Open Legal Chile

⚖️ Open Legal Chile

智利共和国法律体系的开放式法律智能基础设施、MCP 服务与官方连接器

---

📑 目录

1. 🌟 愿景、理念与法律主权
2. 🏗️ 生态系统架构
3. ⚡ 安装与启动
4. 🔌 MCP 工具完整目录（87 个工具）
5. 🏛️ 智利国家的 10 个官方连接器
6. 📚 正典学术数据库与法证程序维度
7. ⚖️ 专业法证与教学模块
8. 🧠 Skills 与子 Agent 目录（18 个专业领域）
9. 💻 CLI 控制台完整指南（openlegal）
10. 🛡️ 360° 机构审计认证（AUDIT.md）
11. 🧪 自动化测试与持续验证
12. 📜 许可证、法证伦理与职业责任
13. 🌱 如何贡献

---

🌟 1. 愿景、理念与法律主权

Open Legal Chile 是一套开源软件基础设施，旨在改变智利共和国的法律实践、大学教学和法证研究。

与依据英美 Common Law 视角设计的通用商业人工智能模型不同，Open Legal Chile 从根基上就是为智利大陆法系（Civil Law）设计的：

🏛️ 智利法律体系的基本原则

• 成文法至上： 法律是主权意志的表达，依照宪法规定的形式表达后，命令、禁止或允许（《民法典》第 1 条）。
• 判决的相对效力： 司法判决仅对其所裁决的案件具有约束力（《民法典》第 3 条第 2 款）。智利不实行英美的约束性判例原则（stare decisis），但最高法院统一判例，以及审计总署（CGR）和劳动局（DT）的行政解释，为法律体系确立了指导标准。
• 绝对禁止使用英语借词和外国法律概念： 严禁将不属于智利诉讼传统的概念移植过来（at-will employment, punitive damages, discovery, subpoena, grand jury, deposition, Title VII, FLSA）。仅使用智利本土的诉讼及实体法术语（企业经营需要、附权利保留条款的离职结算书、劳动特别保护、基本权利保护诉讼、精神损害、直接损失、预期利益损失、另附请求、复议、上诉、形式违法和实体违法的上诉、OJV推定）。
• 强制采用官方引注标准：
  • 法律或法典：[BCN - 《民法典》，第 1545 条] 或 [BCN - 第 21.643 号《Karin 法》，第 2 条]
  • 宪法：[BCN - CPR，第 19 条第 1 项]
  • 最高法院判决：[CS - 案号 12.345-2023，日期：15-11-2023]
  • DT 解释：[DT 解释第 1234/15 号（2024 年）]
  • CGR 解释：[CGR 解释第 E123456 号（2024 年）]
  • SII 通告：[SII 第 45 号通告（2023 年）]
  • CMF 规范：[CMF 第 461 号一般规范]

🛡️ 技术主权与职业保密（$0 且无需 API 密钥）

法律实践要求绝对保密：

1. 100% 免费且自由： 无需商业许可证、付费令牌或信用卡。
2. 零数据泄露（Zero Data Leak）： 本地主权引擎和通过 Ollama 提供的开源模型（llama3.2、deepseek-r1、qwen2.5）会在你自己的计算机上以 100% 本地方式处理案件、合同和司法保密文书，保护职业秘密（《刑法典》第 247 条）以及《第 19.628 号私人生活保护法》。
3. 公开访问国家来源： 与 BCN、CGR、DT、PJUD、CNE、CMF、SII、SMA 和 TDLC 的连接均访问智利国家开放的公共存储库，无需注册或付费密钥。

🎨 法律设计（Legal Design）

Open Legal Chile 采用 Legal Design Manifesto（Ducato、Haapio、Hagan、Palmirani、Passera 和 Rossi）以及 Stanford Legal Design Lab（Margaret Hagan）工作的原则：法律是为需要使用它的人撰写的，而不是为撰写它的人撰写的。本仓库的 25 条原则及其对应的可验证规则见 docs/legal_design.md；发布技能、工具或文档前用于检查的简短清单见 docs/legal_design_checklist.md。

以下是这里如何应用这些原则的两个具体示例：

• 18 项技能均设有人为审核关卡。 .agents/skills/ 中的每个 SKILL.md 都会说明面向谁撰写、输出形式如何，以及审核关卡是什么；没有任何一项承诺提供「可直接提交」的成果。可运行 .venv/bin/python -m pytest tests/test_legal_design.py -q 进行验证。
• 清晰易懂的语言，不止于宣称，更落实于实践。 法律诊所将裁决翻译成通俗西班牙语：clinica_juridica.py 会把「téngase presente」转换为「法庭已阅读您的文件，并将其记录在案件卷宗中」。同一规则——首次出现技术术语时，在括号中附上其通俗说法——适用于所有供人阅读的文本。

---

🏗️ 2. 生态系统架构

该套件遵循国际标准 Model Context Protocol（MCP），使任何 Agent 或环境都能与智利法律基础设施交互：

┌─────────────────────────────────────────────────────────────────────────────────────────┐
│                           CLIENTES Y AGENTES DE IA SOPORTADOS                           │
│                                                                                         │
│   Google Antigravity      Claude Code (CLI)      Claude Desktop      Cursor / VS Code   │
│   (Google AI Pro)         (Anthropic)            (Cowork)            (Codex / Roo Code) │
└────────────────────────────────────────┬────────────────────────────────────────────────┘
                                         │ JSON-RPC 2.0 (stdio)
┌────────────────────────────────────────▼────────────────────────────────────────────────┐
│                       SERVIDOR MAESTRO MCP (mcp_server.py)                              │
│                                                                                         │
│   • 87 Herramientas Forenses Registradas (Suite Edition)                         │
│   • Espacios de Casos Locales con LegalGraphify (case_workspace.py, case_graph.py)     │
│   • Motor Vectorial Híbrido Dense + BM25 con RRF (vector_engine.py)                     │
│   • Motor de Agentes Jurídicos Autónomos Soberanos (agents_runtime.py)                  │
│   • Generador Estandarizado de Recursos de Protección OJV (recurso_proteccion.py)       │
│   • Knowledge Graph Jurídico y Ahorro de Tokens (legal_graphify.py)                     │
│   • Telemetría Ética de Adopción y Auto-Actualización (stats_tracker.py, update_checker.py)│
│   • Motor de Estudio de Títulos Decenal CBR (cbr_titles.py)                              │
│   • Auditor de Mandatos Judiciales Art. 7 CPC (cbr_titles.py)                            │
│   • Deconstructor Estructural de Sentencias Art. 170 CPC (sentencias_parser.py)         │
│   • Validador Oficial de RUT y Directorio de Órganos Públicos (entes_publicos.py)       │
│   • Guías Oficiales de la Academia Judicial de Chile (academia_judicial_connector.py)   │
│   • Sincronizador de Biblioteca Online y Datasets Markdown (online_library_sync.py)     │
│   • Motor de Doctrina Canónica FTS5 BM25 (doctrina_connector.py)                        │
│   • Motor de Crítica Forense en 5 Dimensiones (critique.py)                             │
│   • Vigilante de Proveídos y Plazos Fatales OJV (docket_watcher.py)                     │
│   • Simulador Socrático de Examen de Grado (examen_grado.py)                            │
│   • Asistente Social de Clínica Jurídica y Lenguaje Claro (clinica_juridica.py)         │
│   • Módulo de Peritaje OCR y Compilador de Expedientes A4 (pdf_dossier_compiler.py)     │
│   • Modelador de Grafos de Vínculos y Probidad Pública (grafo_vinculos.py)              │
│   • Exportador Forense OJV Ley N° 20.886 (exporters.py)                                 │
└────────────────────────────────────────┬────────────────────────────────────────────────┘
                                         │ Consultas Locales y Red Oficial
