langchain-siliconflow

这不是官方的 LangChain.js 适配包，而是一个社区维护的项目。

LangChain.js 的 SiliconFlow 适配包（Chat + Embeddings）。接口兼容 @langchain/* 的常规使用方式。

安装

npm i langchain-siliconflow @langchain/core

要求 Node.js >= 18（内置 fetch）。

使用示例

Chat 模型

import { ChatSiliconFlow } from "langchain-siliconflow";
import { HumanMessage } from "@langchain/core/messages";

const chat = new ChatSiliconFlow({
  apiKey: process.env.SILICONFLOW_API_KEY!,
  model: "Qwen/QwQ-32B",
  temperature: 0.7,
});

const res = await chat.invoke([new HumanMessage("用一句话解释LangChain是什么？")]);
console.log(res.content);

Embeddings 模型

import { SiliconFlowEmbeddings } from "langchain-siliconflow";

const embeddings = new SiliconFlowEmbeddings({
  apiKey: process.env.SILICONFLOW_API_KEY!,
  model: "BAAI/bge-large-zh-v1.5",
});

const vector = await embeddings.embedQuery("你好，世界");
console.log(vector.length);

获取模型列表

依赖 ChatSiliconFlow 内置的 models 接口（或直接使用导出的 SiliconFlowModelsAPI）。

import { ChatSiliconFlow } from "langchain-siliconflow";

const chat = new ChatSiliconFlow({
  apiKey: process.env.SILICONFLOW_API_KEY!,
  model: "Qwen/QwQ-32B",
});

// 列出全部模型
const all = await chat.models.list();
console.log(all.data.map((m) => m.id));

// 仅过滤聊天模型
const chats = await chat.models.list({ type: "chat" });
console.log(chats.data.length);

静态方式获取模型列表（无需初始化 Chat）

import { ChatSiliconFlow } from "langchain-siliconflow";

// 获取全部模型
const all = await ChatSiliconFlow.listModels({
  apiKey: process.env.SILICONFLOW_API_KEY!,
});
console.log(all.data.map((m) => m.id));

// 按类型过滤（例如仅聊天模型）
const chats = await ChatSiliconFlow.listModels({
  apiKey: process.env.SILICONFLOW_API_KEY!,
  type: "chat",
});
console.log(chats.data.length);

也可以直接使用 SiliconFlowModelsAPI：

import { SiliconFlowClient, SiliconFlowModelsAPI } from "langchain-siliconflow";

const client = new SiliconFlowClient({ apiKey: process.env.SILICONFLOW_API_KEY! });
const modelsApi = new SiliconFlowModelsAPI(client);
const { data } = await modelsApi.list({ type: "embedding" });
console.log(data.map((m) => m.id));

环境变量

• SILICONFLOW_API_KEY: 在 SiliconCloud 控制台创建的 API Key。
• 如需切换域名，可通过构造参数 baseUrl 自定义（默认 https://api.siliconflow.cn/v1）。

发布到 npm

发布前检查：

• 确认 package.json 的 name、version、description、license、files、types、main 等正确；已配置 publishConfig.access: "public"。
• 确认只发布 dist 与 README.md（files 已限制）。
• 运行构建：npm run build。

发布步骤：

• 登录 npm：npm login（如果开启 2FA，请使用一次性验证码）。
• 如需升版本：npm version patch（或 minor/major）。
• 发布：npm publish --access public。

发布后验证：

• npm info langchain-siliconflow 查看版本与元数据。
• 在示例工程中安装验证：npm i langchain-siliconflow @langchain/core，运行示例。

参考

• SiliconFlow Chat Completions: https://docs.siliconflow.com/en/api-reference/chat-completions/chat-completions
• SiliconFlow Embeddings: https://docs.siliconflow.cn/en/api-reference/embeddings/create-embeddings
• LangChain JS DeepSeek: https://www.npmjs.com/package/@langchain/deepseek