novel_chapter_brief

开写包。把「写这一章之前需要读的一切」装配成一次只读调用：上一章结尾原文（承接口）、上一章钩子、本章大纲方向行、按命中过滤的人物卡、未回收伏笔及其埋设距离、世界观禁用词与语用规范、必用词硬清单（lexicon）、六维基线（语料按面板「基线范围」选取，默认全书）、原著锚段与句式骨架、上一章风格自检结论，以及由此生成的三段式 plan 与本章禁用清单；v7.0.0 起另附五项近距护航材料（原著动作颗粒度、本章大纲子句框架、上一章遗留问题、本章症状处方、参照集来源）。chapter 取默认值 "next" 时指向「当前最大章号 + 1」，该文件可以尚未创建。

参数

参数对象声明 additionalProperties: false；budget 省略时按 compact 处理。

输出结构

返回体共 24 个键（13 个契约必返 + baselineScope / baselineMode 两个恒定出现的范围披露字段 + worldview + chapter / lexicon / baseline 三个「取不到就整键省略」+ v7.0.0 新增的 5 个近距护航键）。v6.9.0 另有一个条件键 rawMode（仅非净化模式开启时出现，见下表，不计入上面的 24）；worldview 自 v6.9.5 起恒在（未登记设定时按文化基准注入默认禁用词表）。材料取不到时字段缺省或为空数组，同时在 degraded 里写清是哪些材料、为什么取不到；调用方应以 degraded 判断「这份材料是否完整」，而不是以字段是否存在来猜测。返回前经 dropNullDeep 处理——值为 null / undefined 的键整键丢弃（含数组内的 null 元素），而不是置 null。

characters[] 条目

排序为：mentions 降序 → 「上一章出场」优先 → 名称中文拼音序。

openPlots 条目

注意与 novel_plot 的 entry.chapter 区分：本工具返回的是解析后的章号 firstChapter，不再返回原始的 chapter 文本字符串。

计算与装配

执行顺序：读创作资料（大纲 / 钩子）→ 定位目标章 → 定位上一章 → 逐章读正文 → 组装锚段与骨架 → 算六维基线 → 现算上一章结论 → 算参照集分位 / 动作链 / 子句框架 / 诊断集与症状处方 → 汇总伏笔 → 合并设定表与人物卡 → 生成本章禁用清单 → 生成 plan → 按 budget 截断。全程只读：除复用既有分析缓存（六维测量缓存文件由 metricChaptersCached 按内容哈希增量维护，这是既有行为）外不写任何文件——伏笔表也刻意不走 core.readPlots（它在「新位置缺失 + 旧位置存在」时会迁移写盘），改用只读版本按「新位置 → 旧位置」顺序自行解析。

1 · 目标章定位与 isNext

isNext 的语义是「这一章还没写」而不是「参数是 next」：因此本工具不会因为目标章文件不存在而报错，反而正是它最有用的时刻——此时上一章就是全书最后一章，承接口与钩子都指向它。已有的 novel_style_check 无法对未创建的文件工作，本工具则可以先给材料。

上一章的取法：章号小于目标章号的最后一章；目标章号不确定时退回「全书最后一章」并在 degraded 里说明。全书没有任何更早的章节时，anchor 与 previousHook 均为空串。

2 · 承接口 anchor 与 previousHook

只给结尾而不给全章，是因为续写真正需要的接口是「上一句停在哪里、场景与语气是什么」；全章正文可通过 novel_read 按需补读，而全章塞进返回体只会挤占上下文。hook 未回填、或整份「钩子记录.md」都不存在时，两种情况在 degraded 里是不同的文案（「未初始化」与「没有该章的钩子」），便于区分「没建资料」与「忘了回填」。

3 · 人物卡过滤 characters

过滤器面向的是「这一章可能写到谁」，因此判据取上一章 + 本章大纲两份文本，而不是全书：全书命中会把整张人物表原样带出，等于没过滤。人物设定行的解析口径是 - 名字：简介，没有冒号也认（novel_outline action=character 只给名字不给简介时写出的就是 - 名字，旧正则会把插件自己写的人物卡静默丢掉）；冒号后为空同样算一张卡（描述为空串）。会跳过「角色设定 / 世界观 / 不允许的事件 / 主线目的 / 题材偏好 / 额外要求 / 用户原创设定 / 用户角色设定」这些模板段标签——它们不是人名。设定表与创作资料都没有人物卡时为空数组，并计入 degraded。

「已退场」只识别明确的结构化状态，或句首直接描述该角色的退场/死亡陈述；人物简介中提及他人的死亡、否定或假设不直接触发。比如“调查父亲死亡真相”不会设置 offstage:true。这是保守规则，复杂叙述仍应由作者核对。

