Telegram 自动打包上传机器人 通过 Telegram 消息触发项目的自动打包和上传。
WG-WEB Telegram 自动打包机器人
通过 Telegram 消息触发 WG-WEB 项目的自动打包和分发。
⚠️ 当前使用用户账号模式（User Bot），可发送最大 2GB 的文件！
功能特性
- 📦 发送分支名即可自动打包
- 🚀 自动拉取最新代码
- 📝 显示最新 commit 信息
- 📊 显示构建耗时和文件大小
- 🤖 自动发送打包文件到群组
- 🔐 支持用户权限控制
- 🌿 支持多分支构建
安装步骤
1. 安装依赖
cd telegram-bot
npm install
2. 获取 Telegram API 凭证
访问 https://my.telegram.org/apps
- 用你的手机号登录
- 点击 “API development tools”
- 填写应用信息：
- App title:
WG-WEB Builder - Short name:
wgbuilder - Platform:
Desktop
- App title:
- 创建后获取：
- api_id（数字）
- api_hash（字符串）
3. 配置 .env 文件
编辑 .env 文件：
# Telegram 用户账号配置
API_ID=你的api_id
API_HASH=你的api_hash
PHONE_NUMBER=+8613800138000 # 你的手机号（带国家码）
CHAT_ID=-1001234567890 # 目标群组ID（可选，留空则处理所有群组）# 项目配置
BUILD_PROJECT_PATH=../WG-WEB
ALLOWED_USERS= # 可选：允许的用户ID列表
4. 获取群组 ID（可选）
如果你想限制只在特定群组工作：
- 启动程序：
npm start - 首次运行会要求输入验证码，按提示操作
- 在任意群组发送消息
- 查看控制台输出的"群组ID"
- 将 ID 填入
.env的CHAT_ID
5. 克隆打包仓库
在 PackageRepos 目录下克隆一个专门用于打包的仓库：
cd ../
git clone <你的WG-WEB仓库地址> WG-WEB-Build
cd WG-WEB-Build
npm install
目录结构应该是：
PackageRepos/
├── telegram-bot/ # 本项目
├── WG-WEB/ # 开发目录
└── WG-WEB-Build/ # 打包专用目录
├── wg-web/ # 项目目录
使用方法
启动 Bot
npm start
或使用 nodemon 自动重启（开发模式）：
npm run dev
Bot 命令
在 Telegram 群组中：
| 命令 | 说明 |
|---|---|
/start | 显示帮助信息 |
/branches | 查看可用分支列表 |
/status | 查看配置状态 |
main | 打包 main 分支 |
dev | 打包 dev 分支 |
<分支名> | 打包指定分支 |
打包流程
- 在群组中发送分支名，例如：
main - Bot 自动执行：
- ✅ 切换到指定分支
- ✅ 拉取最新代码
- ✅ 安装/更新依赖
- ✅ 执行
npm run build - ✅ 压缩 dist 文件夹
- ✅ 发送到群组
- 接收打包文件
dist-<分支>-<时间>.zip
配置说明
.env 配置项
| 配置项 | 必填 | 说明 |
|---|---|---|
BOT_TOKEN | ✅ | Telegram Bot Token |
CHAT_ID | ✅ | 接收打包文件的群组 ID |
BUILD_PROJECT_PATH | ❌ | WG-WEB-Build 路径，默认 ../WG-WEB-Build |
ALLOWED_USERS | ❌ | 允许使用的用户 ID，逗号分隔，留空不限制 |
config.js 高级配置
{build: {buildCommand: 'npm run build', // 构建命令distPath: 'dist', // 输出目录zipOutputPath: './builds', // zip 存放目录autoInstall: true, // 是否每次都 npm installallowedBranches: [] // 允许的分支，留空不限制}
}
权限控制
限制特定用户使用
-
获取你的用户 ID：
- 向 bot 发送消息
- 查看控制台输出的 “用户ID”
-
在
.env中配置：
ALLOWED_USERS=123456789,987654321
限制可打包的分支
在 config.js 中配置：
allowedBranches: ['main', 'dev', 'release']
常见问题
1. Bot 没有响应
- 检查 Bot Token 是否正确
- 确认 bot 已添加到群组
- 查看控制台是否有错误信息
2. 无法获取群组 ID
- 确保 bot 已被添加到群组并有权限
- 在群组发送消息后查看控制台
- 或访问 getUpdates API
3. 构建失败
- 检查 WG-WEB-Build 目录是否存在
- 确认该目录是完整的 Git 仓库
- 检查分支名是否正确
- 查看控制台的详细错误信息
4. 文件发送失败
- 检查文件大小（Telegram 限制 50MB）
- 确认 bot 在群组中有发送文件权限
- 检查网络连接
开发说明
项目结构
telegram-bot/
├── index.js # 主程序，处理 Telegram 消息
├── builder.js # 构建逻辑，执行 git/npm 命令
├── config.js # 配置管理
├── package.json # 依赖配置
├── .env # 环境变量（不提交到 Git）
├── .env.example # 配置示例
└── builds/ # 临时存放 zip 文件（自动创建）
修改构建流程
编辑 builder.js 中的 fullBuild 方法。
添加新命令
在 index.js 中的 bot.on('message') 添加处理逻辑。
注意事项
⚠️ 安全提示：
- 不要将
.env文件提交到 Git - 不要公开你的 Bot Token
- 建议设置
ALLOWED_USERS限制使用权限
⚠️ 资源占用：
- 打包过程会占用 CPU 和内存
- 建议在服务器资源充足时使用
- 可以限制并发打包数量（当前不支持，可扩展）
维护
更新依赖
npm update
清理构建文件
rm -rf builds/*.zip
后台运行（Linux）
使用 PM2：
npm install -g pm2
pm2 start index.js --name wg-telegram-bot
pm2 logs wg-telegram-bot
使用 screen：
screen -S telegram-bot
npm start
# Ctrl+A+D 退出
License
MIT