WorkBuddy技能结果陈旧是因项目索引未更新；需退出程序后删除project_index.db文件重启重建，或执行workbuddy --reindex-projects --incremental命令增量刷新，并通过/context status验证时间戳是否为当前分钟内。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 时发现技能执行结果陈旧、无法反映最新文件变更或任务状态未同步，可能是由于项目上下文索引未及时更新所致。WorkBuddy 依赖本地构建的项目索引缓存来快速定位文件、历史任务与上下文关系，若该索引停滞或损坏，将导致上下文获取失败。以下是手动强制刷新项目索引的具体步骤：
一、关闭 WorkBuddy 并定位项目索引目录
项目索引通常以 SQLite 数据库文件形式存储于本地应用数据路径中，必须在程序完全退出后操作，避免文件锁冲突或写入中断。
1、右键点击系统托盘中的 WorkBuddy 图标，选择「退出」；若无托盘图标，打开任务管理器（Windows）或活动监视器（macOS），结束所有名为 workbuddy 或 CodeBuddy 的进程。
2、按 Windows 键 + R，输入 %APPDATA%\CodeBuddy\workbuddy\projects（Windows）或前往 ~/Library/Application Support/CodeBuddy/workbuddy/projects（macOS）。
3、在该目录下查找名为 project_index.db 的文件——此即核心项目上下文索引数据库。
二、删除索引文件并重启重建
删除索引文件不会丢失任何原始项目文件、技能包或用户配置，仅清除已缓存的路径映射、时间戳快照与上下文图谱结构，重启后将自动扫描全部已知项目路径并生成全新索引。
1、选中 project_index.db 文件，按 Delete 键彻底删除（macOS 用户请确认已清空废纸篓）。
2、双击桌面或开始菜单中的 WorkBuddy 图标，重新启动客户端。
3、首次启动后，界面右下角将显示「正在重建项目索引…（0%–100%）」提示条，持续约 3–12 秒（取决于项目总数与单个项目规模）。
4、当提示条消失且状态栏显示「索引就绪」时，即可验证：在任意技能中调用需上下文感知的功能（如「总结当前项目README」），确认返回内容是否基于最新文件版本。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、通过命令行触发增量式索引刷新
适用于已启用开发者模式的用户，该方式跳过全量扫描，仅校验并更新自上次索引以来发生修改的项目路径，响应更快且资源占用更低。
1、以管理员身份打开 PowerShell（Windows）或 Terminal（macOS）。
2、执行命令：workbuddy --reindex-projects --incremental。
3、观察终端输出中是否出现 [INFO] Incremental project index updated for X paths 日志行。
4、无需重启客户端，索引更新将在 2 秒内完成并立即生效，可在技能执行日志中确认上下文加载时间戳已刷新。
四、验证索引刷新结果与上下文可用性
刷新完成后需主动触发一次上下文敏感操作，以确认新索引已正确加载并可被技能链路调用，避免因缓存残留导致误判。
1、进入「任务中心」，点击右上角「+ 新建任务」按钮。
2、在指令输入框中键入：/context status（该为内置诊断指令）。
3、按下回车，等待 1–3 秒，查看返回结果中 last_index_update 字段的时间戳是否为当前分钟内（如 2026-04-13T04:12:xx）。
4、若时间戳符合预期，且 indexed_projects_count 值大于 0，则表明项目索引已成功刷新并可供上下文获取使用。
