@di-code/ai

为 di-code 提供与 Provider 无关的 TypeScript AI 契约、流式事件、模型目录，以及 OpenAI、Anthropic、DeepSeek、Kimi 和智谱 API 适配器。

可插拔运行时中的 provider namespace entry 只能向 registry 贡献本包的 Provider、Model 与流事件契约；厂商私有字段不能越过这个公开边界进入 Agent 或插件 API。

这是一个库，不提供命令行程序。想直接使用 AI 编码 CLI，请安装 @di-code/coding-agent。

安装

npm install @di-code/ai

要求 Node.js >= 22.19.0。

使用 Provider

创建 Provider，选择模型，然后消费类型安全的流式事件。这个包不会读写文件，也不会执行工具。

import { createOpenAIProvider } from "@di-code/ai";
const provider = createOpenAIProvider({ apiKey: process.env.OPENAI_API_KEY });
const model = provider.models[0];
if (!model) throw new Error("No OpenAI model is configured");
const stream = provider.stream(model, { messages: [], systemPrompt: "Answer concisely." });
for await (const event of stream) {
	if (event.type === "text_delta") process.stdout.write(event.delta);
	if (event.type === "image") console.log(`generated ${event.image.mimeType} image`);
}

Provider 可以通过 StreamEvent 的原子 image 事件返回助手生成图片。图片数据使用不带前缀的 Base64，并会出现在最终 AssistantMessage.content 中；适配器应在发出事件前完成下载和 MIME 校验。对非流式生图服务，使用下方的 Images API 适配器或由插件实现自定义 Provider。

Provider 接收的 Context.systemPrompt 是 Agent 在每次请求前组装的最终文本。动态 section 不改变既有 Provider schema；支持提示词缓存的适配器继续使用稳定的 StreamOptions.sessionId 作为缓存键，section 内容变化只影响对应请求内容。

generateOpenAIImages 和 createOpenAIImagesProvider 提供独立的 OpenAI Images 兼容适配器。它们调用 /images/generations，接受 b64_json 或图片 URL，并统一返回已校验的 ImageContent；baseUrl 和模型 ID 可覆盖，因此第三方兼容网关无需修改 AI 公共协议。

需要工具执行和完整对话历史时，请配合 @di-code/agent。

配置

可以显式传入凭据，也可以在 Node.js 进程启动前设置环境变量。不要提交 API key。

$env:OPENAI_API_KEY = "your-openai-api-key"
$env:OPENAI_BASE_URL = "https://api.openai.com/v1" # 可选

DeepSeek 使用 DEEPSEEK_API_KEY 和可选的 DEEPSEEK_BASE_URL，默认 endpoint 是 https://api.deepseek.com。Kimi 使用 KIMI_API_KEY 和可选的 KIMI_BASE_URL，默认 endpoint 是 https://api.kimi.com/coding/v1。OpenAI 使用 OPENAI_API_KEY 和可选的 OPENAI_BASE_URL。

Anthropic 使用 ANTHROPIC_API_KEY 和可选的 ANTHROPIC_BASE_URL，默认 endpoint 是 https://api.anthropic.com。createAnthropicProvider 使用 Anthropic Messages API，支持文本、Base64 图片、工具调用、工具结果、usage、取消和临时 HTTP 错误重试；扩展思考不会在请求中主动启用。

确定性离线测试请使用 createFauxProvider({ responses: [...] })，它不会访问网络。

公共 API

主要导出 Provider、Model、Message、StreamEvent、ToolDefinition、TypeBox 工具、MODELS，以及各内建 Provider 创建函数，包括 createKimiProvider。

源码、示例和问题反馈：https://github.com/qddidi/di-code