快速开始

从零到一个发布在 Nexus 上的应用，大约十分钟。需要：Node 18 以上、一个有 developer 权限的 AIDC 账号（公司的 developer License，或 AIDC 平台账号）。

1. 安装 CLI

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

安装脚本只做一件事：把单文件 CLI（/developer/cli/aidc.mjs）放到 ~/.aidc/bin/aidc，并提示把它加进 PATH。也可以不安装，直接 node aidc.mjs …。

2. 登录

aidc login

终端会打印一个链接和八位授权码。在浏览器里打开链接（已登录 AIDC），核对授权码、选择这把 Key 代表哪家公司、点「批准」。终端几秒内完成登录，开发者 Key 存在 ~/.aidc/config.json（权限 0600）。

• 智能体 / CI：aidc login --no-wait --json 先拿到链接交给人批准，之后 aidc login --continue 继续；或者直接设置 AIDC_API_KEY=aidc-dk-…。
• 查看身份：aidc whoami；吊销：aidc logout --revoke。

3. 创建应用

aidc app init shelf-check --template camera --title "货架检查"

生成四个文件：aidc.app.json（应用清单）、index.html、app.js、style.css。清单说明应用是谁、要用哪些 SDK / 模型 / 数据集、要不要摄像头和麦克风、每天的额度——平台按它放行。

4. 本地预览

aidc app dev shelf-check
# 本地预览：http://localhost:5173

本地服务器把 /api/* 转发到 AIDC，并替页面带上你的开发者 Key——Key 只在本机进程里，不进浏览器。预览期间的模型用量记在你的公司名下。

5. 发布到 Developer（test 通道）

aidc app deploy shelf-check
# 新版本 v1 已进入 test 通道
#   Developer 预览：https://www.ai-dc.ai/developer/cell-xxx/apps/shelf-check

同样的文件重复部署不会产生新版本（内容寻址），重试是安全的。先看会发生什么：加 --dry-run。

6. 发布到 Nexus（production 通道）

aidc app publish shelf-check
#   Nexus：https://www.ai-dc.ai/nexus/cell-xxx/apps/shelf-check

发布的就是刚才测过的那个版本，不会重新打包。发现问题：aidc app rollback shelf-check --version 1。

下一步

• 看三个样板应用的源码：瑕疵检测、会议纪要、ERP 数据分析。
• 每个 SDK 的完整接口：视觉 · 语音 · 视频 · 模型 · 数据 · 发布 · 连接。

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