群鲸助手

适合刚把机器人拉进群的群主。先确认机器人是管理员，再进入管理台配置功能。

1. 把 @qjzhushou_bot 拉进群。
2. 在群管理里把机器人设为管理员，至少给删除消息、邀请用户、置顶消息权限。
3. 群里发送 /admin@qjzhushou_bot。
4. 点击“进入管理菜单”，进入私聊后台后按功能逐项设置。
5. 需要群ID时，点管理台里的“获取本群ID”，机器人会私聊发送，不在群里公开。

普通成员想看说明，可发送 使用说明 或 全部指令。

用于新人进群后自动欢迎、展示群规，也可以配合进群验证减少广告号。

1. 管理员发送 /admin@qjzhushou_bot 打开管理台。
2. 进入“入群设置”，先填写欢迎词。
3. 需要防广告时，开启进群验证；不需要验证时只保留欢迎词即可。
4. 保存后用小号进群测试一次，看欢迎词是否出现。

欢迎词发送成功后会自动删除，避免群里长期刷屏。

用于拦截广告、违禁词、刷屏、恶意链接。适合大群和经常被广告打扰的群。

1. 管理台进入“风控系统”。
2. 先开启总开关，再添加违禁词，一行一个词。
3. 开启反垃圾和刷屏限制，按群活跃度设置处罚力度。
4. 保存后用测试词发一条消息，确认机器人会处理。

建议先轻处罚观察几天，再逐步提高限制，避免误伤正常成员。

用于统计谁给群里拉了人。本期邀请用于发奖励，历史邀请用于长期排行榜。

1. 管理台进入“邀请推广”，开启精准统计和邀请提醒。
2. 成员在群里发送 /link 或 邀请链接，机器人生成他的专属邀请链接。
3. 新成员通过这个链接入群后，会计入邀请人的本期邀请和历史邀请。
4. 发完奖励后，在结算页选择要结算的人，本期数据清零，历史总数保留。

如果出现未归因，优先让成员重新生成链接，并检查机器人是否有邀请用户权限。

用户通过签到、发言、邀请获得积分，积分可以用来报名抽奖或兑换奖励。

1. 管理台进入“积分与抽奖”，开启积分功能。
2. 设置每日签到给多少积分，例如签到一次 6 分。
3. 设置发言积分、发言冷却和每日上限，避免刷屏刷分。
4. 成员群里发送 签到 或 每日签到，再用 我的积分、积分排名 查看结果。

积分也支持 查积分、积分明细、积分兑换 等说法。

适合用积分控制抽奖资格。管理员设置奖品、人数、报名消耗积分和开奖时间。

1. 管理台进入“积分与抽奖”，打开抽奖设置。
2. 填写奖品、中奖人数、报名开始/结束时间、开奖时间。
3. 设置报名消耗积分，0 表示免费报名。
4. 开奖后检查中奖名单，发奖后标记“已派奖”。

开奖记录、参与名单、派奖状态都建议定期导出 Excel 留底。

查U是给群里所有普通成员用的，不应该限制管理员。成员直接在群里发地址即可。

1. 复制一个 TRON 地址。
2. 群里发送 查U TRON地址，也可以发送 查余额 TRON地址。
3. 机器人返回 USDT/TRX 余额和近期交易记录。
4. 如果没反应，先确认地址格式是否正确，再看机器人是否被禁言。

示例：查U TPmtn1y7qL87suqXBsQNjvaFzRca9s7D5C

适合收款群、资金群。管理员添加监听地址后，入账和出账会自动提醒到群里。

1. 管理员打开管理台，进入“查U / 监听”。
2. 点击添加监听地址，填写 TRON 地址和备注，例如“收款钱包”。
3. 保存后等待链上交易，机器人会自动推送提醒。
4. 不用监听时，回到监听列表删除这个地址。

监听地址建议写清备注，否则多个钱包同时提醒时很难分辨。

