# tgbot-verify **Repository Path**: bestForwarder_admin/tgbot-verify ## Basic Information - **Project Name**: tgbot-verify - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: feature - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-17 - **Last Updated**: 2026-01-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # SheerID 自动认证 Telegram 机器人 ![Stars](https://img.shields.io/github/stars/PastKing/tgbot-verify?style=social) ![Forks](https://img.shields.io/github/forks/PastKing/tgbot-verify?style=social) ![Issues](https://img.shields.io/github/issues/PastKing/tgbot-verify) ![License](https://img.shields.io/github/license/PastKing/tgbot-verify) > 🤖 自动完成 SheerID 学生/教师认证的 Telegram 机器人 > > 基于 [@auto_sheerid_bot](https://t.me/auto_sheerid_bot) GGBond 的旧版代码改进 --- ## 📋 项目简介 这是一个基于 Python 的 Telegram 机器人，可以自动完成多个平台的 SheerID 学生/教师身份认证。机器人自动生成身份信息、创建认证文档并提交到 SheerID 平台，大大简化了认证流程。 > **⚠️ 重要提示**： > > - **Gemini One Pro**、**ChatGPT Teacher K12**、**Spotify Student**、**YouTube Premium Student** 等服务在使用前需要更新各模块配置文件中的 `programId` 等验证资料，具体请参考下方"使用前必读"章节。 > - 本项目还提供了 **ChatGPT 军人认证**的实现思路和接口文档，详细内容请查看 [`military/README.md`](military/README.md)，用户可根据文档自行集成。 ### 🎯 支持的认证服务 | 命令 | 服务 | 类型 | 状态 | 说明 | |------|------|------|------|------| | `/verify` | Gemini One Pro | 教师认证 | ✅ 完整 | Google AI Studio 教育优惠 | | `/verify2` | ChatGPT Teacher K12 | 教师认证 | ✅ 完整 | OpenAI ChatGPT 教育优惠 | | `/verify3` | Spotify Student | 学生认证 | ✅ 完整 | Spotify 学生订阅优惠 | | `/verify4` | Bolt.new Teacher | 教师认证 | ✅ 完整 | Bolt.new 教育优惠（自动获取 code）| | `/verify5` | YouTube Premium Student | 学生认证 | ⚠️ 半成品 | YouTube Premium 学生优惠（见下方说明）| > **⚠️ YouTube 认证特别说明**： > > YouTube 认证功能目前为半成品状态，使用前请仔细阅读 [`youtube/HELP.MD`](youtube/HELP.MD) 文档。 > > **主要区别**： > - YouTube 的原始链接格式与其他服务不同 > - 需要手动从浏览器网络日志中提取 `programId` 和 `verificationId` > - 然后手动组成标准的 SheerID 链接格式 > > **使用步骤**： > 1. 访问 YouTube Premium 学生认证页面 > 2. 打开浏览器开发者工具（F12）→ 网络（Network）标签 > 3. 开始认证流程，搜索 `https://services.sheerid.com/rest/v2/verification/` > 4. 从请求载荷中获取 `programId`，从响应中获取 `verificationId` > 5. 手动组成链接：`https://services.sheerid.com/verify/{programId}/?verificationId={verificationId}` > 6. 使用 `/verify5` 命令提交该链接 > **💡 ChatGPT 军人认证思路**： > > 本项目提供了 ChatGPT 军人 SheerID 认证的实现思路和接口文档。军人认证流程与普通学生/教师认证不同，需要先执行 `collectMilitaryStatus` 接口设置军人状态，然后再提交个人信息表单。详细实现思路和接口说明请查看 [`military/README.md`](military/README.md) 文档。用户可根据该文档自行集成到机器人中。 ### ✨ 核心功能 - 🚀 **自动化流程**：一键完成信息生成、文档创建、认证提交 - 🎨 **智能生成**：自动生成学生证/教师证 PNG 图片 - 💰 **积分系统**：签到、邀请、卡密兑换等多种获取方式 - 🔐 **安全可靠**：使用 MySQL 数据库，支持环境变量配置 - ⚡ **并发控制**：智能管理并发请求，确保稳定性 - 👥 **管理功能**：完善的用户管理和积分管理系统 --- ## 🛠️ 技术栈 - **语言**：Python 3.11+ - **Bot框架**：python-telegram-bot 20.0+ - **数据库**：MySQL 5.7+ - **浏览器自动化**：Playwright - **HTTP客户端**：httpx - **图像处理**：Pillow, reportlab, xhtml2pdf - **环境管理**：python-dotenv --- ## 🚀 快速开始 ### 1. 克隆项目 ```bash git clone https://github.com/PastKing/tgbot-verify.git cd tgbot-verify ``` ### 2. 安装依赖 ```bash pip install -r requirements.txt playwright install chromium ``` ### 3. 配置环境变量 复制 `env.example` 为 `.env` 并填写配置： ```env # Telegram Bot 配置 BOT_TOKEN=your_bot_token_here CHANNEL_USERNAME=your_channel CHANNEL_URL=https://t.me/your_channel ADMIN_USER_ID=your_admin_id # MySQL 数据库配置 MYSQL_HOST=localhost MYSQL_PORT=3306 MYSQL_USER=root MYSQL_PASSWORD=your_password MYSQL_DATABASE=tgbot_verify ``` ### 4. 启动机器人 ```bash python bot.py ``` --- ## 🐳 Docker 部署 ### 使用 Docker Compose（推荐） ```bash # 1. 修改 .env 文件配置 cp env.example .env nano .env # 2. 启动服务 docker-compose up -d # 3. 查看日志 docker-compose logs -f ``` ### 手动 Docker 部署 ```bash # 构建镜像 docker build -t tgbot-verify . # 运行容器 docker run -d \ --name tgbot-verify \ --env-file .env \ -v $(pwd)/logs:/app/logs \ tgbot-verify ``` --- ## 📖 使用说明 ### 用户命令 ```bash /start # 开始使用（注册） /about # 了解机器人功能 /balance # 查看积分余额 /qd # 每日签到（+1积分） /invite # 生成邀请链接（+2积分/人） /use <卡密> # 使用卡密兑换积分 /verify <链接> # Gemini One Pro 认证 /verify2 <链接> # ChatGPT Teacher K12 认证 /verify3 <链接> # Spotify Student 认证 /verify4 <链接> # Bolt.new Teacher 认证 /verify5 <链接> # YouTube Premium Student 认证 /getV4Code # 获取 Bolt.new 认证码 /help # 查看帮助信息 ``` ### 管理员命令 ```bash /addbalance <用户ID> <积分> # 增加用户积分 /block <用户ID> # 拉黑用户 /white <用户ID> # 取消拉黑 /blacklist # 查看黑名单 /genkey <卡密> <积分> [次数] [天数] # 生成卡密 /listkeys # 查看卡密列表 /broadcast <文本> # 群发通知 ``` ### 使用流程 1. **获取认证链接** - 访问对应服务的认证页面 - 开始认证流程 - 复制浏览器地址栏中的完整 URL（包含 `verificationId`） 2. **提交认证请求** ``` /verify3 https://services.sheerid.com/verify/xxx/?verificationId=yyy ``` 3. **等待处理** - 机器人自动生成身份信息 - 创建学生证/教师证图片 - 提交到 SheerID 平台 4. **获取结果** - 审核通常在几分钟内完成 - 成功后会返回跳转链接 --- ## 📁 项目结构 ``` tgbot-verify/ ├── bot.py # 机器人主程序 ├── config.py # 全局配置 ├── database_mysql.py # MySQL 数据库管理 ├── .env # 环境变量配置（需自行创建） ├── env.example # 环境变量模板 ├── requirements.txt # Python 依赖 ├── Dockerfile # Docker 镜像构建 ├── docker-compose.yml # Docker Compose 配置 ├── handlers/ # 命令处理器 │ ├── user_commands.py # 用户命令 │ ├── admin_commands.py # 管理员命令 │ └── verify_commands.py # 认证命令 ├── one/ # Gemini One Pro 认证模块 ├── k12/ # ChatGPT K12 认证模块 ├── spotify/ # Spotify Student 认证模块 ├── youtube/ # YouTube Premium 认证模块 ├── Boltnew/ # Bolt.new 认证模块 ├── military/ # ChatGPT 军人认证思路文档 └── utils/ # 工具函数 ├── messages.py # 消息模板 ├── concurrency.py # 并发控制 └── checks.py # 权限检查 ``` --- ## ⚙️ 配置说明 ### 环境变量 | 变量名 | 必填 | 说明 | 默认值 | |--------|------|------|--------| | `BOT_TOKEN` | ✅ | Telegram Bot Token | - | | `CHANNEL_USERNAME` | ❌ | 频道用户名 | pk_oa | | `CHANNEL_URL` | ❌ | 频道链接 | https://t.me/pk_oa | | `ADMIN_USER_ID` | ✅ | 管理员 Telegram ID | - | | `MYSQL_HOST` | ✅ | MySQL 主机地址 | localhost | | `MYSQL_PORT` | ❌ | MySQL 端口 | 3306 | | `MYSQL_USER` | ✅ | MySQL 用户名 | - | | `MYSQL_PASSWORD` | ✅ | MySQL 密码 | - | | `MYSQL_DATABASE` | ✅ | 数据库名称 | tgbot_verify | ### 积分配置 在 `config.py` 中可以自定义积分规则： ```python VERIFY_COST = 1 # 验证消耗的积分 CHECKIN_REWARD = 1 # 签到奖励积分 INVITE_REWARD = 2 # 邀请奖励积分 REGISTER_REWARD = 1 # 注册奖励积分 ``` --- ## ⚠️ 重要说明 ### 🔴 使用前必读 **在使用机器人之前，请务必检查并更新各模块的验证配置！** 由于 SheerID 平台的 `programId` 可能会定期更新，以下服务在使用前**必须**更新配置文件中的验证资料： - `one/config.py` - **Gemini One Pro** 认证（需更新 `PROGRAM_ID`） - `k12/config.py` - **ChatGPT Teacher K12** 认证（需更新 `PROGRAM_ID`） - `spotify/config.py` - **Spotify Student** 认证（需更新 `PROGRAM_ID`） - `youtube/config.py` - **YouTube Premium Student** 认证（需更新 `PROGRAM_ID`） - `Boltnew/config.py` - Bolt.new Teacher 认证（建议检查 `PROGRAM_ID`） **如何获取最新的 programId**： 1. 访问对应服务的认证页面 2. 打开浏览器开发者工具（F12）→ 网络（Network）标签 3. 开始认证流程 4. 查找 `https://services.sheerid.com/rest/v2/verification/` 请求 5. 从 URL 或请求载荷中提取 `programId` 6. 更新对应模块的 `config.py` 文件 > **提示**：如果认证一直失败，很可能是 `programId` 已过期，请按上述步骤更新。 --- ## 🔗 相关链接 - 📺 **Telegram 频道**：https://t.me/pk_oa - 🐛 **问题反馈**：[GitHub Issues](https://github.com/PastKing/tgbot-verify/issues) - 📖 **部署文档**：[DEPLOY.md](DEPLOY.md) --- ## 🤝 二次开发 欢迎进行二次开发！但请遵守以下规则： 1. **保留原作者信息** - 在代码和文档中保留原仓库地址 - 注明基于本项目进行的二次开发 2. **开源协议** - 本项目采用 MIT 开源协议 - 二次开发的项目也必须开源 3. **商业使用** - 个人使用免费 - 商业使用请自行优化并承担责任 - 不提供任何技术支持和担保 --- ## 📜 开源协议 本项目采用 [MIT License](LICENSE) 开源协议。 ``` MIT License Copyright (c) 2025 PastKing Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction... ``` --- ## 🙏 致谢 - 感谢 [@auto_sheerid_bot](https://t.me/auto_sheerid_bot) GGBond 提供的旧版代码基础 - 感谢所有为本项目做出贡献的开发者 - 感谢 SheerID 平台提供的认证服务 --- ## 📊 项目统计 [![Star History Chart](https://api.star-history.com/svg?repos=PastKing/tgbot-verify&type=Date)](https://star-history.com/#PastKing/tgbot-verify&Date) --- ## 📝 更新日志 ### v2.0.0 (2025-01-12) - ✨ 新增 Spotify Student 和 YouTube Premium Student 认证（YouTube 为半成品，需参考 youtube/HELP.MD 使用） - 🚀 优化并发控制和性能 - 📝 完善文档和部署指南 - 🐛 修复已知 BUG ### v1.0.0 - 🎉 初始版本发布 - ✅ 支持 Gemini、ChatGPT、Bolt.new 认证 ---

⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！

Made with ❤️ by PastKing