`.
>
> Generate one bridging sentence per section from the FIRST up to the SECOND-TO-LAST. Place each at the END of that section's first `
` to lead into the NEXT section's topic.
>
> **Output**: a JSON array of strings. Length = (number_of_sections − 1). The i-th string bridges section i to section i+1. Each is one sentence (12–25 words), fluent academic English, no newlines.
>
> **Patterns** to prefer:
> - When the next section introduces/elaborates/substantiates a method or idea: "To introduce / elaborate on / substantiate \, we next present \."
> - When the next section is experimental: "Next, we evaluate \ to demonstrate ..." or "We then conduct experiments on \ to empirically validate ..."
> - Always reference the next section's topic without introducing new technical claims.
解析返回的 JSON 数组。对每个字符串,追加到对应章节的第一个 `` 末尾。最后一个章节不加过渡句。
### Step 5: 构建海报
```bash
python3 tools/poster.py build \
--template templates/poster/poster_template.html \
--outline poster/outline.html \
--output poster/poster.html
python3 tools/poster.py inject-title \
--dag poster/dag.json \
[--authors "{Step 0 收集到的 authors 覆盖串,或 --authors flag 的值}"] \
poster/poster.html
```
`--anonymous` 已在 Step 1(`wiki2dag.py`)生效 —— `dag.json` 中的标题/作者已是最终值,`inject-title` 默认从那里读。当论文的 `\author{}` 因双盲投稿而留空但海报需要显示真实作者时,传入 `--authors` 覆盖。同时传入 `--anonymous` 时仍以 `--anonymous` 为准。
```bash
# 应用 Step 0 收集到的 venue 与 logo。用户跳过的项就不要传对应 flag。
python3 tools/poster.py inject-header \
--venue "{Step 0 的 venue}" \
[--affiliation-logo {path}] \
[--conference-logo {path}] \
--layout {corners|stacked} \
poster/poster.html
python3 tools/poster.py inject-figures \
--dag poster/dag.json \
--paper-dir paper/ \
--poster-dir poster/
python3 tools/poster.py validate poster/poster.html
```
`inject-figures` 直接拷贝 PNG/JPG,对 PDF 源使用 `pdftoppm` 以 200 DPI 转为 PNG。`validate` 检查每个 `
` 能解析、标题非空、章节数 ≥ 3、不存在 `TODO`/`FIXME`/`[UNCONFIRMED]` 标记。
### Step 5b: 渲染 PNG
`validate` 通过后,把 HTML 海报渲染成 PNG,供用户预览,也作为后续 Step 5.5 critique-revise 的输入:
```bash
python3 tools/poster.py render poster/poster.html
```
产出 `poster/poster.png`,默认 2× CSS 像素(2800×1800)。用 `--scale {1,2,3}` 覆盖(1 = 快速预览,3 = 印刷质量)。
**渲染引擎**:优先 Playwright(Chromium),其次是系统浏览器的子进程兜底。Playwright 之所以首选,是因为它在截图前**等到特定事件触发**——`document.fonts.ready`、所有 `![]()
` `load` 事件、`flow.scrollWidth` 连续 10 帧不变(即 fit() 收敛)。子进程路径用 `--virtual-time-budget=5000` 这种 wall-clock 超时,在 CDN 慢响应时可能在 Google Fonts / KaTeX 加载前就截图。这正是 PaperX 用的等待语义。
**安装 Playwright**(一次性,推荐):`pip install playwright && python -m playwright install chromium`。即使不装,`render` 也能走子进程路径;输出里会显示 `browser: chromium`(子进程)或 `browser: playwright-chromium`(首选)。
**子进程兜底的浏览器探测**:Chrome → Edge → Chromium → Firefox(最后兜底)。Chrome/Edge/Chromium 三者等价(同引擎、同 CLI flag)。Firefox 也能用,但有两个限制 —— 不支持 HiDPI 缩放(无论 `--scale` 传什么,PNG 都是 1×);也没有 `--virtual-time-budget` 等价物。退化到 Firefox 时 `render` 会向 stderr 打印警告。
**不支持 Safari** —— Safari 没有 headless CLI 截图 flag;接入需要 `safaridriver` + Selenium WebDriver。macOS 上只有 Safari 的用户可以 `brew install --cask google-chrome`(一行命令)解锁完整流程。
若找不到任何支持的浏览器,`render` 以平台对应的安装提示退出。HTML 海报本身在任何浏览器里都能打开 —— 用户依然可以 `open poster/poster.html`。
### Step 5.5: Critique-revise(截图 + DOM 溢出报告双驱动)
目标:用**程序化的溢出报告**(从渲染后的 DOM 取的 ground truth)结合**截图**(视觉上下文)来修订 HTML。DOM 报告是 fit() 和 LLM 都可能漏看的东西 —— 它精确测量每个叶子元素的 bottom / right 与 flow 边缘的差,精确报出任何 clipping。LLM **不能**在报告显示 clipping 的情况下声明收敛,必须修剪文字直到报告 ok。
自动应用,无用户交互。
**跳过条件**:
- 传入 `--no-refine` → 完全跳过。
- `--refine-iterations 0` → 等同 `--no-refine`。
- Step 5b 没产出 `poster/poster.png`(无可用 headless 浏览器)→ 警告后跳过。
**迭代次数**:由 `--refine-iterations N` 决定(默认 1,硬上限 2)。注意:收敛不再只看文字稳定,而是依赖溢出报告 —— 见下面的终止条件。
**单轮迭代流程**(i = 1..N):
1. 确保 `poster/poster.png` 反映当前 `poster/poster.html`。若 HTML 自上次渲染后有改动,重跑 `python3 tools/poster.py render poster/poster.html`。
2. 运行 `python3 tools/poster.py check-overflow poster/poster.html --output raw/tmp/poster.overflow.json`(scratch 路径 —— `poster/` 里只放最终产物)。读取该 JSON。
3. **提前收敛(仅溢出报告路径)**:若 `i == 1` 且 `overflow.ok == true`,且认真比对截图后没看到任何明显的 LaTeX / 编码 / 编号问题(对自己应用下面 refinement 提示词里的强制 checklist),**可以**在这里就声明收敛:记录 `"converged after 0 iterations — DOM clean, no visible content issues"` 并退出。如果有**任何**疑虑就不要走这条捷径 —— 跑一轮 refinement 的成本远小于交付一张细节有问题的海报。
4. 在内存里快照 `pre_html = <当前 poster.html>` —— 用于后面的文字稳定性判定。
5. 读取 `poster/poster.png`(多模态)、`poster/poster.html`、以及 `raw/tmp/poster.overflow.json`(ground truth 的 clipping 报告)。
6. 应用下面的 refinement 提示词。把 overflow JSON 作为 prompt 的一部分传入 —— LLM 凭它**精确**知道哪些章节要 trim,而不是从截图里猜。用 Claude(会话内,已多模态)。**不要**用 `mcp__llm-review__chat`,它按 `mcp-servers/llm-review/server.py` 只接受文本。
7. 解析 LLM 输出:从第一个 ```` ```html ```` 围栏代码块里提取 HTML。
8. 把修订后的 HTML 写回 `poster/poster.html`,并快照为 `post_html`。
9. 重跑 `python3 tools/poster.py validate poster/poster.html`。若 validate 失败:停止,告诉用户具体问题,HTML 保留原样。
10. 重新渲染 `poster/poster.png`。重跑 `check-overflow --output raw/tmp/poster.overflow.json` → 更新报告。
11. **收敛检查(两个条件**都满足才算收敛**)**:
- (a) 新的 overflow 报告 `ok == true`,且
- (b) `pre_html` 与 `post_html` 在 `.flow` 区域字符差异 < 50。
都满足:声明收敛(`"converged after {i} iteration(s) — DOM clean and prose stable"`)并退出。
overflow.ok 仍为 false:下一轮**必须**继续 refine;即使 prose 稳定也不能停。LLM 没 trim 够。
迭代预算用尽但 overflow.ok 还是 false:停止,清晰提示("Step 5.5 跑完 N 轮但仍有 DOM clipping —— 考虑 `--refine-iterations 2`,或在 `poster/outline.html` 里手动 trim 最长那节的文字"),HTML / PNG 留着给用户人工检查。
**为什么这么设计**:上一版让 LLM 看降采样的 PNG 后凭感觉声明收敛。列边缘的细微 clipping 被漏掉。DOM 溢出报告把"clipping 的检测"从 LLM 判断里拿出来 —— 现在 clipping 是测量值,不是猜测。LLM 的活变成专门**修复**报告里标出的东西,不再兼职决定"有没有要修的"。
**Refinement 提示词**(从 PaperX `poster_refinement_prompt` 移植;新增 overflow JSON 输入 + 强制 pre-flight checklist):
> You are an expert Academic Poster Designer and Web Developer. Your task is to refine an existing HTML poster based on its visual rendering (screenshot), the current HTML code, and a structured DOM overflow report.
>
> **INPUTS**:
> 1. **Current Poster Code (HTML)** — full poster.html
> 2. **Visual Render (PNG screenshot)** — poster.png attached via Read
> 3. **DOM Overflow Report (JSON)** — output of `tools/poster.py check-overflow`. This is **ground truth** about which elements are clipped. If `clipped` is non-empty, you MUST fix each entry.
>
> **MANDATORY PRE-FLIGHT CHECKLIST** — answer BEFORE generating any HTML. Write this as a fenced ```` ```json ```` block first; then below it, output the corrected HTML in a separate ```` ```html ```` block.
>
> ```json
> {
> "overflow_report_ok": ,
> "clipped_count": ,
> "col1_bottom_ok": ,
> "col2_bottom_ok": ,
> "col3_bottom_ok": ,
> "latex_leaks": ,
> "numbering_prefixes": ,
> "will_revise":
> }
> ```
>
> If `will_revise: false`, your HTML block may be identical to the input.
>
> If `will_revise: true`, the HTML block MUST contain real edits addressing each flagged issue. **Do not output unchanged HTML claiming you fixed it** — that's the failure mode this checklist exists to prevent.
>
> **TASKS** (apply only where flagged by the checklist):
>
> **Task 1: Fix LaTeX / encoding leaks** (when `latex_leaks` non-empty)
> - Replace raw LaTeX with HTML entities or Unicode (`\\textbf{x}` → `x`, `\\citep{key}` → `[N]`, `$d_S \\ge 10$` → `d_S ≥ 10`).
>
> **Task 2: Normalize section headers** (when `numbering_prefixes` non-empty)
> - Strip leading `1.`, `2.1`, `A.`, `E.`, `- `, etc. from `` contents.
>
> **Task 3: Fix DOM-reported clipping** (when `overflow_report_ok: false`)
> - The JSON's `clipped` array names every offending element with its `section_title`, `tag`, `bottom_overflow_px`, and a content `preview`. For each clipped element, **trim the corresponding section's prose conservatively** (drop filler words, tighten sentences) until that element fits. Never delete claims, citations, or math expressions.
>
> **Task 4: Fix screenshot-only issues** (when any `colN_bottom_ok: false`)
> - The DOM check has tolerance; visually cramped content (line right against the border) may still pass `overflow.ok: true`. If the screenshot shows this, trim the relevant column's prose by 5–15 words.
>
> **Output requirements**:
> - First, the ```` ```json ```` checklist block (mandatory).
> - Then, the ```` ```html ```` block: complete, runnable HTML.
> - Preserve the CSS, the `