/ljg-card

模具：白板（-w）

白板把作者怎样一步步走到结论摊开。1080px 竖长卡片像下潜深水：问题在上，前提、证据、矛盾、转折与局部分支逐层变深，最后停在内容自身的收束处。读者只看成品，也应能复述「为什么下一步从上一步发生」。

自然流动来自前一步留下的压力，而不是旁白不断宣布「现在继续追问」。主干在账本里始终明确；前台只让真正改变论证方向的铰链出声，普通延续、解释和递进保持安静。

用于知识讲解时，读者还应知道现实对象凭什么归入概念、规则怎样产生具体结果。先读 references/learning-design.md，明确目标读者的判断任务。纵向主干表示作者论证的先后，下上结构表示对象与概念的对应；二者独立，不把整张白板强制改成上下两栏。

执行时先读取 references/image-generation.md 与 assets/whiteboard_template.html。共享协议决定资产身份和来源边界，本文件决定论证抽取、纵向主干与局部结构。

一、先建立论证账本

视觉母题之前，先按原文阅读顺序建立账本。不要从摘要直接进入排版；摘要会保留结论，却最容易删除作者抵达结论的过程。

先把锁定后的正文按原段落保存为精确来源快照；段落之间保留一个空行。用确定性工具生成独立来源清单：

bun assets/prepare-whiteboard-source.ts /tmp/<task>/source.txt /tmp/<task>/whiteboard-source-inventory.json

工具会锁定原文件 SHA-256，并按顺序给每个非空段落分配 src-01、src-02……及段落哈希。论证账本的 source_sections 必须与这份独立清单 ID、顺序完全一致，因此不能先漏掉原文，再让自写账本与 DOM 互相证明。

每个来源段落登记为 source_sections：

• id：稳定来源锚点，例如 src-01；
• disposition: rendered：它进入白板，并列出对应 step_ids；
• disposition: omitted：它既不承担必要论证，也不承担目标读者所需的学习材料，同时写清 omission_reason；
• 每个源章节必须二选一，不能静默消失。

对候选材料做两种删除测试，任一成立就保留：

• 论证承重：删后，后面的判断失去前提、转折、证据或边界。
• 学习承重：删后，目标读者无法初次辨认概念、区分易混对象、完成规则与具体结果的对应。例子未参与证明，也可能在这里承重。

学习材料优先放进所属步骤的 support 或局部 .learning-material，不为了保留一个例子强造推理转折；它的来源段落仍以 rendered 映射到该步骤。确实新增独立判断时才建立新步骤。最终账本中每个步骤的 must_render 仍为 true；omission_reason 要说明被删材料的功能为何不再需要，不能只写「只是例子」。不凑固定节点数。

账本字段与引用齐全只证明材料已登记。节点的实际解释还应把对象、动作或状态、归类依据与结果接起来；正文中看不见的对应，读者无法从箭头或字段名中补出。用 references/learning-design.md 的同文对照审阅表达，不把结构门禁当成讲解效果。

每个步骤登记：

role 描述论证作用，不把教学例子一律标成 evidence。support 与局部学习材料可以呈现对象、判别依据、关系及结果，不要求五项分栏。原文实例绑定其真实 source_refs；经授权补例放在所解释步骤内，可见标注「补充假设例」，其规则的来源引用不能冒充例子来自原文。缺材料且未获补例授权时，在制作记录和交付回复中写明缺口。

关系另行登记为 relations，每条含 id、from、to、kind、visibility、bridge：

• kind：continue / deepen / contrast / question / branch / return / boundary；
• visibility: implicit：普通延续、解释、例证或自然递进。bridge 固定为空，视觉上只让纵向主干继续；
• visibility: visible：矛盾出现、问题被改写、条件变化、分支、回收或边界。bridge 写一条完整、具体的自然句，不再拆成关系标签与解释句。

同一条边只能有一个可见承载面：如果当前步骤已经用 residue 留下了压力，随后关系就使用 implicit；如果转折需要独立停顿，当前步骤的 residue 留空，由关系的 bridge 承担。不要同时写两遍。相邻不自动等于因果。

最终账本使用下面的结构，并写入模板的 {{LOGIC_LEDGER_JSON}}：

