排查说明
频道内容整理规则的验收，先检查一条消息为什么命中、同时命中时怎么办，再谈实际执行。普通频道帖子与关联讨论群中的评论是不同对象；消息正文、图片说明和文件名也不是同一个字段。把这些条件写清楚，才能用小样本判断规则是否符合自己的预期。
本文使用已有且获准查看的入口，检查匹配与拟执行动作。确有已确认的只读预览时读取其结果；没有时先做离线文本策略核对，并把真实工具引擎列为未验证。配图为规则验收概念示意或通信符号装饰，并非tgtools实际界面，也不表示已经执行删除、禁言或转发。
快速导航
先确认对象与现有入口
记录待整理的是广播频道帖子，还是关联讨论群里的消息或评论。写下具体源对象与预期目标的位置，确保不是把两个同名频道或一个频道及其讨论群当成同一处。Telegram频道说明可用于核对这种区别；有评论入口不表示所有频道订阅者都能直接发频道帖子。
只使用已经确认可用、允许查看的账号和入口，记录版本或当前可见名称，以及能观察哪些消息、哪些字段。核对该对象的实际角色与权限，不把“管理员”三个字直接等同于所有源/目标的读取、删除和转发权限。
没有待整理对象或入口不可访问时，先记录“入口未提供”或实际错误，本次还不能验证工具匹配。当前官方平台存在的新机制也不能替代工具自身功能证据；不按旧概括断言某类平台能力一定不存在。
确认实际整理对象的概念示意，并非tgtools界面或真实引擎测试结果。
分清现有账号与实际API路径
记录当前入口使用的是机器人、用户账号，还是尚未确认的方式，以及实际可见的认证和更新方式。没有这些信息就记未知，由已有负责人核对，不在本文流程里收集密码、bot token、会话文件或应用密钥。
应用凭据说明解释MTProto应用的api_id与hash；Bot API文档描述另一套HTTP接口。账号类型和传输接口不是可以随意互换的名称，不能据此要求所有tgtools读者创建API应用或安装Python，也不能凭某张示意图确认工具采用哪一种。
完成这一步时，应能说明本次实际对象、入口和可观察范围；仍未知的接口或权限条件保留为待确认，不通过下载新的安装包来猜测。
核对现有账号与API路径的概念示意，并非tgtools界面或真实引擎测试结果。
写下这次匹配策略
先写一份人工可读的期望，不预设工具具有某个模板或固定优先级。至少明确：关键词检查正文还是媒体caption；是否区分大小写；按完整词还是子串匹配；图片、PDF等类型如何处理；字段缺失时是待确认还是跳过；允许条件和禁止条件同时出现时希望怎样分类。
以下样本使用“公告”作允许词、TEST-AD作测试禁止词。这只是脱敏策略示例，分类结果写成“保留候选”“待审候选”“冲突待定”等观察标签，不对应真实删除或转发操作。你可以使用自己已获准的条件，但应在测试前记录预期和理由。
同时命中而尚未确定优先关系时，保留“冲突待定”。不要将白名单最高或禁止最高当成tgtools已证实的默认行为；也不要把“规则保存版本”写成产品必有的一键回滚菜单。
先写明确匹配策略的概念示意，并非tgtools界面或真实引擎测试结果。
准备八条脱敏样本
在自己的记录中给样本编号，写清输入字段与期望分类，不发送真实客户身份资料。下面八条可用于有限核对：
- S01普通公告：正文“公告：本周安排”，允许词命中，禁止词不命中，期望为保留候选。
- S02测试禁止词：正文“TEST-AD 测试内容”，只命中禁止词，期望为待审候选。
- S03冲突：正文“公告 TEST-AD”，两条件都命中，按已写的冲突策略分类；尚未决定时标为冲突待定。
- S04图片带说明：图片caption为“TEST-AD 图片测试”，正文为空；仅在策略确实检查caption时预期命中，字段范围不同就记录差异。
前四条匹配样本的概念示意，并非tgtools界面或真实引擎测试结果。
- S05图片无说明：没有caption，也没有正文，按缺字段策略标为待确认或跳过，不能伪造一段文本使它命中。
- S06PDF：文件名“TEST-AD.pdf”，说明为“公告附件”。分别记录文件名与说明，按实际选定字段匹配，不默认工具检查文件内容或识别文字。
- S07已编辑消息：以S02的样本作对照，将文本改为“普通测试内容”，禁止词不再命中；真实入口是否提供编辑更新、是否重新计算，要另记实际观察。
- S08同一事件重复输入：再次使用S02对应的同一事件及原字段，匹配分类应按同一策略比较。若还要核对去重，必须有可辨的实际事件身份；不同消息只是文字相似，不能直接算重复事件。只有离线记录时，不宣称已验证引擎去重。
每条都保留“字段—命中—预期”的记录。八条是本次范围，不要求批量抓取历史消息或向正式频道写入测试内容。
字段与事件样本的概念示意，并非tgtools界面或真实引擎测试结果。
读取只读预览，或先离线核对策略
若当前工具确有已确认、获准使用的预览或只读结果入口，把上述样本按实际支持方式交给该入口，逐条记录命中条件和拟执行动作。实际只能删除、禁言、转发或写正式频道的入口，不作为这次匹配验收的测试路径。
没有可核对的预览能力时，直接在离线文本记录中按所写策略检查八条样本，并注明“仅核对策略，真实工具引擎未验证”。不要把人工推演得到的分类填成工具实测结果。
将预期与实际分开列出：相符、错误、缺字段、无权限或入口未提供。看到一个成功提示而没有样本级结果时，仍无法确认哪条规则命中；此次检查也不代表拟执行动作已真的完成。
区分两种观察模式的概念示意，并非tgtools界面或真实引擎测试结果。
核对同时命中与缺字段的分支
重点检查S03：实际预览如何处理允许和禁止同时命中，是否符合你已写下的策略。结果不明、与预期相反或无法观察时，保留待定并记录具体规则条件，不套用未经证实的默认顺序。
再核对S04到S07的字段差异：实际结果来自正文、caption、文件名还是编辑更新？如果某类样本未到达观察入口，先确认对象、角色/权限、接收的更新类型及字段是否存在，不直接归因于关键词规则失效。
同一文本在不同消息里出现，与同一个事件再次输入是两个情况。去重身份或更新范围不能确认时，记为未验证，不按表面相似度判定已经自动去重。
同时命中保持可解释的概念示意，并非tgtools界面或真实引擎测试结果。
核对字段与事件身份的概念示意，并非tgtools界面或真实引擎测试结果。
按实际错误记录条件与等待
遇到错误时，保存实际字面提示、出现时间、对象及操作阶段；记录是接收样本、读取预览，还是字段缺失。凭错误文字和已有可查入口交负责人核对，不猜测隐藏端口、缓存或限流参数。
出现要求等待的限制时，按平台返回的条件暂停并等待。Telegram错误说明列有FLOOD_WAIT等条件，部分特定限制有自己的例外，不能推广为付费账号全部免限。不要通过高频压测、模拟人工节奏或换账号来规避实际限制。
恢复可观察条件后，只处理这次已记录的小样本；没有恢复条件就保留“未完成”，不用7×24、固定秒数或所谓保证成功的配置替代结果。
按实际错误与条件等待的概念示意，并非tgtools界面或真实引擎测试结果。
一次有限修正与复核
需要调整时，先记录当前人工策略、样本及结果，只改一处已确认的条件，例如caption是否参与匹配或冲突分类期望。通过现有已确认的只读入口再核对同一组样本一次；若仍是离线推演，继续明确标为离线策略核对。
比较这次变化是否解决了原样本问题，是否影响S01等正常样本。无法解释的冲突或错误保持待定，暂停扩大到其他对象；不要同时改变多个条件，或通过实际删除正式消息来证明规则“更快”。
这一步的完成标准是能指出改了哪一处、哪些样本结果改变、还有哪些条件未验证。人工保存的配置记录有助于对照，但不承诺产品能撤销已执行操作或恢复已删消息。
一次有限修正与复核的概念示意，并非tgtools界面或真实引擎测试结果。
记录结果与可交付信息
给八条样本分别标明匹配正确、匹配错误、缺字段、无权限、入口未提供，以及冲突是否仍待定。附上实际观察时间、对象、入口/版本、字段范围和一次修正的前后结果；离线策略结果与真实预览结果使用不同标记。
本次通过只表示这些样本的匹配与预览符合已写策略。它不是误删率、响应时限、全天可用性或删除/转发端到端执行成功的证明，也不推断所有历史消息都能重新处理。
需要交支持时，使用已有且已核对的负责人或供应方入口，提供脱敏样本ID、预期/实际、完整错误和未观察条件。不要提交密码、令牌、会话文件或完整私人聊天；样本信息足以复现匹配差异。
记录有限匹配结果的概念示意，并非tgtools界面或真实引擎测试结果。
常见疑问
没有现有入口时，要先安装Python或创建API应用吗？
不能由这篇验收流程推导这种要求。先核对实际工具入口、产品资料和负责人确认的运行方式；MTProto应用凭据与HTTP Bot API不是同一条认证路径，本站下载入口也不因此成为已验证发行来源。入口无法确认时，本次只能整理离线样本和待查条件。
离线核对是否验证了真实工具引擎？
没有。离线文本推演能检查人工策略是否自洽，却不能证明工具支持相同字段、优先级、编辑更新或去重。确有已确认的只读入口并得到逐条结果，才记录对应实际观察。
样本通过，是否说明不会误删或全天可用？
不能。有限匹配结果不代替真实执行与运行条件验收；不要从八条样本推导固定秒数、误杀比例或与其他工具的效率优势。缺少某项产品证据，也不等于断言该功能不存在。
接收到新帖，就能处理全部历史或恢复误删原帖吗？
不能。Bot API的新更新与全部历史不同；用户历史接口也受可访问对象等条件约束。受保护内容和不同消息类型有相应转发/复制限制，不按本文绕过。
已发生误删时先停止继续删除，核对现有副本及实际产品支持。日志里的消息ID不能保证恢复原帖；用完整副本重新发帖也不恢复原ID。Bot API某一删除方法的时间与权限限制，不应推广成所有客户端删除的共同规则。
Telegram与未核自动化符号的主题装饰，不表示tgtools特定集成、接口、双向同步或官方身份。
相关阅读
本站目录展示示意
