workbuddy-skin-skill

name	workbuddy-skin-skill
description	在腾讯 WorkBuddy 内生成、应用、验证、导出和恢复可逆的定制 Skin。当用户提到 WorkBuddy Skin、皮肤、美化、暗色模式、界面配色、上传图片换肤、明星图片或明星风格定制、二次元风格、联网搜索灵感或恢复原生界面时使用。

WorkBuddy Skin Skill

在 WorkBuddy 内部运行本 Skill。通过 CodeDrobe Core 的本机 CDP 连接注入声明式 CSS，不修改 WorkBuddy 安装包、签名、账号、任务和用户数据。不要建议用户转到 Codex 安装或使用。

1. 判断任务

• 直接换肤：使用用户指定的内置 Skin；未指定时使用 focus-night。
• 上传图片或要求明星/二次元定制：读取 references/image-customization.md 和 references/skin-contract.md，完成图片分析、联网研究、生成、应用与截图验证，不只给建议。
• 检查 Skin：运行 probe 或 verify。
• 恢复：立即运行 restore，不改动其他 WorkBuddy 设置。

2. 检查环境

node scripts/workbuddy-skin.mjs doctor

如果 WorkBuddy 已使用其他 CDP 端口，从进程参数读取端口，并在后续命令传入 --port <port> --no-launch。如果 WorkBuddy 正在运行但没有开放 CDP，说明需要一次重启，获得用户授权后才使用 --restart-existing。

3. 使用内置 Skin

node scripts/workbuddy-skin.mjs list
node scripts/workbuddy-skin.mjs apply focus-night

内置 10 套：

• 基础：focus-night、warm-paper、cyber-lobster。
• 明星舞台氛围：stage-aurora、rose-glam、silver-idol。
• 原创二次元氛围：sakura-dream、mecha-core、magical-night、pixel-campus。

只在需要持续覆盖页面重载时增加 --watch。

4. 上传图片与联网定制

1. 在本地读取用户上传的图片，提取主色、光线、材质、抽象母题、构图和可读性线索。
2. 不根据人脸推断或确认人物身份。使用用户提供的姓名、作品名或文字线索搜索公开资料；没有身份线索时只搜索通用视觉风格。
3. 优先官方工作室、官方活动页和品牌发布页，保留 2–4 个来源链接。不上传私人参考图进行反向搜索，不默认下载搜索结果中的图片。
4. 选择最接近的内置 Skin，创建默认私有版：

node scripts/workbuddy-skin.mjs scaffold <new-id> \
  --from <base-id> \
  --name "<display name>" \
  --art "/absolute/path/to/uploaded-image.jpg"

5. 用户在本地要求“某明星风格”且提供了有权使用的图片时，必须把同一张大头像同时用于 .wb-home-page 主页和 .chat-container 聊天背景，并生成与图片一致的灯光、材质和配色氛围；不要只换按钮颜色。只有用户明确说“不要照片”时才省略 --art。
6. 将真人照片和私人定制包留在已被 Git 忽略的 local-themes/ 和 local-dist/。用户要求公开分享时，先确认素材权利；无法确认时只发布原创配色版。

5. 打包、检查与验证

node scripts/workbuddy-skin.mjs pack <id>
node scripts/workbuddy-skin.mjs inspect <id>
node scripts/workbuddy-skin.mjs apply <id>
node scripts/workbuddy-skin.mjs verify <id> --screenshot /absolute/workbuddy-skin.png

分别在主页和聊天页截图验证；明星大头像必须在两处都清晰可见且不遮挡正文、输入框和导航。再检查侧边栏、任务页和产物页。将必要 DOM 地标缺失、文字难读、主体被遮挡或横向溢出视为失败。静态打包成功不等于视觉验证成功。

6. 恢复

node scripts/workbuddy-skin.mjs restore

验证失败或用户要求恢复时立即执行。用户明确要保留 Skin 时才保持当前注入。

7. 安全与原创边界

• 不修改、替换、重签名或接管 WorkBuddy 的 app.asar 和安装目录。
• 不隐藏导航、按钮、输入框、任务列表和产物入口。装饰层使用 pointer-events: none。
• 不在 CSS 中使用外部 url(...)、@import、远程字体、追踪像素或脚本。打包后必须执行 inspect。
• 公开明星氛围 Skin 不使用真实肖像、声纹、粉丝标识或官方 Logo。公开二次元 Skin 不使用现成角色、截图或官方素材。
• macOS WorkBuddy 5.2.6 已验证。Windows 只标记为实验性支持。

致谢与上游边界

保留上游来源：底层 CDP 注入机制、WorkBuddy 适配器和 .codedrobe-theme 技术格式来自 CodeDrobe Core，原作者为 Alone88（@anhao），上游使用 Apache-2.0 协议。

将本项目描述为 CodeDrobe 的 WorkBuddy Skin 场景扩展，不宣称重新发明其运行时。对外发布衍生版本时继续保留上游作者、仓库和许可证信息。

语言

• 用户用中文就用中文回复，用英文就用英文回复。
• 先给结论，再说明验证结果、联网来源和仍待确认的兼容性。