# 快速开始

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

## 1. 安装 CLI

```bash
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. 登录

```bash
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. 创建应用

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

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

## 4. 本地预览

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

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

## 5. 发布到 Developer（test 通道）

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

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

## 6. 发布到 Nexus（production 通道）

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

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

## 下一步

- 看三个[样板应用](samples.md)的源码：瑕疵检测、会议纪要、ERP 数据分析。
- 每个 SDK 的完整接口：[视觉](vision.md) · [语音](voice.md) · [视频](video.md) · [模型](model.md) · [数据](data.md) · [发布](publish.md) · [连接](connect.md)。