【插件发布】圈圈助手新人引导：八关互动教程、并发保护与权限检测

社区新用户注册后，往往不知道如何发送私信、使用 Markdown、发布帖子、点赞或收藏。仅依靠规则文档，很难让用户真正熟悉社区功能。

因此我制作了「圈圈助手新人引导」插件，通过 Rhex 原生私信、后台任务、发帖、点赞、收藏、积分和勋章能力，为新用户提供一套可交互的八关入门教程。

主要功能

新人注册后，机器人会通过私信自动发送欢迎内容，并依次引导用户完成以下任务：

1. 回复机器人私信

2. 发送一个有效链接

3. 发送表情

4. 正确提及用户
5. 使用 Markdown 排版文字

6. 在指定圈子发布符合要求的帖子

7. 点赞新人指南
8. 收藏新人指南

完成全部任务后，可自动发放积分和指定勋章。奖励、练习圈子、机器人账号、新人指南及教程文案均可在后台配置。

后台管理

插件提供独立的原生管理页面，支持：

• 开启或关闭新人引导
• 设置新注册用户自动触发
• 允许管理员手动发送测试教程
• 配置机器人账号、练习圈子和新人指南
• 设置毕业积分、毕业勋章及练习帖最低字数
• 自定义欢迎语、任务说明、成功提示和错误提示
• 使用站点名称、用户名、进度、奖励等模板变量
• 查看用户当前进度
• 提醒用户继续任务
• 重新开始指定用户的教程
• 清除指定用户的教程进度
• 自动检查练习圈子的实际发帖权限

目前内置 20 项可编辑教程文案和 18 个模板变量。

并发与顺序保护

插件针对多人同时参与教程的场景进行了专门处理：

• 使用 PostgreSQL 用户租约保证同一用户的事件按顺序执行
• 不同用户之间可以并行处理
• 使用数据库原子发送时隙控制机器人私信顺序
• 遵守 Rhex 原生私信发送频率限制
• 每条私信最多自动重试 5 次
• 重复点赞、收藏或重复事件不会重复结算
• 积分和勋章仅发放一次
• 多 Web 实例和多 Worker 实例之间共享进度与锁状态

已完成 20 个用户同时参与八关教程的并发模拟，所有用户均能正常完成，奖励和勋章没有重复发放。

权限兼容

插件会在保存配置和用户进入发帖任务前，检查目标圈子的真实发帖策略，包括：

• 普通用户是否允许发帖
• 是否允许普通帖子类型
• 积分、等级、VIP、认证和勋章门槛
• 是否要求审核
• 圈子状态是否正常
• 发帖间隔设置

如果站点临时关闭发帖权限，任务会进入可重试状态；权限恢复后可以继续处理。

如果用户没有编辑旧帖的权限，也可以重新发布一篇符合要求的帖子完成任务，不会卡死在编辑步骤。

安装方法

1. 下载附件 newcomer-guide-0.3.0-miya.zip
2. 进入 Rhex 后台的“插件管理”
3. 上传 ZIP 并启用插件
4. 打开“圈圈助手新人引导”管理页面
5. 配置机器人账号、练习圈子、新人指南和毕业奖励
6. 确认后台显示“新人发帖权限检查通过”
7. 使用测试用户发送一轮教程进行验证

插件不会修改 Rhex 核心文件，卸载后不会影响站点原有发帖、私信、积分和勋章功能。

环境要求

• 已在 Rhex 1.1.0 完成安装验证
• 站点已正确配置 PostgreSQL 和 Redis
• Rhex Worker 服务正常运行
• 已配置 SESSION_SECRET
• 正式站点使用 HTTPS
• 机器人账号需要提前注册并保持正常状态
• 练习圈子需要允许普通新用户发布普通帖子
• Rhex 已允许执行可信插件服务端代码

测试情况

该版本已完成以下测试：

• 插件上传、安装、启用和数据迁移
• 新用户注册后自动发送欢迎私信
• 八关任务完整流程
• 20 用户并发完成教程
• 同一用户重复事件去重
• 私信发送顺序与频率控制
• 积分和勋章幂等奖励
• 待审核帖子处理
• 禁止编辑后重新发帖
• 圈子权限临时关闭及恢复
• 多实例用户租约
• 后台任务成功消费
• 桌面端、平板和移动端适配
• 320、390、768、1024、1440 像素视口检查
• Web、Worker、PostgreSQL 和 Redis 运行检查

当前版本 14 项单元测试全部通过，线上冒烟任务无重试、无死信。

下载与校验

作者：Miya
版本：0.3.0
附件：newcomer-guide-0.3.0-miya.zip

SHA-256：

text
a699956652df54631063ffbf2cb8d96da02a2bac7403970968ccb0b9a7911b51

后续更新地址：
https://xingqiuwu.com/article/1543

以后钩子多了肯定还是要更新更多功能的，目前局限于纯插件