mcpField
C
codedrobe-theme-manager

codedrobe-theme-manager

github.com/qcrao设计与 UI1112 次安装15 周前更新
代码仓库

关于 codedrobe-theme-manager

用于通过 CodexSkins 库和 `@codedrobe/core` 管理 CodeDrobe 主题的 Skill，面向执行主题安装与维护的 Agent。它涵盖应用、验证和还原流程，并限制对应用程序包的修改。

主要功能

  1. 01安装并列出主题包
  2. 02应用和切换主题
  3. 03使用 Core 验证主题
  4. 04还原原生外观

适用场景

  1. 01按目录 ID 安装主题
  2. 02应用本地 `.codedrobe-theme` 文件
  3. 03通过截图验证渲染
  4. 04还原原有外观

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/qcrao/codedrobe-one-shot-theme-skill --skill codedrobe-theme-manager

安装后在 Claude Code 中输入/codedrobe-theme-manager确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
lifecycle.md
scripts/
apply_theme.mjs
restore_theme.mjs
self-test.mjs
theme_library.mjs

详细介绍

管理 CodeDrobe 主题

将软件包保存在受管理的 CodexSkins 库中，并且仅将已发布的 @codedrobe/core 用作运行时。切勿修补应用程序包，也不要执行主题包中的代码。

在排查监视器归属、平台路径或恢复失败问题前，请先阅读 references/lifecycle.md。

查找或安装

如果用户只提到一种视觉风格，请先使用 codedrobe-theme-finder。 如果用户提供了可安装的目录 ID，请运行：

node scripts/theme_library.mjs install <theme-id>

如果目录报告 downloadAuth: "google"，请勿尝试自动完成 Google 登录，也不要将登录页面当作软件包下载来源。请向用户提供主题详情 URL，让他们在浏览器中登录并下载，然后使用 apply_theme.mjs 检查并应用生成的本地 .codedrobe-theme 路径。

安装器只会下载 CodexSkins 目录中发布的软件包 URL，检查字节大小和 SHA-256，使用 CodeDrobe Core 检查软件包，然后将其写入 ~/.codexskins/themes/<theme-id>/。除非用户要求更新或批准使用 --force，否则安装器不会覆盖现有软件包。 仅在暂存或本地验证时使用 --catalog /absolute/catalog.json 或 CODEXSKINS_CATALOG_URL，切勿从不受信任的用户提供的目录安装。

使用以下命令列出或解析已安装的软件包：

node scripts/theme_library.mjs list
node scripts/theme_library.mjs resolve <theme-id>

应用或切换

应用主题表示用户希望查看该主题。如果请求明确要求安装并应用，请在安装后继续操作。否则，请说明安装路径并询问是否应用。

通过唯一归属的监视器应用主题：

node scripts/apply_theme.mjs --theme /absolute/theme.codedrobe-theme

如果 Codex 已提供 CDP，此操作会热应用主题。如果提示需要重启，请先征求许可，然后使用 --restart-existing 重新运行。不要将浏览或下载理解为已获得重启许可。

此辅助工具恰好管理一个 CodexSkins 监视器，因此切换主题时会替换旧监视器，而不是叠加注入器。它会将 CodeDrobe 绑定到 127.0.0.1 上的端口 9335，并支持 macOS 和 Windows，且不会修改 WindowsApps。

验证

此辅助工具最多等待 45 秒，直到运行时就绪。action: applied 包含精简的 Core 验证信息；action: submitted 表示限定等待时间已结束，并不构成视觉验证。Codex 可访问后，请运行：

npx --yes @codedrobe/core@latest verify \
  --app codex --port 9335 \
  --theme /absolute/theme.codedrobe-theme \
  --screenshot /absolute/verification.png

检查截图。报告主题 ID/版本、活动图像名称、渲染器配置、必需的界面标志、溢出情况，以及检查过的主页/对话/设置上下文。切勿声称已通过 macOS 运行验证 Windows。

恢复

恢复前请停止归属的监视器，以免其重新注入：

node scripts/restore_theme.mjs

将结果视为生命周期状态，而不是外观承诺：

  • native：渲染器和宿主状态已恢复为原生状态；无需重启。
  • restart-required：注入已移除，磁盘上的宿主外观已从备份恢复，但正在运行的 Codex 进程可能仍显示缓存的主题颜色。请征求重启许可。
  • watcher-stopped：Core 无法访问渲染器；必须完全退出并重新打开。

用户授权关闭 Codex 后，让辅助工具提交一个独立重启任务，使其在当前 Codex 任务关闭后仍能继续运行：

node scripts/restore_theme.mjs --restart-existing

Codex 重新启动后，捕获一份保护隐私的 Core DOM 快照。要完成恢复，必须满足 activeTheme.installed: false、没有 codedrobe-theme/宿主主题类、没有归属的监视器，并且计算后的背景颜色为原生颜色。切勿仅因 codedrobe restore 成功退出就声称已完全恢复。

边界

  • 仅使用目录声明的 HTTPS 下载，并验证其摘要。
  • 切勿修改应用程序包、app.asar、WindowsApps、身份验证数据或用户任务。
  • 如果本地软件包可能包含用户修改，切勿在未警告的情况下使用 --force 覆盖。
  • 切勿仅凭下载、检查或打包就声称主题已激活或已验证。

评论

支持 Markdown