经过数月的打磨，Telegram Federal Smart Governance Bot 正式开源。

这是一个面向 Telegram 多群组生态的去中心化智能治理系统，融合了 AI 语义审核、联邦信用评分 和 多级熔断防护，打破了传统 Bot 只能单群管理的局限。

项目地址 👉 GitHub: nq9831-ops/Telegram-Federal-Smart-Governance-Bot

核心理念

跨群组联邦信用治理体系 —— 一处违规，全域联防。

传统 Telegram 群管 Bot 只能在单个群内封禁用户，违规者换个群照样逍遥。Federal Governance Bot 通过 联邦信用分（0-100 分）让所有接入的群组共享同一套信用体系，任何一个群的违规记录都会影响用户在所有群的信用评级。

技术栈

语言Java 21
框架Spring Boot 3.2.12
数据库PostgreSQL + Redis + Elasticsearch
AI 引擎DeepSeek API（支持本地 Ollama 部署）
部署Docker Compose 一键部署

核心能力

🤖 AI 智能内容审核

  • 消息实时语义分析，自动判定违规等级（广告/色情/赌博/诈骗/政治敏感）
  • 80+ 违规模板预设，高频违规秒级匹配
  • 支持云端 DeepSeek API 和本地 Ollama 两种模式（数据零外出）
  • 异步审核队列处理，上限 10000，不影响消息主流程

🛡️ 联邦信用体系

  • 信用分 0-100，跨群组统一
  • 动态禁言阈值（35-70 自适应），不再一刀切
  • 乐观锁 + 3 次指数退避重试，事务级原子性
  • 信用分异动 ≥±15 分实时通知，±30 分自动告警工单

⚡ 四级熔断防护

  • L0 请求层：ConcurrencyGuard 信号量限流（审核 10 / ES 20）
  • L1 群组层：QPS / 违规率双指标滑动窗口熔断
  • L2 用户层：跨群违规用户 10 分钟静默封禁
  • L3 全局层：API 熔断 → 纯规则引擎降级

📋 智能工单系统

  • 负载均衡：根据审核员当前负载自动分配
  • 优先级调度：高优工单分配给负载低的审核员
  • SLA 超时升级：1x/2x/3x 超时自动向上级升票
  • 幂等保证：Redis SETNX + 24h TTL 防重复处罚

🏆 排行榜与画像

  • 用户信誉榜 / 群组环境榜 / 机器人服务榜 / 代理稳定榜
  • Top 20 展示，每周自动结算
  • 每日用户画像分析：风险等级 + 建议操作

安全设计

  • Webhook IP 白名单 + 请求限流
  • HMAC SHA256 签名验证 + 防重放时间戳校验
  • URL 安全校验（禁止内网 IP、云元数据地址、DNS 二次校验，防 SSRF）
  • 邀请码防刷：新号折扣 + 每日奖励上限 + 同 IP 检测 + 邀请链检测
  • 分布式锁基于 PostgreSQL advisory lock，事务级安全
  • 完整审计日志，所有操作可追溯

快速部署

git clone https://github.com/nq9831-ops/Telegram-Federal-Smart-Governance-Bot.git
cd Telegram-Federal-Smart-Governance-Bot

# 编辑 .env 填入 Bot Token 等配置
vim .env

# 一键启动
docker compose up -d

系统架构图：

                ┌─────────────────────────────┐
                │     ConcurrencyGuard         │
                │  Semaphore(审核=10, ES=20)    │
                │  Virtual Thread 风暴防护       │
                └──────┬──────────┬───────────┘
                       │          │
 Telegram ──HTTP──→ Webhook ──→ Virtual Thread ──→ AI 审核
                       │              ├─ DeepSeek API (云端)
                       │              └─ Ollama (本地可选)
                       ↓
         Spring Boot ─── PostgreSQL (核心数据)
                     ├── Redis (缓存/限流/分布式锁)
                     ├── Elasticsearch (评分数据)
                     └── Mini App 前端 (8080)

项目结构一览

完整代码 70+ 文件，含 11 个配置类、14 个数据模型、19 个业务服务、7 个命令处理器、6 个定时任务、5 版 Flyway 数据库迁移脚本。

适合谁用

  • 管理多个 Telegram 群组，需要统一治理方案
  • 对群内容质量有要求，不想被广告/诈骗信息淹没
  • 想要 AI 辅助审核但担心数据隐私（支持本地 Ollama）
  • 需要工单系统让管理员团队协同处理举报

开源协议

项目完全开源，欢迎 Star、Fork、PR。如有问题或合作需求，欢迎联系 [email protected]。

📌 项目持续迭代中，敬请关注 GitHub 动态