投票
这篇帮你做什么：开启后，群成员可以在群里发起 投票禁言 或 投票踢人：大家在群里回复投票，票数达到阈值时机器人自动执行对应的禁言或踢出。配置入口：侧边栏 → 群设置 → 基本设置 → 投票设置 卡（改完随群基本设置页顶部的 保存 一起生效）。
开始前确认（重要）
- 投票踢人是不可逆的：被踢成员需重新申请入群；勾选"踢出拉黑"则同时进黑名单。
- 内置投票指令默认权限等级为 0，普通成员也可能发起处罚投票；实际门槛还取决于你在指令设置中保存的权限要求和群分类开关。阈值、每日发起/参与上限都要慎重设置，不要把默认权限当作不可修改的固定规则。
- 达到阈值时系统会再检查一次目标：对方是受保护用户（管理员、群主、白名单等）时投票作废不执行；查不清保护状态时同样不执行。
- 本功能与"投票禁言/投票踢人"两条 群指令 配合使用；指令在指令设置里可停用。
配置项与默认值
| 配置 | 作用 | 默认 |
|---|---|---|
| 启用投票 | 总开关，关闭后群内发起投票会提示"本群投票功能未启用" | 关 |
| 投票禁言 | 是否允许发起"投票禁言" | 关 |
| 禁言票数阈值 / 禁言时长 | 多少票通过；通过后禁言多少秒 | 10 票 / 600 秒 |
| 投票踢人 | 是否允许发起"投票踢人" | 关 |
| 踢人票数阈值 / 踢出拉黑 | 多少票通过；通过后是否同时拉黑 | 20 票 / 关 |
| 投票限制 | 单人每天最多发起 / 参与多少次（0 为不限） | 3 次 / 10 次 |
| 投票有效期 | 一项投票多久内有效（秒） | 1800 秒 |
| 结束冷却 | 一项投票结束后本群多少秒内不能再发起（0 为不冷却） | 0 |
| 匿名来源 | 是否允许无法识别身份的来源投票及其上限 | 关 |
群里怎么用
- 群成员发送 投票禁言 @某人 或 投票踢人 @某人（必须 @ 目标）。
- 机器人回复投票进度（第一个人发起时提示发起，之后每人一票递增进度）。
- 同一人对同一投票只算一票；重复参与、超过当日次数、冷却中、已有进行中的投票等情况下机器人会给出对应提示。同一群同一时间只有一个进行中的投票：不区分类型和目标，后来的发起会被拒绝，等当前投票结束（通过、失败、过期或取消）后才能再发起。
- 票数达到阈值 → 机器人检查目标是否受保护 → 不受保护才执行禁言/踢出，并在群里播报结果。
"投票有效期"和"结束冷却"是两段不同的时间：有效期内票数不够的投票保持进行中，到点自动过期；结束后进入冷却，冷却期内本群不能再发起新投票。
怎样判断结果
- 群里播报：成功播报可作为结果线索，还应核对目标实际状态。在平台拒绝、未派发或结果未知时，失败信息只记日志，不保证在群里播报；没有失败消息不等于处罚成功，也不等于确定没有执行。
- 控制台回读：基本设置页下方的 投票运行回读 卡，点 刷新 可看当前投票：生命周期（投票中 / 等待平台结果 / 平台已生效 / 平台未生效 / 已过期 / 已阻止 / 已取消 / 结果未知）、票数、冷却剩余、决议阶段、平台错误和 Trace ID（用于关联日志的追踪编号）等。"平台已生效"才算真的处罚完成；"等待平台结果""平台未生效""结果未知"都不是。"结果未知"表示这次处罚尝试已经结束、但平台实际结果没有确认；当前界面尚未给这个终态配置文字标签，该状态下生命周期一格可能显示为空白——空白同样按"结果未知"理解，不能当成"没有执行"。
- 处罚是否真正生效，应结合动作终态、日志和成员实际状态判断；群消息投递失败不会撤销已经发生的处罚，不要只凭有没有播报决定重试。
没成功先检查什么
- 发起投票提示"未启用"：总开关或对应类型（禁言/踢人）开关没开，保存后重试。
- 票够了自己停住：目标多半是受保护用户或保护状态查不清，此时投票按"已阻止"收场，属设计行为。
- 没有进度提示：指令是否被停用（指令设置）→ 机器人是否在线（按常见问题核对）。
- 显示等待、结果未知或生命周期空白：核对决议阶段、平台错误，用 Trace ID 关联应用日志，并检查动作终态及实际成员状态；权限不足、超时和断线含义不同，不能一律认定未执行。系统会持久结束失败或未知的投票并保留结束冷却；未知事实仍保留，不自动重新处罚。不能人工指定结果，也不要为了重试而重建同一处罚；重启不会重新派发已经结束的投票。
关闭或改回
- 彻底停用：关闭 启用投票 并保存基本设置。
- 只停某类：单独关闭"投票禁言"或"投票踢人"。
- 进行中的投票会按有效期自动过期；被阻止/过期/取消的投票不会执行处罚。