Telegram 记账机器人
一个功能完整的 Telegram 群组记账机器人，支持多币种记账、汇率管理、权限控制和数据统计等功能。包含全功能后台。
安全/稳定/高效/可靠
💎优势特色
- 快速高效。
- 可以在很低配置的主机执行。
- 可溯源，防范修改。
- 所有记录都可以点击溯源。后台也存储所有消息的初始信息以及修改后的信息。防止篡改。
- 强交互，机器人反馈及时。
- 所有账单指令都会有机器人点击表情来确认。
- 功能完善。
- 包含日常对账所需的汇率/计算器/标注功能。
💰 费用标准
- 客户自备服务器/域名独立部署： 500u买断。
- 客户无服务器： 50u每月。
✨ 主要功能
🏠 基础功能
- 机器人激活：群组内激活/停用机器人
- 权限管理：设置群组操作员，精细化权限控制
- 多币种支持：支持 20+种主流币种记账
💰 记账功能
- 快速记账：支持
+金额/-金额快速记账 - 多种记账方式：
- 入款：
+100或入款100或上行100 - 出款：
-100或出款100或下发100 - 余额调整：
余额+100或余额-100
- 入款：
- USDT 记账：金额后添加
u标识，如+100u - 记账撤销：回复记账消息并发送
撤销或取消
📈 数据统计
- 实时余额查询：发送
查或c查看当前统计 - 详细报表：
- 入款总额及明细
- 出款总额及明细
- 余额调整记录
- 未下发金额计算
- 费率计算：自动计算应下发金额（扣除手续费）
🔧 参数设置
- 汇率设置：
设置汇率7.2 - 费率设置：
设置费率0.01（表示 1%手续费） - 币种设置：
设置币种JPY切换群组默认币种 - 商户设置：
设置商户号12345设置 HTPay 商户号
💱 USDT 价格查询
- 支付宝收款：发送
z0查看 USDT/CNY 支付宝价格 - 微信收款：发送
w0查看 USDT/CNY 微信价格 - 银行卡收款：发送
b0或k0查看 USDT/CNY 银行卡价格 - 其他币种：
t0- 泰铢(THB)e0- 欧元(EUR)p0- 菲律宾比索(PHP)y0- 英镑(GBP)
🧮 计算器功能
- 数学计算：直接发送数学表达式，如
100*7.2+50 - 支持运算：加减乘除、乘方运算
- 开关控制：
开启计算器/关闭计算器
📋 订单查询
- HTPay 查单：
查单 订单号查询 HTPay 订单状态
🚀 快速开始
1. 激活机器人
将机器人添加到群组后，管理员发送：
激活机器人
或简写：
激活
2. 设置操作员
管理员回复目标用户消息，发送：
设置操作人
或简写：
开权限
3. 配置参数
设置汇率（必须）：
设置汇率 7.2
设置费率（可选，默认 0%）：
设置费率 0.01
设置币种（可选，默认 CNY）：
设置币种 JPY
4. 开始记账
# 入款记账
+1000
入款1000
上行1000
# 出款记账
-800
出款800
下发800
# USDT记账
+100u
-50u
# 余额调整
余额+200
余额-100
5. 查询统计
查
或
c
PS：查询指令的账单明细内，含有记录超链接。可以点击跳转记账的消息。
📝 命 令列表
管理员专用命令
| 命令 | 说明 |
|---|---|
激活机器人 / 激活 | 激活机器人 |
设置操作人 / 开权限 | 设置操作员（需回复目标用户） |
取消操作人 / 关权限 | 取消操作员（需回复目标用户） |
清除数据 / 清空 / 清除 | 清空所有记账数据 |
操作员可用命令
| 命令 | 说明 |
|---|---|
设置汇率 数值 | 设置汇率 |
设置费率 数值 | 设置费率（-1 到 1 之间） |
设置币种 币种代码 | 设置群组默认币种 |
撤销 / 取消 | 撤销记账（需回复记账消息） |
+金额 / -金额 | 记账操作 |
余额±金额 | 余额调整 |
通用命令
| 命令 | 说明 |
|---|---|
查 / c | 查询余额统计 |
币种 | 显示当前币种 |
z0 / w0 / b0 | 查询 USDT 价格 |
显示u / 隐藏u | 控制 USDT 显示 |
开启计算器 / 关闭计算器 | 计算器开关 |
查单 订单号 | 查询 HTPay 订单 |
设置商户号 商户号 | 设置 HTPay 商户 |
💡 使用技巧
记账格式
- 支持小数：
+100.5、-88.88 - USDT 标识：金额后加
u，如+100u - 自动计算：系统自动按汇率换算显示
权限说明
- 管理员：拥有所有权限，通过环境变量
ADMINS配置 - 操作员：可以记账和设置参数，由管理员指定
- 普通用户：只能查看信息，无记账权限
币种支持
支持以下币种：EUR, GBP, JPY, CHF, CAD, AUD, NZD, PHP, CNY, SGD, INR, BRL, ZAR, SEK, NOK, THB, MXN, RUB, HKD, IDR
费率计算
- 费率为小数形式：0.01 = 1%
- 支持负费率：-0.01 = -1%（补贴）
- 应下发 = 总入款 × (1 - 费率) + 余额调整 - 总下发
🔧 部署说明
环境变量配置
BOT_TOKEN=你的机器人Token
ADMINS=管理员ID1,管理员ID2
PROXY_URI=代理地址（可选）
依赖安装
pip install -r requirements.txt
运行方式
# 运行机器人
python -m bot
# 运行管理后台API
python api_entry.py
📊 管理后台
系统提供 Web 管理后台，可以：
- 查看所有群组数据
- 管理用户信息
- 查看记账记录
- 广播消息
- 管理 HTPay 商户
默认管理员账号：
- 用户名：
admin/administrator - 密码：
123456
🔒 数据安全
- 所有敏感操作都有权限验证
- 记账数据支持软删除，可恢复
- 完整的操作日志记录
- 支持数据备份和迁移
⚠️ 注意事项
- 首次使用需要设置汇率才能正常记账
- 更换币种前需要清空现有记录
- 撤销操作只能撤销自己的记账记录（管理员除外）
- 编辑消息会被自动删除，防止记账混乱
- 机器人需要群组管理员权限才能正常工作
📞 技术支持
如有问题或建议，请联系开发者 ： @MrMiHa。
💡 提示：发送任何命令前，请确保机器人已激活且您拥有相应权限。初次使用建议先设置汇率和费率。