第一次安装插件
插件安装是管理员操作。plugin manifest 会声明身份、包来源、权限、依赖、入口点和可选 skills;它不会自动授予自己访问权限。Soha 仍然会执行 RBAC、Gateway grant、access policy、approval、audit 和 secret 管理。
前置条件
- 已按 第一次部署 启动 Soha 控制平面。
- 有一个具备 plugin-management 权限的 administrator profile。
- 控制平面已经配置 marketplace source。
查看 Marketplace 条目
soha plugin search
soha plugin show <id>API reference 名称是:
GET /api/v1/plugins/marketplaceGET /api/v1/plugins/marketplace/:pluginID
安装前先检查 plugin manifest 中的字段:
- publisher
- version
- checksum 或 signature 状态
- requested permissions
- required secrets
- capability refs
- entry points
安装并启用
soha plugin install <id>
soha plugin list
soha plugin enable <id>安装路径会 snapshot manifest 和 source metadata,避免 marketplace 后续变化静默改变已安装实例。
验证安装状态
soha plugin show <id>直接使用 API 验证时,查看:
GET /api/v1/plugins/installedGET /api/v1/plugins/:pluginIDGET /api/v1/plugins/:pluginID/manifest
预期输出形状
Plugin 输出取决于配置的 marketplace。安装路径应区分 discovery、install 和 enablement:
Fixture artifact: first-plugin-install.expected.txt
soha plugin search
soha plugin show <id>
soha plugin install <id>
soha plugin enable <id>id name version
demo Demo Plugin 0.1.0
manifest: reviewed
installed: demo
enabled: demo
GET /api/v1/plugins/installed验收标准
- 安装前 marketplace entry 可见。
- 安装前已经 review plugin manifest。
- Install 记录 version 和 source metadata。
- Enablement 与 installation 分离。
- 权限不足的用户看到 disabled actions,而不是含糊的 plugin 状态。
已知缺口
Plugin signing、provenance、compatibility matrix 和 rollback governance 仍是路线图工作。一次成功安装不能证明插件包已经达到生产可信。
Last updated on