{
  "version": 2,
  "source_sha256": "锁定原文的 64 位 SHA-256",
  "source_sections": [
    {"id": "src-01", "disposition": "rendered", "step_ids": ["step-01", "step-02"]},
    {"id": "src-02", "disposition": "omitted", "omission_reason": "作者信息，不参与论证"}
  ],
  "steps": [
    {
      "id": "step-01",
      "role": "question",
      "source_refs": ["src-01"],
      "claim": "原文真正试图回答的问题",
      "support": "问题出现的具体局面",
      "residue": "这只说明经验会消失，还没有说明它应该写到哪里。",
      "must_render": true,
      "presentation": "typography"
    }
  ],
  "relations": [
    {"id": "rel-01", "from": "step-01", "to": "step-02", "kind": "deepen", "visibility": "implicit", "bridge": ""}
  ]
}

把 JSON 中的 < 序列化为 \u003c，不要把原文 HTML 或可执行内容复制进 <script type="application/json">。

二、一条主干，局部变形

每张白板只有一个 .reasoning-spine。它是阅读方向，也是视觉上的下潜线。旧的整卡 data-whiteboard-layout 已停用：真实文章可以先链式递进，中段分叉，随后用矩阵比较，再汇入结论。

开头使用：

• .whiteboard-title：文章议题，不提前代替全部推导；
• .whiteboard-question：读者带着什么问题向下走；
• 可选 .whiteboard-orientation：交代来源场景，不写结论摘要。

每个承重步骤使用：

<article class="logic-step"
         data-step-id="step-02"
         data-role="tension"
         data-source-refs="src-01 src-02">
  <div class="step-marker" aria-hidden="true">
    <span class="step-depth">02</span><span class="step-dot"></span>
  </div>
  <div class="step-panel">
    <span class="step-role">矛盾</span>
    <h2 class="step-claim">短期记住不等于长期学会</h2>
    <p class="step-support">上下文结束后，经验没有稳定进入下一次任务。</p>
    <p class="step-residue">这只说明经验会消失，还没有说明它应该写到哪里。</p>
  </div>
</article>

普通递进仍登记端点，但保持静默：

<div class="logic-relation"
     data-relation-id="rel-02"
     data-from="step-02"
     data-to="step-03"
     data-kind="deepen"
     data-visibility="implicit"
     aria-hidden="true"></div>

真正改变方向时才使用可见转折；一句话同时承担关系与理由：

<div class="logic-relation"
     data-relation-id="rel-03"
     data-from="step-03"
     data-to="step-04"
     data-kind="branch"
     data-visibility="visible"
     aria-label="单一记忆层无法同时满足快速更新与稳定保留，问题由此分成两条路线。">
  <span class="relation-rail" aria-hidden="true">
    <span class="relation-stem"></span><span class="relation-arrowhead"></span>
  </span>
  <div class="transition-copy">
    <p class="transition-sentence">单一记忆层无法同时满足快速更新与稳定保留，问题由此分成两条路线。</p>
  </div>
</div>

账本步骤、DOM 步骤、账本关系与 DOM 关系的 ID、顺序、类型、显隐和文字必须一致。第一步是 question，结论前至少有真实推导；结尾服从原文的结论、问题或余韵，不强制以 boundary 收尾。boundary 仅标记原文真正改变判断的适用条件或限制，不能为它补造免责声明，也不能让顶部一句核心判断替代整条路径。

流水式衔接的删除测试

先把标题、支撑文字和可选 residue 连起来朗读，再逐条检查关系：

• 删除这句转折，读者仍能顺着前一步进入下一步：改为 implicit；
• 删除后会丢失矛盾、问题改写、分叉、回收或边界：保留 visible；
• 过渡句只说「继续追问」「再向前一步」「因此展开」而没有指出原文中的具体未解对象：它只是报幕，重写或删除；
• 下一节点标题已经自然回答了前一步的余压：不要再加关系文案。

可见转折的数量由删除测试决定，不设比例。目标不是少写，而是只在逻辑真正换挡时写。

三、五种 topology 降为局部工具

局部结构使用 data-logic-shape，可以在同一主干内组合：

分支必须说明去向：

<section class="local-shape local-branch"
         data-logic-shape="branch"
         data-branch-state="converged"
         data-entry-step="step-04"
         data-return-step="step-07">
  <div class="branch-grid">
    <div class="branch-path" data-branch-id="route-a">...</div>
    <div class="branch-path" data-branch-id="route-b">...</div>
  </div>
  <p class="branch-return">两条路线在 step-07 重新汇合。</p>
</section>

converged 分支的每条路径都要通过关系抵达 data-return-step；暂时无法汇合时使用 data-branch-state="open" 并写可见的 .branch-open，不能画完两栏就遗忘它们。

四、图像只进入承重步骤

在决定是否用图前，同时检查论证与判别是否受损：删图后两者均不受损才可省略。具体下层材料可以由文字、原图或生成场景承载，0 幅生成图仍合法；保留图片必须说明它让哪个特征或结果更容易辨认。

