codedrobe-theme

CodeDrobe 主题

仅使用已发布的 @codedrobe/core CLI 作为运行时。保持此 Skill 仅包含指令：不要在 Skill 中重新实现注入器、启动脚本、软件包解析器或应用修补器。

路由请求

1. 明确识别目标应用。支持情况或默认值不确定时，运行 codedrobe apps --json。
2. 选择已安装、npm 或 Bun 命令运行器之前，先阅读 references/cli.md。
3. 只阅读目标应用对应的参考文档：
   • Codex：references/codex.md
   • WorkBuddy：references/workbuddy.md
   • QoderWork：references/qoderwork.md
   • TRAE SOLO：references/traework.md
4. 创建主题、处理图片、CSS、打包或转换旧版主题时，阅读 references/theme-authoring.md。
5. 请求中包含附加的或本地的视觉参考时，阅读 references/reference-image.md。
6. 新建或修复 CSS 时，阅读 references/dom-snapshot.md 和 references/css-templates.md。
7. 要查看完整的 Miku Future Beats / 初音未来示例，阅读 references/miku-future-beats-example.md。
8. 进行探测、验证、截图、缺失节点、CDP 故障排查或应用更新时，阅读 references/verification.md。
9. 将主题发布或提交到 CodeDrobe 商店时，阅读 references/publish.md。

解析常见请求

• “参考这张图片，帮我生成一个 Codex 皮肤”：检查提供的图片，根据实时 Codex DOM 快照创建 Codex 目标，打包，并在 Codex 中验证原生 UI。
• “把这个视觉风格同时做成 Codex 和 WorkBuddy 皮肤”：创建一个包含独立目标 CSS 和共享命名图片资源的主题包。
• “用玩偶姐姐示例改成蓝色版本”：将捆绑示例复制到可写项目中，修改其令牌和资源，刷新实时选择器，并验证两个指定上下文。
• “这个主题更新应用后错位了”：获取新的快照，修复主题 CSS 和主题专用验证节点，然后重新打包并对比截图。
• “帮我安装这个 .codedrobe-theme”：检查、探测、应用并验证提供的软件包；只有在验证失败且用户要求修复时，才重新创建。
• “从商店装一个复古主题到 Codex”：运行 codedrobe theme search 确定 slug（有多个匹配项时确认选择），运行 codedrobe theme download（通过完整性验证，保存到 ~/.codedrobe/themes），然后按常规流程执行检查 → 探测 → 应用 → 验证。
• “把这个主题发布到 CodeDrobe 商店”：补全 theme.catalog 列表元数据、打包、向用户确认，然后运行 codedrobe theme publish（仅在另行确认后才使用 --submit）。

将指定的目标应用视为明确指定。若未指定目标，且无法从提供的软件包或当前任务中推断出来，请先简洁地询问一个问题，再启动或应用任何内容。

应用现有主题

1. 应用前检查软件包。
2. 检测应用，并确定用户提供的安装路径或 CDP 端口。
3. 使用选定主题探测实时渲染器。兼容性按窗口判断：缺少必需适配器或主题节点的窗口会被跳过；只有没有任何符合条件的窗口时，应用才会失败。应用仍处于加载界面时运行探测，会报告所有地标缺失——应等待根地标出现后，再判断是否不兼容。
4. 应用主题。除非用户授权关闭并重启正在运行的应用，否则绝不要添加 --restart-existing。
5. 验证已安装的主题；需要视觉确认时，截取绝对路径截图。
6. 如果主题同时设置了主屏幕和普通对话的样式，请检查这两个界面。

选择 references/cli.md 中所述的命令运行器后，使用以下命令格式：

codedrobe theme inspect /absolute/theme.codedrobe-theme
codedrobe probe --app <app-id> --theme /absolute/theme.codedrobe-theme
codedrobe apply --app <app-id> --theme /absolute/theme.codedrobe-theme
codedrobe verify --app <app-id> --theme /absolute/theme.codedrobe-theme --screenshot /absolute/preview.png

创建或修复主题

1. 检查提供的参考图片，并在编写 CSS 前将其整理为简短的视觉说明。切勿将参考截图用作全窗口覆盖层。
2. 复制 assets/theme-starter/ 作为中性基础，或复制 assets/examples/miku-future-beats/ 作为完整的多应用示例。切勿直接修改已安装的 Skill。
3. 打开主题要适配的每个应用上下文，并分别捕获 codedrobe dom snapshot；不要仅凭模板推断选择器。
4. 从快照中选出语义候选项，然后在 html.codedrobe-host-<app-id> 下编写应用专属 CSS。
5. 将共享插图放在命名的 images 目录中；将应用专属选择器放在相应的目标 CSS 中。
6. 让适配器标记保持通用，并将主题布局假设放在主题专属的验证节点中。
7. 使用 Core 打包并检查输出，然后在真实渲染器上探测并应用主题。
8. 根据主页和对话截图迭代。仅凭静态 CSS、快照或软件包验证，不得宣称成功。

恢复

使用 Core 恢复，而不是删除应用数据或手动编辑宿主设置：

codedrobe restore --app <app-id>

确认 CodeDrobe 渲染器状态和主题样式均已移除。对于 Codex，如果之前存在事务性基础主题备份，也请确认该备份已恢复。

防护措施

• 切勿修补、替换、重新签名或接管应用程序包、app.asar 或 WindowsApps 文件。
• CDP 仅绑定到回环地址，并在启动、应用、监视、验证和恢复过程中使用同一个端口。
• 未经用户明确授权，不得终止或重启现有应用。
• 不要在同一渲染器上运行相互冲突的主题监视器。
• 将主题包视为不可信输入。不得执行主题 JavaScript，也不得允许外部 CSS 资源。
• 装饰层必须保持不可交互，并保留原生导航、编辑器、菜单和无障碍行为。
• 不得将私有参考图片上传到未经批准的图片服务。
• 只能通过 codedrobe theme publish 发布，绝不可使用临时拼凑的端点。发布和提交审核都必须获得用户明确确认，登录也必须通过用户批准的设备流程进行。