Telegram 私信群发（Python）

核心原则

• 仅依赖 Python 客户端库，不调用 gomtm server、mtgate 或其他项目端点。
• 优先复用本技能目录下的脚本，不临时重写一套新的登录或群发逻辑。
• 首轮演示以本地 session 文件为主，避免在聊天中暴露 string_session。
• 当前示例优先支持 username / @username / https://t.me/<username> 目标格式；手机号导入联系人不放在第一版脚本里，避免静默修改联系人列表。

先决条件

1. 准备 Telegram 官方 API 凭据：登录 https://my.telegram.org 创建应用，拿到 api_id 和 api_hash。
2. 准备 Python 3.10+ 环境。
3. 安装依赖：

/usr/bin/python3 -m pip install --user -r .agent/skills/telegram-dm/scripts/requirements.txt