# AIDC Developer

> AIDC Developer 是 AIDC 的智能体开发平台：九个 SDK（视觉、语音、视频、模型、建模、语义、自进化、界面、发布）+ aidc CLI + OpenAI 兼容的模型 API。在 Developer 里开发与测试，发布到 Nexus（智能体时代的应用商店）。账单记在调用方所属公司。

- 上手说明（交给智能体，它替人装好 CLI、登录、做出第一个应用）：https://www.ai-dc.ai/developer/agent-ready.md
- SDK（浏览器 ESM）：https://www.ai-dc.ai/developer/sdk/v1/aidc.js
- 界面 SDK：样式表 https://www.ai-dc.ai/developer/sdk/v1/ui.css · 组件登记表 https://www.ai-dc.ai/developer/sdk/v1/ui.json · 样例 https://www.ai-dc.ai/developer/ui
- CLI：curl -fsSL https://www.ai-dc.ai/developer/cli/install.sh | sh
- 模型 API（OpenAI 兼容 base URL）：https://www.ai-dc.ai/api/v1/models
- OpenAPI：https://www.ai-dc.ai/developer/openapi.json
- 应用清单 JSON Schema：https://www.ai-dc.ai/developer/schemas/aidc.app.schema.json
- Agent Skill：https://www.ai-dc.ai/developer/skills/aidc-sdk/SKILL.md

## 开始