普通成员可直接查询汇率，不需要管理员权限。

1. 群里发送 今日汇率 或 汇率。
2. 想查指定币种，发送 汇率 CNY 或 CNY 汇率。
3. 机器人返回当前可用汇率。
4. 如果短时间多次查询，等待缓存刷新即可。

这个功能适合给群成员公开使用，不建议加管理员限制。

计算器支持加减乘除、括号、百分比和复杂公式，普通成员可以直接在群里用。

1. 想看示例，发送 计算器。
2. 直接计算，发送 计算 25*(25%*36)/5。
3. 也可以发送 算一下 1000*(1+5%)。
4. 习惯英文命令的人可以发送 calc 2^3+10/5。
5. 私聊机器人时也可以用 /calc 1+1。

公式里尽量使用英文括号和符号，复制官网示例最稳。

适合客服问答、群规、活动链接。成员发关键词，机器人自动回复固定内容。

1. 管理台进入“自动回复”。
2. 点击添加规则，按格式发送 关键词 | 回复内容。
3. 例如：客服 | 请联系 @aliy2009。
4. 添加后点测试，发送关键词确认是否命中。

规则多时可以批量导入；大群建议设置冷却时间，避免重复刷屏。

适合每天公告、活动提醒、客服在线时间、群规循环提示。

1. 管理台进入“定时消息”。
2. 点击添加定时消息，先输入要发送的文字或复制原消息。
3. 设置重复间隔、开始日期、结束日期和发送时段。
4. 需要保持群干净时，开启“删除上一条”；重要公告可开启自动置顶。

建议先设置 10 分钟测试一次，确认没问题后再改成每天或每小时。

适合群内收支、团队账本、临时流水。支持有空格和没空格。

1. 收入发送 记账+5000工资。
2. 支出发送 记账-300餐费。
3. 查看汇总发送 我的账本。
4. 只清自己的记录，发送 清空我的账本，确认后不会删除其他成员记录。
5. 明细太多时，不在群里刷屏，直接导出 Excel 查看完整账目。

建议备注写清楚来源，例如工资、广告费、餐费、返佣。

通道统计是独立机器人 @tongdaov_bot，适合担保收款群、代收代付群。它和随手记账分开，避免 入款、下发 抢到普通账本。

1. 把 @tongdaov_bot 拉进通道群，并设置为管理员。
2. 机器人首次进群会发送欢迎说明。管理员发送 开始使用 或 开启统计，选择人民币、缅币或 USDT。
3. 已有通道群发送 修改账本设置，或在当前设置页面点击同名按钮，也可以改为缅币账本。
4. 选择“缅币”表示人民币入款、缅币承兑。跨账本类型切换前，当前账单必须先结清；已结清流水按原币种归档，新流水使用新设置，历史金额不会重新计算。
5. 缅币模式发送 设置缅币汇率0.00153，含义为 1 MMK = 0.00153 CNY。该模式不支持实时汇率或无汇率。
6. 设置费率发送 设置费率5，表示 5%。
7. 固定汇率发送 设置汇率6.8。选择实时汇率后，按提示回复 不调整、汇率上调0.15 或 汇率下调0.15。
8. 以后调整可直接发送 汇率上调0.15、汇率下调0.15 或 汇率不调整。新命令会覆盖旧设置，不会累加；管理员和操作员都能修改。
9. 每笔入款、下发都会重新获取实时基础汇率，再叠加当前调整值并保存。已经记录的流水使用当时汇率，不会随行情重复计算；实时汇率获取失败时，本笔不会入账。
10. 群主和群管理员自动拥有全部操作权限，无需加入操作员名单。
11. 添加普通操作员：管理员进入“操作员管理”点“添加操作员”，需要记账的成员点击“成为操作员”后立即生效。添加窗口有效 5 分钟，也可由管理员提前结束。
12. 快速添加一人：管理员回复目标成员的消息，发送 添加操作员。
13. 仅发送 @用户名 添加操作员 无法取得用户 ID 时，机器人会打开添加窗口并提示该成员点击加入，不再返回识别失败。
14. 移除普通操作员：进入“操作员管理”点“移除操作员”，勾选后确认。群管理员不能在这里移除，需要先在 Telegram 撤销其管理员身份。
15. 缅币账本：+10000 入款 10,000 CNY，-5000000 下发 5,000,000 MMK，-5000人民币 下发 5,000 CNY。
16. 原人民币/USDT账本仍使用 入款+5000 张三、下发+3000 客户A、下发USDT+50 客户A，原公式不变。
17. 查看账单发送 通道统计、今日账单 或 本轮账单。
18. 导出发送 /export，可选择全部日期或指定日期。报表包含财务仪表盘、每日汇总、流水明细、操作员分析、历史归档、配置与审计 6 张表。
19. 只清今天发送 清理今日数据；发送 清理所有账单 后需管理员二次确认，会清空流水和归档，但保留配置和操作员。
20. 需要连同货币、费率、汇率和操作员一起清除时，点击 恢复出厂设置，由同一位群管理员在 60 秒内连续确认两次。

