Documentation

授权站身份与 Core 应用商店接入

授权站身份与 Core 应用商店接入

适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。

授权站身份配置

在产品插件授权站身份中配置稳定 Provider ID、显示名称、API 基础地址与网站基础地址。

Provider ID 使用反向域名格式，并作为稳定身份；产品发布后不应随域名迁移修改它。API 与网站地址需要无账号、查询参数和片段的 HTTPS 地址，域名迁移时更新地址字段。

Manifest 发现

GET /apis/public.product.muyin.site/v1alpha1/provider-manifest

当前契约为 provider-manifest-v1，包含 providerId、issuer、名称、基础地址以及 license-v1、marketplace-v1、bundle-v2、bundle-v1 能力。

Manifest 是公开身份和能力信息，不包含可直接信任的密钥材料。Core 发现之后仍需按其授权中心配置完成登记、信任与账号绑定。

产品准备

  1. Halo 插件单品设置 HALO_PLUGIN，主题单品设置 HALO_THEME。
  2. 发布产品，并提供可用在线版本、下载地址及兼容范围。
  3. 套餐配置独立父 Key、有序成员和可购买报价；父 Key 留空应用类型，不配置安装包。
  4. 在实际 Core 端检查目录、账号绑定、购买与授权入口。

Marketplace 契约

marketplace/list 和 marketplace/{key} 提供应用目录与详情。授权接口提供当前站点授权、授权列表、域名迁移及删除；套餐父订单通过 orders/{orderId}/fulfillment-plan 获取并推进权益计划。

支持套餐的客户端在 X-Muyin-Marketplace-Capabilities 中声明 bundle-v1 或 bundle-v2；旧客户端未声明能力时看不到并且不能购买套餐。bundle-v2 提供稳定权益错误码与可重试性，同时兼容读取旧版计划。

两端职责与验收

产品插件维护销售、订单快照和成员权益，Core 按成员的具体订单 ID 完成授权、安装或更新、启动及验证。检查产品目录可见性、当前站点域名授权、安装包可达性、成员顺序及失败后继续安装。

实际安装结果必须在 Core 和 Halo 应用状态中确认；只拿到权益计划不能认定安装完成。自定义或空应用类型不会自动推断为可安装应用。

相关文档

评论