跳到正文
ThemeCC

提交主题

主题通过向 ThemeCC 仓库提交 Pull Request 收录。不需要账号,也没有表单。

打开仓库

步骤

  1. Fork 仓库,在 registry/desktop 或 registry/cli 下新建以主题 slug 命名的文件夹。
  2. 添加下面说明的文件。
  3. 在本地运行 pnpm registry:check。它与 Pull Request 里的检查相同。
  4. 提交 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 申请下架条目。