┌────────────────────────────────────────▼────────────────────────────────────────────────┐
│                     10 CONECTORES OFICIALES DEL ESTADO DE CHILE                         │
│                                                                                         │
│   [BCN Ley Chile XML]   [Contraloría CGR]   [Dirección del Trabajo DT]  [PJUD / Suprema]│
│   [Tribunal Const.]     [CNE Energía]       [Panel de Expertos]         [CMF Valores]   │
│   [SII Tributario]      [SMA SNIFA Ambient] [TDLC Libre Competencia]                    │
└─────────────────────────────────────────────────────────────────────────────────────────┘

🧩 主权神经符号三元组：LegalOpenJev、LegalGraphify 和 LegalCanvas

Open Legal Chile 实现了一种受认知心理学（Kahneman）和本地优先软件工程启发的双过程架构（Dual-Process Architecture）：

1. ⚡ LegalOpenJev（系统 1 引擎 — 快速思考）：

   • 文件： legal_open_jev.py
   • 延迟： 本地 CPU 上 < 5 ms，100% 离线，零令牌成本，且保密性不可侵犯（Art. 247 CP）。
   • 基本操作：
     • JevChoice：智能分流和路由，将活跃的 MCP 工具目录从 87 个工具缩减至 3-5 个与主题相关的工具（每轮提示词节省超过 12.000 个令牌）。
     • JevNoul：严格的形式有效性二元门控：劳动失效绝对期限（Art. 168 CT：60/90 天）、民事诉讼时效（Arts. 2514-2515 CC）、宪法保护期限（Art. 20 CPR：连续 30 天）、司法工作日诉讼期限计算（Art. 66 CPC）、RUT Módulo 11 数学验证，以及诉讼代理人的特别权限（Art. 7 inc. 2 CPC）。
     • JevScore：超快速的本地主题相关性加权。

2. 🧠 LegalGraphify（知识图谱引擎 — 深度思考）：

   • 文件： legal_graphify.py
   • 拓扑结构： 包含 14.050 个节点和约 20.000 条智利法律关系的多维本体图谱。
   • 实测效率： 上下文缩减 99,9%（合成子图的令牌数中位数为 91，相比完整教义著作的 96.536 个令牌）。
   • 能力： 提取半径为 1 的自我中心子图，通过 PageRank 识别结构性制度（上帝节点），并追踪法律规范与最高法院指导性判决之间的教义推导路径。

3. 🎨 LegalCanvas（可视化仪表板与交付界面引擎）：

   • 文件： legal_canvas.py
   • 理念： 采用高信息密度的交互式仪表板和微型 UI（Thariq Shihipar / Claude Code），生成单个独立 HTML 文件，其中嵌入 CSS 和 SVG，且零外部依赖（无 CDN、无 npm、100% 离线且保密）。
   • 组件： 诉讼封面、交互式 SVG 时间线、风险与失效期限信号灯、带复选框的证据清单，以及带有 点击复制 按钮的官方引文抽屉（[BCN - ...]、[CS - ...]、[Doctrina - ...]）。

---

⚡ 3. 安装与启动

提示

想通过一键或一条命令将 Open Legal Chile 安装为插件吗？
请参阅 PLUGINS.md 中针对 Claude Code、Cursor、VS Code、Cline 和 Smithery.ai 的详细指南。

一条命令安装

pip install openlegal-chile && openlegal instalar

openlegal instalar 会检测当前文件夹中的 harness（Claude Code、Cursor、VS Code、dsh、Codex、 Antigravity），将 MCP 配置与现有配置合并后写入（并创建 .bak 备份），然后通过 openlegal doctor 验证状态。对于 Agent，openlegal instalar --json 会以 JSON 格式返回相同摘要；在 harness 中则可使用工具 suite_instalar。

其他方式——Claude Code 原生插件、Cursor / VS Code / Cline 自动检测、 Smithery.ai、从源代码安装以及 Antigravity 的 mcp_config.json——见 PLUGINS.md。各客户端的详情——以及如何验证 harness 能看到这些工具——见 docs/integracion-harness.md。

此软件包包含教义语料库（7,399 份智利 Markdown 文档：228 份经典条约、讲义、教学材料和司法学院指南，以及 11 本智利科学期刊的 7,170 篇文章），并且已构建好知识图谱，因此 graphify_* 和 doctrina_search 无需克隆其他内容即可运行。教义的 FTS5 索引会在首次搜索时自动构建（几秒钟）。 如果你只安装模块（例如，只复制零散文件），引擎会说明原因，而不是对所有内容都回答“未找到”：这是 1.5.4 之前版本的静默故障。

要读取扫描或拍摄的文档（收据、契约、案卷），无需另外安装任何内容：OCR 已包含在软件包中（RapidOCR）。pip install openlegal-chile 会直接安装稳定可靠的引擎，无需额外组件或命令。Tesseract 作为操作系统级备用方案保留：它适用于清晰扫描件，但无法处理倾斜或低分辨率照片（在两张拍摄的公证收据测试中：Tesseract 在任意旋转角度下均识别出 0 个字符，RapidOCR 则分别识别出 553 和 525 个字符）。提取器始终会报告所用引擎；如果某页未能提取文本，也会发出警告，而不会报告成功。查看已安装的内容：

openlegal doctor

此外，openlegal ocr <documento.pdf> [--contexto "expediente con plazo corriendo"] 会根据智利法律推理，建议如何提取文档：如果文档已有文本层，则使用原生提取；如果是扫描件，则根据类型（案卷、公证契约、旧判决、行政文档、表格）选择引擎和 DPI；涉及期限时还会建议双重处理（CPC 第 66 条）。MCP 中也提供相同建议，工具名称为 ocr_plan_documento。

⚙️ 推理模式：主权模式与外部模型

Open Legal Chile 默认采用主权模式（100% 免费，且不会向境外发送数据）：

• 主权引擎： 自动启用，无需配置密钥。
• 本地 Ollama（可选）： 如果你在 localhost:11434 运行 Ollama，套件会立即检测并使用你的本地模型。
• 商业服务商（可选）： 如果你自愿选择连接付费商业 API，可以在 .env 文件中配置变量：

  # Totalmente opcionales (el sistema funciona al 100% sin ellas)
  ANTHROPIC_API_KEY="sk-ant-..."
  GEMINI_API_KEY="AIzaSy..."
  DEEPSEEK_API_KEY="sk-..."
  OPENAI_API_KEY="sk-..."
  

🌐 Hugging Face 上发布的语料库

整个语料库都位于公开数据集 pablobenavidesj/doctrina-jurisprudencia-chile 中，以 Markdown 格式提供，并包含供 Agent 使用的索引（llms.txt）：

集合	内容	实测数量
学说	专著、笔记和教学材料，全文	228 部作品
法律期刊	RChD UC（1974-2026 年，2 086 篇文章）、RDPUCV（1977-2024 年，868 篇文章）、RDUACh（1990-2026 年，1 011 篇文章）、REHJ PUCV（1976-2025 年，950 篇文章）、RDUCN（1994-2026 年，737 篇文章）、RChDP UDP（2003-2026 年，494 篇文章）、RChDCP UCT（2010-2026 年，316 篇文章）、RDA UChile（2002-2026 年，229 篇文章）、RDUdeC（1933-2026 年，226 篇文章）、RChDT UChile（2012-2026 年，232 篇文章）和 DACC UdeC（2025-2026 年，21 篇文章），OJS/SciELO 格式的 Markdown	7 170 篇文章
AJ 指南	智利司法学院，全文	24 份指南
最高法院	Markdown 条目 + 官方链接（获取全文需要 PJUD 会话）	70 536 条记录
宪法法院	全文	967 份判决
环境法院（1TA/2TA/3TA）	735 份全文 · 151 条记录（其中 1TA 的 111 条：其门户已无法提供 PDF）	886 份判决
环境出版物	公报和年鉴	55 份

