民事案件归档助手 V3
使用一套通用引擎和分律所配置整理民事案件卷宗。律所模板、输出路径和字段映射保存在技能包外:
~/.workbuddy/case-archiver/
├─ settings.json
└─ firm_config/<firm>/
├─ paths.json
├─ preferences.json
├─ template_mapping.md
├─ archive_plan.json
└─ field_map.json
升级技能不得覆盖该配置目录,也不得把客户材料复制进技能包。
路由
| 用户意图 | 动作 |
|---|---|
| 归档案件、先归档现有材料 | 运行 scripts/archive_case.py |
| 完卷、补齐新增材料 | 运行 scripts/status.py,重新扫描并更新状态 |
| 接入新律所或新模板 | 运行 scripts/onboard.py,随后人工审阅低置信度映射 |
| 检查 Word 模板网格和标记 | 运行 scripts/fill_docx.py 模板.docx --out 检查.json |
| 合并卷宗、合成 PDF | 先向用户确认,再运行 scripts/merge_volume.py 或向主流程传 --merge yes |
归档流程
- 读取默认律所及
paths、archive_plan、field_map、preferences。 - 递归扫描案卷;从 PDF、DOCX、DOC 和允许 OCR 的扫描件提取文字。
- 检查是否混入多份互斥材料;发现时警告,不假装材料属于同一案件。
- 按
archive_plan处理:填写表格、抽取纯模板页、复制既定文件或跳过。 - 自动字段按
from和key提取;agent字段使用调用方提供值;client字段保持空白。 - 生成
.归档状态.json和待补齐材料清单.txt。 - 不自动合并 PDF;只有用户明确同意后才执行合并。
案件未结案时允许部分归档。缺失材料记为 pending;表格定位或写后校验失败记为 error,不得标记为 done。
V3 表格规则
填写 DOCX 时按稳定性选择定位方式:
marker:模板中的{{字段名}},首选。control_tag:Word 内容控件 Tag/标题。cell_anchor:按标签定位同格、右格或下格。anchor/loc:仅兼容旧配置;loc应附expected_text防错位。
默认启用严格模式。非空字段找不到、标签不唯一、旧坐标越界或写后验证失败时,保留原输出并把原因写入 manifest 的 fill_report。
接入向导生成的 review_required=true 映射必须经人工确认。合并单元格、空白装饰格和重复标签不得仅凭猜测投入正式使用。
涉及表格映射、选项框、内容长度或 V2 配置迁移时,读取 references/table-mapping-v3.md。修改其他配置时读取 references/schema.md。
业务填写约定
- 当事人指委托人(我方客户);对方当事人指对立面。
- 收案时间取委托合同落款日期;处理机关取受理法院或仲裁机构。
- 审批表右上角“处理方式”填劳动仲裁、一审、二审等,不填处理机关。
- 空白字段保持空白,不写“待填写”等占位文字。
- 合同明确免收、免费或零元时,收费栏填“免收”。
- 案情简介从诉讼请求、查明事实和处理结果组织 200–400 字摘要;无法可靠提取时转为
agent,不编造。 - 案件进程按日期排列委托、立案/仲裁、举证、开庭、裁判或调解等事件。
授权材料检查
| 委托人类型 | 必备材料 |
|---|---|
| 自然人 | 身份证、授权委托书、律所公函、律师执业证 |
| 组织 | 营业执照、法定代表人身份证明书、法定代表人身份证、授权委托书、律所公函、律师执业证 |
缺失项记为 pending,不得用相似但不等价的材料替代。
合并确认边界
- 归档不等于合并。
- 即使
preferences.merge_pdf为always,仍须先获得本次用户确认。 --merge yes仅表示调用方已经取得本次明确确认。- 多案件批量操作可汇总确认,但必须清楚列出将合并的案件。
依赖与兼容
python-docx:DOCX 模板填写与检查。pypdf:PDF 文本提取。PyMuPDF:PDF 合并与页码。pywin32/ Word COM:仅在把 Word 文件转换为 PDF 时需要。- PaddleOCR 或 Windows OCR:扫描件文字识别;默认只处理白名单文书。
正式归档前先用脱敏案卷试运行。检查 fill_report.errors、缺失清单以及生成 DOCX 的实际渲染版面;不要只依据脚本退出码判断表格正确。