⏰排档调度
每小时一档全自动运转，拍下档语义（2:40 开排拍的是 3 点档），只为有主持的档发麦序，错过整点自动补发，断线自愈。
| 指令 | 说明 |
|---|---|
设置扣排时间40 设置扣排截止时间58 设置任务截止时间20管理员 | 每小时的开排/截排/截任务分钟；任务截止分 ≤ 截排分时自动视为下一小时 |
开排 截排 截任务管理员 | 手动档控制（不受主持表限制） |
设置拍下档 / 设置拍当前档管理员 | 2:40 拍 3 点档（默认）或拍 2 点档 |
本档指令管理员 | 重发本档公告+麦序（网络原因没发出去时补发） |
设置主持（多行 0-2张三）换主持10-15@某人 查询主持 | 主持表（右开区间，支持连排/跨天）；目标档无主持不自动发麦序 |
设置麦序文档… 查询麦序文档管理员 | 开排公告模板，支持 {主持} {时间} {日期} 占位符 |
本档作废 上档作废 设置麦序作废人数N管理员 | 作废档（被作废者的置顶卡自动退回） |
🎯扣排系统
三种扣排模式 + 防伪码防复制 + 自定义扣排词，满员自动截排，被顶出麦位即时@提醒。
默认模式
发 p / P / 排 即扣排；可用 设置扣排词Cucu 自定义触发词（英文不分大小写），设置扣排词默认 恢复。
数字防伪码 🔐
每档随机 3 位码，公告显示花体 扣：𝟢𝟨𝟣——复制粘贴的是花体字符无效，只能手打数字；粘贴者被当场识破「检测到复制粘贴」。AI 闲聊也不会泄露码。
文字防伪码
随机 3 个汉字显示为 扣：山·茶·云，须手打「山茶云」，带符号粘贴无效。
| 指令 | 说明 |
|---|---|
切换麦序模式 [默认/数字/文字]管理员 | 不带参数循环切换；扣排中切换立即换新码 |
设置扣排人数7管理员 | 每档麦位数，手速满员自动截排（🈵标记） |
取 / 补成员 取@某人 / 补@某人管理员 | 取排/补排（代操作需管理员）；受 设置取时间N 设置补位时间N 设置手速可取/不可取 设置任务排可取/不可取 约束 |
转麦序@某人成员 | 把自己的麦序转给别人 |
0-2固定排@某人 清空固定排 查询固定排管理员 | 固定排开排自动置顶；另有 设置固定手速人数N 设置固定手速任务xx |
覆盖麦序 + 每行 @名字 (类型)管理员 | 整张麦序表直接重写（纠错神器） |
| 被顶提醒自动 | 有人被任务顶出麦位时发 @顶者 →@被顶者 被顶原因:5.0 + 最新麦序表 |
📈任务体系
任务数据阶梯定义合法扣排值与排序权重，打任务词即上任务排，收光打卡抵消任务。
| 指令 | 说明 |
|---|---|
设置任务数据0.2<0.3<…<新人置顶卡<全麦置顶卡<魅力置顶卡<5.0<…<100.0管理员 | 任务阶梯（支持125档+）：只能按预设值扣排，越靠后位次越高；置顶卡位次即其在阶梯中的位置 |
打任务值如 6.6成员 | 上任务排/升级位次；麦序排序：固定排 → 任务(阶梯位次) → 优先手速 → 手速/补 → 买8/9 |
设置任务6.6、13、33 查看任务管理员 | 任务关键词（无阶梯时的简单模式） |
设置任务起始值6.6管理员 | 任务门槛：低于无效，任务排按值排序优先于手速（0=取消） |
| 截排后扣排门槛自动 | 截排后只收高于全部置顶卡的任务（如 ≥5.0），照样触发顶卡 |
添加累计@某人 5 累计任务 累计过 | 手动累计加分与查询 |
🎫置顶卡
三种卡（新人/全麦/魅力置顶卡），带有效期、按档限张、覆盖退卡、进群自动赠卡。
| 指令 | 说明 |
|---|---|
给@某人 新人置顶卡 2张 7天管理员 | 发卡：时长支持天/小时/分钟，不写=永久，到期自动消失，用卡优先消耗快到期的 |
使用新人置顶卡（或直接发卡名）成员 | 消耗1张按阶梯位次置顶；全档累计限 2 张（设置置顶卡上限N/特殊置顶人数N 可调，取排不释放额度） |
设置单卡上限 新人置顶卡 1管理员 | 单卡种每档限张（与全档上限叠加） |
| 覆盖规则自动 | 一张高任务（如5.0）只覆盖一张最低级的卡：即时按原有效期退卡、持卡人降为手速；第二张5.0才覆盖第二张卡 |
设置退卡开/关管理员 | 收档时位次跌出麦位（没排上）自动退卡（默认开）；作废档同样退卡 |
入群添加置顶卡 新人置顶卡 2张 7天管理员 | 进群自动赠卡（…关闭 取消） |
我的置顶卡 / 置顶卡 / 查卡成员 查询新人置顶卡 | 查自己的卡（含到期时间）；查全群持卡名册 |
💰买8竞价
独立于扣排的竞价队列：打任务值抢 8 号麦（买9 同理），价高者得。
| 指令 | 说明 |
|---|---|
买8 2.0 / 买82.0 / P8 2.5成员 | 必须带任务值（受阶梯/起始值约束），且须高于正常麦序中最高任务档位 |
| 竞价规则自动 | 价高者顶替前任并全群公示「💥 B 以任务 2.5 抢下买8！A 被顶替」，被顶可加价回抢；与扣排互斥（先「取」再买）；不占扣排名额，显示「8号麦.@xx (买8·2.5)」 |
🚪报备
离厅报备限时限量，超时自动@提醒，可联动自动禁排。
| 指令 | 说明 |
|---|---|
bb吃饭去 / 报备…，回厅发 回成员 | 报备离厅/回厅（回厅显示离开时长） |
设置报备时间15 设置报备人数2 设置报备次数1管理员 | 时长（分钟）/每档累计人数（回厅不释放、跨档清零）/每人每小时次数 |
设置报备超时提示词xx 设置报备回厅词xx管理员 | 自定义文案 |
| 超时提醒自动 | 到点自动 @ 催回；开启「麦序未归禁排」后超时未回直接禁排 |
📊打卡与统计
打卡项可自定义，收光=任务抵消；日/周总计、任务未过、历史麦序、操作日志全套查询。
| 指令 | 说明 |
|---|---|
收光 全麦 互动 带走 黑麦成员 | 麦上打卡计入麦序；收光抵消任务（回复"任务6.6已抵消"），收档后补打也计入 |
设置打卡项收光、全麦、流水、旷档 查询打卡项管理员 | 自定义打卡项（收光固定保留） |
当前麦序 今日麦序10-15 昨日麦序 | 实时麦序表 / 按档查历史 |
今日总计 本周总计 | 每人排麦次数｜任务累计｜已收光｜未完成明细 + 全群汇总（含进行中的档） |
任务未过统计 本周任务未过 | 只列未收光者：1.@欢熙-任务未过(2.5) |
查询日志 [N]管理员 | 操作流水（扣排/买8/用卡/发卡/退卡/取补/打卡/报备/档控制…20类埋点），MySQL 全量存 mx_logs 可 SQL 报表 |
取档@某人 21 补主持麦序@某人 21管理员 | 修正历史档记录（可带日期），统计同步生效 |
👮权限与人员
每群独立管理员体系；昵称自动去 emoji 规范化匹配，不再认错人。
| 指令 | 说明 |
|---|---|
ping / 开始运行 停止运行 | 激活群（首个发 ping 者自动成为管理员）/ 启停机器人管理员 |
设管理@某人 取消管理@某人 查询管理管理员 | 管理员授权；机器人登录号本人与 Web 后台为全群超管 |
禁排@某人 取消禁排@某人 查询禁排名单管理员 | 禁排管理（黑麦/报备超时可自动禁排） |
| 进/退群提醒自动 | 默认开启：进群欢迎（支持 {名字} 占位、可附自动赠卡）；主动退群每60秒轮询检测；设置欢迎词 设置退群词 自定义 |
艾特全麦 [内容]管理员 修改昵称xx | @麦序全员 / 改群名 |
🎛自动化开关
发 开启xx / 关闭xx 切换（管理员）；直接发开关名可查当前状态（所有人）。
🎲 随机手速
截排时从手速中随机抽一人为「优先手速」，排普通手速前，防手速垄断。
🔗 连档检测
连续两档打同任务自动标记「连」，计入麦序与归档。
🚫 黑麦自动禁排 / 麦序未归禁排
打卡黑麦、或报备超时未回厅 → 自动进禁排名单。
⏰ 任务未过提醒 / 累计任务提醒
收档时 @ 催未收光者 / 附今日累计任务简报。
🔍 所有人可查 / 打卡详情显示
关闭后查询类命令仅管理员；麦序表隐藏打卡标记。
📅 每日定时发送
每日定时发送12:00 内容，每天定点发送，…关闭 取消。
🖥系统与后台
📱 私人微信扫码登录
itchat-uos 网页协议免 token，python3 main.py 扫码即用，短期重启免扫码；掉线自动重连（会话失效自动重新出码）。一个微信号管理任意多群，每群状态完全独立。
🤖 AI 语义识别（DeepSeek）
@机器人说人话：成员「帮我排一个」「我出去吃个饭」自动识别为扣排/报备；管理员「每档7人排」「58分麦序截止」直接生效并回显命令。防伪码对 AI 隔离，不会被套话泄露。
🌐 Web 管理后台
http://127.0.0.1:8000（端口被占自动顺延）：网页扫码、群列表实时进度、当前麦序、20+ 参数表单化、指令控制台（可同步发群）。
🗄 MySQL / JSON 双存储
.env 一键切换；MySQL 4 张表（mx_groups / mx_pin_cards / mx_history / mx_logs，兼容5.7），首次启动自动建库建表并迁移旧 JSON 数据；写库失败不中断机器人。
🛡 健壮性
调度按开档时刻推算（错过整点补发、残留档自愈）；指令异常回复提示而非沉默；昵称 emoji 规范化；原子落盘。60 项单元测试覆盖全部业务。
🧪 本地模拟器
python3 cli_demo.py 不接微信模拟群聊全流程，/tick 模拟定时任务，开发调试零风险。