WorkBuddy换肤工坊

技能文档

---
name: workbuddy-skin-studio
title: WorkBuddy 换肤工坊
category: 开发工具
description: 为 WorkBuddy 桌面端一键安装社区主题皮肤，基于 CDP 注入 CSS 实现换肤，不修改官方安装目录与签名，纯本地操作、不收集凭证。当用户想要「换皮肤」「装主题」「美化 WorkBuddy」「更换界面」「还原官方外观」或按教程指示安装 workbuddy-skin-studio 皮肤时使用本技能。
---

# WorkBuddy 换肤工坊

## 概述

> **免责声明：** 本技能为社区第三方封装，与 WorkBuddy / 腾讯官方无任何隶属或关联，并非官方出品。所有主题与流程均来自 MIT 协议开源项目。

本技能为 **WorkBuddy 桌面端** 安装并应用第三方社区主题皮肤。它封装了开源项目 `cdredfox/workbuddy-skin-studio`（MIT 协议，<https://github.com/cdredfox/workbuddy-skin-studio>）。

**工作原理与安全边界：** 内置的 Node 启动器（`scripts/apply-node.mjs`）定位 `WorkBuddy.exe` → 以 `--remote-debugging-port=9223` 重启 → 通过 CDP 向运行中的渲染进程注入 CSS。它**不修改**官方安装目录、二进制文件或数字签名；**不读取也不传输**任何用户凭证、文件或网络数据；所有操作严格限定在本机。主题仅在当次运行有效——手动重启 WorkBuddy 会清除皮肤（重新执行 apply 即可恢复）。

**来源与授权：** `cdredfox/workbuddy-skin-studio` 是独立的社区开源项目，采用 MIT 协议。本技能仅自动化其官方文档记载的流程，不内置、不修改其代码。

本技能使用 Node 启动器（`scripts/apply-node.mjs`）作为可靠的换肤方式。**请勿使用仓库中的 `apply.ps1`**——参见注意事项。

## 适用场景

- 用户要求安装/应用 WorkBuddy 皮肤或主题（来自文章、链接或直接请求）。
- 用户想更换 WorkBuddy 外观、切换主题、或还原官方外观。
- 用户提及 "workbuddy-skin-studio"、🎨 菜单、或 CDP 换肤注入。

## 技能工作流

### 步骤1：克隆工具到纯 ASCII 路径

克隆到**不含中文/非 ASCII 字符**的路径——Node 无法从 Unicode 路径加载主题文件。

```bash
git clone --depth 1 https://github.com/cdredfox/workbuddy-skin-studio.git C:/Users/<user>/workbuddy-skin-studio
```

将克隆根目录记为 `REPO`（如 `C:/Users/15469/workbuddy-skin-studio`）。

### 步骤2：定位 WorkBuddy.exe

默认检测（LOCALAPPDATA、ProgramFiles）经常找不到实际安装位置。需显式定位：

```bash
# 在常见和 DevTools 位置全局搜索；回退到全盘搜索
Glob **/WorkBuddy.exe under C:\ and D:\
```

如果仍未找到，请用户提供确切路径，设为 `WB_EXE`。

### 步骤3：验证 CLI（只读检查）

```bash
node <REPO>/src/cli.mjs --check        # 语法检查
node <REPO>/src/cli.mjs list            # 确认内置主题被识别
node <REPO>/src/cli.mjs status          # 应显示 CDP 端口 9223 尚未开启
```

### 步骤4：应用主题（关键步骤）

以**分离模式**运行内置启动器，使其在 WorkBuddy 重启后仍能继续执行。将 `<theme>` 替换为具体主题名，如 `naruto-hokage`、`miku-light`、`genshin-night`、`deepspace-star`。

```bash
cmd //c 'start "" "<NODE>" "<SKILL_DIR>/scripts/apply-node.mjs" <theme>'
```

其中 `<NODE>` 为任意 Node ≥ 18（或托管运行时的 `process.execPath`），`<SKILL_DIR>` 为本技能目录。按需传递环境变量：

- `WB_EXE` — WorkBuddy.exe 路径（省略则自动检测）
- `WB_REPO` — 克隆仓库根目录（默认为当前目录）
- `PORT` — CDP 端口（默认 9223）

