JAVA超级索引TG搜索机器人源码

这套源码是一个 Telegram 超级索引（搜索）机器人项目，核心用 Java + Spring Boot 开发，项目内名为「小九超级索引」（机器人 @xiao9soso_bot）。它面向 Telegram 用户，发送关键词即可检索已收录的群组、频道与机器人，并提供群组/频道排行、机器人内广告位、用户 TRX 钱包以及推广代理佣金等模块。源码包内带有数据库 SQL、Maven 配置、后端代码配置说明与一份完整的 Java 版搭建教程文档，适合想学习 Telegram Bot 开发、机器人检索与商业化模块实现的朋友做本地部署测试和二次开发参考。

适用场景

• 学习 Telegram Bot 的 LongPolling 开发模式与 MyBatis-Plus 数据层实现

• 搭建 TG 群组、频道检索与收录排行类的搜索机器人

• 研究机器人内广告位、推广代理佣金与 TRX 钱包充值提现的对接逻辑

技术栈与运行环境

• 前端：Vue 管理后台前端工程（源码包内另附，部署时需注意接口对接，详见下文提示）

• 后端：Java 1.8 + Spring Boot 2.6.11 + MyBatis-Plus 3.4.0

• 数据库：MySQL 8.0+

• 运行环境：JDK 1.8、Redis 7.0+、Maven 3.9+、Node.js（用于编译前端）

• 其他依赖：TelegramBots 6.5.0、TRON Trident（TRX 地址校验）、jsoup、fastjson、Swagger2、easyexcel

功能亮点

• 关键词搜索群组/频道/机器人：用户在私聊发送任意关键词即返回已索引结果卡片，支持翻页查看，对应 BotService 的 searcchInfo 与 KeyWordUntils。

• 群组频道收录与排行：机器人被加入群组时自动触发收录（onMyChatMember 事件），支持批量导入群组索引；并提供 /group、/channel 排行榜分页展示，对应 TgGroup、TgGroupIndexInfo 及对应控制器。

• 三类广告位：关键词排名广告、搜索置顶轮播广告、搜索结果底部固定键盘广告，分别对应 ket_word_advertisement、advertisement、keyboard_advertisement_pice 表与购买/支付回调逻辑。

• 用户钱包与 TRX：内置充值、提现、绑定/覆盖 TRX 提现地址、我已付款等流程，TrxUntils 提供 TRON 地址格式校验，对应 tg_user_withdraw、user_address 表。

• 推广代理体系：支持邀请下级、佣金账单、下级列表查询，对应 user_agency 表与 commissionStatement、subordinateList 回调。

• 管理后台接口：提供管理员登录、群组管理、用户管理、广告管理、提现审核、系统配置等 REST 接口（路径前缀 /superengine/*），便于运营端维护。

安装与部署提示

1. 准备环境：JDK 1.8、Redis 7.0+（务必设置密码）、MySQL 8.0+；导入 数据库 目录下的 suoyin_*.sql（默认库名 suoyin）。

1. 修改后端配置：编辑 application.yml 填写 Redis 与 MySQL 连接信息；在 Constants.java 中替换自己的 botToken 与 botName（需到 @BotFather 申请）；用 Maven 执行 clean 后 install 编译出 jar 包（默认端口 7530）。

1. 编译前端：进入管理后台前端工程执行 npm install 与 npm run build。注意该前端工程的接口路径与本项目后端不一致（详见截图说明），需要自行适配对接或替换为自研后台。

1. 启动 jar 并配置反向代理/域名后，将机器人添加到群组即可开始收录与搜索。

截图与演示说明

• 机器人私聊首页：/start 欢迎语与菜单（群组、频道、我的、帮助、购买广告、推广赚钱、官方频道等）

• 关键词搜索结果消息卡片：含分页「上一页/下一页」与结果条目

• 群组/频道排行榜分页消息：/group、/channel 命令返回列表

• 钱包相关页面：我的钱包、充值、提现地址、账单、佣金账单、下级列表

• 广告购买流程：关键词广告、置顶轮播广告、底部键盘广告的购买与支付确认

• 管理后台接口对应页面：管理员登录、群组管理、用户管理、广告管理、提现审核、系统配置

• 源码包内另含一套 Vue 管理后台前端工程（原工程 README 名为 boss-group-admin），其请求接口为 /api/robot/tgDice* 等路径，属于另一套机器人项目的前端，与本项目 /superengine/* 后端不对应，需自行重写对接后再使用。

• 常见问题

  运行前需要注意什么？

  需准备 JDK 1.8、Redis（必须设密码）、MySQL 8.0+；务必在 Constants.java 替换成自己的机器人 Token，数据库默认库名以 suoyin 为准（注意 application.yml 中残留的 xiao9mybot 配置需改回）。TRX 钱包相关逻辑依赖 TRON 地址校验，正式运营需自行完善节点与资金安全方案。

  适合二次开发吗？

  后端采用 Spring Boot + MyBatis-Plus，控制器、服务、Mapper 分层清晰，赠送的搜索/广告/代理/钱包模块都集中在 BotService 与对应控制器中，便于二次开发。但打包附带的前端工程接口路径与本项目后端不一致，需重写对接或另做后台，不能直接套用。

  安全风险提示

  特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！

  补充说明：源码中 botToken、botName 以及数据库账号密码以明文写在 Constants.java 与 application.yml 内（属示例配置），部署前请务必替换为自有凭据并妥善保管，避免机器人权限与数据库被他人利用。TRX 钱包与提现涉及资金，上线前请做完整的安全与合规评估。

  下载说明

  源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。涉及 Telegram 机器人、TRX 钱包与推广代理的功能，请遵守相关平台规则与所在地法律法规，勿用于违规或欺诈用途。