---
name: evidence-table
description: 证据矩阵规范。规定每条核心结论必须有对应的证据记录，格式、字段、置信度分级和文件结构。dr-analyst 撰写初稿时使用，dr-verifier 追加反方证据时使用，dr-chief-editor 审校时作为核验基准。
---

# 证据矩阵规范

## 核心原则

**每条结论必须可追溯**。报告中每一个有 [src_xxx] 标注的观点，都必须在对应章节的 evidence 文件中有一行记录。

Antigravity native 模式下，证据不能只停留在模型上下文或章节草稿里。除章节 evidence markdown 外，还必须维护机器可审计的 claim ledger，让 Phase 3/4 可以逐条核验。

---

## Antigravity Native 证据落盘

Phase 2 必须至少维护以下文件：

- `projects/<slug>/phase2/search_log.jsonl`：检索、打开、抽取的回执
- `projects/<slug>/phase2/sources.jsonl`：稳定 source registry
- `projects/<slug>/phase2/claims_ledger.jsonl`：原子 claim 台账
- `projects/<slug>/phase2/coverage_matrix.md`：章节/任务覆盖矩阵
- `projects/<slug>/phase2/unsupported_claims.md`：未证实或仅弱证据支持的观点

`claims_ledger.jsonl` 每行必须是一个原子事实或判断，字段至少包括：

```json
{
  "claim_id": "ch03_C012",
  "chapter": "ch03",
  "claim_type": "fact|trend|comparison|causal|forecast|recommendation",
  "claim": "...",
  "supporting_source_ids": ["src_042", "src_087"],
  "counter_source_ids": ["src_103"],
  "evidence_spans": [
    {
      "source_id": "src_042",
      "locator": "Table 2",
      "summary": "..."
    }
  ],
  "confidence": "high|medium|low|unsupported",
  "verification_status": "verified|partially_verified|conflicted|unsupported",
  "needs_delta_retrieve": false,
  "visible_caveat_required": false
}
```

正文、章节 evidence markdown、`claims_ledger.jsonl` 三者必须能互相对上：

- 正文的 `Cxx/Fxx/Txx` ID 必须在 evidence markdown 和 `claims_ledger.jsonl` 中存在；
- `claims_ledger.jsonl` 中 `verification_status=unsupported` 的 claim 必须进入 `unsupported_claims.md`；
- `needs_delta_retrieve=true` 的 claim 必须补做定向检索，或在正文显式降级；
- Phase 4 不得新增未进入 claim ledger 的事实。

---

## 证据矩阵文件格式

文件路径：`projects/<slug>/phase2/evidence/chXX-evidence.md`

### 文件结构

```markdown
# 第 X 章 <标题> — 证据矩阵

生成时间：<datetime>
研究员：dr-analyst
字数统计：<N> 字 / 配额 <N> 字

---

## 核心结论证据表

| 结论 ID | 观点摘要（≤30字） | 支持证据 1 | 支持证据 2 | 置信度 | 备注 |
|---|---|---|---|---|---|
| C01 | <观点> | [src_001] <标题> Tier1 | [src_002] <标题> Tier2 | 高 | |
| C02 | <观点> | [src_003] <标题> Tier2 | **[待验证]** 仅 1 个来源 | 中 | 需补充 |
| C03 | <观点> | [src_004] <标题> Tier1 | [src_005] <标题> Tier1 | 高 | |

---

## 置信度说明

- **高**：2 个以上独立 Tier 1-2 信源支持，无重大反方证据
- **中**：只有 1 个 Tier 1-2 信源，或有轻微反方证据
- **低**：仅 Tier 3 信源，或有实质性反方证据
- **[待验证]**：找不到第 2 个独立信源，在正文明确标注

---

## 信源详情

<!-- 每条 [src_xxx] 的完整信息 -->

**[src_001]**
- 标题：
- 作者/机构：
- 年份：
- URL/DOI：
- Tier：1
- 评分：8.5
- 摘要（2-3句）：

**[src_002]**
...

---

## 反方证据（dr-verifier 填写）

<!-- dr-verifier 完成后追加以下内容 -->

### 验证摘要
- 核验结论数：X
- 发现反方证据：X 条
- 补足待验证：X 条
- 重大挑战：X 条

### 反方证据详情

#### 针对结论 C01：<观点摘要>
- 反方证据：<内容>
- 来源：[src_xxx] | Tier X
- 处理建议：保留并注明争议 / 修改措辞 / 删除

<!-- 如有重大挑战 -->
CRITICAL: <说明>
```

