Files
Gloridust 98b6495741 docs(tg-bot): 更正私聊窗口为 5 分钟——轮询模式下验证码送不达
上一个提交里我写「user_chat_id 允许 24 小时内私聊,故 Actions 轮询方案成立」,
这是错的。核对官方文档原文:

  "The bot can use this identifier for 5 minutes to send messages
   until the join request is processed"

是 5 分钟。全文中所有 24 hours 均与入群申请无关——我多半是把
"Incoming updates ... not be kept longer than 24 hours"(更新在服务器的保留时长)
错当成了私聊窗口,两者是两回事。

影响:cron 最小 5 分钟且常延后 10~15 分钟 → 窗口多已过期 → 验证码大概率发不出去。
安全性不受影响(待批准用户进不了群、发不了消息),但会退化为人工审批。

- 注释更正为 5 分钟,并写明混淆点,避免以后再踩
- 私聊失败的日志改为说明真实成因与后续动作(仍不自动拒绝,避免误伤真人)
- workflow 注释加显著提示,并给出两条可行的近实时方案(webhook / 自托管长轮询)

验证逻辑本身无需改动,换传输层即可复用。
2026-07-29 00:37:34 +08:00
..