法律研究工作流 kingselyjoe/legal-research-dsh

legal-research-dsh

面向 DeepSeek Harness 的法律研究与法学论文工作流。

它会告诉你现在做到哪一步、这一步为什么要做、怎样算完成，以及接下来最该处理什么。

version DeepSeek Harness Agent Skills license tests

围绕 DeepSeek Harness 设计，也能由支持 Agent Skills 的工具读取。

legal-research-dsh 由龙瑾的工具箱维护。这个项目把法源检索、原文核验、论点证据链、论文写作、引注审查和最终交付放进同一个可恢复的研究目录。研究中断以后，已经确认的来源和判断仍然保留，下一次可以从原来的位置继续。

快速安装 · 能力一览 · 研究流程 · 使用说明 · 版本区别 · 联系维护者

legal-research-dsh 六阶段研究流程

它解决什么问题

做法律研究时，找到一段文字只是开头。材料越来越多以后，很容易说不清这条法源是否核过原文、这个结论由什么支撑、反方材料放在哪里、论文写到哪一步，以及哪些问题会挡住最终交付。

legal-research-dsh 会把这些工作拆成六个主阶段。每次开始先交代当前步骤和完成标准，处理完再说明实际结果、它对论文有什么作用、还留下什么风险。内部编号和 JSON 继续存在，但它们留给 Agent 和自动化脚本，普通使用者看到的是可以读懂的中文说明。

它适合法学论文、文献综述、法律备忘录和裁判文书实证研究。它提供研究过程和证据管理，不提供针对个人案件的法律意见。

快速安装

交给 DSH 安装

把下面这句话发给你的 DSH。

~~~text
请安装这个法律研究 Skill https://github.com/kingselyjoe/legal-research-dsh 安装完成后检查 legal-research 命令和十个 Skill 是否可用

在 Windows 手动安装

~~~powershell
git clone https://github.com/kingselyjoe/legal-research-dsh.git
cd legal-research-dsh
.\install-dsh.ps1

在 macOS 或 Linux 手动安装

~~~bash
git clone https://github.com/kingselyjoe/legal-research-dsh.git
cd legal-research-dsh
./install-dsh.sh

需要 Python 3.10 或更新版本。安装器会安装 legal-research 命令，并把十个模块复制到 ${DSH_HOME}/skills。没有设置 DSH_HOME 时使用 ~/.dsh/skills。

装好以后可以直接这样说。

~~~text
使用 legal-research 帮我建立一个法学论文项目。
题目是“平台算法解释义务研究”，法域是中国大陆，采用中引法。
从研究设定开始，每一步先告诉我正在处理什么、为什么要做、怎样算完成。

继续已有项目时这样说。

~~~text
继续我的法律研究项目。
先说明目前在第几个阶段、已经有哪些材料、当前风险和唯一的下一步。
不要给我看 JSON 或内部命令。

当前版本为 0.5.0。

能力一览

| 能力 | 实际得到的结果 |
| 研究过程看得懂 | 六阶段路线、当前步骤、完成标准、已有材料和一个建议动作 |
| 来源能够回到原文 | 法条、案例、论文、专著和数据集的来源台账与核验状态 |
| 论点能够找到证据 | 每个可争议命题与支持材料、反方材料、背景材料的精确连接 |
| 引注问题提前暴露 | 中引法、Bluebook、OSCOLA、AGLC 和 McGill 的核验流程 |
| 论文保留作者判断 | 核心命题、规范立场、最强反方和研究局限的作者确认记录 |
| 机械表达可以复查 | TXT、Markdown 和 DOCX 的表面机械化表达提示 |
| 裁判文书可以批量整理 | 文书批量导入、SHA-256 去重、语料台账和实证研究流程 |
| 交付前有严格审计 | 缺失来源、未核验材料、孤立论点、缺少精确位置等阻断项 |
| 研究结果可以导出 | Markdown 与 DOCX 证据台账报告 |
| 授权数据库可以接入 | 北大法宝 MCP 模板、官方 CLI 结果导入、标准化和来源追溯 |

研究流程

legal-research-dsh 按六个主阶段推进一项研究。

1. 研究设定　固定问题、法域、研究期限、研究类型和暂定核心命题。
2. 来源检索与核验　收集法条、案例、论文和反方材料，随后回到原文核对。
3. 论点与证据链　把正文判断拆成可验证命题，并连接支持、反方和背景证据。
4. 提纲与正文　先按证据地图搭提纲，再形成能够回到来源的初稿。
5. 作者确认与审查　确认作者立场、最强反方、研究局限、引注和表达问题。
6. 导出与交付　严格审计通过以后生成文件，再做最后一次人工核对。

数据库接入、引注核验、作者性审查和实证研究属于主阶段中的专业子步骤。任何一步失败，项目都会保留已经核验的来源和现有成果，只重做当前没有完成的部分。

你会看到什么

DSH 开始处理以前会先给出这样的说明。

