dsh-novel-write-engine 0.2.6 → 0.2.8

package/briefs/P2.md

@@ -19,7 +19,7 @@
 |---|---|
 | `title` | 不带「第N章」前缀；长度读 rulepack 的 `format.title.min_chars/max_chars`，引擎会拼前缀并校验 |
 | `scene_type` | 四选一：战斗/动作章、日常过渡章、情感爆发章、纯叙事章 |
-| `narrator` | 视角人物，必须在本章出场；第一人称写成 `陈默（第一人称「我」）`，引擎接受括号/引号里的正文别名 |
+| `narrator` | 视角人物，必须在本章出场；第一人称写成 `主角（第一人称「我」）`，引擎接受括号/引号里的正文别名 |
 | `beats` | 5~8 个节拍，每个是一句话的可检验动作 |
 | `opening` | 前两段打算怎么写（场景 + 动作 + 一个钩子） |
 | `ending` | 断章点，必须是新信息或新麻烦 |

package/briefs/P8.md

@@ -28,7 +28,7 @@
 - `timeline` 的键是 `summary.events` 的下标（字符串）。
 - `relationships` 的键是 `"甲|乙"`；每项至少 `{ "action": "created", "type": "关系类型", "description": "..." }`，缺 `type` 会被拒绝。
 - `characters` 的键是人物名；`world` 的键是新地点/能力/物品名；`foreshadows` 的键是 summary 里的 planted key 或已分配的 `FS-xxx`。
-- `foreshadows` 的 `summary.foreshadows.resolved` 里列出的 key，delta 必须写 `action: "updated"`；引擎会把 `resolved_at` 写成当前章，并把 `note`/`new_info` 追加到 `advance_log`。示例：`"FS-002": {"action":"updated","note":"欠条被收回，债清了","new_info":true}`。
+- `foreshadows` 的 `summary.foreshadows.resolved` 里列出的 key，delta 必须写 `action: "updated"`；引擎会把 `resolved_at` 写成当前章，并把 `note`/`new_info` 追加到 `advance_log`。示例：`"FS-002": {"action":"updated","note":"债务已结清","new_info":true}`。
 
 ## 最小 schema
 
