用途:为受支持的 Chromium/Electron AI 桌面应用创建、检查、转换、应用、替换、验证、排障、更新或还原可逆的 CodeDrobe 主题。该技能本身仅包含指令,不重建注入器、启动脚本、包解析器或应用补丁器,运行时只使用已发布的 @codedrobe/core CLI。
主要能力与用法:先明确目标应用,支持情况不确定时运行 codedrobe apps --json。选择命令运行器前阅读 references/cli.md,并按目标阅读对应参考文档(Codex 用 references/codex.md,WorkBuddy 用 references/workbuddy.md);主题创作、图片、CSS、打包或旧版转换阅读 references/theme-authoring.md,新写或修复 CSS 阅读 references/dom-snapshot.md 与 references/css-templates.md,完整示例见 references/doll-sister-example.md,探测、验证、截图、缺失节点、CDP 失败或应用更新见 references/verification.md。
应用已有主题:先检查包,检测应用并解析用户提供的安装路径或 CDP 端口,用所选主题探测实时渲染器,缺少必需适配器或主题节点视为不兼容;随后应用主题,除非用户授权关闭并重启正在运行的应用,否则不要加 --restart-existing;最后验证并截图。常用命令: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。
创建或修复主题:可复制 assets/theme-starter/ 或 assets/examples/doll-sister/,不要就地编辑已安装技能;对每个要样式化的应用上下文分别执行 codedrobe dom snapshot,从快照选择语义候选,在 html.codedrobe-host-<app-id> 下写应用专属 CSS;共享素材放命名图片,适配器地标保持通用;用 Core 打包后检查输出,再在真实渲染器上探测和应用,依据首页与对话截图迭代。
还原:使用 codedrobe restore --app <app-id>,确认渲染器状态与主题样式已消失。
限制与护栏:不得修补、替换、重签名或接管应用包、app.asar 或 WindowsApps 文件;CDP 仅绑定回环地址并全程使用同一端口;未经明确授权不得终止或重启应用;不得对同一渲染器运行竞争的主题监视器;主题包视为不可信输入,不执行主题 JavaScript 或允许外部 CSS 资源;装饰层保持非交互并保留原生导航、输入框、菜单与无障碍行为;不得将私有参考图上传到未获批准的图像服务;主题发布在专用认证流程发布前不可用。