,替换为 data: URI
data_uri = f"data:image/png;base64,{base64.b64encode(png_bytes).decode('ascii')}"
```
- 8 张 PNG 全部内嵌(主图 1 + LP 全景图 1 + 子页决策树 N)
- 单文件目标 < 25 MB(主流邮箱附件上限)
#### B) 跨文件链接 → 锚点跳转
- 主页 `href="page_
子页 ·
` / `` / `` 并构建树
- 子页 anchor 通过 `prefix_id="page-{key}-"` 自动加前缀,不会与主页冲突
**Iron Law(v1.3.1 修复 · 2026-04-25 用户反馈)**:
1. **主报告分组必须过滤 `page-*` 前缀 anchor**:`extract_headings(main_html)` 在合并后的 HTML 上调用会同时抓到主页和已合并的子页 h1/h2(id 已带 `page-{key}-` 前缀)→ 必须 `if anchor.startswith("page-"): continue` 过滤,否则主报告分组会出现 N 套重复且无归属(图中症状:连续 6 套"双分支决策树/Market 测算/TOP 3 LP/关键证据"无子页归属)
2. **禁用 backdrop-filter: blur**:9 MB+ 大文档下 `backdrop-filter: blur(2px)` 会让浏览器对整个 viewport 强制重排重绘 → 鼠标延迟高、卡顿。改用 `background: rgba(15,23,42,0.35)` 半透明纯遮罩(GPU 友好)
3. **过渡时长 ≤ 150ms · 动画用 `@keyframes` 而非 `transition`**:opacity transition 130ms · panel 用 `animation: ftoc-pop 0.14s ease-out`,加 `will-change: opacity/transform` 提示合成层
4. **打开用 `requestAnimationFrame` 而非 `setTimeout(10)`**:确保 hidden 切换后下一帧才加 .show class(避免动画跳过)
**血液科 v2.5.3 实测**:92 个目录条目自动提取(主页 30+ + 6 子页各 ~10),HTML 体积 +0.02 MB(可忽略)。
#### E.6) 子页 sticky topnav 在合并版隐藏
```css
.standalone-subpage .topnav { display: none !important; }
.standalone-subpage { margin-top: 60pt; padding-top: 30pt; border-top: 4pt double var(--navy); page-break-before: always; }
.standalone-divider { display: flex; justify-content: space-between; background: linear-gradient(90deg, var(--navy) 0%, var(--blue) 100%); color: #fff; padding: 12pt 18pt; border-radius: 6pt; }
```
原因:合并后所有锚点都在同一文档,子页 topnav 失去意义且会污染滚动。
### 6.4 复用脚本骨架(从 build_standalone.py 抽取)
**完整参考实现**:`/build_standalone.py`(血液科 v2.5.3 验证可用)
```python
from pathlib import Path
import base64, re
from dataclasses import dataclass
# ===== 配置常量(跨疾病移植仅改这里)=====
OUT = Path(__file__).parent
MAIN_HTML = OUT / "report_v??.html"
SUB_PAGES: list[tuple[str, Path]] = [
("", OUT / "page_.html"),
("", OUT / "page_.html"),
# ... N 个子页
]
OUTPUT_HTML = OUT / "report_v??_standalone.html"
@dataclass(frozen=True)
class SubPage:
key: str; title: str; body_html: str; head_style: str
# ===== 核心五函数 =====
def extract_subpage(path, key) -> SubPage: ... # 提取子页 body + 重写主页链接
def png_to_base64(path) -> str: ... # PNG → data: URI
def inline_all_png(html, base_dir): ... # 批量替换
def rewrite_subpage_links(html) -> str: ... # 主页 page_*.html → #page-*
def build_section_for_subpage(sub) -> str: ... # 子页 body →
def merge():
# 1) 读主页 + N 子页
# 2) 注入 extra CSS(.standalone-* 系列)
# 3) 重写主页跨文件链接
# 4) 后注入 + banner
# 5) 前插入 N 个子页 section
# 6) inline_all_png 全文 PNG 内嵌
# 7) 写出 + 验证
```
### 6.5 ~~配套 PDF 生成~~(v1.2 已停用 · 2026-04-25)
> ❌ **本节已停用**:用户最终明确"以后交付全部交付 HTML,不再交付 PDF"。
> 单 HTML 是终态交付物 — 决策树原画质 base64 内嵌、锚点跳转、零依赖,完全覆盖 PDF 所有场景。
> 读者若需打印,在浏览器中按 `Ctrl+P` 自行另存为 PDF — **生成方不再主动产出 PDF**。
> Chrome headless / playwright 命令仅作历史归档保留(失败模式 #11)。
### 6.6 验证清单(交付前必过)
- [ ] **文件大小** < 25 MB(邮件附件可发)
- [ ] **锚点跳转**:点击主页任一 disease-card → 平滑滚到对应子页 section
- [ ] **回退链**:每个子页内 "↑ 回到主页顶部" 工作正常
- [ ] **PNG 内嵌**:N+1 张 PNG 全部用 `data:image/png;base64,...` 内嵌(grep 计数)
- [ ] **零外部依赖**:断网双击打开,所有图、所有跳转、所有样式都正常
- [ ] **banner 提示**:文件顶部"📦 单一独立 HTML 版"横幅可见
- [ ] **悬浮目录导航**(v1.3 Iron Law):右上角目录按钮可见,点击展开主报告 + 全部 N 子页全量目录(h1/h2 全提取),点击外部/Esc 关闭,@media print 隐藏
- [ ] ~~PDF 验证~~ — v1.2 不再交付 PDF,本项删除
### 6.7 跨疾病移植清单
| 配置项 | 改动 | 示例(呼吸科 ICU 真菌) |
|-------|------|----------------------|
| `MAIN_HTML` | 🟡 改 | `report_resp_v??.html` |
| `SUB_PAGES` | 🟡 改 | `[("RICU_CAPA", ...), ("PCCM_CPA", ...), ...]` |
| `OUTPUT_HTML` | 🟡 改 | `report_resp_v??_standalone.html` |
| `extract_subpage()` 中主页文件名正则 | 🟡 改 | `r'href="report_resp_v??\.html"'` |
| 五个核心函数(extract / inline / rewrite / build / merge)| ✅ 直接复用 | — |
| extra CSS(.standalone-* 系列)| ✅ 直接复用 | — |
| banner 文案 | 🟡 改版本号即可 | — |
| ~~Chrome headless PDF 命令~~ | ❌ v1.2 已停用 | 不再交付 PDF |
### 6.8 Iron Law(本阶段强制条款)
**报告交付前必须生成单文件 HTML 版本(v1.2 更新 · 仅 HTML 交付)**:
- 跨文件链接的"N HTML + M PNG"形态**禁止**直接交付给最终读者
- 必须用 `build_standalone.py` 合并成单一 HTML(零外部依赖)
- ❌ **不再生成 PDF**(失败模式 #11 · 用户最终决策 2026-04-25)
- 合并失败或 §6.6 验证清单未全过 → **不可声明"已交付"**
- **历史复现证据**:
- v2.5.3 初版双交付 HTML + PDF — 用户立即指出"以后交付全部交付 HTML,不再交付 PDF"
- 单 HTML 已涵盖屏幕浏览/邮件附件/即时通讯/网盘分享/打印(浏览器 Ctrl+P)所有场景
---
## 版本历史
- **v1.3 (2026-04-25)** · **新增悬浮目录导航 Iron Law**(阶段 6.3 §E.5)— 单文件 HTML 必须含全量 TOC(主页 + 全部 N 子页 h1/h2),右上角圆形按钮 + 悬浮面板,点击外部/Esc 关闭,@media print 隐藏。`build_standalone.py` 新增 `extract_headings()` + `build_floating_toc()` 自动构建,血液科 v2.5.3 实测 92 条目自动提取。
- **v1.2 (2026-04-25)** · **PDF 永久停用**(用户最终决策"以后交付全部交付 HTML,不再交付 PDF")。新增失败模式 #11(PDF 二次压缩失真 + 内容冗余)。Iron Law 简化为"必须生成单文件 HTML 版本"。读者打印需求 → 浏览器 Ctrl+P 自助。
- **v1.1 (2026-04-25)** · 追加阶段 6:可分享交付物生成(原方案 单文件 HTML + 配套 PDF · 已被 v1.2 收敛为 HTML-only)。新增失败模式 #10。证据来源:
- 血液科 v2.5.3 [build_standalone.py](D:/Vibe Coding Project/AI Square/血液科市场调研/output/build_standalone.py)
- 交付物 [report_v25_standalone.html](D:/Vibe Coding Project/AI Square/血液科市场调研/output/report_v25_standalone.html) (9 MB)
- **v1.0 (2026-04-25)** · 从血液科 v2.5 第 6 次迭代抽出。证据来源:
- 主页 [report_v25.html](D:/Vibe Coding Project/AI Square/血液科市场调研/output/report_v25.html)
- 6 子页 [page_alloHSCT.html](D:/Vibe Coding Project/AI Square/血液科市场调研/output/page_alloHSCT.html) 等
- L1 ifi-market-sizing-skill v1.5 §5.3 HTML 报告完整性清单
---
## Skill Presented by:YongQi, SimonSu, RuiYu, YingJi
` 并构建树
- 子页 anchor 通过 `prefix_id="page-{key}-"` 自动加前缀,不会与主页冲突
**Iron Law(v1.3.1 修复 · 2026-04-25 用户反馈)**:
1. **主报告分组必须过滤 `page-*` 前缀 anchor**:`extract_headings(main_html)` 在合并后的 HTML 上调用会同时抓到主页和已合并的子页 h1/h2(id 已带 `page-{key}-` 前缀)→ 必须 `if anchor.startswith("page-"): continue` 过滤,否则主报告分组会出现 N 套重复且无归属(图中症状:连续 6 套"双分支决策树/Market 测算/TOP 3 LP/关键证据"无子页归属)
2. **禁用 backdrop-filter: blur**:9 MB+ 大文档下 `backdrop-filter: blur(2px)` 会让浏览器对整个 viewport 强制重排重绘 → 鼠标延迟高、卡顿。改用 `background: rgba(15,23,42,0.35)` 半透明纯遮罩(GPU 友好)
3. **过渡时长 ≤ 150ms · 动画用 `@keyframes` 而非 `transition`**:opacity transition 130ms · panel 用 `animation: ftoc-pop 0.14s ease-out`,加 `will-change: opacity/transform` 提示合成层
4. **打开用 `requestAnimationFrame` 而非 `setTimeout(10)`**:确保 hidden 切换后下一帧才加 .show class(避免动画跳过)
**血液科 v2.5.3 实测**:92 个目录条目自动提取(主页 30+ + 6 子页各 ~10),HTML 体积 +0.02 MB(可忽略)。
#### E.6) 子页 sticky topnav 在合并版隐藏
```css
.standalone-subpage .topnav { display: none !important; }
.standalone-subpage { margin-top: 60pt; padding-top: 30pt; border-top: 4pt double var(--navy); page-break-before: always; }
.standalone-divider { display: flex; justify-content: space-between; background: linear-gradient(90deg, var(--navy) 0%, var(--blue) 100%); color: #fff; padding: 12pt 18pt; border-radius: 6pt; }
```
原因:合并后所有锚点都在同一文档,子页 topnav 失去意义且会污染滚动。
### 6.4 复用脚本骨架(从 build_standalone.py 抽取)
**完整参考实现**:`/build_standalone.py`(血液科 v2.5.3 验证可用)
```python
from pathlib import Path
import base64, re
from dataclasses import dataclass
# ===== 配置常量(跨疾病移植仅改这里)=====
OUT = Path(__file__).parent
MAIN_HTML = OUT / "report_v??.html"
SUB_PAGES: list[tuple[str, Path]] = [
("", OUT / "page_.html"),
("", OUT / "page_.html"),
# ... N 个子页
]
OUTPUT_HTML = OUT / "report_v??_standalone.html"
@dataclass(frozen=True)
class SubPage:
key: str; title: str; body_html: str; head_style: str
# ===== 核心五函数 =====
def extract_subpage(path, key) -> SubPage: ... # 提取子页 body + 重写主页链接
def png_to_base64(path) -> str: ... # PNG → data: URI
def inline_all_png(html, base_dir): ... # 批量替换
def rewrite_subpage_links(html) -> str: ... # 主页 page_*.html → #page-*
def build_section_for_subpage(sub) -> str: ... # 子页 body →
def merge():
# 1) 读主页 + N 子页
# 2) 注入 extra CSS(.standalone-* 系列)
# 3) 重写主页跨文件链接
# 4) 后注入 + banner
# 5) 前插入 N 个子页 section
# 6) inline_all_png 全文 PNG 内嵌
# 7) 写出 + 验证
```
### 6.5 ~~配套 PDF 生成~~(v1.2 已停用 · 2026-04-25)
> ❌ **本节已停用**:用户最终明确"以后交付全部交付 HTML,不再交付 PDF"。
> 单 HTML 是终态交付物 — 决策树原画质 base64 内嵌、锚点跳转、零依赖,完全覆盖 PDF 所有场景。
> 读者若需打印,在浏览器中按 `Ctrl+P` 自行另存为 PDF — **生成方不再主动产出 PDF**。
> Chrome headless / playwright 命令仅作历史归档保留(失败模式 #11)。
### 6.6 验证清单(交付前必过)
- [ ] **文件大小** < 25 MB(邮件附件可发)
- [ ] **锚点跳转**:点击主页任一 disease-card → 平滑滚到对应子页 section
- [ ] **回退链**:每个子页内 "↑ 回到主页顶部" 工作正常
- [ ] **PNG 内嵌**:N+1 张 PNG 全部用 `data:image/png;base64,...` 内嵌(grep 计数)
- [ ] **零外部依赖**:断网双击打开,所有图、所有跳转、所有样式都正常
- [ ] **banner 提示**:文件顶部"📦 单一独立 HTML 版"横幅可见
- [ ] **悬浮目录导航**(v1.3 Iron Law):右上角目录按钮可见,点击展开主报告 + 全部 N 子页全量目录(h1/h2 全提取),点击外部/Esc 关闭,@media print 隐藏
- [ ] ~~PDF 验证~~ — v1.2 不再交付 PDF,本项删除
### 6.7 跨疾病移植清单
| 配置项 | 改动 | 示例(呼吸科 ICU 真菌) |
|-------|------|----------------------|
| `MAIN_HTML` | 🟡 改 | `report_resp_v??.html` |
| `SUB_PAGES` | 🟡 改 | `[("RICU_CAPA", ...), ("PCCM_CPA", ...), ...]` |
| `OUTPUT_HTML` | 🟡 改 | `report_resp_v??_standalone.html` |
| `extract_subpage()` 中主页文件名正则 | 🟡 改 | `r'href="report_resp_v??\.html"'` |
| 五个核心函数(extract / inline / rewrite / build / merge)| ✅ 直接复用 | — |
| extra CSS(.standalone-* 系列)| ✅ 直接复用 | — |
| banner 文案 | 🟡 改版本号即可 | — |
| ~~Chrome headless PDF 命令~~ | ❌ v1.2 已停用 | 不再交付 PDF |
### 6.8 Iron Law(本阶段强制条款)
**报告交付前必须生成单文件 HTML 版本(v1.2 更新 · 仅 HTML 交付)**:
- 跨文件链接的"N HTML + M PNG"形态**禁止**直接交付给最终读者
- 必须用 `build_standalone.py` 合并成单一 HTML(零外部依赖)
- ❌ **不再生成 PDF**(失败模式 #11 · 用户最终决策 2026-04-25)
- 合并失败或 §6.6 验证清单未全过 → **不可声明"已交付"**
- **历史复现证据**:
- v2.5.3 初版双交付 HTML + PDF — 用户立即指出"以后交付全部交付 HTML,不再交付 PDF"
- 单 HTML 已涵盖屏幕浏览/邮件附件/即时通讯/网盘分享/打印(浏览器 Ctrl+P)所有场景
---
## 版本历史
- **v1.3 (2026-04-25)** · **新增悬浮目录导航 Iron Law**(阶段 6.3 §E.5)— 单文件 HTML 必须含全量 TOC(主页 + 全部 N 子页 h1/h2),右上角圆形按钮 + 悬浮面板,点击外部/Esc 关闭,@media print 隐藏。`build_standalone.py` 新增 `extract_headings()` + `build_floating_toc()` 自动构建,血液科 v2.5.3 实测 92 条目自动提取。
- **v1.2 (2026-04-25)** · **PDF 永久停用**(用户最终决策"以后交付全部交付 HTML,不再交付 PDF")。新增失败模式 #11(PDF 二次压缩失真 + 内容冗余)。Iron Law 简化为"必须生成单文件 HTML 版本"。读者打印需求 → 浏览器 Ctrl+P 自助。
- **v1.1 (2026-04-25)** · 追加阶段 6:可分享交付物生成(原方案 单文件 HTML + 配套 PDF · 已被 v1.2 收敛为 HTML-only)。新增失败模式 #10。证据来源:
- 血液科 v2.5.3 [build_standalone.py](D:/Vibe Coding Project/AI Square/血液科市场调研/output/build_standalone.py)
- 交付物 [report_v25_standalone.html](D:/Vibe Coding Project/AI Square/血液科市场调研/output/report_v25_standalone.html) (9 MB)
- **v1.0 (2026-04-25)** · 从血液科 v2.5 第 6 次迭代抽出。证据来源:
- 主页 [report_v25.html](D:/Vibe Coding Project/AI Square/血液科市场调研/output/report_v25.html)
- 6 子页 [page_alloHSCT.html](D:/Vibe Coding Project/AI Square/血液科市场调研/output/page_alloHSCT.html) 等
- L1 ifi-market-sizing-skill v1.5 §5.3 HTML 报告完整性清单
---
## Skill Presented by:YongQi, SimonSu, RuiYu, YingJi
def rewrite_subpage_links(html) -> str: ... # 主页 page_*.html → #page-*
def build_section_for_subpage(sub) -> str: ... # 子页 body →