@@ -81,7 +81,7 @@
 }
 ```
 
-错误会带上 `expected` 形态和收到的字段值，例如 `characters.陈嘉树.current_state must be an object; expected {"resources":{"港币":3},...}`。不要猜字段名，按报错补齐即可。`current_state.resources` 会与旧余额深合并，余额必须是有限非负整数。
+错误会带上 `expected` 形态和收到的字段值，例如 `characters.主角.current_state must be an object; expected {"resources":{"资源名":3},...}`。不要猜字段名，按报错补齐即可。`current_state.resources` 会与旧余额深合并，余额必须是有限非负整数。
 
 ## summary 与 delta 的联动（归档前必核）
 
@@ -95,9 +95,9 @@
 
 如果 summary 与本章事实不符，先走 **summary-only** 修复：`novel_revise {chapter, summary}`（不带 content/patch/proof）只更新 draft.summary，不消耗 revise 轮次、不改正文，然后按当前阶段继续；只有正文需要改时才走 P5 全文修订。
 
-- **伏笔的 title 是可读标签，anchor 才是校验证据**：`title` 可以写「船费债」这样的短语；要归档，请把正文原句放进 `anchor`（summary 的 planted 项或 delta 项都行，至少 8 个字符）。没有 `anchor` 时，`title` 必须逐字出现在正文里，否则 `ENGINE_DELTA_UNVERIFIED`。示例：`{"action":"created","title":"船费债","anchor":"三百蚊的船费先欠着","description":"欠船费三百蚊"}`。
+- **伏笔的 title 是可读标签，anchor 才是校验证据**：`title` 可以写「欠款」这样的短语；要归档，请把正文原句放进 `anchor`（summary 的 planted 项或 delta 项都行，至少 8 个字符）。没有 `anchor` 时，`title` 必须逐字出现在正文里，否则 `ENGINE_DELTA_UNVERIFIED`。示例：`{"action":"created","title":"欠款","anchor":"那笔欠款还没有还清","description":"欠款未清"}`。
 - 归档失败的报错会指出字段、值和缺失的锚点；不要把 title 改成碎片来“凑命中”，补 `anchor` 即可。
-- 第一人称的叙述者若在 `narrator` 里声明为 `陈默（第一人称「我」）`，正文用「我」也视为出现，但角色键仍写 `陈默`。
+- 第一人称的叙述者若在 `narrator` 里声明为 `主角（第一人称「我」）`，正文用「我」也视为出现，但角色键仍写 `主角`。
 - 每个新实体写 `action: "created"`（正文出现、kind 可确定）；已存在实体写 `updated` 或 `no_change`，引擎会按台账归一化冲突并给 warning。
 - `world` 新实体还要写 `kind: "location"|"ability"|"artifact"|"faction"|"rule"` 和 `description`。
 - `state_delta` 可以是对象，也可以是 JSON 字符串；引擎两者都接受。

package/lib/client.js

@@ -50,9 +50,9 @@ window.__ModuleLoader__.load({
 			P4: "评审",
 			P5: "修订",
 			P6: "一致性",
-			P7: "终审",
-			P8: "归档",
-			P9: "完成"
+			P7: "状态同步",
+			P8: "终审",
+			P9: "归档"
 		};
 		const STAGE_LABELS = {
 			idle: "待开始",
@@ -332,8 +332,10 @@ window.__ModuleLoader__.load({
 			const rowAverage = scored.length === 0 ? 0 : scored.reduce((sum, row) => sum + row.scoreValue, 0) / scored.length;
 			const average = summary.averageScore !== void 0 && Number.isFinite(summary.averageScore) ? summary.averageScore : rowAverage;
 			const next = summary.next;
-			const finished = summary.finished === true;
+			const progress = summary.progress;
+			const finished = progress?.finished ?? summary.finished === true;
 			const doneLabel = summary.stage === "done" ? finished ? "全书完成" : "本章已归档" : stageLabel(summary.stage);
+			const progressLine = progress?.label ?? (summary.stage === "done" ? finished ? `共 ${summary.totalChapters} 章` : `下一章 第 ${summary.chapter} 章` : `第 ${summary.chapter} 章`);
 			const selected = base.projects.find((project) => project.selected);
 			return {
 				...base,
@@ -343,7 +345,7 @@ window.__ModuleLoader__.load({
 				damaged: selected?.state === "damaged",
 				resumeText: payload.resume?.text ?? "",
 				volumeNumber: summary.volume,
-				subtitle: summary.stage === "done" ? `${summary.genre} · ${platformLabel(summary.platform)} · ${finished ? `共 ${summary.totalChapters} 章` : `下一章 第 ${summary.chapter} 章`}${volumeLabel(summary)}` : `${summary.genre} · ${platformLabel(summary.platform)} · 第 ${summary.chapter} 章${volumeLabel(summary)}`,
+				subtitle: `${summary.genre} · ${platformLabel(summary.platform)} · ${progressLine}${volumeLabel(summary)}`,
 				stageLabel: doneLabel,
 				finished,
 				revisionLabel: `第 ${summary.bookData?.current.rounds.revise ?? summary.revision} 次修订`,
@@ -357,6 +359,8 @@ window.__ModuleLoader__.load({
 				stats: {
 					chapters: summary.totalChapters,
 					words: summary.totalWords,
+					...summary.archivedWords === void 0 ? {} : { archivedWords: summary.archivedWords },
+					...summary.draftWords === void 0 ? {} : { draftWords: summary.draftWords },
 					averageScore: Math.round(average * 10) / 10,
 					blocking: blocking.length
 				},
@@ -1146,7 +1150,7 @@ window.__ModuleLoader__.load({
 				title: "写书级蓝图与卷结构",
 				tool: "novel_blueprint",
 				body: "让模型先定 premise（故事前提）、logline（一句话卖点）、themes（主题）、tone（基调）、pov（视角）、audience（读者）、selling_points（卖点）、ending（结局方向）和 volumes（每卷起止章、目标、弧线、高潮）。",
-				note: "蓝图不是正文，可以后补。严格大纲是可选开关：strict:true 时每章必须先有章卡；不开启也能先写，但章卡一旦存在，标题、场景、目标字数和 cast 仍会校验。"
+				note: "蓝图不是正文，可以后补。首次提交章卡时 strict 默认开启；要宽松写作可在蓝图里显式 strict:false 关闭。strict 开启后每章必须先有章卡；章卡一旦存在，标题、场景、目标字数和 cast 仍会校验。"
 			},
 			{
 				title: "排章卡，或导入现成大纲",
@@ -1219,7 +1223,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 每次提交前先领取当前阶段任务书，失败时按返回的 code 和 blocking 一次改完。`;
 		const TUTORIAL_NEXT_PROMPT = `继续写当前项目的下一章。先调用 novel_pipeline（或 novel_status）确认当前阶段、项目根目录和下一步工具，不要猜阶段。
 如果当前会话还没绑定或不确定是哪本书：先用 /novel current 看会话绑定，再调用 novel_status 看 selection；需要切换时用 /novel use <路径|书名|.>，不要靠 active 猜。
-第一次调用带 project_root 时，它会成为当前会话的持久绑定；后续无 root 调用会继续这本书。
+第一次带 project_root 的项目调用会成为当前会话的持久绑定；后续无 root 调用会继续这本书。纯文本的 novel_word_count 和 novel_diff 不读取项目，也不会建立绑定。
 
 如果下一章还没有章卡：用 novel_outline 只提交下一章的卡（按 num upsert），省略的已有卡会保持不动；不要重交全量，也不要用空数组清空。要删卡必须显式传 remove。
 如果 targets.total_chapters 已经写满：先用 novel_amend 把 total_chapters 调到至少包含下一章，不能低于已归档章数。
@@ -1515,7 +1519,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 			ref: closeRef,
 			onClick: onClose,
 			"aria-label": "关闭使用教程"
-		}, (0, react.createElement)("span", { "aria-hidden": "true" }, "×"))), (0, react.createElement)("div", { className: "nwe-modal-body" }, (0, react.createElement)("div", { className: "nwe-tutorial-intro" }, (0, react.createElement)("p", null, "网文工坊不是一个“帮你想剧情”的按钮，而是一台有状态的写作引擎：你提供内容，引擎负责阶段、字数、门控、评审、归档和文件。"), (0, react.createElement)("p", null, "每一步都先领取当前阶段的任务书，再提交；提交后看引擎返回的 blocking 与下一步。面板只读，真正的写操作都在对话里的工具调用中。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "开始前：记住三件事"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "只用引擎入口写"), (0, react.createElement)("span", null, "正文只走 novel_write_draft / novel_revise；状态只走工具。手改 chapters/、state/、outline/ 会破坏事务与校验。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "每一步先领 brief"), (0, react.createElement)("span", null, "任务书携带当前上下文和 digest；跳过它会撞 PG-01。任务书过期就重新领取，不要复用旧上下文。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "失败先读 code"), (0, react.createElement)("span", null, "参数错改参数，门控没过改正文，系统故障查目录/稍后重试。blocking 会一次列全，一次改完再交。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "用哪个会话："), " 想获得完整的引擎保证，请新开一个「网文工坊」预设会话；普通会话里模型可能还挂着文件工具，能绕过引擎直接改稿。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一本书的完整流程"), (0, react.createElement)("p", null, "前四步是开书准备，后面是每章循环。第一次先按顺序走完一章，熟悉后再批量推进整本。"), (0, react.createElement)("ol", { className: "nwe-steps" }, ...TUTORIAL_STEPS.map((step, index) => tutorialStep(step, index)))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "面板怎么看"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "顶部统计"), (0, react.createElement)("span", null, "已归档章、总字数、平均分、待处理门控。数字来自引擎，不是正文估算。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "九阶段轨与下一步"), (0, react.createElement)("span", null, "亮起的阶段是当前进度，“下一步”卡会直接给出该调用的工具名。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "章节与门控"), (0, react.createElement)("span", null, "章节卡展开可看字数、评分与状态；门控区按 code/detail/hint 列出所有阻塞。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "刷新："), " 面板每 15 秒静默同步一次，也可以点右上角刷新。它是只读投影；不会替你改稿、归档或修状态。"), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "项目状态："), "选择器里 choose 表示发现多本书、还没选；项目不在了表示目录缺失，绑定仍会保留；不是项目表示目录还在但没有 novel.yaml 或项目状态；项目不可读表示权限或 IO 错误，先修权限或换一本。面板选择只影响查看，不改变任何会话的写作绑定。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "卡住时先看这里"), (0, react.createElement)("ul", { className: "nwe-faq" }, (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "为什么一直让我先领 brief？"), (0, react.createElement)("p", null, "这是正常门控。任务书决定当前阶段可用的字段与上下文 digest；先按返回值调用 novel_brief，再继续。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "门控失败，改一条还是全改？"), (0, react.createElement)("p", null, "一次看完所有 blocking，再一起改。逐条试会反复烧掉阶段轮次；错误里的 code 会告诉你属于参数、门控还是系统故障。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "字数和评分为什么对不上？"), (0, react.createElement)("p", null, "字数以 engine 返回为准，可用 novel_word_count 核对；review 的 total 必须等于 150 减全部扣分，不能另算一套。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "P4/P6 过不去怎么办？"), (0, react.createElement)("p", null, "P4 有 blocker 就领 P5 任务书修订，再回 P4 重评；P6 失败同样回修订。不要 waive blocker，也不要只跑半个 scope 就归档。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "想改已经归档的章节？"), (0, react.createElement)("p", null, "先 novel_reopen，带非空 reason。它会从归档备份恢复，重开后重新走 P3→P8；不要直接编辑归档卡或正文文件。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "状态文档坏了能手工修吗？"), (0, react.createElement)("p", null, "先用 novel_state 看 raw 和 next；需要修复时用 novel_amend，并在 reason 写清原因。手改 YAML 会丢失事务保护。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "有多个项目，面板看的是哪本？"), (0, react.createElement)("p", null, "面板用顶部项目选择器切换查看对象；选择只改 ?root= 和浏览器 localStorage，不调用 activate、不写会话绑定。写作项目请用 /novel use 或显式 project_root。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "选错书、想清掉绑定怎么办？"), (0, react.createElement)("p", null, "先用 /novel current 看当前会话绑定；要换书用 /novel use <路径|书名|.>，要清掉只影响当前会话的绑定用 /novel unbind。不要靠 active 猜，也不要手改 state/session-bindings.yaml。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "扫描到了，为什么还没切过去？"), (0, react.createElement)("p", null, "scan 只读发现；scan --register 只登记项目，不选择、不改 active、不绑会话。真正切换写作项目要用 /novel use，或第一次调用显式传 project_root。")))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "可以直接复制给模型的起手话术"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "续写下一章时，直接复制这段给 Agent"), (0, react.createElement)("p", null, "这段会先确认状态，再处理缺章卡和目标章数已满，最后按 P1→P8 推进；归档前会要求你确认 state_delta。"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_NEXT_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一章完成检查清单"), (0, react.createElement)("ul", { className: "nwe-checklist" }, (0, react.createElement)("li", null, "本章 P1/P2 计划已提交，P3 正文已通过格式与字数门控。"), (0, react.createElement)("li", null, "P4 评审 total 对账无误，没有未修 blocker。"), (0, react.createElement)("li", null, "P6 五个语义项都有不同句子的正文引用，完整 scope 通过。"), (0, react.createElement)("li", null, "P8 任务书当前，novel_archive 带完整 state_delta 成功。"), (0, react.createElement)("li", null, "面板出现已归档章节，门控区没有新的阻塞。")))), (0, react.createElement)("div", { className: "nwe-modal-foot" }, "教程基于 0.2.6 · 具体字段以当前任务书和工具返回为准 · 面板只读")));
+		}, (0, react.createElement)("span", { "aria-hidden": "true" }, "×"))), (0, react.createElement)("div", { className: "nwe-modal-body" }, (0, react.createElement)("div", { className: "nwe-tutorial-intro" }, (0, react.createElement)("p", null, "网文工坊不是一个“帮你想剧情”的按钮，而是一台有状态的写作引擎：你提供内容，引擎负责阶段、字数、门控、评审、归档和文件。"), (0, react.createElement)("p", null, "每一步都先领取当前阶段的任务书，再提交；提交后看引擎返回的 blocking 与下一步。面板只读，真正的写操作都在对话里的工具调用中。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "开始前：记住三件事"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "只用引擎入口写"), (0, react.createElement)("span", null, "正文只走 novel_write_draft / novel_revise；状态只走工具。手改 chapters/、state/、outline/ 会破坏事务与校验。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "每一步先领 brief"), (0, react.createElement)("span", null, "任务书携带当前上下文和 digest；跳过它会撞 PG-01。任务书过期就重新领取，不要复用旧上下文。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "失败先读 code"), (0, react.createElement)("span", null, "参数错改参数，门控没过改正文，系统故障查目录/稍后重试。blocking 会一次列全，一次改完再交。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "用哪个会话："), " 想获得完整的引擎保证，请新开一个「网文工坊」预设会话；普通会话里模型可能还挂着文件工具，能绕过引擎直接改稿。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一本书的完整流程"), (0, react.createElement)("p", null, "前四步是开书准备，后面是每章循环。第一次先按顺序走完一章，熟悉后再批量推进整本。"), (0, react.createElement)("ol", { className: "nwe-steps" }, ...TUTORIAL_STEPS.map((step, index) => tutorialStep(step, index)))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "面板怎么看"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "顶部统计"), (0, react.createElement)("span", null, "已归档章、总字数、平均分、待处理门控。数字来自引擎，不是正文估算。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "九阶段轨与下一步"), (0, react.createElement)("span", null, "亮起的阶段是当前进度，“下一步”卡会直接给出该调用的工具名。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "章节与门控"), (0, react.createElement)("span", null, "章节卡展开可看字数、评分与状态；门控区按 code/detail/hint 列出所有阻塞。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "刷新："), " 面板每 15 秒静默同步一次，也可以点右上角刷新。它是只读投影；不会替你改稿、归档或修状态。"), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "项目状态："), "选择器里 choose 表示发现多本书、还没选；项目不在了表示目录缺失，绑定仍会保留；不是项目表示目录还在但没有 novel.yaml 或项目状态；项目不可读表示权限或 IO 错误，先修权限或换一本。面板选择只影响查看，不改变任何会话的写作绑定。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "卡住时先看这里"), (0, react.createElement)("ul", { className: "nwe-faq" }, (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "为什么一直让我先领 brief？"), (0, react.createElement)("p", null, "这是正常门控。任务书决定当前阶段可用的字段与上下文 digest；先按返回值调用 novel_brief，再继续。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "门控失败，改一条还是全改？"), (0, react.createElement)("p", null, "一次看完所有 blocking，再一起改。逐条试会反复烧掉阶段轮次；错误里的 code 会告诉你属于参数、门控还是系统故障。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "字数和评分为什么对不上？"), (0, react.createElement)("p", null, "字数以 engine 返回为准，可用 novel_word_count 核对；review 的 total 必须等于 150 减全部扣分，不能另算一套。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "P4/P6 过不去怎么办？"), (0, react.createElement)("p", null, "P4 有 blocker 就领 P5 任务书修订，再回 P4 重评；P6 失败同样回修订。不要 waive blocker，也不要只跑半个 scope 就归档。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "想改已经归档的章节？"), (0, react.createElement)("p", null, "先 novel_reopen，带非空 reason。它会从归档备份恢复，重开后重新走 P3→P8；不要直接编辑归档卡或正文文件。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "状态文档坏了能手工修吗？"), (0, react.createElement)("p", null, "先用 novel_state 看 raw 和 next；需要修复时用 novel_amend，并在 reason 写清原因。手改 YAML 会丢失事务保护。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "有多个项目，面板看的是哪本？"), (0, react.createElement)("p", null, "面板用顶部项目选择器切换查看对象；选择只改 ?root= 和浏览器 localStorage，不调用 activate、不写会话绑定。写作项目请用 /novel use 或显式 project_root。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "选错书、想清掉绑定怎么办？"), (0, react.createElement)("p", null, "先用 /novel current 看当前会话绑定；要换书用 /novel use <路径|书名|.>，要清掉只影响当前会话的绑定用 /novel unbind。不要靠 active 猜，也不要手改 state/session-bindings.yaml。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "扫描到了，为什么还没切过去？"), (0, react.createElement)("p", null, "scan 只读发现；scan --register 只登记项目，不选择、不改 active、不绑会话。真正切换写作项目要用 /novel use，或第一次调用显式传 project_root。")))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "可以直接复制给模型的起手话术"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "续写下一章时，直接复制这段给 Agent"), (0, react.createElement)("p", null, "这段会先确认状态，再处理缺章卡和目标章数已满，最后按 P1→P8 推进；归档前会要求你确认 state_delta。"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_NEXT_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一章完成检查清单"), (0, react.createElement)("ul", { className: "nwe-checklist" }, (0, react.createElement)("li", null, "本章 P1/P2 计划已提交，P3 正文已通过格式与字数门控。"), (0, react.createElement)("li", null, "P4 评审 total 对账无误，没有未修 blocker。"), (0, react.createElement)("li", null, "P6 五个语义项都有不同句子的正文引用，完整 scope 通过。"), (0, react.createElement)("li", null, "P8 任务书当前，novel_archive 带完整 state_delta 成功。"), (0, react.createElement)("li", null, "面板出现已归档章节，门控区没有新的阻塞。")))), (0, react.createElement)("div", { className: "nwe-modal-foot" }, "教程基于 0.2.8 · 具体字段以当前任务书和工具返回为准 · 面板只读")));
 		const NovelHelp = () => {
 			const [open, setOpen] = (0, react.useState)(false);
 			const triggerRef = (0, react.useRef)(null);
@@ -1592,6 +1596,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 		const bookDataSection = (view) => {
 			const data = view.bookData;
 			if (data === null) return null;
+			const currentLabel = data.current.stage === "done" ? data.progress.target !== null && data.progress.archived >= data.progress.target ? "全书完成" : `下一章 ${data.current.chapter} · 未开始` : `${data.current.chapter} · ${data.current.stage}`;
 			const dims = data.quality.dimensions.map((dimension) => (0, react.createElement)("div", {
 				className: "nwe-v6-bar",
 				key: dimension.id
@@ -1613,7 +1618,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 				["已归档", `${data.progress.archived} / ${data.progress.target ?? "不限"} 章`],
 				["字数", `归档 ${data.progress.words_archived} · 含草稿 ${data.progress.words_with_draft}`],
 				["剩余", data.progress.remaining_words === null ? "—" : `${data.progress.remaining_words} 字（${data.progress.remaining_words_basis}）`],
-				["当前章", `${data.current.chapter} · ${data.current.stage} · ${data.current.card?.title ?? "无章卡"}`],
+				["当前章", `${currentLabel} · ${data.current.card?.title ?? "无章卡"}`],
 				["轮次", `评 ${data.current.rounds.review} / 修 ${data.current.rounds.revise} / 检 ${data.current.rounds.check}`],
 				["正文 hash", data.current.manuscript_hash ?? "—"],
 				["当前字数", data.current.metrics === null ? "—" : String(data.current.metrics.total_word_count)]
@@ -1685,7 +1690,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 				className: "nwe-stats",
 				role: "group",
 				"aria-label": "项目统计"
-			}, stat("已归档", String(view.stats.chapters), "章"), stat("总字数", view.stats.words.toLocaleString("zh-CN"), "字"), stat("全书均分", view.stats.chapters === 0 ? "—" : String(view.stats.averageScore), "/150"), stat("待处理", String(view.stats.blocking), "项")) : null, ready ? bookDataSection(view) : null, view.state === "loading" ? loadingState() : null, view.state === "choose" ? choosePanel(view, onSelectProject) : null, view.state === "missing" ? missingPanel(view) : null, view.state === "error" || view.state === "empty" || view.state === "outdated" ? statePanel(view.state, view, loading, onRefresh) : null, ready ? (0, react.createElement)("div", { className: "nwe-desk" }, (0, react.createElement)("div", { className: "nwe-desk-main" }, (0, react.createElement)("div", { className: "nwe-desk-heading" }, (0, react.createElement)("span", { className: "nwe-desk-kicker" }, "当前一章"), (0, react.createElement)("span", { className: "nwe-desk-note" }, view.stageLabel)), phases(view), blockingSection(view), advisoriesSection(view), pendingSection(view), legacySection(view), chaptersSection(view)), (0, react.createElement)("aside", {
+			}, stat("已归档", String(view.stats.chapters), "章"), stat("总字数", view.stats.words.toLocaleString("zh-CN"), (view.stats.draftWords ?? 0) > 0 ? `字（归档 ${(view.stats.archivedWords ?? 0).toLocaleString("zh-CN")} + 草稿 ${view.stats.draftWords.toLocaleString("zh-CN")}）` : "字"), stat("全书均分", view.stats.chapters === 0 ? "—" : String(view.stats.averageScore), "/150"), stat("待处理", String(view.stats.blocking), "项")) : null, ready ? bookDataSection(view) : null, view.state === "loading" ? loadingState() : null, view.state === "choose" ? choosePanel(view, onSelectProject) : null, view.state === "missing" ? missingPanel(view) : null, view.state === "error" || view.state === "empty" || view.state === "outdated" ? statePanel(view.state, view, loading, onRefresh) : null, ready ? (0, react.createElement)("div", { className: "nwe-desk" }, (0, react.createElement)("div", { className: "nwe-desk-main" }, (0, react.createElement)("div", { className: "nwe-desk-heading" }, (0, react.createElement)("span", { className: "nwe-desk-kicker" }, "当前一章"), (0, react.createElement)("span", { className: "nwe-desk-note" }, view.stageLabel)), phases(view), blockingSection(view), advisoriesSection(view), pendingSection(view), legacySection(view), chaptersSection(view)), (0, react.createElement)("aside", {
 				className: "nwe-desk-side",
 				"aria-label": "全书与活动"
 			}, bookSection(view), activitySection(view))) : null, footer());

package/lib/index.d.ts

@@ -301,8 +301,8 @@ interface CharacterDelta {
   role?: string;
   profile?: Record<string, unknown>;
   current_state?: Record<string, unknown>;
+  /** Chapter is engine-assigned from the archive transaction, not caller-supplied. */
   growth?: {
-    chapter: number;
     change: string;
     status_change: string;
   };
@@ -972,6 +972,8 @@ interface GateInput {
   briefStage: BriefStage | null;
   draftTitle: string | null;
   sceneType: SceneType | null;
+  /** The submitted/active plan narrator; PG-05 uses it before a draft exists. */
+  narrator?: string | null;
   summary: ChapterSummary | null;
   /** P5 may omit `summary`; when omitted, the previous plan summary is reused. */
   summaryProvided?: boolean;
@@ -1034,6 +1036,36 @@ interface Selection {
   title?: string;
   created_at?: string;
 }
+/**
+ * One human-readable projection of the pipeline's chapter boundary.
+ *
+ * `pipeline.chapter`/`stage` are protocol values: after archiving chapter N the
+ * pipeline points at N+1 and still says `done` because `done` describes the
+ * chapter that was just archived. This projection is the only place that turns
+ * those values into "chapter N archived; chapter N+1 starts at P1".
+ */
+interface ChapterProgress {
+  active_chapter: number;
+  stage: Stage;
+  /** The chapter currently being written; null while `stage === 'done'`. */
+  current: {
+    chapter: number;
+    stage: Stage;
+  } | null;
+  /** Highest archived chapter, or null before the first archive. */
+  last_archived: number | null;
+  /** Next chapter to start at P1; null while writing or after the book is finished. */
+  next: {
+    chapter: number;
+    stage: 'P1';
+  } | null;
+  /** True only when the configured target has been reached at `stage === 'done'`. */
+  finished: boolean;
+  /** One line for status cards, commands and the panel. */
+  label: string;
+  /** Sentence used by the resume prompt instead of "当前第 N 章，阶段 done". */
+  resume: string;
+}
 /** The `getStatus` payload. */
 interface StatusReport {
   project: {
@@ -1054,6 +1086,8 @@ interface StatusReport {
   /** SHA-256 of the active manuscript, or null when the stage has no draft. */
   manuscript_hash: string | null;
   stage: Stage;
+  /** Chapter-boundary projection shared by every human-readable surface. */
+  progress?: ChapterProgress;
   rounds: RoundCounters;
   blocking: BlockingItem[];
   /** Non-blocking recovery notes, e.g. a recoverable pending transaction. */
@@ -1106,6 +1140,8 @@ interface StatusReport {
 interface AdviceReport {
   stage: Stage;
   chapter: number;
+  /** Same chapter-boundary projection as getStatus. */
+  progress?: ChapterProgress;
   tool: string;
   args: Record<string, unknown>;
   reason: string;
@@ -1577,6 +1613,8 @@ interface PanelSnapshot {
   platform: string;
   chapter: number;
   stage: Stage;
+  /** Chapter-boundary projection; `chapter`/`stage` stay as the protocol pair. */
+  progress?: ChapterProgress;
   revision: number;
   rounds: {
     review: number;
@@ -1595,8 +1633,12 @@ interface PanelSnapshot {
   chapters: ChapterRecord[];
   /** The active, not-yet-archived chapter; archived rows come from `chapters`. */
   draft?: PanelDraft | null;
-  /** Total words across the index, for the header. */
+  /** Archived words plus the active draft; the header shows this total. */
   totalWords: number;
+  /** Words in archived chapters only. */
+  archivedWords?: number;
+  /** Active draft words, zero when no draft exists. */
+  draftWords?: number;
   /** Book-wide archived average, not just the panel's capped rows. */
   averageScore?: number;
   /** The nine-phase strip state, derived from the pipeline stage. */
@@ -1694,8 +1736,14 @@ interface PanelSummaryDto {
   platform: string;
   chapter: number;
   stage: Stage;
+  /** Chapter-boundary projection; absent on older payloads. */
+  progress?: ChapterProgress;
   revision: number;
   totalWords: number;
+  /** Words in archived chapters only; `totalWords` also counts the active draft. */
+  archivedWords?: number;
+  /** Active draft words, zero when no draft exists. */
+  draftWords?: number;
   totalChapters: number;
   /** Book-wide archived average; absent on older payloads. */
   averageScore?: number;
@@ -1825,12 +1873,27 @@ interface PanelBundle {
   empty?: true;
   error?: string;
 }
+interface ChapterProgressInput {
+  activeChapter: number;
+  stage: Stage;
+  archived: readonly number[];
+  target: number | null;
+}
+/**
+ * Turn the protocol pair (`chapter` + `stage`) into the only human-readable
+ * chapter boundary. After archiving chapter N the protocol intentionally keeps
+ * `stage: 'done'` and advances `chapter` to N+1; `done` describes chapter N,
+ * not the chapter the pipeline now points at.
+ */
+declare function projectChapterProgress(input: ChapterProgressInput): ChapterProgress;
 interface ResumePromptInput {
   title: string;
   root: string;
   chapter: number | string;
   stage: string;
   nextTool: string;
+  /** When supplied, replaces the protocol pair with the chapter boundary text. */
+  progress?: ChapterProgress;
 }
 /** One shared prompt template for `/novel resume` and the panel copy button. */
 declare function formatResumePrompt(input: ResumePromptInput): string;
@@ -2298,6 +2361,7 @@ declare class EngineService {
   }): Promise<OpResult<{
     stage: Stage;
     chapter: number;
+    progress: ChapterProgress;
     tool: string;
     args: Record<string, unknown>;
     reason: string;
@@ -2419,6 +2483,8 @@ declare class EngineService {
     root?: string;
   }): Promise<{
     totalWords: number;
+    archivedWords: number;
+    draftWords: number;
     chapters: number;
     revision: number;
     rulepack: string;
@@ -2805,4 +2871,4 @@ declare const Config: Schema<Config>;
  * created lazily per project root.
  */
 declare function apply(ctx: Context, config: Config): void;
-export { ARCHIVE_DIGESTS_FILE, AdviceReport, ArchiveHandoff, AuditRow, BACKUP_DIR, BRIEF_RECEIPTS_FILE, BlockingItem, BookPlan, BookReport, BriefDocument, BriefLibrary, BriefReceipt, BriefReceiptsDocument, BriefStage, CHAPTERS_DIR, CHECK_DIR, CORE_TOOLS, ChapterCastMember, ChapterPlanInput, ChapterRecord, ChapterStatusRow, ChapterSummary, ChaptersDocument, CharacterDelta, CharactersDocument, CheckDocument, Config, DEFAULT_GENRE, DEFAULT_PLATFORM, Deduction, DeltaAction, DiffReport, DoctorCheck, DoctorReport, DraftInput, DraftState, ERROR_CODES, EXPORT_DIR, EngineBlockedError, EngineError, EngineFaultError, EngineInputError, EngineService, ErrorCode, ExportChapter, ExportKind, ForeshadowDelta, ForeshadowsDocument, GENRES, GateInput, GateOptions, GateResult, Genre, GuideReport, GuideStep, HISTORY_DIR, HISTORY_KINDS, HandoffDocument, HistoryKind, INITIAL_STAGE, LIMITS, LOCK_FILE, LocksDocument, METADATA_LOCK_FILE, MachineMetrics, NovelProject, OPERATIONS, OUTLINE_DEPRECATED_FILE, OUTLINE_DIR, OUTLINE_FILE, OpResult, Operation, OutlineChapter, OutlineDocument, OutlineProgress, OutlineVolume, PANEL_CHAPTER_LIMIT, PANEL_ID, PANEL_ROUTE, PHASE_STRIP, PLAN_DIR, PLATFORMS, PLUGIN_NAME, PROJECT_FILE, PanelBook, PanelBundle, PanelChapterRow, PanelChaptersDto, PanelDraft, PanelGatesDto, PanelMissing, PanelProjectOption, PanelSelection, PanelSnapshot, PanelSummaryDto, PipelineState, Platform, REGISTRY_FILE, REMOTE_VERSION, REVIEW_DIR, ReadingProof, ReadingProofReference, RelationshipDelta, RelationshipsDocument, ResumePromptInput, ReviewDocument, ReviewInput, ReviewIssue, RevisionEdit, RevisionInput, RevisionPatch, RoundCounters, SCENE_TYPES, SCENE_TYPE_DEFAULT, SCHEMA_VERSION, SESSION_BINDINGS_FILE, SKILL_NAME, STAGING_DIR, STATE_DIR, STATE_FILES, SceneType, ScoreDimension, SearchReport, SearchResultItem, Selection, SelectionSource, SemanticItem, Severity, Stage, StateDelta, StateError, StateErrorCode, StatusReport, TOOL_NAMES, TimelineDelta, TimelineDocument, ToolName, Violation, WORLDBOOK_FILE, Warning, WordMetrics, WorldDelta, WorldDocument, WorldPlanInput, WorldbookBackstory, WorldbookCharacter, WorldbookDocument, WorldbookFact, WorldbookFaction, WorldbookGlossary, WorldbookLocation, WorldbookRule, applicableGates, apply, blockedError, briefStageFor, chapterFile, chapterHeading, chapterHistoryFile, checkFile, checkHistoryFile, deprecatedChapterFile, deprecatedHistoryFile, evaluateGates, faultError, formatResumePrompt, gateName, inject, inputError, loadRulepack, name, parseParagraphLocation, phaseStrip, planChapterFile, planHistoryFile, planWorldFile, projectChapter, projectChapters, projectGates, projectSummary, renderBlurb, renderCover, renderEpubChapter, renderMarkdown, renderPlainText, renderProposal, reviewFile, reviewHistoryFile, verifyReference };
+export { ARCHIVE_DIGESTS_FILE, AdviceReport, ArchiveHandoff, AuditRow, BACKUP_DIR, BRIEF_RECEIPTS_FILE, BlockingItem, BookPlan, BookReport, BriefDocument, BriefLibrary, BriefReceipt, BriefReceiptsDocument, BriefStage, CHAPTERS_DIR, CHECK_DIR, CORE_TOOLS, ChapterCastMember, ChapterPlanInput, ChapterProgress, ChapterProgressInput, ChapterRecord, ChapterStatusRow, ChapterSummary, ChaptersDocument, CharacterDelta, CharactersDocument, CheckDocument, Config, DEFAULT_GENRE, DEFAULT_PLATFORM, Deduction, DeltaAction, DiffReport, DoctorCheck, DoctorReport, DraftInput, DraftState, ERROR_CODES, EXPORT_DIR, EngineBlockedError, EngineError, EngineFaultError, EngineInputError, EngineService, ErrorCode, ExportChapter, ExportKind, ForeshadowDelta, ForeshadowsDocument, GENRES, GateInput, GateOptions, GateResult, Genre, GuideReport, GuideStep, HISTORY_DIR, HISTORY_KINDS, HandoffDocument, HistoryKind, INITIAL_STAGE, LIMITS, LOCK_FILE, LocksDocument, METADATA_LOCK_FILE, MachineMetrics, NovelProject, OPERATIONS, OUTLINE_DEPRECATED_FILE, OUTLINE_DIR, OUTLINE_FILE, OpResult, Operation, OutlineChapter, OutlineDocument, OutlineProgress, OutlineVolume, PANEL_CHAPTER_LIMIT, PANEL_ID, PANEL_ROUTE, PHASE_STRIP, PLAN_DIR, PLATFORMS, PLUGIN_NAME, PROJECT_FILE, PanelBook, PanelBundle, PanelChapterRow, PanelChaptersDto, PanelDraft, PanelGatesDto, PanelMissing, PanelProjectOption, PanelSelection, PanelSnapshot, PanelSummaryDto, PipelineState, Platform, REGISTRY_FILE, REMOTE_VERSION, REVIEW_DIR, ReadingProof, ReadingProofReference, RelationshipDelta, RelationshipsDocument, ResumePromptInput, ReviewDocument, ReviewInput, ReviewIssue, RevisionEdit, RevisionInput, RevisionPatch, RoundCounters, SCENE_TYPES, SCENE_TYPE_DEFAULT, SCHEMA_VERSION, SESSION_BINDINGS_FILE, SKILL_NAME, STAGING_DIR, STATE_DIR, STATE_FILES, SceneType, ScoreDimension, SearchReport, SearchResultItem, Selection, SelectionSource, SemanticItem, Severity, Stage, StateDelta, StateError, StateErrorCode, StatusReport, TOOL_NAMES, TimelineDelta, TimelineDocument, ToolName, Violation, WORLDBOOK_FILE, Warning, WordMetrics, WorldDelta, WorldDocument, WorldPlanInput, WorldbookBackstory, WorldbookCharacter, WorldbookDocument, WorldbookFact, WorldbookFaction, WorldbookGlossary, WorldbookLocation, WorldbookRule, applicableGates, apply, blockedError, briefStageFor, chapterFile, chapterHeading, chapterHistoryFile, checkFile, checkHistoryFile, deprecatedChapterFile, deprecatedHistoryFile, evaluateGates, faultError, formatResumePrompt, gateName, inject, inputError, loadRulepack, name, parseParagraphLocation, phaseStrip, planChapterFile, planHistoryFile, planWorldFile, projectChapter, projectChapterProgress, projectChapters, projectGates, projectSummary, renderBlurb, renderCover, renderEpubChapter, renderMarkdown, renderPlainText, renderProposal, reviewFile, reviewHistoryFile, verifyReference };