命令行 Telegram 消息管家

基于第三方 Telegram CLI 的纯文档型技能，支持命令行读取、搜索、发送消息及群组管理，适合开发者自动化 Telegram 工作流。

基本信息

• 技能名称?tg
• 中文名称?命令行 Telegram 消息管家
• 作者?arein
• 分类?效率
• 版本?v0.1.0
• 标签?content-media, automation, productivity, api, development-engineering

使用方法

使用说明
核心用法
该 Skill 是 Telegram CLI 工具 @cyberdrk/tg 的使用说明文档，为 AI Agent 提供与 Telegram 交互的标准化指令集。用户需先通过 npm 全局安装 CLI 工具并完成 Telegram API 认证，即可通过命令行实现：消息收发（ tg send 、 、 tg read ）、收件箱管理（ tg inbox ）、聊天记录搜索（ tg search ）、联系人及群组信息查询（ tg contact 、 、 tg members 、 、 tg admins ）等操作。所有命令均支持 --json` 输出格式，便于程序化处理。
显著优点

1. 纯文档零风险 ：Skill 本身不含任何可执行代码，仅为 Markdown 使用指南，安全透明可审计
2. 功能覆盖全面 ：涵盖消息读写、搜索、联系人管理、群组权限查询等核心 Telegram 操作
3. 结构化输出友好 ：内置 JSON 输出支持，方便 AI Agent 解析和后续自动化处理
4. 参数设计灵活 ：支持时间范围过滤（ --since ）、消息数量限制（ -n ）、模糊匹配聊天名称等实用特性
5. 轻量无依赖 ：Skill 不捆绑任何运行时，CLI 工具由用户按需自主安装
   潜在缺点与局限性
6. 来源可信度有限 ：底层 CLI 工具来自个人开发者账号（T3 来源），非 Telegram 官方出品，长期维护存在不确定性
7. 功能边界受限 ：不支持媒体文件上传下载、语音通话、复杂群组管理等高级功能
8. 认证门槛较高 ：首次使用需手动从 my.telegram.org 申请 API ID 和 Hash，对普通用户不够友好
9. 无图形界面 ：纯命令行交互，不适合需要可视化操作的场景
10. 依赖外部工具 ：Skill 仅为文档，实际功能完全依赖用户自行安装的第三方 npm 包，版本兼容性需自行保障
    适合的目标群体
    开发者及技术型用户，需要通过脚本自动化 Telegram 消息处理
    AI Agent 构建者，希望为 Agent 赋予 Telegram 读写能力
    需要批量查询聊天记录、监控群组动态的运营人员
    偏好命令行效率、追求工作流集成的极客用户
    使用风险
11. API 凭证泄露风险 ：Telegram API ID 和 Hash 具有长期有效性，若保管不当可能导致账号被盗用
12. 会话数据本地存储 ：CLI 工具将加密会话保存在 ~/.config/tg/ ，多用户环境需注意目录权限隔离
13. 第三方工具信任问题 ： @cyberdrk/tg 非官方工具，其代码安全性、隐私政策需用户自行评估
14. 误操作风险 ：命令行发送消息无二次确认，批量操作可能导致消息误发
15. Rate Limit 限制 ：高频调用 Telegram API 可能触发平台限流，影响正常使用