CodeDrobe 主题管理器用于管理 CodeDrobe 主题，将主题包保存在受管理的 CodexSkins 库中，并使用已发布的 @codedrobe/core 作为唯一运行时。它不会修补应用包，也不会执行主题包中的代码。
用途 该工具面向需要安全安装、应用和还原 CodeDrobe 主题的用户。它通过 CodexSkins.org 目录获取数据型 .codedrobe-theme 包，并确保整个过程不修改应用包或评估主题代码。
主要能力
- 安装：从 CodexSkins 目录下载主题包，检查字节大小和 SHA-256，使用 CodeDrobe Core 检查，然后写入 ~/.codexskins/themes/<theme-id>/。除非用户要求更新或批准 --force，否则拒绝覆盖现有包。
- 列出与解析：使用 node scripts/theme_library.mjs list 列出已安装包，使用 resolve <theme-id> 解析包路径。
- 应用与切换：通过单一拥有的监视器应用主题，命令为 node scripts/apply_theme.mjs --theme /absolute/theme.codedrobe-theme。当 Codex 已暴露 CDP 时热应用；若报告需要重启，需请求许可后使用 --restart-existing 重新运行。
- 验证：等待最多 45 秒运行时就绪，然后使用 npx --yes @codedrobe/core@latest verify 命令生成截图并检查主题 ID/版本、活动图像名称、渲染器配置、必需地标、溢出以及检查的 home/conversation/settings 上下文。
- 还原：先停止拥有的监视器，然后运行 node scripts/restore_theme.mjs。结果可能是 native、restart-required 或 watcher-stopped。若需重启，用户授权后使用 --restart-existing 提交分离重启。
使用方式
- 安装主题：node scripts/theme_library.mjs install <theme-id>
- 列出已安装：node scripts/theme_library.mjs list
- 解析主题：node scripts/theme_library.mjs resolve <theme-id>
- 应用主题：node scripts/apply_theme.mjs --theme /absolute/theme.codedrobe-theme
- 验证主题：npx --yes @codedrobe/core@latest verify --app codex --port 9335 --theme /absolute/theme.codedrobe-theme --screenshot /absolute/verification.png
- 还原主题：node scripts/restore_theme.mjs
适用场景 适用于需要管理 CodeDrobe 主题的 Codex 用户，特别是在 macOS 和 Windows 上。支持热应用和重启应用，并确保不修改 WindowsApps。
限制
- 仅使用目录声明的 HTTPS 下载并验证摘要。
- 绝不修改应用包、app.asar、WindowsApps、认证数据或用户任务。
- 当本地包可能包含用户编辑时，未经警告不得使用 --force 覆盖。
- 不得基于下载、检查或打包声称主题已激活或已验证。
- 如果目录报告 downloadAuth: "google"，不要自动化 Google 登录或跟随登录页面作为包下载。应提供主题详情 URL，要求用户在浏览器中登录并下载，然后使用 apply_theme.mjs 检查并应用本地 .codedrobe-theme 路径。
- 使用 --catalog /absolute/catalog.json 或 CODEXSKINS_CATALOG_URL 仅用于暂存/本地验证，绝不从未受信任的用户提供目录安装。
- 验证时需检查截图，报告主题 ID/版本、活动图像名称、渲染器配置、必需地标、溢出以及检查的上下文。不得从 macOS 运行声称 Windows 验证。
- 还原后，完整还原需要 activeTheme.installed: false、无 codedrobe-theme/host 主题类、无拥有的监视器以及原生计算背景颜色。不得仅因 codedrobe restore 成功退出就报告完整还原。