# @harnessio/pipeline-graph 中文文档

规范地址：https://npmcn.com/package/%40harnessio/pipeline-graph/

版本：1\.11\.0
npm 元数据更新时间：2026-11-16T17:37:11.123Z
中文译文更新时间：2026-11-17T10:15:39.197Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40harnessio/pipeline-graph
原文对照：https://npmcn.com/package/%40harnessio/pipeline-graph/?lang=original

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

- 包体积（解压后）：969 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：react ^17\.0\.2，react-dom ^17\.0\.2，@types/react ^17\.0\.3，@types/react-dom ^17\.0\.3
- 首次发布：2025-01-21T16:45:08.730Z
- 最新版本发布：2026-11-13T07:20:04.206Z
- 近 30 天下载量：61312（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 17 个）

## 中文简介

用于生成和与管道图交互的库.

## 安装

```sh
npm install @harnessio/pipeline-graph
```

也可以使用：`pnpm add @harnessio/pipeline-graph`、`yarn add @harnessio/pipeline-graph`、`bun add @harnessio/pipeline-graph`

## README

# 管道图

用于生成和与管道图交互的库.

![pipeline graph](https://npmcn.com/package/%40harnessio/pipeline-graph/public/pipeline-graph.png "Pipeline graph")

## 解剖学

-   型号
-   集装箱和内容节点
-   边缘
-   帆布

### 型号

类型 **任何容器节点** 我们的联盟 **叶管节点** | **平行容器节点** | **串接器节点** 并代表一个节点. **叶管节点** 节点没有孩子, 而其他节点有.

模型实例

```ts
const model: AnyContainerNodeType[] = [
  {
    type: 'stage',
    children: [{ type: 'step' }, { type: 'step' }]
  }
]
```

为了想象我们的模型,我们需要 **集装箱** 财务报告和审定财务报表 **内容** 节点.

### 集装箱和内容节点

#### 集装箱节点

集装箱节点负责布局和基本的用户互动,如添加/删除节点. 有三个集装箱: **叶子**, (中文(简体) ), **序列** 财务报告和审定财务报表 **平行**。 。 。 . **叶子** 使一个 **内容** 节点,同时 **序列**编号 :**平行** 使自己和孩子们.

集装箱节点解剖学:

-   **元数据** - 在我们的根部 **数据路径** 财务报告和审定财务报表 **数据动作** 用于活动授权目的的属性.
-   **相对定位** - root div 已经 _职位:相对_ 因此,我们可以使用绝对位置 在造型在 **内容** 节点.
-   **港口** - 港口是潜水的 它的位置用于计算和绘制端口之间的联系.
-   **添加/删除容器** - 用于捕获鼠标徘徊(通过css)。 它们有鼠标悬浮时出现的按钮.

#### 内容节点

内容节点负责节点的内容(如文本,图标等)和可视化状态(如 _装入_ 或者说 _选择_(中文(简体) )

#### 对齐内容和连接节点

为了制作我们的图表,我们必须将容器和内容节点配对。 我们用这个 **节点** 类型.

```ts
const nodes: NodeContent[] = [
  // register "step" content node which will render "StepContentNode" inside "leaf" container
  {
    type: "step",
    component: StepContentNode,
    containerType: ContainerNode.leaf
  },
  // register "stage" content node which will render "SerialGroupContentNode" inside "serial" container
  {
    type: "stage",
    component: SerialGroupContentNode
    containerType: ContainerNode.serial,
  }
]
```

### 边缘

节点之间的连接线使用 svg 路径来绘制 。 线路使用端口(属于集装箱节点的一部分)来计算.

### 帆布

图书馆提供从盒子中取出锅和从盒中取出. 用于创建手动控制以缩放和放出, 我们可以使用 CanvasContext 来显示增量、减速和放入功能 .

执行自定义控制示例

```tsx
const { increase, decrease, fit } = useCanvasContext()

return <>
    <button onClick={() => increase()}>+</button>
    <button onClick={() => decrease()}>-</button>
    <button onClick={() => fit()}>FIT</button>
</>
```

## 常见问题

### @harnessio/pipeline-graph 是什么？

用于生成和与管道图交互的库\.

### 如何安装 @harnessio/pipeline-graph？

在项目目录运行 npm install @harnessio/pipeline-graph，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17\.0\.2）、react-dom（^17\.0\.2）、@types/react（^17\.0\.3）、@types/react-dom（^17\.0\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @harnessio/pipeline-graph 支持 TypeScript 吗？

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

### @harnessio/pipeline-graph 支持 ESM 还是 CommonJS？

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

### @harnessio/pipeline-graph 可以商用吗？

@harnessio/pipeline-graph 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @harnessio/pipeline-graph 的下载量有多少？

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

### @harnessio/pipeline-graph 还在维护吗？

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

