PerryLink/dsh-legal-clause

dsh-legal-clause

官方仓库。 本包唯一官方仓库，由 PerryLink 维护；其他账号下的同名仓库与本项目无关。Apache-2.0。

合同条款树、playbook 映射与未解决报告。

状态：alpha / 公开合成 / partial / not counted / 非 GA。 不含客户证据、客户数据，也不作生产可用声明。

English · 简体中文 · Español · Português · हिन्दी

dsh plugin --profile <profile> add dsh-legal-clause

一句话

把一份合同文本拆成条款树，核对 12 项关键条款是否齐全并标出缺失。

适合 / 不适合

• 适合：10–200 条、UTF-8 纯文本的中英文合同；先看条款编号有没有重复/跳号，再看 12 类关键条款缺哪几项。
• 不适合：扫描件、PDF、Word 原件（要先转成纯文本）；逐条法律意见或风险评级；把客户合同上传到任何地方（只在你的电脑上算）。

输入

• 格式：UTF-8 纯文本 .txt，每个条款单独一行、以 1.、2. 开头；也可以直接粘贴正文。
• 大小：单份 ≤ 1 MB（自带样例约 3 KB）。
• 来源：合同系统导出、Word 另存为纯文本，或手工粘贴；原文件不会被修改。

输出

• 终端摘要：条款数、未识别条款数、12 项条款命中/缺失、条款编号问题数。
• 条款树 JSON：写到 $DSH_HOME/storages/dsh-legal-clause/exports/<合同编号>.json；原文件不改。
• 样例金标：samples/quickstart/expected/result.json（由真实运行产生）。

示例

直接复制下面这句：

我有一份 10 条的保密协议文本，帮我拆成条款树，看看 12 项关键条款缺哪几项。

用自带样例复跑并核对金标：

node samples/quickstart/run.mjs --check

截图就是上面这条命令的真实输出；金标比对结果见 samples/quickstart/expected/result.json。

权限

读：用户指定的 UTF-8 纯文本合同；不读其他目录 写：$DSH_HOME/storages/dsh-legal-clause/exports/；不改原文件 联网：否 外部系统：无

写文件的工具是 legal.clause_tree、legal.playbook_register、legal.export_tree，均标 R1（本地写）；其余标 R0（只读）。

FAQ

1. 装不上怎么办？

确认 Node >=24.9 <25、DSH >=0.2.1-rc.3 <0.4.0，再执行 dsh plugin --profile <profile> add dsh-legal-clause。仍失败先看 TROUBLESHOOTING.md 第 1 条。

2. 结果不对怎么办？

先跑 node samples/quickstart/run.mjs --check：样例通过说明安装没问题，再检查合同是不是每个条款单独一行、以 1. 开头。本包只按编号和关键词做静态检查，不判断条款写得好不好。

3. 能处理我的文件吗？

能。单份 ≤1 MB 的 UTF-8 纯文本，本地读、本地算，不上传、不联网。PDF/Word 请先转纯文本；客户合同不要贴进 issue。

4. 会改我的原文件吗？

不会。只往 $DSH_HOME/storages/dsh-legal-clause/exports/ 写一份新的 JSON。

版本

