# 质量门禁辅助简报（主题锁 · VCR · 国标）

> **版本**：2.1.2 · **层级**：平台侧（CI / S5 / Proofer 参考）


> **冲突裁定声明**：本文件是 `search-policy.json` 机读配置的人类可读摘要；当本文件表述与 `search-policy.json` 字段值冲突时，**以 `search-policy.json` 为准**；当本文件与质量规则文件冲突时，优先级顺序为：**`quality-check.md`（第一权威）→ `metrics.md`（第二权威）→ `quality-PLC.md`（第三权威，各层判断细则）→ 本文件（摘要层，不优先）**。发现冲突须同步修正源文件。
>
> **B3 通过条件裁定（v2.0.1 评审修订）**：B 层通过条件以 `metrics.md §1.5` 为准——**B 层原始分 ≥ 4 分**（满分5，最多允许1个维度未达标）；`quality-PLC.md §B3` 中的「无警告」仅作辅助判断依据，不单独构成 B3 阻断条件。两文件表述冲突时以 metrics.md 为准。

---

## P0 规则速查清单

### S0 阶段 P0（阻断级）

- [ ] **主题锁**：S0 产出首行须含 `**主题**：…` 或 topicLock 一致性
- [ ] **时间戳检查**：RESEARCH 阶段所有联网引用必须带时间标签
- [ ] **S0 维度门禁**：必须通过 5 维度检查（主题、范围、目标、读者、体例）

### S3 阶段 P0（阻断级）

- [ ] **账本原子性**：章节状态表字段完整，无空值
- [ ] **时间标签审计**：所有联网检索结果含 `[[时间:YYYY-MM-DD]]` 标记
- [ ] **术语一致性**：全书术语统一，无同义词混用

### 全局 P0（阻断级）

- [ ] **引用格式**：必须使用 MAT 编号格式（MAT-001、MAT-002...）
- [ ] **真实性承诺**：遵守 §3.2.1 事实绑定写入规则
- [ ] **禁止 AI 味词**：S5 buzzword 黑名单（29 个词汇）禁用
- [ ] **首句具体性**：S1 规则 - 首句必须含人物/场景/数据/问题
- [ ] **消灭冗余修饰**：S2 规则 - A 类程度副词出现次数 = 0（`quality-S.md` 阈值为0次；`aiAdverbMax` 为密度预警上限 12次/千字，二者不冲突：前者是质检通过标准，后者是宽松预警触发值）
- [ ] **连接词降温**：S4 规则 - C 类连接词控制
- [ ] **标点纪律**：S6 规则 - 顿号/冒号/感叹号阈值

### P1 重要级（强烈建议，含 S3 短句规则）

- [ ] **短句优先**：S3 规则 - 超40字句占比 < 10%（`quality-S.md` 定为 **P1 预警**，非 P0 阻断；`quality-auditor-lite.mjs` 已对齐至10%阈值；>8% 触发 P1 预警，>10% 阻断）

### P1 重要级（强烈建议）

- [ ] **问题驱动**：P1 规则 - 段落开头提出问题
- [ ] **对话代替转述**：P2 规则 - 引用直接对话
- [ ] **禁止对称排比**：P3 规则 - 避免整齐对仗
- [ ] **拒绝注水**：P4 规则 - 禁止空洞描述
- [ ] **承认局限**：C1 规则 - 明确陈述不确定性
- [ ] **结尾指向行动**：C2 规则 - 结尾有实践建议
- [ ] **打破结构均匀**：C3 规则 - 段落长度多样性
- [ ] **数据具体性**：C4 规则 - 数字精确到单位
- [ ] **全局节奏综合**：B3 规则 - 段落节奏变异系数 ≥ 0.3，避免全书节奏恒温（已在 `quality-auditor-lite.mjs` 实现）

### P2 建议级（择机优化）

- [ ] **标题编号唯一**：B0 规则 - 避免重复标题
- [ ] **段落节奏**：B2 规则 - 段落长度合理分布
- [ ] **标点多样性**：B2 规则 - 避免单一标点过度使用

---

## 一、主题一致性门禁（C0-4）

**机读配置**：[`search-policy.json`](./search-policy.json) 的 `topicLock`

