SuperAPI AI 工具集

codex-theme-switcher

设计与创作

查看项目

更新于 10-15 20:13

技能介绍

用途:从本地受管主题库 ~/.codexthemes/themes/<theme-id>/ 向运行中的 Codex 桌面应用应用主题、在已安装主题间切换、恢复原生外观,并核实实际生效的主题。该技能独立运行,其 TypeScript 脚本自带可逆注入运行时;不负责创建或编辑主题、从画廊安装或发布主题。

主要能力:列出已安装主题(id、名称、布局模式)及当前激活项;热切换主题(无需重启,输出 {"status": "active", "pagesThemed": n});在无调试端点时经用户许可用 --launch 重启并注入;内置可读性门禁,注入后按真实渲染像素检测文字对比度,不可读则自动回滚并报告 {"status": "reverted", "failures": [...]};用 status 探测每个 Codex 页面,报告 active、partial 或 inactive;支持 rollback 回到上一主题、restore 恢复原生外观。

使用方式:在已安装技能目录中运行命令。列出:npx tsx scripts/switch-theme.ts list;应用:npx tsx scripts/switch-theme.ts apply <theme-id>;需重启时加 --launch;验证:npx tsx scripts/switch-theme.ts status;回滚:npx tsx scripts/switch-theme.ts rollback;恢复原生:npx tsx scripts/switch-theme.ts restore;清除陈旧会话:apply <theme-id> --launch --relaunch。

适用场景:需要为 Codex 桌面应用更换外观、在多个已装主题间切换或临时恢复默认外观时。

限制:仅需 Node.js 20+、npx 和官方 Codex 桌面应用;运行时只注入自有 <style> 元素,不修改签名应用包;重启前须获用户明确许可;涉及重启时不能仅凭 apply 输出判定成功,须用 status 验证;启动器支持 macOS 与 Windows,Windows 下若检测失败可用 --app 指定完整 .exe 路径,某些安装版本(如 Microsoft Store 包)会丢弃调试标志,此时应如实说明限制,不得修改 WindowsApps 或安装目录下的文件;不在此编辑主题源,设计变更应交给 codex-theme-creator。