前言¶
在 DSH 裏做法律相關智能體或輔助工具時，常見做法是：把法規 PDF/Word 丟給通用 RAG，或依賴在線法條 API。前者往往只能做到「整篇文檔」粒度，效力級別、條號引用和篩選維度不好控；後者則涉及語料出境與賬號依賴。若你希望語料全程留在本機、檢索到單條條文、並在同一界面裏完成閱讀、文書模板與若干 AI 輔助，社區插件 lawkb-ui（倉庫 Iambatman1928/dsh-lawkb-ui）提供的是一條「客戶端 + 本地索引」路徑。下面介紹它是什麼、能做什麼，以及如何安裝與入庫。
這是什麼¶
lawkb-ui 是面向法律檢索的 DSH 客戶端插件（維護者：Iambatman1928），定位是「法律知識庫工作臺」：讀取你機器上的法規 .doc / .docx，建成條文級檢索庫，並提供關鍵詞、統計語義、向量語義三種檢索（可 RRF 融合）、雙維度篩選、大綱與條文閱讀，以及案名索引、民事案由樹、文書編輯器與「引用覈驗 / 合同審查 / AI 分析 / AI 文書生成」四件套。
插件在 package.json 中聲明爲 Web 客戶端（dsh.client.platform: web），依賴宿主 Cordis（@deepseek-ai/cordis ^4.0.4），運行環境要求 Node.js ≥ 20、DSH ≥ 0.1.0-rc.1。許可證爲 MIT（© 2026 Iambatman1928）。社區目錄頁：https://www.skillhub.cn/plugins/Iambatman1928/dsh-lawkb-ui；源碼與說明：https://github.com/Iambatman1928/dsh-lawkb-ui。
說明：README 明確標註本插件是檢索與寫作輔助工具，不構成法律意見；AI 生成內容須由使用者自行復核。
核心功能¶
本地語料與條文級索引¶
- 直讀本地語料：解析
.doc/.docx（Word 二進制 / OOXML / 僞 HTML / RTF 等多策略），全程離線，語料不外傳。 - 條文級檢索：按「一條條文 / 一段文章」切塊建索引；子串匹配結合效力級別先驗與命中條文數打分。
三種檢索與融合¶
- 關鍵詞：子串匹配。
- 統計語義：IDF、概念共現、法條引用圖。
- 向量語義：本地嵌入模型 bge-small-zh-v1.5。
三路結果可做 RRF 融合，並逐條標註來源。向量檢索首次使用會自動下載嵌入模型（約 23 MB，默認從 huggingface.co 拉取；無法直連時可設 HF_ENDPOINT=https://hf-mirror.com），之後可離線使用。
篩選、索引樹與文書¶
- 雙維度篩選：效力級別、制定機關、時效性、公佈年份、數據源等；計數時剔除自身維度。
- 知識索引樹：刑事罪名樹（刑法括注 + 補充規定）、民事案由樹（《民事案件案由規定》）。
- 文書編輯器：9 種文書模板 + 常用條文庫；純模板渲染（非 AI），條文實時從庫內現行有效原文取用。
AI 四件套¶
| 能力 | 說明 |
|---|---|
| 引用覈驗 | 純本地 |
| 合同審查 | 純本地規則 |
| AI 分析 | 先檢索 → 模型僅依據條文 → 回驗條號 |
| AI 文書生成 | 模型走宿主 llm 服務 |
安裝與啓用¶
在 DSH 環境中執行官方安裝命令：
dsh plugin add github:Iambatman1928/dsh-lawkb-ui
裝完後重啓 DSH。插件通過 cordis.patch.yml 注入 Cordis 補丁，無需單獨 git clone 倉庫。
數據目錄與典型用法¶
數據落盤位置¶
索引、抽取緩存、草稿、導出等默認在 ~/lawkb/。優先級爲：
cordis.patch.yml中的config.dataRoot- 環境變量
LAWKB_DATA_ROOT - 默認
~/lawkb/
入庫流程¶
經過上面的安裝步驟後，典型用法如下：
- 在插件「數據管理」中登記語料根目錄（一個包含
.doc/.docx法規文件的目錄）。 - 執行入庫；建索引在後臺運行，可查看進度。
- 向量索引支持中斷後續跑。
- 在檢索界面使用關鍵詞 / 語義 / 向量或融合模式，配合雙維度篩選閱讀條文；按需使用文書編輯器或 AI 四件套（需宿主已配置
llm的部分能力）。
README 未給出更細的 UI 逐步截圖或 API 示例；實際操作以安裝後的客戶端界面與倉庫 README 爲準。
適用場景與注意¶
適合誰
- 需要在 DSH 生態內做離線或本機優先的中國法規範檢索、寫作輔助的智能體開發者或法務相關工具搭建者。
- 已有大量 Word 格式法規語料、希望條文級命中與效力維度篩選，而不是整文檔 chunk 的場景。
運行與安全
- 插件以當前 DSH 進程權限運行，可讀寫你登記的語料目錄與
~/lawkb/（或自定義 dataRoot）。安裝前建議在 GitHub 查看源碼與 MIT 許可證，確認符合你的合規要求。 - 分類上屬於 客戶端 插件；與 SkillHub 等社區目錄的展示一致，社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
- 勿將插件輸出當作正式法律意見；涉及對外文書或決策前須人工複覈。
結尾¶
lawkb-ui 把「本地 Word 法規 → 條文級三路檢索 → 閱讀 / 模板 / 本地規則 + 宿主 LLM 輔助」收進一個 DSH Web 客戶端插件，適合重視語料不出機、檢索粒度到條文的用法。當前版本 0.1.0，倉庫星標以 GitHub 頁面爲準。
- 社區目錄：https://www.skillhub.cn/plugins/Iambatman1928/dsh-lawkb-ui
- GitHub：https://github.com/Iambatman1928/dsh-lawkb-ui
