法治检索 zaxx2006/dsh-legal

DSH 法治检索插件

第一版测试包，目标 DSH 0.2.1-rc.2、Node.js 22 及以上。所有结果来自官网，不使用模型记忆补写法条或案号。

已实现：国家法律法规数据库的法规版本与条文检索，以及人民法院案例库、中国裁判文书网的登录后案例检索。三个站点均已完成 Windows 本机实测；两个案例网站的登录状态分别检查，网站要求验证时由用户自行完成。

下载

- 下载 v0.1.0-beta.1 安装包
- 查看版本说明与校验文件

下载安装包后，按下文在 DSH 插件页安装。无需下载整个源码仓库。

本地运行

在本目录打开 PowerShell：

npm install
npm run setup:browser
npm run cli -- law "中华人民共和国国防动员法" "第一条"

法条检索直接连接国家法律法规数据库，读取版本元数据并下载官方原始 DOCX，解析章节和完整条文。默认取现行有效版本。输出保留官方详情链接；下载、解析或网络失败会报错，不会伪装成查无结果。

用户输入简称或主题时，工具可能先返回候选法规；确认完整名称后再检索条文。scope: "text" 用于法规正文检索；keyword 用于已定位法规内的条文筛选。未指定条号时默认展示前 5 条，并明确标注是否仍有未展示条文。

案例账号登录

npm run cli -- login
npm run cli -- case "建设工程" case_library
npm run cli -- case "郭庆梓" wenshu

在打开的专用浏览器中自行登录中国裁判文书网和人民法院案例库，完成网站要求的验证。登录后在终端按回车保存并关闭，或直接关闭该浏览器窗口。无需把密码、验证码或 Cookie 交给模型。

专用浏览器位于当前用户目录的 .dsh-legal/browser，插件每 5 秒把 Cookie、localStorage 和 sessionStorage 保存到 .dsh-legal/auth-state.json；主动关闭时也会先保存。不在项目目录或发布包内。不要分享或提交整个 .dsh-legal 目录，其中包含可用于登录的凭据。同一目录不能被多个插件进程同时打开。网站仍可能主动使会话过期，此时需要重新登录。

安装到 DSH

桌面版在应用内安装：

1. 打开侧栏的 插件 → 添加插件。
2. 输入安装包保存后的绝对路径，例如 C:\DSHPlugins\dsh-legal-0.1.0-beta.1.tgz。
3. 选择 安装，成功后选择 立即启用。界面提示需要重启时再重启。

普通 npm 版 DSH CLI 不能管理桌面版独占的 desktop 配置。不要用 npx ... plugin --profile desktop add ... 安装桌面插件，也不要手工改写桌面 profile 来绕过此限制。

Web 版可在包所在目录运行：

npx @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web add ./dsh-legal-0.1.0-beta.1.tgz

启用后在新会话输入：

使用 legal_search_laws，查询《中华人民共和国国防动员法》第一条。保留原文、时效状态与官网链接。

案例库检索示例：

使用 legal_search_cases，从人民法院案例库查询建设工程相关案例，返回案件名称、案号和官网链接。

安装前请运行 npm test；打包前使用 npm pack --dry-run 检查文件。当前为预发布测试版本，兼容范围固定为已经验证的 DSH 版本。

在其他电脑安装

在另一台电脑下载上述 Release 的 .tgz 文件。在该机器 DSH 桌面版的 插件 → 添加插件 中填写保存后的包绝对路径，安装并启用。

首次案例检索前，准备浏览器：

npx playwright@1.64.1 install chromium

按照应用提示决定是否重启。案例检索需要使用者在自己的官网账号下登录，不复制开发者的账号或登录文件。当前验证平台为 Windows；其他系统仍需各自验证浏览器运行环境。暂未发布公共 npm 包。Web 版按上文的 --profile web 命令安装，随后使用 dsh web 启动。

已验证范围

- 16 项自动测试，涵盖法条解析、查无结果与网络错误区分、会话恢复、文书列表与详情的交叉核验、登录失效及取消操作。
- 法条实测：《中华人民共和国国防动员法》第一条；尚未生效版本的条文和施行日期。
- 案例库实测：“建设工程”，读取指导案例 171 号等案例的详情，并区分案号与入库编号。
- 文书网实测：“郭庆梓”，返回“泰州市晨磊机电安装有限公司、吴天云等建设工程分包合同纠纷民事二审民事判决书”，案号“（2022）鄂01民终16720号”，并核对正文代理人信息。
- 真实 DSH 运行时中已注册 legal_search_laws、legal_search_cases、legal_open_login 三个工具。

一次案例检索默认仅展示每个来源前 3 条，最多 5 条，不能作为完整案件清单。文书网还会核对检索词是否出现在详情正文或案名中；较长句子请先提炼为姓名、案由、案号等关键词。

结果规则

- 查询成功且数据库确实返回零结果时，输出“国家法律法规数据库中不存在对应法律法规”。
- 法律存在但指定条文未找到时，明确说明条文未找到。
- 原文没有章号时不虚构章号；有编、章、节时保留实际层级。
- 分别标注有效、尚未生效、已修改、已废止；未来版本保留官网施行日期。
- 案例必须核对官网详情中的名称、案号、链接；入库编号不等于裁判案号。
- 登录过期、验证码、网站异常、结果截断均不能作为案件不存在的依据。

官方参考

- DSH 打包与安装
- DSH 工具编写
- 国家法律法规数据库
- 中国裁判文书网
- 人民法院案例库

法规站点用的是官网当前实际调用的接口，网站升级时可能需要维护适配。插件还没发布到 npm。