Documentation
安装、授权与依赖准备
安装、授权与依赖准备
适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。
用途与前置条件
本文适用于站点管理员。准备 Halo 管理员账号、产品插件安装包，以及可用的产品插件授权。
当前插件描述文件声明以下运行条件：
| 组件 | 要求 | 作用 |
|---|---|---|
| Halo | >=2.26.0 | 插件运行平台 |
Lywq 核心插件 LywqPluginCore | >=3.0.0，必需 | 通用能力、授权和任务等依赖 |
支付插件 PluginPayment | 安装时要求 >=3.0.0 | 支付宝、微信等渠道支付 |
会员插件 PluginMember | 安装时要求 >=1.3.0 | 余额、积分、推荐码及会员折扣 |
| Halo MCP Server | 可选，>=1.0.0 & <2.0.0 | 对外提供产品 MCP 工具 |
可选依赖允许产品插件在未安装该组件时运行；使用对应功能前仍需安装、启用并配置相关组件。
安装步骤
- 在 Halo 插件管理中安装、启用满足版本要求的 Core。
- 安装产品插件并启用，按站点授权流程完成插件授权。
- 如需渠道支付，启用支付插件并准备可用支付渠道。
- 如需会员能力，启用会员插件；余额和积分还需配置产品插件专用的会员服务令牌。
- 打开产品插件设置，填写服务条款、购买须知和客服信息，再配置支付与优惠开关。
- 进入
/console/product检查产品管理页面；以普通用户登录检查/uc/product。
验收结果
管理员能进入控制台并查询产品，普通用户能进入用户中心。启用了支付能力时，还应使用低金额业务样例检查真实支付和订单同步；页面可打开仅证明入口可访问。
常见问题
插件启用失败时先核对 Halo 和依赖版本。页面存在但接口返回未授权时核对产品插件许可证和 Core 授权配置。普通用户缺少菜单时核对用户中心角色权限。会员支付不可用时按会员接入指南运行服务预检。
评论