dsh-contract-stance
把合同条款立场台账的缺项与自相矛盾,在谈判前变成一份可逐条指认的清单。
面向法务与合同管理员的主机端核对插件:读取一份「合同表头 + 每条款一行」的立场台账,按逐字引用的规则库列出「哪一行、哪一栏、差什么」,不改原件、不判定合规。
安装 · 配置 · FAQ · 简体中文 · English · Español · Português · हिन्दी
dsh plugin --profile <name> add dsh-contract-stance
社区插件,与 DeepSeek 官方无关。唯一仓库:https://github.com/PerryLink/dsh-contract-stance(Gitee 为镜像)。
它是什么
dsh-contract-stance 读取一份合同条款立场台账——合同表头加每条条款一行——只核对这份台账自身的齐备与自洽:条款原文是否摘录、本方立场是否取自本机构口径、风险等级是否同样在册、必保条款是否写明退让底线与责任人、条款号是否唯一、表头是否声明合同与本方、条款原文是否残留未替换的占位符。它输出的是「哪一行、哪一栏、差什么」的差异清单;材料只读,原样保留。
插件注册单一工具 contract_stance,材料用 JSON 或 YAML,file 与 material 二选一。
三步上手
安装(npm 已发布
0.2.11):dsh plugin --profile <name> add dsh-contract-stance dsh --profile <name> --dump-config | grep 'dsh-contract-stance'在本仓库内跑一次自带样例(先构建宿主产物):
pnpm install && pnpm run build node samples/quickstart/run.mjs$ node samples/quickstart/run.mjs contract_stance: 1 issue(s) — error 0, warn 1, info 0 skipped: 2样例输入在
samples/quickstart/input/CS-001-unsafe.json,期望摘要见samples/quickstart/expected/result.json,同一输出收录在docs/assets/quickstart.log。在会话里调用工具:
用 contract_stance 核对 samples/quickstart/input/CS-001-unsafe.json工具也接受内联材料:
{"material": "contractName: …\nrows:\n - …"}。输出含summary、issueCount、skippedCount、markdown与reportJson。

