先确定你要交付什么
| 目标 | 插件类型 | 代码或文件在哪里运行 | 第一次建议 |
|---|---|---|---|
| 改用户控制台或公开网站的外观 | theme | 主控校验并加载受约束的主题内容 | 用主题工具生成 |
| 提供声明式防护规则 | rule_pack | 主控按规则模型校验，节点核心引擎解释执行 | 先确认规则模型支持目标能力 |
| 提供独立页面或报表 | ui_page | 你自己的 HTTPS 网站，主控用隔离 iframe 挂载 | 先验证页面来源，再接桥接 SDK |
| 提供 DNS、短信、邮件、备案或支付适配 | provider | 你部署的 HTTPS 服务 | 先跑通沙箱契约，再接真实供应商 |
| 订阅事件或调用开放接口 | external_service | 你部署的 HTTPS 服务 | 明确需要的权限与故障处理 |
插件类型、清单的 kind 和运行入口是三件事：新建插件时选类型；清单顶层 kind 固定为 Plugin；实际运行方式写在 spec.entrypoint。上传服务包不代表主控会执行其中的程序。
第一次发布建议先做免费插件，再加收费方案和外部服务，避免同时排查签名、审核、支付和调用问题。