读者俱乐部概览与首次配置

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

用途

用收藏物、读者护照、互动活动和心愿墙，把签到、评论、阅读与线下相遇沉淀为读者自己的纪念。读者俱乐部独立于付费会员等级和积分账户：读者获得的徽章、称号与花园成长不会因积分消费或等级到期而失去。

前置条件

会员插件 1.5.0 及以上，站点已满足 Halo >= 2.27.0 与 LywqPluginCore >= 3.2.3。参与互动的读者需要已有会员档案且未被冻结；站长需要具备会员控制台权限。主题正常输出 Halo 模板页脚，文章活动卡片和公开护照组件才能自动加载。

操作入口

站长：控制台 → 会员管理 → 读者俱乐部（/console/member?tab=readerClub），包含「收藏与装扮」「读者活动」「选题许愿池」三个栏目。

读者：用户中心 → 会员管理 → 读者俱乐部（/uc/member?tab=readerClub），包含「读者护照」「收藏与装扮」「一起参与」「花园与伙伴」「年度回忆」「心愿墙」六个栏目。

操作步骤

在「收藏与装扮」创建一枚免费领取的纪念徽章并发布，让读者先走通领取、佩戴和公开护照的完整路径。
创建成就徽章，按累计签到天数、加入会员天数、审核通过的评论数或收藏文章数发放。
创建获取方式为「活动纪念奖励」的收藏物，作为活动完成奖励。该收藏物必须先发布，才能在活动中被选中。
在「读者活动」创建一次文章寻宝或专题探索路线，填写文章资源名、入口链接与步骤答案后发布。
需要花园玩法时，创建花园植物、博客宠物和花园装饰，由读者放入花园并每日照料。
需要积分兑换时，先在产品插件建立产品与积分价格，再创建「积分商品兑换」收藏物并关联产品标识与兑换页面。
用普通会员账号在用户中心完成一次领取、一次活动和一次许愿，核对护照、收藏册与活动进度。

预期结果与核对

控制台三个栏目可分别维护收藏物、活动和心愿；用户中心六个栏目可以打开，读者操作后护照佩戴物、收藏记录、活动进度与心愿状态随之更新。

限制与注意事项

读者俱乐部没有独立的功能总开关，随插件启用；相关记录使用 Halo 扩展资源存储，不需要数据库迁移。收藏物与活动都有草稿、已发布、已归档三种状态，已发布后不能退回草稿。日期统计与每日次数限制按 Asia/Shanghai 计算；后台时间选择器按当前浏览器时区录入，保存为统一时间。读者俱乐部不是付费等级的替代：等级决定权益，俱乐部只记录参与和纪念。

常见问题

读者看不到读者俱乐部？ 先确认读者已登录、已有会员档案且未被冻结，再检查插件版本与用户中心角色权限。
控制台没有读者俱乐部？ 核对插件版本；自建角色需要补充「控制台权限」中的俱乐部接口授权，内置角色由角色模板提供。
停用插件后记录会丢吗？ 停用或升级不会清空已产生的收藏、活动与心愿记录；卸载前应先备份。
能否用 MCP 管理俱乐部？ 当前会员 MCP 工具不包含读者俱乐部操作，仍需通过控制台或接口完成。