总计：7 399 份以 Markdown 结构化的学说和学术期刊文档，以及 25 556 条内容详实的法理记录，并提供快速索引 train_lite.jsonl 和 instituciones_lite.jsonl，便于基于依据进行引用，避免幻觉。

🗺️ 语料库知识地图

数据集还包含一张完整知识地图（数据集自身的 data/mapa/ 目录）： 每个文件对应一行——包括最高法院的 7 万多条记录——并附有规范 ID （cs:10641-2024、tc:2402、ta:3ta:r-21-2021、norma:cc:2314、norma:cpr:19:n3……）、元数据 （职务、日期、法庭、诉讼类型、法官、作者、期刊），以及通过确定性语法提取的正文所引用的法律条文和职务。在此基础上，还构建了 LegalGraphify 连接层：法律条文、作者、期刊、法官、法庭、法院和诉讼类型，以及它们所属的社区。

• 自动更新。 每日运行的 Action mapa-hf.yml 会检查数据集是否有变更，仅重建新增内容（按 blob 增量处理），进行验证，在 HF 上发布，并创建 PR，将 mapa_corpus/puntero.json 指向新的修订版本。
• 始终通过地图查询。 consulta_maestra、huggingface_search_dataset（支持 rol、norma、coleccion 和 entidad）、pjud_search_jurisprudencia、doctrina_search 和 graphify_* 会先查询地图：精确职务、引用某条法律的主体、某位法官或某个法庭的判决，以及不区分重音符号的文本搜索。每条结果都附有固定到来源修订版本的 URL。
• 查询时无需联网。 地图会在后台下载并通过 sha256 校验，存放在 ~/.openlegal/mapa/；openlegal cache mapa 可显示其状态，suite_instalar 会完成准备工作。

格式、引用语法和运行方式的详情见 docs/mapa.md。

每部作品末尾都有一个**“另请参阅”**区块，其中列出测得的关联（引用图谱、共同引用的法律条文和采用该作品的指南）。官方引用格式为 [BCN - Código, Art. N]，并始终附有该条文的原文；图谱详情见 docs/grafo.md，节省的用量测算见 docs/medicion_tokens.md。

---

🔌 4. MCP 工具完整目录（87 个官方工具）

MCP 服务提供 87 个按功能分类的官方工具：

A. 共和国法律与法典

MCP 工具	参数	操作说明
bcn_get_codigo	codigo (str), articulo (str, opc)	在 BCN 查询智利 9 部基础法典（民法典、劳动法典、民事诉讼法典、刑法典、商法典、税法典、矿业法典、水法典、刑事诉讼法典）、《政治宪法》和《卫生法典》的条文或结构。
bcn_get_ley	numero (int), articulo (str, opc)	下载并解析共和国任何法律的官方文本（例如，《21.643 号 Karin 法》、《21.561 号 40 小时法》、《20.886 号 OJV 法》）。此外还会返回包含官方引文括号和原文的 citas 块。
consulta_maestra	consulta (str), limite (int, opc)	所有法律查询的第一步（§2 quater）。 单次调用即可获取 Hugging Face 语料库、权威学说、子图和检测到的法规，并提供每个来源的原文和引文括号，以及无法获取内容的 faltantes 列表。
cita_texto	referencia (str) · referencias (list, opcional)	返回所引法规的原文（“《民法典》第 1438 条”、“《21.643 号法》第 2 条”），并附上官方引文括号和 BCN 链接。使用 referencias 可在单次调用中核验一批引用（每项唯一法规进行一次网络请求；失败项会列入 faltantes）。如果来源无响应，则标记为 sin_fuente_verificable，而非编造条文内容。

B. 判例法与有约束力的裁决

MCP 工具	参数	操作说明
cgr_search_jurisprudencia	query (str)	在共和国总审计署的行政判例中搜索有约束力的裁决。
cgr_search_auditorias	query (str)	查询 CGR 超过 9,600 份审计最终报告及特别调查的目录。
dt_search_doctrina	query (str)	搜索劳动局（DT）有约束力的裁决和劳动法学说，并提供全文链接。
pjud_search_jurisprudencia	query (str), sala (str, opc)	在本地采集的语料库中搜索：最高法院近两年的 70,523 份判决、宪法法院的 966 份判决，以及最高法院／宪法法院的指导性判决；可按案名、事项、诉讼类型、结果和学说搜索。

C. 行业监管与公共机构

MCP 工具	参数	操作说明
cne_get_centrales_y_proyectos	region (str, opc)	查询国家能源委员会 SEA 中运行中的发电站、装机容量和能源项目。
panel_expertos_search	query (str)	在《电力法》专家小组中搜索针对技术和费率争议作出的有约束力且不可上诉的裁决。
cmf_search_normativa	query (str)	查询金融市场委员会（CMF）的一般性规范（NCG）和通告。
sii_search_circulares	query (str)	查询国内税务局（SII）的官方通告和局长指示。
sma_search_sancionatorios	query (str)	查询 SMA 的 SNIFA 中的环境制裁案件和合规计划（PdC）。
tdlc_search_jurisprudencia	query (str)	查询自由竞争保护法庭（TDLC）的判决和裁决。

D. 教义学与法庭程序维度

MCP 工具	参数	操作说明
doctrina_search	query (str), area (str, opc), autor (str, opc), limit (int)	在智利论著（Peñailillo、Ramos Pazos、Barros Bourie、Gamonal、Bermúdez、Cury、Maturana、Cea Egaña）中使用 FTS5 和 BM25 按语义相关性搜索。
doctrina_get_institucion	nombre (str), area (str, opc)	获取完整的教义学与法庭资料卡：规范定义、要件、法庭程序操作、BCN 关联信息和指导性判决。
doctrina_list_obras	(ninguno)	列出所有已编入索引的教义学手册和论著，并显示其制度与令牌统计信息。
doctrina_ingestar_documento	file_path (str), area (str, opc), tratadista (str, opc), obra (str, opc), actualizar_grafo (bool)	将文档（PDF、DOCX、TXT、MD）转换为令牌优化的规范 Markdown（RAE/ASALE 和 BCN/CS），并立即同步至知识图谱和 SQLite FTS5。

E. 教学与法律学位考试

MCP 工具	参数	操作说明
grado_interrogar	materia (str), dificultad (str)	模拟民法或程序法学位考试中的苏格拉底式问答，并依据严格的教义学评分标准评估答案。
grado_generar_cedula	tema (str)	生成完整的学位考试试题，包含实践案例、相关法律条文、规范教义学和评分标准。
grado_obtener_flashcards	area (str), tipo (str)	生成用于强化学习的记忆卡片，内容包括严格定义和不可延展的程序期限。

F. 程序监督与司法裁定

MCP 工具	参数	操作说明
vigilante_analizar_resolucion	resolucion_texto (str), procedimiento (str)	分析 OJV 司法裁定（"移交对方答辩"、"待裁决案件"、"视为已答辩"），判定其效力，并计算工作日内的不可延展期限（CPC 第 66 条）。
vigilante_radar_normativo	materia (str), dias_atras (int)	监测《官方公报》中的法规更新、审计长办公室的意见书及税务通告。
vigilante_contrato_plazos	tipo_contrato (str), fecha_vencimiento (str), preaviso_dias (int)	计算民事和商事合同的预先通知期限、解约期限及默示续约条款。

G. 法律诊所与清晰语言

MCP 工具	参数	操作说明
clinica_lenguaje_claro	texto_resolucion (str), destinatario (str)	将专业的司法裁定和判决转化为公民易懂、富有同理心的语言，方便处于弱势处境的人理解。
clinica_intake_social	materia (str), datos_usuario (dict)	为家庭、无权占有和赡养费案件的法律援助诊所生成社会法律接案表。
clinica_auditar_borrador	borrador_texto (str), tribunal (str)	在导师审核前，对实习生或学生起草的诉讼文书草稿进行形式审查（案情陈述、诉讼代理和诉讼请求）。

