十三个 SDK 一张图

第 3 课 · 共 6 课 约 7 分钟

界面、视觉、语音、视频、模型、连接、数据、语义、工作流、权限、日志、自提升、发布。

本课目标

读完这一课，你将能够

  • 说出十三个 SDK 的名字，以及它们分成的六层
  • 面对一个需求，挑出要用的几个 SDK
  • 在应用清单里如实登记用到的 SDK

六层，十三个

十三个 SDK 按层排开：最上面是所有应用共用的界面，往下是感知、智能、数据与语义、组合，最后是治理与迭代。每个 SDK 先是 API，再是命令行，最后才是界面；在浏览器里，一行 import 就能用。

  1. 01界面界面，所有应用共用
  2. 02感知视觉 · 语音 · 视频
  3. 03智能模型
  4. 04数据与语义连接 · 数据 · 语义
  5. 05组合工作流
  6. 06治理与迭代权限 · 日志 · 自提升 · 发布
import { ui, vision, model } from "/developer/sdk/v1/aidc.js";

一张图认全

UI

界面

所有应用共用的一套界面：按钮、表单、卡片、表格、对话框、Toast 与加载动效，引一个样式表就能用。

VISION

视觉

调摄像头、拍照、选图，交给视觉模型做结构化判断，在图上框出问题。

VOICE

语音

边说边出字的实时转写、录音、多语种翻译、会议纪要。

VIDEO

视频

建立在视觉与语音之上：带声录像、定时抽帧、视频拆帧与音轨分析。

MODEL

模型

LLM、视觉、转写与调度模型 Jev，与 OpenAI 兼容；账单记在调用方公司。

CONNECT

连接

接数据源：发布端只读地把 ERP、MES 的变化推上来，几秒到应用；外加企业数据集与智能体。

DATA

数据

企业数据层：对象的增删改查、导入、聚合、实时订阅，从数据流同步进来；外加分析小工具。

SEMANTIC

语义

企业 Ontology：对象、属性、链接与 Action（受控写、留痕），智能体读得懂的说明书；ERP 永远只读。

WORKFLOW

工作流

把各部门已发布的应用组合成流程：计算、AI 分析、写回；手动、预演或数据一变自动运行。

AUTH

权限

AIDC 账号登录、公司角色、应用访问范围；分享给全公司、指定的人或只读公开链接。

LOG

日志

版本与发布记录、反馈、操作记录、使用情况与错误，应用的每一次变化都有痕迹。

IMPROVE

自提升

把反馈、操作、数据、文件、技能与对话整合成改进提案，变成新的语义版本或应用版本。

PUBLISH

发布

应用清单与 SDK 登记、版本号、test 与 production 双通道、回滚；每个应用自动生成应用卡片。

按需求挑 SDK

挑 SDK 先问三件事：这件事要感知什么，读写哪些数据，结果交给谁。再把答案对到层上。四个公开样板正好是四种典型组合：

做什么用到的 SDK
瑕疵检测拍一张照片，判断有没有污渍、破洞、划痕，并在图上标出位置视觉 + 模型
会议纪要边说边出字，逐句翻译，结束后整理成纪要，发给指定的智能体语音 + 模型 + 连接
ERP 数据自动分析连接 ERP，按固定口径生成经营报告和管理层摘要连接 + 数据 + 模型
跨部门报价工作流把五个部门各自发布的应用串成一条报价流程工作流 + 语义 + 模型

界面 SDK 不在表里，因为每个应用都用它：按钮、表单、卡片、对话框一律从它来，应用里不另写一套。

用到的，就要登记

应用清单 aidc.app.json 里有一栏 sdk，写明这个应用用了哪些 SDK。部署时，平台会分析包里对 aidc.js 的 import 和对 ui.css 的引用：用了却没登记的，直接拒收；登记了却没用到的，会在应用卡片上标出来。

所以应用登记表永远是真的。aidc app registry 列出本公司每个应用登记的与实际用到的 SDK、读写哪些数据，以及每个 SDK 正被哪些应用使用。

要点

  • 十三个 SDK 分六层：界面、感知、智能、数据与语义、组合、治理与迭代。
  • 挑 SDK 先问三件事：感知什么、读写什么数据、结果交给谁。
  • 界面 SDK 每个应用都用，应用里不另写一套按钮和表单。
  • 用到的 SDK 都要登记：用了没登记，部署直接被拒。

练一练

给需求配 SDK

拿你部门的三件事练一练。

不看本页，把十三个 SDK 按六层写出来，再回来对照。

小测

选一个答案，马上看解析。

Q1做一个「拍照判断产品有没有瑕疵」的应用，除了界面，至少要用哪两个 SDK？

Q2应用里 import 了语音 SDK，清单的 sdk 里却没登记，部署时会怎样？

Q3哪个 SDK 负责把各部门已经发布的应用串成一条流程？

延伸阅读