**P0 要点**：
- S0 及后续阶段产出首行须含 `**主题**：…`，与 `topicLock.s0Output.mustInclude` 一致。
- 读取宿主记忆摘要、切换书稿后并让 Writer 开始写前，须核对主题与当前本书一致；漂移时 **ASK_CONFIRMATION**，禁止静默切换语境。
- 见 [`book-level-consistency.md`](../02-quality/book-level-consistency.md) C0-4、[`section-nlu.md`](../01-core/section-nlu.md) 首响优先级协同。
- `userMemoryIntegration.mustPassGatesBeforeUse` 的 `topicConsistencyGate` → `C0-4`：注入记忆摘要前须通过本书主题锁。
- **aiAdverbMax**：`search-policy.json` 的 `qualityGate.aiAdverbMax`（默认 **12**）为 **A 类程度副词每千字上限**（次/千字）；超出触发 `AI_FLAVOR_OVERUSE` 告警，与 `quality-S.md` S2 规则对应。

---

## 二、VCR 自动化启发式（P2）

**完整 VCR 人工标准**：[`quality-check.md`](../02-quality/quality-check.md) · [`08-visual.md`](../03-product/08-visual.md)

CI / S5 前置不做完整 VCR 语义评分时，使用 `scripts/quality-auditor.mjs --vcr-heuristic-warn` 执行下列 3 条机读启发式：

| 代号 | 条件 | 含义 |
|------|------|------|
| **VCR-H1** | 存在 `![]()` 或 `![空白](https://example.com)` 形式图片 Markdown | 缺 alt 不利于无障碍与版式审查 |
| **VCR-H2** | `<!-- ILLUST: ... -->` 整块中缺少 `prompt:` | 插图意图未结构化，无法复现或外发绘制 |
| **VCR-H3** | 汉字 ≤ 1000 字内 Mermaid 代码块密度过高 | 图多文少风险，需确认每图有正文解释 |

```bash
node scripts/quality-auditor.mjs --skill-root <技能根> --glob "chapters/*.md" --vcr-heuristic-warn
```

命中任一条时报告明细；`--vcr-heuristic-warn` 下退出码 1（可选门禁）。
**V1 视觉密度**计数含：Mermaid、Markdown 表格、`![...](https://example.com)`、`<figure>`、完整闭合的 `<!-- ILLUST: ... -->` 块。

---

## 三、国家标准与编校对照（摘要）

**深度排版**：[`06-typography.md`](../03-product/06-typography.md) · [`quality-check.md`](../02-quality/quality-check.md)

**Proofer / 终校**：当对外承诺「编校合格」时，除本书 S/P/C/B 规则外，须参照 **CY/T 266—2023**、**GB/T 15834/15835**、**7714** 等与稿件类型相关的对照（全书尺度）。

- 本书 **C0/S6** 规则**不替代**国标全套计错；二者并行。
- 具体条目以出版社/机构要求为准；本节提供对齐意识与缺口提示，非替代表格全文。

---

## 四、核心评分体系摘要

**完整评分规则**：[`quality-check.md`](../02-quality/quality-check.md) · [`metrics.md`](../02-quality/metrics.md)

| 层 | 名称 | 当前规则数 | 层内满分 | 全书建议通过线 | S3 阶段加严线 | 当前口径 |
|-----|------|-----------|---------|---------------|--------------|---------|
| **S** | 句级（语言质量） | **6 条** | **10 分** | **≥7.5** | **≥8.3** | `通过条数 ÷ 6 × 10` |
| **P** | 段级（逻辑结构） | **4 条** | **10 分** | **≥7.5** | — | `通过条数 ÷ 4 × 10` |
| **C** | 章级（内容完整） | **4 条** | **10 分** | **≥7.5** | — | `通过条数 ÷ 4 × 10` |
| **B** | 篇级（全书一致） | **6 条**（含 `B0`） | **10 分** | **≥6.7** | **≥6.7** | `通过条数 ÷ 6 × 10` |
| **V1** | 视觉密度 | 附加观测项 | **10 分** | 只记录，不并入综合分 | — | 达标记 10，否则记 0 |
| **综合** | 综合分 | — | **10 分** | **≥7.5** | **S≥8.3 且 S+C≥16** | `(S + P + C + B) ÷ 4` |

> **S3 加严说明**：当前按 10 分制口径执行，S3 验收阶段建议同时满足 **S 层 ≥ 8.3** 与 **S+C 合计 ≥ 16**；如与脚本或机读配置冲突，以 `search-policy.json` 的 `qualityGate` 字段为准。

**关键阈值**：

- **综合分 ≥ 7.5**：通过，可进入下一阶段（`qualityGate.minOverallScore`）。
- **7.0 ≤ 综合分 < 7.5**：弱通过，建议修订后复审（`qualityGate.weakPassFloor`）。
- **综合分 < 7.0**：不通过，暂停推进。
- **B 层 < 6.7/10**：触发篇级一致性告警（`qualityGate.minBLayerScore`）。
- **AI 对比度 >8%**：触发去 AI 味提示（`qualityGate.aiContrastMax`）。
