安装、授权与依赖准备

适用版本：会员插件 1.5.0 · 核对日期：2026-10-22

用途

准备会员插件所需的平台、依赖和产品授权，并确认管理入口可用。

前置条件

会员插件 1.5.0 声明 Halo >= 2.27.0，必需 LywqPluginCore >= 3.2.3。在线充值可选 PluginPayment >= 3.0.0；MCP 可选 mcp-server >= 1.0.0 且 < 2.0.0。

操作入口

Halo 控制台 → 插件，以及核心插件提供的产品授权配置入口。

操作步骤

1. 核对 Halo 和核心插件版本，先安装并启用核心插件。
2. 安装会员插件 JAR，在插件列表确认版本和启用状态。
3. 按核心插件授权流程配置会员插件的有效授权。产品标识为 PluginMember，当前声明的授权提供者为 site.muyin.auth。
4. 打开会员插件设置，先保持余额相关能力关闭并保存基本配置。
5. 进入 /console/member，再用普通会员账号访问 /uc/member。
6. 按业务需求另行配置支付或 MCP，分别验证，不把基础安装成功当作集成已完成。

预期结果与核对

后台可进入会员管理，普通用户可在授权范围内打开用户中心；升级到 1.5.0 后新增的「读者俱乐部」标签页可以直接使用，不需要额外配置开关。可选插件未安装时，不应要求站点使用对应功能。

限制与注意事项

版本要求以当前插件声明为准，旧教程中的 Halo 2.26.0 和核心插件 3.0.0 不适用于本版。产品授权检查与 Halo 登录权限是不同条件；登录成功不代表插件授权有效。读者俱乐部的收藏、活动与心愿记录随插件启用自动注册，不需要数据库迁移，升级不会清空已有会员数据。

常见问题

• 入口存在但业务请求失败？ 检查插件启用状态、产品授权、角色权限和日志。
• 没有支付渠道？ 检查支付插件版本、渠道配置和会员插件的支付开关，见在线充值。
• 升级后没有读者俱乐部？ 先确认插件版本为 1.5.0、Halo 与核心插件达到最低版本，再检查控制台角色权限。