lawkb-ui

Readme

# lawkb-ui · 法律知识库工作台

面向法律检索的本地 DSH 插件：把你机器上的法规 `.doc/.docx` 语料建成**条文级**检索库，提供关键词 / 统计语义 / 向量语义三种检索与 RRF 融合、双维度筛选、大纲与条文级阅读，并内置案名索引、民事案由树、文书编辑器，以及「引用核验 / 合同审查 / AI 分析 / AI 文书生成」四件套。

> ⚠️ 本插件是**检索与写作辅助工具，不构成法律意见**。AI 生成的内容须由使用者自行复核。

## 特性

- **直读本地语料**：直接解析 `.doc/.docx`（Word 二进制 / OOXML / 伪 HTML / RTF 多策略嗅探），全程离线，语料不外传。
- **条文级检索**：按「一条条文 / 一段文章」切块建索引；子串匹配 + 效力级别先验 + 命中条文数打分。
- **三种检索 + RRF 融合**：关键词（子串）、统计语义（IDF + 概念共现 + 法条引用图）、向量语义（本地 bge-small-zh-v1.5 嵌入），可三路融合并逐条标注来源。
- **双维度筛选**：效力级别 / 制定机关 / 时效性 / 公布年份 / 数据源，计数剔除自身维度。
- **知识索引树**：刑事罪名树（刑法括注 + 补充规定）、民事案由树（《民事案件案由规定》）。
- **文书编辑器**：9 种文书模板 + 常用条文库，纯模板渲染（非 AI），条文实时取库内现行有效原文。
- **AI 四件套**：引用核验（纯本地）、合同审查（纯本地规则）、AI 分析（先检索 → 模型只依据条文 → 回验条号）、AI 文书生成；模型走宿主 `llm` 服务。

## 安装

```bash
dsh plugin add github:Iambatman1928/dsh-lawkb-ui
```

装完重启 DSH。向量检索首次使用会自动下载本地嵌入模型（bge-small-zh-v1.5，约 23 MB，默认从 huggingface.co 拉取；无法直连时设 `HF_ENDPOINT=https://hf-mirror.com`），之后全程离线。

## 数据目录与语料

- 插件数据（索引 / 抽取缓存 / 草稿 / 导出）默认落在 `~/lawkb/`。
  优先级：`cordis.patch.yml` 的 `config.dataRoot` > 环境变量 `LAWKB_DATA_ROOT` > 默认值。
- 安装后先在「数据管理」里登记你的语料根目录（一个含 `.doc/.docx` 法规文本的目录），再执行入库。
  入库 / 建索引为后台任务，进度可查；向量索引可中断续跑。

## 许可证

MIT © 2026 Iambatman1928