起诉状核对 PerryLink/dsh-pleading-draft

dsh-pleading-draft — 起诉状要素核对表完整性检查，每项诉讼请求一行

dsh-pleading-draft 读取一份起诉状要素核对表——案件头部信息，加上每项诉讼请求一行，行内含 序号、诉讼请求、事实依据、证据、法律依据、金额、期限 各列——检查文档自身的完整性与内部一致性：每项诉讼请求都记录了事实依据、指向证据并写明法律依据；带金额的诉讼请求同时带履行期限；头部信息写明原告与被告；没有要素编号重复；诉讼请求列中不残留未替换的占位符。

它能回答什么

| 你问 | 它回答什么 |
| 诉讼请求写出来了，但证据列什么都没指向。 | PL-002 报告 证据 列未指向证据的那一行——它检查是否写明了引用，不检查证据是否存在、是否完整、是否与该项诉讼请求相关。 |
| 法律依据列只写了一句笼统的话，比如「相关法律规定」。 | PL-003 要求每项诉讼请求要素的 法律依据 列都已填写。它报告空列；不核实所引条文是否存在、是否现行有效、是否适用于本案。 |
| 金额写了，但没记录履行期限。 | PL-004 仅在 金额 列已填写时触发，随后要求 期限 列：有金额无期限即报告。确认之诉的诉讼请求不会被要求填写它本就没有的期限。金额计算是否正确、期限是否合理，不在检查范围内。 |
| 案件头部信息必须包含哪些字段？ | PL-005 要求头部信息写明原告与被告；两者都是配置字段，所以你可以按自己的表单加上案由与受理法院。它不检查当事人是否是该诉讼请求的适格主体。 |
| 诉讼请求列里还留着模板占位符，会怎样？ | PL-007 会报告：它查找的词是 【、】、{{、}}、XXX、xxx、待填、待补充、TBD、todo 和 示例。表述含糊但不含上述词的诉讼请求会通过，因为判断诉讼请求需要多精确属于法律判断。 |
| 某条规则出现在 skipped 里，而不是报告任何内容。这是不是说明它通过了？ | 不是。skipped 列出的是未运行的检查：比如 PL-002，在配置中被禁用、被 only 选择排除，或材料满足其前置条件且未发现差异时，就会列在那里。未运行的检查无法为任何列放行，它自身的局限也依然成立：它从来看不出证据是否充分、是否与诉讼请求对应。 |

遵循的标准

| 文档 | 编号 | 引用规则 |
| 《中华人民共和国民事诉讼法》 | 1991年通过，经 2007、2012、2017、2021、2023 年五次修正（现行条号据 2021 年第四次修正及 2023 年第五次修正文本核对） | PL-001, PL-002, PL-003, PL-004, PL-005, PL-006, PL-007 |

边界： 本插件检查 起诉状（或申请书）要素核对表 的完整性——即每项诉讼请求都记录了事实依据、指向证据、写明法律依据，金钱请求要写明金额和履行期限，文书要点明双方当事人，要素编号唯一，且不留任何占位符。它不判断请求能否成立、是否超过诉讼时效、管辖是否正确、证据是否充分、案件是否应当受理。那些都是法院的认定和律师的实体判断。

⚠️ 这个插件能做什么、不能做什么

它读的是一份清单，不是起诉状、证据或法条。 所以它只能检查某一栏是否指向证据、是否写明某条规定——永远不能检查证据是否充分，也不能检查该规定是否存在、是否有效、是否适用。PL-002 和 PL-003 在自己的备注里就是这么写的。拿一份引用了已废止条文的起诉状来测这个插件：它会通过，因为查法条是另一回事，这个插件刻意不做。

规则包里的每一条 excerpt 都明明白白写着：条文原文未能获取。 相关制度见《中华人民共和国民事诉讼法》（尤其是关于起诉状应当记明哪些事项的那一条）以及最高人民法院对它的解释。核验环节没能取到条文原文，所以规则包在 excerpt 字段里直接写明这一缺口，并把每条规则都保持在 warn 或 info。拿到条文原文后，把每条 excerpt 换成真正的条文，并把 kind 提到 direct。

PL-004 只在金额栏填了内容时才触发，所以请求确认或请求变更法律关系的诉请，不会被要求写一个它本来就没有的履行期限。而 PL-007 只抓占位符：一条表述含糊、但不含 【】 或 待填 的请求会通过，因为判断一条请求是否达到要求的明确程度，属于法律判断。

兼容性

| 层面 | 状态 |
| Harness | 对等范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0 —— 已验证同时接受 0.2.0-rc.2 和 0.2.1-alpha.1。刻意不声明 engines.dsh：它没有读取方，也无法拒绝宿主 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码、无网络、不调用模型） |
| 工具模式 | 在 native、ptc 和 both 下都能用；请求较多时用 ptc |

