telegram

用个人号（MTProto）收发 Telegram：把文本/图片/视频/相册发到指定 chat，也读某个 chat 的消息（只读，不回读媒体文件）

以 Pi package（技能形态）发布。技能本体在 skills/telegram/。

• 平台：全平台
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

pi install git:gitea.vhkd.top/pi-hub/telegram.git@v0.1.0

装完 pi-skill list 能看到 telegram，pi-skill telegram check 会告诉还缺什么。

先准备什么

• python3（运行环境），安装：brew install python3；Telethon 工作进程跑在 local/skills/telegram/venv 里，由 setup --deps 用 python3 -m venv 建；telethon/python-socks 随 venv 装，用 status 查
• scutil（命令），安装：不用装：macOS 自带；Linux/Windows 上这一条可忽略（用 HTTPS_PROXY 环境变量或 setup --proxy）；只在 macOS 上自动读系统代理（scutil --proxy）；读不到就退回环境变量/直连，不是硬前置

常用命令

命令	说明
status	自检：依赖 / 凭据 / 登录态
setup	装依赖（--deps）或写入 api_id / api_hash
login	两步登录：先发码，再填码（含 2FA）
chats	列出/搜索对话，拿目标 chat 的 id 或 @username
read	读消息：--chat 必给；--limit/--since/--topic/--search 可选，按时间正序回 id/时间/发言人/类型/正文
send	发文本/图片/视频/相册（+caption、话题），回读 message_id
delete	删除自己发的消息（默认预览，--yes 才删）

用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。