| name | evidence-binder |
| version | 1.0.0 |
| description | 物理层面的证据册装配——将证据文件按证据目录排序、重命名、转PDF、编连续页码、按分组归档，形成可提交法院的完整证据册。与「证据目录」技能互补：证据目录负责逻辑层（分组+证明对象），证据装册负责物理层（文件操作+页码编排）。触发词：证据册、整理证据文件、编页码、证据装册、装订证据、证据归档。 |
证据装册（evidence-binder）
物理层面的证据册装配技能——将证据文件按照 /evidence-index 的逻辑分组进行排序、重命名、格式转换、编页码、归档，最终形成可提交法院的完整证据册。
职责边界：本技能负责文件的物理操作（重命名/转PDF/文件夹组织/页码编排），不负责证据的逻辑分组和证明对象撰写（那是 /evidence-index 的工作）。
前置条件
| 材料 | 说明 |
|---|
| 证据材料文件 | 用户提供的原始证据文件（PDF/图片/Word等） |
| 证据目录 | 已通过 /evidence-index 生成的证据目录（含分组结构和编号） |
两项缺一不可。如证据目录尚未生成，提示用户先调用 /evidence-index。
工作流程
Step 1: 解析证据目录
解析证据目录文本，提取：分组结构（组号、组名）、每份证据的编号（组号-序号）与名称、证据总份数。
Step 2: 匹配原始证据文件
- 列出用户提供的所有原始证据文件
- 自动匹配文件与证据目录条目（基于文件名关键词/序号）
- 输出匹配结果表格，必须等用户确认所有对应关系后再继续
| 证据编号 | 证据名称 | 匹配文件 | 状态 |
|----------|----------|----------|------|
| 1-1 | 营业执照 | yyzz.pdf | ✓ 已匹配 |
| 1-2 | 法定代表人身份证明 | ? | ❌ 待确认 |
Step 3: 备份 → 重命名
- 备份原始文件到工作目录（
证据册_原始备份_{时间戳}/）
- 按格式重命名：
{编号}{证据名称}.{扩展名}（如 1-1营业执照.pdf）
Step 4: 按分组创建文件夹
证据册/
├── 第一组-主体资格证据/
│ ├── 1-1营业执照.pdf
│ └── 1-2法定代表人身份证明.pdf
├── 第二组-合同成立证据/
│ └── ...
└── evidence-index.docx
Step 5: 格式转换为PDF
| 源格式 | 转换方案 |
|---|
| 图片(JPG/PNG/TIFF) | img2pdf（保持原分辨率）→ 备选 Pillow |
| Word(.docx) | LibreOffice headless → 备选 pandoc |
| Word(.doc, macOS) | textutil 转 docx → LibreOffice |
| 已是PDF | 保持原样 |
| 多张图片同一证据 | 合并为一个PDF |
转换失败时：保留原始文件，标注"待手动处理"，不阻塞其他文件。
Step 6: 编连续页码
- 用 pypdf 统计每份证据PDF页数
- 从第1页起连续编号，按证据目录顺序累加
- 计算每份证据的"起始页-结束页"范围
- 将页码范围回填到证据目录
输出示例：
| 编号 | 证据名称 | 页数 | 页码范围 |
|------|----------|------|----------|
| 1-1 | 营业执照 | 2 | 第1-2页 |
| 1-2 | 法定代表人身份证明 | 1 | 第3页 |
| 2-1 | 技术开发合同 | 15 | 第4-18页 |
输出成果
- 证据册文件夹：按分组+编号命名的PDF文件
- 更新后的证据目录：包含页码范围列，md 输出后询问是否转 Word（见 profile.md「文书 Word 排版规范」）
- 整理报告：总份数、总页数、格式转换记录、异常项
安全规则
- 备份在前 —— 所有文件操作前必须先完整备份原始文件
- 用户确认 —— 匹配关系未经确认不执行文件操作
- 不删除原文件 —— 所有操作基于复制，原始文件保留在备份目录
- 异常中断 —— 任何步骤失败时停止后续操作并报告，不做半成品输出
- 幂等性 —— 重复调用时检测已有结果，询问覆盖/增量/取消
技术依赖
| 工具 | 用途 | 检查方式 |
|---|
| Python 3 | 脚本环境 | python3 --version |
| pypdf | PDF页数读取 | pip install pypdf |
| img2pdf | 图片转PDF | pip install img2pdf |
| LibreOffice | Word转PDF | soffice --version |
运行前检查依赖，缺失则提示用户安装或使用备选方案。
下一步建议
- 证据册装配完成 → 提交法院 / 发送律师
- 需补充证据 →
/evidence-index（更新分组后重新整理）
- 准备开庭 →
/trial-outline（引用证据册页码）
案件管家联动（强制）
本 skill 完成产出后，必须在输出文档之前调用「案件管家」的台账回写协议，六步流程 / 降级 / 不阻塞规则统一由套件 Hub 维护：
协议单一权威源：skills/case-manager/references/downstream-writeback-protocol.md
入口条款：/case-manager SKILL.md §0.7
本 skill 的产出：证据册 PDF / Zip
差异化字段回写：下一步动作 → 递交法院
