WorkBuddy Git 记忆同步

解决什么问题

WorkBuddy 的本地记忆分散在 ~/.workbuddy 下，包含人格设定、用户偏好、长期记忆等关键内容，但长期缺少结构化的版本同步方案。直接 cp -r 或 git add ~/.workbuddy 会把数据库、日志、会话记录、疑似 Token 的配置文件一并提交，既污染仓库，也可能泄露敏感信息。另一方面，换设备或重装后，想从远程仓库恢复记忆时，手动还原容易漏文件、覆盖错路径，且无法先预览影响范围。

技能如何工作

该技能通过白名单方式同步记忆文件，而不是备份整个目录。脚本 scripts/git_memory_sync.py 只处理以下路径：

• ~/.workbuddy/MEMORY.md
• ~/.workbuddy/USER.md
• ~/.workbuddy/IDENTITY.md
• ~/.workbuddy/SOUL.md
• ~/.workbuddy/memory/**
• 可选的 workspace 记忆：*/.workbuddy/memory/**

同时排除数据库、日志、会话、追踪、Token/密钥类文件、连接器配置、插件状态和 .git 目录。

首次使用时需要提供或推断远端 Git URL（支持 Gitee、GitHub、GitLab、自托管或标准 Git URL）、本地备份仓库路径（默认 ~/workbuddy-memory-backup）、分支（可选）、是否包含 workspace 记忆以及对应的 workspace 根路径。配置会保存到 ~/.workbuddy/memory/git-sync/config.json，仅当包含 workspace 记忆时还会额外写入 ~/.workbuddy/memory/git-sync/workspaces.json。

核心流程包括：

• 健康检查：在上下文不清时先运行 git_memory_sync.py check，检查远端 URL、分支、本地仓库路径、仓库是否存在、凭据是否就绪。
• 初始化或克隆：本地仓库已存在时验证并创建备份子文件夹；缺失且用户同意时才克隆远端仓库。
• 备份：提交变更到本地仓库，可选择是否推送远端。脚本会生成 manifest.json 记录文件快照。
• 拉取同步：pull 会拉取远端变更、在本地提交变更并推送；只有在请求或配置启用时才会包含 workspace 记忆。
• 恢复：默认 dry-run，先打印所有源路径和目标路径；确认后使用 --yes 执行实际写入。写入前会提示将覆盖本地记忆文件，并生成预恢复快照到 ~/.workbuddy/memory/git-sync/snapshots/。

参数优先级为命令行参数 > 配置文件 > 安全默认值。默认行为包括：仓库路径 ~/workbuddy-memory-backup、远端 URL 为空（克隆或推送前必填）、分支自动检测、默认不包含 workspace 记忆、workspace 根路径为空。

适用边界与注意点

• 恢复会覆盖 ~/.workbuddy 下的记忆文件，应视为破坏性操作；除非同一轮已获得明确确认，否则先 dry-run。
• 不要对 ~/.workbuddy、Desktop、Downloads、Documents、Home 或 WorkBuddy 项目目录执行 rm -rf 或广泛删除。
• 不要将整个 ~/.workbuddy 目录加入 Git。
• 技能和备份仓库中不得存放 Git 凭据、Token、密码、SSH 密钥或连接器配置。
• git push 或 git pull 因认证失败时，直接报告错误并请用户自行配置 Git 凭据，不要尝试猜测或重试。
• 备份仓库出现意外未提交的手动改动时，先查看状态再继续。
• 恢复操作只写入 ~/.workbuddy 和显式配置的 workspace 根路径。