前言¶
在 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
