# @b4run/langgraph 中文文档

规范地址：https://npmcn.com/package/%40b4run/langgraph/

版本：0\.15\.8
npm 元数据更新时间：2026-10-30T22:22:25.933Z
中文译文更新时间：2026-11-07T16:54:25.208Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40b4run/langgraph
原文对照：https://npmcn.com/package/%40b4run/langgraph/?lang=original
项目主页：https://github.com/cacheplane/b4run/tree/main/packages/langgraph#readme
源码仓库：https://github.com/cacheplane/b4run

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：305 kB，28 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：1 个
- peer 依赖：langchain ^1\.5\.12，@langchain/core ^1\.2\.12，@langchain/langgraph ^1\.4\.17
- 首次发布：2026-09-09T04:18:58.865Z
- 最新版本发布：2026-10-30T22:22:25.605Z
- 近 30 天下载量：4325（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

LangGraph.js的适配器和B4.run代理商的路由合同,工作流程,以及图表.

## 安装

```sh
npm install @b4run/langgraph
```

也可以使用：`pnpm add @b4run/langgraph`、`yarn add @b4run/langgraph`、`bun add @b4run/langgraph`

## README

# @ b4run/ 朗格图

LangGraph.js 路由适配器和用于B4.run或平面LangGraph应用的节点工具活性辅助器.

**当 :** 您正在将原始的图表或工作流程与 B4. 运行的路由合同合并, 或者将工具活动添加到普通节点 LangChain/ LangGraph 代理中 `/ui`。不需要原始路由模块的代理和工具作者应该从 [`@b4run/sdk`](https://www.npmjs.com/package/@b4run/sdk)。 。 。 .

## 安装

```bash
pnpm add @b4run/langgraph
```

## 示例

```ts
import { defineEntry, graphAdapter } from "@b4run/langgraph"

const route = defineEntry({
  graph: async (input: { name: string }) => ({ greeting: `Hello, ${input.name}` }),
})

const result = await graphAdapter.execute(route.graph, { name: "B4.run" }, {
  signal: new AbortController().signal,
})
```

## 运行时间和稳定性

-   `@b4run/langgraph` 用于适配器和路由合同的边缘安全、支持的集成面.
-   `@b4run/langgraph/define-entry` 是一个边缘安全,支持的进入验证子路径.
-   `@b4run/langgraph/route-module` 是一个边缘安全、支持的正常化和路线类型的子路径.

这三个路由表面没有包含第三方运行时间依赖或节点环球. 该边界并不对应用程序提供的图表、工作流程或工具进行分类.

## 普通 LangGraph 工具活动

`@b4run/langgraph/ui` 是一个唯一的节点,支持的生产者表面。 它使用可选 同行 `@langchain/core` 1.2.12, (中文(简体) ), `langchain` 1.5.12和 `@langchain/langgraph` 1.4.17; 2; 只为这个子路径安装 。 它不需要B4代理,CLI或文件系统路由. 根和路由子路径从不导入这些同位素.

```bash
pnpm add @b4run/langgraph @langchain/core@1.2.12 langchain@1.5.12 @langchain/langgraph@1.4.17
```

```ts
import { emitToolStep, toolStepMiddleware } from "@b4run/langgraph/ui"
```

见 [纯正代理](https://npmcn.com/package/%40b4run/langgraph/examples/plain-agent.ts), (中文(简体) ), [手动节点](https://npmcn.com/package/%40b4run/langgraph/examples/manual-tool.ts) 财务报告和审定财务报表 [Python 生产商/桥梁](https://npmcn.com/package/%40b4run/langgraph/examples/python_tool_steps.py) 源食谱和 [API 指南](https://b4.run/docs/api/langgraph#plain-langgraph-tool-activity)。 。 。 . `ToolStepDisplay` 财务报告和审定财务报表 `ToolStepMiddlewareOptions` 是两种公共选项类型. CUSTOM 事件只进行直播; 恢复检查点需要一座投影桥 `additional_kwargs.b4_step` 输入工具消息 `metadata["b4.step"]` 可读 失败文本输入 `error`。永久服务器检查器和客户端记录 持续解决恢复的不同部分.

## 相关

-   [`@b4run/sdk`](https://www.npmjs.com/package/@b4run/sdk) 高级路线、代理和工具合同.
-   [`@b4run/langchain`](https://www.npmjs.com/package/@b4run/langchain) ——LangChain代理和连锁物化.
-   [LangGraph API 参考文献](https://b4.run/docs/api/langgraph) ——路由模块输出和适配器行为.
-   [路线指南](https://b4.run/docs/routes) —— B4. run 的文件系统路由模型.

## 成熟和支持

这个包是前1.0并放入B4.run的固定包组. 评议 [更改日志](https://github.com/cacheplane/b4run/blob/main/packages/langgraph/CHANGELOG.md) 升级前。 为了支持, [打开一个问题](https://github.com/cacheplane/b4run/issues)。 。 。 .

## 许可证

麻省理工学院. 见 [仓库许可证](https://github.com/cacheplane/b4run/blob/main/LICENSE)。 。 。 .

## 常见问题

### @b4run/langgraph 是什么？

LangGraph\.js的适配器和B4\.run代理商的路由合同,工作流程,以及图表\.

### 如何安装 @b4run/langgraph？

在项目目录运行 npm install @b4run/langgraph，或使用 pnpm add / yarn add / bun add。

### @b4run/langgraph 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @b4run/langgraph 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @b4run/langgraph 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @b4run/langgraph 可以商用吗？

@b4run/langgraph 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @b4run/langgraph 的下载量有多少？

根据 npm 官方下载统计，@b4run/langgraph 在 2026/10/08 – 2026/11/06 这 30 天内被下载 4,325 次，日均约 144 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @b4run/langgraph 还在维护吗？

最新版本 0\.15\.8 发布于 2026/10/31（7 天前）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/09/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。