前言¶
在 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 目錄頁。
