@qihuang02/world-book-mcp 0.0.4-beta.5 → 0.0.5

package/README.md

@@ -1,6 +1,6 @@
 # world-book-mcp
 
-`world-book-mcp` is an MCP server built with Node.js and TypeScript. It helps AI organize information from text or web-search summaries and export SillyTavern-compatible World Book JSON, basic `chara_card_v3` character card JSON, and optional MVU/ZOD, HTML beautification, and EJS dynamic content assets.
+`world-book-mcp` is an MCP server built with Node.js and TypeScript. It manages a `.worldbook/` drafting workspace and helps AI validate, patch, and export SillyTavern-compatible World Book JSON, basic `chara_card_v3` character card JSON, and optional MVU/ZOD, HTML beautification, and EJS dynamic content assets. Source reading, web search, and fact extraction are handled by the host AI in conversation; this server stores structured project state, draft entries, configurations, and exported JSON.
 
 ## Installation
 
@@ -48,25 +48,20 @@ args = ["-y", "@qihuang02/world-book-mcp"]
 
 The current version supports:
 
-- Ingesting text materials.
-- Ingesting web-search summaries.
+- Explicitly initializing a project, suitable for first-time use in an empty directory.
 - Creating information extraction outlines.
-- Submitting structured extraction results.
-- Automatically planning World Book entries.
-- Returning World Book entry templates.
-- Querying the usage guide for a single tool.
-- Explaining SillyTavern World Book configuration fields.
+- Submitting structured extraction results prepared by the host AI.
+- Creating explicit World Book entry plans from caller-provided card type, characters, world sections, items, scenes, and events.
 - Scanning forbidden terms and common writing issues.
-- Explicitly initializing a project, suitable for first-time use in an empty directory.
-- Saving, updating, and validating World Book drafts through simplified input: AI only needs to submit core fields such as `comment`, `keys`, and `content`; MCP automatically completes the full structure.
+- Creating `.worldbook/draft/*.json` slice templates first, then updating them field by field, confirming completeness, and merging them into exported JSON.
 - Exporting standalone SillyTavern World Book JSON.
-- Importing existing World Book JSON and applying safe patches.
+- Importing existing World Book JSON by slicing it into `.worldbook/draft/*.json`, then applying safe patches / merged exports.
 - Generating basic character card JSON that can embed the project World Book draft; when exporting a character card, the basic settings and personality settings of the same character are merged into the same embedded World Book entry.
 - MVU/ZOD configuration templates, validation, and asset building, with automatic merging into character card JSON.
 - HTML beautification configuration templates, validation, and asset building, with automatic merging into character card JSON.
 - EJS dynamic content configuration templates, validation, and entry building, with automatic merging into the embedded World Book of a character card.
 - Querying exported World Book JSON and character card JSON.
-- Importing existing character card JSON and applying patches to profile fields or embedded World Book entries.
+- Importing existing character card JSON, slicing the embedded World Book into draft entries, and applying patches to profile fields or embedded World Book entries.
 
 Not supported yet:
 - Built-in web search.
