aidc CLI

AIDC Developer 的命令行，也是智能体使用 AIDC 的首选入口：每条命令都能输出 JSON、从不交互、退出码稳定。所有业务逻辑都在 API 里，CLI 只做参数、文件与输出。

安装

curl -fsSL https://www.ai-dc.ai/developer/cli/install.sh | sh

需要 Node 18 以上。安装脚本把单文件 CLI 下载到 ~/.aidc/bin/aidc；也可以直接 node aidc.mjs …（下载地址 https://www.ai-dc.ai/developer/cli/aidc.mjs）。aidc video 与长音频转写需要 ffmpeg。

命令	说明
`aidc login`	设备授权：打印链接与授权码 → 浏览器里批准 → 拿到开发者 Key
`aidc login --no-wait --json`	只打印授权链接（智能体把它交给人），随后 `aidc login --continue` 完成
`aidc login --with-key < key.txt`	从 stdin 读开发者 Key（CI）
`aidc whoami` · `aidc keys`	身份、Key 列表
`aidc logout [--revoke]`	删除本机 Key；`--revoke` 同时在服务端吊销

凭证读取顺序：环境变量 AIDC_API_KEY → ~/.aidc/config.json（0600）。API 根：--api → AIDC_API_BASE → 配置文件 → https://www.ai-dc.ai。

命令一览

aidc models
aidc model chat -m <模型> "<提示>" [--system …] [--image 图…] [--json-object] [--stream]
aidc model decide --state "<文本>" --question id=说明 --choice id:选项=判据 …

aidc vision inspect <图片…> --task "<检查什么>" [--criteria …] [-m gpt-6-luna]
aidc voice transcribe <音频/视频> [--language zh] [-m gpt-transcribe]
aidc voice translate "<文本>" --to ja,en,ar-EG,bn
aidc voice minutes <逐字稿.txt> [--title …]
aidc video frames <视频> --every <秒> [--out 目录] [--max N]
aidc video inspect <视频> --every <秒> --task "<检查什么>" [--transcribe]

aidc data profile <file.csv|json>
aidc data group <file> --by <列> [--sum 列] [--avg 列] [--count]

aidc connect datasets
aidc connect report <数据集> [--report overview]
aidc connect send "<消息>" [--session <id>]          # Agent Key 读 AIDC_AGENT_KEY

aidc stream create <流名> --title … [--key 主键] --field 名:类型[:显示名] … [--retention N] [--spec 文件.json]
aidc stream list · status <流名> · get <流名>
aidc stream key <流名> --label "装在哪" · keys <流名> · revoke <流名> --prefix aidc-pk-…
aidc stream publish <流名> --event '{…}' | --file 事件.json
aidc stream tail <流名> [--after N]                   # 实时订阅（SSE），每次变化一行；--json 输出 JSON 行
aidc stream pipe <命名空间>/<流名> -- <适配器命令…>   # 边缘发布端（发布 Key 读 AIDC_PUBLISH_KEY）
               [--heartbeat 30] [--full-every 360] [--stale-after 15]   # 秒 / 分 / 分
aidc stream delete <流名> [--dry-run]

aidc app init <slug> [--template blank|camera|voice|data] [--title …] [-n <命名空间>]
aidc app check [目录]
aidc app dev [目录] [--port 5173]
aidc app deploy [目录] [--notes …] [--dry-run]         # 版本号 = 清单 version，内容变了就要升
aidc app publish <slug|目录> [--version 1.2.0] [--notes …] [--dry-run]
aidc app rollback <slug> --version 1.1.0 [--notes …]
aidc app status <slug> · aidc app history <slug> · aidc app list   # slug 也可写 <命名空间>/<slug>

流名可以写 <流名>（命名空间取当前登录的公司）或 <命名空间>/<流名>。aidc stream pipe 常驻运行（systemd 服务，不是定时器），适配器协议见连接 SDK · 实时数据流。

通用参数：--json（stdout 不是终端时默认开启）、--dry-run、--api <根地址>、-n/--namespace。

输出与退出码

JSON 模式下，成功输出命令的数据对象；失败输出 { ok: false, error: { code, message, status, details, requestId } }。进度提示一律在 stderr。
aidc login 在 JSON 模式输出逐行事件：{"event":"authorize","url":…,"userCode":…} → {"event":"logged_in",…}。

退出码	含义
0	成功
1	一般错误
2	参数错误 / 校验不通过
3	未登录或凭证无效
4	无权限
5	不存在
6	冲突（例如发布未测过的版本、内容变了没升版本号）
7	限流或额度用完
8	上游或网络故障

外部程序

aidc video 与长音频转写通过 ffmpeg 抽帧、转码、分段（AIDC_FFMPEG / AIDC_FFPROBE 可指定路径）。没装时命令报错并给出安装方式，不会退化成不完整的实现。

本页由 developer/docs/cli.md 生成 · Markdown 原文 · llms.txt