~~~text
当前进度｜阶段 2/6 · 原文核验这一步在做什么｜核对来源身份、效力状态和原文位置为什么现在做｜未核验的检索结果不能直接支撑论文结论完成标准｜关键来源都有原文地址和明确核验状态

处理完成以后会给出一张结果卡。
~~~text
本步结果｜已登记 8 个来源，其中 5 个已核验原文对论文的作用｜可以支撑两个核心论点需要注意｜另有一项效力状态待确认下一步｜把核心命题拆成可分别证明的论点

S0001 代表来源编号，C0001 代表论点编号，E0001 代表证据连接编号。Skill 会在这些编号第一次出现时解释用途，不要求使用者自己理解数据结构。

完整使用说明

随时查看研究进度

终端默认输出中文说明。

~~~bash
legal-research --workspace ./research guide

它会显示完整路线、当前步骤、完成标准、材料数量和一个建议操作。--json 专供 DSH 与脚本读取，普通使用时不用添加。

手动建立一个项目

~~~bash
legal-research --workspace ./research init \
--title "平台算法解释义务研究" \
--jurisdiction "中国大陆" \
--research-type law-review \
--citation-style "中引法" \
--thesis "平台解释义务应根据决策风险采用分层标准"

legal-research --workspace ./research guide

手动维护研究台账

通常由 DSH 根据研究进展执行这些命令。需要排错或批量处理时也可以手动运行。

~~~bash
legal-research --workspace ./research source add \
--type law --title "示例法律" --locator "https://example.invalid/law" \
--jurisdiction "中国大陆" --authority-level primary --verified

legal-research --workspace ./research claim add \
--text "高风险自动化决策需要更强的说明义务" --section "第三章"

legal-research --workspace ./research evidence add \
--claim C0001 --source S0001 --pinpoint "第X条" --verified

legal-research --workspace ./research audit --strict
legal-research prose audit ./research/artifacts/draft.md
legal-research --workspace ./research render --format docx

示例地址和条文只是演示占位符，不能进入真实研究结论。

接入北大法宝

Community 版可以生成不含真实 Token 的 MCP 配置模板，也可以把用户授权查询后得到的 JSON 结果导入来源台账。

~~~bash
legal-research provider diagnose pkulaw
legal-research provider mcp-config pkulaw --output ./mcp.pkulaw.example.json

legal-research --workspace ./research provider import pkulaw \
./pkulaw-result.json --resource-type auto

导入只证明数据库返回了这条记录。涉及法律结论的材料仍然要回到原文核验。

Community 与 Pro

Community 版永久免费并采用 MIT 许可证。它提供完整的本地研究流程、十个 DSH Skills、来源与证据台账、论文审查、文书导入、北大法宝 MCP 模板和结构化结果导入，而且不限制项目、来源或论文字数。

Pro 是读取同一研究目录的独立扩展。它规划用于授权数据库自动查询、批量任务、断点续跑、调用前预览和来源变化监控。数据库账号、Token、积分和订阅仍由使用者直接向数据提供方购买。

完整边界见 EDITIONS.md。停止使用 Pro 不会影响 Community 打开、审计和导出原有项目。

项目结构

~~~text
dsh/ DSH 集合清单 skills/ 十个 Agent Skill src/legal_research_dsh/ CLI 与研究数据层 media/ 项目展示图与联系二维码 scripts/dsh_manager.py 安装、检查和卸载 tests/ 单元和集成测试

每项研究使用自己的 workspace。来源、论点和证据分别保存为 JSONL，适合版本控制、增量恢复和外部数据分析。

使用边界

- 项目不提供法律意见，也不替代律师、导师、编辑和人工来源核验。
- 项目不内置商业数据库凭据，也不绕过登录、付费墙、访问控制和数据库条款。
- Provider 导入不会自动把数据库记录标成已经核验的一手法源。
- 具体引注格式仍以使用者合法取得的规则和目标期刊要求为准。
- render 生成证据台账报告，不会覆盖作者的正式正文。
- prose audit 只报告预设的表面机械表达，不判断作者身份，也不承诺通过任何 AI 检测。

开发验证

~~~bash
python -m unittest discover -s tests -v
python scripts/dsh_manager.py check

当前自动化测试共 21 项。

更新记录

0.5.0

- 新增六阶段进度说明和 guide 命令。
- 默认输出改成面向使用者的中文结果卡。
- 十个 Skill 统一说明步骤目的、完成标准、结果和下一步。
- 空项目与未核验来源不再得到误导性的审计绿灯。
- 加入新的项目首页、研究流程图和维护者联系入口。

完整记录见 CHANGELOG.md。

维护者与交流

龙瑾的工具箱

微信　KleinK21

添加微信时请备注 legal-research-dsh。
安装失败、规则冲突或研究步骤显示不清楚，可以提交 Issue。请附上使用的 Agent、输入指令、输出片段和期望结果。

本项目采用 MIT License。项目不包含第三方数据库内容，也不分发完整引注手册。