Bot 状态
—
服务/部署重启后会自动拉起 Bot（已配置 Token 时）。控制台点「停止」后不会自动拉起，需再点启动。改 Token/群 ID 后请停止再启动。
数据概览
使用说明总模块
群里游戏和私聊游戏独立运行，只共用同一套会员积分。下面按后台输入框逐项说明。
1. 机器人怎么申请
Telegram 搜索 @BotFather，发送 /newbot。
输入机器人显示名称，例如 手摇快三。
输入机器人用户名，必须以 bot 结尾，例如 shouyao_k3_bot。
BotFather 返回一串 Token，格式类似 123456:ABC...，复制到后台「系统设置 → Bot Token → 新 Token」。
把机器人拉进游戏群，给它发消息和发骰子的权限；如果要发开盘/封盘 GIF，群里不要禁用媒体消息。
@userinfobot，复制纯数字 ID。获取群 Chat ID：把机器人拉入群后发一条群消息，再看后台日志或运行诊断里的群 ID，通常是 -100...。2. 系统设置 · 每个输入框填什么
| 模块 | 输入框 | 填写内容 | 注意 |
|---|---|---|---|
| Bot Token | 新 Token | BotFather 给你的完整 Token。 | 留空表示不改；改完后重启机器人。 |
| 基础参数 | 管理员 ID | Telegram 用户 ID，多个用英文逗号分隔，例如 123,456。 | 主管理员可开盘，也用于后台识别。 |
| 基础参数 | 客服用户名 | 客服 Telegram 用户名，不带 @。 | 玩家点“联系管理员”时使用。 |
| 基础参数 | 游戏群组链接 | 群邀请链接，例如 https://t.me/+xxxx。 | 私聊菜单“游戏群组”按钮使用。 |
| 基础参数 | 机器人虚拟余额 | 庄家展示余额，例如 200000。 | 开奖后会随输赢自动变化，仅代表庄家展示资金。 |
| 群内设置 | 绑定群 Chat ID | 游戏群 ID，例如 -1003998015232。 | 只有这个群能下注、开盘、封盘、开奖。 |
| 群内设置 | 每期下注时长 | 选择 1 / 2 / 3 / 5 分钟。 | 从开盘到封盘，新期次生效。 |
| 群内设置 | 封盘到开奖间隔 | 秒数，建议 8 到 15。 | 封盘图发出后等待多久开始掷骰。 |
| 群内设置 | 机器人介绍 | Telegram 机器人详情页长介绍。 | 保存后会尝试同步到 Telegram。 |
| 群内设置 | 机器人短介绍 | Telegram 机器人资料页短描述。 | 建议一句话，不要太长。 |
| 开奖管理员 | 用户 ID | 允许发送 /开始下注 的 Telegram 用户 ID。 | 只填纯数字。 |
| 开奖管理员 | 备注 | 例如 总控、财务。 | 只给后台识别。 |
| 后台安全 | 新的管理密码 | 后台主管理员新密码。 | 至少 6 位。 |
| 后台安全 | 确认新的管理密码 | 再次输入同一个密码。 | 两次必须一致。 |
| 额外管理员 | 新增管理员账号 | 后台登录账号，例如 operator1。 | 不能用系统保留账号。 |
| 额外管理员 | 新增管理员密码 | 该后台账号的登录密码。 | 至少 6 位。 |
| 欢迎广告图 | 上传图片 | PNG 或 JPG。 | 用户私聊机器人点开始时展示。 |
3. 群内游戏怎么用
开盘流程
开奖管理员在绑定群发送 /开始下注。机器人发送开盘 GIF 和下注规则，倒计时结束后自动封盘，再自动掷骰开奖。
群内下注格式
dd10、ds10、xd10、xs10，也可发 大单 10、大双 10、小单 10、小双 10。
豹子1 10、豹子 1 10、bz1 10、bz 1 10。
定位胆4 10、定位胆 4 10、dwd4 10、dwd 4 10、4y 10。
取消与查询
封盘前发送 取消 可退回本期群内下注。发送 余额 查询余额、今日流水和今日输赢。发送 反水 领取待领反水。
玩家掷骰
单期最高投注达到系统阈值时，由该玩家掷 3 颗骰子；超时或时间不足时机器人接管补发。
4. 私聊游戏怎么用
独立规则
私聊下注是即时局，独立期号，独立开奖，不等待群内开盘。群里游戏和私聊游戏只共用同一套余额。
私聊下注
玩家私聊机器人发送和群里相同的下注格式，例如 大单10、定位胆 4 10。下注成功后立即掷骰并结算。
私聊菜单
👤 个人中心 查看余额流水；💰 我要充值 打开充值；💸 我要提币 申请提现；📝 我的注单 查看最近注单。
私聊高限红
在用户详情里勾选“启用私聊高限红”，保存后该会员可使用更高私聊限额（如果机器人侧已启用对应规则）。
5. 支付系统 · 每个输入框填什么
| 模块 | 输入框 | 填写内容 | 玩家侧效果 |
|---|---|---|---|
| TRC20 充值 | USDT TRC20 收款地址 | 你的 TRC20 USDT 地址，通常以 T 开头。 | 玩家生成充值订单后向该地址转账。 |
| TRC20 充值 | 最低充值 | 最小充值金额，例如 10。 | 低于该金额不允许下单。 |
| TRC20 充值 | 订单有效分钟 | 订单过期时间，例如 15。 | 超时未到账需重新下单。 |
| TRC20 充值 | 链上轮询间隔 | 检测到账频率，建议 3 到 10 秒。 | 越短越快，但接口请求更多。 |
| TRC20 充值 | Tron API Key | TronScan/TronGrid API Key，可留空。 | 提高查询稳定性。 |
| Okpay 充值 | 最低充值 | Okpay 最小充值金额。 | 低于该金额不允许下单。 |
| Okpay 充值 | 商户 ID | Okpay 商户后台提供的 Shop ID。 | 用于生成 Okpay 支付链接。 |
| Okpay 充值 | 商户 TOKEN | Okpay 商户密钥。 | 留空保留原 TOKEN；勾选清空则删除。 |
| Okpay 充值 | API 地址 | 默认 https://api.okaypay.me/shop/。 | Okpay 接口地址。 |
| Okpay 充值 | 回调 URL | 完整 HTTPS 地址，例如 https://你的域名/api/okaypay/notify。 | Okpay 支付成功后回调自动上分。 |
| Okpay 充值 | 备用付款链接 | 商户未配置或下单失败时展示的链接。 | 避免玩家无入口。 |
| 提币 | 最低提现 | 最小提现金额。 | 玩家低于该金额无法提交。 |
| 提币 | 启用提款密码 | 勾选后玩家首次提币要设置提款密码。 | 后台用户详情可清除会员提款密码。 |
6. 会员后台功能
用户列表
查看会员 ID、昵称、用户名、余额、流水、充值合计、投注次数、待领反水。余额每 8 秒刷新。
上分 / 调账
正数加款，负数扣款，都会写入充值/调账记录，并私聊通知会员。
后台提现扣款
直接扣会员余额并记为已通过，不走提现审核。只适合人工已经打款的场景。
提现审核
玩家在机器人里申请提现后，后台可通过或驳回。通过视为已打款，驳回会退回余额。
RTP 标记
在用户详情填 RTP 最小/最大百分比，用于运营标记，不直接改变公共结算公式。
删除会员
删除该会员余额、投注、充值、提现、反水等记录。操作不可恢复，需二次输入用户 ID。
7. 日常运营顺序
系统设置填 Token、管理员 ID、绑定群 Chat ID、客服、群链接、支付信息。
点击“保存基础设置”“保存群内参数”“保存支付设置”。改 Token 或群 ID 后重启机器人。
确认 Bot 状态显示运行中，再到游戏群由管理员发送 /开始下注。
玩家群内下注或私聊即时下注；后台通过用户管理、账目明细、提现审核、运行日志检查运营状态。
出现异常先看“运行日志”和“运行诊断”；日志里会记录开盘、封盘、开奖、充值、提现、错误信息。
用户列表
余额约每 8 秒刷新；绿色=下降、红色=上升。点击用户 ID 进入详情（上分/调账/提现/RTP/高限红）。
| ID | 昵称 | 用户名 | 余额 | 流水 | 充值合计 | 投注次数 | 待领反水 | 注册时间 | 操作 |
|---|
用户详情
会员管理
提款密码：—
RTP / 私聊高限红
RTP 仅作运营标记；私聊高限红允许该会员在私聊使用更高限额（若 Bot 已启用）。
💰 手动上分 / 调账
正数=加款，负数=扣款调账，写入充值记录。
💸 后台提现扣款
立即扣款并记为已通过，不走提现审核。
💵 充值 / 调账记录
| 时间 | 金额 | 来源 | 备注 |
|---|
💸 提现记录
| 时间 | 金额 | 状态 | 来源 | 备注 |
|---|
🎮 投注记录
| 期号 | 时间 | 本金 | 派彩 | 净 | 明细 |
|---|
机器人运行日志
写入 logs/bot.log，含启动、开盘、开奖、充值、错误等。部署重启后若已配置 Token 会自动拉起并记入日志。
—
加载中…
账目汇总（上海时区）
充值仅统计正数；负数计入调账。提现仅统计已通过。
指定日期 · 会员汇总
| 会员ID | 局数 | 本金 | 派彩 | 净输赢 | 充值/调账 | 提现 | 待领反水 |
|---|
近期混合流水
| 类型 | ID | 会员 | 时间 | 充值/调账 | 提现 | 本金 | 派彩 | 净 | 来源 | 备注 |
|---|
群开奖记录（只读）
历史开奖结果，不含受控骰子/改奖功能。
| 期号 | 群ID | 骰子 | 时间 |
|---|
运行诊断
配置快照（敏感项已脱敏）与 Bot 日志尾部。
配置快照
—
Bot 日志（500 行）
—
待审核提现
—
会员在机器人内申请提现会暂扣余额；此处通过后视为已打款；驳回则全额退回并 Telegram 通知。后台「用户详情→后台提现」为立即扣款，无需审核。
| ID | 用户ID | 金额 | 时间 | 备注 | 操作 |
|---|
最近已处理
| ID | 用户 | 金额 | 状态 | 申请时间 | 审核时间 | 备注 |
|---|
Bot Token
基础参数
群内设置总模块
群 ID、开封盘周期、机器人介绍和群内开奖管理员集中管理。
—
群内游戏参数
仅支持 1 / 2 / 3 / 5 分钟；保存后新开的期次生效。
开奖管理员
绑定 Telegram 用户 ID，允许在群内发送 /开始下注。
| 用户 ID | 备注 | 操作 |
|---|
后台安全
主管理员与额外后台账号、登录密码集中在此配置。
主管理员密码
默认后台账号：k5（不可删除）
额外管理员
| 账号 | 类型 | 操作 |
|---|
欢迎广告图
用户点击机器人「开始」时展示（PNG/JPG）。
支付系统
TRC20 自动上分、Okpay 收银；填好后请点本页底部 「保存支付设置」。回调：/api/okaypay/notify