WorkBuddy 问题调试与 C 盘清理

要解决的问题

WorkBuddy 在实际部署中有两个反复出现、极易被误判的故障：

• 更新被拦截：升级时弹出"安装目录下存在用户项目目录"或"安装目录下有项目目录"，无法继续。
• 侧边栏幽灵项目：已删除的项目（如 Claw）每次启动自动恢复，删目录无效，清 workspaces 表也无效。

这两个问题表面不同，根因却都与 WorkBuddy 的目录策略和会话记录机制有关。直接删文件往往让情况更糟——要么误删运行核心，要么重启后又被重建。

核心根因与修复路径

复发开关在于 WORKBUDDY_DATA_FOLDER_NAME=.workbuddy。WorkBuddy 会给每一个被当作工作根目录的文件夹自动生成 .workbuddy 子目录来存储用户数据。如果安装目录恰好落在某个工作根之下，且曾被登记为 workspace，安装目录内部就会被写入 .workbuddy，触发更新拦截。

幽灵项目的真凶不在 workspaces 表，而在 sessions 表的 cwd 字段。当某条历史会话的 cwd 指向已不存在的路径，WorkBuddy 启动时会恢复侧边栏显示并重建空壳目录。因此清 workspaces、删归档、删空壳目录都无效——唯一根治方式是把失效 cwd 改写为有效路径，保留历史记录不丢。

技能按四步推进：

1. 只读诊断：diagnose.py 探测安装与配置目录，检测 .workbuddy，读取 workspaces 与 sessions 表，输出清洁度结论。
2. 分级修复：优先将安装目录迁至 C:\Program Files\WorkBuddy 与工作盘物理隔离；guard-install-workbuddy.ps1 默认仅检查，加 -Fix 时备份后移走误写的 .workbuddy。
3. 幽灵项目修复：fix_sessions.py 先备份 workbuddy.db，再将失效 cwd 改写为有效路径。
4. 安全清理：recycle_cleanup.py 只清理冗余、历史、备份类残留并送回收站，不硬删。

适用边界

• 用户数据核心位于 WORKBUDDY_CONFIG_DIR（默认 ~/.workbuddy），与安装位置解耦。重装只卸载程序，技能、记忆、连接器配置均保留。
• 运行时实时缓存（blobs、file-history、app、logs 等）不要手动清理，重启后会自动重建。
• 卸载必须由用户在退出实例后手动执行，当前会话内卸载会杀掉自身。
• workbuddy.db 可能含令牌与历史，所有清理与修复操作前务必确认备份完整。