0.1.0 · 25 项测试通过（node --test test/*.test.mjs）。

⭐ 如果它帮到了你，点个 star 会让下一个人更容易找到它；没有任何功能被 star 解锁。

工作流：本地输入 → 插件 → 本地输出；不需要调用模型。

本地真实测试运行；不调用模型或网络。

安装

安装并验证：

dsh plugin --profile <profile> add dsh-legal-clause
dsh --profile <profile> --dump-config | grep dsh-legal-clause

卸载：

dsh plugin --profile <profile> remove dsh-legal-clause

安装通道

推荐 npm；其他通道用于固定版本或离线。

• npm（推荐）: dsh plugin --profile <profile> add dsh-legal-clause
• git 通道: dsh plugin --profile <profile> add github:PerryLink/dsh-legal-clause
• tarball: pnpm pack then dsh plugin --profile <profile> add ./dsh-legal-clause-<version>.tgz
• 1024 商店: npm i -g dsh1024 then dsh1024 plugin --profile <profile> add dsh-legal-clause

它做什么

合同条款树、playbook 映射与未解决报告。 在 DeepSeek Harness 本地运行；下表就是实际工具面，示例使用真实命令面。

输入和输出都留在本地，不上传。

工具

工具名是稳定 API；说明已本地化。

工具	用途	风险
legal.playbook	加载默认的 12 键 playbook	R0
legal.clause_tree	从法律文本构建条款树	R1 local write
legal.playbook_register	注册带版本的自定义 playbook 键	R1 local write
legal.playbook_check	将已保存的条款树与 playbook 比对，报告缺失/多余的键	R0
legal.export_tree	将条款树导出为 JSON	R1 local write
legal.clause_integrity	检查条款编号重复/跳号/乱序	R0
legal.coverage_check	直接对文本计算 12 项条款覆盖率	R0

快速开始

dsh plugin --profile <profile> add dsh-legal-clause
dsh --profile <profile> --dump-config | grep dsh-legal-clause

验收证据

fixture 支撑的示例

输入: fixtures/public/mit/sample_nda.txt

命令: pnpm test

验收行:

req_id	metric	threshold	actual	pass	source	counted
SKU-10-A01	合同条款树（20）	20/20	20	true	public/synthetic	false

这是 fixture 支撑的验收行，不是客户运行；没有编造输出。

边界

• 仅公开/合成样例；不含客户数据或客户证据。
• alpha/partial、not counted，不作 GA 或生产可用声明。
• 除非工具明确说明，否则不调用模型、不联网。
• 每个工具的精确边界见工具表与 ACCEPTANCE.csv。

公开样例

公开/合成 fixture 在 fixtures/；ACCEPTANCE.csv 记录公开检查，全部 counted=false。

开发

pnpm install --frozen-lockfile
pnpm build && pnpm lint && pnpm typecheck && pnpm test

兼容性

维度	状态
Harness	dsh >=0.2.1-rc.3 <0.3.0
Node	>=24.9.0 <25
Platforms	All; local files only
数据	No network, no model call, no upload

数据边界

• 本地运行；不联网、不调用模型、不上传。
• 只使用公开/合成 fixture；不含客户数据或客户证据。
• alpha/partial；not counted，不作 GA 或生产可用声明。

相关项目

兄弟包与家族索引： dsh-legal-intake · dsh-docx-redline · dsh-contract-suite

相关核查器（英文表）: Related checkers.

• 故障排查（英文）
• 领域索引
• Checker 家族
• 主线家族

家族

Package	npm
dsh-einvoice	npm
dsh-docx-redline	npm
dsh-policy-ledger	npm
dsh-ghg	npm
dsh-bankrec	npm
dsh-ap-three-way	npm
dsh-ifc-qto	npm
dsh-qms-capa	npm
dsh-legal-intake	npm
dsh-legal-clause	npm
dsh-freight-audit	npm
dsh-hs-candidate	npm
dsh-travel-recon	npm
dsh-pim-lint	npm
dsh-eval-pack	npm
dsh-finops-suite	npm
dsh-contract-suite	npm

Package	npm
dsh-aqua-input-check	npm
dsh-archive-check	npm
dsh-bid-ca-precheck	npm
dsh-bid-qual-check	npm
dsh-contract-stance	npm
dsh-customs-doc-check	npm
dsh-demurrage-ledger	npm
dsh-drill-script-check	npm
dsh-eia-guide-check	npm
dsh-emergency-plan	npm
dsh-essay-rubric-check	npm
dsh-evidence-check	npm
dsh-export-ctl-check	npm
dsh-fmea-table-check	npm
dsh-forecast-penalty	npm
dsh-gongwen-flow-check	npm
dsh-gongwen-word-check	npm
dsh-guard-plan-qc	npm
dsh-hazchem-check	npm
dsh-hazplan-check	npm
dsh-hidden-risk-map	npm
dsh-hs-classify	npm
dsh-icd-rule-check	npm
dsh-lawcite-adapter	npm
dsh-lc-doc-check	npm
dsh-learning-gap-check	npm
dsh-medrec-qc	npm
dsh-nsfc-form-check	npm
dsh-nurse-record-check	npm
dsh-origin-rvc-check	npm
dsh-ota-review-check	npm
dsh-paper-doc-adapter	npm
dsh-permit-report-check	npm
dsh-pipeline-check	npm
dsh-pleading-draft	npm
dsh-policy-brief-draft	npm
dsh-power-loss-split	npm
dsh-power-ticket-check	npm
dsh-ppap-check	npm
dsh-protest-deadline	npm
dsh-railway-window	npm
dsh-repair-order-qc	npm
dsh-review-reply-check	npm
dsh-rulefile-check	npm
dsh-safety-brief-check	npm
dsh-site-log-check	npm
dsh-soe-decision-check	npm
dsh-soilwater-check	npm
dsh-sop-sync-check	npm
dsh-spc-gbt-adapter	npm
dsh-tender-extract	npm
dsh-tender-matrix	npm
dsh-warranty-calc	npm
dsh-auto-review	npm
dsh-autotier	npm
dsh-budget	npm
dsh-cert-mcp	npm
dsh-checkpoint-rewind	npm
dsh-claude-move	npm
dsh-click	npm
dsh-composer-history	npm
dsh-data-quality	npm
dsh-defend	npm
dsh-doublecheck	npm
dsh-draw	npm
dsh-fast	npm
dsh-fund-research	npm
dsh-industry-research	npm
dsh-laya	npm
dsh-library	npm
dsh-local-ai	npm
dsh-lsp-actions	npm
dsh-mask	npm
dsh-mcp-panel	npm
dsh-memento	npm
dsh-observe	npm
dsh-output-styles	npm
dsh-permission-rules	npm
dsh-plugin-guide	npm
dsh-plugin-upgrade	npm
dsh-reach	npm
dsh-research-report	npm
dsh-score	npm
dsh-session-sync	npm
dsh-talk	npm
dsh-test-drive	npm
dsh-translate	npm
	npm
	npm
	npm
	npm
	npm

许可证

Apache-2.0. See LICENSE, NOTICE, THIRD-PARTY-NOTICES.