前言¶
在 DeepSeek Harness（DSH）里用智能体或模型起草起诉状、代理词、法律意见时，输出往往可读性不错，但引用环节容易出硬伤：仍在引用已废止的旧法、条号超出该法条文总数、司法解释文号已被新解释取代，或案号格式像真案却无法在本地证实。人工逐条对照法规库成本高，联网检索又带来隐私与流程上的顾虑。
下面介绍社区客户端插件 @deepwhale-cn/dsh-legal-cite-check（仓库 feely0208/dsh-legal-cite-check）。它在本地从 Markdown 或纯文本中抽出法条、法释文号与案号引用，对照随包索引标记失效、越界与待人工核验项，并可在 DSH Web 侧栏面板中操作，不联网、不上传、不调用模型。
这是什么¶
插件 npm 包名为 @deepwhale-cn/dsh-legal-cite-check，当前版本 0.1.3（见仓库 package.json），维护者为 feely0208（温州深鲸智能科技有限公司），许可证 MIT。SkillHub 目录分类为客户端，面向 DSH Web 配置（dsh.client.platform: web）。
定位一句话：深鲸引用核验——离线核验法律文书里的法条、司法解释与案号引用；对能查到的失效旧法、越界条号、被取代解释给出明确状态，案号一律标为需人工核验，不把「查不到」说成「没问题」。
它解决什么问题¶
README 归纳的四类常见引用问题中，前三类在索引范围内尽量自动检出：
- 引用已在 2021 年前后废止的《合同法》《婚姻法》《物权法》等旧法；
- 条号大于该法条文总数（例如《民法典》不存在第 1300 条——民法典索引为 1260 条）；
- 继续引用已被新司法解释取代的旧文号（如法释〔2001〕14 号一类对照）；
- 案号形似真实案件，但无法离线证实——插件统一标「需人工核验」，不给出「已通过」的假象。
插件不判断引用是否适用于具体案情，不核验案例内容真伪；结果不构成法律意见，正式提交前仍须承办律师核对 国家法律法规数据库 原文。
核心功能¶
引用抽取与状态¶
从 .md / .txt 中识别《法名》第 N 条、法释文号、案号等，并对每条引用给出状态与级别（节选）：
| 状态 | 级别 | 含义 |
|---|---|---|
OUTDATED |
material | 引用了已废止的法律/解释，应按 replaced_by 改引 |
OUT_OF_RANGE |
material | 条号大于条文总数 |
RENUMBERED / PENDING / UNKNOWN |
warn | 条文重排、尚未生效或索引未收录，需人工核 |
UNVERIFIED |
info | 案号或文号无法离线核验 |
OK |
ok | 法名与条号在索引内（不等于适用于本案） |
命令行退出码：0 表示完成；1 表示使用 --strict 且存在必须处理项；2 表示参数或路径错误。
离线数据¶
随包位于 lib/data/：
statutes-index.json：1,513 部现行/待生效法规，含条文总数（来源 chinese-law-corpus，CC0 1.0，文本取自国家法律法规数据库）；statutes.json：失效对照（含 12 部旧法、4 件旧劳动争议解释等）、条文重排提示、常用简称。
数据为纯 JSON，可自行追加；运行过程不联网。
DSH 面板¶
侧栏「深鲸引用核验」：填写文书或目录路径 → 开始核验 → 展示汇总（OK / 失效 / 越界 / 待核验）、前 20 条问题及产物路径。若后端未注册，面板显示错误提示而非白屏。
边界说明¶
- 仅读
.md/.txt；.docx需先转为文本（包内依赖含 mammoth、unpdf，以仓库实际 CLI 行为为准，README 边界处仍强调 docx 先转文本）。 - 插件在当前 DSH 进程权限下读取你指定的路径；安装前请自行审阅 GitHub 源码 与 MIT 许可证。
安装与启用¶
官方安装命令（来自 README，勿自行拼接 github:owner/repo）：
dsh plugin --profile web add @deepwhale-cn/dsh-legal-cite-check
环境要求（package.json）：Node >=18，DSH >=0.1.0-rc.6 且 <0.3.0。
典型用法¶
安装后可在终端使用命令 dsh-legal-cite-check。下列示例均来自 README。
核验单个文书：
dsh-legal-cite-check 起诉状.md
递归核验整个目录，并在存在必须处理项时以非零退出码结束（配合 --strict）：
dsh-legal-cite-check ./案件材料 --strict
输出机器可读结果并指定目录：
dsh-legal-cite-check 起诉状.md --json --out ./核验结果
查看内置样例：
dsh-legal-cite-check --demo
产物包括：citations.csv（UTF-8 BOM，便于 Excel 打开）、citations.md（汇总、必须处理、待核验与明细）。
仓库内测试：
bash tests/run.sh
适用场景与注意¶
适合在 DSH 工作流中发出或归档前对 AI 或模板生成的法律文书做引用 hygiene：快速筛掉废止法、越界条号与明显过时的司法解释引用，把案号集中到「待人工核验」列表。
务必记住：OK 只表示法名与条号在随包索引中存在，不代表该条适用于本案；案号与部分 warn 状态必须人工跟进。社区目录 SkillHub 插件页 与 GitHub 仓库相互独立维护，与 DeepSeek / 幻方无官方从属关系；星标与版本以你安装时 npm 包与仓库为准。
结尾¶
@deepwhale-cn/dsh-legal-cite-check 把「法条是否存在、是否已失效、条号是否越界」做成可重复的离线步骤，并接入 DSH Web 面板，减少法律文书里低级的引用硬伤。需要细节时直接查阅 GitHub README 与 SkillHub 目录页。
