Lawd Evidence Timeline Generator

---
name: 证据时间线生成
name_en: lawd-evidence-timeline-generator
displayName: 证据时间线生成
description_en: "Evidence timeline generation skill: extracts time information from user-provided evidence materials, sorts case events chronologically, and produces a Markdown evidence timeline document plus an HTML interactive timeline (mind map). Triggered when users mention keywords such as timeline or event ordering, provide evidence materials to be organized by time, need to visualize how case events developed, or prepare litigation materials. Not for evidence cross-examination, evidence validity assessment, or legal analysis."
argument-hint: "案件证据材料或含时间信息的案件事实"
description: '证据时间线生成技能。根据用户提供的证据材料，自动提取时间信息并按时间顺序整理，生成证据时间线 Markdown 文档和 HTML 思维导图文件。TRIGGER when: (1) 用户提及"时间线"、"时间轴"、"事件排序"、"证据时间线"、"案件时间线"等关键词，(2) 用户提供证据材料并要求按时间整理，(3) 用户需要可视化展示案件事件发展过程，(4) 用户准备诉讼材料需要梳理时间脉络。输出：证据时间线 Markdown 文档 + HTML 交互式思维导图（基于 ECharts）。IMPORTANT: 必须基于用户实际提供的材料内容提取时间信息，严禁编造或推测任何事件；时间必须准确，无法确认的时间需标注"时间不详"。NOT for: 证据质证、证据效力评估、法律分析。'
version: "1.1.0"
categories: ["法律", "证据整理", "时间线", "可视化"]
tags: ["证据时间线", "事件排序", "思维导图", "可视化", "案件梳理"]
icon: "📅"
---

# 证据时间线生成技能

专业的证据时间线生成技能，帮助律师从案件材料中提取时间信息，按时间顺序梳理事件脉络，生成结构化的时间线文档和可视化思维导图。

## 前置条件

**必须**：用户已提供或准备提供以下材料之一：
- 证据材料（合同、协议、往来函件、聊天记录、付款凭证等）
- 案件事实描述（包含时间信息）
- 证据清单或证据说明
- 案件相关文档（PDF、Word、图片等）

若用户未提供任何材料，先询问用户案件基本情况和已有证据材料，不可在无材料的情况下执行生成。

## 约束原则

### 1. 真实性约束
时间线中所有事件、时间、证据信息必须严格基于用户提供的材料提取，**严禁编造、推测或虚构**任何事件 — 错误的时间线会严重误导案件分析和诉讼策略。

### 2. 时间准确性
- 提取的时间必须准确反映材料中的原始时间信息
- 无法确认具体日期的事件，使用最精确的描述（如"2019年3月"、"2019年初"、"时间不详"）
- 同一事件有多个时间信息时，以关键行为发生时间为准
- 所有时间统一格式：YYYY年MM月DD日（完整日期）、YYYY年MM月（仅月份）、YYYY年（仅年份）

### 3. 完整性要求
- 材料中所有包含时间信息的事件都应提取并列入时间线
- 不得自行筛选或遗漏重要事件
- 若时间信息存在矛盾，在时间线中标注并提示用户确认

### 4. 逻辑性要求
- 事件必须严格按时间顺序排列（从早到晚）
- 同一日期多个事件按逻辑顺序排列
- 相关事件应归类到同一分组（如"合同签署阶段"、"履约阶段"、"违约阶段"、"诉讼准备阶段"等）

## 不适用场景

本技能**不适用于**以下场景：
- **证据质证意见撰写** → 使用 `综合证据策略` 模式A（综合证据分析）
- **证据合法性审查** → 使用 `综合证据策略` 模式A（综合证据分析）
- **法律分析或案件评估** → 使用 `律师办案小结`
- **类案检索** → 使用 `律师类案检索与报告`

## 工作流程

**以下阶段必须严格按顺序执行。每个阶段必须在前一阶段完成后才能开始，不得跳步。**

### 阶段一：材料接收与时间信息提取

1. **接收用户材料**：
   - 用户可能以文字描述、文件上传、或粘贴文本形式提供材料
   - 若材料不清晰或缺失关键时间信息，主动询问补充

2. **提取案件基本信息**：
   - 案件名称/项目名称
   - 当事人信息（甲方、乙方、丙方等）
   - 协议编号（如有）
   - 担保人信息（如有）