@@ -86,7 +81,7 @@ The primary role of `init_project` is to create or reuse the single MCP workspac
 └─ <exported world book or character card>.json
 ```
 
-`upsert_worldbook_entry` / `upsert_worldbook_entries` write each draft entry to `.worldbook/draft/<safe-comment>.json`. Split files store MCP draft entries, not final SillyTavern entries:
+`create_worldbook_draft_entry` / `create_worldbook_draft_entries` first create slice templates at `.worldbook/draft/<safe-comment>.json`; then `update_worldbook_draft_field` / `update_worldbook_draft_fields` fill them field by field. Split files store MCP draft entries, not final SillyTavern entries:
 
 ```json
 {
@@ -104,7 +99,7 @@ The primary role of `init_project` is to create or reuse the single MCP workspac
 }
 ```
 
-Validation, review, lint, World Book export, and character card export preferentially merge `.worldbook/draft/*.json`; if no split draft exists, they fall back to legacy `project.draft`. By default, exports are written to `<name>.json` in the current working directory. Relative and absolute output paths must stay inside the current working directory; out-of-bound writes are rejected.
+Validation, review, lint, World Book export, and character card export merge `.worldbook/draft/*.json`; split draft files are the draft source of truth. `.worldbook/draft/` is the long-lived workspace: `generate_worldbook_json` / `generate_character_card_json` do not clear drafts after export, and `apply_worldbook_patch` / `apply_character_card_patch` retain the updated split draft entries after merging into exported JSON. By default, exports are written to `<name>.json` in the current working directory. Relative and absolute output paths must stay inside the current working directory; out-of-bound writes are rejected.
 
 `init_project` also scans one level of `*.json` files in the current working directory. If no SillyTavern World Book or `chara_card_v3` JSON exists, it safely creates a root template JSON. If a Tavern-format JSON already exists, it does not create another template and never overwrites existing JSON files. The returned `root_template` field reports whether a template was created, its path, or the existing files that caused creation to be skipped. `kind=worldbook` creates a standalone World Book template; `kind=character_card` and `kind=mixed` create a `chara_card_v3` template, with `mixed` explicitly meaning a character card plus an empty embedded World Book.
 
@@ -112,29 +107,29 @@ Validation, review, lint, World Book export, and character card export preferent
 
 Writes for the same `project_id` are serialized inside the MCP process and return an incremented `revision`. Tools that accept `expected_revision` can use it for concurrency control: if a caller writes based on a stale revision, the tool returns a `project revision conflict` error.
 
-`apply_worldbook_patch` / `apply_character_card_patch` write the exported JSON file and update project state together. The implementation writes a temp file, replaces the target file, then updates the project; if the project update fails, it best-effort restores the previous exported file or removes the newly written target. When a patch returns `ok=false` or throws a revision conflict, reload the project before retrying.
+`apply_worldbook_patch` / `apply_character_card_patch` use the current project draft as input, write the exported JSON file, and update project state together; on success, the updated `.worldbook/draft/*.json` files are retained. The implementation writes a temp file, replaces the target file, then updates the project; if the project update fails, it best-effort restores the previous exported file or removes the newly written target. When a patch returns `ok=false` or throws a revision conflict, reload the project before retrying.
 
-Patch `match.uid` first matches the `sourceUid` preserved from an imported World Book, so it targets the original SillyTavern entry uid. For newly created drafts or legacy projects without `sourceUid`, prefer `index` or a unique `comment` to avoid confusing uid with the regenerated contiguous export index.
+Patch `match.uid` first matches the `sourceUid` preserved from an imported World Book, so it targets the original SillyTavern entry uid. For newly created drafts without `sourceUid`, prefer `index` or a unique `comment` to avoid confusing uid with the regenerated contiguous export index.
 
 ## Tools Overview
 
-Task routing, workflow choice, and clarification strategy are handled by the bundled `skill/world-book-mcp/` documentation rather than MCP tools.
+Task routing, workflow choice, and clarification strategy are handled by the bundled `skill/world-book-mcp-skill/` documentation rather than MCP tools.
 
 | Category | Tool | Description |
 | --- | --- | --- |
 | Workflow, Projects, and Specs | `init_project` | Initializes `.worldbook/project.json` and `.worldbook/draft/`; safely creates a root template JSON when no Tavern-format JSON exists; existing projects can be reused or overwritten with `if_exists`. |
 | Workflow, Projects, and Specs | `list_projects` | Returns the current `.worldbook/project.json` workspace project, or an empty list if no workspace exists. |
 | Workflow, Projects, and Specs | `get_project` | Views project details or a summary. |
-| Workflow, Projects, and Specs | `get_entry_template` | Returns a World Book entry template. |
-| Workflow, Projects, and Specs | `explain_worldbook_config` | Explains configuration fields such as position, constant, order, keys, and recursion. |
 | Workflow, Projects, and Specs | `lint_worldbook_content` | Scans forbidden terms and common writing issues. |
-| Material Input | `ingest_text_source` | Ingests novel excerpts, settings, user notes, and other text. |
-| Material Input | `ingest_web_research` | Ingests web-search summaries organized by AI. |
 | Extraction | `create_extraction_outline` | Creates an extraction template for characters, worldbuilding, items, and events. |
 | Extraction | `submit_extraction_result` | Submits structured facts extracted by the main AI. |
-| World Book Building | `plan_worldbook_entries` | Plans an entry table from extraction results. |
-| World Book Building | `upsert_worldbook_entry` | Adds or updates a single entry through simplified input; MCP automatically completes the full configuration. |
-| World Book Building | `upsert_worldbook_entries` | Adds or updates multiple entries through simplified input. |
+| World Book Building | `create_worldbook_entry_plan` | Creates an explicit entry plan from caller-provided card type, characters, world sections, items, scenes, and events. |
+| World Book Building | `validate_worldbook_entry_plan` | Validates an explicit entry plan's position, order, and keyword-trigger rules. |
+| World Book Building | `create_worldbook_draft_entry` | Creates one `.worldbook/draft/*.json` slice template. |
+| World Book Building | `create_worldbook_draft_entries` | Creates multiple slice templates. |
+| World Book Building | `update_worldbook_draft_field` | Locates a draft by comment and updates one field. |
+| World Book Building | `update_worldbook_draft_fields` | Updates a small set of draft fields at once. |
+| World Book Building | `confirm_worldbook_draft_complete` | Confirms all drafts are complete and ready to merge/export. |
 | World Book Building | `list_worldbook_draft_entries` | Lists `.worldbook/draft/*.json` split draft entries. |
 | World Book Building | `get_worldbook_draft_entry` | Reads one split draft entry by comment. |
 | World Book Building | `delete_worldbook_draft_entry` | Deletes one split draft entry by comment. |
@@ -143,6 +138,7 @@ Task routing, workflow choice, and clarification strategy are handled by the bun
 | Character Card | `import_character_card_json` | Imports an existing `chara_card_v3` JSON in the current directory and extracts profile plus embedded World Book draft. |
 | Character Card | `upsert_character_profile` | Creates or updates character card profile configuration through simplified fields; MCP automatically fills default `chara_card_v3` fields. |
 | Character Card | `validate_character_card_config` | Validates character card configuration and the embedded World Book. |
+| Character Card | `confirm_character_card_draft_complete` | Confirms character-card profile, embedded World Book drafts, and assets are ready to merge/export. |
 | Character Card | `generate_character_card_json` | Exports `chara_card_v3` character card JSON; `character_basic` and `character_personality` for the same character are merged into the same embedded World Book entry. |
 | Character Card | `create_character_card_patch` | Creates a patch plan for profile, worldbook config, or embedded World Book entries. |
 | Character Card | `preview_character_card_patch` | Previews character card patch diffs and validation. |
@@ -172,7 +168,7 @@ Task routing, workflow choice, and clarification strategy are handled by the bun
 
 ## Skill
 
-This repository includes a standard Claude Code Skill at [`skill/world-book-mcp/`](skill/world-book-mcp/). It is a directory package containing `SKILL.md` and `references/`, used to guide AI in correctly orchestrating all tools of this MCP server when users request World Book or character card related tasks.
+This repository includes a standard Claude Code Skill named `world-book-mcp-skill` at [`skill/world-book-mcp-skill/`](skill/world-book-mcp-skill/). It is a directory package containing `SKILL.md` and `references/`, used to guide AI in correctly orchestrating all tools of this MCP server when users request World Book or character card related tasks. The skill name is intentionally distinct from the MCP server name `world-book-mcp` to avoid confusion in agent tooling.
 
 ## Future Capability Extensions
 

package/README_ZH.md

@@ -1,6 +1,6 @@
 # world-book-mcp
 
-`world-book-mcp` 是一个使用 Node.js + TypeScript 编写的 MCP 服务器，用于辅助 AI 从文本或网页搜索摘要中整理信息，并导出符合 SillyTavern 格式的世界书 JSON、基础 `chara_card_v3` 角色卡 JSON，以及可选 MVU/ZOD、HTML 美化和 EJS 动态内容资产。
+`world-book-mcp` 是一个使用 Node.js + TypeScript 编写的 MCP 服务器，用于管理 `.worldbook/` 草稿工作区，并辅助 AI 校验、patch 和导出符合 SillyTavern 格式的世界书 JSON、基础 `chara_card_v3` 角色卡 JSON，以及可选 MVU/ZOD、HTML 美化和 EJS 动态内容资产。原文阅读、网页搜索和事实提取由宿主 AI 在对话中完成；本服务器只保存结构化 project 状态、draft 条目、配置和导出 JSON。
 
 ## 安装
 
@@ -48,25 +48,20 @@ args = ["-y", "@qihuang02/world-book-mcp"]
 
 当前版本支持：
 
-- 接收文本素材。
-- 接收网页搜索摘要。
+- 显式初始化 project，适合空白目录首次使用。
 - 创建信息提取 outline。
-- 提交结构化提取结果。
-- 自动规划世界书条目。
-- 返回世界书条目模板。
-- 查询单个 tool 的使用指南。
-- 解释 SillyTavern 世界书配置字段。
+- 提交由宿主 AI 整理好的结构化提取结果。
+- 根据调用方显式提供的卡型、角色、世界分区、物品、场景和事件创建世界书条目规划。
 - 扫描禁词与常见写作问题。
-- 显式初始化 project，适合空白目录首次使用。
-- 通过简化输入保存、更新、校验世界书草稿：AI 只需提交 `comment`、`keys`、`content` 等核心字段，MCP 自动补全完整结构。
+- 先创建 `.worldbook/draft/*.json` 切片模板，再逐字段更新、确认完整并合并导出，避免 AI 一次提交完整条目对象。
 - 导出独立 SillyTavern 世界书 JSON。
-- 导入已有世界书 JSON 并进行安全 patch。
+- 导入已有世界书 JSON，先切片为 `.worldbook/draft/*.json`，再进行安全 patch / 合并导出。
 - 基础角色卡 JSON 生成，可嵌入项目世界书 draft；导出角色卡时同一角色的基础设定和性格设定会聚合为同一个内嵌世界书条目。
 - MVU/ZOD 配置模板、校验、资产构建，并可自动合并进角色卡 JSON。
 - HTML 美化配置模板、校验、资产构建，并可自动合并进角色卡 JSON。
 - EJS 动态内容配置模板、校验、entries 构建，并可自动合并进角色卡内嵌世界书。
 - 查询导出的世界书 JSON 和角色卡 JSON。
-- 导入已有角色卡 JSON，并通过 patch 修改角色卡字段或内嵌世界书条目。
+- 导入已有角色卡 JSON，将内嵌世界书切片为 draft，并通过 patch 修改角色卡字段或内嵌世界书条目。
 
 暂不支持：
 - 内置网页搜索。
@@ -86,7 +81,7 @@ args = ["-y", "@qihuang02/world-book-mcp"]
 └─ <导出的世界书或角色卡>.json
 ```
 
-`upsert_worldbook_entry` / `upsert_worldbook_entries` 会把每条草稿写为 `.worldbook/draft/<safe-comment>.json`。分片文件保存的是 MCP draft entry，而不是最终 SillyTavern entry：
+`create_worldbook_draft_entry` / `create_worldbook_draft_entries` 会先把每个切片模板写为 `.worldbook/draft/<safe-comment>.json`；随后使用 `update_worldbook_draft_field` / `update_worldbook_draft_fields` 逐字段填充。分片文件保存的是 MCP draft entry，而不是最终 SillyTavern entry：
 
 ```json
 {
@@ -104,7 +99,7 @@ args = ["-y", "@qihuang02/world-book-mcp"]
 }
 ```
 
-校验、审查、lint、世界书导出和角色卡导出会优先合并读取 `.worldbook/draft/*.json`；若没有分片 draft，则兼容读取旧的 `project.draft`。默认导出路径是当前工作目录的 `<名称>.json`，相对路径和绝对路径都必须位于当前工作目录内，越界写入会失败。
+校验、审查、lint、世界书导出和角色卡导出会合并读取 `.worldbook/draft/*.json`；分片 draft 文件是草稿的唯一事实来源。`.worldbook/draft/` 是长期工作区：`generate_worldbook_json` / `generate_character_card_json` 导出后不会清空草稿，`apply_worldbook_patch` / `apply_character_card_patch` 合并导出后也会保留更新后的分片草稿，供下次继续修改。默认导出路径是当前工作目录的 `<名称>.json`，相对路径和绝对路径都必须位于当前工作目录内，越界写入会失败。
 
 此外，`init_project` 会扫描当前工作目录根目录的一层 `*.json`：如果没有发现酒馆格式世界书或 `chara_card_v3` 角色卡 JSON，会自动创建一个根目录模板 JSON；如果已经存在酒馆格式 JSON，则不会额外创建模板，也不会覆盖已有 JSON。返回值中的 `root_template` 会说明模板是否创建、路径或已有文件列表。`kind=worldbook` 会创建独立世界书模板；`kind=character_card` 和 `kind=mixed` 会创建 `chara_card_v3` 模板，其中 `mixed` 明确表示角色卡 + 内嵌空世界书的一体化模板。
 
@@ -112,29 +107,29 @@ args = ["-y", "@qihuang02/world-book-mcp"]
 
 同一 `project_id` 的写入会在 MCP 进程内串行化，并在返回值中递增 `revision`。支持 `expected_revision` 的写入工具可用它做并发冲突检测：如果调用方基于旧 revision 写入，会返回 `project revision conflict`。
 
-`apply_worldbook_patch` / `apply_character_card_patch` 会同时写导出的 JSON 文件并更新 project 状态。实现会先写临时文件并替换目标文件，再更新 project；如果 project 更新失败，会尽力恢复旧导出文件或删除新写入文件。返回 `ok=false` 或抛出冲突错误时，调用方应重新读取 project 后再重试。
+`apply_worldbook_patch` / `apply_character_card_patch` 会以当前 project draft 为输入，同时写导出的 JSON 文件并更新 project 状态；成功后保留更新后的 `.worldbook/draft/*.json`。实现会先写临时文件并替换目标文件，再更新 project；如果 project 更新失败，会尽力恢复旧导出文件或删除新写入文件。返回 `ok=false` 或抛出冲突错误时，调用方应重新读取 project 后再重试。
 
-patch 的 `match.uid` 优先匹配从已导入世界书保留的 `sourceUid`，用于定位原始 SillyTavern 条目 uid。对新建草稿或没有 `sourceUid` 的旧项目，建议使用 `index` 或唯一 `comment` 定位，避免把 uid 误当作导出后的连续下标。
+patch 的 `match.uid` 优先匹配从已导入世界书保留的 `sourceUid`，用于定位原始 SillyTavern 条目 uid。对没有 `sourceUid` 的新建草稿，建议使用 `index` 或唯一 `comment` 定位，避免把 uid 误当作导出后的连续下标。
 
 ## Tools 一览
 
-任务分类、工作流选择和澄清策略由随包 `skill/world-book-mcp/` 文档指导，不再作为 MCP tools 暴露。
+任务分类、工作流选择和澄清策略由随包 `skill/world-book-mcp-skill/` 文档指导，不再作为 MCP tools 暴露。
 
 | 分类 | Tool | 说明 |
 | --- | --- | --- |
-| 工作流、项目与规范 | `get_entry_template` | 返回世界书条目模板。 |
 | 工作流、项目与规范 | `init_project` | 初始化 `.worldbook/project.json` 与 `.worldbook/draft/`；若根目录没有酒馆格式 JSON，会安全创建模板 JSON；已有项目可用 `if_exists` 控制复用或覆盖。 |
 | 工作流、项目与规范 | `list_projects` | 返回当前 `.worldbook/project.json` 工作区项目；未初始化时返回空列表。 |
 | 工作流、项目与规范 | `get_project` | 查看项目详情或摘要。 |
-| 工作流、项目与规范 | `explain_worldbook_config` | 解释 position、constant、order、keys、递归等配置。 |
 | 工作流、项目与规范 | `lint_worldbook_content` | 扫描禁词和常见写作问题。 |
-| 素材输入 | `ingest_text_source` | 接收小说片段、设定、用户笔记等文本。 |
-| 素材输入 | `ingest_web_research` | 接收 AI 整理后的网页搜索摘要。 |
 | 提取 | `create_extraction_outline` | 创建角色、世界观、物品、事件的提取模板。 |
 | 提取 | `submit_extraction_result` | 提交主 AI 提取好的结构化事实。 |
-| 世界书构建 | `plan_worldbook_entries` | 根据提取结果规划条目表。 |
-| 世界书构建 | `upsert_worldbook_entry` | 用简化输入新增/更新单个条目，MCP 自动补全完整配置。 |
-| 世界书构建 | `upsert_worldbook_entries` | 用简化输入批量新增/更新多个条目。 |
+| 世界书构建 | `create_worldbook_entry_plan` | 根据调用方显式提供的卡型、角色、世界分区、物品、场景和事件创建条目规划。 |
+| 世界书构建 | `validate_worldbook_entry_plan` | 校验显式条目规划的 position、order 和关键词触发规则。 |
+| 世界书构建 | `create_worldbook_draft_entry` | 创建单个 `.worldbook/draft/*.json` 切片模板。 |
+| 世界书构建 | `create_worldbook_draft_entries` | 批量创建切片模板。 |
+| 世界书构建 | `update_worldbook_draft_field` | 按 comment 定位并逐字段更新 draft。 |
+| 世界书构建 | `update_worldbook_draft_fields` | 一次更新少量 draft 字段。 |
+| 世界书构建 | `confirm_worldbook_draft_complete` | 确认所有 draft 完整且可合并导出。 |
 | 世界书构建 | `list_worldbook_draft_entries` | 列出 `.worldbook/draft/*.json` 分片草稿。 |
 | 世界书构建 | `get_worldbook_draft_entry` | 按 comment 读取单个分片草稿。 |
 | 世界书构建 | `delete_worldbook_draft_entry` | 按 comment 删除单个分片草稿。 |
@@ -143,6 +138,7 @@ patch 的 `match.uid` 优先匹配从已导入世界书保留的 `sourceUid`，
 | 角色卡 | `import_character_card_json` | 导入当前目录内已有 `chara_card_v3` 角色卡 JSON，提取 profile 与内嵌世界书 draft。 |
 | 角色卡 | `upsert_character_profile` | 用简化字段创建/更新角色卡人设配置，MCP 自动补齐 `chara_card_v3` 默认字段。 |
 | 角色卡 | `validate_character_card_config` | 校验角色卡配置和嵌入世界书。 |
+| 角色卡 | `confirm_character_card_draft_complete` | 确认角色卡 profile、内嵌世界书 draft 与资产可合并导出。 |
 | 角色卡 | `generate_character_card_json` | 导出 `chara_card_v3` 角色卡 JSON；同一角色的 `character_basic` 与 `character_personality` 会合并为同一个内嵌世界书条目。 |
 | 角色卡 | `create_character_card_patch` | 为已有角色卡 project 创建 profile / worldbook config / 内嵌世界书修改计划。 |
 | 角色卡 | `preview_character_card_patch` | 预览角色卡 patch diff 与校验结果。 |
@@ -172,7 +168,7 @@ patch 的 `match.uid` 优先匹配从已导入世界书保留的 `sourceUid`，
 
 ## Skill
 
-仓库自带一个标准 Claude Code Skill，位于 [`skill/world-book-mcp/`](skill/world-book-mcp/)。它是一个 `SKILL.md` + `references/` 的目录包，用于指导 AI 在用户提出世界书 / 角色卡相关需求时，正确编排本 MCP 服务器的全部工具。
+仓库自带一个名为 `world-book-mcp-skill` 的标准 Claude Code Skill，位于 [`skill/world-book-mcp-skill/`](skill/world-book-mcp-skill/)。它是一个 `SKILL.md` + `references/` 的目录包，用于指导 AI 在用户提出世界书 / 角色卡相关需求时，正确编排本 MCP 服务器的全部工具。skill 名称刻意区别于 MCP server 名称 `world-book-mcp`，避免在 Agent 工具中混淆。
 
 ## 未来能力扩展
 

package/dist/core/delivery-checklist.js

@@ -11,10 +11,10 @@ export function createDeliveryChecklist(input) {
     }
     // 世界书 draft
     if (!input.project.draft || input.project.draft.length === 0) {
-        items.push({ section: "worldbook_draft", status: input.export_target === "worldbook" ? "blocking" : "warning", message: "项目尚未保存世界书 draft", related_tools: ["upsert_worldbook_entry", "upsert_worldbook_entries"] });
+        items.push({ section: "worldbook_draft", status: input.export_target === "worldbook" ? "blocking" : "warning", message: "项目尚未保存世界书 draft", related_tools: ["create_worldbook_draft_entry", "create_worldbook_draft_entries"] });
     }
     else {
-        items.push({ section: "worldbook_draft", status: review.sections.worldbook?.ok ? "ok" : "blocking", message: review.sections.worldbook?.ok ? "世界书 draft 校验通过" : "世界书 draft 存在阻塞性错误", related_tools: ["validate_worldbook_draft", "list_worldbook_draft_entries", "upsert_worldbook_entry"] });
+        items.push({ section: "worldbook_draft", status: review.sections.worldbook?.ok ? "ok" : "blocking", message: review.sections.worldbook?.ok ? "世界书 draft 校验通过" : "世界书 draft 存在阻塞性错误", related_tools: ["confirm_worldbook_draft_complete", "validate_worldbook_draft", "list_worldbook_draft_entries", "update_worldbook_draft_field"] });
     }
     // 角色卡
     if (input.export_target === "character_card") {

package/dist/core/delivery-checklist.js.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-checklist.js","sourceRoot":"","sources":["../../src/core/delivery-checklist.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"delivery-checklist.js","sourceRoot":"","sources":["../../src/core/delivery-checklist.ts"],"names":[],"mappings":"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"}

package/dist/core/worldbook-draft-editor.d.ts

@@ -0,0 +1,24 @@
+import { type CreateWorldbookDraftTemplateInput, type WorldbookDraftEntry, type WorldbookDraftField } from "../schemas/worldbook-draft.js";
+import { validateWorldbookDraft } from "./worldbook-validator.js";
+export interface DraftCompletenessIssue {
+    comment?: string;
+    field: string;
+    message: string;
+}
+export interface DraftNextAction {
+    tool: "create_worldbook_draft_entry" | "update_worldbook_draft_field";
+    comment?: string;
+    field?: WorldbookDraftField;
+}
+export interface WorldbookDraftCompletenessResult {
+    ok: boolean;
+    ready_to_merge: boolean;
+    entry_count: number;
+    missing_fields: DraftCompletenessIssue[];
+    next_actions: DraftNextAction[];
+    validation: ReturnType<typeof validateWorldbookDraft>;
+}
+export declare function createWorldbookDraftTemplate(input: CreateWorldbookDraftTemplateInput): WorldbookDraftEntry;
+export declare function updateWorldbookDraftField(entry: WorldbookDraftEntry, field: WorldbookDraftField, value: unknown): WorldbookDraftEntry;
+export declare function updateWorldbookDraftFields(entry: WorldbookDraftEntry, changes: Partial<Record<WorldbookDraftField, unknown>>): WorldbookDraftEntry;
+export declare function confirmWorldbookDraftComplete(entries: WorldbookDraftEntry[] | undefined): WorldbookDraftCompletenessResult;

package/dist/core/worldbook-draft-editor.js

@@ -0,0 +1,221 @@
+import { z } from "zod";
+import { EntryTypeSchema, PositionNameSchema } from "../schemas/worldbook-draft.js";
+import { validateWorldbookDraft } from "./worldbook-validator.js";
+const FieldValueSchemas = {
+    comment: z.string().min(1),
+    entry_type: EntryTypeSchema,
+    keys: z.array(z.string()),
+    secondary_keys: z.array(z.string()),
+    content: z.string(),
+    character_name: z.string().nullable(),
+    constant: z.boolean(),
+    position: PositionNameSchema,
+    order: z.number(),
+    enabled: z.boolean(),
+    depth: z.number().int().min(0).nullable(),
+    scan_depth: z.number().int().min(0).nullable(),
+};
+export function createWorldbookDraftTemplate(input) {
+    const comment = input.comment.trim();
+    const entryType = input.entryType ?? input.entry_type ?? "other";
+    const characterName = input.characterName ?? input.character_name;
+    const keySeed = characterName?.trim() || comment;
+    return {
+        comment,
+        entryType,
+        keys: uniqueStrings([keySeed]),
+        secondaryKeys: [],
+        content: "",
+        ...(characterName?.trim() ? { characterName: characterName.trim() } : {}),
+        constant: input.constant ?? true,
+        position: input.position ?? "before_char",
+        order: input.order ?? defaultOrderForEntryType(entryType),
+        enabled: input.enabled ?? true,
+        preventRecursion: true,
+        excludeRecursion: true,
+    };
+}
+export function updateWorldbookDraftField(entry, field, value) {
+    const next = cloneEntry(entry);
+    switch (field) {
+        case "comment": {
+            next.comment = FieldValueSchemas.comment.parse(value).trim();
+            break;
+        }
+        case "entry_type": {
+            next.entryType = FieldValueSchemas.entry_type.parse(value);
+            break;
+        }
+        case "keys": {
+            next.keys = uniqueStrings(FieldValueSchemas.keys.parse(value));
+            break;
+        }
+        case "secondary_keys": {
+            next.secondaryKeys = uniqueStrings(FieldValueSchemas.secondary_keys.parse(value));
+            break;
+        }
+        case "content": {
+            next.content = FieldValueSchemas.content.parse(value);
+            break;
+        }
+        case "character_name": {
+            const parsed = FieldValueSchemas.character_name.parse(value);
+            if (parsed === null || parsed.trim() === "")
+                delete next.characterName;
+            else
+                next.characterName = parsed.trim();
+            break;
+        }
+        case "constant": {
+            next.constant = FieldValueSchemas.constant.parse(value);
+            break;
+        }
+        case "position": {
+            next.position = FieldValueSchemas.position.parse(value);
+            break;
+        }
+        case "order": {
+            next.order = FieldValueSchemas.order.parse(value);
+            break;
+        }
+        case "enabled": {
+            next.enabled = FieldValueSchemas.enabled.parse(value);
+            break;
+        }
+        case "depth": {
+            const parsed = FieldValueSchemas.depth.parse(value);
+            if (parsed === null)
+                delete next.depth;
+            else
+                next.depth = parsed;
+            break;
+        }
+        case "scan_depth": {
+            const parsed = FieldValueSchemas.scan_depth.parse(value);
+            if (parsed === null)
+                delete next.scanDepth;
+            else
+                next.scanDepth = parsed;
+            break;
+        }
+    }
+    return next;
+}
+export function updateWorldbookDraftFields(entry, changes) {
+    let next = entry;
+    for (const field of Object.keys(changes)) {
+        next = updateWorldbookDraftField(next, field, changes[field]);
+    }
+    return next;
+}
+export function confirmWorldbookDraftComplete(entries) {
+    const draft = entries ?? [];
+    const missing = [];
+    const nextActions = [];
+    if (draft.length === 0) {
+        missing.push({ field: "draft", message: "尚未创建任何 .worldbook/draft/*.json 切片模板" });
+        nextActions.push({ tool: "create_worldbook_draft_entry" });
+    }
+    const seen = new Set();
+    for (const entry of draft) {
+        if (!entry.comment.trim()) {
+            missing.push({ comment: entry.comment, field: "comment", message: "comment 不能为空" });
+            nextActions.push({ tool: "update_worldbook_draft_field", comment: entry.comment, field: "comment" });
+        }
+        else if (seen.has(entry.comment)) {
+            missing.push({ comment: entry.comment, field: "comment", message: `comment 重复：${entry.comment}` });
+        }
+        seen.add(entry.comment);
+        if (!entry.content.trim()) {
+            missing.push({ comment: entry.comment, field: "content", message: "content 为空，不能合并导出" });
+            nextActions.push({ tool: "update_worldbook_draft_field", comment: entry.comment, field: "content" });
+        }
+        if (!entry.constant && entry.keys.length === 0) {
+            missing.push({ comment: entry.comment, field: "keys", message: "constant=false 的绿灯条目必须有 keys" });
+            nextActions.push({ tool: "update_worldbook_draft_field", comment: entry.comment, field: "keys" });
+        }
+        if ((entry.entryType === "character_basic" || entry.entryType === "character_personality") && !entry.characterName?.trim() && !inferCharacterNameFromComment(entry.comment)) {
+            missing.push({ comment: entry.comment, field: "character_name", message: "角色类条目建议填写 character_name，或使用“角色名-基础设定/性格”格式的 comment" });
+            nextActions.push({ tool: "update_worldbook_draft_field", comment: entry.comment, field: "character_name" });
+        }
+    }
+    const validation = validateWorldbookDraft(draft);
+    const missingKeys = new Set(missing.map(missingIssueKey));
+    for (const issue of [...validation.errors, ...validation.warnings].filter((issue) => issue.severity === "error")) {
+        const completenessIssue = { comment: issue.entry, field: issue.field ?? "validation", message: issue.message };
+        const key = missingIssueKey(completenessIssue);
+        if (missingKeys.has(key) || isCoveredByCompletenessChecks(completenessIssue))
+            continue;
+        missingKeys.add(key);
+        missing.push(completenessIssue);
+    }
+    const ready = missing.length === 0 && validation.valid;
+    return {
+        ok: ready,
+        ready_to_merge: ready,
+        entry_count: draft.length,
+        missing_fields: missing,
+        next_actions: dedupeNextActions(nextActions),
+        validation,
+    };
+}
+function defaultOrderForEntryType(entryType) {
+    switch (entryType) {
+        case "world_summary":
+            return 1;
+        case "background":
+            return 10;
+        case "character_overview":
+            return 20;
+        case "character_basic":
+            return 30;
+        case "character_personality":
+            return 31;
+        case "faction":
+            return 40;
+        case "item":
+        case "ability":
+            return 50;
+        case "scene":
+        case "event":
+            return 60;
+        case "npc":
+            return 70;
+        case "other":
+        default:
+            return 100;
+    }
+}
+function inferCharacterNameFromComment(comment) {
+    const match = comment.match(/^(.+?)[-_](基础设定|基础|性格设定|性格|人格)$/);
+    return match?.[1]?.trim() || undefined;
+}
+function cloneEntry(entry) {
+    return {
+        ...entry,
+        keys: [...entry.keys],
+        secondaryKeys: [...entry.secondaryKeys],
+    };
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
+}
+function dedupeNextActions(actions) {
+    const seen = new Set();
+    return actions.filter((action) => {
+        const key = `${action.tool}:${action.comment ?? ""}:${action.field ?? ""}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+function missingIssueKey(issue) {
+    return `${issue.comment ?? ""}:${issue.field}`;
+}
+function isCoveredByCompletenessChecks(issue) {
+    if (issue.field === "entries")
+        return true;
+    return ["comment", "content", "keys", "character_name"].includes(issue.field);
+}
+//# sourceMappingURL=worldbook-draft-editor.js.map

package/dist/core/worldbook-draft-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worldbook-draft-editor.js","sourceRoot":"","sources":["../../src/core/worldbook-draft-editor.ts"],"names":[],"mappings":"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"}

package/dist/core/worldbook-entry-factory.d.ts

@@ -18,11 +18,11 @@ export interface SimplifiedWorldbookEntryInput {
     characterName?: string;
 }
 export declare function normalizeWorldbookEntry(input: SimplifiedWorldbookEntryInput, existing?: WorldbookDraftEntry): WorldbookDraftEntry;
-export declare function upsertWorldbookDraftEntry(entries: WorldbookDraftEntry[] | undefined, input: SimplifiedWorldbookEntryInput, options?: {
+export declare function applyAddOrUpdateDraftEntry(entries: WorldbookDraftEntry[] | undefined, input: SimplifiedWorldbookEntryInput, options?: {
     matchByKeys?: boolean;
 }): {
     entries: WorldbookDraftEntry[];
-    created: boolean;
+    action: "created" | "updated";
     index: number;
     entry: WorldbookDraftEntry;
 };

package/dist/core/worldbook-entry-factory.js

@@ -25,17 +25,17 @@ export function normalizeWorldbookEntry(input, existing) {
         excludeRecursion: true,
     };
 }
-export function upsertWorldbookDraftEntry(entries, input, options = {}) {
+export function applyAddOrUpdateDraftEntry(entries, input, options = {}) {
     const current = entries ? [...entries] : [];
     const index = findEntryIndex(current, input, options);
     if (index >= 0) {
         const entry = normalizeWorldbookEntry(input, current[index]);
         current[index] = entry;
-        return { entries: current, created: false, index, entry };
+        return { entries: current, action: "updated", index, entry };
     }
     const entry = normalizeWorldbookEntry(input);
     current.push(entry);
-    return { entries: current, created: true, index: current.length - 1, entry };
+    return { entries: current, action: "created", index: current.length - 1, entry };
 }
 function findEntryIndex(entries, input, options) {
     const normalizedComment = input.comment.trim();

package/dist/core/worldbook-entry-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"worldbook-entry-factory.js","sourceRoot":"","sources":["../../src/core/worldbook-entry-factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worldbook-entry-factory.js","sourceRoot":"","sources":["../../src/core/worldbook-entry-factory.ts"],"names":[],"mappings":"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"}

package/dist/core/worldbook-patch.js

@@ -1,5 +1,5 @@
 import { createId, nowIso } from "../utils/ids.js";
-import { normalizeWorldbookEntry, upsertWorldbookDraftEntry } from "./worldbook-entry-factory.js";
+import { applyAddOrUpdateDraftEntry, normalizeWorldbookEntry } from "./worldbook-entry-factory.js";
 import { validateWorldbookDraft } from "./worldbook-validator.js";
 export function createPatch(input) {
     return {
@@ -22,8 +22,8 @@ export function applyPatchToDraft(entries, operations) {
                 break;
             }
             case "add_or_update_entry": {
-                const applied = upsertWorldbookDraftEntry(next, operation.entry, { matchByKeys: operation.match_by_keys });
-                const before = applied.created ? undefined : cloneEntry(next[applied.index]);
+                const applied = applyAddOrUpdateDraftEntry(next, operation.entry, { matchByKeys: operation.match_by_keys });
+                const before = applied.action === "created" ? undefined : cloneEntry(next[applied.index]);
                 next.splice(0, next.length, ...applied.entries);
                 diff.push({ op: operation.op, target: targetLabel(applied.entry, applied.index), before, after: applied.entry });
                 break;