Documentation
系统设置与角色权限
系统设置与角色权限
适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。
设置入口与分组
进入 Halo 插件管理中的产品插件设置，按业务配置：
| 设置组 | 主要内容 |
|---|---|
| 通用设置 | 授权与优惠券清理、订单动作重试、支付返回页、公开 API Token、应用类型 |
| 版本推送 | 推送令牌、安装包存储策略、附件分组、下载地址前缀、包大小、归属用户及清理 |
| 授权站身份 | Provider ID、名称、API 与网站地址 |
| 支付设置 | 支付开关、渠道、积分换算比例和订单同步 |
| 会员能力接入 | 接入开关、站点根地址、专用服务令牌与预检 |
| 优惠设置 | 优惠券、推荐码、会员折扣及旧附赠配置 |
| 服务设置 | 服务条款、购买须知、客服联系方式与展示模板 |
页面与接口权限
| 权限 | 用途 |
|---|---|
plugin:product:console | 管理控制台 |
plugin:product:uc | 用户中心入口 |
plugin:product:public | 对应公开接口角色能力 |
页面权限与接口 RBAC 都需要核对。匿名公开角色仅放行指定展示及发现能力，不代表所有公开组写接口均可匿名调用。普通用户的订单、授权、卡密与认领按当前登录用户处理。
凭据各自用途
公开 API Token 用于受保护的展示查询；版本推送令牌用于 CI 推送和安装包上传；会员服务令牌用于服务端会员交易；MCP 访问密钥用于工具委托。产品插件许可证是另外的执行前提，这些凭据不能混用。
配置顺序与验收
先核对依赖与许可证，再配置支付、服务信息和产品；随后启用优惠、通知及外部对接。保存后分别用管理员、普通用户和未登录访客检查目标入口与接口结果。
授权站 Provider ID 作为稳定身份，应保持不变；地址迁移更新基础地址。修改支付或会员配置后应检查待确认订单，修改存储与地址配置后应检查已有版本的实际下载结果。
常见问题
菜单不存在检查角色和插件启用；接口 401 检查账号或插件授权；403 检查角色、Token 和独立推送权限；会员预检失败检查站点根地址及专用令牌。以实际接口响应判断原因，不能仅凭 HTTP 状态推断唯一根因。
评论