跳到主要内容

Telegram 记账机器人

一个功能完整的 Telegram 群组记账机器人，支持多币种记账、汇率管理、权限控制和数据统计等功能。包含全功能后台。

安全/稳定/高效/可靠

image-20250609141056620

💎优势特色​

  • 快速高效。
    • 可以在很低配置的主机执行。
  • 可溯源，防范修改。
    • 所有记录都可以点击溯源。后台也存储所有消息的初始信息以及修改后的信息。防止篡改。
  • 强交互，机器人反馈及时。
    • 所有账单指令都会有机器人点击表情来确认。
  • 功能完善。
    • 包含日常对账所需的汇率/计算器/标注功能。

💰 费用标准​

  • 客户自备服务器/域名独立部署： 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

image-20250609141541249

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

image-20250609141639944image-20250609141650359image-20250609141706780image-20250609141711264image-20250609141715043

🔒 数据安全​

  • 所有敏感操作都有权限验证
  • 记账数据支持软删除，可恢复
  • 完整的操作日志记录
  • 支持数据备份和迁移

⚠️ 注意事项​

  1. 首次使用需要设置汇率才能正常记账
  2. 更换币种前需要清空现有记录
  3. 撤销操作只能撤销自己的记账记录（管理员除外）
  4. 编辑消息会被自动删除，防止记账混乱
  5. 机器人需要群组管理员权限才能正常工作

📞 技术支持​

如有问题或建议，请联系开发者 ： @MrMiHa。

💡 提示：发送任何命令前，请确保机器人已激活且您拥有相应权限。初次使用建议先设置汇率和费率。