WorkBuddy Dream Skin

中文 · English

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

外部主题 / 换肤工具 · 本机 CDP 注入 · 不改官方安装包

一张图，一种心情 · 写代码，也要有氛围感

非 WorkBuddy 官方产品。不修改 app.asar / 安装目录 / 代码签名。

效果预览

默认主题「星河紫夜」（Starry River）：深紫蓝渐变星空背景、闪烁星光、品牌徽章、签名、拍立得装饰、丝带——全部位于 pointer-events: none 的装饰层，原生控件照常可交互。

换一张图（windows/assets/dream-reference.png），就能变成你的专属主题。

它能做什么

• 真·可交互：侧栏、输入框、按钮都是原生控件，不是整窗假截图贴上去
• 可换图：换一张喜欢的图，就能变成你的主题
• 可恢复：一键还原官方外观
• 相对安全：本机回环 CDP 注入，不改官方二进制与签名

快速开始

原理参考 Codex-Dream-Skin，本项目为其 WorkBuddy 适配版本。

前置要求

• Windows 10 / 11
• Node.js 18 或更新
• 已安装 WorkBuddy 桌面端

步骤

1. 安装（只需一次）—— 校验环境并创建桌面快捷方式：

   powershell -NoProfile -ExecutionPolicy Bypass -File windows\scripts\install.ps1

2. 启动换肤 —— 双击桌面的 Start WorkBuddy Dream Skin，或：

   powershell -NoProfile -ExecutionPolicy Bypass -File windows\scripts\start.ps1 -PromptRestart

   脚本会以 --remote-debugging-port 启动 WorkBuddy，连接回环 CDP，注入皮肤并保持守护。

3. 验证（可选）—— 截图确认皮肤已生效：

   powershell -NoProfile -ExecutionPolicy Bypass -File windows\scripts\verify.ps1 -ScreenshotPath "$env:USERPROFILE\Desktop\skin.png"

4. 还原 —— 双击桌面的 Restore WorkBuddy Dream Skin，或：

   powershell -NoProfile -ExecutionPolicy Bypass -File windows\scripts\restore.ps1
   # 加 -Uninstall 同时删除桌面快捷方式

自定义主题

1. 替换 windows/assets/dream-reference.png 为你喜欢的图（建议 512×512 或更大，PNG）。
2. 编辑 windows/assets/dream-skin.css 顶部的 --dream-* 颜色变量：

   :root.workbuddy-dream-skin {
     --dream-purple: #8b5cf6;  /* 主紫 */
     --dream-pink:   #ec4899;  /* 强调粉 */
     --dream-cyan:   #22d3ee;  /* 点缀青 */
     --dream-bg-0:   #0f0a1f;  /* 背景深色 */
   }

3. 重新 start.ps1，无需重新安装。

工作原理

install.ps1  →  校验 Node、发现 WorkBuddy.exe、建快捷方式
start.ps1    →  以 --remote-debugging-port=9336 启动 WorkBuddy（仅 127.0.0.1）
                → injector.mjs 守护进程连接 CDP
                → 探测主窗口 → 注入 CSS + renderer-inject.js
                → 监听导航/刷新，自动重新注入
restore.ps1  →  移除皮肤、停止守护、关闭调试端口、正常重开 WorkBuddy

皮肤 = dream-skin.css + renderer-inject.js + dream-reference.png，打包成 JS 字符串经 Runtime.evaluate 注入。

安全边界

• CDP 只绑 127.0.0.1，主题运行期间勿运行来路不明的本机程序（Chromium CDP 无同用户鉴权）
• 不修改官方安装目录与代码签名
• 不会改写 API Key / 模型配置
• ⚠️ 不要对正在使用的 WorkBuddy 会话换肤——启动会重启 WorkBuddy，可能丢失当前对话。请先保存，再换肤。

目录结构

workbuddy-dream-skin/
├── windows/
│   ├── scripts/
│   │   ├── injector.mjs        # CDP 注入核心
│   │   ├── common.ps1          # 发现/端口/状态/锁
│   │   ├── install.ps1        # 一次性安装
│   │   ├── start.ps1           # 启动 + 注入
│   │   ├── verify.ps1          # 验证 + 截图
│   │   └── restore.ps1         # 还原
│   ├── assets/
│   │   ├── dream-skin.css      # 星河紫夜主题
│   │   ├── renderer-inject.js  # DOM 集成层
│   │   └── dream-reference.png # 装饰图
│   ├── references/qa-inventory.md
│   ├── tests/run-tests.ps1
│   ├── SKILL.md
│   ├── CHANGELOG.md
│   └── README.md
├── docs/platforms.md
├── AGENTS.md
└── README.md / README.en.md

反馈与贡献

• Bug / 功能请求：请用 Issue 模板，附 run-tests.ps1 与 verify.ps1 输出。
• PR：请写清改动，并跑过 tests\run-tests.ps1、node --check 自检。

许可与声明

• 见 LICENSE（MIT）
• 非 WorkBuddy 官方产品；WorkBuddy 及相关权利归其权利人
• 效果图中的形象仅作主题示意；商用或公开再分发请自行确认肖像权与商标授权

---

Star 一下，换一张图，把你的 WorkBuddy 变成今天想要的样子。