怎么装
一次装齐 按顺序执行 2 条
1
pi install git:gitea.vhkd.top/pi-hub/skill-interface@v0.1.4依赖2
pi install git:gitea.vhkd.top/pi-hub/telegram@v0.1.0本体Pi
pi install git:gitea.vhkd.top/pi-hub/telegram@v0.1.0装完跑 pi-skill telegram check。
先准备什么
python3运行环境
Telethon 工作进程跑在 local/skills/telegram/venv 里，由 setup --deps 用 python3 -m venv 建；telethon/python-socks 随 venv 装，用 status 查
brew install python3
scutil命令
只在 macOS 上自动读系统代理（scutil --proxy）；读不到就退回环境变量/直连，不是硬前置
不用装：macOS 自带；Linux/Windows 上这一条可忽略（用 HTTPS_PROXY 环境变量或 setup --proxy）
要先配什么
apiId
必配
Telegram API ID（my.telegram.org → API development tools 里的 App api_id）
你的 Telegram api_id 是多少？
apiHash
必配
私密
Telegram API hash（与 api_id 成对，等同密钥）
你的 Telegram api_hash 是多少？
proxy
可选
连 Telegram 走的代理（127.0.0.1:7890 或 socks5://host:port；留空=直连）
要经哪个代理连 Telegram？（留空 = 直连）
python
可选
跑 Telethon 工作进程的解释器（缺省用 local/skills/telegram/venv 里的 python）
要用哪个 python 跑 telethon？
常用命令
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 才删） |