Agent Skills
返回列表
WorkBuddy 数据目录迁移

WorkBuddy 数据目录迁移

IT 运维与安全 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_cb3bc76d/windows-junction-migration。

技能介绍

要解决的问题

很多 Windows 应用把数据写在 C:\Users\\\AppData 下,时间一长系统盘就满了。直接剪切目录再让应用改配置,往往没有这个选项;用复制加删除的方式迁移,一旦应用还在运行,日志和会话文件被锁,脚本很容易删一半、回滚困难。

另一个更隐蔽的坑是批处理编码。凡是含中文路径的 .bat,管理员 cmd 都可能解析失败。中文注释、GBK 编码、chcp 切换、甚至 for /d 扫描中文目录名,全部会导致脚本把每一行原样回显成命令,最后报 'local' is not recognized。

这个技能做了什么

核心是生成器 scripts/genmigrationbat.py,它产出两个文件:

  • migrate.bat:100% 纯 ASCII,不含任何非 ASCII 字节,运行时通过外部文件读取目标路径。
  • migrate_target.txt:用 GBK 编码写入目标路径,管理员 cmd 按系统代码页原生读取,不产生乱码。

脚本按顺序做七件事:管理员权限检查、检测应用是否运行、robocopy /E /PURGE 最终同步、校验目标端文件数不低于源端 80%、将源目录重命名为 .bak(只改名永不删除)、mklink /J 建立目录联接、最后写入并删除测试文件验证读写。第 5 到 7 步任意失败都会删除联接并把 .bak 改回原名,实现自动回滚。

适用边界与注意点

  • 只支持本地固定 NTFS 驱动器,C 盘和 E 盘之间可以,跨网络盘不行。
  • 永远不要手写含中文路径的 .bat,所有非 ASCII 输入必须走 GBK 外部文件。
  • 执行前要彻底退出应用,包括系统托盘图标,否则残留进程会锁住日志,导致改名失败。
  • 由于 agent 本身跑在应用里,脚本必须由用户在关闭应用后手动右键以管理员身份运行。
  • 源目录只改名不删除,确认稳定运行几天后再手动清理 .bak。

更多失败案例的复盘见 references/encoding-pitfalls.md,记录了多种错误写法及其原因。

整个方案透明且应用无关,不需要改动目标应用的配置。

使用场景

  • C 盘被写满,想把 WorkBuddy 的 .workbuddy 数据目录挪到 E:\软件\workbuddy 下继续用,且不改任何应用配置
  • 应用装在中文目录下,自己写的 .bat 一执行就逐行回显、报 'local' is not recognized,想换编码安全的方式生成脚本
  • 想做大应用数据目录的迁移,但不想冒险用复制加删除,希望保留只改名、可随时回滚的 .bak 备份
  • 目录联接建立后,需要验证读写确实落到新盘,避免运行几天后才发现问题

适合人员

  • Windows 桌面应用开发者:应用数据写死在 C 盘且不提供 dataDir 设置,需要透明迁移方案交付给用户
  • IT 运维工程师:按工单把员工机器上的业务数据目录迁到第二块盘,要求不改应用配置且失败可回滚
  • 被批处理中文乱码坑过的开发者或运维:需要纯 ASCII 脚本加 GBK 外部文件这条可靠写法
  • 系统盘空间吃紧的 Windows 用户:想把大型应用的数据目录整体挪到 E 盘继续日常使用