它做什么

注册 pleading_draft 工具。它读取一份起诉要素清单——案件抬头加上每条请求一行——套用带版本的规则包，返回一份报告。

| 规则 | 检查项 | 严重级别 | 依据类型 |
| PL-001 | 每条请求都写明事实依据 | warn | direct |
| PL-002 | 每条请求都指向证据 | warn | direct |
| PL-003 | 每条请求都写明法律依据 | warn | direct |
| PL-004 | 金钱请求写明金额和期限 | warn | principle |
| PL-005 | 文书中写明原告与被告 | warn | direct |
| PL-006 | 要素编号唯一 | warn | principle |
| PL-007 | 诉讼请求列中不含未替换的占位符 | warn | principle |

安装

dsh plugin --profile <name> add dsh-pleading-draft
dsh --profile <name> --dump-config | grep 'dsh-pleading-draft'

配置

| 键 | 类型 | 默认值 | 说明 |
| rulesFile | string | rules/pleading-draft.yaml | 规则包路径，相对于包根目录 |
| disabledRules | string[] | [] | 停止运行的规则 id；每个都会出现在 skipped 中 |
| onlyRules | string[] | [] | 只运行这些规则 id；留空则运行全部规则 |
| skipNotes | string | "" | 附加到每条 skipped 原因后的备注 |
| timeoutMs | number | 120000 | 协作式工具超时预算 |

规则级参数值得了解：

- PL-004 conditionField / requiredFields —— 哪一列触发期限要求；默认是金额列，要求写明履行期限。
- PL-005 fields —— 必须存在的表头字段；默认是原告与被告。如果你的清单把法院和案由记在表头，就加上 court 和 cause。
- PL-007 terms —— 要查找的占位符。

材料格式

工具接受 JSON 或 YAML：

caseNo: （2026）某民初 1234 号 court: 某某人民法院 plaintiff: 原告某某公司 defendant: 被告某某公司 cause: 买卖合同纠纷 rows:
- { 序号: '1', 请求要素: 本金给付请求,
诉讼请求: 判令被告支付货款本金人民币 1,250,000 元, 事实依据: 双方于 2025 年 3 月 10 日签订买卖合同，原告已按约交付货物，被告未按期付款, 证据: 证1、证2、证3, 法律依据: 《中华人民共和国民法典》第五百七十七条, 金额: '1250000', 期限: 本判决生效之日起十日内 }

列名匹配不区分大小写，并忽略空格、下划线和连字符；清单自己的列名会保留，所以每条发现都会写明它读取的是哪一列。

规则来源

规则数据放在 rules/pleading-draft.yaml。规则包头部完整说明了引用缺口，每条规则的 note 会重复与该规则相关的那部分。加载时的守卫通常强制「摘录必须是至少八个字符的真实引用」，但它分不清引用和描述——所以这个规则包依赖头部、每条规则的 note，以及一个断言每个 excerpt 都承认该缺口的测试。

故障排查

- PL-003 在我明知已被废止的条文上通过了。 它查不了这个：它只验证法律依据是否被写明，不验证它是否存在或是否适用。条文检索按设计不在范围内。
- PL-002 在证据什么都证明不了的情况下通过了。 原因相同：它检查证据是否被指向，不检查是否充分。
- PL-004 在确认之诉上不触发。 这是有意为之——只有写明金额时才要求期限。
- PL-007 在诉讼请求含糊时不触发。 它抓的是占位符（【】、待填、TBD），不是表述不精确。
- 插件装上了，但工具始终不出现。 检查 main 是否指向 lib/index.mjs，并且
- pnpm run build 生成了它；main 写错会让加载器静默跳过入口。
- dsh plugin add 拒绝该包，报不兼容。 peer 范围覆盖 0.1.x 和 0.2.x；如果你的运行时不在这个范围内，显式授予豁免： dsh plugin --profile <name> allow-version dsh-pleading-draft@0.1.0 --dsh-version <runtime> --accept-risk
- check 报告 manifest-peers 失败。 静态检查器比对的是硬编码的 peer 范围，早于 0.2 系列。运行时在安装时强制校验 peer 兼容性，所以声明的范围才是正确的；这是 dsh-plugin-dev 中的已知上游问题。

开发

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # vitest, the shared table-plugin suite plus paired fixtures
pnpm run build # tsdown -> lib/index.mjs + lib/index.d.mts
node ../scripts/sync-shared.mjs dsh-pleading-draft # refresh src/shared from ../_shared

插件是纯数据的：src/model.ts 声明表结构，共享套件提供读取器和检查引擎，规则包声明每一项检查。

许可证

Apache License 2.0 © 2026 dsh-pleading-draft contributors。