开发者平台 · 7 / 9

客户如何取得、安装并授权你的插件

开发者提供说明、支持渠道和必要的服务地址；购买、安装确认和授权都由客户管理员在自己的主控里完成。下载、确认安装、启用是三个不同状态。

← 全部教程

客户的操作步骤

平台管理员打开主控“插件商店”（/dashboard/sys/plugin-store），查看发布者、类型、版本、价格与权限。
免费插件直接获取；收费插件先购买，付款完成后再获取。获取后插件进入租户的“插件市场”。
租户管理员在“插件市场”（/dashboard/sys/plugin-market）核对权限列表并确认安装；敏感权限和新增权限要单独勾选确认。
按类型到启用位置完成启用与配置（见下表），再用目标角色进入实际功能页，验证保存、刷新回读和一次真实调用。

类型	主控里的启用位置
theme	主题，/dashboard/sys/themes
rule_pack	规则包，/dashboard/site/rule-packs
provider	第三方服务商插件，/dashboard/sys/plugin-providers（先跑安装契约，全部通过才能启用）
ui_page、external_service	目标租户的插件市场安装列表

身份与权限

操作	需要
浏览、购买插件	平台管理员，marketplace.browse / marketplace.purchase
查看租户安装列表	当前会话属于目标租户，并有 plugin_installations.read
确认、升级、停用、卸载	plugin_installations.manage；接口要求 If-Match 与 Idempotency-Key

平台管理员身份与租户身份作用域不同，不能只看用户名判断当前身份。开发者不能替客户批准安装权限。

安装状态

状态	含义
pending_confirmation	已获取，等待租户管理员确认权限
authorized, installing	已确认，正在安装
enabled	已启用，能力生效
disabled	已停用：页面移除、调用拒绝、新事件停止
upgrade_failed_lkg_preserved	升级失败，保留最近一次有效版本
uninstalled	已卸载，授权撤销

看到插件出现在列表里，还要确认它是否已确认、已启用并完成配置。