3. **提取时间事件信息**：
   对每份证据材料提取以下信息：

   | 提取字段 | 说明 | 示例 |
   |----------|------|------|
   | **时间** | 事件发生的具体时间 | "2019年3月25日"、"2019年3月"、"2019年初" |
   | **事件描述** | 简要描述事件内容 | "合作协议签署"、"保证金支付3000万" |
   | **证据来源** | 该事件对应的证据名称 | "合作协议"、"电子回单" |
   | **页码** | 证据在材料中的页码；材料无物理页码时用条款编号替代（如"协议书§3.1"、"附件4§1"），不得留空或写"P-" | "P1-10"、"P11"、"通用条款§6.2.1" |
   | **事件类型** | 事件分类 | "合同签署"、"付款"、"违约"、"催告"、"诉讼准备" |
   | **关键金额** | 涉及的金额（如有） | "3000万"、"450万"、"10万" |
   | **备注** | 其他重要信息 | "截止日期"、"约定节点" |

4. **时间信息标准化**：
   - 统一时间格式：YYYY年MM月DD日、YYYY年MM月、YYYY年
   - **相对时间零推算（强制）**：如"交付后10日内"、"签署后3日内"等相对表述，**仅当触发日期在材料中已确认时**才换算为绝对日期；触发日期未确认的一律**保留原文相对表述**，备注标注"待实际发生后确定"，**严禁基于假设推算绝对日期**
   - 模糊时间处理：如"2019年初"保持不变，在备注中标注"时间不精确"

### 阶段二：时间线整理与分组

1. **按时间排序**：
   - 所有事件严格按时间从早到晚排序
   - 同一日期的多个事件按逻辑顺序排列（如"上午签约"→"下午付款"）

2. **事件分组**（建议分组，可根据案件调整）：
   - **案件基本信息**：当事人、协议编号、合作项目等
   - **前期准备阶段**：意向书、股东会决议、尽职调查等
   - **合同签署阶段**：协议签署、担保设定等
   - **履约阶段**：付款、交付、验收等
   - **违约阶段**：未履行、延迟履行、质量不合格等
   - **催告与协商阶段**：法务函、律师函、协商会议等
   - **诉讼准备阶段**：律师费、保险费、保全申请等
   - **约定期限与条件**：条件触发型约定（见下方专项规则）

   **条件触发型事件专项规则（强制）**：材料中仅有触发条件、无确定发生时间的事件（如"逾期交付时按日计违约金"、"设计不合格时重做"、责任上限条款等），**不参与时间排序**，统一归入「约定期限与条件」分组，分组标题标注"按类型排列，非时间排序"。此类事件不计入"严格按时间排序"的合规判定；其中纯条款约定（如违约金上限、赔偿上限）不含时间信息的，作为该分组的备注条目列出，不作为独立时间事件。

3. **关键节点标注**：
   - 合同生效日
   - 重要付款截止日
   - 违约发生日
   - 诉讼时效节点
   - 合同期限届满日

### 阶段三：Markdown 时间线文档生成

生成结构化的 Markdown 时间线文档，**以时间线为主**，仅包含案件基本信息和时间线事件；不得额外生成“关键争议点”“证据清单”“法律分析意见”等章节。格式如下：

```markdown
# {案件名称} - 证据材料时间线

## 案件基本信息

| 项目 | 内容 |
|------|------|
| 案件名称 | {案件名称} |
| 协议编号 | {协议编号，如无则省略或标注未提供} |
| 甲方 | {甲方名称，如无则省略} |
| 乙方 | {乙方名称，如无则省略} |
| 其他当事人 | {其他主体，如无则省略} |

## 时间线事件

### {时间分组1}（如：前期准备阶段）

#### {YYYY年MM月}

| 时间 | 事件 | 核心摘要 | 证据 | 页码 | 备注 |
|------|------|----------|------|------|------|
| YYYY-MM-DD | {事件标题或简要描述} | {1-2句核心法律事实摘要} | {证据名称} | P{页码} | {备注} |

### {时间分组2}（如：合同签署阶段）

...

---

**生成日期**：YYYY年MM月DD日
**材料来源**：{用户提供的材料说明}
```

**禁止输出**：Markdown 文档中不再生成“关键争议点”“证据清单”章节；如用户另行需要，应作为独立任务或附加输出处理。

### 阶段四：HTML 可打印时间线生成

调用 Python 脚本生成**适合 A4/A3 打印的静态 HTML 时间轴**，所有事件完全展开无需点击。

**脚本路径**：`scripts/generate_timeline_print.py`