- [AIDC Developer 总览](https://www.ai-dc.ai/developer/docs/overview.md): AIDC Developer 是 AIDC 的智能体开发平台：用九个 SDK 把统一的界面、摄像头、麦克风、模型、3D 世界和企业数据接进你的应用——企业数据的一切（数据从哪来、对象与 Action、谁能看、变了自动做什么、日志与用量）都在 Semantic 这个数据平台里；在 Developer 
- [应用（Apps）](https://www.ai-dc.ai/developer/docs/apps.md): 新应用默认使用标准 plugin.json；旧 aidc.app.json 继续支持。Apps 与 OpenAI Plugin 的包、UI、默认 AIDC 登录和可选 OAuth 规范见 [Plugin 兼容](plugins.md)。
- [快速开始](https://www.ai-dc.ai/developer/docs/quickstart.md): 做一个智能体能用的 AIDC 应用，大约十分钟。一个应用是一组 Skills 加一组 APIs，界面可选（见 [应用（Apps）](apps.md)）。这篇从最小的形态开始：只有一条 Skill 的应用——教智能体用现成的 AIDC 视觉能力检查现场照片。做完以后，你会在 Developer 里看到
- [闭环：从 ERP 到持续变好的应用](https://www.ai-dc.ai/developer/docs/loop.md): 这一页以一个车间的生产进度看板为例（示例公司 Demo Company），把 Semantic（数据平台）的各部分和自进化串成一条线：数据流（ERP 只读推上来）→ Ontology（对象、Action）→ 数据源（流接到哪个类型，写在定义里）→ 应用（读对象集、实时订阅、用 Action 改）→ 
- [开发规范](https://www.ai-dc.ai/developer/docs/standards.md): 新应用默认使用标准 plugin.json；旧 aidc.app.json 继续支持。Apps 与 OpenAI Plugin 的包、UI、默认 AIDC 登录和可选 OAuth 规范见 [Plugin 兼容](plugins.md)。

## 界面

- [界面 SDK](https://www.ai-dc.ai/developer/docs/ui.md): 所有 Nexus 应用共用的一套界面：按钮、表单、卡片、表格、标签页、对话框、Toast，以及以品牌斜杆 // 为母题的加载动效（含刻度轮）。外观与 shadcn/ui 一致，取值与 AIDC Console 同源。纯 HTML 应用引一个样式表就能用，需要脚本的部分在 aidc.js 的 ui 里

## 感知与智能

- [视觉 SDK](https://www.ai-dc.ai/developer/docs/vision.md): 调摄像头、拍照、从文件选图，压缩后交给视觉模型做结构化判断（质检）或物体检测（类别 + 位置框），再把结果画回图上；看公司 NVR / 网络摄像机的实时画面与高清截图（见下文「网络摄像机 / NVR」）。只用浏览器原生能力（getUserMedia、canvas、createImageBitmap、
- [语音 SDK](https://www.ai-dc.ai/developer/docs/voice.md): 实时转写（边说边出字）、录音、音量分析、音频文件转写，以及基于转写的翻译与会议纪要。
- [视频 SDK](https://www.ai-dc.ai/developer/docs/video.md): 建立在视觉与语音 SDK 之上：摄像头与麦克风一起开、带声录像、定时抽帧交给视觉模型、把录好的视频拆成关键帧与音轨分别分析。浏览器端用 MediaRecorder / <video> / canvas；批量与长视频交给 aidc video（基于 ffmpeg）。
- [模型 SDK](https://www.ai-dc.ai/developer/docs/model.md): 开箱即用的模型：LLM、视觉、语音转写、实时转写，以及调度模型 Jev。不用自己去各家申请 key、不用自己记账——每次调用都记在调用方所属公司的账上（开发者 Key 记它的公司；Nexus 应用的访客用量记应用所属公司）。
- [建模 SDK](https://www.ai-dc.ai/developer/docs/modeling.md): 用世界模型把一段文字、一张照片、一张 360° 全景、同一空间的几张照片或一段视频，变成可以走进去的 3D 世界（高斯溅射 + 碰撞网格 + 全景），再把世界里的位置绑到公司的业务对象上——设备、工位、传感器——这是数字孪生的地基。上游是 World Labs 的 Marble 世界模型（World

## Semantic（数据平台）

- [语义 SDK（Semantic）](https://www.ai-dc.ai/developer/docs/semantic.md): Semantic 是 AIDC 的数据平台（照 Palantir Foundry：Data Connection + Ontology + Automate + Security）。企业数据的一切都在这里：数据从哪来、存成什么对象、谁能看、谁改了什么、变了之后自动做什么、花了多少钱。ERP / ME
- [Semantic · 数据流与数据源（原连接 SDK）](https://www.ai-dc.ai/developer/docs/connect.md): 1.20.0 起连接 SDK 并进 [Semantic](semantic.md)：数据流是 semantic.stream() / semantic.streams（aidc semantic streams …），数据流接到哪个 Object Type 写在类型定义的 datasources 里
- [Semantic · 旧的数据层（原数据 SDK）](https://www.ai-dc.ai/developer/docs/data.md): 1.20.0 起数据 SDK 并进 [Semantic](semantic.md)：读对象用 semantic.ontology().objects(…)（对象集、聚合、链接），实时用 objectSet.subscribe(…)，改数据只走 Action；数据从数据源进来（Object Type 
- [Semantic · 访问与账号（原权限 SDK）](https://www.ai-dc.ai/developer/docs/auth.md): 1.20.0 起权限 SDK 并进 [Semantic](semantic.md)：资源的访问是 semantic.filesystem（Private / Group / Public / Open to Internet，aidc semantic filesystem …），账号与成员是 se
- [Semantic · 自动化（原工作流 SDK）](https://www.ai-dc.ai/developer/docs/workflow.md): 1.20.0 起工作流 SDK 并进 [Semantic](semantic.md)，叫 Automate（照 Palantir）：trigger.change = 对象新建 / 修改的条件，trigger.schedule = 时间条件，use / model / notify 步骤 = Acti
- [Semantic · 应用日志（原日志 SDK）](https://www.ai-dc.ai/developer/docs/log.md): 1.20.0 起日志 SDK 并进 [Semantic](semantic.md)：改数据的留痕是 Ontology 的 Action Log 与 editsHistory；应用的使用 / 反馈 / 错误是 semantic.observability（aidc semantic observabi
- [Semantic · 用量与账单（原账单 SDK）](https://www.ai-dc.ai/developer/docs/billing.md): 1.20.0 起账单 SDK 并进 [Semantic](semantic.md)：semantic.usage（aidc semantic usage …），用量明细也可以作为平台对象类型 aidcModelUsage（按天 × 应用 / Key × 模型）进你的 Ontology，用对象集聚合、

## 迭代与发布

- [自进化 SDK](https://www.ai-dc.ai/developer/docs/evolve.md): 让应用在使用中持续变好：用户在应用里说一句就改，开发者 / 智能体按证据提改进提案、发新版本——两条路，同一个 SDK。
- [发布 SDK](https://www.ai-dc.ai/developer/docs/publish.md): 新应用默认使用标准 plugin.json；旧 aidc.app.json 继续支持。Apps 与 OpenAI Plugin 的包、UI、默认 AIDC 登录和可选 OAuth 规范见 [Plugin 兼容](plugins.md)。
- [应用卡片（App Card）](https://www.ai-dc.ai/developer/docs/app-card.md): 每个 Nexus 应用都有一张应用卡片。它由平台按「清单 + 部署时的静态分析 + 通道指针 + 数据流状态 + 使用日志」自动生成——开发者不用手写，也就不会和代码对不上。一张卡片回答七个问题：

## 工具与接入

- [aidc CLI](https://www.ai-dc.ai/developer/docs/cli.md): AIDC Developer 的命令行，也是智能体使用 AIDC 的首选入口：每条命令都能输出 JSON、从不交互（唯一例外是 aidc login 在你自己的终端里问账号和密码）、退出码稳定。所有业务逻辑都在 API 里，CLI 只做参数、文件与输出。
- [智能体接入](https://www.ai-dc.ai/developer/docs/agents.md): AIDC Developer 为智能体（Claude Code、Codex、AIDH / Hermes、LangChain 或任何自研框架）准备的接入方式——全部是行业已有的标准，不需要安装 AIDC 专用插件。
- [Apps 与 OpenAI Compatible Plugin](https://www.ai-dc.ai/developer/docs/plugins.md): AIDC 的 App 与 OpenAI 的 Plugin 使用同一份 Agent Plugins 1.0 包。 包的身份、版本、Skills 与 MCP 声明可以复用；AIDC 运行权限只放在自己的扩展里。
- [API 参考](https://www.ai-dc.ai/developer/docs/api.md): Developer 与模型 API 的完整清单。机器可读版本：[/developer/openapi.json](https://www.ai-dc.ai/developer/openapi.json)（由服务端的契约注册表生成，与代码同步）。

## 样板应用

- [样板应用](https://www.ai-dc.ai/developer/docs/samples.md): 公开的样板，用来演示 SDK 怎么组合成一个能用的应用。它们都是 AIDC 官方公开应用（namespace: public）：登录的成员都可以打开（一律登录：至少是一家公司的 member），不存储任何数据；模型用量记在 AIDC 名下，并受每日额度保护。源码在 aidc-cloud 仓库的 de

## 版本

- [更新记录](https://www.ai-dc.ai/developer/docs/changelog.md): 数据安全：Markings + 对象 / 属性安全策略（照 Palantir）：财务、薪资、采购价、技术配方这类数据也要进 Semantic，但要管住谁能看。照 Palantir Security 补上这一块：Markings 管「这类数据只有谁能碰」，对象安全策略管行，属性安全策略管列，所有读写路