WorkBuddy C Drive Migration Expert: Relocating AI Tool Data Off the C Drive

前言

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 的能力有以下几点:

  1. 体积体检。搬迁之前先扫描数据目录,逐项列出各个子目录的占用情况,并标出哪些垃圾可以直接删除,先让用户看到空间都被谁吃掉了。
  2. 环境变量迁移。确认搬迁后,通过官方支持的 WORKBUDDY_CONFIG_DIR / CODEBUDDY_CONFIG_DIR 环境变量,把整个数据根目录指向新位置,不需要管理员权限,不需要手工编辑配置文件。
  3. 默认 dry run。附带脚本默认只做体检,不会动文件;加上 -Migrate 参数才会真正搬迁。
  4. 搬迁前校验。真正搬迁前会校验目标路径是否有效、剩余空间是否足够、有没有阻塞进程占用源目录。
  5. 搬迁后校验。搬完会核对新目录和原目录两边的文件数是否一致。
  6. 可回滚。原目录只会改名为 .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 依托的官方机制,这也是它不需要改配置文件的原因。

典型用法

已抓取资料中提供了脚本的两种运行形态,没有给出更细的调用示例:

  1. 默认运行:只做体检,输出各子目录占用并标出可删除的垃圾,不移动任何文件。
运行附带脚本(默认 dry run)
  1. 真正搬迁:确认体检结果后,给脚本加上 -Migrate 参数,脚本会先校验目标路径、剩余空间和阻塞进程,然后执行搬迁,搬迁后校验两边文件数一致。
运行附带脚本 -Migrate

搬迁完成后,原目录会保留为 .bak 改名目录。确认新目录工作正常后,再自行处理 .bak 目录即可。

适用场景与注意

适合以下场景:

  • WorkBuddy 或 codebuddy CLI 的用户目录在 C 盘,系统盘空间被 AI 工具的会话、缓存数据持续占用。
  • 希望整体搬走数据根目录,而不是手工剪切粘贴或逐项清理。
  • 不想改配置文件,也不想为了改环境变量去开管理员权限。

需要注意的几点:

  1. 迁移依赖官方环境变量 WORKBUDDY_CONFIG_DIR / CODEBUDDY_CONFIG_DIR 生效,使用前确认所用版本的 WorkBuddy / codebuddy CLI 支持这两个变量。
  2. 脚本默认只体检,必须显式加 -Migrate 才会搬迁;搬迁前建议先确认目标盘剩余空间充足。
  3. 搬迁过程中如果有进程正在读写源目录,校验会拦下来,需要先关闭这些进程。
  4. 原目录只会改名为 .bak 而不删除,确认新目录正常后再自行清理。
  5. 该 Skill 在 SkillHub 上评分 100000、下载 1450 次,来源为 community,采用前可自行在官方页面核对最新数据。

结尾

这个 Skill 的价值在于把「搬数据目录」这件高风险的事拆成了体检、校验、搬迁、回滚四步:默认 dry run 不碰文件,-Migrate 之后有前后校验和 .bak 兜底,失败即中止、源目录不动。对 C 盘被 AI 工具占满的 Windows 用户来说,是一个可以无损回收空间的方案。

官方地址:https://www.skillhub.cn/skills/indiv-tangzhan/wb-c-migration

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye