# 质量门禁（Quality Bar）

对照参考篇：`tech-articles/hadoop-ecosystem-deep-dive/hadoop-ecosystem-deep-dive.html`。

生成或重写完成后，运行：

```bash
python3 tech-articles/_shared/gate_check.py tech-articles/<slug>/index.html
```

退出码 0 才算达标。

## 硬门槛

| 项 | 要求 |
|---|---|
| 汉字（去 script/style/pre） | 8000～12000（甜点 9000～11000） |
| 自制 SVG | ≥5（`<svg` 计数；Mermaid 不算） |
| 证据 callout | ≥4，且 `fact`/`trap`/`prod`/`infer` 至少覆盖 3 类 |
| `src-note` | ≥3（含可点击官方文档链接） |
| `scene-box` | ≥1 |
| 决策矩阵 | 正文含「决策矩阵」或表头含「继续/迁移/选型」类权衡列，或存在 `pro-con-card` 对照 |
| 视觉壳 | 含 `--bg:#020617` 与 `diagram-card`（暗色 deep shell） |
| emoji | 0 |
| 复合场景 | 虚构案例须含「复合场景」字样 |

## 结构期望（8～10 章）

1. 问题现场  
2. 体系总览 / 概念地图（SVG）  
3. 核心机制（多章）  
4. 适合 / 不适合  
5. 生产实践或排障/治理  
6. 决策框架收尾 + 相邻知识地图 + ref-list  

## 反例（不达标）

- 只换 CSS、正文仍是浅 Part 罗列  
- 仅用 Mermaid 凑图、无自制 SVG  
- 无来源的性能数字 / 默认值  
- 丢掉初稿已有深度 SOP/案例后另起空文（除非初稿本身无可迁移内容）  
- 图题写「架构图」而不写具体机制名  

## 内容保全式重写顺序

1. 读参考篇结构 + 现有 index.html → 可迁移素材清单  
2. 整文件写入暗色壳  
3. 迁移并升格素材 → 补 SVG / callout / src-note / 决策矩阵  
4. 跑 `gate_check.py`