WorkBuddy 工作区搬迁助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_69f8ab72/workbuddy-move-workspace。
技能介绍
要解决的具体问题
本文解决 WorkBuddy 用户在更换磁盘、移入云盘同步目录或调整目录层级后,旧对话无法打开或路径失效的问题。核心在于工作区路径变更后,WorkBuddy 内部的多层数据引用没有同步更新。
核心能力与关键步骤
该技能围绕 WorkBuddy 的 4 层数据结构设计,确保路径替换准确且无遗漏:
- 权威层修复:直接修改
workbuddy.db(SQLite)中的sessions.cwd和workspaces.path。这是旧对话能打开的关键,仅修复缓存会在重启后被数据库覆盖。 - 缓存层重建:同步修复
projects目录下的对话记录、sessions目录的元数据,以及app/sessions.json和artifact-index产物索引。 - 归档目录迁移:自动将
projects/<旧编码>下的对话归档重命名或合并到新路径,保证数据结构一致。 - 路径风格适配:自动识别盘符大小写、单双反斜杠及正斜杠等写法,并进行同风格替换,避免破坏 JSON 转义格式。
- 批量与回滚:支持通过清单文件(每行
旧路径|新路径)批量处理。改动前自动备份至~/.workbuddy/_pathfix_backup_/,随时可回滚。
适用边界与注意点
- 零删除原则:脚本全程不删除数据,旧归档仅移入备份区,清理需用户确认且通过回收站进行。
- 必须重启:脚本仅更新记录,文件夹需用户预先移动,且执行后必须重启 WorkBuddy 界面才会生效。
- 环境与编码:脚本内部处理了 Windows Git Bash 的路径转义问题,并修复了整型字段遍历导致的
TypeError。
使用场景
- 电脑更换物理盘后,需要将workspaces数据库里的旧磁盘路径批量更新为新盘符
- 将工作区文件夹移到云盘同步目录时,保证workbuddy.db的会话路径和归档一致
- 多个项目文件夹同时改路径,用清单文件批量更新数据库和缓存引用
- 旧对话框无法打开,需要全盘扫描残留的旧路径并修复全部层级
适合人员
- 个人项目开发者,需要迁移本地代码库到新磁盘后保持历史提交记录可追溯
- 团队运维人员,要在部署多环境时批量同步工作区的路径配置到不同服务器
- 文件同步需求者,要把数据搬入云盘时保证本地应用的用户会话历史不丢失
- 历史项目维护者,需要修复因目录重构导致旧项目无法在WorkBuddy中打开的问题