可追溯的法律信息检索、合同审查与文书辅助原型
A traceable legal-information, contract-review, and document-assistance prototype
简体中文 · English · 在线法条浏览 / Pages · 安全政策 · 贡献指南 · 更新记录 · v1.1.0-rc.1 预发布
首页 · 浅色 Light · 首页 · 深色 Dark
▲ 首页 · 专业律师视图（浅色 / 深色），采集于 2026-09-09
Important
LegalHigh 坚持「检索、引用绑定、人工核验、审计留痕」的受控工作流。它不是律师，不提供法律意见，也不保证任何案件结果；高风险产出必须由具备相应资格的人在平台外独立复核。当前仓库是仍在验收中的本地优先原型，未完成备案或生产部署。
LegalHigh follows a controlled retrieval, citation-binding, human-review, and audit workflow. It is not a lawyer, does not provide legal advice, and makes no outcome guarantee. High-risk outputs require independent review outside the platform. This is a local-first prototype under active verification.
四条主链路全部本地可复现；GIF 于 2026-09-09 在隔离临时数据库的真实前后端上录制，未剪辑出关键结果态。
① 法条检索 → 引用卡片：跨 109 部受控语料（10,751 条条文条目）的 BM25 检索，每条结果带来源、时效与证据等级；摘要只显示程序统计，不调用生成模型。
② 事实与证据梳理 · ③ 请求权要件检查
左：公众入口的六步向导：只依据使用者陈述检索可回溯来源，输出「候选问题方向」与待补材料，未知明确标未知；右：使用者二次明确选择方向后运行的无状态检查：逐项回链原文片段与现行条文，只报告「文本中发现线索/未见线索」。
④ 合同规则审查 · 外观与动效
左：本地规则扫描费用、账户与责任条款：16 个审查点 → Risk Inspector 批注状态机 → DOCX 修订稿导出；右：界面遵循系统浅色/深色与减少动态效果设置；弹簧动效、对比度、焦点环均纳入 QA 门禁。
AI 插件默认关闭：仅在用户明确配置并授权后调用受控远程端点，且全部输出经过红线、引用绑定与审计三道 gate。详见中文说明或 English documentation。
三个本机使用视图（公众 / 法学学习者 / 专业使用者）按用途展示不同工具集；直接输入受限路由地址会被视图门拦截。
事实与证据梳理 · 法律检索 · 法条详情（证据字段）
案例检索（来源+证据等级） · 合同审查 · 专业工作台
展开 12 张补充截图（研究 / 学习 / 起草 / 审计 · 深色 · 窄屏 390×844）
法律研究 · 跨法域对比 · 学习中心（法学学习者视图）
文书起草 · 数据与证据来源 · 历史记录与操作审计
首页（深色） · 检索结果（深色） · 专业工作台（深色）
窄屏 · 首页 · 窄屏 · 检索结果 · 窄屏 · 法条详情
要求：Python 3.12、Node.js 22、npm。完整步骤（含桌面壳、质量门、升级与回退）见中文说明 / English docs。
# ① 后端（先构建受控语料，再启动 API）
cd server && python -m venv .venv
.venv/bin/python -m pip install --require-hashes -r requirements-dev.lock # Windows: .venv\Scripts\python.exe
.venv/bin/python build_corpus.py
.venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8000
# ② 前端（Vite 把 /api 代理到 127.0.0.1:8000）
cd web && npm ci && npm run devNote
不要把开发服务绑定到公网地址。敏感接口需要 ≥32 字符的 LH_ADMIN_TOKEN（请求头 X-LegalHigh-Admin-Token），缺省时按 503 fail-closed 处理。
| 入口 / Entry | 内容 / Available |
|---|---|
| GitHub Pages | 静态法条浏览与产品说明。无后端、无在线 AI、无合同或案件材料上传服务。 / Static statute browsing and product information; no backend or AI service. |
| 源码预发布 / Source prerelease | 本机运行完整工作流；包含源码、静态站点 ZIP 和 SHA-256。 / Run the full workflow locally; source, static-site ZIP and SHA-256 checksums. |
| 桌面候选包 / Desktop candidates | 三平台安装、签名与升级验收尚未完成，本次不附桌面安装器。 / Install, signature and upgrade verification are incomplete; no installers in this release. |
本次版本为 v1.1.0-rc.1（预发布），已记录的本地验收为 182 项后端测试、48 路由浏览器巡检及 1 项专业解读页定向巡检；以链接中的具体断言和日期为准，不代表法律正确率。（该口径为 rc.1 发布时点；主干此后持续演进，当前实测数字见下方质量表。）旧 v1.0.0 安装包不包含此后修复。
核心公开链路是六步「事实与证据梳理」：使用者自己记录起因、经过、结果、人员、材料和问题，系统仅据此检索可回溯来源并给出有事实依据的候选方向；未知就明确标未知，不自动判案。首次使用必须在普通民众、法学学生和专业律师三种本机视图中自行选择（不采集姓名、不是资格认证）；法条与案例检索对三类视图始终开放，合同、文书与专业工作台仅在专业律师视图出现。
产品功能：首页诉讼时效计算器（输入权利受损日期→三年时效截止日+剩余天数，民法典188/196条确定性计算）；法律知识测评 /quiz（215 张术语卡生成选择题，即时反馈+法条深链）；案例对比阅读 /cases/compare（两案例并排比较裁判要点/法条/结果，共有法条自动高亮）；术语卡显示引用案例徽章（N 件案例引用此条文，跳转法条关联案例）；求助准备单支持可读文本导出（.txt 人类可读，非仅 JSON）；搜索结果卡片复制条文+打印快捷操作。
知识导航特性：法条详情页提供双向交叉引用（「本文引用→其他条文」与「其他条文→引用本文」，661 条已验证引用）；搜索框实时匹配 215 张术语卡引导从口语表述（如「定金能退吗」）到法条词面（「定金罚则」）；数据洞察页展示 引用网络力导向图（d3-force，31 部被引法律的共被引关系可视化）；法条与案例页支持打印友好输出（自动隐藏导航、保留证据链与引用来源）；flk native id 映射 106/109 部（证据账本 §19 source_native_id 全覆盖）。
| 门禁 / Gate | 内容 / What it checks |
|---|---|
| 后端测试 / Backend tests | 607 项 pytest（引用绑定、状态机、PIPL 级联、fail-closed、评测单调性、证据账本、重编号映射、robots 红线代码层、laws-md 导出镜像、受控检索组名次锚、时点适用全时间线性质扫描、审查立场契约、建议修订块（w:del）金标与三态观测、租赁/劳动/买卖/物业·建设工程/中介·技术服务/借款·担保/保管·仓储·运输/赠与·委托/合伙·保险/供用电水气热力/行纪类审查点判定表与修订跨度精确断言、数据许可接线、审查 AI 框架审阅四问判分、引号逐字门与导出新鲜度钉子等；2026-10-11 实测） |
| 案例库 / Case library | 281 件可公开核验案例（最高人民法院指导案例 278 件 + 域外经典判例 3 件）；裁判要点与裁判结果逐字出自官方发布页快照并由测试钉住，法条引用经语料逐字核验（2026-09-27 实测） |
| 浏览器巡检 / Route sweeps | 无头 Chrome 逐路由截图 + console/网络零错误门（67 路由，2026-09-29 实测 0 问题） |
| 对比度 / Contrast | WCAG AA 正文 4.5:1 + UI 指示器 3:1（strict 模式） |
| 动效探针 / Motion probes | 弹簧位移、Toast/Dialog 卸载、Reduce Motion 双通道、入场动画不残留 transform（fixed 锚定）、ActionSheet 拖拽跟手·阻尼橡皮筋·阈值关闭·回位等 13 项行为断言（2026-09-29 实测 13/13） |
| 可访问性探针 / A11y probes | WCAG 2.2 AA 子集（24px 目标尺寸 / 焦点不被遮挡；30 路由，2026-09-27 实测 0 违规） |
| 离线探针 / Offline probes | PWA service worker 真断网验收：离线导航/法条/术语可读、恢复在线（7 断言，2026-09-29 实测 7/7） |
| 窄屏扫描 / Narrow sweeps | 390px 逐路由：横向溢出 ≤2px + 页头操作件 ≤3 + 视口自检防假绿（27 路由，2026-09-29 实测 27/27） |
| 第三链文本核验 / Third-chain texts | lawtext（flk DOCX 衍生）快照逐字比对：22 部全一致并锁定复验（corpus_selfcheck 常驻自检，2026-09-24 实测 26 部锁定） |
| QA 证据收据 / QA receipt | server/scripts/qa_receipt.py 聚合四类 QA 工件为带 SHA-256 的分层收据（strict：证据缺失≠通过；run_qa 第 10 门） |
| 发布前核验 / Final verify | server/scripts/final_verify.py 对运行中实例做十项 API 真值断言 |
应用内 质量透明度页 只读公示实时派生指标与带日期历史记录。自动化测试只能证明被覆盖的断言，不能证明系统「绝不出错」；检索评测（金标 548 组，编排层 hit@5 98.0%、法律级 99.3%、rank-1 67.2%、MRR 79.2%（raw 层 96.7%/98.5% 见 /api/evals）；2026-10-12 实测——含确定性重排二代的 IDF 加权覆盖度，全量 A/B 救回 4 例零打落；指标随金标扩容与真实难例自然浮动）衡量的是语料命中率，不是法律正确率。
全语料 markdown 导出（每法一文件+官方元数据）与结构化 laws.json 见 data/laws-md/；数据集发布件由 server/scripts/package_dataset.py 产出（ZIP+SHA256+CC0 LICENSE）。许可（决策 19，2026-09-30 业主裁定）：法条文本不受著作权保护（《著作权法》第五条）；数据整理成果以 CC0 1.0 Universal 发布（全文见 LICENSES/DATA-CC0-1.0.txt）；仓库代码许可另议（未定）。
LegalHigh 的引用绑定法条检索可作为 Model Context Protocol 服务器接入任一 MCP 客户端（Claude、Cursor 等）——零第三方依赖（纯标准库 stdio 传输）：
python server/mcp_server.py九工具：search_articles（BM25 全文检索法条原文）、resolve_citation（法条直查——问句含「法名+条号」时确定性解析定位单条，支持中文数字与之N）、get_article（按 ID+条号取原文与元数据）、list_laws（语料清单）、search_cases（指导案例与域外判例检索）、search_history（历史版本文本独立检索，非现行仅供对照）、get_xrefs（法条双向交叉引用导航，661 条已验证引用关系）、get_amendments（修正决定清单与快照全文——145 条决定「改了什么」的一手文本）、get_predecessor（前身法全文——更名边界法明文废止的前法文本；民法典九前身形态带 idx 逐部选择）。只暴露检索，无任何生成型工具；输出永远为法条原文+元数据+官方来源 URL，并声明「不构成法律意见」。详见 v7 路线图 S2。
REST API：运行 server 后 openapi.json 与 交互文档 自动可用（FastAPI 生成，49 路径）；检索响应与 MCP 同源（引用绑定+免责声明）。
Agent Skill 形态：skills/legalhigh/SKILL.md 把同一能力打包为 Claude Code / Codex 等 Agent 技能——零安装走 Pages 静态导出（llms.txt / laws-md），或克隆后接 MCP；技能内置引用纪律（逐条绑定来源、原文优先、版本敏感、空结果不臆补）。
LegalHigh/
├─ server/ FastAPI 后端：app/ 模块 · build_corpus.py 语料构建 · scripts/ 测试与核验
│ └─ data/laws/ 受控语料（由证据快照构建，禁止手改）
├─ web/ React 19 + react-router 7 前端 · scripts/ QA 工具链
│ └─ public/data/laws.json 语料导出（web/scripts/export_laws.py 唯一路径）
├─ desktop/ 桌面壳（PyInstaller sidecar，候选包待验收）
├─ skills/legalhigh/ Agent Skill 打包（Claude Code/Codex 消费形态：静态导出+MCP+REST 三路径）
├─ docs/
│ ├─ readme/ README 媒体资产（readme_media.mjs 生成）
│ ├─ research/ 调研报告与证据快照 evidence/
│ ├─ compliance/ 备案材料清单与安全扫描记录
│ ├─ standards/qa-evidence/ 质量门证据（截图、报告、终局核验）
│ └─ plan/ 开发计划与决策清单
└─ .githooks/ pre-commit 快门（pytest / build / 数据纪律 / WCAG）
- 不以律师名义执业：律师函等文书走「AI/模板起草 → 使用者本机复核 → 平台外独立复核」；模板中的律所、律师与证号由使用者自行填写，平台不核验。
- 引用不变量：每条断言绑定来源段落；法条引用附版本/生效/效力字段；判例引用附负面历史检查。
- 裁判文书入库前二次脱敏，并提供拒绝/删除通道（PIPL 级联删除 + 审计留痕）。
- 禁止未授权爬取；语料一律来自证据快照，
server/build_corpus.py是唯一构建路径。 - 无证据表明本项目已完成生成式 AI 服务备案、算法备案或律师业务许可；GitHub Pages 工作流只构建静态浏览界面且仅人工触发。
数据与证据纪律、完整安全边界与「不能据此声称的事项」见中文说明 / English documentation。
| 参考 | 借鉴点 |
|---|---|
| LegalBench-RAG / 论文 | 检索与生成分开评测、确定性金标 |
| LawBench | 中英文 README 导航、任务矩阵、弃权率指标 |
| DISC-LawLLM | 中文法律系统检索增强与「不能替代律师」边界 |
| CUAD | 合同审查条款类别与金标思路 |
| CourtListener / docassemble | 项目结构、权利说明与引导式访谈定位 |
仅参考方法与文档结构，未复制其数据或代码；逐项许可核验见中文说明。
本仓库当前未附开源许可证，默认保留全部权利，不能因仓库公开即复制、修改、分发或商业使用；法律文本、裁判文书及第三方材料的权利由其来源决定。详见权利与第三方说明。