群基本设置

这篇帮你做什么：群设置 → 基本设置 是一个按群保存的配置页，集中放了群名维护、代理管理员、投票、警告规范、警告记录、信用分、卧底识别和 AI 群级开关。本页是两件事的落点：

1. 告警（警告）与信用分的集中说明，见下方告警与信用分——警告怎么累计、到多少次升级成什么处罚、信用分怎么扣怎么恢复。
2. 页面各配置卡的索引。投票、卧底线索等专题已有独立页面，这里只说明它在本页的位置和差异，不复制整套步骤。

开始前确认

• 所有配置 按群生效，先在页面顶部选好群；换群后整页配置随之切换。
• 本页各卡共用顶部群选择框旁的 保存 按钮：一次保存会一并提交本页的投票、警告规范、信用分、卧底识别、代理管理员等各卡内容。保存后页面自动回读服务端结果；提示"已保存但刷新失败"时 只重试读取，不要重复保存。两个窗口同时改同一群时，后保存的一方会收到"配置已被其他窗口修改"，需要刷新后基于新版本重改。
• "群名维护"卡有自己的保存按钮，不随页面顶部保存提交。
• 警告与信用分都可能触发禁言、踢出、拉黑等处罚；踢出不可逆，成员需重新申请入群。先在测试群或用保守动作（提醒）练习。
• 受保护用户（白名单、代理管理员、群管理员、群主、高管、超级管理员）不会被这些机制处罚；保护状态查不清时同样不处罚。

页面各卡索引

卡片	作用	详细说明
群名维护	修改群名称、查看群名历史、锁定群名（配合"锁定群名"指令）	本卡内保存
代理管理员	配置本群的等级 7 名单；卧底通知、文件监控通知复用这份名单	见权限管理
投票设置 / 投票运行回读	投票禁言、投票踢人的参数与进行中投票状态	见投票
警告规范 / 警告记录	警告累计与升级处罚的规则和历史	见下文告警与信用分
信用分斩杀线 / 信用分运行回读	信用分扣分模型、阈值处罚与计分明细	见下文告警与信用分
卧底识别	私聊、好友事件、群邀请的审计线索与代管通知	见卧底线索
AI Chat 群级开关 / AI 用量	本群 @机器人聊天开关，以及聊天/总结的群级额度和用量	见 AI 功能

告警与信用分

本节是警告累计、升级处罚和信用分机制的完整说明；监控方案、踢人禁言、文件监控等页面提到"警告""信用分"时都指向这里。

两套机制的关系

群内对同一个成员同时维护 两个独立的计数：

• 警告次数：按"次"累计，达到你在警告规范里配置的次数后，按次数规则升级处罚（提醒 → 禁言 → 踢出）。
• 信用分：按"分"扣减，分数跌破你配置的阈值后，按阈值档位触发处罚（警告 / 禁言 / 踢出 / 黑名单）。

两者 各自判断、各自处罚，互不代替也互不抵消：一次违规事件可以既让警告 +1，又让信用分扣分；两套阈值也不同步。关闭信用分系统不影响警告升级，反之亦然。

告警次数（警告次数）怎么累计

• 哪些动作会计警告：监控方案规则选"警告"处理方式、文件监控惩戒选"警告"、以及私聊里对成员的批量警告操作——这些警告动作在执行时都会记录一次违规并参与累计。
• 累计范围是"单个群的单个成员"：同一人在不同群的警告分开计数，互不影响。
• 累计看的是滚动窗口，不是自然月：只有"警告重置间隔"这段时间内的警告参与计数，更早的警告仍在记录里，但不再算入当前次数。窗口按配置值精确计算（如 7d 就是最近 7 天），不是到某个日期清零。
• 有效保存的“启用警告”关闭时不累计：需保留至少一条合法的警告动作规则一起保存，警告动作才退化为只提醒、不记录、不升级；已有记录保留。动作列表为空时，运行时会整份回退内置默认，包括重新启用警告，不能靠“关 + 空列表”停用。 重新打开后，仍在滚动窗口内的旧记录会立即重新参与计数，不是从零开始。
• 手动清零：警告记录卡的 清空记录 会删除本群全部警告记录（不可恢复），累计次数随之归零；私聊"清除警告"指令可按成员 / 本群 / 全局范围清除（全局清除要求等级 10 及以上）。同一数据库正常重启不会清空警告，重启后仍按当前窗口统计；窗口随时间移动不等于历史被删除。

升级处罚（次数规则）

"警告动作配置"按 警告次数 → 处罚动作 一行一条配置：

• 成员当前窗口内次数 达到 某条配置的次数时，按该条执行处罚；同时命中多条时 取次数最高的一条。
• 动作只有三种：提醒（仅消息）、禁言（需填时长，1–86400 秒）、踢出（不可逆，不自动拉黑）。
• 系统内置默认规则为：第 1 次提醒、第 2 次禁言 600 秒、第 3 次踢出； 没有保存过警告规范的群，运行时也按这套默认执行，不是"不处罚"。
• 处罚执行前照常检查受保护状态：目标是保护用户或保护状态查不清时，不执行处罚。
• 升级后的踢出/禁言与其它来源的处罚共用 踢人禁言 描述的保护与结果核查方式；"指令已发出"不等于"处罚已在群里生效"。

