Telegram Contacts 是一个围绕 Telegram 联系人管理的工具技能，提供导出、导入和查询三类操作。
用途 该技能用于处理 Telegram 联系人数据，典型使用场景包括：从 Telegram 导出联系人、在 Telegram 中查找某个联系人、向 Telegram 导入联系人、查询某个 @username 是谁、按手机号查找联系人。
主要能力
- 导出联系人：支持导出为 CSV 或 JSON。CSV 输出到标准输出或指定文件；JSON 可附带最近消息。CSV 列包括 user_id、username、first_name、last_name、phone。JSON 在此基础上额外包含 messages、last_message_date、messages_count。
- 查询联系人：支持按用户名（如 @username）或手机号（如 +380671234567）查询，显示姓名、用户名、电话、ID 以及最近 5 条消息。如果联系人不在列表中，会临时添加并在检查后自动移除。
- 导入联系人：从 CSV 文件导入，CSV 格式为 first_name,last_name,phone。
使用方式 工具路径为 $TG_TOOLS_PATH/tools/tg_contacts.py，通过 python3 运行。
导出联系人：
CSV 到标准输出
python3 $TG_TOOLS_PATH/tools/tg_contacts.py export
CSV 到文件
python3 $TG_TOOLS_PATH/tools/tg_contacts.py export --output contacts.csv
JSON 并附带最近消息
python3 $TG_TOOLS_PATH/tools/tg_contacts.py export --output contacts.json --messages 50
查询联系人：
按用户名
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_contacts.py import --input contacts.csv
适用场景 适合需要批量备份或迁移 Telegram 通讯录、快速定位某个用户名或手机号对应的联系人、以及将已有 CSV 联系人列表导入 Telegram 的用户。
限制
- 带消息的 JSON 导出可能较慢，每个联系人约 0.3 秒。
- 进度每 100 个联系人保存一次。
- 并非所有手机号都在 Telegram 注册。
相关技能 telegram-send（发送消息）、telegram-check（检查回复）、update-lead（查询后更新 CRM）。