H. 透明度、廉政与关系网络建模

MCP 工具	参数	操作说明
infoprobidad_get_dip	query_or_url (str)	从 InfoProbidad 提取并结构化公职人员的利益与财产申报（DIP）（第 20.880 号法律）。
generar_grafo_vinculos	nodes, edges, title	将企业关系、亲属关系及公共利益关系建模为 Mermaid 图表和 JSON 导出文件。

I. 文书鉴定与 OJV 办理

MCP 工具	参数	操作说明
ocr_extract_pdf	pdf_path, start_page, end_page, force_ocr, dpi, lang	提取原生文本，或对扫描的司法案卷和公证公文执行司法鉴定级 OCR（Tesseract）。
compile_legal_dossier	markdown_content, output_pdf_path, annexes	将司法文书编译为机构标准 A4 PDF 格式，组装带页码的文书附件并生成优化版本。此外，还会生成可编辑的 Word 工作文档（.docx）。
export_brief_ojv	titulo, tribunal, comparecencia, hechos, derecho, peticiones, otrosies	为虚拟司法办公室（OJV）生成并排版正式司法文书，格式包括 .html、.md、.txt 和 .json。
generar_documento	tipo (str), hechos (str), peticiones (str), objeto/derecho/dictamen/normas/doctrina/jurisprudencia (opc)	生成 Word 工作文档（可编辑的 .docx）以及 HTML/MD/TXT/JSON 文件：民事诉讼、保护令申请、劳动诉讼、PPA 合同，或法律意见报告（类型为 informe）：描述案件事实，在正文中完整转录所引法规的条文（附 [BCN - …] 引文和链接），并纳入学说和判例。没有附上原文的引文会被标记为“缺乏可核实来源”：不会盲目引用。

J. 隐私（ARCO）与工业产权（INAPI）

MCP 工具	参数	操作说明
privacidad_tramitar_arco	tipo_derecho, solicitante, rut, datos_solicitados	办理并起草针对访问、更正、删除或反对请求（第 19.628 号法律）的正式答复范本。
inapi_cease_and_desist	marca_afectada, titular, infractor, hechos_infraccion	针对商标侵权（第 19.039 号法律）或版权侵权（第 17.336 号法律）起草正式的停止侵权公证函。
inapi_evaluar_marca	marca_propuesta, clase_niza	评估拟议标志在尼斯分类中的可行性和显著性，并用于 INAPI 商标注册评估。

K. 辅助分析研究（Google NotebookLM）

MCP 工具	参数	操作说明
notebooklm_list_notebooks	(ninguno)	列出所有已创建的法律研究笔记本及其元数据和来源。
notebooklm_create_notebook	title (str)	在 NotebookLM 中创建结构化的法律研究笔记本。
notebooklm_add_source	notebook_id, file_path, title	将本地案卷、判决或学说导入笔记本，作为证据来源。
notebooklm_query	notebook_id, prompt	执行高精度查询，并提供精确引用（grounded citations）。

L. 房地产诉讼实务、CBR 产权审查与司法授权

MCP 工具	参数	操作说明
cbr_estudio_titulos	inscripciones (list), anios_requeridos (int)	审核十年产权链（10 年，第 2510-2511 条《民法典》）和 CBR 登记，检测权利传承中断、未注销的负担或缺少有效占有证明等问题。
cbr_checklist_documentos	tipo_inmueble (str)	返回产权审查所需文件的完整清单（30 年产权历史、现行产权、DOM 证明、TGR 证明）。
cpc_validar_mandato	texto_mandato (str)	正式审核诉讼代理及授权的附加条款或公证文书（第 18.120 号法律），核验普通权限（第 7 条第 1 款）和明确授予的特别权限（《民事诉讼法》第 7 条第 2 款：和解、收取款项、撤诉）。

M. 跨时法律与 BCN 历史查询

MCP 工具	参数	操作说明
bcn_get_ley_historica	numero (int), fecha (str), articulo (str, opc)	在 BCN 查询某部智利法律于特定历史日期（YYYY-MM-DD）生效的文本，用于审查法律效力延续和过渡法。
bcn_get_codigo_historico	codigo (str), fecha (str), articulo (str, opc)	查询智利共和国法典（民法典、劳动法典、CPC、刑法典）在过去某个历史日期（YYYY-MM-DD）的内容。

N. 公共部门、监管与 RUT 验证

MCP 工具	参数	操作说明
rut_validar_chile	rut (str)	使用官方 Módulo 11 算法验证智利自然人或法人的 RUT，并生成规范格式。
entes_consultar_organo	organo (str)	查询公共机构（SII、CMF、CGR、DT、SERNAC、FNE、SMA、CPLT）的组织法、职权、监管权力以及司法／行政申诉途径。

O. 司法判决与 OJV 裁定的法证分析

MCP 工具	参数	操作说明
pjud_analizar_sentencia	texto_sentencia (str)	根据《民事诉讼法典》第 170 条和 1907 年《司法裁定》（Auto Acordado）对司法判决进行结构化拆解（事实陈述、事实／法律理由、裁决、不同意见及《民事诉讼法典》第 144 条规定的诉讼费用）。
pjud_interpretar_proveido	texto_proveido (str)	解读 OJV 中常见裁定（“Téngase presente”、“Como se pide”、“Traslado”、“Autos para fallo”）的法律含义和诉讼义务。

P. 行政决议与特别法庭

MCP 工具	参数	操作说明
sii_buscar_resoluciones_y_oficios	query (str), anios (list, opc)	搜索 SII 局长作出的豁免决议和行政判例公函（《税法典》第 26 条）。
tdlc_buscar_icg_y_dictamenes	query (str)	搜索 TDLC 判例：争讼判决、非争讼意见以及一般性指令（ICG）。
cmf_buscar_sanciones	query (str)	搜索 CMF 官方制裁决议登记册及其实施的制裁程序。
ambiental_buscar_jurisprudencia	query (str), tribunal (str, opc)	搜索环境判例年度汇编及环境法庭（1TA、2TA、3TA）的判决。
ambiental_consulta_maestra	consulta (str), limite (int, opc), incluir_subgrafo (bool, opc)	环境法专用模块（§2 quinquies）：查询环境法庭的 886 份判决、年鉴和 2TA／3TA 公报、环境图书馆（评论竞赛书籍、法律意见报告、论坛、手册和教学材料）以及环境法学说；返回计划、原文和引用 [Hugging Face - <archivo>]。

Q. 智利司法学院与 Markdown 在线图书馆

MCP 工具	参数	操作说明
academia_judicial_buscar_guias	query (str)、materia (str，选填)	在司法学院的官方培训与司法最佳实践指南中搜索（刑事、量刑、劳动、家庭、伦理、AI）。
biblioteca_compilar_manifiesto	generar_bundles (bool，选填)	编译 Markdown 在线图书馆的目录和指标，并生成适用于 Hugging Face、GitHub Releases 和 Google Drive 的数据包。
huggingface_search_dataset	query (str)、limit (int，选填)	在 Hugging Face 公共数据集中搜索（法学理论、指南、判例和图谱），并返回文件路径、数据集链接以及带引文括号的文本摘录（extractos），可直接引用。

R. 伦理遥测、采用指标与自动更新

MCP 工具	参数	操作说明
suite_telemetria_stats	（无）	查询整体采用情况统计、PyPI 下载量（pypistats.org）、GitHub 社区数据以及本地已安装功能。
suite_verificar_actualizacion	forzar (bool，选填)	在后台检查 PyPI 或 GitHub 是否有更新版本，并为 AI Agent 提供精准的操作说明。
suite_auto_update	（无）	在本地环境中执行 Suite 的安全自动更新（通过 git pull 或 pip install --upgrade）。

S. 法律知识图谱与 Token 优化（内部引擎 legal_graphify.py）

MCP 工具	参数	操作说明
graphify_consulta_subgrafo	query (str)、max_hops (int，选填)、incluir_mermaid (bool，选填)	查询智利法学理论法律知识图谱（LegalGraphify），提取高密度精简子图（BCN 法规、最高法院标准、法学家及诉讼实务），与阅读完整法学理论文本相比，中位数可节省 99.9% 的 Token（中位数资料卡：91 个 Token；完整著作：96.536 个 Token）。可在 docs/medicion_tokens.md 查看可复现的测量结果。
graphify_trazar_camino	concepto_origen (str)、concepto_destino (str)	计算并追踪 LegalGraphify 中两个法律概念或法规之间的最短关系路径，推导涵摄链和法教义学论证。
graphify_explicar_institucion	nombre (str)	在 LegalGraphify 中生成法律制度的 360° 法教义学说明：定义、BCN 实证法依据、最高法院标准、诉讼实务和拓扑等级。
graphify_analizar_impacto	nodo_modificado (str)	当法律法规或法律制度发生法律修订或判例转向时，计算其拓扑影响范围（Blast Radius），识别受影响的 1 级（直接）和 2 级（级联）实体。
graphify_god_nodes	top_n (int，选填)	根据 PageRank 和中心性算法，识别智利法律体系中法学理论与法规知识图谱的结构性法教义学支柱（God Nodes）。

T. 宪法救济与 OJV 标准化

MCP 工具	参数	操作说明
recurso_proteccion_generar	recurrente (dict)、recurrido (dict)、corte (str)、acto_u_omision (str)、garantias_afectadas (list)、petitorio (str)、oni (dict, opc)、anexos (list, opc)	生成并编制正式标准化的保护令救济及 OJV 司法案卷，符合最高法院阁议决议（第 94-2015 号法案），计算 30 个连续日的法定期限，采用防拥堵预审、适用《宪法》第 19 条保障、特殊法规（第 21.430、21.545、19.712 号法律，《刑事诉讼法典》第 175-176 条）、附带条件的禁止创新令（ONI），并编制带有原生目录书签的 PDF。此外，还会生成可编辑的 Word（.docx）工作文档。

U. 自主法律 Agent 生态系统

MCP 工具	参数	操作说明
agent_list	(无)	列出 Open Legal Chile 中可用的 19 个专业法律 Agent 配置及其操作能力。
agent_run	agent_name (str)、task (str)、context (dict, opc)、provider (str, opc)	以自主确定性模式（100% 离线，无需 API 密钥）或由多家供应商的大模型辅助模式（Ollama、DeepSeek、Claude、Gemini、OpenAI）运行智利法律 Agent。执行诉讼、CBR 产权分析、CGR 廉政分析、教义涵摄或法证审计等任务，并从 5 个程序维度进行自我批判。
agent_export_subagents	target_dir (str, opc)、format (str, opc)	将 19 个法律 Agent 配置导出为已配置的子 Agent（.json 或 .md），以便立即用于 Claude Code（.claude/subagents）或 Google Antigravity 等 Agent 开发环境。

---

V. 案件受理台

• caso_analizar：接收案卷文件夹、文本或自然语言查询，并返回一个计划——案件领域、可能的管辖范围、相关机构、按顺序排列的工具及其用途，以及缺少的材料。不会修改任何内容，也不会查询外部服务。案件领域由规则判断（Rol/RIT 和智利关键词），不会凭空猜测。
• caso_ejecutar：针对真实来源执行该计划（BCN、PJUD、CGR、DT、SII、CMF、SMA、已索引的法律学说及文件夹中的文档）。每个步骤都会报告状态；失败的步骤会记录错误，没有参数的步骤则会说明原因并跳过。绝不会返回捏造的结果。

🏛️ 5. 智利政府的 10 个官方连接器

每个连接器均专为直接连接智利政府公共平台而开发，并将响应存储在本地 SQLite 数据库（openlegal_cache.db）中，以确保快速响应并支持离线运行：

1. 📜 国会图书馆（BCN Ley Chile）：
   • 机制： 直接查询 BCN 公共 XML 门户（leychile.cl/Consulta/obtxml）。
   • 覆盖范围： 智利共和国的全部立法、9 部现行法典、《政治宪法》和《卫生法典》，实时更新。无需注册或 API 密钥。
2. 🏛️ 智利共和国审计长办公室（CGR）：
   • 机制： 开放的行政法理 REST API。
   • 覆盖范围： 超过 50,000 份有关临时聘用人员合法信赖、行政法规和廉政问题的裁定，以及 9,600 多份审计报告。
3. 💼 劳工局（DT）：
   • 机制： 开放的机构裁定与学理意见目录。
   • 覆盖范围： 关于解雇（第 161 条）、Karin 法（第 21.643 号法律）、每周工作时间缩短至 40 小时（第 21.561 号法律）和劳动关系终止结算的约束性判例。
4. ⚖️ 司法权（PJUD）与最高法院：
   • 机制： 本地结构化数据库（jurisprudencia_judicial.db），已为指导性判决建立索引。
   • 覆盖范围： 劳动法统一判决（《劳动法典》第 483 条）、保护诉讼和民事上诉。
5. 🛡️ 宪法法院（TC）：
   • 机制： 收录违宪不适用申请（《政治宪法》第 93 条第 6 款）及违宪判决（《政治宪法》第 93 条第 7 款）的存储库。
6. ⚡ 国家能源委员会（CNE）：
   • 机制： 开放能源开放数据门户。
   • 覆盖范围： 装机容量（MW）、1,342 座发电厂、环境影响评估系统（SEA）中的 3,754 个项目。
7. 🔌《电力法》专家委员会：
   • 机制： 技术和电价争议公共 API。
   • 覆盖范围： 针对《电力服务总法》（第 4/2006 号法令）作出的约束性且不得上诉的裁定。
8. 🏢 金融市场委员会（CMF）：
   • 机制： 公共规范查询服务。
   • 覆盖范围： 一般性规范（NCG 461、公司治理、可持续性）以及银行和证券市场通告。
9. 💰 国内税务局（SII）：
   • 机制： 官方税务决议与通告索引（2020 至 2026 年）。
10. 🌱 环境监管局（SMA / SNIFA）：
    • 机制： 国家环境执法信息系统（SNIFA）。
    • 覆盖范围： 环境处罚案卷和合规计划（PdC）。

---

📚 6. 正典学理基础与法证程序维度

在智利法律传统中，手册或论著从来不是纯理论或抽象的汇编：没有诉讼程序提供保护，就没有主观权利。

Open Legal Chile 拥有一个由正典论著构成的教义学基础数据库，这些论著已在 SQLite 中建立索引，并支持全文检索 FTS5 和 BM25 排名（doctrina.db）：

📖 数字化的权威法学著作

• 法律行为总论： Víctor Vial del Río
• 继承法与遗产分割： Manuel Somarriva Undurraga
• 债务法与家庭法： René Ramos Pazos
• 合同（总论）： Jorge López Santa María
• 财产与物权： Daniel Peñailillo Arévalo
• 非合同责任： Enrique Barros Bourie
• 商法、公司（SpA）与破产法： Ricardo Sandoval López
• 行政法基本原理： Eduardo Soto Kloss
• 行政法总论： Jorge Bermúdez Soto
• 共同规定与普通诉讼： Alejandro Romero Seguel y Fernando Orellana Torres
• 诉讼救济总论： Mario Mosquera Ruiz y Cristián Maturana Miquel
• 刑法（总论）： Enrique Cury Urzúa
• 劳动法与劳资关系： Sergio Gamonal Contreras
• 宪法与诉讼： José Luis Cea Egaña
• 司法实践与培训指南： Academia Judicial de Chile（21 份官方指南）

🏛️ 诉讼实务维度的 7 大支柱

每项学理制度不仅界定该制度，还会详细说明其在法院中的实际应用：

1. 诉讼途径 / 程序类型： 普通高额诉讼（《民事诉讼法典》第 254 条）、简易诉讼（《民事诉讼法典》第 680 条）、执行诉讼（《民事诉讼法典》第 434 条）、劳动保护诉讼（《劳动法典》第 485 条）、保护诉讼（《智利宪法》第 20 条）。
2. 有管辖权的法院： 《法院组织法典》（COT）规定的绝对管辖权规则（事项、诉讼标的金额、身份管辖）与相对管辖权规则（地域）。
3. 诉讼主体资格： 谁可以提起诉讼（主动主体资格：例如所有人、依据《民法典》第 894 条提起公示所有权之诉的合法占有人、劳动者、工会），以及诉求针对谁（被动主体资格）。
4. 举证责任（Onus Probandi）： 根据《民法典》第 1698 条分配举证责任、法定证明标准与自由心证标准，以及间接证据（《劳动法典》第 493 条）。
5. 诉前保全与临时保全措施： 诉前措施（《民事诉讼法典》第 273 条和第 279 条）以及《民事诉讼法典》第 290 条规定的保全措施（扣押、指定监管人、扣留财产，以及禁止实施法律行为和订立合同）。
6. 不变期间与举证期限： 应诉期间（15/18 天 + 对照表）、举证期限（普通程序 20 天、简易程序 8 天、执行程序 10 天）以及救济期限（上诉 5/10 天、撤销之诉 15 天、保护诉讼 30 个连续日）。
7. 典型抗辩与抗辩事由： 程序性抗辩（《民事诉讼法典》第 303 条）、实体抗辩与永久性抗辩（exceptio non adimpleti contractus，《民法典》第 1552 条；权利失效；消灭时效）。

💡 经测量的 Token 优化（中位数 99,9 %；单条目 91 tokens，对比原著 96.536）

通过编译器 scripts/doctrina_parser.py，原始文本和学理论述转录内容会经过编辑噪声清理，并转换为高密度教义学 Markdown，以供图谱使用。该编译器不承诺自身带来节省：本项目公布的节省量，是查询子图而非整部著作时所实现的节省，并且经过测量而非估算——详见 docs/medicion_tokens.md。

---

⚖️ 7. 专业诉讼实务与教学模块

🔍 A. 五维法证批判引擎（critique.py）

受司法文书自我审查和质量审计机制启发，从 5 个必选维度评估草稿：

1. 规范层级与合法性： 检查是否符合宪法和现行法律，清除 Common Law 术语，并遵循官方引注标准。
2. 适用学说与判例： 要求依据最高法院、CGR 或 DT 的指导性标准进行论证。
3. OJV 法证文书结构（第 20.886 号法律）： 检查是否包含文首摘要、出庭陈述、事实陈述、法律论证、诉讼请求及附带请求等内容。
4. 事实一致性与举证责任（《民法典》第 1698 条）： 评估所陈述事实与所提出诉讼请求之间是否一致。
5. 伦理与不变期间关卡： 提示失权风险，并要求由具备执业资格的律师进行人工验证。

⏱️ B. 诉讼裁定监控器（docket_watcher.py）

自动执行案件的诉讼流程管控：

• 裁定读取： 检测并分类 OJV 的司法裁定（“移送对方答辩”、“待裁决”、“视为已答辩”、“案件进入举证阶段”）。
• 不变期间计算： 自动计算司法工作日的期限届满日（根据《民事诉讼法典》第 66 条，不包括星期日和节假日）。
• 合同监控： 监控民事和商事合同中的解约及提前通知关键期限。

🎓 C. 法学学位考试苏格拉底式模拟器（examen_grado.py）

专为严格备考法学本科毕业考试而设计：

• 动态提问者： 提出学理问题和苏格拉底式追问，要求概念准确。
• 考试题签生成器： 按科目（民法和民事诉讼法）生成完整题签，并附教师评分标准。
• 记忆卡片： 提供快速学习卡片，包含规范定义和诉讼不变期间。

🤝 D. 法律诊所与浅白语言（clinica_juridica.py）

用于联系社会各界并提供司法援助的工具：

• 浅白语言转换器： 将晦涩的司法裁定转化为易懂且具有教学意义的说明，供资源匮乏的用户阅读。
• 案件社会分流： 为抚养费、家庭暴力和无权占有诉讼案件提供结构化登记表。
• 实习生审计： 在指导律师审阅签署前，对实习学生的书面文件进行形式审查。

🌐 E. 关系网络建模与公共廉正（grafo_vinculos.py 和 infoprobidad_connector.py）

• InfoProbidad 提取： 根据第 20.880 号法律解析利益与财产申报（DIP）。
• 关系图谱： 以 Mermaid 图表和 JSON 结构建模公司关系、家庭关系及与国家的合同关系。

📑 F. 法证 OCR 与案卷编译器（forensic_ocr.py 和 pdf_dossier_compiler.py）

• 法证 OCR： 提取扫描卷宗页的文本，同时保留文档的准确性。
• A4 编页编译器： 将诉状、救济申请和证据附件合并为一份案卷，并添加机构封面和电子页码。

🏡 G. 不动产产权调查、CBR 和司法授权（cbr_titles.py）

• 十年产权调查： 关于特别取得时效的规则（《民法典》第 2510 和 2511 条）、瑕疵补正，以及对 CBR 四类登记簿（产权登记簿、抵押和负担登记簿、禁令和限制登记簿、目录簿）的审查。
• 红旗风险检测： 自动警示产权传承中断、缺少有效占有或遗产特别登记（《民法典》第 688 条）、扣押和预防性措施。
• 司法授权审查（第 18.120 号法律和《民事诉讼法典》第 7 条）： 核实诉讼代理人具备资格，并明确确认其拥有《民事诉讼法典》第 7 条第 2 款规定的特别权限（撤诉、和解、收款、提交仲裁）。

⚖️ H. 判决与 OJV 裁定结构分析器（sentencias_parser.py）

• 《民事诉讼法典》第 170 条结构拆解： 根据 1907 年的司法协议令自动拆分判决（事实陈述部分、事实认定理由、法律认定理由、裁判主文，以及异议意见或保留意见）。
• 诉讼费用制度（《民事诉讼法典》第 144 条）： 检测是否判令承担全部费用，或因诉讼具有合理事由而免予承担。
• OJV 裁定解读器： 分析诉讼义务以及仅涉及程序处理的命令所产生的法律效力（“予以考虑”、“准予所请”、“送达对方”、“提交裁判”）。

🌿 I. 环境法庭与判例汇编（tribunales_ambientales_connector.py）

• 3 个环境法庭（第 20.600 号法律）： 覆盖第 1 环境法庭（安托法加斯塔）、第 2 环境法庭（圣地亚哥）和第 3 环境法庭（瓦尔迪维亚）。
• 年度环境判例汇编： 编目并提供搜索功能，涵盖年鉴及经系统整理的判例标准，包括环境损害诉讼（第 17 条第 2 款）、针对 SMA 的申诉（第 17 条第 1 款和第 3 款）以及城市湿地（第 21.202 号法律）。

🏛️ 智利司法学院与 Markdown 在线图书馆（academia_judicial_connector.py 和 online_library_sync.py）

