前言¶
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