Skip to content

框架适配器 ​

适配器负责将第三方生态框架的调用桥接至 Nimi AI 客户端。Runtime 继续负责模型路由与执行,App 则专注于工具回调、界面交互与自身业务状态。

区分发布包与源码开发包 ​

制品版本与配对关系在本指南中的定位
npm 已发布的 Vercel 适配器0.1.0;AI SDK 6、provider 3、SDK ^0.13.0早期公开发布制品,不可与当前源码示例混用
当前工作区 Vercel 适配器源码0.5.0;AI SDK ^7.0.0、provider ^4.0.0、SDK ^0.21.0下方示例采用此组合,通过本地开发归档或开发交付包提供
OpenAI-compatible 适配器仅存在于源码,未公开发布至 npm仅用于内部测试及明确支持的兼容子集

已发布的 0.1.0 版本声明请参阅 npm 制品元数据。源码清单中的版本号并不代表该版本已正式发布。当前 App 的开发环境准备请参考开发环境准备。

在当前源码 App 中使用 Vercel AI SDK 7 ​

请确保具备 SDK 0.21.0、配套的 Kit/Runtime 构建产物,以及适配器 0.5.0 源码的本地开发归档。直接复用 App 宿主绑定的客户端实例:

ts
import { stepCountIs, streamText } from 'ai';
import { createNimiLocalAppVercelLanguageModel } from '@nimiplatform/sdk-adapter-vercel-ai';
import { getNimiLocalAppClient } from './shell/auth/local-app-client.js';

const model = createNimiLocalAppVercelLanguageModel({
  ai: getNimiLocalAppClient().ai,
});

const result = streamText({
  model,
  prompt: '请用三句话总结这份笔记。',
  stopWhen: stepCountIs(5),
});

当前源码适配器返回 LanguageModelV4 实例,无法与 AI SDK 6 配对。实际执行还依赖 App 既有的 AIConfig、能力声明以及当前的有效会话;适配器不自带凭据、不保证模型就绪状态,也无法绕过平台的权限校验。

其他入口 ​

请在各自约定的契约范围内使用公开的 AI runner、Runtime 与 AI 工具子路径。已退役的旧子路径 @nimiplatform/sdk/ai-provider 不再转发至任何适配器。

OpenAI-compatible 适配器仅覆盖源码中明确支持的 API 子集;它未作为独立包发布,既不能用于直连私有 Runtime 接口,也无法绕过平台的能力校验。

Source Basis ​

Nimi 文档:可安装、开源、本地优先的个人 AI 产品。