# WorkBuddy Skin — 快速部署指南（面向终端用户）

> 本文档介绍最简单、最快的部署方式，无需编写任何代码，5 分钟内完成换肤。

---

## 方式一：双击控制台（推荐，零配置）

适合所有 Windows 用户，无需 Node.js。

### 步骤

1. **下载解压项目**
   ```
   从 GitHub 下载 ZIP → 解压到任意文件夹（如 D:\WorkBuddySkin）
   ```

2. **双击运行** `一键启动主控制台.bat`

3. **选择操作**（界面为英文）
   | 按键 | 功能 |
   | :--: | :--- |
   | `1`  | 一键应用默认皮肤（初音白日梦 portrait-night） |
   | `2`  | 查看已安装皮肤列表 |
   | `3`  | 恢复官方原生外观 |
   | `4`  | 创建桌面快捷方式（以后双击即用） |
   | `5`  | 环境诊断（排查问题） |

4. **首次使用提示**
   - 确保 WorkBuddy 桌面助手正在运行
   - 如果提示 CDP 连接失败，选择 `[5] 环境诊断` 排查

---

## 方式二：一键部署为桌面快捷方式

想下次直接双击桌面图标换肤？选择控制台中的 `[4]` 即可。

快捷方式会自动：
- 启动 WorkBuddy（带 CDP 调试端口）
- 注入当前主题皮肤
- 全程无需手动操作

---

## 方式三：命令行快速应用（需 Node.js）

如果你有 Node.js 环境，可以直接在终端运行：

```bash
# 查看所有可用主题
node src/cli.mjs list

# 应用指定主题
node src/cli.mjs apply --theme portrait-night

# 恢复官方外观
node src/cli.mjs restore

# 环境诊断
node src/cli.mjs doctor
```

---

## 方式四：预编译单文件 exe（免 Node.js 依赖）

无需安装 Node.js，双击 `.exe` 即可运行：

```bash
# 构建单文件 exe（需要 Node.js 环境执行一次）
npm run build:exe

# 之后分发 dist/WorkBuddySkin.exe
# 用户双击即可使用
```

---

## 可用主题一览

| 主题 ID | 名称 | 风格 |
| :--: | :--- | :--- |
| `portrait-night` | 初音白日梦 | 清新粉色，适合办公 |
| `miku-488137` | 初音暗黑版 | 深邃紫黑，极客风 |
| `genshin-dawn` | 原神晨曦 | 温暖橙黄，提瓦特风 |
| `genshin-night` | 原神夜幕 | 深蓝夜空，星空感 |
| `naruto-hokage` | 火影火影 | 橙色热血，火影风 |
| `naruto-sasuke` | 佐助暗夜 | 暗紫神秘，宇智波风 |
| `wuthering-tide` | 鸣潮潮汐 | 清爽蓝白，冒险风 |
| `wuthering-echo` | 鸣潮回声 | 深蓝科技感，共鸣感 |
| `portrait-night` | 夜色肖像 | 深色肖像风，极简 |
| `deepspace-dawn` | 深空黎明 | 紫蓝渐变，科幻感 |
| `deepspace-star` | 深空星辰 | 深蓝星空，宇宙感 |
| `zoomlion-ai` | 中联智慧 | 企业蓝，AI办公 |
| `zoomlion-hq` | 中联总部 | 企业白标，B2B |

---

## 常见问题

**Q: 双击 .bat 没反应？**
确保 Windows 已安装 PowerShell 5.1 或 PowerShell 7+。

**Q: 应用后界面没变化？**
检查 WorkBuddy 是否正在运行，选择 `[5] 环境诊断` 查看 CDP 端口状态。

**Q: 如何恢复原版？**
双击控制台 → 选择 `[3]`，一键还原官方 UI。

**Q: 想在启动时自动应用？**
使用 `[4]` 创建桌面快捷方式，以后双击图标即自动触发。