writing-beats
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese<what-to-do>
The user has passed (or will pass) a markdown file of raw material. This is exploit: the exploring is done, the pile is fixed — commit to a path through it and mine the pile to fill each beat.
If the user did not say where to save the article, ask once and remember the path.
Then run a beat-by-beat journey, choose-your-own-adventure style:
- Establish the prerequisites. Before any beats, settle with the user what the audience already knows walking in — the concepts that are grounded from the start. Everything else must be grounded by a beat before a later beat can use it. See Grounding.
- Write 2–3 candidate starting beats, drawn from the raw material. Each is a different entry point into the article. Each may only lean on grounded concepts; note what new concepts each one grounds. Show the user the beats before writing to the article file. The user picks one. Preview what beats that pick unlocks — as if the user is seeing a little way down the path.
- Once the user picks a starting beat, write only that beat to the article file. A beat may be one sentence or several paragraphs — whatever that beat naturally is. Stop there.
- Re-read the article file from disk. Then offer 2–3 candidate next beats — different directions the journey could pivot to from where the article now stands. Each must be reachable from the current grounded set; note what each one grounds.
- Loop steps 3–5 until the article reaches a natural end.
<what-to-do>
用户已经提供（或即将提供）一份包含原始素材的markdown文件。这就是exploit（素材挖掘）：探索阶段已完成，素材库已确定——现在要确定一条创作路径，从素材库中选取内容来填充每个beat。
如果用户没有说明文章的保存路径，询问一次并记住该路径。
随后按照“自选冒险”的风格，逐beat推进创作旅程：
- 明确前置知识。在开始创作任何beat之前，与用户确认目标读者已具备的知识——即从一开始就被grounded的概念。除此之外的所有概念，都必须在某个beat中先被grounded，之后的beat才能引用。详见Grounding部分。
- 从原始素材中提炼2-3个候选起始beat。每个beat对应文章的不同切入点。每个beat只能引用已被grounded的概念；同时标注每个beat会新ground哪些概念。在写入文章文件前，先向用户展示这些beat，由用户选择其中一个。同时预览该选择会开启哪些后续beat——让用户能提前看到创作路径的走向。
- 用户选定起始beat后，仅将该beat写入文章文件。一个beat可以是一句话，也可以是几段文字——根据该beat的自然需求而定。写完后暂停。
- 重新读取磁盘中的文章文件。然后提供2-3个候选下一个beat——即从当前文章进度出发，创作旅程可以转向的不同方向。每个候选beat必须基于当前已被grounded的概念集；同时标注每个beat会新ground哪些概念。
- 重复步骤3-5，直到文章自然收尾。
Grounding
Grounding
Every concept has to be grounded before a beat can lean on it: the audience either walked in knowing it or met it in an earlier beat. A beat that reaches for an ungrounded concept loses the reader — that is the one move the journey can't make. The unit is the concept, not the word for it: a beat can lean on an idea the reader lacks even with no jargon in sight. Where a concept has a name — a term — grounding it means landing the idea and the term together.
A concept gets grounded one of two ways:
- Prerequisite — grounded before the first beat. The audience brings it. Fixed at the start.
- Introduced — a beat establishes it, and from then on it's grounded for every later beat.
So each beat does two jobs: it requires concepts that are already grounded, and it grounds new ones. Keep a running list of what's grounded so far, and update it each time a beat lands.
This is what shapes the choose-your-own-adventure. A candidate beat is only reachable if everything it requires is already grounded; picking a beat that grounds concept X unlocks every beat that was waiting on X. When you offer next beats, they must all be reachable from the current grounded set — and say what each one grounds, so the user can see which paths it opens.
The big lever is what you make a prerequisite versus what you ground inside the piece. Demand too much up front and you shut out readers who don't have it; ground too much inside and the early beats drown in definitions. Settle this with the user when you establish prerequisites, and revisit it whenever a tempting beat turns out to require a concept nothing has grounded yet — the fix is either a grounding beat before it, or promoting the concept to a prerequisite.
每个concept在被某个beat引用之前都必须先被grounded：读者要么在开始阅读时就已经了解该概念，要么是在之前的beat中已经接触过它。如果某个beat使用了未被grounded的概念，读者就会跟不上节奏——这是创作旅程中绝对不能犯的错误。这里的核心是概念本身，而非概念的表述词汇：即使没有使用专业术语，beat也可能涉及读者不了解的想法。当某个概念有对应的term时，grounding意味着同时向读者传递概念的内涵和对应的术语。
概念的grounding有两种方式：
- 前置知识——在第一个beat之前就已被grounded。由读者自带。在创作初期确定。
- 引入式——由某个beat来阐释该概念，之后所有后续beat都可以引用它。
因此每个beat承担两项任务：它需要已被grounded的概念作为基础，同时它会ground新的概念。要持续记录当前已被grounded的概念列表，并在每个beat完成后更新列表。
这正是“自选冒险”风格的核心所在。只有当候选beat所需的所有概念都已被grounded时，该beat才是可选的；选择某个ground了概念X的beat，会解锁所有等待使用概念X的beat。在提供后续beat选项时，所有选项都必须基于当前已被grounded的概念集——同时标注每个beat会新ground哪些概念，让用户能了解该选择会开启哪些创作路径。
关键的平衡在于确定哪些概念作为前置知识，哪些在文章内部进行grounding。如果前置知识要求过高，会把不具备该知识的读者拒之门外；如果在文章内部ground过多概念，早期beat会被定义性内容淹没。在明确前置知识阶段与用户敲定这一点，每当遇到某个有吸引力的beat需要未被grounded的概念时，也要重新审视——解决方法要么是在该beat之前增加一个grounding beat，要么将该概念提升为前置知识。
What is a beat
What is a beat
A beat is one move in the journey. It does one thing — sets a scene, lands a point, asks a question, drops an aside, twists the angle. Then it stops, leaving the reader at a place where the next beat can pivot.
A beat is sized by what it needs:
- A single sentence if that's all the move is ("And then nothing happened for three weeks.").
- A short paragraph if the move needs setup.
- Multiple paragraphs if the beat is a self-contained vignette, argument, or example.
If a "beat" needs five paragraphs and three subheadings, it's not a beat — it's two beats glued together. Split it.
beat是创作旅程中的一个环节。它只完成一件事——设定场景、阐述观点、提出问题、补充题外话、转换视角。然后暂停，让读者处于一个可以转向下一个beat的节点。
beat的篇幅由其需求决定：
- 如果只是一个简单的表述，一句话即可（比如：“接下来的三周毫无动静。”）。
- 如果需要铺垫，用一小段文字。
- 如果是一个独立的小片段、论点或示例，可以用多段文字。
如果一个“beat”需要五段文字和三个小标题，那它就不是一个beat——而是两个beat的组合。需要拆分它。
Pulling from the pile
Pulling from the pile
Pull material from the raw pile to populate each beat. You can paraphrase, split, recombine, or quote. The pile is a quarry.
从原始素材库中选取内容来填充每个beat。你可以改写、拆分、重组或引用素材。素材库就像一个采石场。
Ending the journey
Ending the journey
The article ends when the journey is complete — not when the pile is empty. Most piles will have leftover fragments that don't make it in. That is fine; that is the point of having more raw material than you need.
当创作旅程完成时，文章即告结束——而非素材库耗尽时。大多数素材库会有未被使用的片段，这很正常；这正是准备超出需求的原始素材的意义所在。
Writing rhythm
Writing rhythm
- Append one beat at a time. Never write ahead.
- Re-read the article file from disk before every write. Preserve user edits absolutely.
- If the user edits a previous beat substantially, let it change what comes next.
- If the user says "rewrite that beat" or "go back and try a different beat 3", do it — edit in place, leave the rest alone.
- 每次只追加一个beat。绝不要提前写好后续内容。
- 在每次写入前，重新读取磁盘中的文章文件。绝对保留用户的编辑内容。
- 如果用户大幅修改了之前的某个beat，要根据修改内容调整后续的创作方向。
- 如果用户说“重写那个beat”或“回到beat 3尝试另一个选项”，照做即可——原地修改，保留其他内容不变。