**使用方法**（`--mode timeline` 必传，生成纵向时间轴；不传时脚本默认亦为 timeline）：
```bash
cd {skill_directory}
python3 scripts/generate_timeline_print.py \
  --case-name "{\u6848件名称}" \
  --output "outputs/{\u6848件名称}_\u65f6\u95f4\u7ebf.html" \
  --data-file "{JSON\u6570\u636e\u6587\u4ef6\u8def\u5f84}" \
  --mode timeline
```

**数据格式（JSON）**：

仅需提供 `timeline` 字段（按月分组格式）。**month 字段格式（强制）**：严格使用"YYYY年MM月"或"YYYY年MM月-YYYY年MM月"，**不得附加括号说明**（如"2025年2月（合同生效后）"为错误写法），补充说明一律移入事件的 `note` 字段：

```json
{
  "case_name": "案件名称",
  "timeline": [
    {
      "month": "2019年2月",
      "events": [
        {
          "date": "2月25日",
          "event": "股东会决议",
          "summary": "公司股东会通过决议，授权管理层签署本次合作销售协议及相关担保文件。",
          "evidence": "股东会决议书",
          "page": "P32",
          "amount": "",
          "note": ""
        }
      ]
    },
    {
      "month": "2019年4月",
      "events": [
        {
          "date": "4月1日",
          "event": "保证金支付",
          "summary": "乙方依约向甲方支付3000万元保证金，合同约定合作期满后予以退还，逾期按日千分之一计罚息。",
          "evidence": "电子回单",
          "page": "P11",
          "amount": "3000万",
          "note": "合同约定3月29日前支付，实际于4月1日支付"
        }
      ]
    }
  ]
}
```

**事件字段说明**：

| 字段 | 必填 | 说明 |
|------|------|------|
| `date` | ✅ | 日期（如"4月1日"、"2019年4月1日"） |
| `event` | ✅ | 事件标题（简短，10字以内） |
| `summary` | **强烈建议** | **核心信息摘要**：1-2句话说明该事件的法律意义、关键条款或事实背景，由 AI 提炼生成 |
| `evidence` | 可选 | 对应的证据名称 |
| `page` | 可选 | 证据页码（如"P11"、"P1-10"）；材料无物理页码时用条款编号替代（如"协议书§3.1"），不得留空或写"P-" |
| `amount` | 可选 | 涉及金额（如"3000万"），有则显示橙色金额标签 |
| `note` | 可选 | 补充备注（如时间偏差、矛盾点等） |

**`summary` 字段生成要求（必读）**：

在构建 JSON 数据时，AI 必须为每个事件提炼 `summary`，撰写要点如下：
- **长度**：1~2句，30~80字
- **内容**：从证据材料原文中提炼该事件的核心法律事实，包括关键主体、行为、金额、期限或法律后果
- **语言**：简洁客观，使用法言法语，无需主观判断
- **禁止**：不得编造材料中未提及的事实
- **矛盾事件分工（强制）**：事件本身含时间/条款矛盾时，`summary` 只写法律事实本身（如"合同约定设计周期为10天"），矛盾说明写入 `note` 字段（如"⚠ 专用条款§X 另约定20天，两处矛盾，待用户确认"），不得在 summary 中只描述矛盾而不写事实

| 事件类型 | summary 示例 |
|---------|-------------|
| 合同签署 | "甲乙丙三方签署合作销售协议，约定乙方代理锦溪项目销售，合作期自签署日起至2019年9月29日，甲方支付佣金450万并退还保证金。" |
| 付款行为 | "乙方通过银行转账向甲方支付保证金3000万元，合同约定3月29日前完成，实际付款日期为4月1日，迟延3天。" |
| 违约事件 | "甲方未能在约定的8月15日前取得预售许可证，依合同构成违约，应向乙方支付佣金450万元。" |
| 催告函件 | "乙方通过律师向甲方发出法务函，要求其在收函后15日内退还保证金3000万并支付违约金，否则提起诉讼。" |
| 诉讼准备 | "乙方委托律师代理本案，支付律师费10万元，同时投保财产保全保险，保全金额3758.75万元。" |

**事件类型自动识别**（根据 `event` 关键词自动着色，下表与脚本 `TYPE_RULES` 保持一致）：

