主题（theme）开发指南

1. 新建插件，类型选 theme，插件 ID 如 acme.dev.ocean。
2. 写 theme.json：id 必须是 market.<插件 ID>，version 与插件版本相同。
3. 把 theme.json 的 SHA-256 写进 spec.entrypoint.sha256，权限只写 platform.themes.provide，签名并上传。

{
  "schema": "cdnca.theme/v1",
  "id": "market.acme.dev.ocean",
  "version": "1.0.0",
  "name": {"zh-CN": "海蓝", "en-US": "Ocean"},
  "description": {"zh-CN": "蓝色系主控外观"},
  "tokens": {"colorPrimary": "#1769aa", "borderRadius": 6},
  "layout_slots": {"login_layout": "centered", "sidebar": "dark"},
  "templates": {
    "styles": [{"selector": ".cf-page", "declarations": {"background-color": "token:colorBgContainer"}}],
    "error_page": "<!doctype html><html><head><title>{{title}}</title></head><body><main class=\"cf-page\"><h1>{{status}} {{title}}</h1><p>{{message}}</p></main></body></html>",
    "email": "<!doctype html><html><head><title>{{subject}}</title></head><body><main class=\"cf-page\">{{#lines}}<p>{{.}}</p>{{/lines}}</main></body></html>"
  }
}复制

签名与公钥登记见插件签名工具页。 签名工具与步骤 →

任何字符串里出现 url(、@import、expression(、javascript:、<script、<link、<iframe、<object、<embed、src=、href=、srcset= 都会被拒绝（header_links 的 url 与 base64 图片除外）。主题包最大 8 MiB。

上传后审核 worker 先跑“校验”阶段（manifest、入口、权限、本类型专属检查），出现任何拒绝项就不再扫描；再跑“扫描”阶段。结论：有拒绝项 → 需修改（修好后点“重新提交”，每个版本最多 10 次扫描）；有隔离项 → 待人工审核；都没有 → 视下列条件直接通过或进入人工审核。

• 首个版本（该插件还没有任何已审核版本）
• 权限与上一个已审核版本不同（增加或减少）
• 高风险类型：module、engine_module、provider
• 入驻未满 90 天的卖家（市场默认值，运营可调）
• 扫描连续 3 次出错

满足任一条即进入人工审核。完整规则表（规则 ID、级别、拒绝或隔离、是否试运行）见审核规则页。

• theme.invalid：不是合法的 cdnca.theme/v1（令牌、槽位、模板、外部引用），detail 里有 code 和 field（拒绝）。
• theme.id_mismatch：id 不是 market.<插件 ID>（拒绝）。
• theme.version_mismatch：主题 version 与插件版本不同（拒绝）。

本类型相关的规则见审核规则清单： metadata.* entrypoint.* permissions.* theme.*

审核用的就是主控的渲染器 libs/themepack 的 Render。在仓库根目录用它预检，报错的 code / field 与审核报告一致：

mkdir -p libs/themepack/cmd/thc && cat > libs/themepack/cmd/thc/main.go <<'EOF'
package main

import (
	"fmt"
	"os"

	"github.com/cdnca/cdnca/libs/themepack"
)

func main() {
	raw, _ := os.ReadFile(os.Args[1])
	r, err := themepack.Render(raw)
	if err != nil {
		fmt.Fprintln(os.Stderr, err)
		os.Exit(1)
	}
	fmt.Println(r.Package.ID, r.Package.Version, r.PackageSHA256)
}
EOF
GOWORK=off go -C libs/themepack run ./cmd/thc "$PWD/theme.json"复制

官方内置主题 libs/themepack/builtin/*.json 可作为完整写法参考（id 需改成 market.<你的插件 ID>）。