Agent Skills
返回列表
WorkBuddy 会话迁移

WorkBuddy 会话迁移

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_cad2c8c1/workbuddy-session-migrate。

技能介绍

面临的问题

WorkBuddy 的侧边栏不是一张全局会话表,而是按 user_id 加 deleted_at IS NULL 过滤出来的。同一个本地数据库里,个人版与企业版的会话天然隔离,切换账号也看不到别人的记录。常见需求有两类:把某条会话从个人版移动到企业版;或在目标账号下生成一份副本、源会话继续保留。手工复制正文容易丢失时间线与工作目录归属。

技能如何工作

该技能直接改写 SQLite 数据库 ~/.workbuddy/workbuddy.db,而不是模拟界面点击。sessions 表以 id 为主键、用 user_id 表示归属;正文是按 cwd 分目录的 .jsonl 文件,文件名等于会话 ID,每行顶层 sessionId 与之一致,正文内容与 user_id 无关。

据此有两种语义:

  • 移动 migrate:一条 UPDATE sessions SET user_id=... WHERE id=...,正文不动,会话从源账号消失、出现在目标账号。
  • 复制 copy:生成新 UUID,克隆 sessions 行并刷新 updated_at;同时复制 .jsonl,改名为新 ID,并把每行顶层 sessionId 替换过去。

session_usage 等表只按 session_id 关联、不含 user_id,移动时无需处理;副本的用量从零计数,不继承原会话统计。

写盘前有四步缺一不可的流程:

  1. 前置探测:用 list-users / list-sessions 读出源/目标账号、待处理 session ID 与语义(默认多数跨账号需求是 copy)。
  2. 逐项确认:完整罗列退出 App(含托盘进程)、账号与 ID 核对、跨账号合规、非官方风险、会话仍显示在原 cwd 分组等事项,等待显式确认。
  3. 备份先行:数据库快照与相关 .jsonl 打包成带时间戳的 zip 放到桌面,记录 BACKUP_ZIP=,确认体积正常后才继续。
  4. 校验与复核:先 --dry-run 演练再写入;copy 走事务,失败回滚并清理孤儿文件,结束后打印 N/N 复核结果。

最后用目标账号登录,在 原 cwd 工作区分组 下确认会话可见且正文可加载。

适用边界与注意点

这是改写生产数据库的 非官方操作,产品升级或 schema 变更后脚本需同步维护。执行前必须:WorkBuddy 已完全退出(含托盘进程);两个账号均为本人所有且符合所在组织的合规要求;桌面 zip 已生成并通过 --backup-verified 检查——未确认不得备份、未备份不得写入、App 运行时不得写库。

幂等性有差异:migrate 会跳过已属目标账号的会话,数据库中不存在的 ID 记为缺失但不影响其余处理;copy 每次都生成全新副本,重复运行会产生多份重复会话。

撤销路径:移动可用反向 --to 配合 --backup-verified 恢复(复用已存 zip 即可);复制只需删除生成的副本,源会话不受影响;整体还原用 zip 内的 db/workbuddy.db 覆盖磁盘文件,重开 App 即可。批量处理用 --from 选某账号全部未删除会话,或用 --sessions a,b,c 混合指定,参数在 backup_sessions.py、verify、migrate、copy 中保持一致。

使用场景

  • 需要把个人版下调试了很久的 AI 会话搬到企业版继续推进,让团队接得上进度
  • 企业版崭新账号缺少问题排查的完整上下文,要从个人会话复制一份副本过去补位
  • 旧电脑不再续用,要把上面的 WorkBuddy 会话迁移到另一台机器的新版本账号中
  • 同一台设备换了新账号,要把之前沉淀的多条工作会话批量交接过去继续使用

适合人员

  • 一起用 WorkBuddy 协同办公、经常要把个人会话搬到企业账号继续用的工程师
  • 担心误操作丢数据、需要可回滚备份才敢改本地数据库的谨慎型运维
  • 负责组织数据治理、需要审计每一次跨账号迁移操作的合规人员
  • 喜欢折腾 WorkBuddy 桌面端并做多账号实验的技术爱好者