4 · 未回收伏笔与 distance

distance 是「埋了多久没回收」的直接量化：它把静态的伏笔表变成带时间压力的清单，让调用方先处理埋得最久、优先级最高的线。已回收（done）的伏笔不进入 openPlots，而是从另一个方向进入 avoid（见下节）。

5 · 世界观 worldview 与禁用清单 avoid

第 ① 类的用意是防止「把已经用掉的线当作新钩子再埋一次」——这是长篇里最常见的自我重复。第 ② 类不再截断（v6.4.0 前只取前 10 条，而合并默认表后动辄 40+ 词，模型最多只看得到 10 个且看不到总数），改为按 12 条一组紧凑渲染，不静默丢词。

v6.4.0 修复（P0-1）：语用规范此前从未到达模型。speechStyle（称谓 / 禁客套语 / 仪式禁式 / 语气）一直被合并进返回体的 worldview，但全文件没有任何消费点——它既没进 avoid 也没进 plan.checklist，于是用户精心登记的「称谓用先生/阁下」「禁提点/承蒙」「仪式禁烧香磕头」「语气禁文言四字客套」一个字都没到模型。第 ③ 类就是补上的消费点：逐项渲染成模型可见的条目，plan.checklist 里再点名一次。这套规范正是为防中式语用渗透而设计的，缺了它，欧式设定下写出的「多谢提点」没有任何一道防线会提醒模型。

6 · 必用词 lexicon（硬清单）

v6.3.0 修复：这段分区此前从未渲染。lib/brief.js 一直在产出 lexicon 载荷、也一直在 plan.checklist 里写下「完整表见上方【必用词·优先使用】」，但 render 里没有对应块——模型可见的文本只来自 render，于是那句硬指令指向了一个不存在的分区，avoid（勿用替身词）一条都到不了模型。现已补上；lexicon 字段本身一直在 JSON 返回体里，词表的登记与审计不受该缺口影响。

与世界观禁用词的分工：novel_settings 的 worldview.bannedWords 管「不要写什么」（进 avoid 清单，kind = "禁词"），本分区管「必须写什么」；两者可以指向同一件事的两面（禁「铜灯」+ 必用「青铜灯」），但数据、开关与消费路径互不重叠。完整语义与九个 action 见 novel_lexicon。

7 · 六维基线 baseline

基线与 novel_style_report、novel_style_check、novel_new_chapter 走同一份分章测量缓存（<root>/.novel-writer/analysis/<book>-chapters-metrics.json），缓存键按内容哈希且与章序无关，因此四个工具交替调用不会互相击穿缓存。只有正文 ≥ 40 字的章节才进入测量；性能：命中缓存时基线几乎零成本；长书首次调用仍需读全书算一遍分章指标（可能数秒），此后增量命中。

8 · 锚段与骨架 anchors / skeletons

与 novel_new_chapter、novel_style_check 共用同一个锚包构建函数，因此三处口径不会分叉。anchors 是「校准语感」的样例，不是造句模板——锚段读一遍对上味道即可，skeletons 只在写不出该类型句子时参考，不要照它造句、不要套句式模板；基线数字只是事后校验。两者都在返回体里，但用途不同。本书正文不满足抽样条件（所有段落都短于 40 字）时两个数组都为空，并计入 degraded；锚包"生成失败"是另一回事（v6.6.0 起两者文案分开，见下表）。

9 · 上一章结论 lastVerdict

这里刻意不做落盘：插件从不把 novel_style_check 的结论写进任何文件，因此「上一章自检结论」是每次由缓存的逐章指标现算的（口径与 novel_style_check 一致，并沿用侧边栏保存的自定义容差）。上一章正文不足 40 字、或除上一章外没有其它可测章节时为空串并计入 degraded。

10 · plan 的生成口径

plan 是材料的索引，不是新信息：它不引入任何未在其它字段出现过的判断，只把散落的材料组织成「动笔前看一眼」的三段式；不编造剧情，所有文本都从已有字段派生（超长片段统一按 clip 截断加省略号）。字段本身不随 budget 截断。

v7.0.0 起 checklist 恒定多一条「章末收束闸门」：「本章必须停在具体动作、突发异响或一句没答完的话上；不写总结陈词与未来展望。」它排在自检建议之后、收尾提醒之前，是动笔时还来得及改的一条；写完之后同一件事由 novel_new_chapter 的 postWriteAudit 以「章末升华」再核一次（只告警、不阻断保存）。

11 · 增强包：颗粒度 / 子句框架 / 处方（v7.0.0）

