@harnessio/pipeline-graph

中文文档
1.11.0发布于 2026/11/13Apache-2.0TypeScriptES Module近 30 天下载 6.1万

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

中文使用文档
文档目录5 节
  1. 解剖学
  2. 型号
  3. 集装箱和内容节点
  4. 边缘
  5. 帆布

管道图

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

pipeline graph

解剖学

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

型号

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

模型实例

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

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

集装箱和内容节点

集装箱节点

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

集装箱节点解剖学:

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

内容节点

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

对齐内容和连接节点

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

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 来显示增量、减速和放入功能 .

执行自定义控制示例

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

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

版本与发布记录

@harnessio/pipeline-graph 共发布 32 个版本,首次发布于 2025/01/22;过去 12 个月发布了 17 个版本。

版本发布日期距今
1.11.0latest2026/11/134 天前
1.10.02026/10/131 个月前
1.9.72026/08/133 个月前
1.9.62026/02/069 个月前
1.9.52026/02/069 个月前
1.9.42026/02/069 个月前

其他发布通道:alpha → 1.0.0-alpha.0。

关于 @harnessio/pipeline-graph 的常见问题

@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 和提交记录判断。