应调整索引更新频率以解决内容变更未及时反映问题：一、开启自动重新整理并设为每小时等周期；二、手动执行完整编目；三、混合使用累加式与周期性完整编目；四、通过claw-cli命令行强制同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您发现WorkBuddy本地知识库中的内容变更未能及时反映在搜索或技能调用结果中，则可能是索引更新频率设置过低，导致向量检索依据的是陈旧快照。以下是调整索引更新频率的具体操作步骤：
一、设置自动重新整理间隔
重新整理操作会扫描数据源中已修改或新增的文档，并仅对这些变动内容增量更新索引，避免全量重建带来的性能开销。该机制适用于日常高频更新场景，确保知识库内容保持近实时同步。
1、进入WorkBuddy主界面，点击左下角「设置」图标，打开系统配置页。
2、在左侧导航栏选择「知识库管理」→「索引设置」。
3、找到「自动重新整理」开关，将其设为开启状态。
4、在「重新整理频率」下拉菜单中选择预设周期：每15分钟、每小时、每6小时或每日；如需更精细控制，点击「自定义」输入Cron表达式，例如0 0 */4 * * ?表示每4小时执行一次。
5、勾选「仅扫描最近修改文档」，系统将跳过未改动文件，显著缩短单次刷新耗时。
二、触发手动完整编目
完整编目会遍历数据源全部文档，强制重建整个向量索引库，适用于知识库结构大幅调整、批量导入新资料或怀疑索引损坏等情形。此操作资源占用较高，建议在非高峰时段执行。
1、在「知识库管理」页面，点击「编目与同步」标签页。
2、确认当前连接的数据源状态为“就绪”且无运行中任务。
3、点击「执行完整编目」按钮，弹窗提示“即将清空现有索引并重建”，点击确认。
4、观察底部状态栏进度条，待显示[SUCCESS] Full cataloging completed即表示完成。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
三、配置累加式与完整式混合策略
为兼顾时效性与稳定性，可组合使用累加式重新整理与周期性完整编目。前者保障日常微调响应，后者定期校准全局一致性，防止长期增量累积引发的偏移或遗漏。
1、在「索引设置」页底部，展开「高级编目策略」区域。
2、启用「周期性完整编目」，设置频率为每周一次，推荐时间选在周日凌晨2:00。
3、保持「累加式重新整理」间隔为每小时，确保文档修改后1小时内可见。
4、勾选「异常时自动降级为完整编目」，当连续3次累加刷新失败，系统将自动触发一次完整重建。
四、通过命令行强制同步索引
当图形界面无法响应或需绕过UI缓存逻辑进行底层索引重置时，可使用Claw命令行工具直接操作索引服务，适用于运维人员或自动化脚本集成场景。
1、打开终端（Windows使用PowerShell，macOS/Linux使用Terminal）。
2、切换至WorkBuddy安装目录下的engine/indexer/子路径。
3、执行命令：claw-cli index sync --mode=full --force（强制完整同步）或claw-cli index sync --mode=incremental（仅增量同步）。
4、等待日志输出包含Index version bumped to v[0-9]+.[0-9]+字样，表示索引版本已更新生效。
