# docx 交付件模板

> 由 Audit Agent 在阶段 3 读取，用于生成客户交付件。

---

## docx 交付件

docx 是**客户交付件**,聚焦漏洞的黑盒复现,不堆项目细节。和 md 完整报告是两个产物。

**docx 交付件只含**:

- 封面:系统名 + 目标 + 测试时间 + 漏洞统计(严重/高/中/低计数)
- 每个确认漏洞一节:漏洞概要 / 影响范围 / 复现步骤 / 漏洞数据包 / 漏洞证明 / 修复建议(简述)
- **不含**:覆盖率、测试账号矩阵、功能测试明细、系统级审计、参考信息(CWE/CVSS)、攻击链、盲区清单

**交付件 md 结构**(渲染器输入,渲染后删除;漏洞按等级降序:严重→高→中→低):

```markdown
# {系统名} 渗透测试报告

> 目标: https://...
> 测试时间: YYYY-MM-DD
> 漏洞统计: 严重 x / 高危 y / 中危 z / 低危 w

---

## 一、{漏洞标题}（{等级}）

### 漏洞概要
（2-3 段,客观直白,去 AI 化套话;说清是什么漏洞、能做什么）

### 影响范围
- （量化:用户量级 / 数据范围 / 可执行操作 / 最大危害）

### 漏洞复现
1. （第一步操作描述）

2. （第二步操作;如有数据包穿插在对应步骤后）
```
请求:
...
响应:
...
```

3. （后续步骤同理,数据包紧跟对应步骤）

**结果**:（说明漏洞最终影响,越权类给 baseline vs attack 对比）

### 修复建议
- （2-4 条,简述,不分 P0/P1 不分短期长期,直接列要点）

---

## 二、{下一个漏洞}（{等级}）
（结构同上）
```

**流程**:

1. 按上述结构写交付件内容,Write 成临时 `pentest-report/{project-id}-deliverable-tmp.md`(首部必须 `# 标题` + `>` 引用块 + `---`)
2. 执行 `python3 t/001.py pentest-report/{project-id}-deliverable-tmp.md pentest-report/{project-id}-{系统名}-pentest-{YYYYMMDD}.docx`
3. `python-docx` 未安装先 `pip3 install python-docx`
4. 确认 `SAVED` 后删除临时 md:`rm pentest-report/{project-id}-deliverable-tmp.md`
5. 最终 pentest-report/ 留:完整报告 `.md` + 交付件 `.docx`

渲染脚本位置:`t/001.py`。
