前言¶

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