通知代管角色：这是页面上的开关名称，但当前实际控制的是警告升级为禁言/踢出后，是否向 本群 发送处罚结果汇总，不会私聊代理管理员。关闭它不停止处罚；未升级的纯提醒仍会发到群里，不受此开关控制。

信用分怎么扣

• 扣分模型：成员首次被记录时从 初始信用分 起算，之后违规按扣分规则扣分；分数只因扣分和恢复变动。
• 扣分规则按"违规类型 → 扣分值"配置（1–100 分）。违规类型要与实际记录事件的类型标识一致（例如治理处罚对应的动作类型）； 没有匹配到任何扣分规则的事件不扣分，会在运行回读里记为忽略（原因 rule_not_matched）。
• 处罚联动扣分有类型限制：只有成功的警告（warn）、封禁（ban）和踢出（kick）产生联动扣分事件；配置为普通禁言（mute）的处罚不会因此扣分。封禁当前只执行禁言，不踢出、也不写入黑名单，不要按名称理解成拉黑。扣分规则仍须匹配该事件类型，因受保护或保护状态不明而跳过的目标不扣分。
• 阈值处罚（斩杀线）：每次成功扣分后，从分数已跌破的档位中选 阈值最高的一档 执行动作。比较是严格小于：恰等于阈值不触发。一档都未跌破时不动作。
• 多档不是递进处罚：例如设 80 分警告、50 分禁言，降到 40 分时仍选 80 分警告，50 分档不会执行。跌破最高档后，后续每次成功扣分都会再次触发该档；不能把多档配置理解成“分越低罚越重”或“每档只罚一次”。
• 同一次违规可能叠加 警告升级处罚 + 信用分阈值处罚，但升级产生的禁言/踢出不会再单独扣一份，信用阈值处罚也不会反过来循环扣分或累计警告。
• 信用分处罚同样先过受保护检查；计分与平台处罚是两件事，结果核对见下方观测入口。

扣分规则填什么类型

类型键	何时产生	注意
warn	警告动作成功后的联动事件	升级为禁言/踢出仍按来源 warn，不是另扣一份；也接受规则键 warning
ban	封禁动作成功后的联动事件	该动作当前只执行禁言，不踢出、不写黑名单；扣分规则也接受 mute 作为此类型的别名；不代表普通禁言 mute 会产生联动事件
kick	踢出动作成功后的联动事件	仍需规则匹配；保护跳过不扣
speak	成员发言事件	不等于只对违规消息扣分
join / invite / leave	对应入群、邀请、离群事件	按实际事件类型分别匹配

优先按上表的类型键填写，不填自由描述。成员事件计分和处罚联动是不同入口：受保护成员也可能因发言、入群等事件扣分，目标保护在后续阈值处罚时再检查，不是所有计分的豁免。其他未匹配类型会被忽略，不靠默认扣分补齐。

信用分怎么恢复

• 系统每 24 小时运行一轮恢复（从应用启动时刻起算，不是每天零点）。
• 一名成员的分数 最后一次变动（扣分或上次恢复都会重新计时）超过 恢复周期 后，在下一轮恢复任务中回涨一次 每日恢复分，最多涨回初始信用分。虽然界面叫“每日恢复分”，实际是 每满一个恢复周期回涨一次，不是开始恢复后每天涨。
• 启用信用分系统 关闭，或恢复周期、每日恢复分任一为 0 时，该群不执行恢复。启用前明确设置合适的正数初始信用分；已保存的 0 不是“自动使用 100”，也会成为恢复的上限。
• 恢复 不会撤销已经执行过的处罚：被踢的成员不会因分数恢复而回到群里，黑名单也不会自动解除。

观测入口

• 警告记录 卡：本群警告历史（类型、成员、理由、操作者、时间），页内 清空记录 清空本群。
• 信用分运行回读 卡：点 刷新 查看本群最近 20 条计分明细（成员、规则、变动、分数变化、处置状态、时间）和最近一次恢复任务结果（执行中 / 已更新 / 空集 / 失败，含更新与跳过数量）。
• 计分明细的 处置 列显示原始状态：action_pending（处罚待派发）、accepted（已受理）、failed（派发失败）、not_required（无需处罚）、unsupported（动作不支持）。该列不会回写“平台已生效”，即使平台动作成功也可能仍是 accepted；不能等它变成已生效来判断。结合日志中心的出站结果及实际成员状态核对；由消息监控触发的处理还可查群聊监控的触发记录。

设置项参考

警告规范（警告动作配置按"次数 → 动作"逐条生效，本群独立）

配置	含义与取值	未保存规范时的运行时默认
警告重置间隔	滚动窗口长度，正整数 + 单位 d/h/m/s；页面下拉提供每天 / 每周 / 每月	7d（最近 7 天）
启用警告	保存为关且动作列表非空时，不记录、不升级；空列表会回退默认开启	开
通知代管角色	当前仅控制升级处罚后的群内汇总，不私聊代管角色；不控制纯提醒	开
警告次数	每条规则的触发次数，≥1 的整数，不可重复	—
处罚动作	提醒 / 禁言 / 踢出	1 提醒；2 禁言；3 踢出
处罚时长（秒）	仅禁言需要，1–86400	默认规则为 600 秒

