NeuroBook 是一款 AI 驱动的长篇小说写作 IDE，它的剧情工坊把每个伏笔当作一笔「对读者的债务」来记账：埋下、推进、兑现全程留痕，写到目标章节时自动进入写作指令，让契诃夫之枪必然打响。下面用实战视角拆解这套"伏笔记账"系统怎么用、为什么管用。

伏笔为什么总烂尾：把它当技术债看

第 3 章墙上挂了把枪，第 200 章它还没响——问题不在记性，而在没有账本。

工程师不会忘记还技术债，因为每一笔债务都有状态、有责任人、有到期时间。NeuroBook 的做法是把伏笔（以及一切"对读者的承诺"）搬进同一个模型：承诺账本（Promise Ledger）。

• 埋下：登记一笔承诺，写清楚许诺了什么、预期怎么兑现；
• 推进：承诺的节拍挂在具体场景上，场景状态一变，节拍状态跟着变；
• 兑现：写到目标章时，这笔承诺自动进入该章的写作指令，AI 写正文时就知道这里该收线了。

账本逻辑的服务端实现在 promise.service.ts，前端对应 PlotPromiseLedgerTab.vue。

3 分钟认识剧情工坊：两个树、三个分区

顶栏的Plot按钮打开剧情工作台。NeuroBook 用两棵树解决长篇的核心难题——"故事发生的顺序"和"读者读到的顺序"不是一回事：

两棵树在"场景归属的章"上交汇：第 5 章的一场戏，因果上完全可以属于三百年前的某条剧情线——倒叙、插叙、多线并行不再搅成一团。

工作台内部分为三个真实分区：

1. 线程规划：两棵树的结构编辑、场景与剧情线详情，支持拖拽排序；
2. 承诺账本：承诺列表、节拍时间线、兑现 / 放弃 / 重开；
3. 决策记录：未决置顶、ADR 式详情、拍板与作废。

承诺账本实战：埋下、推进、兑现三步记账

账本里每一笔承诺的推进都通过PromiseBeat（节拍）记录，节拍挂在具体场景上，四种类型各管一段：

几个值得新手记住的机制 🎯：

• 形态由字段驱动，不设死板分类。填了期限章才有"逾期"概念，填了节奏（每几章提一次）才有节奏提示——感情线想"每隔几章发一次糖"，也是记成一笔承诺，三十章没发它会提醒你。
• 状态不靠手改。存储态只有open / fulfilled / abandoned三种，中间的planted / echoed / paid_off全部从节拍自动派生，账本状态永远不会和剧情漂移。
• 打payoff节拍默认自动置为"已兑现"（promise.service.ts#L148-L149）；如果里程碑之后线还要延续（比如感情线"在一起"之后还有后续），可关闭自动兑现。
• 删掉兑现场景会自动回退：不再存在有效的payoff节拍时，fulfilled回退为open，不会出现"账已平、枪没响"的假账。

下面这张状态账本视图展示了"逐条登记"的效果：每一项任务/承诺都有明确的状态标记与原文出处，随时可查、可核对。

4 种伏笔兑现机制：契诃夫之枪怎么打

伏笔不打死类型，按兑现机制打标签（推荐词表，可自由扩展）🔫：

• setup_payoff契诃夫之枪：具体元素、因果性回收、单点触发。公平性要求最严格——必须先有plant节拍，才允许payoff；
• prophecy预言/悬念：明确断言，字面式或反讽式兑现，兑现方式写进"兑现预期"字段；
• motif象征/母题：意象重复、累积式兑现，典型形态是没有期限章、有节奏提示；
• mirror镜像/平行：两条以上线索互相映照，节拍分属不同剧情线的场景，双线关联天然成立。

自由文本也有清晰分工，避免互相复述：summary写"向读者许了什么"；payoffExpectation写"兑现时图什么效果"（只给兑现场）；节拍的note写"本次推进到哪一步"（如"只写到发烫，不许发光"）。

自动兑现：写作指令如何强制收线

账本记完不是终点——兑现必须写进正文。每章可带一组章级写作指令（ChapterBrief），其中"信息控制"四字段（读者知道什么 / 主角知道什么 / 必须隐瞒 / 只能暗示）是希区柯克悬念理论的工程化：AI 天然是上帝视角，不显式约束就会让角色说出不该知道的话。

写作前，系统用get_chapter_writer_brief编译出该章的 writer brief，承诺账本以"本章 Promise 任务"段落自动送达：哪个场景要建立、哪个要推进、推进幅度按节拍note收住、兑现任务附上完整"兑现预期"。未填信息控制字段的章节会被直接挡住交接，先补指令才能开工。

格式契约见 writer-brief.md，Agent 操作规范见 agent-spec.md。

决策记录：三个月后还知道为什么这么写

账本管"欠读者什么"，决策记录（Decision）管"为什么这么安排"——借用了工程里的 ADR（架构决策记录）做法：

• 未决状态（open）会挡住 AI 擅自把事情写死；
• 拍板时必填决定内容、动机和风险（risk 是写作者的"刹车点"）；
• 放弃某个方案要写明原因；决策可被推翻，但推翻也留痕。

三个月后你能看到的不只是"主角黑化了"，而是"当时在 A / B / C 三个方案里选了 B，因为要给第四卷的反转留伏笔，已知风险是前期读者可能弃书"。

新手上手：把第一本长篇的伏笔管起来

📌 建议的起步路径：

1. 建结构：先搭承载树（卷、章）和因果树（剧情线、场景），场景挂章、锚定世界时间地点；
2. 立账：每个伏笔记一笔承诺，打对标签，重要的填期限章，需要定期呼应的填节奏；
3. 规划节拍：在对应场景上登记plant / advance / payoff，推进幅度写进节拍说明；
4. 写章节指令：信息控制四字段必填，让 AI 知道哪些秘密只能暗示；
5. 复盘：打开承诺账本看未清偿的账（列表默认未清偿优先、重要度排序），逾期的一笔都跑不掉。

完整数据模型与字段合同见 system.md，功能总览见 plot-workbench.md。

把伏笔当技术债记账，把契诃夫之枪写进账期——长篇连载最难的"收线"，从此变成一项有流程、可追踪的工程。