群里账单只展示最新几笔。缅币 Excel 会展示累计收款、累计手续费、下发 MMK、折算人民币、未下发 MMK 和每笔汇率快照。

群数据中心用于每天复盘运营情况：谁活跃、谁拉人、积分是否异常、抽奖是否待派奖。

1. 管理台进入“群数据中心”。
2. 先看今日数据，再看 7 日趋势。
3. 重点检查邀请排行、积分增长、待派奖记录。
4. 需要发奖励或做复盘时，导出 Excel 给财务或运营看。

群越大越不要在聊天窗口展示明细，汇总放群里，明细走 Excel。

克隆中心适合创建“专属机器人”：使用者看到的是自己的机器人名字和头像，底层使用群鲸助手同一套功能。

1. 先把群鲸助手拉进你的群，并设置为管理员。
2. 私聊群鲸助手发送 /clone，打开克隆中心。
3. 克隆中心、额度说明和创建向导可以先看；真正添加克隆时才会校验克隆授权。
4. 点击“创建向导”，按提示去 @BotFather 创建新机器人。
5. 复制 BotFather 返回的 token，回到私聊发送 /clone_add。
6. 把 token 单独发给机器人；机器人接收后会立即删除这条敏感消息，再创建克隆。
7. 需要克隆额度时，先确认当前版本是否包含可用额度。
8. 把新克隆机器人拉进使用群并设管理员，群内发送 /admin 使用管理台。

普通人能看到克隆入口，但没有群管理员权限时只能看到加群设管理员提示。

用户反馈“机器人没反应”时，先看运行诊断，不要先重建机器人。

1. 私聊主机器人进入克隆中心诊断入口，查看所有可管理克隆。
2. 看状态是否“运行中”，PID 是否存在，最近错误是否为空。
3. 检查当前版本额度是否用完，或是否已经超过可使用群数量。
4. 打开单个机器人状态详情，确认所属用户、可用群和最近错误。
5. 如果异常，先在状态页点击重启，再观察是否恢复。
6. 确认使用群里克隆机器人还是管理员，且没有被禁言。

诊断页不会展示 BotFather token，可以放心给运营人员看状态。

功能多以后最容易出问题的是权限边界：公开工具不能限制普通成员，管理功能必须限制管理员。

1. 普通成员可用：查U、今日汇率、计算器、签到、我的积分。
2. 群管理员可用：管理台、邀请结算、风控设置、抽奖设置、定时消息。
3. 普通成员操作管理功能时，会收到“仅群管理员可用”的明确提示。
4. 如果公开功能提示没权限，请让群管理员在管理台检查对应功能是否开启。
5. 如果管理功能普通人也能用，立刻检查按钮回调是否走管理员校验。

权限问题优先测试三类身份：普通成员、群管理员、后台管理员。