SuperAPI AI 工具集

tg

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

tg 是一个快速读写 Telegram 消息的命令行工具,面向需要在命令行中处理 Telegram 对话的场景。

用途:适合查看未读消息与收件箱、检索某个聊天或全部聊天中的关键词、向联系人或群组发消息、回复指定消息、查看联系人信息,以及查询群成员与管理员。

安装:全局安装在终端执行 npm install -g @cyberdrk/tg;也可从源码安装,进入项目目录后依次执行 npm install、npm run build 和 npm link。

认证:首次使用需在 https://my.telegram.org/apps 获取 API 凭据,然后运行 tg auth 完成登录。状态检查可用 tg whoami 和 tg check。

主要能力:读取方面支持 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" 回复指定消息。联系人与群组方面支持 tg contact @username 查联系人、tg members "GroupName" 列出成员、tg admins "GroupName" 列出管理员、tg groups --admin 列出你作为管理员的群。

输出格式:所有命令支持 --json 生成结构化输出,便于后续处理,例如 tg inbox --json、tg read "Chat" --json 返回消息数组、tg chats --json 返回聊天列表。

使用限制与注意事项:聊天名称支持部分匹配,例如 "MetaDAO" 可匹配 "MetaDAO Community";用户名必须以 @ 开头;消息按时间倒序返回,最新在前;--since 支持 "1h"、"30m"、"7d" 这类格式。收费方式、价格与平台支持范围资料暂未提供。