• 官方司法培训指南： 摄取并查询来自 guias.academiajudicial.cl 的 22+ 份官方指南（刑事、刑罚裁定、口头审判准备、家庭、劳动、伦理以及法院中的人工智能）。
• Markdown 在线图书馆： 免费发布并打包语料库，供 Hugging Face Datasets 使用（pablobenavidesj/doctrina-jurisprudencia-chile），提供压缩版 GitHub releases，以及为 Google Drive 和 Google NotebookLM 整理的文件夹。
• 面向 Agent 的高效目录（2026-09-25）： 数据集新增 llms.txt（语料库地图和引用格式）、data/catalogo/instituciones_lite.jsonl（不含全文的条目：11.5 MB，而非 83.6 MB）、data/catalogo/train_lite.jsonl（作品索引：0.1 MB，而非 74.9 MB）、data/catalogo/indice_citas.jsonl（文档 · 章节 · 脚注引用的直接链接）以及 data/catalogo/indice_agentes.json（“主题 → 文件”路径）。
• 新增全文（2026-09-25）： jurisprudencia_tc/ 收录了最近两年智利宪法法院的 966 份判决（Markdown 格式，含引用条目和全文，下载自官方搜索系统）；publicaciones_ambientales/ 收录了环境法院的 年刊和公报（78 份出版物）。这些内容由 scripts/tc_pdfs_a_md.py 和 scripts/publicaciones_a_md.py 转换。
• 单独的训练数据集： 完整版本（train.jsonl 74.9 MB 和 instituciones.jsonl 83.6 MB）存放在 pablobenavidesj/doctrina-jurisprudencia-chile-training；主数据集缩减至约 168 MB，完整语料库位于 doctrina/ 中，并保留“指针”版本。
• 扩展判例： 环境法院的 886 份判决（1TA 111 · 2TA 441 · 3TA 334）、78 份官方环境判例出版物（2TA/3TA 年刊和公报）、最高法院的 70 536 份判决，以及最近两年宪法法院的 967 份判决，均包含案号、审判庭、日期、诉讼类型、结果和法官信息（最高法院的文本需通过 PJUD 会话访问；宪法法院内容附有官方 PDF 链接）。
• 环境图书馆（2026-09-28）： biblioteca_ambiental/ 文集收录 88 份 转换为 Markdown 的文档——“全国判决评注大赛”的 6 本书、环境法院的 14 份法律意见、论坛、手册和教学材料——以及最新的年刊和公报（79 份出版物）。专用模块 ambiental_consulta_maestra（工具 87）可通过 openlegal ambiental "…" 一并查询全部内容。
• 面向 Hugging Face 的快速目录与内存索引（2026-09-30）： Hugging Face 远程搜索（online_library_sync.py）支持即时解析 25.556 家法学机构（instituciones_lite.jsonl）和 70.536 起司法案件，并可直接本地读取仓库中已有的文本（0 ms），保证提供原文摘录和标准化官方引用（[Hugging Face - ...]）。
• 大规模摄取与 Grounding Pipeline（scripts/ingestar_lote_masivo.py）： 批量摄取文档集（.pdf、.docx、.txt、.md），进行 RAE/ASALE 正字法规范化和 Token 压缩，并整合同步（FTS5 doctrine.db、LegalGraphify 和目录），不降低性能。

🧠 K. 内部图谱：通过关联知识减少 token（legal_graphify.py）

• 多维法学理论图谱： 20.990 个相互连接的节点（法学理论制度、BCN 法典条文、最高法院和宪法法院的指导性判决、环境法院出版物、环境图书馆和经典法学家著作）以及 51.590 条关系边（427 个本体社区）。
• 高速 O(1) 倒排索引（2026-09-30）： 在内存中为 labels、tokens 和定义建立索引，节点解析耗时 0,006 ms（比线性 regex 快 9.000 倍），可对大型图谱即时查询子图和拓扑爆炸半径。
• 实测 token 节省（中位数 99,9 %；2026-09-28 对 9.863 项制度的测量）： 无需注入完整的学术著作（中位数 96.536 tokens；最大值 313.985），引擎会提取一个高度密集的连通子图，包含 27 到 544 tokens（中位数 91），并以结构化格式呈现（规范定义、对应条文、最高法院指导性标准和司法程序操作）。可通过 .venv/bin/python scripts/medir_ahorro_tokens.py 复现测量 → docs/medicion_tokens.md。
• 实时 Mermaid 图表： 实时生成关系流程图，以可视化每项制度的法学理论推理。
• 与 Graphify 集成（代码图谱 + 法律图谱）： 两个图谱如何融合、测量了什么以及为何不维护分支，详见 docs/integracion_graphify.md。
• CLI 命令和 MCP 工具： 可通过 openlegal graph "concepto" 使用，也可通过 MCP 工具 graphify_consulta_subgrafo 使用。兼容 Graphify Labs CLI（python -m graphify query "..."），并支持交互式导出到浏览器（graphify-out/graph.html）。

---

🧠 8. 技能与子 Agent 目录（19 个专业领域）

agents/ 目录包含 19 个针对智利大陆法系调整的法律专业档案（从 claude-for-legal 导入并去除英美法系色彩）：

1. chilean-employment-legal（agente-laboral）：解雇（《劳动法典》第 161/160 条）、《Karin 法》（21.643）、40 小时工作制（21.561）、离职结算协议及 DT 法律见解。

2. chilean-litigation-legal（agente-litigios）：OJV 第 20.886 号法律规定的诉讼、标准化的保护令申请（第 94-2015 号法令）、事实时间线、程序性救济及预防性措施。

3. chilean-real-estate-cbr（agente-inmobiliario）：十年产权审查（10 年）、所有权转移、抵押负担、登记禁令及司法授权（《民事诉讼法典》第 7 条）。

4. chilean-dogmatic-graphify（agente-dogmatico）：高阶法教义学策略师、技术性法律涵摄、完整的法学文献语料库（7,399 部著作和文章 + 智利司法学院 24 份指南），以及使用 LegalGraphify 子图进行推演（中位数 Token 节省率：99.9%；档案 91，对比著作 96,536）。

5. chilean-administrative-legal（agente-regulatorio）：CGR 裁定和报告、公共采购（第 19.886 号法律）及监管监测。

6. chilean-energy-legal（agente-energia）：自由客户的 PPA 合同、电力输电第 20.936 号法律及专家小组争议。

7. chilean-environmental-legal（agente-ambiental）：SMA 检查（SNIFA）、违反 RCA 的行为及合规计划。

8. chilean-contract-legal（agente-contratos）：合同审查、NDA、违约金条款（《民法典》）及《消费者保护法》第 19.496 号法律。

9. chilean-corporate-legal（agente-corporativo）：成立 SpA（第 20.659 号法律）和 S.A.（18.046）、CMF/SII 合规及自由竞争（第 211 号法令）。

10. chilean-forensic-evidence（agente-forense）：扫描卷宗的文书鉴定、PaddleOCR/Tesseract OCR 及红队审计。

11. chilean-probity-investigation（agente-probidad）：比对 DIP 财产申报（InfoProbidad）及利益冲突调查。

12. chilean-dossier-assembly（agente-expedientes）：整理带页码的卷宗，加入证据分隔页和 TOC 标记。

13. chilean-notebooklm-grounding（agente-investigacion-ia）：连接 Google NotebookLM，开展带有可靠引文的研究。

14. chilean-socratic-bar-exam（agente-grado）：为准备学位考试的法律专业毕业生提供苏格拉底式提问。

15. chilean-docket-watcher（agente-vigilante）：监测 OJV 的法院裁定，并按司法工作日计算最终期限。

16. chilean-legal-clinic（agente-clinica）：为 CAJ 法律咨询机构提供社会法律援助，并转换为通俗易懂的语言。

17. chilean-privacy-ip（agente-propiedad-datos）：办理 ARCO 权利申请（第 19.628 号法律），并评估向 INAPI 申请商标的可行性。

18. chilean-doctrine-ingestion（agente-ingestor）：吸收和导入智利法学文献，将其转换为符合 RAE/ASALE 规范的标准 Markdown，并实时同步至知识图谱和 SQLite FTS5。

19. chilean-case-intake（agente-mesa）：案件收件台：文件夹、文本或咨询 → 工具计划 → 执行 → 案卷；声明所有缺失材料，并设置审核关卡。

🤖 自主法律 Agent 引擎（agents_runtime.py）

该套件包含一个支持两种执行模式的 Agent 运行时：

