用途:te-cli 是 ThinkingEngine 数据分析平台的命令行工具,供 AI Agent 和人类用户使用。本技能为其基础部分,涵盖认证、全局参数、错误处理与安全约束。
认证:使用前必须先认证,优先级为环境变量 TE_TOKEN(最高,适合 CI/脚本)、缓存 token(~/.te-cli/tokens.json,20 小时有效)、macOS 自动从 Chrome 提取(仅 macOS)。命令:te-cli auth login(macOS 自动认证)、te-cli auth set-token <token>、te-cli auth status、te-cli auth logout。多环境可用 --host 指定,如 te-cli auth login --host ta-staging.example.com,并用 te-cli config set defaultHost 配置默认 host。
全局参数:所有命令支持 --host(默认配置中的 defaultHost 或 ta.thinkingdata.cn)、--format(json|table,默认 json)、--jq(jq 过滤表达式)、--dry-run(只显示请求不执行)、--yes(跳过 write 操作确认)。
输出与错误:默认 JSON 输出形如 {"ok": true, "data": {...}};table 格式示例 te-cli meta +list-events -p 1 --format table;jq 过滤示例 te-cli meta +list-events -p 1 --jq '.events[].eventName'。错误输出到 stderr,格式含 ok、error.type(auth|api|validation|config)、message、hint;退出码成功 0、错误 1。
安全约束:risk 为 read 的命令直接执行;risk 为 write 的命令需确认,除非传入 --yes;可用 --dry-run 预览将发送的请求。
命令结构:te-cli <domain> +<command> [flags] 与 te-cli api <METHOD> <PATH> [--params] [--data];域包括 meta(元数据)、analysis(分析)、audience(受众)、operation(运营)。
限制:资料未提供各域具体命令清单、权限范围、速率限制及平台兼容性细节。