提交主题
主题通过向 ThemeCC 仓库提交 Pull Request 收录。不需要账号,也没有表单。
打开仓库步骤
- Fork 仓库,在 registry/desktop 或 registry/cli 下新建以主题 slug 命名的文件夹。
- 添加下面说明的文件。
- 在本地运行 pnpm registry:check。它与 Pull Request 里的检查相同。
- 提交 Pull Request。CI 会校验条目。CLI 主题在检查通过后由维护者合并,桌面 mod 需要人工审核。
桌面版主题(mod)
主题代码保留在你自己的仓库里,条目用完整的 commit 哈希指向它。更新时提交新的 Pull Request,填入新的哈希。
registry/desktop/<slug>/theme.json、poster.webp(不超过 300 KB)、preview.mp4(可选,不超过 8 MB、15 秒)
规则
- 仓库必须公开,并带有被接受的许可证。
- 插件名必须与 slug 相同。
- 插件必须通过 claude plugin validate。
- 不接受混淆或压缩过的代码。请如实声明网络、文件和命令的使用。
- 预览画面必须是你自己的作品,或已获得使用许可。
- 不要自己添加 reviewed 字段。维护者阅读固定 commit 下的源码后会添加。
桌面主题的 theme.json 示例
{
"name": "Night Sky",
"description": {
"en": "A dark palette with a slow starfield behind the conversation.",
"zh": "深色配色,对话后方有缓慢移动的星空。"
},
"usage": {
"en": "Start a new local session in the Code tab. Run /night-sky off to remove it."
},
"author": { "github": "your-github-name" },
"license": "MIT",
"source": {
"repo": "your-github-name/night-sky",
"sha": "0123456789abcdef0123456789abcdef01234567"
},
"plugin": "night-sky",
"minClaudeCode": "2.1.324",
"colorScheme": ["dark"],
"motion": true,
"tags": ["space", "dark"],
"permissions": { "network": false, "files": false, "commands": false },
"preview": { "poster": "poster.webp", "video": "preview.mp4" },
"addedAt": "2026-01-01"
}CLI 主题
主题文件使用 Claude Code 官方格式,复制到 ~/.claude/themes 就能直接使用。
registry/cli/<slug>/theme.json 和 meta.json
规则
- theme.json 包含 name、base 和 overrides。颜色使用 #rrggbb、#rgb、rgb()、ansi256() 或 ansi:name。
- meta.json 写明作者和被接受的许可证。移植已有配色方案时,必须写明上游项目并保留其版权声明。
- 用你自己的话写的描述。
接受的许可证
MIT, Apache-2.0, BSD-2-Clause, BSD-3-Clause, ISC, CC0-1.0。许可证不明确的条目不予收录。
审核方式
CLI 主题只包含颜色值,自动检查通过后合并。桌面 mod 可以读写文件、发起网络请求和运行命令,所以维护者会阅读固定 commit 下的源码,并把结果记录在条目里。没有这条记录的条目会标明尚未审核。
下架
作者可以随时通过提交 Issue 或 Pull Request 申请下架条目。