名称： tg
描述： Telegram 命令行工具，用于读取、搜索和发送消息。当用户询问 Telegram 消息、想检查收件箱、搜索聊天记录、发送消息或查找联系人和群组时使用。

Telegram CLI

用于读取、搜索和发送消息的快速 Telegram 命令行工具。

使用场景

当用户出现以下需求时，可使用此技能：
- 要求检查 Telegram 消息或收件箱
- 想在 Telegram 中搜索某个主题/关键词
- 想给某人发送 Telegram 消息
- 询问 Telegram 群组、联系人或聊天信息
- 想查看未读消息
- 需要查找群组成员或管理员

安装

npm install -g @cyberdrk/tg

或从源码安装：

cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link

认证

首次使用需要从 https://my.telegram.org/apps 获取 API 凭证。

tg auth

命令

读取消息

tg inbox                               # 未读消息摘要
tg chats                               # 列出所有聊天
tg read "聊天名称" -n 50               # 读取最近 50 条消息
tg read "聊天名称" --since "1h"        # 读取最近一小时的消息
tg read @用户名 -n 20                  # 读取与用户的私聊消息
tg search "查询词" --chat "聊天名称"    # 在指定聊天中搜索
tg search "查询词" --all               # 在所有聊天中搜索

发送消息

tg send @用户名 "消息内容"              # 发送私聊消息
tg send "群组名称" "消息内容"           # 发送到群组
tg reply "聊天名称" 12345 "回复内容"    # 回复指定消息 ID

联系人 & 群组

tg contact @用户名                     # 获取联系人信息
tg members "群组名称"                  # 列出群组成员
tg admins "群组名称"                   # 仅列出管理员
tg groups --admin                      # 列出你担任管理员的群组

状态

tg whoami                              # 显示当前登录账户
tg check                               # 验证会话状态

输出格式

所有命令都支持 --json 参数，以便生成适合程序处理的 JSON 结构化数据：

tg inbox --json                        # JSON 格式输出
tg read "聊天名称" --json              # 包含消息数组的 JSON
tg chats --json                        # 包含聊天列表的 JSON

示例

检查收件箱：

tg inbox

读取某个聊天的最近消息：

tg read "MetaDAO 社区" -n 20

搜索特定主题：

tg search "futarchy" --chat "MetaDAO"

发送消息：

tg send @用户名 "你好，我来看看！"

注意事项

• 聊天名称支持部分匹配（例如 "MetaDAO" 可匹配 "MetaDAO Community"）
• 用户名必须以 @ 开头（例如 @username）
• 消息按时间倒序返回（最新的在前）
• --since 标志支持 "1h"、"30m"、"7d" 等时间格式