[农哥ng001]-自动回帖顶帖插件 v2.0.0-Discuz x 插件（2026年7月22日）
[农哥ng001]-自动回帖顶帖插件 v2.0.0========================================
适合版本：-Discuz x5 插件
一、功能介绍
========================================
本插件实现论坛自动回帖顶帖功能，让论坛保持活跃，主要特性：
【核心功能】
- 多规则管理：支持创建多条独立的回帖规则
- 多板块回帖：可指定特定板块或所有板块回帖
- 自定义回复内容：从文本文件读取回复内容，支持随机选择
- 智能帖子筛选：按最新、热门、精华、附件等条件筛选帖子
- 用户身份切换：支持指定多个用户随机回帖
【高级控制】
- 运行时间段控制：指定每天的运行时段
- 帖子回复限制：单个帖子最多回复次数
- 帖子天数限制：只回复指定天数内的帖子
- 回复间隔限制：同一帖子两次回复的最小间隔
- 规则执行间隔：每条规则的执行频率
【数据库管理】
- 数据库升级：自动检测并升级表结构
- 数据库备份：一键备份所有规则数据
- 数据库恢复：从备份文件恢复数据
========================================
二、安装方法
========================================
1. 将 ng001 目录上传到 Discuz! 的 source/plugin/ 目录下
2. 登录 Discuz! 后台，进入【应用】→【插件】管理页面
3. 找到 "[农哥ng001]-自动回帖顶帖" 插件，点击"安装"按钮
4. 安装完成后点击"设置"进入插件配置页面
5. 下载地址：天翼云盘：**** Hidden Message *****
【安装注意事项】
- 安装后插件会自动创建数据库表 `pre_ng001`（pre_ 为数据库前缀）
- 安装后会自动注册定时任务，每分钟执行一次
- 如需手动升级数据库，点击"数据库管理"→"数据库升级"
========================================
三、使用说明
========================================
3.1 规则管理
----------------------------------------
【添加规则】
点击插件首页的"添加规则"按钮，进入规则配置页面。
【编辑规则】
在规则列表中点击"编辑"链接，修改已有规则的配置。
【删除规则】
在规则列表中点击"删除"链接，确认后删除该规则。
【规则状态】
- 启用：规则正常运行，定时任务会执行此规则
- 禁用：规则暂停运行，定时任务不会执行此规则
----------------------------------------
3.2 规则配置参数详解
----------------------------------------
【选择板块】
- 功能：指定哪些板块需要自动回帖
- 操作：在下拉列表中选择一个或多个板块（按住 Ctrl 键多选）
- 说明：
- 不选任何板块：对所有板块生效
- 选择特定板块：只对选中的板块生效
- 支持多选：可同时选择多个板块
【回复内容文件】
- 功能：指定回复内容的文本文件路径
- 格式：相对于插件目录的路径，如 data/reply_content.txt
- 说明：
- 新建规则时自动生成随机文件名（如 data/txt_abc12.txt）
- 文件中每行一条回复内容，用 === 分隔
- 回帖时系统随机选择一条内容
- 文件编码必须为 UTF-8
【运行时间段】
- 功能：指定规则每天的运行时段
- 格式：开始时间-结束时间，如 6-23
- 说明：
- 6-23 表示每天 6:00 到 23:00 之间运行
- 0-24 表示全天运行
- 超出时间段时，规则不会执行回帖
- 时间为 24 小时制，无需补零
【帖子最大回复数】
- 功能：限制单个帖子的最大回复次数
- 单位：次
- 说明：
- 设置为 50：单个帖子回复达到 50 次后不再回复
- 设置为 0：不限制回复次数
- 防止对同一帖子过度回复
【帖子天数限制】
- 功能：只回复指定天数内发布的帖子
- 单位：天
- 说明：
- 设置为 5：只回复最近 5 天内发布的帖子
- 设置为 0：不限制帖子发布时间
- 避免回复过旧的帖子
【回复间隔限制】
- 功能：同一帖子两次回复之间的最小间隔
- 单位：秒
- 说明：
- 设置为 1200（20分钟）：同一帖子两次回复间隔至少20分钟
- 设置为 0：不限制回复间隔
- 防止短时间内对同一帖子频繁回复
【帖子选择方式】
- 最新发布的帖子：按发布时间从新到旧排序
- 热门帖子（回复最多）：按回复数量从多到少排序
- 精华推荐帖子：只选择精华帖进行回复
- 有附件的帖子：只选择带有附件的帖子
- 随机选择：随机选择帖子进行回复
【规则执行间隔】
- 功能：每条规则两次执行之间的最小间隔
- 单位：秒
- 说明：
- 设置为 300（5分钟）：规则执行一次后至少等待5分钟才能再次执行
- 建议设置为 300-600 秒（5-10分钟）
- 避免规则执行过于频繁
【回帖用户】
- 功能：指定哪些用户可以执行回帖
- 格式：用户名或UID，用 ||| 分隔
- 说明：
- 支持用户名：如 user1|||user2|||user3
- 支持UID：如 1|||2|||3
- 混合使用：如 user1|||2|||user3
- 保存时系统会自动验证用户是否存在
- 用户必须具有发帖权限
- 回帖时从列表中随机选择一个用户
【状态】
- 启用：规则正常运行
- 禁用：规则暂停运行
----------------------------------------
3.3 数据库管理
----------------------------------------
【数据库升级】
- 功能：检测并升级数据库表结构
- 使用场景：
- 插件版本更新后需要升级数据库
- 数据库表结构损坏时修复
- 操作步骤：
1. 点击"数据库管理"按钮
2. 选择"数据库升级"标签页
3. 系统会自动检测需要升级的内容
4. 点击"开始升级"按钮执行升级
- 升级内容包括：
- 创建缺失的数据表
- 添加缺失的字段
- 注册定时任务
【数据库备份】
- 功能：备份插件所有数据到服务器
- 备份路径：source/plugin/bakup/ng001/
- 文件命名：ng001_年月日_时分秒.sql（如 ng001_20260722_194500.sql）
- 备份内容：
- 所有数据表结构（CREATE TABLE）
- 所有规则数据（INSERT INTO）
- 操作步骤：
1. 点击"数据库管理"按钮
2. 选择"数据库备份"标签页
3. 点击"立即备份"按钮
4. 等待备份完成，查看日志确认成功
- 注意：备份文件保存在服务器上，建议定期下载到本地
【数据库恢复】
- 功能：从备份文件恢复插件数据
- 使用场景：
- 数据误删除或损坏时恢复
- 迁移插件数据到其他服务器
- 操作步骤：
1. 点击"数据库管理"按钮
2. 选择"数据库恢复"标签页
3. 在备份文件列表中选择要恢复的文件
4. 点击"恢复"链接，确认后执行恢复
- 注意：
- 恢复会覆盖当前所有数据，请先备份最新数据
- 恢复操作不可撤销
- 恢复后建议刷新页面查看数据是否正常
【下载备份】
- 在备份文件列表中点击文件名可下载备份文件到本地
【删除备份】
- 在备份文件列表中点击"删除"可删除不需要的备份文件
========================================
四、回复内容文件格式
========================================
回复内容文件格式示例：
不错
================
前排支持下
================
前排支持下分享
================
不错，支持下楼主
================
LZ说的很不错
================
顶一下，支持
================
支持支持
================
感谢分享
【格式说明】
- 每条回复内容独占一行
- 回复内容之间用 === 分隔（数量不固定，一个或多个均可）
- 支持 Discuz! BBCode 格式，如 粗体、红色
- 文件编码必须为 UTF-8
- 建议设置 10-50 条不同的回复内容，避免回复过于重复
【BBCode 示例】
不错
================
前排支持下
================
访问官网
========================================
五、回帖用户配置
========================================
【配置要求】
1. 用户必须是系统中已注册的正常用户
2. 用户所在用户组必须具有发帖权限
3. 用户不能被封禁或处于待验证状态
【配置格式】
- 使用 ||| 分隔多个用户
- 支持用户名和UID混合使用
【配置示例】
user1|||user2|||3|||user4
- user1：用户名
- user2：用户名
- 3：UID
- user4：用户名
【验证机制】
- 保存规则时系统会自动验证每个用户是否存在
- 不存在的用户会被自动忽略
- 页面会显示已验证用户的详细信息（用户名、UID、用户组）
【注意事项】
- 建议配置 3-10 个用户，避免单一用户频繁发帖被判定为灌水
- 用户组变更后需要重新验证用户权限
- 删除用户后需要从规则中移除该用户
========================================
六、定时任务说明
========================================
【任务注册】
- 插件安装后自动注册定时任务
- 任务名称：[农哥ng001]自动回帖顶帖
- 执行频率：每分钟执行一次
【执行流程】
1. 定时任务每分钟触发一次
2. 遍历所有启用的规则
3. 检查规则的运行时间段是否在当前时间范围内
4. 检查规则的执行间隔是否满足条件
5. 按照规则配置选择帖子
6. 从用户列表中随机选择一个用户
7. 从回复内容文件中随机选择一条内容
8. 执行回帖操作
9. 更新规则的最后执行时间
【手动触发】
- 可在后台【应用】→【任务】中手动执行任务
- 执行后会立即检查所有规则并执行回帖
【任务状态】
- 任务默认启用，可在任务管理中禁用
- 禁用任务后插件将停止自动回帖
========================================
七、数据库结构
========================================
插件数据表：pre_ng001
字段说明：
- id：记录ID（自增主键）
- fid：板块ID（逗号分隔，为空表示所有板块）
- reply_content：回复内容文件路径
- time_range：运行时间段（格式：开始-结束）
- max_reply_count：帖子最大回复数（0表示不限制）
- days_limit：帖子天数限制（0表示不限制）
- seconds_limit：回复间隔限制（秒，0表示不限制）
- sort_type：帖子选择方式（newest/hot/digest/attachment/random）
- interval_time：规则执行间隔（秒）
- uid_type：用户类型（custom）
- uid_list：用户列表（|||分隔的UID）
- status：状态（0禁用，1启用）
- last_time：最后执行时间（时间戳）
- dateline：创建时间（时间戳）
备份文件存储路径：
- source/plugin/bakup/ng001/
- 文件命名：ng001_年月日_时分秒.sql
========================================
八、注意事项
========================================
【使用规范】
1. 请确保配置的回帖用户有发帖权限，否则回帖会失败
2. 回复内容不宜过于重复，建议设置多种回复内容（10条以上）
3. 执行间隔不宜过短，建议设置为 5-10 分钟
4. 建议设置合理的运行时间段，避免影响服务器性能
5. 定期备份数据库，以防数据丢失
6. 发帖频率需符合论坛规则，避免账号被封禁
【性能优化】
1. 不要同时启用过多规则，建议不超过 5 条
2. 每个规则的用户列表不宜过多，建议 3-10 个用户
3. 设置合理的帖子天数限制，减少查询范围
4. 避免选择"全部板块"，尽量指定特定板块
【安全注意】
1. 回复内容文件不要包含敏感信息
2. 备份文件包含敏感数据，请妥善保管
3. 不要将备份文件暴露在公共可访问路径
4. 定期检查定时任务是否正常运行
【常见问题】
Q: 插件安装后不自动回帖？
A: 检查定时任务是否启用，规则是否启用，运行时间段是否正确
Q: 回帖失败？
A: 检查回帖用户是否存在、是否有发帖权限、用户组是否正常
Q: 回复内容不显示？
A: 检查回复内容文件路径是否正确，文件编码是否为 UTF-8
Q: 备份文件无法生成？
A: 检查 source/plugin/bakup/ng001/ 目录权限是否可写
Q: 恢复后数据丢失？
A: 恢复会覆盖当前数据，请确保备份文件是最新的
========================================
九、更新日志
========================================
v2.0.0 (2026-07-22)
- 重新构建插件，使用模块化结构
- 添加多规则管理功能
- 添加自定义回帖用户列表（支持用户名和UID）
- 添加数据库管理功能（升级、备份、恢复）
- 修改表名为 pre_ng001，与插件标识一致
- 优化后台管理界面，使用统一的 CSS 样式
- 添加回复内容文件格式支持（=== 分隔）
- 增加运行时间段、帖子限制等高级控制功能
管理员你好，想问一下这个支持X5版本吗？ 免费分享出来的好工具，有需要的网友千万不要错过📝 期待后续更新优化，希望可以修复一些大家反馈出来的小问题 不需要充值开通权限，全部功能开放，日常使用完全足够📝 碰到无法启动的情况，可以回帖说明电脑系统版本，方便排查😀 使用中有不懂的地方，直接在帖子下方提问，会有大佬帮忙解答😀 有想法或者改进意见，欢迎在本帖回帖，供大家一起参考 遇到杀毒软件误报，可以回帖交流下，很多开源工具都会这样👏 遇到功能异常记得回帖描述清楚操作步骤，方便定位问题✨
页:
[1]