用途:指导智能体安装并操作 @will-17173/telegram-cli(可执行文件 tg)。tg 既是账号感知的 Telegram 客户端,也是本地 SQLite 消息索引,命令按数据来源、持久化方式及是否修改 Telegram 来区分。
主要能力:账号登录/登出与切换(account);未读概览与在线读取(inbox、read、search-online);联系人与聊天发现(contact、chats、info、group list);持久化历史到本地 SQLite(history、sync、sync-all、refresh、repair);将聊天归档为 Markdown(archive);对已存消息做查询、导出与删除(search、recent、today、stats、top、timeline、filter、export、purge);重置本地数据(data reset);通知与文件夹管理(notification、folder);本地 Web UI(web);监听新消息(listen)与基于规则的群自动化(guard start);以及发送、编辑、删除等远程写操作。
使用方式:开发当前源码时需 Node.js 22+,执行 pnpm install 后用 pnpm dev <args>(不要多加 --)。否则先运行 command -v tg;未安装则确认 node --version 与 npm --version 成功且 Node.js 不低于 22,再执行 npm install --global @will-17173/telegram-cli 安装,安装后校验 hash -r、command -v tg、tg --version、tg --help。已安装则不要自动重装升级。自动化中必须用 --account <name> 显式指定账号;有限命令需在 --json、--yaml、--markdown 中择一,自动化用 JSON/YAML,并检查进程退出状态与结构化 ok 字段;结构化信封使用 schema_version: "2"。
限制与安全:启用写权限或执行任何远程变更前须获用户明确授权,启用写权限不等于授权某次变更;执行前检查 tg config write-access status --json。开启写权限运行 guard start 属持续远程自动化,需先审阅其分组规则与策略并授权。禁止明文提供、索取或自动化所有权转移密码,该命令仅支持交互式 TTY。API hash、代理 URL、会话、账号元数据、导出消息和数据库均视为机密,不得打印 config list --show-secrets 或提交 DATA_DIR。权限失败不得用 sudo 重试。其余如具体价格、平台支持、性能效果等资料未提供。