| 类型 | 颜色 | 触发关键词 |
|------|------|------------|
| 合同签署 | 深蓝 | 合同、协议、签署、签订、签字、盖章、合作协议、补充协议 |
| 付款/资金 | 绿色 | 付款、支付、缴纳、转账、回款、保证金、押金、定金、佣金、货款、工程款、结算、万元 |
| 违约/逾期 | 红色 | 违约、逾期、未履行、拒绝、拒付、未支付、未取得、未按时 |
| 通知/函件 | 橙色 | 函、通知、律师函、法务函、催款、催告、告知、发函、函件 |
| 约定节点 | 黄褐 | 截止、到期、届满、期限、节点、前、之前、约定、期满 |
| 诉讼准备 | 紫色 | 律师费、诉讼费、保险费、诉讼、保全、仲裁、立案、起诉、开庭、判决、申请 |
| 前期准备 | 蓝灰 | 决议、股东会、尽职、调查、意向、洽谈、备忘录、可行性 |
| 其他（兜底） | 灰色 | 未匹配任何关键词时自动使用默认灰色，不会着色异常 |

**输出文件**：
- 文件路径：`outputs/{案件名称}_时间线.html`
- 文件格式：纯 HTML + CSS，无需网络、无需 CDN
- 打印方式：浏览器打开后点击"打印 / 存为 PDF"按钮
- 页面规格：
  - 默认 **A4 纵向**（210mm × 297mm，边距 15mm）
  - 页面内点击"切换 A3 / A4"可切换为 **A3 纵向**（297mm × 420mm）
- 功能特性：
  - ✅ 所有事件完全展开，无需交互
  - ✅ 纯静态文件，直接用浏览器打开即可
  - ✅ 自带打印/PDF 按钮
  - ✅ A4/A3 一键切换
  - ✅ 事件按类型自动着色
  - ✅ 事件卡片防分页断行（page-break-inside: avoid）

### 阶段五：输出与确认

1. **提供文件路径**：
   - Markdown 文档：`outputs/{案件名称}_时间线.md`
   - HTML 时间线：`outputs/{案件名称}_时间线.html`

2. **时间线完整性确认**：
   - 向用户展示时间线概览（按月份统计事件数量）
   - 提示用户检查是否有遗漏的重要事件
   - 询问是否需要调整事件分组或补充说明

3. **关键节点提示**：
   - 标注诉讼时效相关节点
   - 提示可能已过期或即将过期的权利
   - 仅作为时间线备注或后续建议提示，不生成“关键争议点”章节

4. **后续建议**：
   - 建议补充的证据材料
   - 建议进一步核实的时间信息
   - 建议采取的诉讼策略方向

## 输出格式

### 1. Markdown 时间线文档

**文件命名**：`{案件名称}_时间线.md`

**文档结构**：
- 案件基本信息（表格）
- 时间线事件（按分组和月份组织）

**不得包含**：
- 关键争议点章节
- 证据清单章节
- 法律分析意见或诉讼策略章节

**格式要求**：
- 使用标准 Markdown 语法
- 表格对齐清晰
- 时间节点使用加粗标注
- 关键金额使用加粗或高亮

### 2. HTML 可打印时间线

**文件命名**：`{\u6848件名称}_\u65f6间线.html`

**技术栈**：
- 纯 HTML + CSS，无需 JavaScript 库或 CDN
- 兑容现代浏览器（Chrome、Firefox、Safari、Edge）

**视觉设计**：
- 背景：白色打印友好
- 标题区：案件名称 + 生成日期
- 时间轴：左侧日期 + 垂直轴线 + 右侧事件卡片
- 分组展示：按年月显示深色标签小标题
- 事件卡片：左边框着色区分类型

**输出效果（与原 ECharts 思维导图对比）**：

| 对比项 | 原 ECharts | 新可打印版 |
|--------|-----------|------------|
| 展开方式 | 需要点击展开 | 全部自动展开 |
| 打印支持 | 不适合打印 | A4/A3 一键打印 |
| 页面分行 | 没有控制 | 自动防断行 |
| 内容密度 | 展开后节点小 | 全显示内容充分 |
| CDN 依赖 | 需要联网 | 无需网络 |

## 异常处理

### 用户未提供材料
若用户仅说"帮我生成时间线"但无任何案件材料：
- 明确告知用户需要提供的材料类型
- 提供材料清单模板供用户参考
- 不得基于不充分的信息强行生成时间线

### 时间信息缺失
若证据材料中缺乏明确的时间信息：
- 在时间线中标注"时间不详"
- 向用户说明并询问是否可补充
- 不得编造或推测时间

### 时间信息矛盾
若不同证据对同一事件的时间描述不一致：
- 在时间线中同时列出多个时间
- 标注"时间存在矛盾，请用户确认"
- 向用户说明矛盾点并请求澄清

