dsh-novel-write-engine 0.2.6 → 0.2.7

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

@@ -1515,7 +1515,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.7 · 具体字段以当前任务书和工具返回为准 · 面板只读")));
 		const NovelHelp = () => {
 			const [open, setOpen] = (0, react.useState)(false);
 			const triggerRef = (0, react.useRef)(null);

package/lib/index.js

@@ -5595,7 +5595,7 @@ function applyStateDelta(input) {
 			"profile",
 			"current_state",
 			"growth"
-		]) if (declared[field] !== void 0 && !isRecord(declared[field])) fail$1(`characters.${name}.${field} must be an object; expected ${field === "current_state" ? "{\"resources\":{\"港币\":3},\"status\":\"...\"}" : field === "profile" ? "{\"age\":31,\"occupation\":\"...\"}" : "{\"change\":\"...\",\"status_change\":\"...\"}"}`);
+		]) if (declared[field] !== void 0 && !isRecord(declared[field])) fail$1(`characters.${name}.${field} must be an object; expected ${field === "current_state" ? "{\"resources\":{\"资源名\":3},\"status\":\"...\"}" : field === "profile" ? "{\"age\":31,\"occupation\":\"...\"}" : "{\"change\":\"...\",\"status_change\":\"...\"}"}`);
 		if (declared.growth !== void 0) {
 			const growth = declared.growth;
 			for (const field of ["change", "status_change"]) if (typeof growth[field] !== "string" || growth[field].trim() === "") fail$1(`characters.${name}.growth.${field} must be a non-empty string`);
@@ -10650,7 +10650,7 @@ var EngineService = class {
 			} catch {}
 			if (oldChecks > 0) issues.push({
 				code: "LEGACY_CHECK_FORMAT",
-				detail: `${oldChecks} 章 check 是 0.2.0 旧格式（advisory 混在 violations）；重新跑 novel_check 或按 docs/0.2.3-plan.md 标记`
+				detail: `${oldChecks} 章 check 是 0.2.0 旧格式（advisory 混在 violations）；重新跑 novel_check 或按 0.2.3 迁移说明标记`
 			});
 		}
 		const hints = /* @__PURE__ */ new Map();
@@ -10943,7 +10943,7 @@ var EngineService = class {
 			severity: "warning",
 			title: "旧数据升级提示",
 			detail: `${legacy.length} 类旧数据需要解释或人工补齐：${legacy.slice(0, 3).map((issue) => `${issue.code}（${issue.detail}）`).join("；")}`,
-			hint: "这是只读审计，不会自动改历史；按 docs/0.2.3-plan.md WP0 处理，补 anchor/role 前先核对原文"
+			hint: "这是只读审计，不会自动改历史；按 0.2.3 的 WP0 处理，补 anchor/role 前先核对原文"
 		});
 		const locked = await store.exists(LOCK_FILE);
 		add({
@@ -11235,7 +11235,7 @@ var EngineService = class {
 						reason: "no_change 必填；created/updated 建议写",
 						role: "protagonist | supporting | antagonist | extra（可选）",
 						profile: "object（可选）",
-						current_state: "object（可选，如 {\"resources\":{\"港币\":-3}}）"
+						current_state: "object（可选，如 {\"resources\":{\"资源名\":-3}}）"
 					} },
 					foreshadows: { "<summary.planted.key 或 FS-xxx>": {
 						action: "created | updated | no_change",
@@ -11265,27 +11265,27 @@ var EngineService = class {
 				},
 				examples: [{
 					summary_excerpt: {
-						characters_appeared: ["陈嘉树"],
+						characters_appeared: ["角色甲"],
 						foreshadows: {
 							planted: [],
 							advanced: ["FS-001"],
 							resolved: []
 						}
 					},
-					characters: { 陈嘉树: {
+					characters: { 角色甲: {
 						action: "updated",
-						current_state: { resources: { 港币: -3 } }
+						current_state: { resources: { 资源名: -3 } }
 					} },
 					foreshadows: { "FS-001": {
 						action: "updated",
-						note: "欠条被收回",
+						note: "债务已结清",
 						new_info: true
 					} }
 				}, {
 					summary_excerpt: {
 						events: ["收到信"],
 						new_elements: {
-							locations: ["旧码头"],
+							locations: ["地点甲"],
 							abilities: [],
 							artifacts: []
 						}
@@ -11295,31 +11295,31 @@ var EngineService = class {
 						story_time: "Day 3 清晨",
 						description: "收到信"
 					} },
-					world: { 旧码头: {
+					world: { 地点甲: {
 						action: "created",
 						kind: "location",
-						description: "退潮时露出石阶"
+						description: "地点说明"
 					} }
 				}],
 				linked_example: {
 					summary: {
-						characters_appeared: ["陈嘉树"],
+						characters_appeared: ["角色甲"],
 						new_elements: {
-							locations: ["旧码头"],
+							locations: ["地点甲"],
 							abilities: [],
 							artifacts: []
 						},
 						events: ["收到信"]
 					},
 					delta: {
-						characters: { 陈嘉树: {
+						characters: { 角色甲: {
 							action: "no_change",
 							reason: "本章无变化"
 						} },
-						world: { 旧码头: {
+						world: { 地点甲: {
 							action: "created",
 							kind: "location",
-							description: "退潮时露出石阶"
+							description: "地点说明"
 						} },
 						timeline: { "0": {
 							action: "created",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-novel-write-engine",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Novel writing engine for DeepSeek Harness: state machine, gates, rulepacks and ledgers moved from prompts into code.",
   "keywords": [
     "dsh-plugin",