开发者专属的 Telegram 终端

开源 Telegram CLI 工具，支持消息收发、搜索、群组管理，需自建 API 凭证，适合开发者自动化场景。

基本信息

• 技能名称?Telegram CLI
• 中文名称?开发者专属的 Telegram 终端
• 作者?arein
• 分类?专业技能
• 版本?0.1.0
• 标签?cli, telegram, messaging, automation, mtproto, nodejs

使用方法

使用说明
核心用法
tg 是一个基于 Node.js 的命令行 Telegram 客户端，封装了 MTProto 协议，提供完整的消息读写与群组管理能力。核心工作流围绕「阅读-搜索-发送」三环节展开：
消息处理 ： tg inbox 快速查看未读摘要， tg read 支持按时间范围（ --since ）或数量（ -n ）拉取历史，所有输出可转 JSON 供管道处理。
搜索能力 ： tg search 支持单聊检索与全局检索，关键词匹配消息内容，适合在海量对话中定位信息。
主动通信 ： tg send 与 tg reply 覆盖私信与群组场景，支持通过用户名（ @username ）或群组名定位目标。
群组管理 ： tg members / tg admins 提供成员与权限视图， --admin 筛选可管理群组，便于运营者批量盘点。
显著优点
纯 CLI 体验 ：无 GUI 依赖，适合服务器部署与自动化脚本
结构化输出 ：全命令支持 --json ，易于与 jq/Python 整合
灵活时间过滤 ： --since 支持自然语言（1h/30m/7d），降低心智负担
模糊匹配 ：聊天名称支持部分匹配，减少精确记忆成本
潜在局限
用户
自建凭证门槛 ：需前往 my.telegram.org 申请 api_id/api_hash，流程繁琐且需手机号验证
会话管理风险 ：首次 tg auth 生成本地 session，多设备同步与密钥保管责任在
功能边界 ：不支持语音/视频通话、文件传输、贴纸等富媒体交互
生态维护 ：npm 包 @cyberdrk/tg 下载量与社区活跃度待观察，长期维护存疑
适合人群
需批量处理 Telegram 消息的开发者/数据分析师
运营多群组的管理员，需快速导出成员或统计活跃
偏好终端工作流、追求自动化效率的技术用户
常规风险
| 风险点 | 说明 | |--------|------| | API 密钥泄露 | api_id/hash 若硬编码或误提交，可被滥用导致账号封禁 | | 本地会话文件 | 存储于用户目录的 session 文件需权限管控，避免横向移动 | | 频率限制 | Telegram 服务端对 API 调用有速率限制，批量操作可能触发冷却 | | 账号安全 | CLI 登录等价于独立客户端，若设备失窃需 revoke 会话 |