为什么要一个总额：这几块各自只加一两百字，叠起来足够把弱模型的注意力稀释掉。优先级把最近的事放前面——上一章遗留和本章处方是「现在就得处理」的，动作链只是语感参照。四项全部可空数组；空数组只说明这次没有可用材料，具体原因看 degraded（例如参照集里找不出符合 15~70 字、≥2 个动作动词、≥1 个物件的完整句）。

截断档位 budget

默认 compact 是因为本工具的目标场景是接着写下一章：承接口 300 字符足以承接语气，锚段 2 条 + 骨架 3 条足以定调。追求更完整的锚段材料（锚段 5 条、承接口 600 字符）时应显式传 full，或改用 novel_style_check 的 fixAnchors（写完之后按偏差取锚段，比写之前更准）。budget 只接受 "full" 一个特殊值，传入任何其它值（含 "compact" 与未声明值）都按 compact 执行。v7.0.0 的增强包按 enhanceChars 整包计量（不是每项各截一刀），所以四项可能被截在不同的位置——被截掉的条数写在 degraded 里。

优雅降级

以下情形一律不报错：相应字段缺省或为空数组，同时在 degraded 里说明材料名与原因。这是刻意的设计——「书还没建大纲」不是调用错误，不应该让整个流程中断。

取消信号（exec.signal / AbortError）不属于降级：它会原样向上传播，不被吞掉。

约束与边界

• 只读工具：除复用既有分析缓存（metricChaptersCached 维护的分章测量缓存，属既有行为）外不写任何文件——不建章节、不改伏笔状态、不落盘报告。伏笔表刻意不走会在旧位置迁移写盘的 core.readPlots，而是用本模块的只读版本。需要真正创建章节时用 novel_new_chapter。
• 唯一抛错路径是书名目录不存在；材料缺失、缓存不可用、锚包失败、书太短都走降级。调用方不应把空字段读成「这本书没有伏笔」——必须读 degraded 区分「确实没有」与「取不到」。
• chapter 与 novel_read 共用解析规则：精确文件名优先于章号；只给章号且命中多个同号文件时会报错并列出候选（本工具把它降级为「目标不确定」而不是中断）。纯数字参数不做子串兜底。
• isNext 不等于「参数是 next」：它表示目标章文件尚不存在，因此传入一个未来的章号同样为 true。此时返回的 file 是预期文件名而非磁盘事实（可用 novel_chapters 核对）。
• avoid 的词表不截断（v6.4.0 起）：禁用词按 12 条一组紧凑渲染、每组写明「共 N 条」，语用规范（称谓 / 客套 / 仪式禁式 / 语气）也逐条给出，因此不存在「只禁前 10 个词」式的静默丢弃。词源是 resolveStyleRule 的合并结果（用户登记 ∪ 文化基准默认表），与 novel_continuity_check 的用语扫描一致。未登记任何 worldview 条目时也会注入默认表（worldview 自 v6.9.5 起恒在：按文化基准给默认禁用词，并在 basis 与 degraded 里写明「按哪套基准、共多少条」）——想指定基准时用 novel_settings 的 detect / add 登记一条 worldview。
• distance 依赖章号可解析：chapter / mentionedIn / lastMentioned 三处都解析不出章号时，firstChapter 省略、firstChapterKnown = false，distance 退化为「全书最大章号」（相当于按全书起算），并在 degraded 里点名前 5 条。排序时这类条目按 priority 归一为 medium、再按已退化的 distance 参与比较——不会因此被排到最后，这是刻意的：距离未知不等于不重要。
• 人物命中判定是纯字符串包含，不做语义推理：别名登记不全时会漏命中，同名不同人（如「小周」既指人物又指地名）时会误命中；名字与别名短于 2 字的一律跳过。这是零 token 本地实现的必然边界，命中结果应视为候选。
• 首次调用可能较慢：长书且缓存未预热时需读全书算分章指标；这一点与 budget 无关（见上文）。
• lexicon 只取「装得进预算」的部分：compact 60 / full 200 条、每条保留 2 / 3 个 avoid 是返回体预算的取舍，不是「词表只有这么多」；完整词表用 novel_lexicon 的 list / export 取，截断只影响注入、不动词表数据。
• lexicon 是硬指令，不是新测量：本工具不判断「用没用对」，只把表内词与「勿用」替身词摆到模型面前；判断发生在写完之后，由 novel_lexicon action="audit" 按行号给出（只读、不改正文）。
• 工具开关：执行前经 assertToolEnabled 校验状态文件，被关闭时直接报错（可用 novel_sentence_config 重新开启）。本工具不受「写作助手功能」总开关约束——它与 plan / verify 那类引擎门禁无关。

相关工具

