下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/indiv-tangzhan--wb-c-migration.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @indiv-tangzhan/wb-c-migration。把 WorkBuddy 和 codebuddy CLI 的数据目录(默认 %USERPROFILE%.workbuddy)从 C 盘搬到其他盘,回收被 AI 工具吃掉的系统盘空间。先做体积体检,逐项列出子目录占用并标出可以直接删除的垃圾;确认要搬后,通过官方支持的环境变量 WORKBUDDY_CONFIG_DIR / CODEBUDDY_CONFIG_DIR 把整个数据根目录指向新位置。
附带脚本默认只体检(dry run),加 -Migrate 才真正搬迁:搬前校验目标路径、剩余空间与阻塞进程,搬后校验两边文件数一致,原目录只改名为 .bak 而不删除,任一步失败立即中止且不动源目录。不需要管理员权限,不需要手工改配置文件,出问题可无损回滚。
阅读全文 (展开查看完整说明)
概述
用途
把 WorkBuddy 的数据根目录(含运行时、日志、插件、会话、Electron userData)从 C 盘搬到其他盘,解决"系统盘被 WorkBuddy 吃掉一个多 G"的问题。全程走官方支持的环境变量,不改配置文件、不需要管理员权限、不删除任何数据。
触发场景
- "WorkBuddy 缓存占了 C 盘一个多 G,能换盘吗"
- "C 盘没空间了,WorkBuddy 的数据目录在哪"
- "怎么把 .workbuddy 挪到 D 盘 / E 盘"
- "迁移完怎么确认成功了"
- "脚本说 WorkBuddy 还在运行,但我明明关过了"
- "迁移完 C 盘那个目录又冒出来了,是失败了吗"
- C 盘剩余空间告急,需要定位并回收某个 AI 工具的数据占用
核心事实
数据根目录默认是 %USERPROFILE%.workbuddy(macOS/Linux:~/.workbuddy;WorkBuddy 海外版:~/.workbuddy-ai)。
官方支持换盘,靠环境变量:
| 变量 | 作用域 |
|---|---|
WORKBUDDY_CONFIG_DIR | 桌面端数据根目录 |
CODEBUDDY_CONFIG_DIR | codebuddy / cbc CLI 的数据根目录 |
WORKBUDDY_USER_DATA_DIR | 单独覆盖 Electron userData(默认 <configDir>app) |
解析优先级:显式参数 → WORKBUDDY_CONFIG_DIR → CODEBUDDY_CONFIG_DIR → %USERPROFILE%.workbuddy。
已在 app.asar 源码里核实过这条链(不用重复验证):主进程 configureElectronApp() 先 getWorkbuddyConfigDir() 拿到解析结果,再把它回写进 process.env.WORKBUDDY_CONFIG_DIR / CODEBUDDY_CONFIG_DIR 供子进程继承;而各消费点一律是 process.env.WORKBUDDY_CONFIG_DIR?.trim() || <默认值> 的形式,环境变量优先于默认值。几个代表性函数:
| 函数 | 逻辑 |
|---|---|
resolveConfigDir() | fromEnv = env.WORKBUDDY_CONFIG_DIR?.trim(),有值直接用 |
resolveBinaryManagerConfigDir() | env.WORKBUDDY_CONFIG_DIR || env.CODEBUDDY_CONFIG_DIR || <home>/.workbuddy |
getDefaultUserDataDir() | WORKBUDDY_USER_DATA_DIR → 否则 <configDir>/app |
resolveSessionsDir() | 先 CODEBUDDY_CONFIG_DIR,再 WORKBUDDY_CONFIG_DIR |
副作用提醒:因为主进程会把解析结果回写环境变量,所以 WorkBuddy 运行期间,它派生的任何子进程(包括它自己开的终端、CLI)看到的 WORKBUDDY_CONFIG_DIR 都是旧值。迁移后必须让 WorkBuddy 整体重启(全部进程退出,含托盘),只关窗口没用。
改这两个变量后,以下内容会整体跟着走,它们全挂在同一个根目录下:下载的运行时(Node / Python / PortableGit)、logs、traces、plugins、connectors、skills、sessions、projects、blobs、Electron userData。
典型体积构成与各项性质见 references/cache-layout.md。
前提:必须从 WorkBuddy 外面运行脚本
这条踩坑率最高,实测中连续两轮卡在这里,务必先说清楚。
在 WorkBuddy 自己的会话里执行这个脚本,永远不会成功。 原因有两层:
- 脚本的进程守卫会检测
WorkBuddy.exe。你在 WorkBuddy 里跑它,它检测到的就是你自己,
必然打印 Still running - quit them first 然后 exit 1。
- 就算绕过守卫也没用 —— WorkBuddy 的工具链(PortableGit / Python / Node)本身就在
<configDir>binaries 底下。把 <configDir> 改名的瞬间,你正在用的 shell、Python解释器全部失效,命令跑到一半自己把自己打断。
正确入口:在 Windows 资源管理器里右键技能自带的启动器 → 使用 PowerShell 运行,它会在 WorkBuddy 之外起一个独立进程(注意:.ps1 双击默认打开编辑器,不会执行):
<script-dir>scriptsrun-migration.ps1 # 默认目标 E:WorkBuddyData
powershell -File <script-dir>scriptsrun-migration.ps1 D:WBData # 自定义目标盘或者自己开一个 Windows Terminal / PowerShell 窗口直接调迁移脚本。关键是这个进程的父进程不能是 WorkBuddy。
启动器会在动手前先做目标路径体检,比直接跑迁移脚本多一层保险。
脚本打印的 exit code: 1 是安全中止,不是崩溃 —— 源数据零改动、.bak 未创建、环境变量未写入。看到它就说明守卫正常工作了,退出 WorkBuddy 再跑一次即可。
工作流
1. 先体检,别盲搬
& "<skill-dir>scriptsmove-workbuddy-data.ps1"不带参数时是 dry run:只列出各子目录体积、总量,以及"不用搬就能删"的垃圾,不做任何修改。
判断重点:
binaries通常是最大项(运行时,可以搬,不能删)logs/traces是纯垃圾,直接删%LOCALAPPDATA%@<厂商><产品名>-desktop-updater是升级残留的 installer.exe,动辄 500 MB+,直接删app是 Electron userData,不是普通缓存
如果只清垃圾就够了,到此为止,不必搬。
2. 搬迁
必须先让 WorkBuddy 完全退出,包括托盘图标里的常驻进程 —— 否则 binaries 和 logs 里的文件句柄会导致复制失败或改名失败。脚本会自动检测,有残留进程时直接中止。
而且必须从 WorkBuddy 外面启动(见上一节)—— 否则守卫检测到的就是你自己。
推荐从启动器走(见上一节,它自带路径体检和退出提醒):
<script-dir>scriptsrun-migration.ps1直接调脚本也行:
& "<skill-dir>scriptsmove-workbuddy-data.ps1" -Target "E:WorkBuddyData" -Migrate脚本按顺序执行,任一步失败就停下且不改动源目录:
- 解析源目录,列出体积构成
- 校验目标路径:不能位于源目录之下、不能是盘符根目录、不能已存在同名文件、目标盘剩余空间需 ≥ 源体积的 1.1 倍
- 检测阻塞进程(
WorkBuddy.exe,以及任何可执行文件路径位于源目录下的进程) robocopy /E /COPY:DAT /DCOPY:DAT /R:1 /W:1 /MT:8全量复制,日志写到%TEMP%workbuddy-relocate.log- 校验源与目标文件数一致,不一致则中止
- 把原目录改名为
<源目录>.bak—— 不删除,保留退路 - 写入用户级环境变量
WORKBUDDY_CONFIG_DIR和CODEBUDDY_CONFIG_DIR
选目标盘时优先挑剩余空间大的那个。
3. 验证
启动 WorkBuddy,然后看原来那个目录有没有被重新创建。
别只看"目录在不在",要看它的体积。 有三种结果,第 2 种最容易被误判成失败:
| 旧目录 | 体积 | 结论 |
|---|---|---|
| 不存在 | — | 成功 |
| 存在,但只有几十 KB | 几十 KB | 成功,但有一个已知的残留日志泄漏(见下) |
| 存在,且接近原体积 | 1 GB 级 | 失败,环境变量没生效 |
第 2 种的典型长相:里面只有 device-id、models.json(内容 [])、logs/<日期>/ 下三个诊断日志 —— daemon-memory-diag.log、edge-sync.log、extension-scheduler-diag.log。这时真实数据已经完整在目标盘上了,可以放心删 .bak。
一条硬证据,直接判定数据落在哪边(-wal 是 SQLite 的活跃写入文件,只会在真正被使用的那一侧出现):
Get-ChildItem -LiteralPath 'E:WorkBuddyDataworkbuddy.db-wal', "$env:USERPROFILE.workbuddyworkbuddy.db-wal" -ErrorAction SilentlyContinue |
Select-Object FullName, Length, LastWriteTime-wal 在目标盘且时间戳是当前 → 数据确实在目标盘跑。这一条是最硬的判据,先跑它。
删 .bak 之前的验证清单
别急着回收那 1 GB。按顺序过一遍,全绿再删:
| # | 检查 | 判据 |
|---|---|---|
| 1 | workbuddy.db-wal 在目标盘 | 存在,且时间戳在最近一分钟内 |
| 2 | 用户级环境变量已持久化 | [Environment]::GetEnvironmentVariable('WORKBUDDY_CONFIG_DIR','User') 返回目标路径 |
| 3 | 关键目录文件数不低于备份 | sessions / projects / skills / plugins / binaries 逐项对比;目标盘侧应 ≥ 备份侧 |
| 4 | workbuddy.db 两边大小一致 | 迁移瞬间的快照,应当相等 |
| 5 | 功能抽查 | 打开一条历史会话、看项目列表、触发一个自动化任务、读写一次记忆文件 |
| 6 | 身份文件加载源 | <configDir> 下的 SOUL.md / USER.md 被读到 |
清单 3 的一行版:
foreach ($d in 'sessions','projects','skills','plugins','binaries') {
$t = @(Get-ChildItem -LiteralPath "E:WorkBuddyData$d" -Recurse -File -Force -EA SilentlyContinue).Count
$b = @(Get-ChildItem -LiteralPath "$env:USERPROFILE.workbuddy.bak$d" -Recurse -File -Force -EA SilentlyContinue).Count
"{0,-10} target={1,-8} backup={2}" -f $d, $t, $b
}删 .bak 本身:别用 Directory.Delete
.bak 里通常有只读文件(binaries 下的运行时、.git 对象在 Windows 上默认只读)。[System.IO.Directory]::Delete($path, $true) 不是原子操作:它会先删掉一部分,撞上只读文件才抛 UnauthorizedAccessException。实测把一个 38,903 文件的备份删成 36,589个,留下一个半残的备份 —— 比不删更糟,因为你以为还有退路。
# 别用:[System.IO.Directory]::Delete($path, $true) # 半删 + 抛异常
# 用:
Remove-Item -LiteralPath "$env:USERPROFILE.workbuddy.bak" -Recurse -Force
# 或(更快,cmd):
rd /s /q "%USERPROFILE%.workbuddy.bak"另外两条实践约束:
- 1 GB / 3 万文件级的批量删除会被安全策略判为高风险操作,可能直接被拦。
让用户在自己的终端里执行,代理不该硬来。
- 删之前把完整路径和体积打出来给人确认一遍。这是不可逆操作。
残留泄漏的根因(产品缺陷,非搬运问题):app.asar 里 packages/workbuddy-extensions/src/runtime/extension-host-manager.ts 把日志根目录写死了:
var LOG_BASE_DIR = path.join(os.homedir(), ".workbuddy", "logs"); // 不读 WORKBUDDY_CONFIG_DIR
function memDiagLogPath() { return path.join(todayLogDir(), "daemon-memory-diag.log"); }
function extSchedulerLogPath() { return path.join(todayLogDir(), "extension-scheduler-diag.log"); }同一份代码里另有正确实现 getWorkbuddyLogsDir(deps) → path.join(deps.app.getConfigDir(), "logs") —— 产品内部自己就不一致。所以搬完之后,这几个诊断日志仍会往 ~/.workbuddy/logs/<日期>/ 写,约 10–15 MB/天(daemon-memory-diag 每 5 秒一行)。
怎么处理这个泄漏:
- 推荐接受它,定期清
~/.workbuddy/logs/。想彻底根治只能改app.asar,而每次升级都会被覆盖,不值当。 - 不建议把
~/.workbuddy做成指向目标盘的 junction 来顺手解决它。为省 15 MB/天,去承担"卸载/重置应用数据时穿透 junction 连真实数据一起删"的风险,不划算。
4. 回滚
删掉新目录,把 .bak 改回原名,清掉两个环境变量即可。原数据从未被删除,回滚无损。
Plan B:目录联接
若用户级环境变量反复不生效:
mklink /J "%USERPROFILE%.workbuddy" "E:WorkBuddyData"junction 不需要管理员权限,对所有启动方式都透明生效。
风险提示:卸载程序或"重置应用数据"之类的流程如果递归删除该路径,部分工具会穿透 junction 连带删掉真实数据。只在 Plan A 失效时使用,且务必先备份。
别为了修"残留诊断日志"而用 junction。 那是个 10–15 MB/天的泄漏,而 junction 的穿透删除风险是整个数据集(GB 级)的损失。用代价换收益,方向反了。
排查技巧
robocopy 退出码 16 + 日志里 错误 267 (0x0000010B) 目录名称无效(一个文件都没复制)
目标路径被一个同名文件占了。robocopy 收到的目标是 E:xWorkBuddyData(带目录语法),但那个名字底下实际是个文件,于是"目录名称无效",直接严重错误退出。日志第 16 行左右会明确写出这一条,后面再无内容 —— 这本身就是特征:只有一行错误、没有文件列表,就是路径问题不是权限问题。
典型成因:在资源管理器里"新建 → 文本文档"再改名、或某次 shell 重定向(> E:xWorkBuddyData)顺手创建了一个 0 字节文件。删掉它再跑即可,源数据全程没动。
脚本现在会在复制前用 PSIsContainer 显式拦下这种情况。自查一句话:
Get-Item -LiteralPath 'E:wbWorkBuddyData' | Select-Object PSIsContainer, LengthPSIsContainer = False 就是元凶。
判断某个环境变量是否真被产品支持:到安装目录的 resourcesapp.asar 里搜变量名。asar 是二进制拼接包,直接 strings 会丢上下文,用 Python 读进来做 re.finditer 再切片:
import re
data = open(r"<install-dir>resourcesapp.asar", "rb").read()
for m in re.finditer(rb"WORKBUDDY_CONFIG_DIR", data):
s = max(0, m.start() - 300); e = min(len(data), m.start() + 500)
print(re.sub(rb"[^x20-x7e]+", b" ", data[s:e]).decode("ascii", "replace"))源码注释里往往直接写着优先级链和默认值,比文档可靠。文件不大时也可以用 grep -a -o。
确认 Electron userData 到底在哪:若 %APPDATA%<产品名> 近乎为空、而 <configDir>app 有上百 MB,说明 userData 已被重定向到 configDir 之下,搬迁会一并覆盖,不需要单独处理。
识别升级残留:%LOCALAPPDATA% 下形如 @<厂商><产品名>-desktop-updater 的目录,里面通常只有几个 installer.exe,属于更新包下载缓存,删除只影响下次更新需重新下载。
确认客户端能力边界:有些操作(例如把技能上架到市场)客户端根本没有开放通道。想知道有没有,直接在 app.asar 里搜 RPC 通道常量表(形如 XXX_RPC_CHANNELS = { ... }),表里每一个通道就对应一个能调的能力。
迁移会让 WorkBuddy 整体重启,重启时会话工作区会重新落盘 —— 迁移前写在里面的临时交付物可能丢。 实测:迁移前 16:51 写在工作区的中文名报告文件,17:02 重启后消失,而同目录 16:50 的文件还在。中文文件名本身没问题(实测落盘读写正常),是重启时序导致的。所以诊断报告、验证报告这类要留给人的东西,在迁移重启完成之后再写,或者写完立刻确认一次还在。
边界与注意
- 只搬 WorkBuddy 自己的数据,不碰其他目录
- 脚本不执行任何删除操作,原数据以
.bak形式保留 - 迁移期间必须完全退出 WorkBuddy(含托盘进程),且从 WorkBuddy 外面启动脚本
- 需要目标盘剩余空间 ≥ 源体积的 1.1 倍
- 不需要管理员权限
- 脚本以 PowerShell 5.1 兼容语法编写且为纯 ASCII,无编码风险
- 删
.bak是不可逆操作,必须先过验证清单;且不要用[System.IO.Directory]::Delete(_, $true)(半删+抛异常) - 写 PowerShell 5.1 代码时的坑:
New-Item没有-LiteralPath参数(只有-Path,而-Path会把[]当通配符解释)。要按字面路径建目录、并顺带创建中间层级,用[System.IO.Directory]::CreateDirectory($path)。Test-Path/Get-Item/Get-ChildItem/Remove-Item/Resolve-Path则都有-LiteralPath,该用就用