用途:tg 是一个 Telegram 命令行工具,用于读取、搜索和发送消息,适合在终端中查看收件箱、检索聊天内容、发送私信或群消息,以及查询联系人和群组信息。
主要能力:读取方面支持 tg inbox 查看未读消息摘要、tg chats 列出全部聊天、tg read "ChatName" -n 50 读取最近消息、tg read "ChatName" --since "1h" 按时间范围读取、tg read @username -n 20 读取私信,以及 tg search "query" --chat "ChatName" 在指定聊天内搜索、tg search "query" --all 搜索全部聊天。发送方面支持 tg send @username "message" 发私信、tg send "GroupName" "message" 发群消息、tg reply "ChatName" 12345 "response" 回复指定消息 ID。联系人与群组方面支持 tg contact @username、tg members "GroupName"、tg admins "GroupName"、tg groups --admin。状态方面支持 tg whoami 和 tg check。所有命令支持 --json 输出结构化结果。
使用方式:安装可执行 npm install -g @cyberdrk/tg,或从源码构建:cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link。首次使用需在 https://my.telegram.org/apps 获取 API 凭据,然后运行 tg auth 完成认证。
限制与注意:聊天名称支持部分匹配,用户名必须以 @ 开头,消息按时间倒序返回,--since 接受 "1h"、"30m"、"7d" 等格式。其他细节暂未提供。