SuperAPI AI 工具集

clitg

办公与效率

查看项目

更新于 10-15 23:59

技能介绍

用途:clitg 通过结构化 CLI 读取和管理 Telegram 用户账户,涵盖消息、媒体与账户设置。使用前需将 Telegram 内容、账户元数据与本地会话视为私密,不得暴露 API hash、登录码、密码、认证密钥或会话材料;认证值应使用非交互式密钥文件或明确选定的 stdin。

安装与发现:检查 command -v clitg 与 clitg version,支持 CLI >=0.3,<0.4、schema >=0.2,<0.3。缺失时报告前置条件与安装命令 uv tool install clitg,本技能不负责安装可执行文件。使用显式 --profile;未指定时查看 clitg profiles list,仅在无歧义时用默认值。全局选项放在命令组之前,如 clitg --profile personal --output json messages list --peer @example。用 clitg --help-json、clitg commands get --command <group.command>、clitg schema list、clitg capabilities get --method <method> 发现选项,用 clitg commands list 查找命令。

目标与结果:读取应限定到指定 peer、日期与内容;仅当有意全账户搜索时才省略 messages search 的 --peer。遇到 ambiguous_peer 时列出候选并取得精确选择,不得猜测变更目标。list、get、search、context、replies、export 不会将消息标记为已读;messages read 需要明确的确认意图。仅在规范化字段不足时请求 --include-raw。仅在存在 manifest 时恢复导出,并保留已有导出数据。将 stdout 解析为 JSON,同时检查退出码与 ok。对 JSONL,通过必需的终止摘要或错误消费条目记录,保留已处理项并报告部分失败。需要翻页时严格遵循不透明的 meta.next_cursor。幂等重放的存储结果视为已完成操作。

条件工作流:变更前阅读 writes.md;AI 转换、Business 设置、贴纸或计划任务阅读 specialized-actions.md;更新流或读取批次阅读 streams-and-batches.md;旧式结构化参数或原始 MTProto 阅读 raw-and-registered.md。

失败处理:rate_limited 时遵守 retry_after_seconds,等待足够短且重放安全时可在授权任务内有限重试,保留精确载荷与幂等键,设置有限尝试或时间上限,不得早于指定延迟重试。写入结果不确定且无法安全重放时应停止并核对。permission_denied 时报告 policy_reason;authentication 错误时报告所需的非交互式命令,不在聊天中索要密钥。报告未满足的 Premium、Business 或管理员要求。不得绕过策略、确认、速率限制、Telegram 权限或平台条款。