第六章：发布到社区商店¶

这一章把前面写好的插件或适配器提交到 iamai 社区商店。商店不是运行时后端，而是随文档构建生成的静态 registry；提交入口使用 GitHub issue，维护者审核后再把条目合入 docs/ecosystem/entries。

准备扩展元数据¶

先确认扩展已经可以通过 uv add 安装，或者至少有一个公开仓库。可发布扩展至少需要这些信息：

id：全局唯一，例如 plugin.echo 或 adapter.acme。
type：plugin、adapter、ruleset、agent_tool 等。
name 和 summary：用于商店卡片展示，summary 保持一句话。
package 或 repository：至少填写一个。
license：例如 MIT、Apache-2.0。
entry_points：插件使用 iamai.plugins，适配器使用 iamai.adapters。
iamai_requires：第三方插件和适配器必须填写包元数据发布的标准 Requires-Dist 值，例如 iamai>=1,<2。
conformance_evidence：第三方插件和适配器至少提供一条公开、可复核的 CI、测试报告或命令输出 URL；agent_tool 不强制这两个字段。
runtime_capabilities：例如 network:http、storage:sqlite、agent:tool。
security_notes：声明网络访问、凭据需求、危险动作和可选依赖。
permission_notes：Agent 工具需要说明权限名、输入 schema、审计字段和审批要求。

使用文档表单提交¶

打开社区商店，点击“提交扩展”并填写这些字段。表单会实时生成候选 registry JSON，并在点击提交后打开 GitHub issue 页面。

兼容范围不是另一套手工版本声明。把 wheel 或 sdist 元数据里的 iamai Requires-Dist 原样填入 iamai_requires，维护者会将其和已发布包核对。conformance_evidence 应链接到能看到测试结果的 GitHub Actions、公开测试报告或保存了命令输出的公开 DNS 页面，不能使用裸 IP，也不能只写一条无法复核的本地命令。

Entry point 的填写格式是每行一个：

plugin:echo=iamai_plugin_echo:EchoPlugin
adapter:acme=iamai_adapter_acme:AcmeAdapter

表单不会让你声明 official、security_reviewed 这类认证徽章。它们代表维护者审核结论，不是扩展作者的自我声明。

使用 GitHub Issue Form 提交¶

你也可以直接在 GitHub 新建 issue，选择 Ecosystem submission 模板。这个模板和文档页表单使用同一组核心字段。如果你已经从文档页表单生成了 JSON，可以把它粘贴到 Candidate registry JSON 字段。 GitHub Issue Form 不支持按扩展类型设置条件必填；提交 ruleset、agent_tool 等其他类型时，在 iamai compatibility range 和 Conformance evidence 填写 Not applicable。文档页表单会自动预填。

维护者审核¶

维护者会检查包或仓库是否可访问、entry point 是否和包元数据一致、iamai_requires 是否匹配已发布的标准 Requires-Dist、conformance evidence 是否公开可复核、安装说明是否安全、是否含有密钥或私有地址，以及安全声明是否覆盖实际运行时能力。通过后，维护者把 JSON 合入 docs/ecosystem/entries/<id>.json 并运行：

uv run python scripts/validate_ecosystem_store.py

Checkpoint¶

完成后你应该得到一个带有 ecosystem-submission label 的 GitHub issue。issue 里包含一段 json 代码块，它可以直接作为 registry 条目的初稿。