配置 Telm

本指南将带你把 Telm 添加到 Telegram 群组，先在安全的纯观察模式下看它如何运作，调整你的规则，最后再开启主动执行。

第一步：将机器人添加到你的群组

在 Telegram 中打开你的群组，进入 Manage Group > Administrators > Add Admin，然后添加 @TelmBot。为了有效地进行审核，Telm 需要以下管理员权限：

• 删除消息 —— 移除垃圾信息和违规内容
• 封禁用户 —— 移除并拉黑已知的垃圾发布者
• 限制成员 —— 禁言触发速率限制或过滤器的用户

Telm 从不需要“修改群组信息”或“添加新管理员”权限，因此请保持这些权限处于关闭状态。添加完成后，机器人会在群组中作自我介绍，并将该群组与你的控制台关联起来。

第二步：在监控模式下观察

每个新群组都以 监控模式（Monitoring Mode） 起步——机器人只观察和上报，绝不触碰任何一条消息。这是在 Telm 采取行动之前，准确了解它*将会*做什么的最安全方式。

在控制台中，你会看到一个实时的影子操作动态：

[MONITOR] would DELETE  message from @user4823  reason: CAS blocklist match
[MONITOR] would MUTE    message from @promo_acct reason: rate limit (12 msgs / 5s)
[MONITOR] would BAN     message from @spammer01  reason: AI spam score 0.97

让它在一个活跃的群组里运行几天。查看这些动态，确认其操作与你的预期相符。正是在这一步，你能*在*真实成员受到影响*之前*捕捉到误判。

第三步：配置你的规则

Telm 采用三层检测——硬编码规则、快速的本地分类器，以及针对不确定情形的深度 AI 检查——外加全球 CAS 反垃圾黑名单。在此基础上，你还可以在控制台中添加自己的 自定义审核规则：

• 黑名单 —— 屏蔽单词、短语或正则表达式模式
• 速率限制 —— 限制用户在一段时间窗口内可发送的消息数量
• 链接过滤 —— 屏蔽或白名单特定域名
• 内容过滤 —— 限制转发、媒体或新账户发帖

rules:
  - type: rate_limit
    max_messages: 5
    window_seconds: 10
    action: mute
  - type: link_filter
    mode: allowlist
    domains: ["keepflow.ai", "telm.com"]
    action: delete

根据你在监控模式下的观察来调整阈值。并非越严格越好——动态会告诉你真正的噪声出在哪里。

第四步：启用执行

当影子动态看起来无误时，在控制台中将群组从监控模式切换到 主动（Active）。从这一刻起，Telm 会实时执行你此前预览到的那些操作——删除垃圾信息、禁言违反速率限制者，并封禁 CAS 名单上的账户和高置信度的垃圾账户。

执行会立即生效，无需重启。如果发现任何异常，随时可以切回监控模式；你的规则会被保留。

第五步：使用控制台

控制台是你通过 WebSockets 进行实时管控的中枢：

• 活动（Activity） —— 每日消息与成员统计，以及活跃度热力图
• 排行榜（Leaderboards） —— 按消息数、XP 和声望排名的顶尖成员
• 审核日志（Moderation log） —— 每一项已执行的操作及其触发原因
• 多群组（Multi-group） —— 在一处管理你的所有群组，并为帮助台社区启用 支持模式（Support Mode）

每周查看审核日志，并随着社区的壮大不断完善你的规则。