[{"data":1,"prerenderedAt":739},["ShallowReactive",2],{"guide-library-zh-CN":3},[4,192,261,327,443,543,655],{"id":5,"title":6,"author":7,"body":8,"category":179,"description":180,"extension":181,"language":182,"meta":183,"navigation":184,"order":185,"path":186,"published":187,"readingMinutes":169,"seo":188,"stem":189,"takeaways":190,"updated":187,"__hash__":191},"guides\u002Fzh\u002Fguide\u002Fcreate-bot.md","通过 BotFather 创建 Telegram 机器人","TGDog",{"type":9,"value":10,"toc":168},"minimark",[11,15,19,22,92,97,107,110,118,122,125,138,141,153,156],[12,13,14],"h2",{"id":14},"创建前的准备",[16,17,18],"p",{},"先为 TGDog 创建一个专用机器人。你需要 Telegram 账号，但不需要编写代码或部署机器人服务器。",[12,20,21],{"id":21},"六步创建你的机器人",[23,24,25,41,52,62,76,86],"ol",{},[26,27,28,32,33,40],"li",{},[29,30,31],"strong",{},"打开官方 BotFather。"," 在 Telegram 中打开 ",[34,35,39],"a",{"href":36,"rel":37},"https:\u002F\u002Ft.me\u002FBotFather",[38],"nofollow","@BotFather"," ，如果显示 Start 按钮，点击开始。",[26,42,43,51],{},[29,44,45,46,50],{},"发送 ",[47,48,49],"code",{},"\u002Fnewbot","."," BotFather 会要求你设置机器人的显示名称。",[26,53,54,57,58,61],{},[29,55,56],{},"选择显示名称。"," 例如， ",[47,59,60],{},"My Community Guard","。这是群成员看到的名称。",[26,63,64,67,68,71,72,75],{},[29,65,66],{},"选择唯一的用户名。"," 使用字母、数字或下划线；长度为 5–32 个字符，并以 ",[47,69,70],{},"bot","结尾。例如： ",[47,73,74],{},"my_community_guard_bot","。如果已被占用，请换一个。示例不是链接，也不保证该用户名可用。",[26,77,78,81,82,85],{},[29,79,80],{},"妥善保存 API Token。"," BotFather 会返回机器人的链接和 Token。复制 Token 并保密。如果泄露或丢失，可使用 BotFather 的 ",[47,83,84],{},"\u002Ftoken"," 命令生成新的 Token。",[26,87,88,91],{},[29,89,90],{},"在 TGDog 插件中连接。"," 打开插件的“机器人接入”页面，粘贴 Token 并连接。确认验证后的机器人身份，再继续配置群组。",[93,94,96],"h3",{"id":95},"botfather-输入示例","BotFather 输入示例",[98,99,105],"pre",{"className":100,"code":102,"language":103,"meta":104},[101],"language-text","\u002Fnewbot\nMy Community Guard\nmy_community_guard_bot\n","text","",[47,106,102],{"__ignoreMap":104},[16,108,109],{},"这里不会展示或收集 Token。",[16,111,112,113,50],{},"创建步骤参考： ",[34,114,117],{"href":115,"rel":116},"https:\u002F\u002Fcore.telegram.org\u002Fbots\u002Ffeatures#creating-a-new-bot",[38],"Telegram 官方 BotFather 指南",[12,119,121],{"id":120},"保护-token-并准备群权限","保护 Token 并准备群权限",[16,123,124],{},"把 Token 当作密码保管。仅在 TGDog 插件中填写，不要填入网站或发送给支持人员。",[16,126,127,128,132,133,137],{},"接下来，将机器人加入测试超级群，并在群设置中将其设为管理员。如果要使用自动动作，请授予删除消息和限制成员权限。继续阅读",[34,129,131],{"href":130},"\u002Fzh\u002Fguide\u002Fconnect-bot\u002F","机器人连接与更新接收","和",[34,134,136],{"href":135},"\u002Fzh\u002Fguide\u002Fgroup-rules\u002F","超级群权限","。",[12,139,140],{"id":140},"核对你的配置",[142,143,144,147,150],"ul",{},[26,145,146],{},"使用官方 BotFather。",[26,148,149],{},"私密保存机器人 Token。",[26,151,152],{},"启用成员处理前，先在测试超级群验证。",[12,154,155],{"id":155},"接下来读什么",[16,157,158,159,163,164,137],{},"如果是首次设置 TGDog，请按照",[34,160,162],{"href":161},"\u002Fzh\u002Fhow-to-use\u002F","完整使用教程","操作。需要了解其他主题时，可以返回",[34,165,167],{"href":166},"\u002Fzh\u002Fguide\u002F","指南文章库",{"title":104,"searchDepth":169,"depth":169,"links":170},3,[171,173,176,177,178],{"id":14,"depth":172,"text":14},2,{"id":21,"depth":172,"text":21,"children":174},[175],{"id":95,"depth":169,"text":96},{"id":120,"depth":172,"text":121},{"id":140,"depth":172,"text":140},{"id":155,"depth":172,"text":155},"getting-started","创建自己的机器人，安全保存 Token，并为 TGDog 连接做好准备。","md","zh-CN",{},true,1,"\u002Fzh\u002Fguide\u002Fcreate-bot","2026-10-09",{"title":6,"description":180},"zh\u002Fguide\u002Fcreate-bot",[146,149,152],"zSK-fLk7axy4C09bXQwMJM72b8onv9XcT536XiaarCw",{"id":193,"title":194,"author":7,"body":195,"category":179,"description":254,"extension":181,"language":182,"meta":255,"navigation":184,"order":172,"path":256,"published":187,"readingMinutes":172,"seo":257,"stem":258,"takeaways":259,"updated":187,"__hash__":260},"guides\u002Fzh\u002Fguide\u002Fconnect-bot.md","连接机器人：轮询、Webhook 与 Chrome",{"type":9,"value":196,"toc":247},[197,201,204,207,210,213,216,219,226,228,239,241],[12,198,200],{"id":199},"你的机器人在本地连接","你的机器人，在本地连接。",[16,202,203],{},"使用专用 Telegram 机器人，在 TGDog 插件中输入 Token；网站不会要求填写。TGDog 会向 Telegram 验证机器人，并检查是否已有 Webhook 接收更新。",[12,205,206],{"id":206},"解决更新接收冲突",[16,208,209],{},"Webhook 与轮询不能同时接收更新。只有在你明确确认切换接收方式后，TGDog 才会移除已有 Webhook。一个机器人应仅由一个接收客户端或 Chrome 用户配置使用。",[16,211,212],{},"Token 保存在 chrome.storage.local 中。这是浏览器本地存储，并非操作系统加密保险箱。",[12,214,215],{"id":215},"浏览器的运行条件",[16,217,218],{},"Chrome 需要保持运行，设备保持唤醒并联网。Telegram 待接收更新最多保留 24 小时；长时间离线可能造成消息缺口。TGDog 不读取 Telegram Web 的 DOM，也不扫描全部聊天历史。",[16,220,221],{},[34,222,225],{"href":223,"rel":224},"https:\u002F\u002Fcore.telegram.org\u002Fbots\u002Fapi#getting-updates",[38],"来源：Telegram 更新接收机制",[12,227,140],{"id":140},[142,229,230,233,236],{},[26,231,232],{},"一个机器人应只使用一个更新接收端。",[26,234,235],{},"TGDog 需要 Chrome 保持运行、唤醒与联网。",[26,237,238],{},"Telegram 待接收更新最多保留 24 小时。",[12,240,155],{"id":155},[16,242,158,243,163,245,137],{},[34,244,162],{"href":161},[34,246,167],{"href":166},{"title":104,"searchDepth":169,"depth":169,"links":248},[249,250,251,252,253],{"id":199,"depth":172,"text":200},{"id":206,"depth":172,"text":206},{"id":215,"depth":172,"text":215},{"id":140,"depth":172,"text":140},{"id":155,"depth":172,"text":155},"了解 TGDog 如何接收更新，以及如何解决机器人连接冲突。",{},"\u002Fzh\u002Fguide\u002Fconnect-bot",{"title":194,"description":254},"zh\u002Fguide\u002Fconnect-bot",[232,235,238],"-Py6jj5bTflUbAtBkuPJ8RNVOxjYJqeM8kOaYGsEihA",{"id":262,"title":263,"author":7,"body":264,"category":179,"description":320,"extension":181,"language":182,"meta":321,"navigation":184,"order":169,"path":322,"published":187,"readingMinutes":172,"seo":323,"stem":324,"takeaways":325,"updated":187,"__hash__":326},"guides\u002Fzh\u002Fguide\u002Fgroup-rules.md","超级群、管理员权限与白名单",{"type":9,"value":265,"toc":313},[266,270,273,276,279,282,285,292,294,305,307],[12,267,269],{"id":268},"每个群保留自己的规则","每个群，保留自己的规则。",[16,271,272],{},"将机器人以管理员身份加入测试超级群，发送 \u002Fsetup 或一条文字消息，然后在 TGDog 中接收更新。在“群与规则”中开启该群。当前版本支持超级群的监控与管理。",[12,274,275],{"id":275},"复制规则时保留各群动作",[16,277,278],{},"按名称或 ID 搜索、筛选群组，并批量暂停观察。复制已保存的检测规则时，会保留各群自己的白名单、管理员列表和观察开关，不会复制关键词动作选项。",[12,280,281],{"id":281},"管理员与白名单豁免",[16,283,284],{},"管理员和白名单中的用户 ID 会被豁免。管理员查询失败会在对应群中显示错误，不会在身份不确定时默默继续。",[16,286,287],{},[288,289],"img",{"alt":290,"src":291},"TGDog 群管理面板：搜索、状态筛选和规则设置","\u002Fscreenshots\u002Fgroups-zh.png",[12,293,140],{"id":140},[142,295,296,299,302],{},[26,297,298],{},"开启管理功能仅支持超级群。",[26,300,301],{},"管理员及白名单用户享有豁免。",[26,303,304],{},"复制检测规则不会复制动作选择。",[12,306,155],{"id":155},[16,308,158,309,163,311,137],{},[34,310,162],{"href":161},[34,312,167],{"href":166},{"title":104,"searchDepth":169,"depth":169,"links":314},[315,316,317,318,319],{"id":268,"depth":172,"text":269},{"id":275,"depth":172,"text":275},{"id":281,"depth":172,"text":281},{"id":140,"depth":172,"text":140},{"id":155,"depth":172,"text":155},"配置支持的群组，豁免可信成员，并正确复用检测规则。",{},"\u002Fzh\u002Fguide\u002Fgroup-rules",{"title":263,"description":320},"zh\u002Fguide\u002Fgroup-rules",[298,301,304],"7EBs5qve3wAihma15hCZk0PBGm6sSGRn6-KaNYK7v0M",{"id":328,"title":329,"author":7,"body":330,"category":434,"description":435,"extension":181,"language":182,"meta":436,"navigation":184,"order":437,"path":438,"published":187,"readingMinutes":172,"seo":439,"stem":440,"takeaways":441,"updated":187,"__hash__":442},"guides\u002Fzh\u002Fguide\u002Fspam-filter-rules.md","关键词、重复消息与防刷屏规则",{"type":9,"value":331,"toc":425},[332,336,339,342,345,348,354,357,360,364,367,370,404,406,417,419],[12,333,335],{"id":334},"匹配你关心的消息内容","匹配你关心的消息内容。",[16,337,338],{},"每行输入一个关键词，最多 30 个，每个最多 80 个字符。消息包含关键词时，即可保存匹配证据。可选的模糊匹配支持识别文本变体，相似度阈值为 0.70–0.98，默认 0.85。",[12,340,341],{"id":341},"模糊匹配的限制",[16,343,344],{},"少于四个字符的词仅使用包含匹配。模糊检查只覆盖每条消息的前 500 个字符，并受每群计算预算限制。相似度不是垃圾消息概率，预算限制可能导致漏检。",[12,346,347],{"id":347},"包含匹配示例",[16,349,350,351],{},"关键词： ",[47,352,353],{},"免费赠送",[16,355,356],{},"消息：“今天来参加我们的 免费赠送 活动。”",[16,358,359],{},"观察模式下保存证据",[12,361,363],{"id":362},"重复消息近似重复与防刷屏","重复消息、近似重复与防刷屏",[16,365,366],{},"重复消息、近似重复和短时间刷屏有各自的检测设置。已开启的检测类型可使用群内选择的观察、封禁或移除动作；只需要证据时，请保留观察模式。",[12,368,369],{"id":369},"典型社群推荐配置模板",[142,371,372,392,398],{},[26,373,374,377,378,381,382,381,385,381,388,391],{},[29,375,376],{},"Web3 与加密讨论群","：重点配置钓鱼诱导词（如 ",[47,379,380],{},"airdrop","、",[47,383,384],{},"claim reward",[47,386,387],{},"助记词",[47,389,390],{},"私信领币","），开启近似重复检测，并设置严格的防刷屏限制（如 5 秒内 3 条）。先以观察模式留痕，确认诈骗外链后切换为封禁动作。",[26,393,394,397],{},[29,395,396],{},"技术交流与开源社区","：针对商业引流与兼职代写词汇；放宽重复消息检测阈值（5 次以上），避免误伤群员重复贴出的报错日志或代码片段；将核心维护者加入白名单。",[26,399,400,403],{},[29,401,402],{},"同城生活与兴趣群","：添加常见同城营销词；开启 60 秒重复消息检测；先在观察模式下验证规则，对跨群批量群发的高频广告账号启用移除动作。",[12,405,140],{"id":140},[142,407,408,411,414],{},[26,409,410],{},"从明确的关键词与观察模式开始。",[26,412,413],{},"相似度不等于垃圾消息概率。",[26,415,416],{},"分别检查重复消息与防刷屏设置。",[12,418,155],{"id":155},[16,420,158,421,163,423,137],{},[34,422,162],{"href":161},[34,424,167],{"href":166},{"title":104,"searchDepth":169,"depth":169,"links":426},[427,428,429,430,431,432,433],{"id":334,"depth":172,"text":335},{"id":341,"depth":172,"text":341},{"id":347,"depth":172,"text":347},{"id":362,"depth":172,"text":363},{"id":369,"depth":172,"text":369},{"id":140,"depth":172,"text":140},{"id":155,"depth":172,"text":155},"rules-and-actions","结合匹配限制、阈值与证据，调整 Telegram 垃圾消息过滤规则。",{},4,"\u002Fzh\u002Fguide\u002Fspam-filter-rules",{"title":329,"description":435},"zh\u002Fguide\u002Fspam-filter-rules",[410,413,416],"xyLQ5tvQCoTTksffsNyzmywfV48g-0bJUPpMXXpO7GQ",{"id":444,"title":445,"author":7,"body":446,"category":434,"description":535,"extension":181,"language":182,"meta":536,"navigation":184,"order":537,"path":538,"published":187,"readingMinutes":172,"seo":539,"stem":540,"takeaways":541,"updated":187,"__hash__":542},"guides\u002Fzh\u002Fguide\u002Fmember-actions.md","观察、封禁与移除：各动作的实际影响",{"type":9,"value":447,"toc":524},[448,452,455,458,462,465,469,472,475,484,487,490,493,496,503,505,516,518],[12,449,451],{"id":450},"先观察再明确选择","先观察，再明确选择。",[93,453,454],{"id":454},"观察",[16,456,457],{},"保存匹配证据，不改变群成员状态。这是默认动作。",[93,459,461],{"id":460},"封禁block","封禁（Block）",[16,463,464],{},"封禁命中规则的成员；封禁期间无法重新加入。",[93,466,468],{"id":467},"移除remove","移除（Remove）",[16,470,471],{},"先封禁，再解封，允许成员重新加入，但不会自动将成员加回。",[12,473,474],{"id":474},"消息删除与所需权限",[476,477,478],"blockquote",{},[16,479,480,483],{},[29,481,482],{},"历史消息会受到影响。"," Telegram 的封禁操作会删除该成员在超级群中的消息历史。Block 和 Remove 都会使用此操作，Remove 不能保证保留历史消息。",[16,485,486],{},"自动动作需要开启群规则，并明确选择封禁或移除。机器人需要删除消息和限制成员权限。TGDog 会先尝试删除当前缓存中仍命中的消息，每批最多 100 条，再处理成员。显式删除通常仅适用于未满 48 小时的消息。保存规则也可能检查已有缓存消息并创建处理任务，不仅处理后续新消息。",[12,488,489],{"id":489},"查看结果并恢复未完成动作",[16,491,492],{},"在“执行记录”查看待执行、重试、成功、失败、跳过或未知状态。未知网络响应不代表成功。未完成的 Remove 可能需要恢复解封，请在断开连接或清除本地数据前完成恢复。",[16,494,495],{},"当前实现的动作处理已进行模拟测试。项目文档尚未确认真实群组中的动作验证。用于正式群前，请先在指定测试群中验证行为。",[16,497,498],{},[34,499,502],{"href":500,"rel":501},"https:\u002F\u002Fcore.telegram.org\u002Fbots\u002Fapi#banchatmember",[38],"来源：Telegram 成员封禁语义",[12,504,140],{"id":140},[142,506,507,510,513],{},[26,508,509],{},"观察只保存证据，不处理成员。",[26,511,512],{},"封禁与移除均影响成员历史消息。",[26,514,515],{},"未知结果需要核验，不能当作成功。",[12,517,155],{"id":155},[16,519,158,520,163,522,137],{},[34,521,162],{"href":161},[34,523,167],{"href":166},{"title":104,"searchDepth":169,"depth":169,"links":525},[526,531,532,533,534],{"id":450,"depth":172,"text":451,"children":527},[528,529,530],{"id":454,"depth":169,"text":454},{"id":460,"depth":169,"text":461},{"id":467,"depth":169,"text":468},{"id":474,"depth":172,"text":474},{"id":489,"depth":172,"text":489},{"id":140,"depth":172,"text":140},{"id":155,"depth":172,"text":155},"启用自动动作前，了解成员封禁、消息删除、权限与恢复行为。",{},5,"\u002Fzh\u002Fguide\u002Fmember-actions",{"title":445,"description":535},"zh\u002Fguide\u002Fmember-actions",[509,512,515],"9gDDDS_HCBL3tdWZOA6Bkao6_EQ5qZxlIPF5UiVDLIs",{"id":544,"title":545,"author":7,"body":546,"category":646,"description":647,"extension":181,"language":182,"meta":648,"navigation":184,"order":649,"path":650,"published":187,"readingMinutes":172,"seo":651,"stem":652,"takeaways":653,"updated":187,"__hash__":654},"guides\u002Fzh\u002Fguide\u002Fmessage-evidence.md","消息证据、本地存储与保留期限",{"type":9,"value":547,"toc":640},[548,552,555,558,564,567,619,621,632,634],[12,549,551],{"id":550},"知道命中了什么以及为什么","知道命中了什么，以及为什么。",[16,553,554],{},"证据包含原文、消息 ID 和时间、匹配词或片段，以及检测时的规则快照。执行记录单独展示尝试处理时实际发生的结果。",[16,556,557],{},"活跃群可能在达到设置的时间窗口前耗尽消息上限。规则变化或编辑后的消息不再匹配时，旧证据不会自动撤回。清除本地缓存不会删除 Telegram 消息。",[16,559,560],{},[34,561,563],{"href":562},"\u002Fzh\u002Fprivacy\u002F","查看数据说明",[12,565,566],{"id":566},"保留期限一览",[568,569,570,583],"table",{},[571,572,573],"thead",{},[574,575,576,580],"tr",{},[577,578,579],"th",{},"数据",[577,581,582],{},"限制",[584,585,586,595,603,611],"tbody",{},[574,587,588,592],{},[589,590,591],"td",{},"原始消息",[589,593,594],{},"每群最多 3,000 条，最长 7 天",[574,596,597,600],{},[589,598,599],{},"匹配证据",[589,601,602],{},"30 天",[574,604,605,608],{},[589,606,607],{},"已完成执行记录",[589,609,610],{},"默认 30 天",[574,612,613,616],{},[589,614,615],{},"未解决恢复任务",[589,617,618],{},"保留至解决",[12,620,140],{"id":140},[142,622,623,626,629],{},[26,624,625],{},"消息与证据使用不同的保留限制。",[26,627,628],{},"活跃群可能提前达到缓存数量上限。",[26,630,631],{},"清除本地缓存不会删除 Telegram 消息。",[12,633,155],{"id":155},[16,635,158,636,163,638,137],{},[34,637,162],{"href":161},[34,639,167],{"href":166},{"title":104,"searchDepth":169,"depth":169,"links":641},[642,643,644,645],{"id":550,"depth":172,"text":551},{"id":566,"depth":172,"text":566},{"id":140,"depth":172,"text":140},{"id":155,"depth":172,"text":155},"data-and-troubleshooting","了解 TGDog 在本地保存哪些信息、保留多久，以及清缓存意味着什么。",{},6,"\u002Fzh\u002Fguide\u002Fmessage-evidence",{"title":545,"description":647},"zh\u002Fguide\u002Fmessage-evidence",[625,628,631],"Wn1lWabrns0qaui3OP6RSvTAUTlQLBap1nTHXIMnMB8",{"id":656,"title":657,"author":7,"body":658,"category":646,"description":731,"extension":181,"language":182,"meta":732,"navigation":184,"order":733,"path":734,"published":187,"readingMinutes":172,"seo":735,"stem":736,"takeaways":737,"updated":187,"__hash__":738},"guides\u002Fzh\u002Fguide\u002Ftroubleshooting.md","排查更新缺失与 Telegram API 错误",{"type":9,"value":659,"toc":721},[660,664,667,670,673,676,680,683,690,694,700,702,713,715],[12,661,663],{"id":662},"遇到问题时从这里检查","遇到问题时，从这里检查。",[93,665,666],{"id":666},"未收到消息",[16,668,669],{},"确认 Chrome 正在运行并联网、Token 有效、机器人是超级群管理员。检查是否有其他客户端或 Webhook 接收更新。机器人可见的消息由 Telegram 决定，不能假定它能收到所有类型的消息。",[93,671,672],{"id":672},"关键词似乎漏检",[16,674,675],{},"检查群管理和关键词规则是否开启、发送者是否被豁免、消息是否存在于本地缓存。使用插件的漏检诊断，查看接收状态和规则原因。该诊断不会获取全部历史消息，也不会触发处罚。",[93,677,679],{"id":678},"_409429-或未知动作状态","409、429 或未知动作状态",[16,681,682],{},"409 表示更新接收冲突，请消除冲突后手动恢复。429 会遵循 Telegram 返回的重试延迟。未知动作需要查看执行记录，必要时核对成员状态，不应视为已完成。",[16,684,685],{},[34,686,689],{"href":687,"rel":688},"https:\u002F\u002Fcore.telegram.org\u002Fbots\u002Ffaq#what-messages-will-my-bot-get",[38],"来源：机器人可以接收哪些消息？",[93,691,693],{"id":692},"仍然需要帮助","仍然需要帮助？",[16,695,696],{},[34,697,699],{"href":698},"\u002Fzh\u002Fcontact\u002F","联系我们",[12,701,140],{"id":140},[142,703,704,707,710],{},[26,705,706],{},"调整规则前，先检查消息接收与豁免。",[26,708,709],{},"409 表示接收冲突；429 需要等待。",[26,711,712],{},"清理本地数据前，先处理未知动作结果。",[12,714,155],{"id":155},[16,716,158,717,163,719,137],{},[34,718,162],{"href":161},[34,720,167],{"href":166},{"title":104,"searchDepth":169,"depth":169,"links":722},[723,729,730],{"id":662,"depth":172,"text":663,"children":724},[725,726,727,728],{"id":666,"depth":169,"text":666},{"id":672,"depth":169,"text":672},{"id":678,"depth":169,"text":679},{"id":692,"depth":169,"text":693},{"id":140,"depth":172,"text":140},{"id":155,"depth":172,"text":155},"诊断匹配遗漏、接收冲突、速率限制与未知动作结果。",{},7,"\u002Fzh\u002Fguide\u002Ftroubleshooting",{"title":657,"description":731},"zh\u002Fguide\u002Ftroubleshooting",[706,709,712],"j3sqePNfHBD5W-a1cWZlVxTp8v0nW1RG3mJEHyjO23s",1791598870646]