生成图预算为 0–4 幅。白板没有顶部 hero 图槽；图片只嵌入它解释的 .logic-step，并让 data-source-claim 等于该步骤 ID：

<figure class="generated-art generated-art--whiteboard"
        data-asset-kind="generated"
        data-asset-id="g02"
        data-source-claim="step-05">
  <img src="/absolute/path.png" alt="阀门收紧后，流入容器的水明显变少">
</figure>

图片只画人、手、物件、容器、绳索、阀门、地形等可见动作。箭头、轴线、矩阵边界、标签、公式、标题和编号全部留给 HTML/CSS。提示词追加：

minimal hand-drawn whiteboard vignette, warm paper-compatible flat background,
one object and one visible action, loose marker line, low detail, generous clean margin

专属负向约束：图中不要箭头、轴线、标签、纸纹、便签壳、阴影或新增高饱和色。透明背景不稳定时，平底色必须与 --board 完全一致。

五、竖长阅读节奏

• 1080px 宽度固定，高度由推理深度决定；不为接近某个模板高度删节点。
• 连续下潜线贯穿主干；每个步骤带深度编号、角色、判断与支撑，只有真实未解压力才增加 residue。
• 铺垫收紧，矛盾、转折、分支回流、结论放大；不要把所有节点做成等重卡片墙。
• 每经过一个真正的推理转折，增加纵向留白；同一层的证据与例子收紧在所属步骤附近。
• 手写体只用于真正的可见转折、深度标记和短批注；正文使用本地中文 Sans。
• 适用条件与证据限定放在对应步骤的 .logic-evidence 或 .step-support 中；原文确有独立承重的限制时，作为普通 .logic-step 沿主干呈现。结尾不追加阅读提示、制作说明或验收声明。
• 承担首次辨认、易混对比或输入输出对应的材料使用 .learning-material，身份用 .learning-label 写明，正文保持主要阅读字号与深墨色。不要把关键判别藏进小号浅色附注；窄分支容不下时移到所属步骤附近的全宽位置，不缩字硬塞。
• 换案问题按内容需要放在讲解之后，使用 .transfer-check；后置 .transfer-feedback 说明答案依据，并可自然结束正文。先判断再下滑的提示只能提供自测机会，不能保证答案未被看见；这一验证限制在交付回复中说明。
• 整图缩小时应先看到一条连续向下的线、少数明显转折和最后的收束；原像素下正文必须轻松可读。

将最终账本写入 {{LOGIC_LEDGER_JSON}}，语义内容写入 {{CONTENT_HTML}}，只在必要时用 {{CUSTOM_CSS}} 做局部微调，并替换 {{LOGO}} 与 {{SOURCE_LINE}}。所有中间文件写入本任务独占的 /tmp 目录。

六、截图与验收

bun assets/capture.ts /tmp/<task>/whiteboard.html ~/Downloads/{name}.png 1080 1600 fullpage /tmp/<task>/whiteboard-source-inventory.json /tmp/<task>/source.txt

截图器会阻断：占位符残留、缺少来源清单或原文快照、原文哈希漂移、来源清单与论证账本段落不一致、缺少唯一主干、旧整卡 topology、账本 JSON 错误、源章节无去向、承重步骤遗漏或乱序、节点未绑定来源、关系端点悬空或文字漂移、静默关系仍带文案或箭头、可见关系缺少完整 bridge、同一条边同时使用 residue 与 bridge、分支不回流也不声明开放、生成图超过 4 幅或未绑定步骤、破图/空 alt、横向或隐藏溢出、超出支持高度。

最终验收分别检查：

1. 来源覆盖：逐项核对 source_sections，每个章节都有步骤或具体省略理由。
2. 论证复述：只看 PNG，能够说出原文的问题、承重前提、后文怎样从前文自然发生、局部分支怎样回收、结论与边界；只能复述结论分类而不能解释推导时，判定失败。
3. 朗读流畅：隐藏角色名、深度编号和关系数据后，顺读标题与正文；如果像提纲旁白反复报幕，或删除某条可见转折后毫无损失，判定失败。
4. 像素检查：整图一次；长图再用有重叠的顶部/中段/底部切片覆盖全部高度，确认下潜线连续、关系方向正确、真正转折才形成停顿、文字无裁切、来源未漂移。
5. 下上连接（知识讲解）：只看成品，能指出关键对象、归类依据、关系条件与具体结果；能否在换案中判断适用或不适用。先审材料是否足够，再区分有无读者实测。来源对账和账本一致只验证结构，不裁定例子是否足以教会、删例是否合理、补例是否真实。