Agent Skills
返回列表
WorkBuddy 工作区搬迁助手

WorkBuddy 工作区搬迁助手

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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中打开的问题