启动器将：终止 WorkBuddy → 以 `--remote-debugging-port=9223` 重新启动 → 等待渲染器 → 执行 `node <REPO>/src/cli.mjs apply`。进度写入 `<SKILL_DIR>/apply-log.txt`，结果写入 `<SKILL_DIR>/apply-result.txt`。

**为何需要分离模式？** 当前会话托管在 WorkBuddy 进程树内。在会话内（即使是后台任务）执行重启会在 `kill` 步骤时终止会话，导致注入无法完成。`start ""` 将启动器从进程树中脱离，使其独立完成。

### 步骤5：验证

WorkBuddy 重新打开后（数秒），确认右上角出现 **🎨 菜单**。可选探测 CDP：

```bash
curl -s -m 3 http://127.0.0.1:9223/json/list
```

如果 🎨 菜单未出现，读取 `<SKILL_DIR>/apply-result.txt`（`OK …` 或 `FAIL …`）和 `<SKILL_DIR>/apply-log.txt`。

### 步骤6：更换主题 / 还原

- 切换或上传主题：使用应用内 🎨 菜单。
- 还原官方外观：`node <REPO>/src/cli.mjs pause`
- 手动重启 WorkBuddy 后，重新执行步骤4即可恢复皮肤。

## 注意事项

- **切勿运行仓库中的 `apply.ps1`。** PowerShell 5.1 会错误解析 `$env:ProgramFiles(x86)` 等模式，在 `while`/`else` 闭合处抛出虚假的 "unexpected `}`" 错误。内置 Node 启动器完全绕开了 PowerShell。
- **克隆路径必须为纯 ASCII。** 中文路径（如 `F:\缓存\...`）会导致 Node 无法读取主题文件。
- **会话位于 WorkBuddy 进程树内。** 终止 WorkBuddy 会结束当前会话。务必通过分离的 `start` 命令执行 apply，不可内联执行。
- **CDP 仅限本地回环。** 调试端口绑定 `127.0.0.1`；皮肤生效期间避免运行来源不明的本机程序。
- **皮肤按次生效。** 手动重启 WorkBuddy 会丢失皮肤。

## 安全说明

**安全评估（低风险）：**
- **仅本地操作：** 通过本机回环地址（`127.0.0.1`）的 CDP 重启 WorkBuddy 并注入 CSS。无任何网络外连、无遥测上报。
- **不访问凭证：** 不读取密码、Token 或任何用户文件。
- **不改动官方文件：** 官方安装目录与签名保持不变，仅对内存中的渲染进程做主题化。
- **透明可审计：** 所有动作与上游项目文档步骤一致；可审阅 `scripts/apply-node.mjs`。
- **调试端口绑定回环：** 皮肤生效期间，避免运行来源不明的本机程序。

本工具为社区开源项目（MIT 协议），仅注入运行中的渲染进程，不触碰官方文件或凭证。应用主题时会重启 WorkBuddy——界面会短暂重启。

使用说明

# WorkBuddy 换肤工坊

为 WorkBuddy 桌面端一键安装社区主题皮肤，基于 CDP 注入 CSS 实现换肤，不修改官方安装目录与签名。

## 使用

告诉助手你想换皮肤即可：

```
帮我给 WorkBuddy 装一个主题皮肤
```

```
把 WorkBuddy 换成初音主题
```

```
还原 WorkBuddy 官方外观
```

## 工作原理

1. 克隆开源换肤工具到纯 ASCII 路径
2. 自动定位 WorkBuddy 安装路径
3. 以 CDP 调试模式重启 WorkBuddy
4. 通过 Node 启动器注入指定主题 CSS
5. 右上角出现 🎨 菜单，可即时切换主题或还原

## 安全说明

- 纯本地操作，通过本机回环 CDP 注入，无网络外连
- 不读取或上传任何凭证与文件
- 不修改官方安装目录与签名
- 主题仅当次运行有效，重启后重新执行即可恢复

## 注意事项

- 克隆路径不可包含中文字符
- 换肤过程会短暂重启 WorkBuddy
- 内置 10+ 社区主题（火影 / 初音 / 原神 / 恋与深空 / 鸣潮等）

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。