技能介绍

要解决什么问题

WorkBuddy 桌面端的外观由官方包固定，想换配色、背景或上传自己的壁纸，通常意味着改 app.asar 或安装目录——既难维护，升级也容易被覆盖。重启客户端后，临时改 DOM 的折腾往往还会丢。你需要的是可逆的换肤：不动官方文件，又能随时回到原生界面。

技能如何工作

WorkBuddy Skin Studio 通过 Chrome DevTools Protocol（CDP） 连到本机 127.0.0.1 上的调试端口，定位渲染页 renderer/index.html，向正在运行的 UI 注入 CSS 与右上角 🎨 主题菜单。流程由 scripts/apply.mjs 串联：检测 WorkBuddy 安装位置（Windows 可优先从正在运行的进程反推路径）、必要时以 --remote-debugging-port=9223 重启客户端、等待 CDP 就绪后调用 src/cli.mjs apply。

核心模块分工清晰：src/cdp-client.mjs 负责连接与 renderer 发现；src/skin-css.mjs 覆盖 --cb-* 变量、背景与容器透明度；src/skin-menu.mjs 提供应用内切换、上传自定义图、删除主题与恢复原生；src/injector.mjs 做幂等的注入与移除。内置主题（如 miku-light、genshin-night 等）存放在 themes/，也可用 create 从本地图片生成自定义 themeId。启动器均为 plain Node .mjs，macOS 与 Windows 同一套命令，不依赖 .command / .ps1。

适用边界与注意点

面向 WorkBuddy 桌面版；Linux 不在官方桌面构建支持范围内。
需要 Node.js 18+（启动器也会尝试使用 WorkBuddy 自带的 Node）。
应用主题会重启 WorkBuddy，未保存的应用内工作会丢失，操作前请先保存。
皮肤只存活于当前 renderer 进程；手动重启 WorkBuddy 后注入会消失，需再次执行 apply；pause / scripts/pause.mjs 可移除皮肤且不改官方安装。
CDP 仅绑定回环地址，但在调试模式下仍应避免与不可信本地软件混用；禁止替换或编辑 WorkBuddy.app、app.asar 或 Windows 安装目录。

截图预览

使用场景

日常用 WorkBuddy 桌面客户端，想把界面换成 genshin-night 等内置主题，且不能改安装目录里的 app.asar。
用户提供 workbuddy-skin-studio 的 GitHub/SkillHub 链接，需要完成 WorkBuddy 检测、带 9223 调试端口重启并注入 CSS 与 🎨 菜单。
手动退出并重开 WorkBuddy 后皮肤消失，需要在不碰官方包的前提下重新 apply，或从菜单恢复原生外观。
手头有角色壁纸 WebP/PNG，要用 create 生成自定义 themeId，并在应用内上传或切换后微调背景与配色。