### 材料信息严重不足
若用户提供的材料缺乏关键信息（如无当事人名称、无协议编号等）：
- 在文档中标注"该信息未提供"
- 明确提示用户需要补充的信息
- 不得编造缺失信息

### HTML 生成失败
若 Python 脚本执行失败：
- 检查 Python 环境及 echarts 依赖
- 提供详细的错误日志
- 降级方案：仅提供 Markdown 文档，并在文档中说明"HTML 思维导图生成失败"
- 建议用户检查 Python 环境后重试

## 参考文件说明

本技能包含以下参考文件：

| 文件 | 用途 | 何时使用 |
|------|------|----------|
| references/timeline-print-template.html | 可打印 HTML 时间轴模板 | 生成 HTML 时间线时加载 |
| references/mindmap-template.html | ECharts 思维导图模板 | 备用，主输出已改为可打印版 |
| references/timeline-format.md | 时间线格式规范 | 生成 Markdown 时间线时参考格式和结构 |
| references/event-classification.md | 事件分类指南 | 对事件进行分组和归类时参考 |

## 示例

### 输入示例

用户提供：
```
案件：锦溪颅景御府项目合作纠纷
材料：合作协议、股东会决议、电子回单、法务函、保险费凭证、律师费凭证、保险单
```

### 输出示例

**Markdown 文档**：`锦溪颅景御府项目_时间线.md`
- 包含案件基本信息表格
- 按月份组织的时间线（2019年2月-10月）
- 每个事件包含时间、事件、核心摘要、证据、页码和备注
- 不包含关键争议点、证据清单等非时间线章节

**HTML 时间线**：`锦溪颅景御府项目_时间线.html`
- 垂直时间轴布局，6个月份分组，12 项事件完全展开
- 事件按类型自动着色（合同-蓝、付款-绳、违约-红、函件-橙等）
- 支持 A4/A3 打印，可直接存为 PDF

## 技术实现

### Python 脚本说明

`scripts/generate_timeline_print.py` 脚本功能：
1. 接收 JSON 格式的时间线数据（支持分月分组格式和平铺格式）
2. 基于 `references/timeline-print-template.html` 模板生成可打印 HTML
3. 自动识别事件类型并着色
4. 支持 A4/A3 页面切换

**依赖要求**：
- Python 3.7+
- 无需额外安装包（仅使用标准库）

**执行示例**：
```bash
cd /path/to/lawd-evidence-timeline-generator
python3 scripts/generate_timeline_print.py \
  --case-name "锦溪颅景御府项目" \
  --output "outputs/锦溪颅景御府项目_时间线.html" \
  --data-file "scripts/example_data.json"
```

## 使用场景

| 场景 | 描述 |
|------|------|
| 合同纠纷案件 | 梳理合同签署、履约、违约、催告等时间节点 |
| 建设工程案件 | 整理开工、竣工、验收、结算等关键时间 |
| 劳动争议案件 | 梳理入职、合同签订、工资发放、解除劳动关系等时间 |
| 知识产权案件 | 整理申请日、授权日、侵权发生日等时间线 |
| 侵权损害赔偿 | 梳理侵权行为发生、发现、取证、起诉等时间 |

## 参考资料

- [references/mindmap-template.html](references/mindmap-template.html) — HTML 思维导图模板
- [references/timeline-format.md](references/timeline-format.md) — 时间线格式规范
- [references/event-classification.md](references/event-classification.md) — 事件分类指南
- [scripts/generate_timeline_mindmap.py](scripts/generate_timeline_mindmap.py) — HTML 生成脚本

## 可选套件上下文（不影响独立使用）

1. 工作目录根存在 `套件运行规则.md` 时必须先读取并执行；不存在时以本技能硬规则为准，不影响独立使用。
2. 工作目录根存在 `办案画像.md` 时，只读取与当前任务有关的诉讼立场、风险偏好和文书风格；不存在时按本技能默认运行，不追问、不报错。
3. 仅当用户明确切换到某案或提供唯一案件路径时，读取 `cases/{案件简称}/案件画像.md`；不得猜测案件，不得跨案带入。
4. 画像只影响表达与偏好，不得覆盖事实、法律依据、必备结构、验证结果或本技能硬规则。
5. 已明确绑定唯一案件且案件管家可用时，成果完成后提交标准案件事件；无案件不建档、不回写，回写失败不得阻塞成果交付。