1. 自主确定性模式（100% 离线，无需 API 密钥）： 专业的确定性流水线，可处理复杂的法证任务（生成和组装保护申请、CBR 十年期产权审计、DIP CGR 监督、劳动保护诉讼、法理学说吸收），仅使用 Open Legal Chile 的本地工具，不向外部服务发送数据。
2. LLM 辅助模式（多提供商 ReAct）： 使用外部或本地模型（Ollama、DeepSeek、Claude、Gemini、OpenAI）编排 Agent，通过思考 / 行动 / 观察循环，并注入法学理论，开展五个维度的法证自我批判。

---

💻 9. CLI 控制台完整指南（openlegal）

Open Legal Chile 提供强大的命令行界面，可通过 openlegal 访问：

# Menú interactivo de la consola (opciones [0] a [18])
openlegal

# Listar agentes jurídicos autónomos disponibles (19 perfiles)
openlegal agent list

# Ejecutar un agente en modo determinista soberano (100 % local)
openlegal agent run litigios "Generar recurso de protección por corte arbitrario de agua potable"
openlegal agent run inmobiliario "Auditar cadena de dominio CBR decenal"
openlegal agent run ingestor /ruta/al/archivo.pdf

# Conversación interactiva con un agente especializado
openlegal agent chat dogmatico

# Exportar perfiles de subagentes para Google Antigravity o Claude Code
openlegal agent export --format antigravity

# Servidor MCP estándar para agentes de IA (87 herramientas)
openlegal mcp

# Chat jurídico interactivo con RAG soberano chileno
openlegal chat

# Búsqueda jurídica universal cruzada en los 10 organismos del Estado
openlegal search "confianza legitima contrata"

# Auditar un escrito bajo las 5 dimensiones forenses
openlegal critique escrito.txt

# Generar un borrador procesal formal OJV
openlegal generate demanda_civil

# Iniciar interrogación socrática para Examen de Grado
openlegal grado civil

# Analizar un proveído judicial y calcular sus plazos fatales
openlegal vigilar "Téngase por contestada la demanda y traslado para réplica"

# Traducir una resolución a Lenguaje Claro para usuarios de consultorio
openlegal clinica "Autos para fallo"

# Tramitar solicitud de Derechos ARCO de datos personales
openlegal arco

# Evaluar viabilidad de marca en INAPI
openlegal inapi "InnoJuris"

# Ejecutar auditoría integral 360° del sistema
openlegal audit

# Exportar escrito formal OJV a HTML, Markdown y JSON
openlegal export

# Búsqueda en los tratados canónicos de Derecho Chileno (FTS5 BM25)
openlegal doctrina "simulacion y error sustancial"

# Consultar las guías de formación de la Academia Judicial
openlegal guias "determinacion de penas"

# El módulo especial de derecho ambiental (sentencias TA, anuarios, boletines y biblioteca)
openlegal ambiental "daño ambiental en humedales urbanos"

# Consultar estadísticas globales de adopción (PyPI / GitHub)
openlegal stats

# Comprobar y ejecutar la auto-actualización de la Suite
openlegal update

# Mesa de entrada y análisis de causas con espacio de trabajo local y grafo interactivo
openlegal caso "Causa RIT T-456-2024 ante Juzgado del Trabajo"

# Búsqueda vectorial híbrida (Dense Similitud Coseno + BM25 FTS5 con RRF) sobre Códigos y CPR
openlegal vector "despido por necesidades de la empresa"

# Pre-calentar caché local con los Códigos de la República y jurisprudencia unificada
openlegal cache warm

# Diagnóstico real de la suite (mide OCR, corpus, grafo, citas y herramientas MCP)
openlegal doctor
openlegal check   # alias del anterior

---

🛡️ 10. 360° 机构审计认证（AUDIT.md）

Open Legal Chile 通过了一套包含 9 层的全面审计套件认证，该套件既可在本地运行，也可在 GitHub Actions 中运行：

./audit.sh
# O vía CLI:
openlegal audit

层 / 维度	标准工具	状态 / 认证
1. SCA 漏洞	pypa/pip-audit	0 个已知漏洞（已消除 CVE）
2. SAST 安全	PyCQA/bandit	0 个注入或反序列化缺陷
3. OWASP 语义分析	semgrep/semgrep	0 个阻塞性发现（分析了 201 条规则）
4. 密钥泄露	Yelp/detect-secrets	零数据泄露（未暴露任何密钥或凭证）
5. 静态类型检查	python/mypy	46 个源文件在严格模式下 0 个错误
6. 代码检查器和 PEP	astral-sh/ruff	100% 的架构和风格规则通过
7. 反过度工程	Ponytail 和 vulture	Ponytail 理念：无死代码（精益为先，交付为本）
8. 可维护性	rubik/radon	实质性逻辑和连接器达到 A 级
9. 功能测试	pytest-dev/pytest	500/500 项单元测试全部通过

请参阅 AUDIT.md 中的详细机构审计报告。

---

🧪 11. 自动化测试与持续验证

python3 -m pytest -n auto -q
# ============================== 500 passed in 44.59s ==============================

测试使用 pytest-xdist 并行运行，500 项测试可在 45 秒内完成。其中多项测试会实时查询国家门户网站（BCN、DT、CGR、PJUD）。因网络不可用而失败的测试会通过 pytest.skip 跳过，以确保系统具备韧性且不产生误报。

• .github/workflows/ci.yml： 在 Ubuntu 和 Windows 上运行持续集成矩阵，测试 Python 3.10、3.11、3.12、3.13 和 3.14。
• .github/workflows/audit.yml： 在每次提交和 Pull Request 中执行严格的安全与质量审计。
• .github/workflows/state-api-monitor.yml： 每日定时监控，检查智利国家门户网站的可用性和响应时间。
• scripts/bench_rendimiento.py： 版本化基准测试（MCP 启动、图加载、FTS trigram、环境查询和 consulta_maestra），并将测试序列写入 docs/bench_rendimiento.md；--comparar 会打印与已保存运行结果的差值。

---

📜 12. 许可证、法证伦理与职业责任

Apache 2.0 许可证

Open Legal Chile 采用 Apache 2.0 许可证（LICENSE）。该许可证允许在学术、专业和商业领域自由使用、研究、修改和再分发。

强制专业验证门槛

⚖️ 法证与职业道德提示： Open Legal Chile 是一个用于技术协助、研究和教学的基础设施。通过人工智能生成的所有草稿、文书、法律意见或分析，在签署、由律师代理或正式提交至 Oficina Judicial Virtual (OJV) 或行政机构之前，都必须由具备执业资格的律师审查并签署确认。

---

🌱 13. 如何贡献

欢迎学生、教师和律师在学术与技术方面作出贡献：

1. 查看贡献指南和行为准则。
2. 创建一个 issue，或提交一个 Pull Request，以添加新的法学理论资料卡或改进连接器。
3. 如需向法理学资料库添加新著作，请使用工具 scripts/doctrina_parser.py，并遵循 token 压缩标准。

---

秉持公共服务宗旨与严谨的法学理论，为智利共和国法律界开发。

引用与交付格式

• 文档——法律意见、分析、备忘录、文书、简报、资料汇编：以 Word (.docx) 格式交付，不使用 PDF，以便修改；引用须置于脚注， 编号列出，并注明来源 · 标识符 · 链接。
• 对话：先给出答复，引用放在文本之后的末尾。

无论来源为何——国家连接器（BCN、CGR、DT、SII、CMF、SMA、PJUD）、已编入索引的学说、 司法学院指南或 Hugging Face 语料库——如果没有可识别的来源，就注明“无可验证来源”；同一条信息有多个来源时，全部引用。

---
Fuentes:
1. [BCN - Código del Trabajo, Art. 161] https://www.bcn.cl/leychile/...
2. [Academia Judicial — Guía para la conducción de la audiencia preparatoria laboral]
3. [Doctrina — Barros Bourie] doctrina/civil/...