# aidc CLI AIDC Developer 的命令行，也是智能体使用 AIDC 的首选入口：每条命令都能输出 JSON、从不交互（唯一例外是 `aidc login` 在你自己的终端里问账号和密码）、退出码稳定。所有业务逻辑都在 API 里，CLI 只做参数、文件与输出。 ## 安装 ```bash curl -fsSL https://www.ai-dc.ai/developer/cli/install.sh | sh ``` 需要 Node 18 以上。安装脚本把单文件 CLI 下载到 `~/.aidc/bin/aidc`，并在 PATH 里第一个 `$HOME` 下的可写目录（`~/.local/bin`、`~/bin`…）放一个链接；输出的最后一行 `下一步：… login` 就是这台机器上能用的命令（没有合适的目录时是完整路径 `~/.aidc/bin/aidc`）。也可以直接 `node aidc.mjs …`（下载地址 `https://www.ai-dc.ai/developer/cli/aidc.mjs`）。`aidc video` 与长音频转写需要 ffmpeg。 ## 登录 **一律登录（2026-09-29）**：除 `aidc login`、`aidc logout`、`aidc help`、`aidc --version` 外，每条命令都要先登录（没登录退出码 3）——包括只在本机跑的 `app init / check / export / dev`、`ui`、`data profile`、`modeling estimate`、`evolve slots`。**member 起步**：公司成员也能登录，能调用本公司已发布的应用（`aidc app call`）、在本机开发、`aidc whoami` 看自己；部署、发布、数据与管理命令要这家公司的 developer。自带凭证的 `aidc stream pipe`（`AIDC_PUBLISH_KEY`）与 `aidc connect send`（`AIDC_AGENT_KEY`）照旧。 ```text $ aidc login 登录 AIDC Developer（https://www.ai-dc.ai）还没有账号？在 https://www.ai-dc.ai/login 点「注册」创建（建议用公司邮箱）；开发公司应用还需要公司发给你的 developer 授权码。账号（用户名或邮箱）：zhang.san@example.com 密码：已登录：张三（zhang.san）· 示例公司（cell-example） ``` | 命令 | 说明 | | --- | --- | | `aidc login` | 在终端里输入 AIDC 账号（用户名或邮箱）和密码（不回显），拿到一把代表你所在公司的开发者 Key | | `aidc login --user <账号> [-n ]` | 预先给账号；账号能代表几家公司（AIDC 平台员工）时用 `-n` 指定，不给就在终端里选 | | `aidc login --with-key < key.txt` | 从 stdin 读开发者 Key（CI） | | `aidc login --browser [--no-wait]` | 身边没有终端的智能体：打印链接与授权码，人在浏览器里批准；`--no-wait --json` 只打印链接，随后 `aidc login --continue` 完成 | | `aidc login --continue --no-wait --json` | 浏览器批准只查一次：没批准返回 `{"event":"authorization_pending"}`、退出码 3，批准了完成登录（`--continue` 不带 `--no-wait` 会一直等到批准或过期） | | `aidc whoami` · `aidc keys` | 身份、Key 列表 | | `aidc logout [--revoke]` | 删除本机 Key；`--revoke` 同时在服务端吊销 | - **只在交互终端里问**：`aidc login` 是唯一会停下来问人的命令。stdin 不是终端（智能体、CI、管道）时立即以退出码 2 报错、说明该怎么做，不会挂着等输入。密码只在提示处输入——不收命令行参数、环境变量或 stdin。 - **还没有账号**：在 `https://www.ai-dc.ai/login` 点「注册」。使用 AIDC Developer 至少要是一家公司的 member：公司发给你的授权码（License）在 `https://www.ai-dc.ai/account` 输入；没有时登录会报「这个账号还不属于任何公司」（退出码 4）。部署、发布还要 developer 授权码。 - **密码**：与网页登录是同一个密码、同一套规则——连续输错 5 次锁 15 分钟（终端和网页算在一起），终端里最多连输三次。忘了就在登录页点「忘记密码？」重设；临时密码、邮箱没验证时先去网页登录处理。只用邮箱验证码登录、没设过密码的账号，也在「忘记密码？」里设一个。 - **Key 代表谁**：签给输入密码的这个账号、代表一家公司，按这个人在这家公司的角色（developer 或 member，`aidc whoami` / `aidc keys` 看得到），用量记在这家公司。重复登录会签新的 Key，旧的仍然有效——换机器或不用了 `aidc logout --revoke`。凭证读取顺序：环境变量 `AIDC_API_KEY` → `~/.aidc/config.json`（0600）。API 根：`--api` → `AIDC_API_BASE` → 配置文件 → `https://www.ai-dc.ai`。 ## 命令一览 ```text aidc ui components [组件] # 界面 SDK：组件、类与示例标记（本机，不联网） aidc ui tokens [--mode light|dark] [--theme aidc|signal] [--css] aidc ui add [目录] [--dry-run] # 给已有应用接上界面 SDK（入口页加 ui.css、清单 sdk 加 ui；幂等） aidc models aidc model chat -m <模型> "<提示>" [--system …] [--image 图…] [--json-object] [--stream] aidc model decide --state "<文本>" --question id=说明 --choice id:选项=判据 … aidc modeling models # 建模 SDK：Marble 模型、价目、当前策略、上游是否已配置 aidc modeling estimate [-m marble-1.1] [--input text|image|pano|multi-image|video] # 本机估价，不联网 aidc modeling budget # 本月额度：公司上限 / 已结算 / 进行中预留 / 剩余 aidc modeling generate --text "…" | --image 图 [--image 图 … --reconstruct] [--azimuth 0,90…] | --pano 全景图 | --video 视频 [-m marble-1.0-draft] [--name …] [--seed N] [--tag …] [--max-credits N] [--no-recaption] [--regenerate] [--idempotency-key K] [--dry-run] [--no-wait] aidc modeling list [--status running] [--limit 30] · get · wait aidc modeling upload <图片或视频> # 换签名地址后字节直传 World Labs，打印 mediaId aidc modeling anchors --file anchors.json [--if-rev N] [--dry-run] aidc modeling export --ply [--resolution full_res] | --mesh [--variant textured|vertex_colored] [--dry-run] aidc modeling download [--out 目录] [--quality 100k|500k|full_res] [--with-pano] aidc modeling import --world-id | --snapshot world.json [--name …] [-m 模型] [--input-kind text --text …] # AIDC 平台账号 aidc modeling delete [--purge] [--dry-run] aidc vision inspect <图片…> --task "<检查什么>" [--criteria …] [-m gpt-6-luna] aidc vision detect <图片…> [--labels 人,叉车] [--prompt …] [--max 50] [-m gpt-6-luna] # 物体检测 aidc vision camera list | show <名字> # 公司的网络摄像机 / NVR（经平台转发的 RTSP） AIDC_CAMERA_PASSWORD=… aidc vision camera add <名字> --host <外网地址> [--port 554] [--vendor dahua|hikvision|generic] \ [--path 模板] [--username …] [--channels 1:大门,2:仓库] [--default-stream sub] [--max-viewers 4] [--allow-main-live] [--dry-run] # 口令只从 AIDC_CAMERA_PASSWORD 或 --password-stdin 读 aidc vision camera probe <名字> [--channels 1-16] [--main] # 连上、认证、读编码（不拉流）；口令被拒立即停 aidc vision camera snapshot <名字> [--channel 1] [--sub] [-o a.jpg] # 截一帧（缺省主码流高清），本机 ffmpeg 转图片 aidc vision camera remove <名字> --yes [--dry-run] 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] # ── Semantic（数据平台）：对象、Action、订阅、数据从哪来、SQL、访问、自动化、日志与用量 ── # Ontology（照 Palantir REST API v2 / OSDK；读命令都收 --branch <分支>，读分支上的定义） aidc semantic ontology # 全貌：Object Type（主键、链接）、Action Type、Interface aidc semantic object-types [apiName] · action-types [apiName] · interfaces [apiName] · value-types · shared-properties aidc semantic objects <类型> [--where '{"stage":"付费","seats":{"$gt":30}}'] [--order-by seats:desc] [--select a,b] [--page-size n] [--page-token t] aidc semantic object <类型> <主键> [--select a,b] · links <类型> <主键> <链接> aidc semantic aggregate <类型> --select '{"$count":"unordered","costUsd:sum":"desc"}' [--group-by '{"month":"exact"}'] [--where …] [--interface] aidc semantic object-set <对象集.json|'{…}'> [--aggregate '{"$select":{…}}'] aidc semantic subscribe <类型> [--where '{…}'] [--properties a,b] # 实时订阅对象集（OSDK subscribe）：● 进来 / 变了 ✗ 离开，--json 输出 JSON 行 aidc semantic apply [--param 名=值 …] [--params '{…}'] [--validate-only] [--return-edits] # 改数据的唯一方式；校验不通过 → 退出码 2 aidc semantic apply-batch <参数数组.json> [--return-edits] # 最多 20 个，一个事务 aidc semantic edits-history <类型> [--pk 主键] [--previous] aidc semantic security test <类型> [--user <账号 id>] [--pk 主键,…] [--object '{…}' …] [--policy 策略.json] # 试安全策略（开发者；不回属性值） # 建本体：智能体在分支上改、开提案，人在网页上审核合并（设 AIDC_AGENT_ID=<智能体> 时作者记为智能体） aidc semantic define <文件.json|目录> [--dry-run] # 定义（有则改）；数据源写在 Object Type 的 datasources 里 aidc semantic types · archive · publish [--notes …] · releases · describe [--markdown] aidc semantic branch list · create <分支> [--description …] · show <分支> aidc semantic branch modify <分支> <文件|目录> [--archive a,b] [--expected-version N] [--dry-run] aidc semantic branch validate <分支> · conflicts <分支> · rebase <分支> [--keep a,b] [--take-main c] · discard <分支> [资源…] · lock <分支> [--unlock] aidc semantic branch propose <分支> --title … --trigger "为什么要改" [--self-test "自测结果"] [--description …] # 打印审核网页地址 aidc semantic proposals [--status OPEN|MERGED|CLOSED] · proposal · proposal close [--note …] # 数据从哪来（Data Connection：发布端 → 数据流 → Object Type 定义里的 datasources）；流名可写 <流名> 或 <命名空间>/<流名> aidc semantic streams create <流名> --title … [--key 主键] --field 名:类型[:显示名] … [--retention N] [--spec 文件.json] aidc semantic streams list · status <流名> · get <流名> · tail <流名> [--after N] · delete <流名> [--dry-run] aidc semantic streams key <流名> --label "装在哪" · keys <流名> · revoke <流名> --prefix aidc-pk-… aidc semantic streams publish <流名> --event '{…}' | --file 事件.json aidc semantic streams pipe <命名空间>/<流名> -- <适配器命令…> # 边缘发布端（发布 Key 读 AIDC_PUBLISH_KEY） [--heartbeat 30] [--full-every 360] [--stale-after 15] # 秒 / 分 / 分 aidc semantic datasource list [类型] # 每个类型的数据源与同步进度 aidc semantic datasource sync # 平台数据源立即同步（= /semantic 的「立即同步」；AIDC 组织还同步 AWS 数据源） aidc semantic datasource set <类型> --stream <流名> --map 属性=列 … [--mode mirror|upsert] [--dry-run] # 写进类型定义（智能体作者要走分支） aidc semantic datasource remove <类型> --stream <流名> [--dry-run] · resync <类型> --stream <流名> # Semantic 数据库（照 Palantir Ontology SQL：一条 SELECT、≤ 10,000 行、20 秒；表名 = Object Type API name） aidc semantic sql "SELECT … FROM