telegram-check

Telegram Check 是一个用于检查 Telegram 入站消息和回复的技能，依托 tg-tools 完成操作。

用途

该技能适用于需要查看 Telegram 收件情况或活动回复的场景。官方说明中列出的典型触发时机包括：用户说“check telegram”“who replied on telegram”“any new messages?”，以及在群发活动之后检查回复。

主要能力

根据资料，Telegram Check 能够执行以下操作：

查询特定联系人。通过 tg_contacts.py lookup 命令，可查询 @username 或电话号码，输出内容包括 name、username、phone、ID 以及最近 5 条消息。
检查群组或频道中的消息。通过 tg_scrape.py messages 命令，可按数量限制或时间范围读取消息，例如 --limit 20 或 --days 7。
导出全部联系人及消息。通过 tg_contacts.py export 命令，可将每个联系人的最近消息导出为 JSON，例如 --output contacts.json --messages 5。

使用方式

文档给出的运行命令如下：

检查特定联系人： python3 $TG_TOOLS_PATH/tools/tg_contacts.py lookup @username python3 $TG_TOOLS_PATH/tools/tg_contacts.py lookup +380671234567

检查群组/频道消息： python3 $TG_TOOLS_PATH/tools/tg_scrape.py messages "Group Name" --limit 20 python3 $TG_TOOLS_PATH/tools/tg_scrape.py messages "Group Name" --days 7

导出所有联系人及消息： python3 $TG_TOOLS_PATH/tools/tg_contacts.py export --output contacts.json --messages 5

依赖条件

使用该技能需要满足以下依赖：

$TG_TOOLS_PATH/ 目录，其中包含 tg-contacts、tg-scrape；有效的 Telegram 会话。

典型回复模式

文档整理了常见回复内容与对应状态：

“yes”“can do”“will be there”对应 responded + hot； “no”“can't”对应 responded + declined； “when?”“details?”对应 responded + interested；无响应对应 no_response。

适用场景

该技能适合在以下情况使用：需要确认某个 Telegram 联系人是否回复、需要查看最近入站消息、需要在群发或推广活动后检查回复情况，以及需要将联系人及其最近消息导出为 JSON 以便后续处理。

技能介绍