TKK · 要素式起诉状转换工具

概述

Web 端单页应用 + Python DOCX 生成器，将传统格式的起诉状 DOCX/PDF 转换为法院要求的要素式文书。

核心能力

• 对话式一键转换：发 DOCX/PDF → AI 自动提取 → 生成要素式 DOCX
• 33个案由全覆盖：所有民事起诉状案由，基于 法〔2025〕82号 官方模板
• 精确格式复刻：页边距/表格列宽/边框/字体严格对齐官方格式
• 数据驱动架构：table_layouts.json 定义表结构，templates.json 定义字段，生成器自动适配

触发条件

• 用户需要将传统起诉状转换为要素式起诉状
• 用户想修改案由模板的字段定义
• 用户想了解工具的架构以便二次开发

使用方式

对话式转换（唯一推荐方式）

直接将起诉状 DOCX/PDF 文件发给 WorkBuddy，说"帮我转换为要素式起诉状"。

工作流：
1. 提取文本 — scripts/extract_text.py 提取全文
2. AI 分析 — WorkBuddy 阅读起诉状文本，识别案由、提取当事人/诉请/事实
3. 生成 DOCX — 写入结构化 JSON，scripts/generate_docx.py 输出要素式文书

⚠️ 深度经验与格式规范（必读）

以下经验源自与 法〔2025〕82号 官方模板的逐项对比分析，是决定输出质量的关键。

1. 表格结构铁律

• 6张独立表格，表间零间隔、零段落、零空行，直接首尾相连（</tbl>→<tbl>）
• 每表含 2 列：标签列（~2270 twips）+ 数据列（~7074 twips），总宽 9344 twips
• 不同案由表格数量不同（4~13 张），但所有民事起诉状的前 2 张表结构一致

2. 精确格式参数

3. 常见错误与教训

4. 不同案由的表结构差异

核心结构（4~6 表案由，占 80%+）：

T0: 说明 + 当事人信息 + 原告(自然人) + 原告(法人)
T1: 代理人 + 被告(自然人) + 被告(法人) + 第三人(自然人) + 第三人(法人)
T2: 第三人org类型 + 诉讼请求(header) + claims + 管辖/保全(header) + 2项
T3: 事实与理由(header) + facts part 1
T4: facts part 2 + 调解意愿(header) + mediation items
T5: mediation 续（benefit 5 + 是否考虑调解）

复杂案由（7~13 表，IP/海事/垄断等）额外添加：涉外/港澳台、关联案件/程序、鉴定申请等专有表。

5. 数据驱动架构说明

• references/table_layouts.json（104KB）：33个案由的完整表布局，逐行记录类型（merged/section_header/label_data）和标签文本
• references/templates.json（174KB）：67个案由的字段定义（claims/facts 的 key-label-hint 三元组）
• scripts/generate_docx.py（v8）：读取 layout + 数据 JSON，自动匹配案由并生成正确表结构

案由 ID 对照表

对话式转换工作流

Step 1：提取文本

python "~/.workbuddy/skills/bude-element-lawsuit/scripts/extract_text.py" "<文件路径>"

Step 2：AI 分析

阅读起诉状全文，输出 JSON。关键规则：
- 从 references/templates.json 读取该 caseType 的 claims/facts 字段定义
- 所有字段值严格对应模板，不得自创字段
- 起诉状中没有的信息留空字符串 ""，不得编造
- 性别/出生日期可从身份证号推断
- claims 中的 lawyerFee/preservation 为 "yes"/"no"
- jurisdiction.mediation 为 "yes"/"no"

{
  "caseType": "jrjk",
  "caseTypeName": "金融借款合同纠纷",
  "court": "合肥市包河区人民法院",
  "plaintiffs": [
    {"type": "org", "name": "", "legalRep": "", "addr": "", "regAddr": "",
     "job": "", "phone": "", "creditCode": "", "orgType": "有限责任公司", "ownership": "民营"},
    {"type": "person", "name": "", "gender": "男", "birth": "", "nation": "汉族",
     "idNum": "", "addr": "", "phone": "", "work": "", "job": ""}
  ],
  "defendants": [],
  "thirds": [],
  "agent": {"has": false, "name": "", "job": "", "firm": "", "phone": "", "auth": "general"},
  "claims": {"full": "", "total": "", "lawyerFee": "no", "preservation": "no",
             "claim_01": "", "claim_02": "", "claim_03": "", "claim_04": "",
             "claim_05": "", "claim_06": "", "claim_07": "", "claim_08": ""},
  "facts": {"facts_00": "", "facts_01": "", "facts_02": "", "facts_03": "",
            "facts_04": "", "facts_05": "", "facts_06": "", "facts_07": "",
            "facts_08": "", "facts_09": "", "facts_10": "", "facts_11": "",
            "facts_12": "", "facts_13": "", "facts_14": "", "facts_15": "",
            "facts_16": "", "facts_17": "", "facts_18": ""},
  "jurisdiction": {"court": "", "basis": "", "date": "", "mediation": "no"}
}

Step 3：生成 DOCX

python "~/.workbuddy/skills/bude-element-lawsuit/scripts/generate_docx.py" \
  "<临时JSON路径>" "<输出DOCX路径>"

Step 4：交付

告知文件路径，提供简要摘要（案由、当事人数量、关键诉请）。

目录结构

bude-element-lawsuit/
├── SKILL.md                    # 本文件（含经验和规范）
├── assets/
│   ├── index.html              # Web版入口
│   └── bude-convert-v10.2-reference.html  # 原始参考
│   ├── css/style.css
│   └── js/app.js
├── references/
│   ├── table_layouts.json      # ⭐ 33个案由完整表布局（从82号模板提取）
│   ├── templates.json          # ⭐ 67个案由字段定义
│   └── fields-structure.md     # 字段定义结构说明
├── scripts/
│   ├── extract_text.py         # Step 1: DOCX/PDF 文本提取
│   ├── generate_docx.py        # Step 3: 数据驱动 DOCX 生成器 (v8)
│   ├── extract_templates_json.js  # 从 app.js 提取模板
│   └── extract.py              # CSS/JS 拆分工具
└── outputs/                    # 生成的 DOCX