卸载:dsh plugin --profile <name> remove dsh-contract-stance(或从 profile patch 删掉该行)。
核心能力
- 单一工具、两种材料入口 ——
contract_stance接受file(JSON/YAML 绝对路径)或material(内联文本);两者都为空时明确报错,不回退到猜测。 - 七条规则,全部由规则库声明 ——
CS-001至CS-007覆盖条款原文、立场口径、风险等级口径、必保条款的底线与责任人、条款号唯一性、表头声明与占位符;替换rules/contract-stance.yaml即可切换规则集,无需改代码。 - 空清单不静默通过 —— 立场清单(
CS-002)与风险等级清单(CS-003)出厂为空,未配置时两条规则把自己列入skipped并写明原因,绝不当作「无差异」。 - 只列差异,不作定性 —— 共享渲染层内置措辞守卫(
src/shared/wording.ts、src/shared/render.ts),每份报告固定附加免责声明;测试套件对模型可见的markdown做同一检查。不判合规、不认定责任、不建议是否签署。 - 只读材料 —— 不修改输入文件、不写入任何文件、不发起网络请求、不调用模型。
- 注册即 effect ——
ctx.tools.register返回 disposer,插件停用或热重载时工具随之撤销。
| 规则 | 核对什么 | 级别 | 依据类型 |
|---|---|---|---|
CS-001 |
每条条款都摘录原文 | warn | 原则性(derived-from-principle) |
CS-002 |
本方立场取自本机构配置的取值清单(默认关闭) | info | 原则性(derived-from-principle) |
CS-003 |
风险等级取自本机构配置的取值清单(默认关闭) | info | 直接(direct) |
CS-004 |
必保条款同时写明退让底线与谈判责任人 | warn | 直接(direct) |
CS-005 |
条款号在台账内唯一(比较时忽略空白) | warn | 原则性(derived-from-principle) |
CS-006 |
表头写明合同名称与本方主体 | warn | 直接(direct) |
CS-007 |
条款原文不残留未替换的占位符 | warn | 原则性(derived-from-principle) |
输出结构
工具返回 summary(error/warn/info 计数)、issueCount、skippedCount、markdown(模型读的渲染文本)与 reportJson(完整报告的规范化 JSON)。reportJson 中每条差异带稳定的 id(<插件>.<规则>.<位置哈希>)、locator(行/栏)、found、expected、basis 与可选 fix。
示例
以下为真实夹具的差异结构(reportJson.issues[0],节选)。输入:
{"rows":[{"条款号":"第 8.2 条","条款主题":"逾期付款违约金","条款原文":"", ...}]}
输出:
{
"id": "dsh-contract-stance.CS-001.de09b5a6",
"ruleId": "CS-001",
"severity": "warn",
"locator": {
"row": 1,
"field": "text"
},
"found": "第 1 行「text」为空",
"expected": "「text」应填写",
"fix": "补填条款原文;本条只核对是否摘录,不判断条款是否可接受"
}
出处:tests/fixtures/CS-001/CS-001-unsafe.json、tests/fixtures/CS-001/cases.json、rules/contract-stance.yaml、tests/index.test.ts。
规则与依据
| 文件 | 文号 | 引用它的规则 |
|---|---|---|
| 《中华人民共和国民法典》 | 现行版本与条号本次未核实 | CS-001, CS-002, CS-003, CS-004, CS-005, CS-006, CS-007 |
边界: 本插件核对一份合同条款立场台账,范围限于台账自身可以据以要求的事项——每一条款的原文是否记录、你的立场是否取自你配置的取值口径、风险等级是否同样取自该口径、必保条款是否同时记录可以让步到的底线与责任人、条款号是否唯一、台账是否写明合同与本方、是否残留占位符。它不判定某条款是否应当接受、某项风险是否可承受、是否应当签署,也不判定谈判策略是否妥当。这些取决于交易本身、对方的议价能力与你自己的风险偏好。
⚠️ 引文依据什么——以及一件绝不能交给本插件的东西
《中华人民共和国民法典》已取得并逐字阅读,
rules/evidence/clause-verification.md记录了所引内容:第四百六十五条(依法成立的合同受法律保护、仅对当事人具有法律约束力)、第四百七十条(合同内容一般包括当事人、标的、数量、质量、价款、履行期限、违约责任与争议解决方法)、第四百九十六条(格式条款的提示与说明义务)、第四百九十七条(格式条款无效的情形)、第五百零六条(免责条款无效的情形)、第五百零九条、第五百七十七条(违约的后果)与第五百八十四条(损害赔偿包括可得利益,但以可预见性为限)。规则库的excerpt是逐字引文,basis.number仍保留「现行版本与条号本次未核实」——本次未取到附则与施行日期,故不对版本与施行日期作断言。合同编并不规范谈判台账。 它规范合同的订立、效力、履行与违约责任;台账的栏位来自你自己的企业合同管理制度。因此每条规则仍封顶为
warn或info:「这一栏是空的」不得被读作「这违反了《民法典》」。 另请注意,第四百七十条写的是一般包括,不是应当包括——这也是CS-001不主张直接义务的又一理由。⚠️ 不要向本插件添加诉讼时效规则。 《民法典》确实规定了具体数字——第一百八十八条规定三年诉讼时效(最长二十年),第二百零三条规定期间最后一日为法定休假日时顺延——这让「直接比较日期」看起来很有吸引力。但在这里行不通:该期间从债权人知道或者应当知道损害与债务人之日起算,而这是台账并不记录的事实认定;该期间还适用中止(第一百九十四条)与中断(第一百九十五条),第一百九十六条则列出根本不适用诉讼时效的请求权。日期算术规则会把事实认定包装成计算,而这恰恰是本插件族要避免的过度主张。
本插件任何地方都不对条款的实质作出判断。 它读取你自己的列,只核对这些列是否填写、是否取自你的词汇表。有两份词汇表出厂为空——立场清单(
CS-002)与风险等级(CS-003)——因此在未配置任何内容时,这些规则会在skipped中自行报告,而不是静默通过。
规则来源
规则数据与代码分离:每条规则都带文件名、文号、按原文自身编号体系的条款号、逐字摘录与来源地址。加载期强制:摘录必须是真实引文且不少于八个字符;依据仅为原则性条款(kind: derived-from-principle,严重级上限 warn)或本机构配置(kind: institutional-configuration,上限 info)的检查不得标为 error。夸大依据的规则库会在加载期失败,而不会产出一份看起来很有底气的报告。
核验中确认的边界与「刻意没有作出的结论」见 rules/evidence/ 目录;pnpm run check:citations 在 CI 中复核这条纪律。
配置
全部可调参数都在 src/config.ts 的 Schemastery schema 中,只改 cordis.yml 即可生效,无需改代码;逐条规则的阈值与取值清单在 rules/contract-stance.yaml 里。
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
rulesFile |
string | rules/contract-stance.yaml |
规则库文件路径,相对插件包根目录 |
disabledRules |
string[] | [] |
要停用的规则 id 列表;每条都会出现在 skipped 中 |
onlyRules |
string[] | [] |
只执行这些规则 id;留空表示执行全部规则 |
skipNotes |
string | "" |
附加到每条 skipped 说明后的备注 |
timeoutMs |
number | 120000 |
工具协作式超时预算(毫秒) |
规则级参数(写在规则库文件里,不在 Config 中):
CS-002的values—— 你的立场词汇表,例如[坚持, 可谈, 接受, 须删除];留空表示不检查。CS-003的values—— 你的风险等级,例如[高, 中, 低];留空表示不检查。CS-004的conditionValues—— 「是否必保」栏中表示必保的取值,默认[是, Y, yes, true, 必保, √]。CS-007的terms—— 要查找的占位符术语清单。
profile patch 覆盖示例:
- insert:
- id: dsh-contract-stance
name: dsh-contract-stance
config:
onlyRules: [CS-001, CS-004, CS-006]
skipNotes: 本机构合同管理办法(2026 版)
材料格式
接受 JSON 与 YAML。最小形态是「表头 + 每条款一行」:
contractNo: HT-2026-018
contractName: 某某设备采购合同
party: 某某公司
version: 第 3 轮谈判稿
rows:
- { 条款号: 第 8.2 条, 条款主题: 逾期付款违约金,
条款原文: 买方逾期付款的,每逾期一日按未付金额的万分之五向卖方支付违约金。,
本方立场: 可谈, 风险等级: 中, 风险说明: 违约金比例高于本方惯例且未设上限,
退让底线: 比例可降至万分之三,须增加总额不超过合同额 5% 的上限,
是否必保: 是, 谈判责任人: 王经理 }
列名大小写不敏感,并忽略空格、下划线与连字符;台账自己的列名会保留在 locator 中,方便按原件回查。表头字段 contractName 与 party 是 CS-006 的核对对象;version 可用于区分多轮谈判稿。材料只读,插件不会改写输入文件。
FAQ
某行只填了条款主题,条款原文栏是空的,会被报出吗?会。CS-001 要求每行都填写 text 栏:没有原文,就无法核对立场是针对什么措辞作出的。本条只核对原文栏是否填写,不判断该条款是否应当接受、是否存在法律风险。
因为两份取值清单出厂都是空的。CS-002 只接受为本机构配置的清单里的 stance 取值,CS-003 对 riskLevel 同理;未配置清单时两条规则都无法执行,于是各自报告 skipped,而不是静默通过。CS-002 只核对所填值是否在册,不判断该立场是否恰当;CS-003 只核对是否在册,不判断该条款的实际风险有多高。
CS-004 读取台账自己的「是否必保」栏:该栏取值为 是、Y、yes、true、必保 或 √(由 conditionValues 配置)时,要求 fallback 与 owner 两栏都填写。它只核对这两栏是否填写,不判断该退让底线是否合理;哪些条款属于必保条款完全取决于本项目,本条不作判定。
CS-005 会报出重复的条款号,比较时忽略空白字符。条款号重复会让人无法准确指认是哪一条;同一条款在多个谈判稿版本中各有一行是正常情形,请在版本栏加以区分,而不是重复使用条款号。没有任何条文规定条款号不得重复,唯一性只是台账可指认性的需要。
CS-006 要求材料顶层写明 contractName(合同名称)与 party(本方名称):不写明这两项,立场就无法追溯到具体的交易与主体。若本机构表式另有版本栏,把该栏加进本条的 fields 即可。本条只核对表头是否声明了这两项,不判断合同本身。
安全边界
- 只读,不写盘。 工具只读取
file指向的材料或material内联文本;不修改原件、不生成文件、不缓存材料。package.json的dsh.demo声明network: false、writes: [],实现中也没有任何网络或模型调用。 - 不作出定性结论。 报告只列「材料与所引条款之间的字面差异」;每份报告固定附加免责声明,共享渲染层在输出前用措辞守卫拒绝「合规/违规/无效合同」这类定性词(
src/shared/render.ts),测试套件对模型可见的markdown做同一检查。专业判断留给复核人。 - 引用纪律是硬门禁。 规则库加载期校验
excerpt必须是不少于八个字符的真实引文,kind决定严重级上限(derived-from-principle封顶warn,institutional-configuration封顶info);依据夸大的规则库直接加载失败。 - 空结果不等于没有问题。 任何因缺少取值清单、停用或只跑部分规则而无法执行的检查,都会逐条列入
skipped并写明原因;「没有差异」只在全部声明规则都已执行时成立。 - 注册即 effect。 工具注册返回 disposer,停止或热重载插件即可撤销注册;插件不注册命令、客户端 slot、HTTP 路由或共享事件监听。
- 权限与数据。 manifest 只声明
tools:register;读取用户指定的材料文件,不写文件、不联网、不存凭据。材料内容只进入本次工具调用的报告,插件侧不落盘。
已知限制
- 只核对台账,不核对合同正文。 台账抄错、漏抄或与合同正文不一致,本插件发现不了——它的工作对象是台账本身,不是合同文件。
- 立场与风险等级清单出厂为空。
CS-002、CS-003的口径由本机构定义,插件不猜;未配置即如实进skipped。 - 民法典不规定台账形式。 合同编规范的是订立、效力、履行与责任;「栏位没填」与「违反民法典」是两件事,所有规则封顶
warn/info。 - 不核对诉讼时效,且不应添加此类规则。 时效起算点是「知道或者应当知道」这一事实认定,台账不记录;中止、中断与不适用时效的请求权也无法从台账判断(详见「规则与依据」)。
- 条款号唯一性只是可指认性的需要。 同一条款按谈判稿分多行是正常形态,应在版本栏区分;
CS-005只报重复,不判断重复是否合理。 - 表头与枚举按字面取值匹配。 列名做大小写与空格/下划线/连字符归一;「是否必保」的判定取值由
conditionValues决定,换表式时需同步配置。 - 工具模式:
native与ptc均可;整目录批量核对建议ptc,schema 成本只付一次。
- 插件装上了但工具不出现:确认
main指向lib/index.mjs且pnpm run build已生成该文件;main写错会让加载器静默跳过该条目。 dsh plugin add报版本不兼容:peer 范围覆盖0.1.x与0.2.x,engines.dsh为>=0.2.1-0 <0.3.0;若运行时在其之外,可显式豁免:dsh plugin --profile <name> allow-version <包名@版本> --dsh-version <runtime> --accept-risk。- 某条规则没有执行:查看
skipped数组,其中写明了规则 id 与原因。 check报manifest-peers失败:静态检查器比对的是一份早于 0.2 世代的硬编码 peer 范围;安装期的 peer 校验以运行时为准。这是dsh-plugin-dev的已知上游问题。- 时间看起来偏移:全部计算都是对输入字符串做墙上时钟运算,不做时区换算。
与其他插件的互操作性
- 只注册一个工具。
contract_stance是插件唯一暴露给模型的表面;它不提供 service key、不注册/命令、不注册客户端 slot、不注册webServer前缀、不监听共享会话事件。 - 依赖宿主
tools服务。inject: ['tools']表示工具只在tools服务可用时注册;宿主没有该服务时插件不会以半初始化状态运行。 - bundle patch 只
insert自己一行。cordis.patch.yml不覆盖任何内置行的config。 - 无全局改写。 不改原型、不改写
process.env、不替换全局 fetch dispatcher、不改动宿主目录结构。 - 没有可争抢的资源。 由于不占用服务键、slot、HTTP 路由与共享事件,同一 profile 中的其他插件不会因本插件产生这四类冲突。
兼容性
| 维度 | 状态 |
|---|---|
| Harness | 对等版本范围 >=0.1.2-rc.1 <0.2.0 || >=0.2.0-0 <0.3.0——已实测同时接受 0.2.0-rc.2 与 0.2.1-rc.2。engines.dsh 声明为 >=0.2.1-0 <0.3.0,0.2.1 起由宿主单独裁决 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全平台(纯 ESM;无原生代码、无联网、不调用模型) |
| 工具模式 | native / ptc 均可;批量校验整个目录时建议 ptc |
生态与质量
- dshfind 插件页(安装量与排名)
- OpenSSF Scorecard 报告(由 .github/workflows/scorecard.yml 驱动)
- DSH Market(已上架)
- Gitee 镜像(同步镜像,以 GitHub 为准)
- 规则核查记录(逐条记录引文来源与刻意未作的结论)
- 按材料选核查器 · PerryLink 插件全景
开发
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
node samples/quickstart/run.mjs
pnpm run verify:self-contained
pnpm run check:lockfile
pnpm run check:readmes
pnpm run check:citations
pnpm pack
node ../scripts/sync-shared.mjs dsh-contract-stance 把 ../_shared 的共享件同步进 src/shared/;每次改动共享件后都要重跑。插件是数据驱动的:src/model.ts 声明表结构与列别名,共享包提供读取与检查引擎,规则库声明每一条检查。
README 配图由 scripts/gen-readme-assets.py 程序化生成(Python + Pillow 出 hero,手写 SVG 出结构图),输出 docs/assets/dsh-contract-stance-hero-{zh,en}-{light,dark}.webp 与 docs/assets/dsh-contract-stance-flow-v5-{light,dark}.svg;可重复执行,结构图内只含命令与配置键 token,五语共用。
Topics:deepseek-harness, dsh, dsh-plugin, cordis, contract, stance
家族与致谢
本项目是 PerryLink 维护的 DeepSeek Harness 插件家族成员(全部 Apache-2.0)。如果这个插件帮到了你,给个 star——它不解锁任何功能,但会让下一个人更容易找到它。
- @PerryLink —— 创建者与维护者:规则库(CS-001..CS-007)、共享核对引擎接入、条款核查记录与五语文档。
License
LICENSE(Apache License 2.0)© 2026 dsh-contract-stance contributors
Apache-2.0 · 社区插件,与 DeepSeek 无关。
No comments yet. Be the first to write one.