• novel_new_chapter —— 真正创建章节文件的工具；其附带的 baseline / anchors / skeletons 与本工具同源，本工具是那套材料的抽离与扩容（多了钩子、大纲方向行、人物卡、伏笔距离、禁用清单与 plan，v7.0.0 起又多了动作链、子句框架、上一章遗留、症状处方与参照集来源）；它的 plan 参数正是用来兑现本工具的 clauseFrames，postWriteAudit 与本工具的 prevChapterIssues 同源。
• novel_style_check —— 写完之后的对照判定（建议跑一次，偏离明显时才据此修正）；其 fixAnchors 与 lastVerdict 分别为本工具锚段的同源材料与上一章结论的来源。
• novel_outline —— 维护本工具读取的创作资料（钩子记录、剧情大纲方向行）。
• novel_plot —— 伏笔登记表；action: "graph" 的结构视图给出跨章的伏笔生命周期，其 plotLifecycle.distance 与本工具的 openPlots.distance 是同族口径（都按「全书最大章号 − 最早提及章号」），但本工具的 firstChapter 只从登记字段（chapter / mentionedIn / lastMentioned）推导，而结构视图还会用伏笔内容的关键词去全书正文里找首次命中章，两者结果可能不同。
• novel_settings —— 人物表与世界观用语规范（禁用词 / 推荐替代 / 语用规范）的维护入口。注意分工：worldview.bannedWords 管「不要写什么」（进本工具的 avoid 清单），novel_lexicon 管「必须写什么」（进本工具的 lexicon 分区）。
• novel_lexicon —— 必用词表：本工具 lexicon 分区与 plan.checklist 硬指令的数据源（合并两层、同名以书级为准，受功能开关 lexiconFirst 控制）；写完一章用它的 action: "audit" 复核覆盖率与「通用词顶替」的行号。
• novel_read —— 需要上一章全文（而非仅结尾 300 字）时按行号补读。

源码位置

• lib/brief.js —— 开写包主体：buildChapterBrief（唯一的对外导出）与其内部各步——BRIEF_BUDGETS（两档预算常量，含 lexicon / avoidPerTerm）、readPlotsReadOnly（只读伏笔读取）、readCreationFile / parseNumberedLines（创作资料读取与编号行解析）、deriveChapterFileName（预期文件名推导）、plotFirstChapter（最早提及章号）、mergeWorldviewBasis（worldview 多条目的 basis 文本拼接，v6.4.0 起只管 basis——词源交给 resolveStyleRule）、pushBannedWordAvoids / pushSpeechStyleAvoids（禁用词与语用规范的分组渲染，v6.4.0 新增，后者修复「speechStyle 到不了模型」）、parseCharacterLines / OFFSTAGE_RE / countMentions（人物卡三源合并与命中统计）、plotKeywordsAll（不截断的关键词版本，供「已回收伏笔 ∩ 方向行」使用）、必用词注入（readLexicon → selectLexiconForBrief → groupLexiconByKind，含 lexiconFirst 门禁与三条 degraded 文案）、clip / isAbort。
• lib/index.js —— registerNovelChapterBrief：工具注册、参数校验（budget 归一）、输出 schema 与渲染文本（含 【必用词·优先使用】 分区——v6.3.0 起才真正渲染）。
• lib/core.js —— metricChaptersCached（六维分章测量缓存）、buildStyleAnchorPackage（锚段与骨架的抽样与上限）、readSettings（设定表）、plotsFile / legacyPlotsFile / normalizePlotEntry / plotKeywords（伏笔表路径与条目归一）、creationDir / CREATION_FILES（创作资料路径）、scanChapters / findChapter / readTextFile / parseChapterNumber（章节定位、读取与章号解析）。
• lib/style-metrics.js —— computeBaselineFromPerChapter（基线的 μ / σ / recTol 口径）/ judgeAgainstBaseline（上一章六维判定）/ METRIC_ORDER / METRIC_LABELS。
• lib/obligations.js / lib/chapter-diagnose.js / lib/lexicons/slop.js —— v7.0.0 新增的三个确定性模块：buildClauseFrames / ENDING_GATE_TEXT（子句框架与章末闸门）、diagnoseChapterSymptoms / checkPlanFulfillment（单章症状与 plan 兑现，与 novel_new_chapter 的写盘体检共用同一实现）、scanSlop（8 类套话库）。参照集与动作链的裁决在 lib/core.js：resolveReferenceSet / selectDiagnosisChapters / percentile / buildReferenceStats / buildActionChains，本模块的 fitEnhance 负责按 enhanceChars 整包装填。
• lib/core.js —— ALL_TOOLS / TOOL_LABELS 注册表条目（开关面板与关闭报错文案）。