dongsheng123132/dsh-lineage

用于DeepSeek Harness的内容寻址制品、事实、动作和报告溯源

Project Overview项目介绍

This repository is a purpose-built plugin for DeepSeek Harness that adds verifiable, content-addressed data and action lineage tracking to DSH workspaces. It builds a local object graph for artifacts, facts, actions, and reports, with each node only storing a typed ID, workspace-relative object reference, and expected SHA-256 hash. It never stores raw chat transcripts or prose content, and it also works as a formal Codex plugin and a standalone stdio MCP server that matches the export shape required by DSH’s default Web Loader. To install it directly to DSH, you can run the one-line command dsh plugin --profile lineage add github:dongsheng123132/dsh-lineage from your DSH CLI.

It is designed for developers who need to audit the provenance of AI-generated artifacts and agent actions within a DSH workspace. It supports four node types and four edge types that encode causal relationships between objects, and it can automatically detect issues like missing objects, stale hashes, dangling references, invalid relations, and graph cycles. All events are stored in an append-only JSONL ledger that uses idempotency keys to ensure immutability, and any new revision of an object gets a new node ID with a supersedes edge linking it to the old version. Replaying the same idempotency key with different content will fail closed to prevent accidental tampering.

The project is released under the open-source MIT license, and it requires Node.js 22 or newer to run, with no mandatory runtime dependencies outside of the optional DSH tools SDK peer dependency. It enforces a strict safety model that blocks path traversal and symlinks, only allows writes to explicitly configured ledger and artifact directories, and rejects any schema that includes fields for text, credentials, or sensitive data. The standalone MCP server only accepts up to 1 MiB of inline events and never accesses the local filesystem, while full persistent ingestion and hash verification are only available via DSH tools or the standalone CLI. You can run the included test suite after cloning to validate your local build.

这是专为DeepSeek Harness开发的原生插件,提供基于内容寻址的可验证数据与操作血缘追踪能力。它会为工作区内的工件、事实、操作和报告构建本地对象图,每个节点仅存储类型ID、工作区相对引用和预期SHA-256哈希,不会存储聊天记录或任何实际内容文本。它同时也符合Codex插件规范,可作为独立标准IO MCP服务器运行,遵循DSH Web加载器要求的导出格式,有专门的回归测试保障加载契约。

该工具面向需要对AI Agent生成的工件和操作做溯源审计的开发者,支持多种节点类型区分、因果边定义和DAG合法性验证,可以检测缺失、过时、悬垂引用、图循环等多种结构异常问题。典型工作流程为先验证完整的假设图结构,再以原子方式写入不可变事件账本,生成对象新修订版本时会分配新节点ID并添加替代边,不会修改或覆盖原有已发布的事件文件。

该项目采用MIT许可开源,无强制运行时依赖,仅要求Node.js 22或更高版本,可选依赖DSH工具SDK作为对等依赖。它严格限制所有路径都必须为工作区相对路径,拒绝符号链接和路径遍历,仅允许在指定的账本和工件目录写入数据,会拒绝包含文本、凭证等内容的非法Schema。首次使用可通过dsh plugin命令一键安装,也可直接通过命令行或MCP调用对应工具。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile lineage add github:dongsheng123132/dsh-lineage

把 dongsheng123132/dsh-lineage 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-lineage

CI MIT license Node.js 22+ Awesome DSH Plugins

Content-addressed data and action lineage evidence for DeepSeek Harness.

The DSH ecosystem already has a security-audit plugin that reports plugin provenance. dsh-lineage addresses a different gap: it builds a local, verifiable object graph for artifacts, verified-fact records, actions, and reports. It never stores chat transcripts or factual prose; a node is only a typed ID plus an explicit workspace-relative object reference and expected SHA-256.

Version 0.2.0 is a formal Codex plugin and standalone proof-only MCP server, and uses the namespace export shape required by the stock DSH Web Loader. A real Cordis boot regression test guards that loader contract.

Adjacent tools track Skill bundle versions, hash-chain agent activity, or register provenance. This project stays at the object-graph evidence layer: typed content-addressed nodes, explicit causal edges, resolvable references, DAG validation, upstream/downstream closure, and missing/stale disclosure.

Graph model

Node types:

  • artifact
  • fact
  • action
  • report

Edge types point from the dependent object toward its provenance:

  • derived-from
  • observed-by
  • produced-by
  • supersedes

Every node reference is dereferenced inside workspaceRoot and hashed. The verifier distinguishes:

  • verified: the object exists and matches its expected hash;
  • missing: the reference cannot be resolved;
  • stale: the object exists but its current hash differs;
  • dangling graph references, invalid relation types, and cycles.

No missing or stale object is silently promoted into a fact.

Append-only ledger

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-newsboard 下一个 Next ccs-balance →