Turing CLI
turing-cli 是图灵平台的命令行工具。它把文档转换、用量查询和 CLI 自更新整理成可脚本化的终端命令,适合本机终端、CI 任务和智能体工作流。
turing-cli 可以和智能体 skills 配合使用。相关 skills 可以在 SkillHub 找到,也可以按自己使用的智能体或 IDE 规范自行配置自有 skills。
| Skill | 配合的 CLI 能力 | 入口 |
|---|---|---|
| Turing Operations | turing-cli operations search / dashboards,用于查询用量、费用、token 和拆分明细 | SkillHub: Turing Operations |
| Documents | turing-cli documents convert,用于把 PDF / Word / Excel / PowerPoint 转成 Markdown 供智能体阅读 | SkillHub: Documents |
能力概览
| 子领域 | 用途 | 常用命令 |
|---|---|---|
| Documents | 将 PDF / Word / Excel / PowerPoint 转成 Markdown | turing-cli documents convert |
| Operations | 查询图灵平台用量、费用、token、模型和请求明细 | turing-cli operations |
| Upgrade & Version | 检查更新、安装新版本、查看当前版本 | turing-cli upgrade |
安装
macOS / Linux:
curl -fsSL https://live-public-aigc-resources.s3.cn-north-1.amazonaws.com.cn/turing/turing-cli/install.sh | bash
turing-cli version
Windows PowerShell:
irm https://live-public-aigc-resources.s3.cn-north-1.amazonaws.com.cn/turing/turing-cli/install.ps1 | iex
turing-cli version
配置 API Key
推荐写入 ~/.turing-cli.yaml:
api_key: sk-...
也可以使用环境变量,且环境变量优先级更高:
export TURING_API_KEY="sk-..."
只有临时连接其它环境时才需要覆盖 API 地址:
export TURING_API_BASE="https://<other-env>/api/v1"
快速开始
turing-cli version
turing-cli documents convert report.pdf
turing-cli operations search -q 张三
turing-cli operations dashboards --type username --value san.zhang
turing-cli upgrade check
命令结构
turing-cli
├── documents
│ └── convert
├── operations
│ ├── search
│ └── dashboards
├── upgrade
│ ├── check
│ └── apply
└── version
全局参数
全局参数可放在任意子命令之前:
turing-cli --config ./turing-cli.yaml operations search -q 张三
| 参数 | 默认值 | 说明 |
|---|---|---|
--config FILE | $HOME/.turing-cli.yaml | 配置文件路径 |
-v, --verbose | false | verbose 输出 |
-h, --help | 查看当前命令帮助 |
排错
| 现象 | 处理 |
|---|---|
command not found: turing-cli | 重新运行安装脚本,并确认安装目录在 PATH 中 |
缺少 API Key | 配置 ~/.turing-cli.yaml 或 TURING_API_KEY |
| 网络连接失败 | 检查网络、代理和是否能访问对应环境 |
HTTP 403 | 当前 API Key 没有查询目标资源的权限 |
卸载
macOS / Linux:
sudo rm /usr/local/bin/turing-cli
Windows:删除 %LOCALAPPDATA%\Programs\turing-cli 下的 turing-cli.exe,并从 PATH 中移除该目录。