---
description: "prompt 页要按读者的选择决定哪段进对话框时读：什么时候才值得做分支、data-when 块的写法、模板能力的上限；其余页面用不上"
---

# 分支：按读者的选择复制

**能用一句「如果……就……」说清的，写成句子，不做分支** —— 收到 prompt 的是大模型，句子里的条件它自己会判断。没选中的那支长到值得省掉，才用 `data-when` 替它先把选择落定：[细讲项目](../../project-research/dissect.md)选了「否」，「实跑」那一节就不进对话框。

## 写法 { #syntax }

```markdown
关键机制要不要实际跑一遍：<select name="实跑"><option>是</option><option>否</option></select>

<div data-when="实跑=是" markdown>

## 实跑

- 拆出要演示的关键片段单独跑……

</div>

<div data-when="实跑=否" markdown>

不实跑：每节只贴模版，效果块省掉。

</div>
```

- **`data-when="名=值"`**：名为「名」的控件当前值等于「值」才复制；哪个选项有话要对 AI 说就给哪个写块，没话说的不写
- **`data-when="名"`**：那个框填了才复制 —— 可选的空连同它那句话包起来，空着就不会复制出【可选：……】
- **开关那句复制不复制，看 AI 要不要知道选了什么**：选的值本身是给 AI 的答复（「关键机制要不要实际跑一遍：否」），写成 prompt 里的一句照常复制；开关只管哪段进对话框（「要不要收纳进本 wiki」），包 `zx-no-copy` 只给人看。某个选项要 AI 多做什么，写进那个选项自己的分支，分支开头不写「如果选了……」，读 `.md` 源的 AI 从 `data-when` 就看得懂
- **源文件里 `data-when` 块不写 `zx-no-copy`**：条件不成立时脚本给它挂上，网页上和[写死的那种](components.md#no-copy)一个样子，另外变淡；只是提示，不藏、不禁用，块里的控件照常能填
- **条件里用到的控件要写 `name`**
- **块放顶层，里面不缩进**：缩进 4 格就成了代码块，和提示框、选项卡正好相反；放进提示框、列表里，HTML 会漏出一个原样的 `markdown` 属性
- 复制时条件成立的块只去掉外壳 div，里面照常复制

活例：[细讲项目](../../project-research/dissect.md)，「实跑」开关是正文里的一句，两支各一个块；「收纳」开关包 `zx-no-copy`，只有「是」写块；「我原来以为它是」填了才复制。

## 上限 { #limit }

填空加分支已经是个模板了，守住别长成模板语言：

- 只有填空和两种条件：等于某个值、填了
- 不嵌套，不写「并且 / 或者」，不做循环、计算、引用别的页 —— 想要更多就拆成两页，或者把逻辑写成句子交给 AI
- 检验：把源文件当普通 markdown 从头读一遍，还像一段人写的 prompt；读着像代码了，就是写过头了
- 脚本拼 prompt 去调 API 才用真正的 Jinja，写在脚本里，不放进 wiki