---

## 正文中反方证据段落的写作规范（v0.8 新）

### 标题必须观点化，不能叫 "反驳证据 / Counter-Evidence"

**问题诊断**：v0.7 发现每章末尾 dr-analyst 会机械地写 `## 反驳证据`，标题重复而空洞，读者看了没有信息增益。

**新规则**：正文反方证据段落的标题必须：

1. **用二级 H2 或三级 H3 标题**（统一层级，禁止用加粗段冒充标题）
2. **包含具体判断**，不要用"反驳证据" / "反方证据" / "Counter-Evidence" 这种模板化命名
3. 至少要回答：**"对前述论点的哪一方面提出了什么挑战？"**

### 可接受的命名示例

| ✗ 不推荐 | ✓ 推荐 |
|---|---|
| 反驳证据 | 另一种声音：管线虚胖还是真实进展？ |
| Counter-Evidence | 需要补充判断的副作用：汇聚偶联收率可能被高估 |
| 反方观点 | 反例：Codexis ECO 并非所有情境都优于 SPOS |
| Counter Arguments | 值得警惕的数据：临床前到 IND 的衰减率 |

### 段落结构模板（推荐）

```markdown
## <观点化标题>

虽然上文论证了 <核心观点>，但以下证据提示需要**有限度地**接受这一判断：

1. **<反方论点 1>**：<具体数据或案例> [src_xxx]。影响评估：<说明>
2. **<反方论点 2>**：<具体数据或案例> [src_xxx]。影响评估：<说明>

综合而言，核心结论仍成立，但需在 <某个具体维度> 上留出缓冲。
```

### 禁止的写法

- 单独用 **加粗段** 冒充反方证据标题（`**反方证据：** ...`）
- 反方证据后不做整合判断，只是堆数据
- 在每个小节末尾都加反方证据（只在章末加一次即可；若小节级别有重大挑战，写在小节正文里即可）

---

## 置信度分级标准

| 置信度 | 条件 | 正文处理方式 |
|---|---|---|
| 高 | ≥2 个独立 Tier 1-2 信源，无 CRITICAL 反方 | 直接陈述 |
| 中 | 1 个 Tier 1-2 信源，或有轻微反方 | 陈述 + "但部分研究认为..." |
| 低 | 仅 Tier 3，或有实质反方 | 必须加 "[待验证]" 标注 |
| [待验证] | 无法找到第 2 个独立来源 | 正文明确写 "该观点仅有 1 个来源支持，待验证" |

---

## 结论 ID 命名规则

- `C01`-`C99`：正向核心结论
- `F01`-`F09`：事实性陈述（不需要观点判断）
- `T01`-`T09`：趋势判断（通常需要时间序列数据支撑）

dr-analyst 在撰写草稿时，给每个有 [src_xxx] 的观点分配一个 ID，在草稿和 evidence 文件里保持一致。

---

## 硬性规则

1. 草稿中每个 [src_xxx] 必须在 evidence 文件里有对应行
2. 草稿中标注 `[待验证]` 的观点必须在 evidence 表里有对应行（置信度列写"低/待验证"）
3. dr-verifier 只能在"反方证据"段落追加，不能修改"核心结论证据表"
4. CRITICAL 标注的问题，dr-chief-editor 审校时必须明确处理（不能忽略）