前言¶

WorkBuddy 桌面端基於 Electron，界面風格固定。若只想換主題、裝皮膚或按教程還原官方外觀，直接改安裝目錄或 app.asar 會動到簽名與更新路徑，風險高。社區裏已有通過 Chrome DevTools Protocol（CDP）向運行中的渲染進程注入 CSS 的做法，但自己要查端口、寫注入腳本、對平臺分支，步驟多。

下面介紹 SkillHub 上的 WorkBuddy 換膚工坊（@user_2f28e616/workbuddy-skin-studio，版本 1.0.0）。它把「檢測環境 → 應用主題 → 驗證 / 還原」寫成 Agent 可執行的 Skill，底層對齊開源項目 cdredfox/workbuddy-skin-studio（MIT），強調本機 CDP 注入、不改官方安裝目錄與簽名，且不收集憑證、不外傳數據（requires_api_key=false）。

這是什麼¶

WorkBuddy 換膚工坊是面向 WorkBuddy 桌面端的換膚 / 主題美化 Agent Skill，分類爲 design-media，來源爲社區（發佈者 user_2f28e616）。

Skill 的定位是：當用戶要安裝皮膚、更換主題、美化界面、還原官方外觀，或按微信文章 / 鏈接指示安裝 workbuddy-skin-studio 相關皮膚時，由 Agent 按 Skill 文檔驅動本機工具完成操作，而不是讓人手敲一整套 CDP 流程。

核心功能¶

以下能力與 SkillHub 簡介及上游開源項目說明一致，Skill 負責在對話裏觸發並編排這些能力。

1. CDP 注入換膚：通過本機迴環 CDP 向 WorkBuddy 渲染進程注入 CSS，覆蓋 --cb-* 等設計變量，不修改官方安裝包。
2. 安裝與切換主題：支持應用預設主題、指定主題 id（上游 CLI 示例如 genshin-night），應用後界面右上角可出現 🎨 菜單，在已裝主題與「原生界面」之間切換。
3. 自定義圖片主題：可從本地圖片生成主題（上游支持 PNG / JPG / JPEG / WebP），菜單內「＋ 自定義圖片」或 CLI create 流程。
4. 還原官方外觀：暫停皮膚或切回原生界面；上游提供 pause 類腳本 / 命令，官方目錄保持原樣。
5. 雙平臺腳本：上游提供 macOS（.command）與 Windows（.ps1）應用腳本；Skill 側由 Agent 做平臺檢測與調用。

觸發詞（SkillHub 標註）：換皮膚、裝主題、美化 WorkBuddy、workbuddy-skin-studio、🎨 菜單、CDP 注入。

安裝與啓用¶

SkillHub 頁面給出的安裝方式是：讓 Agent 按官方安裝說明安裝座標包。

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_2f28e616/workbuddy-skin-studio`。

若本機已安裝 skillhub CLI，可按 SkillHub 安裝文檔 將技能裝進當前 Agent 的 skills 目錄（未指定 --dir 時默認 ./skills/，Agent 可能無法加載）：

command -v skillhub && skillhub --version

skillhub install @user_2f28e616/workbuddy-skin-studio --dir <skills 目錄>

常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔，按你實際使用的 Agent 選一個）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/
• WorkBuddy：~/.workbuddy/skills/

CLI 未安裝時，文檔提供一鍵安裝腳本（需聯網）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安裝或更新 Skill 後，若 Agent 要求重啓客戶端，按其產品說明操作即可。

典型用法¶

通過對話啓用 Skill

在已安裝 Skill 的 Agent 裏，用自然語言說明意圖即可，例如：

• 「給 WorkBuddy 換皮膚 / 裝主題」
• 「按 workbuddy-skin-studio 美化 WorkBuddy」
• 「還原 WorkBuddy 官方外觀」

Agent 應讀取 Skill 內的 SKILL.md，完成平臺檢測、調用上游 apply 流程、選主題與驗證。上游 README 也建議用戶可說：「用這個開源項目幫我更換 WorkBuddy 的主題」，並可指定主題名（如「深色原神主題」或 miku-light）。

上游本機命令（Skill 編排的對象，非 Skill 專有 API）

應用皮膚前請先保存 WorkBuddy 當前任務；應用時客戶端可能以調試模式重啓。macOS 示例：

./scripts/apply.command
# 或
node src/cli.mjs apply --theme genshin-night

Windows 示例：

.\scripts\apply.ps1
.\scripts\apply.ps1 -Theme genshin-night

日常切換在 WorkBuddy 右上角 🎨 菜單完成；暫停 / 恢復原生可參考上游 pause.command 或 pause.ps1，以及 node src/cli.mjs pause。

查看環境與狀態：

node src/cli.mjs doctor
node src/cli.mjs status
node src/cli.mjs list

適用場景與注意¶

適合誰

• 已安裝 WorkBuddy 桌面端，希望快速換膚、試預設主題或上傳自定義圖，且不願改官方安裝目錄的用戶。
• 使用 Cursor、Claude Code、Codex、WorkBuddy 等支持 Skills 的 Agent，希望通過對話完成安裝與換膚流程的開發者。

限制與注意

• 非騰訊官方產品；皮膚素材權利歸各 IP 權利人，上游 README 已說明許可邊界。
• CDP 注入綁定本機 127.0.0.1；換膚運行期間避免運行不可信的本機程序。
• WorkBuddy 完整重啓或重載界面後注入會消失，需重新執行 apply（上游文檔明確說明）。
• Windows 首次運行腳本若遇執行策略錯誤，上游建議：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。
• SkillHub 頁面統計（抓取時）：評分 100000，下載 4786，安裝 0；數據以 SkillHub 實時頁面爲準。

結尾¶

WorkBuddy 換膚工坊把社區成熟的 CDP 換膚方案封裝成可安裝的 Agent Skill：本機操作、不動官方包、對話即可觸發。需要安裝或查看說明時，可打開 SkillHub 頁面：

• https://www.skillhub.cn/skills/user_2f28e616/workbuddy-skin-studio
• API 座標頁：https://api.skillhub.cn/user_2f28e616/workbuddy-skin-studio

上游實現與主題格式詳見：https://github.com/cdredfox/workbuddy-skin-studio