前言¶
WorkBuddy 和 codebuddy CLI 默认把数据目录放在 %USERPROFILE%\.workbuddy,也就是 C 盘用户目录里。AI 工具跑久了,会话记录、缓存、索引之类的文件越攒越多,系统盘可用空间被一点点吃掉,而手工搬目录又很危险:直接剪切粘贴可能破坏配置引用,删错文件可能丢数据。
下面介绍的 Skill「WorkBuddy C盘迁移大师」就是处理这件事的。它先体检、再搬迁、支持回滚,全程不需要管理员权限,也不需要手工改配置文件。
这是什么¶
「WorkBuddy C盘迁移大师」是一个社区来源的 Skill,坐标 @indiv-tangzhan/wb-c-migration,由用户 user_d8acf64f 发布维护,当前版本 1.0.2,属于 SkillHub 的 office-efficiency 分类。
它解决的问题只有一个:把 WorkBuddy 和 codebuddy CLI 的数据根目录从 C 盘整体搬到其他盘,回收被 AI 工具占用的系统盘空间。搬运方式不是复制粘贴,而是通过官方支持的环境变量 WORKBUDDY_CONFIG_DIR / CODEBUDDY_CONFIG_DIR 把数据根目录指向新位置,因此不需要手工改任何配置文件。
核心功能¶
经过核对,这个 Skill 的能力有以下几点:
- 体积体检。搬迁之前先扫描数据目录,逐项列出各个子目录的占用情况,并标出哪些垃圾可以直接删除,先让用户看到空间都被谁吃掉了。
- 环境变量迁移。确认搬迁后,通过官方支持的
WORKBUDDY_CONFIG_DIR/CODEBUDDY_CONFIG_DIR环境变量,把整个数据根目录指向新位置,不需要管理员权限,不需要手工编辑配置文件。 - 默认 dry run。附带脚本默认只做体检,不会动文件;加上
-Migrate参数才会真正搬迁。 - 搬迁前校验。真正搬迁前会校验目标路径是否有效、剩余空间是否足够、有没有阻塞进程占用源目录。
- 搬迁后校验。搬完会核对新目录和原目录两边的文件数是否一致。
- 可回滚。原目录只会改名为
.bak,不会删除;任何一步失败都会立即中止,且不动源目录,出问题可以无损回滚。
安装与启用¶
SkillHub 页面:https://www.skillhub.cn/skills/indiv-tangzhan/wb-c-migration
官方地址:https://api.skillhub.cn/indiv-tangzhan/wb-c-migration
坐标:@indiv-tangzhan/wb-c-migration,版本 1.0.2,来源 community,标签 requires_api_key=false,即不需要 API Key。
关于具体安装命令:已抓取的官方资料中没有给出该 Skill 的安装命令或 SKILL.md 安装片段,Cursor、Codex CLI、Claude Code 等客户端各自的启用方式也没有官方说明。在拿到官方命令之前不建议自行猜测安装方式。可以确认的是,本机使用环境变量 WORKBUDDY_CONFIG_DIR / CODEBUDDY_CONFIG_DIR 指定新数据目录,是该 Skill 依托的官方机制,这也是它不需要改配置文件的原因。
典型用法¶
已抓取资料中提供了脚本的两种运行形态,没有给出更细的调用示例:
- 默认运行:只做体检,输出各子目录占用并标出可删除的垃圾,不移动任何文件。
运行附带脚本(默认 dry run)
- 真正搬迁:确认体检结果后,给脚本加上
-Migrate参数,脚本会先校验目标路径、剩余空间和阻塞进程,然后执行搬迁,搬迁后校验两边文件数一致。
运行附带脚本 -Migrate
搬迁完成后,原目录会保留为 .bak 改名目录。确认新目录工作正常后,再自行处理 .bak 目录即可。
适用场景与注意¶
适合以下场景:
- WorkBuddy 或 codebuddy CLI 的用户目录在 C 盘,系统盘空间被 AI 工具的会话、缓存数据持续占用。
- 希望整体搬走数据根目录,而不是手工剪切粘贴或逐项清理。
- 不想改配置文件,也不想为了改环境变量去开管理员权限。
需要注意的几点:
- 迁移依赖官方环境变量
WORKBUDDY_CONFIG_DIR/CODEBUDDY_CONFIG_DIR生效,使用前确认所用版本的 WorkBuddy / codebuddy CLI 支持这两个变量。 - 脚本默认只体检,必须显式加
-Migrate才会搬迁;搬迁前建议先确认目标盘剩余空间充足。 - 搬迁过程中如果有进程正在读写源目录,校验会拦下来,需要先关闭这些进程。
- 原目录只会改名为
.bak而不删除,确认新目录正常后再自行清理。 - 该 Skill 在 SkillHub 上评分 100000、下载 1450 次,来源为 community,采用前可自行在官方页面核对最新数据。
结尾¶
这个 Skill 的价值在于把「搬数据目录」这件高风险的事拆成了体检、校验、搬迁、回滚四步:默认 dry run 不碰文件,-Migrate 之后有前后校验和 .bak 兜底,失败即中止、源目录不动。对 C 盘被 AI 工具占满的 Windows 用户来说,是一个可以无损回收空间的方案。
官方地址:https://www.skillhub.cn/skills/indiv-tangzhan/wb-c-migration