表单显示不等于运行时默认：未保存规范的群，页面可能显示间隔未选择、两个开关关闭、动作列表为空，但运行时仍按上表的 7d、开关开启和内置动作处理。先核对并保存完整配置；特别是停止警告升级时，不要清空动作列表。

信用分（斩杀线）

配置	含义与取值	未配置时
启用信用分系统	总开关；关闭后所有事件不扣分、不触发阈值	关
初始信用分	首次记录的起始分，0–1000	页面显示 0；运行时配置缺失按 100 兜底
恢复周期（天）	最后一次分数变动后，每隔多少天才可再恢复一次；页面新输入范围 1–365	表单显示 0，运行时不恢复
每日恢复分	每满一个恢复周期回涨一次的分数；页面新输入范围 1–100，不是每天涨	表单显示 0，运行时不恢复
扣分规则	违规类型 → 扣 1–100 分；未匹配类型不扣分	空（任何事件都不扣分）
信用等级阈值	分数严格低于时触发；多档只选最高阈值档。动作警告 / 禁言 / 踢出 / 黑名单，禁言按秒计时长	空（不触发阈值处罚）

未配置时，这两个恢复字段的 0 可能被页面标红，但不能据此判断服务端一定拒绝保存。已保存的恢复周期或恢复分为 0，运行时只是不执行恢复；不等于关闭信用分系统，匹配的扣分和阈值处罚仍可能执行。不要为消除红框而盲目开启恢复。

给定配置怎么推演

下面只是帮助理解规则的静态算例，不要求在成员身上试处罚。假设同一群、同一名不受保护的成员，警告来源动作成功，每个事件只记一次，信用分扣分规则匹配 warn：

• 警告：最近 7 天累计，1 次提醒、2 次禁言 600 秒、3 次踢出。
• 信用分：初始 100，每次 warn 扣 20；80 分档警告、50 分档禁言 600 秒；恢复周期 7 天、每日恢复分 5。

事件	警告侧	信用分侧
第一次警告	窗口内第 1 次，只提醒	100 → 80，等于 80，不触发阈值
第二次警告	第 2 次，升级禁言 600 秒	80 → 60，跌破 80，另触发信用分警告
第三次警告	第 3 次，升级踢出	60 → 40；虽然也跌破 50，仍选阈值最高的 80 分警告，不选 50 分禁言
此后分数无变动	旧警告随时间移出 7 天窗口，不是一起定时清空	最后一次变动超过 7 天后的首轮恢复任务加 5；写回后重新计时，再超过 7 天才可下一次加 5，最多到 100

如果第二次后关闭警告、在旧记录仍处于窗口内时再打开，下一次警告会按第 3 次判断，不会从第 1 次开始。信用分的处置显示 accepted 也只表示受理；算例中的动作条件不替代平台结果核验。

常见误解与排障

• "给了警告怎么没升级"：窗口内的实际次数没到已配置的次数；或"启用警告"没开；或目标是保护用户（这类不处罚是设计如此）。
• "信用分怎么是 0"：从没保存过信用分配置的群，页面表单显示的是零值（初始分 0、恢复 0），不代表系统按 0 分在判罚；先保存一套完整配置再启用。
• "违规了却没扣分"：信用分系统未启用，或该事件的类型没有匹配到任何扣分规则——在信用分运行回读里能看到这条被忽略的记录及原因。
• "恢复怎么这么慢"：从最后一次分数变动超过恢复周期后的首个恢复任务才回涨一次，之后重新等一个周期；还要核对系统开关、周期、恢复分与恢复运行回读。缩短周期或增加恢复分会改变治理力度，先核对影响，不要仅为赶进度调高。
• 配置保存了但行为没变：确认顶部保存成功且回读一致；警告规范要同时核对“启用警告”和动作列表，空列表会回退内置默认；信用分配置要“启用信用分系统”打开才生效。

停止或改回

• 停止警告升级：保留至少一条合法的警告动作规则，关闭 启用警告 并保存回读，确认关状态和非空动作列表一起保留；不要保存成“关 + 空列表”，否则运行时会回退默认开启。警告来源仍可发纯提醒。已有记录不会删除；重新启用时，窗口内旧记录会重新参与计数。清空记录 是删除本群全部历史，不是普通暂停手段。
• 停止信用分：关闭 启用信用分系统；已扣的分数保留在记录里，重新启用后从当前分数继续。
• 被误踢 / 被拉黑的补救方式见踢人禁言的"关闭或改回"。

和其他页面的关系

• 警告动作与信用分阈值触发的是同一批处罚动作，保护范围与执行核查见踢人禁言。
• 代理管理员名单供卧底通知、文件监控通知等使用，配置见本页"代理管理员"卡；警告规范里的“通知代管角色”实际行为见上文。等级含义见权限管理。
• 监控方案里的"警告"处理方式是警告的最主要来源，见监控方案。