自动更新功能

自动更新功能可以在后台自动检测文档变更并更新对应的分享，无需手动点击「更新分享」。

开启自动更新

1. 打开插件设置页面
2. 找到「自动更新分享」开关，切换为开启状态
3. 设置「静默时间」（默认 60 秒，最少 30 秒）

静默时间

静默时间是文档变更后等待的时间窗口，在此期间插件不会触发自动更新。

• 文档修改后开始倒计时
• 如果在倒计时期间文档再次修改，倒计时会重置
• 倒计时结束后才会触发自动更新
• 默认值为 60 秒，可自定义，最少 30 秒

这个机制可以防止编辑过程中频繁触发更新。

工作原理

插件通过监听思源笔记的 WebSocket 事件来检测文档变更，支持以下事件：

• 文档保存
• 文档重命名
• 文档移动

当检测到已分享文档发生变更时，会将该文档加入更新队列。队列中的任务按顺序执行，确保每次只有一个分享在更新。

自动更新状态

点击插件设置中的「自动更新状态」按钮，可以打开状态对话框。对话框包含五个标签页：

概览

显示当前自动更新的整体状态：

• 运行状态 —— 已开启 / 已关闭
• 当前任务 —— 正在更新的分享名称，或「无」
• 排队任务 —— 等待更新的数量
• 上次检测 —— 上次检查变更的时间
• 下次检测 —— 下次检查变更的时间

队列

显示当前等待更新的分享列表。每项显示分享的名称和排队时间。

• 当队列为空时显示「当前没有排队任务」

静默

显示当前处于静默冷却期的分享列表。每项显示分享名称和剩余等待秒数。

• 当没有静默任务时显示「当前没有静默任务」

重试

显示更新失败后等待重试的分享列表。每项显示分享名称和重试信息。

• 点击「清空」按钮可以清除所有重试任务
• 当没有重试任务时显示「当前没有重试任务」

历史

显示最近的自动更新操作历史，包含成功和失败的记录。每条记录显示：

• 分享名称
• 更新时间
• 更新状态（成功 / 失败 / 已跳过）

文档树图标状态

开启自动更新后，已分享文档在文档树中的图标会根据状态变化：

• 蓝色（默认） —— 正常分享状态
• 琥珀色 —— 静默冷却中，等待更新
• 橙色 —— 已加入更新队列
• 旋转动画 —— 正在同步更新
• 红色 —— 更新失败

手动触发检测

在自动更新状态对话框中，点击「立即检测」按钮可以手动触发一次变更检测，不必等待下一次自动扫描。

笔记本关闭时的处理

当笔记本在思源笔记中被关闭时，对应的分享会跳过自动更新，并在历史记录中显示「已跳过自动更新：{名称} 对应笔记本已关闭」。

重试机制

自动更新失败后，系统会自动安排重试：

• 基础重试延迟为 30 秒
• 每次重试失败后延迟翻倍，最长不超过 30 分钟
• 在重试标签页中可以查看当前的重试任务
• 点击「清空」按钮可以取消所有重试