WorkBuddy 换肤工作室

给 WorkBuddy 桌面端换一张会呼吸的脸。​

​

🎈

一张图，一种心情 · 本机 CDP 注入 · 不改官方安装包 · macOS + Windows​

​

非腾讯官方产品。不修改 WorkBuddy.app / app.asar / Windows 安装目录。​

​

给 AI 助手：如果你的用户把本仓库的 GitHub 地址发给你，并说"用这个开源项目帮我换 WorkBuddy 主题"，请直接阅读仓库根目录的 SKILL.md —— 里面是给 AI 的自动化安装流程（平台检测、运行 apply 脚本、选主题、验证、还原），照做即可，无需手动逐步操作。​

​

​

​

​

​

50%

​

​

​

​

50%

​

​

​

​

​

​

47%

​

​

​

​

53%

​

​

这是什么​

快速开始​

需要已安装 WorkBuddy 桌面端。下载本仓库后：​

用 AI 一键安装（推荐）​

不想自己敲命令？把本仓库的 GitHub 地址发给任意 AI 助手（CodeBuddy / Claude / Cursor 等），再加上一句：​

​

用这个开源项目帮我更换 WorkBuddy 的主题​

​

AI 会克隆仓库、读取根目录的 SKILL.md，自动完成平台检测 → 运行对应 apply 脚本 → 注入主题 → 验证状态，你只需在弹窗里保存好 WorkBuddy 当前任务即可。换肤后日常切换仍在右上角 🎨 菜单里进行。​

​

想指定主题也可直接说，例如「用深色原神主题」或「帮我换成 miku-light」。​

​

macOS​

​

代码块​

Plain Text

# 双击 scripts/apply.command，或命令行：​

./scripts/apply.command​

​

# 或指定主题​

node src/cli.mjs apply --theme genshin-night​

​

Windows​

​

代码块​

Plain Text

# PowerShell 运行​

.\scripts\apply.ps1​

​

# 或指定主题​

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

​

# 若找不到 WorkBuddy.exe，先跑排查脚本：​

.\scripts\find-workbuddy.ps1​

​

​

Windows 首次运行若报执行策略错误，执行： Set-ExecutionPolicy -Scope CurrentUser RemoteSigned​

​

应用皮肤时 WorkBuddy 会被正常退出并以本机调试模式重新打开，当前任务请先保存。​

之后的日常切换都在 WorkBuddy 右上角 🎨 菜单里完成。暂停皮肤、回到原生外观：​

​

代码块​

Plain Text

# macOS​

./scripts/pause.command​

​

# Windows​

.\scripts\pause.ps1​

​

​

注意：WorkBuddy 手动重启后注入会消失（CDP 方案的天性），重跑一次 apply 即可回来。​

​

主题切换菜单​

应用皮肤后，WorkBuddy 右上角（titlebar 下方）会出现 🎨 按钮：​

•

点击展开主题列表，点击任意主题即时切换​

•

「＋ 自定义图片」上传本地图片生成主题（canvas 自动取色 + 压缩成 webp）​

•

自定义主题行尾 × 一键删除​

•

「原生界面」恢复官方外观​

自定义主题​

用任意图片创建主题：​

​

代码块​

Plain Text

node src/cli.mjs create --image "/path/to/hero.webp" --name "My Skin"​

node src/cli.mjs apply --theme my-skin​

​

或直接在 🎨 菜单里选「＋ 自定义图片」上传，自动取色并持久化（localStorage）。​

极简主题格式​

​

代码块​

JSON

{​

"schemaVersion": 1,​

"id": "my-skin",​

"name": "My Skin",​

"hero": "hero.webp",​

​

只有 schemaVersion、id、name 和 hero 必填。图片必须位于主题目录内，颜色和文案（copy）都可省略。​

•

surface 的明度决定 light/dark 模式（亮度 > 140 为 light），自动切换 WorkBuddy 的 data-vscode-theme-kind​

•

hero 支持 PNG / JPG / JPEG / WebP​

命令行​

​

代码块​

Bash

​

内置主题​

​

​

设计边界​

•

这是一个轻量工具。皮肤跟随当前 renderer 存活，WorkBuddy 完整重载界面后重新运行一次 apply 即可​

•

CDP 只绑定本机回环地址 127.0.0.1，主题运行期间勿跑来路不明的本机程序​

•

不修改官方安装目录与代码签名​

•

深色主题已适配 data-vscode-theme-kind 自动切换；点「原生界面」恢复时默认回到 light（若你原生是 dark 需手动切回）​

•

当前版本针对 WorkBuddy 的 --cb-* 设计变量系统和 [data-view-id] DOM 锚点适配，与 Codex 的 DOM 结构完全不同​

技术原理​

以 --remote-debugging-port=9223 启动 WorkBuddy（Electron / Chrome 138）​

通过 http://127.0.0.1:9223/json/list 发现 renderer（过滤 renderer/index.html）​

用 CDP Runtime.evaluate 注入 CSS（