Skip to content
dsh marketplace

dsh-data-lineage

Verified

@liuhange/dsh-data-lineage · v2.0.3 · MIT

Data lineage tracking plugin: trace data flow from source to product with hash chaining and Mermaid visualization Also known as @deepseek-ai/dsh-data-lineage.

Install

dsh plugin add @liuhange/dsh-data-lineage

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Readme

@liuhange/dsh-data-lineage

数据血缘追踪插件：追踪数据从源头到最终产品的流转路径，支持链式追溯和 Mermaid 可视化。

安装

dsh plugin --profile web add @liuhange/dsh-data-lineage

Tool 接口

trace_data_lineage

导出数据血缘追踪报告，支持 JSON/Mermaid/Markdown 三种格式。

参数：

  • lineageFilePath (string, 必填): 血缘记录文件路径（lineage.json）
  • outputFormat (string, 可选): 输出格式 json | mermaid | markdown | all，默认 all

输出：

  • lineage_export.json: 血缘 JSON
  • lineage_export.mmd: Mermaid 流程图
  • lineage_export_report.md: Markdown 报告（首行 【数据血缘追踪报告】）

血缘记录

每个步骤记录：步骤名、时间戳、输入文件路径+hash、输出文件路径+hash、变换规则、处理参数。

编排嵌入

通过 LineageHook 在编排流程中自动嵌入血缘记录：

  • recordBefore(): Tool 调用前记录输入文件 hash
  • recordAfter(): Tool 调用后记录输出文件 hash 和变换规则
  • enabled = false 时零开销，不计算 hash，不生成文件

配置节点

business-rules.json → lineage 节点。缺失时默认禁用（enabled: false），编排行为与 v1.0 完全一致。

v1.0 兼容性

血缘功能默认禁用，不影响 v1.0 编排行为。启用时额外耗时 ≤ 1 秒/Tool调用。