# 代码覆盖率报告

- 日期：2026-08-09
- 工具：`pytest-cov` 7.1.0 / `coverage` 7.15.4
- 范围：`src/genesis`（排除 tests 自身）
- 阈值：`fail_under = 90`（`pyproject.toml` `[tool.coverage.report]`），未达标时 pytest 退出码非 0
- 全量用例：**58 passed，无 skip**
- 输出：终端摘要（`--cov-report=term-missing`）、HTML（`htmlcov/index.html`，已 .gitignore）

## 总览

| 指标 | 值 |
|------|-----|
| 语句总数 | 571 |
| 未覆盖语句 | 12 |
| 分支总数 | 150 |
| 未覆盖分支 | 12 |
| **总覆盖率** | **96.67%** |
| 最低模块 | `table_extractor.py` 88% |
| 最高模块 | 9 个文件 100% |

## 分模块

| 模块 | Stmts | Miss | Branch | BrPart | Cover | 未覆盖行 |
|------|------:|-----:|-------:|-------:|------:|----------|
| `__init__.py` | 1 | 0 | — | — | 100% | — |
| `data_models.py` | 180 | 0 | — | — | 100% | — |
| `excel_reader.py` | 12 | 0 | 2 | 0 | 100% | — |
| `free_text_extractor.py` | 22 | 0 | 10 | 0 | 100% | — |
| `merge_fill.py` | 15 | 0 | 10 | 0 | 100% | — |
| `paragraph_splitter.py` | 17 | 0 | 10 | 0 | 100% | — |
| `provenance.py` | 2 | 0 | — | — | 100% | — |
| `sheet_detector.py` | 20 | 0 | 14 | 0 | 100% | — |
| `config.py` | 128 | 1 | 24 | 1 | 99% | 134 |
| `sheet_nature.py` | 33 | 2 | 18 | 3 | 90% | 26, 32, 40→44 |
| `table_extractor.py` | 24 | 2 | 10 | 2 | 88% | 32, 37 |
| `formatting_detector.py` | 40 | 3 | 20 | 2 | 92% | 15–16, 22, 31→33 |
| `excel_parser.py` | 77 | 4 | 32 | 4 | 93% | 36–37, 61, 66→65, 100 |

## 未覆盖点说明（12 语句 + 12 分支）

主要未覆盖区域属于防御分支 / 异常路径：

- `config.py:134` — `unset(_env)` 分支（枚举加载外的环境变量消除路径）
- `sheet_nature.py:26/32` — 空白行修正 / `value` 缺失兜底
- `table_extractor.py:32/37` — `column_letter` 越界兜底 / 空列头兜底
- `formatting_detector.py:15-22` — 非法 RGB 字符串剔除分支
- `excel_parser.py:36-37,61,100` — 空表跳过、`header_row<0` 回落、无表头 free_text 直接文本化

均为「非法输入 / 防御分支」，非主路径；当前 96.67% 已满足红线 90%。

## 门槛策略

- `pyproject.toml` 已固化 `fail_under = 90`（含 12 个 `branch` 分支统计）
- 每次 `python -m pytest` 默认附带覆盖率检查；未来若引入重业务逻辑（LLM/Writer 里程碑），可将 `fail_under` 抬至 95~98 并补充新用例

## 后续可选增强（非当前阻塞）

- 将 `fail_under` 提升至 95% 时需补上述 12 行（多为防御分支，成本低）
- 可在 CI 中将 `--cov-report=html` 或 junit/xml 纳入流水线归档