@ control-plane/ runtime- sdk (控制飞机)
SDK 用于构建连接控制平面的运行时间:
适配器接口、声明能力和通过兼容性——无
触摸控制板内部.
仅取决于 @adea-ai/contracts
还有佐德 说对了 @adea-ai/contracts
对于服务边界.
里面的东西
- 适配器 ——运行时间适配器合同和注册类型.
- 能力与资格 ——宣布运行时间支持什么,让
相应的控制板路线.
- 发现和库存 - 运行时间发现记录、健康和
资格评定.
- 符合性和兼容性 - 装配型套房和
运行时间执行的兼容性检查 .
- 会话路径 外部会议类型和路线决定.
- 运输 - 合用同一地点的运输港,内设确定性
双倍( e)
mock.ts, (中文(简体) ), fixtures.ts用于测试适配器.
运行时间使用核算区分了总部供资的API使用(hq_managed, (中文(简体) ),
由用户供资的API使用量(byo_api外部订阅
(单位:千美元)external_subscription) (中文(简体) ). 报告已支付的API费用时,必须与准确性相符
会计领域的美元微观单位。 订阅会计报告
微单位. 这些字段描述来源;消费者必须核实来源
起诉前的权力.
安装
bun add @adea-ai/runtime-sdk
使用量
import {
RuntimeAdapterMetadataSchema,
RuntimeStartRequestSchema,
RuntimeExecutionResultSchema,
} from '@adea-ai/runtime-sdk'
const metadata = RuntimeAdapterMetadataSchema.parse(raw)
在适配器执行前运行兼容性检查
注册(仓库开发):
bun scripts/compatibility.ts --check
许可证
阿帕奇 - 2.0
关于 @adea-ai/runtime-sdk 的常见问题
@adea-ai/runtime-sdk 是什么？
用于建设控制平面运行时间的SDK:适配器、能力、相容性、发现、资格、健康、会话、运输和路由.
如何安装 @adea-ai/runtime-sdk？
在项目目录运行 npm install @adea-ai/runtime-sdk，或使用 pnpm add / yarn add / bun add。
@adea-ai/runtime-sdk 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@adea-ai/runtime-sdk 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@adea-ai/runtime-sdk 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js 24.21.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@adea-ai/runtime-sdk 可以商用吗？
@adea-ai/runtime-sdk 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。
@adea-ai/runtime-sdk 的下载量有多少？
根据 npm 官方下载统计，@adea-ai/runtime-sdk 在 2026/10/05 – 2026/11/03 这 30 天内被下载 22,545 次，日均约 752 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@adea-ai/runtime-sdk 还在维护吗？
最新版本 2.0.0 发布于 2026/11/03（3 天前）；至今共发布 34 个版本，其中过去 12 个月发布了 34 个；首次发布于 2026/09/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。