@qihuang02/world-book-mcp 0.0.3

package/dist/core/task-classifier.js

@@ -0,0 +1,107 @@
+const GUIDE_MAP = {
+    original_character_card: ["guide.md", "character-card-guide.md", "character-guide.md", "world-book-guide.md", "writing-optimization-guide.md"],
+    derivative_extraction: ["guide.md", "information-extraction-guide.md", "world-book-guide.md", "writing-optimization-guide.md"],
+    worldbuilding_only: ["guide.md", "world-building-guide.md", "world-book-guide.md", "writing-optimization-guide.md"],
+    item_ability_equipment: ["guide.md", "world-book-guide.md", "config-guide.md", "writing-optimization-guide.md"],
+    style_extraction: ["guide.md", "information-extraction-guide.md", "writing-optimization-guide.md"],
+    chapter_extraction: ["guide.md", "information-extraction-guide.md", "world-book-guide.md"],
+    modify_existing: ["guide.md", "world-book-guide.md", "config-guide.md"],
+    query_existing: ["guide.md", "world-book-guide.md"],
+    mvu_zod: ["guide.md", "mvu-guide.md", "character-card-guide.md"],
+    ejs_dynamic: ["guide.md", "ejs-guide.md", "mvu-guide.md"],
+    html_beautify: ["guide.md", "html-beautify-guide.md", "character-card-guide.md"],
+    content_lint: ["guide.md", "writing-optimization-guide.md"],
+};
+export function classifyWorldbookTask(input) {
+    const request = input.request.toLowerCase();
+    const task_type = detectTaskType(input.request, request, input);
+    const required_workflow = workflowFor(task_type, request);
+    return {
+        task_type,
+        original_or_derivative: originFor(task_type, request),
+        required_workflow,
+        required_guides: GUIDE_MAP[task_type],
+        notes: notesFor(task_type, input),
+    };
+}
+function detectTaskType(raw, request, input) {
+    if (input.wants_ejs || /\bejs\b|动态条目|阶段条目|getwi|getvar/.test(request))
+        return "ejs_dynamic";
+    if (input.wants_html || /html|美化|状态栏|前端|css|正则脚本/.test(request))
+        return "html_beautify";
+    if (input.wants_mvu || /\bmvu\b|zod|变量|状态变量|initvar|状态栏占位符/.test(request))
+        return "mvu_zod";
+    if (/禁词|润色|优化|扫描|自查|lint|违禁词/.test(request))
+        return "content_lint";
+    if (/修改|更新|patch|补丁|删除条目|添加条目|已有世界书|导入世界书/.test(request))
+        return "modify_existing";
+    if (/查询|查看|搜索|统计|brief|uid/.test(request))
+        return "query_existing";
+    if (/文风|风格提取|行文|叙事风格/.test(request))
+        return "style_extraction";
+    if (/章节|章回|剧情提取|故事提取|剧情总结/.test(request))
+        return "chapter_extraction";
+    if (/物品|道具|装备|服装|衣服|能力|技能|法术|武器/.test(request))
+        return "item_ability_equipment";
+    if (/世界观|世界设定|世界书|势力|地理|历史|社会结构/.test(request) && /原创|设计|创建|生成|设定/.test(request))
+        return "worldbuilding_only";
+    if (/二创|原作|同人|提取|根据.*(?:文本|资料|网页|小说|作品)|从.*(?:文本|资料|网页|小说|作品)/.test(raw))
+        return "derivative_extraction";
+    return input.wants_character_card || /角色卡|character card|开场白|first_mes|alternate/.test(request) ? "original_character_card" : "worldbuilding_only";
+}
+function workflowFor(taskType, request) {
+    switch (taskType) {
+        case "derivative_extraction":
+            return /网页|网址|web|搜索|research/.test(request) ? "from_web_research" : "from_text";
+        case "modify_existing":
+            return "modify_existing";
+        case "query_existing":
+            return "query_existing";
+        case "content_lint":
+            return "content_lint";
+        case "mvu_zod":
+            return "mvu_zod";
+        case "ejs_dynamic":
+            return "ejs_dynamic";
+        case "html_beautify":
+            return "html_beautify";
+        case "style_extraction":
+            return "style_extraction";
+        case "chapter_extraction":
+            return "chapter_extraction";
+        case "item_ability_equipment":
+            return "item_ability_equipment";
+        case "worldbuilding_only":
+            return "worldbuilding_only";
+        case "original_character_card":
+            return "original_character_card";
+    }
+}
+function originFor(taskType, request) {
+    if (["mvu_zod", "ejs_dynamic", "html_beautify", "content_lint"].includes(taskType))
+        return "technical";
+    if (["modify_existing", "query_existing"].includes(taskType))
+        return "existing_asset";
+    if (taskType === "derivative_extraction" || /二创|同人|原作|提取/.test(request))
+        return "derivative";
+    if (taskType === "style_extraction" || taskType === "chapter_extraction")
+        return "derivative";
+    if (taskType === "original_character_card" || taskType === "worldbuilding_only" || taskType === "item_ability_equipment")
+        return "original";
+    return "unknown";
+}
+function notesFor(taskType, input) {
+    const notes = [];
+    if (taskType === "ejs_dynamic")
+        notes.push("EJS 依赖 MVU，建议先完成 mvu_zod 工作流");
+    if (taskType === "html_beautify")
+        notes.push("HTML 美化通常需要角色卡承载 regex / 状态栏资产");
+    if (taskType === "original_character_card")
+        notes.push("角色设定应写入世界书条目，角色卡 description 建议留空");
+    if (taskType === "worldbuilding_only")
+        notes.push("先产出世界观总纲，再拆分为世界书条目");
+    if (input.wants_ejs && !input.wants_mvu)
+        notes.push("用户要求 EJS 但未声明 MVU：应补充 MVU 变量设计");
+    return notes;
+}
+//# sourceMappingURL=task-classifier.js.map

package/dist/core/task-classifier.js.map

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

package/dist/core/tool-usage-guide.d.ts

@@ -0,0 +1,13 @@
+export type ToolUsageGuide = {
+    tool: string;
+    purpose: string;
+    when_to_call: string;
+    required_fields: string[];
+    example_input: unknown;
+    common_mistakes: string[];
+    next_tools: string[];
+};
+export declare function getToolUsageGuide(tool: string): ToolUsageGuide | {
+    available_tools: string[];
+    message: string;
+};

package/dist/core/tool-usage-guide.js

@@ -0,0 +1,198 @@
+const GUIDES = {
+    get_worldbook_workflow: {
+        tool: "get_worldbook_workflow",
+        purpose: "根据用户任务类型返回推荐 MCP tool 调用流程。",
+        when_to_call: "用户刚提出写世界书、角色卡、查询或修改已有世界书需求时。",
+        required_fields: ["task_type"],
+        example_input: { task_type: "from_text", wants_character_card: true },
+        common_mistakes: ["跳过工作流直接生成 JSON", "角色卡需求未设置 wants_character_card=true"],
+        next_tools: ["ingest_text_source", "ingest_web_research", "submit_extraction_result"],
+    },
+    ingest_text_source: {
+        tool: "ingest_text_source",
+        purpose: "把用户提供的原始文本、设定、小说片段保存到 MCP project。",
+        when_to_call: "用户提供了文本材料时。",
+        required_fields: ["title", "content"],
+        example_input: { title: "角色设定", content: "...", source_type: "notes", tags: ["角色"] },
+        common_mistakes: ["把提取后的结构化事实传到这里", "content 为空"],
+        next_tools: ["create_extraction_outline"],
+    },
+    ingest_web_research: {
+        tool: "ingest_web_research",
+        purpose: "保存主 AI 搜索网页后整理出的摘要和 facts。MCP 本身不联网搜索。",
+        when_to_call: "主 AI 已完成网页搜索并整理摘要后。",
+        required_fields: ["topic", "items"],
+        example_input: { topic: "作品名", items: [{ title: "页面", url: "https://example.com", summary: "摘要", facts: ["事实"], reliability: "wiki" }] },
+        common_mistakes: ["传入未经整理的大段网页 HTML", "省略事实来源 URL"],
+        next_tools: ["create_extraction_outline"],
+    },
+    create_extraction_outline: {
+        tool: "create_extraction_outline",
+        purpose: "返回主 AI 应提取的角色、世界观、物品、事件字段模板。",
+        when_to_call: "原始文本或网页摘要已存入 project 后。",
+        required_fields: [],
+        example_input: { project_id: "project_xxx", focus: ["characters", "world", "items", "events"] },
+        common_mistakes: ["把 outline 当作最终提取结果", "让 MCP 代替主 AI 阅读和理解全文"],
+        next_tools: ["submit_extraction_result"],
+    },
+    submit_extraction_result: {
+        tool: "submit_extraction_result",
+        purpose: "提交主 AI 从原始材料中提取出的结构化事实。",
+        when_to_call: "主 AI 已根据 outline 完成事实提取后。",
+        required_fields: ["project_id", "title", "characters", "world", "items", "events"],
+        example_input: { project_id: "project_xxx", title: "项目", characters: [], world: [], items: [], events: [], sourceRefs: [] },
+        common_mistakes: ["把原始全文塞进 characters/world 字段", "脑补来源中没有的信息"],
+        next_tools: ["plan_worldbook_entries"],
+    },
+    plan_worldbook_entries: {
+        tool: "plan_worldbook_entries",
+        purpose: "根据 extraction result 生成世界书条目规划表。",
+        when_to_call: "结构化事实已提交后。",
+        required_fields: ["project_id"],
+        example_input: { project_id: "project_xxx" },
+        common_mistakes: ["未提交 extraction result 就调用", "把规划表当成可导出的世界书"],
+        next_tools: ["create_worldbook_draft_template"],
+    },
+    create_worldbook_draft_template: {
+        tool: "create_worldbook_draft_template",
+        purpose: "把条目规划表转换为可填写的 MCP draft JSON 模板。",
+        when_to_call: "plan_worldbook_entries 后。",
+        required_fields: ["project_id"],
+        example_input: { project_id: "project_xxx", save: true },
+        common_mistakes: ["直接导出模板而不填写 content", "误以为这是 SillyTavern 最终 JSON"],
+        next_tools: ["draft_worldbook_entries", "update_worldbook_draft_entries"],
+    },
+    draft_worldbook_entries: {
+        tool: "draft_worldbook_entries",
+        purpose: "保存主 AI 填好的世界书 draft entries，并立即校验。",
+        when_to_call: "主 AI 已填写 draft.content 后。",
+        required_fields: ["project_id", "entries"],
+        example_input: { project_id: "project_xxx", entries: [] },
+        common_mistakes: ["content 仍是空模板", "绿灯条目没有 keys"],
+        next_tools: ["validate_worldbook_draft", "generate_worldbook_json"],
+    },
+    generate_worldbook_json: {
+        tool: "generate_worldbook_json",
+        purpose: "把通过校验的 MCP draft 导出为独立 SillyTavern 世界书 JSON。",
+        when_to_call: "validate_worldbook_draft 通过后。",
+        required_fields: ["project_id", "worldbook_name"],
+        example_input: { project_id: "project_xxx", worldbook_name: "世界书", overwrite: false },
+        common_mistakes: ["校验未通过就导出", "output_path 越界"],
+        next_tools: ["query_worldbook", "create_character_card_template"],
+    },
+    create_character_card_template: {
+        tool: "create_character_card_template",
+        purpose: "创建基础 chara_card_v3 角色卡配置模板。",
+        when_to_call: "世界书 draft 完成并通过校验后，且用户需要角色卡。",
+        required_fields: ["name"],
+        example_input: { project_id: "project_xxx", name: "角色名", include_worldbook: true, greeting_count: 3 },
+        common_mistakes: ["未先完成世界书 draft", "把角色详细信息写进 description"],
+        next_tools: ["submit_character_card_config"],
+    },
+    submit_character_card_config: {
+        tool: "submit_character_card_config",
+        purpose: "保存主 AI 填好的角色卡配置。",
+        when_to_call: "主 AI 已填写 first_mes 和 alternate_greetings 后。",
+        required_fields: ["project_id", "config"],
+        example_input: { project_id: "project_xxx", config: { card: { name: "角色名", first_mes: "..." }, worldbook: { source: "project_draft" } } },
+        common_mistakes: ["first_mes 为空", "description 非空"],
+        next_tools: ["validate_character_card_config", "generate_character_card_json"],
+    },
+    generate_character_card_json: {
+        tool: "generate_character_card_json",
+        purpose: "导出基础 chara_card_v3 角色卡 JSON。如项目启用 MVU，会自动合并 MVU 资产。",
+        when_to_call: "角色卡配置、世界书 draft、MVU 配置均通过校验后。",
+        required_fields: ["project_id"],
+        example_input: { project_id: "project_xxx", overwrite: false },
+        common_mistakes: ["未保存 characterCardConfig", "世界书 draft 仍有错误", "启用 MVU 但 schema_script 无效"],
+        next_tools: ["query_character_card"],
+    },
+    create_mvu_schema_template: {
+        tool: "create_mvu_schema_template",
+        purpose: "创建 MVU/ZOD 变量系统配置模板。",
+        when_to_call: "用户需要动态变量、状态栏或后续 EJS 前。通常在角色卡生成前调用。",
+        required_fields: ["character_names"],
+        example_input: { project_id: "project_xxx", character_names: ["角色A"], variable_list_path: "stat_data" },
+        common_mistakes: ["角色名为空", "把完整 HTML 状态栏放进 MVU 配置"],
+        next_tools: ["submit_mvu_config"],
+    },
+    submit_mvu_config: {
+        tool: "submit_mvu_config",
+        purpose: "保存主 AI 填好的 MVU/ZOD 配置到 project。",
+        when_to_call: "主 AI 已调整 schema_script、initvar、update_rules 后。",
+        required_fields: ["project_id", "mvu"],
+        example_input: { project_id: "project_xxx", mvu: { enabled: true, style: "zod", schema_script: "...", initvar: "...", update_rules: "..." } },
+        common_mistakes: ["schema_script 缺少 registerMvuSchema", "initvar 手写 <initvar> 包裹", "混用 MVU beta 风格"],
+        next_tools: ["validate_mvu_config", "build_mvu_assets"],
+    },
+    build_mvu_assets: {
+        tool: "build_mvu_assets",
+        purpose: "把 MVU 配置构建为世界书条目、regex_scripts 和 tavern_helper scripts。",
+        when_to_call: "想在生成角色卡前预览 MVU 资产时。generate_character_card_json 会自动合并这些资产。",
+        required_fields: ["project_id"],
+        example_input: { project_id: "project_xxx" },
+        common_mistakes: ["配置未通过 validate_mvu_config 就构建", "误以为 build_mvu_assets 会直接写角色卡文件"],
+        next_tools: ["generate_character_card_json"],
+    },
+    create_html_beautify_template: {
+        tool: "create_html_beautify_template",
+        purpose: "创建 HTML 美化配置模板，支持状态栏和全局正则美化。",
+        when_to_call: "用户需要状态栏、全局界面美化或更好的变量展示时。",
+        required_fields: [],
+        example_input: { project_id: "project_xxx", target: "statusbar", theme: "minimal" },
+        common_mistakes: ["未启用角色卡生成", "状态栏 HTML 使用全局 CSS 或 script"],
+        next_tools: ["submit_html_beautify_config"],
+    },
+    submit_html_beautify_config: {
+        tool: "submit_html_beautify_config",
+        purpose: "保存 HTML 美化配置到 project。",
+        when_to_call: "主 AI 已调整状态栏 HTML 或全局 regex 后。",
+        required_fields: ["project_id", "html"],
+        example_input: { project_id: "project_xxx", html: { enabled: true, target: "statusbar", theme: "minimal" } },
+        common_mistakes: ["statusbar target 下 html 为空", "全局 regex 缺少 findRegex"],
+        next_tools: ["validate_html_beautify_config", "build_html_beautify_assets"],
+    },
+    build_html_beautify_assets: {
+        tool: "build_html_beautify_assets",
+        purpose: "把 HTML 美化配置构建为角色卡 regex_scripts。",
+        when_to_call: "想在生成角色卡前预览 HTML 美化资产时。generate_character_card_json 会自动合并这些资产。",
+        required_fields: ["project_id"],
+        example_input: { project_id: "project_xxx" },
+        common_mistakes: ["配置未通过 validate_html_beautify_config 就构建", "误以为 build 会直接写角色卡文件"],
+        next_tools: ["generate_character_card_json"],
+    },
+    create_ejs_template: {
+        tool: "create_ejs_template",
+        purpose: "创建 EJS 动态内容配置模板，支持阶段人设、调色盘和自定义条目。",
+        when_to_call: "用户需要根据 MVU 变量动态切换世界书内容时。",
+        required_fields: ["character_name"],
+        example_input: { project_id: "project_xxx", template_type: "phase_profile", character_name: "角色A" },
+        common_mistakes: ["未先启用 MVU", "变量路径未以 stat_data 开头", "阶段条目没有设为 disabled"],
+        next_tools: ["submit_ejs_config"],
+    },
+    submit_ejs_config: {
+        tool: "submit_ejs_config",
+        purpose: "保存 EJS 动态内容配置到 project。",
+        when_to_call: "主 AI 已调整 EJS 控制器和阶段条目内容后。",
+        required_fields: ["project_id", "ejs"],
+        example_input: { project_id: "project_xxx", ejs: { enabled: true, template_type: "phase_profile", variable_paths: ["stat_data.角色A.好感度"], entries: [] } },
+        common_mistakes: ["EJS 标签未闭合", "getwi 未使用 await", "使用 const/let 读取 getvar"],
+        next_tools: ["validate_ejs_config", "build_ejs_entries"],
+    },
+    build_ejs_entries: {
+        tool: "build_ejs_entries",
+        purpose: "把 EJS 配置构建为将合并进角色卡内嵌世界书的 entries。",
+        when_to_call: "想在生成角色卡前预览 EJS 世界书条目时。generate_character_card_json 会自动合并这些条目。",
+        required_fields: ["project_id"],
+        example_input: { project_id: "project_xxx" },
+        common_mistakes: ["未通过 validate_ejs_config 就构建", "误以为 build 会直接写角色卡文件"],
+        next_tools: ["generate_character_card_json"],
+    },
+};
+export function getToolUsageGuide(tool) {
+    return GUIDES[tool] ?? {
+        message: `未找到 ${tool} 的专门指南，可先调用 get_worldbook_workflow 获取总体流程。`,
+        available_tools: Object.keys(GUIDES).sort(),
+    };
+}
+//# sourceMappingURL=tool-usage-guide.js.map

package/dist/core/tool-usage-guide.js.map

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

package/dist/core/workflow.d.ts

@@ -0,0 +1,12 @@
+export type WorkflowTaskType = "from_text" | "from_web_research" | "original_world" | "original_character_card" | "derivative_extraction" | "worldbuilding_only" | "item_ability_equipment" | "style_extraction" | "chapter_extraction" | "modify_existing" | "query_existing" | "mvu_zod" | "ejs_dynamic" | "html_beautify" | "content_lint";
+export interface WorkflowInput {
+    task_type: WorkflowTaskType;
+    wants_character_card?: boolean;
+    wants_mvu?: boolean;
+    wants_html?: boolean;
+    wants_ejs?: boolean;
+}
+export declare function getWorkflow(input: WorkflowInput): {
+    workflow: string[];
+    notes: string[];
+};

package/dist/core/workflow.js

@@ -0,0 +1,129 @@
+export function getWorkflow(input) {
+    const commonNotes = [
+        "生成 JSON 前必须调用 validate_worldbook_draft",
+        "网页搜索由宿主 AI 完成，MCP 只接收搜索摘要",
+    ];
+    if (input.wants_html && !input.wants_character_card) {
+        commonNotes.push("HTML 美化资产需要通过角色卡 JSON 承载，建议同时设置 wants_character_card=true");
+    }
+    if (input.wants_mvu && !input.wants_character_card) {
+        commonNotes.push("MVU/ZOD 资产需要通过角色卡 JSON 承载，建议同时设置 wants_character_card=true");
+    }
+    if (input.wants_ejs && !input.wants_character_card) {
+        commonNotes.push("EJS entries 需要通过角色卡 JSON 承载，建议同时设置 wants_character_card=true");
+    }
+    if (input.wants_ejs && !input.wants_mvu) {
+        commonNotes.push("EJS 依赖 MVU 变量，建议同时设置 wants_mvu=true");
+    }
+    switch (input.task_type) {
+        case "from_text":
+        case "derivative_extraction":
+            return {
+                workflow: withCharacterCard(input, extractionWorkflow("ingest_text_source")),
+                notes: commonNotes,
+            };
+        case "from_web_research":
+            return {
+                workflow: withCharacterCard(input, extractionWorkflow("ingest_web_research")),
+                notes: commonNotes,
+            };
+        case "original_world":
+        case "worldbuilding_only":
+            return {
+                workflow: withCharacterCard(input, [
+                    "create_worldbuilding_outline",
+                    "submit_worldbuilding_summary",
+                    "validate_worldbuilding_summary",
+                    "submit_extraction_result",
+                    "plan_worldbook_entries",
+                    "create_worldbook_draft_template",
+                    "get_entry_template",
+                    "draft_worldbook_entries",
+                    "validate_worldbook_draft",
+                    "lint_project_content",
+                    "create_final_review_report",
+                    "generate_worldbook_json",
+                ]),
+                notes: ["原创设定建议先完成世界观总纲，再整理为 extraction result 后提交", ...commonNotes],
+            };
+        case "original_character_card":
+            return {
+                workflow: withCharacterCard({ ...input, wants_character_card: true }, [
+                    "create_worldbuilding_outline",
+                    "submit_worldbuilding_summary",
+                    "validate_worldbuilding_summary",
+                    "submit_extraction_result",
+                    "plan_worldbook_entries",
+                    "create_worldbook_draft_template",
+                    "get_entry_template",
+                    "draft_worldbook_entries",
+                    "validate_worldbook_draft",
+                    "lint_project_content",
+                    "create_final_review_report",
+                ]),
+                notes: ["角色卡 description 建议留空，角色信息写入世界书", ...commonNotes],
+            };
+        case "item_ability_equipment":
+            return {
+                workflow: withCharacterCard(input, ["get_entry_template", "draft_worldbook_entries", "validate_worldbook_draft", "lint_project_content", "create_final_review_report", "generate_worldbook_json"]),
+                notes: ["物品/能力/装备条目应保持 XML 包裹 YAML，并按触发策略设置 keys", ...commonNotes],
+            };
+        case "style_extraction":
+            return {
+                workflow: ["ingest_text_source", "create_style_extraction_outline", "submit_extraction_result", "lint_project_content"],
+                notes: ["文风提取以写作规则和负面约束为主，不应照搬大段原文", ...commonNotes],
+            };
+        case "chapter_extraction":
+            return {
+                workflow: ["ingest_text_source", "create_chapter_extraction_outline", "submit_extraction_result", "plan_worldbook_entries", "draft_worldbook_entries", "validate_worldbook_draft"],
+                notes: ["章节提取应保留事件因果和角色状态变化，避免流水账", ...commonNotes],
+            };
+        case "modify_existing":
+            return {
+                workflow: ["import_worldbook_json", "query_worldbook", "create_worldbook_patch", "preview_worldbook_patch", "apply_worldbook_patch"],
+                notes: ["修改已有世界书建议先导入并预览 patch，校验通过后再应用", ...commonNotes],
+            };
+        case "query_existing":
+            return { workflow: ["query_worldbook"], notes: commonNotes };
+        case "mvu_zod":
+            return { workflow: ["create_mvu_schema_template", "submit_mvu_config", "validate_mvu_config", "build_mvu_assets", "create_final_review_report"], notes: commonNotes };
+        case "ejs_dynamic":
+            return { workflow: ["create_mvu_schema_template", "submit_mvu_config", "validate_mvu_config", "create_ejs_template", "submit_ejs_config", "validate_ejs_config", "build_ejs_entries", "create_final_review_report"], notes: ["EJS 依赖 MVU 变量", ...commonNotes] };
+        case "html_beautify":
+            return { workflow: ["create_html_beautify_template", "submit_html_beautify_config", "validate_html_beautify_config", "build_html_beautify_assets", "create_final_review_report"], notes: commonNotes };
+        case "content_lint":
+            return { workflow: ["lint_worldbook_content", "lint_project_content", "create_final_review_report"], notes: commonNotes };
+    }
+}
+function extractionWorkflow(sourceTool) {
+    return [
+        sourceTool,
+        "create_extraction_outline",
+        "submit_extraction_result",
+        "plan_worldbook_entries",
+        "create_worldbook_draft_template",
+        "get_entry_template",
+        "draft_worldbook_entries",
+        "validate_worldbook_draft",
+        "lint_project_content",
+        "create_final_review_report",
+        "generate_worldbook_json",
+        "query_worldbook",
+    ];
+}
+function withCharacterCard(input, workflow) {
+    if (!input.wants_character_card)
+        return workflow;
+    return [
+        ...workflow,
+        "create_character_card_template",
+        ...(input.wants_mvu ? ["create_mvu_schema_template", "submit_mvu_config", "validate_mvu_config", "build_mvu_assets"] : []),
+        ...(input.wants_html ? ["create_html_beautify_template", "submit_html_beautify_config", "validate_html_beautify_config", "build_html_beautify_assets"] : []),
+        ...(input.wants_ejs ? ["create_ejs_template", "submit_ejs_config", "validate_ejs_config", "build_ejs_entries"] : []),
+        "submit_character_card_config",
+        "validate_character_card_config",
+        "generate_character_card_json",
+        "query_character_card",
+    ];
+}
+//# sourceMappingURL=workflow.js.map

package/dist/core/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/core/workflow.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,MAAM,WAAW,GAAG;QAClB,wCAAwC;QACxC,2BAA2B;KAC5B,CAAC;IACF,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACpD,WAAW,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACnD,WAAW,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACnD,WAAW,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACxC,WAAW,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC1D,CAAC;IAED,QAAQ,KAAK,CAAC,SAAS,EAAE,CAAC;QACxB,KAAK,WAAW,CAAC;QACjB,KAAK,uBAAuB;YAC1B,OAAO;gBACL,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;gBAC5E,KAAK,EAAE,WAAW;aACnB,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO;gBACL,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;gBAC7E,KAAK,EAAE,WAAW;aACnB,CAAC;QACJ,KAAK,gBAAgB,CAAC;QACtB,KAAK,oBAAoB;YACvB,OAAO;gBACL,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE;oBACjC,8BAA8B;oBAC9B,8BAA8B;oBAC9B,gCAAgC;oBAChC,0BAA0B;oBAC1B,wBAAwB;oBACxB,iCAAiC;oBACjC,oBAAoB;oBACpB,yBAAyB;oBACzB,0BAA0B;oBAC1B,sBAAsB;oBACtB,4BAA4B;oBAC5B,yBAAyB;iBAC1B,CAAC;gBACF,KAAK,EAAE,CAAC,2CAA2C,EAAE,GAAG,WAAW,CAAC;aACrE,CAAC;QACJ,KAAK,yBAAyB;YAC5B,OAAO;gBACL,QAAQ,EAAE,iBAAiB,CAAC,EAAE,GAAG,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAE;oBACpE,8BAA8B;oBAC9B,8BAA8B;oBAC9B,gCAAgC;oBAChC,0BAA0B;oBAC1B,wBAAwB;oBACxB,iCAAiC;oBACjC,oBAAoB;oBACpB,yBAAyB;oBACzB,0BAA0B;oBAC1B,sBAAsB;oBACtB,4BAA4B;iBAC7B,CAAC;gBACF,KAAK,EAAE,CAAC,gCAAgC,EAAE,GAAG,WAAW,CAAC;aAC1D,CAAC;QACJ,KAAK,wBAAwB;YAC3B,OAAO;gBACL,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,CAAC,oBAAoB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,yBAAyB,CAAC,CAAC;gBAClM,KAAK,EAAE,CAAC,yCAAyC,EAAE,GAAG,WAAW,CAAC;aACnE,CAAC;QACJ,KAAK,kBAAkB;YACrB,OAAO;gBACL,QAAQ,EAAE,CAAC,oBAAoB,EAAE,iCAAiC,EAAE,0BAA0B,EAAE,sBAAsB,CAAC;gBACvH,KAAK,EAAE,CAAC,2BAA2B,EAAE,GAAG,WAAW,CAAC;aACrD,CAAC;QACJ,KAAK,oBAAoB;YACvB,OAAO;gBACL,QAAQ,EAAE,CAAC,oBAAoB,EAAE,mCAAmC,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,0BAA0B,CAAC;gBAClL,KAAK,EAAE,CAAC,0BAA0B,EAAE,GAAG,WAAW,CAAC;aACpD,CAAC;QACJ,KAAK,iBAAiB;YACpB,OAAO;gBACL,QAAQ,EAAE,CAAC,uBAAuB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,uBAAuB,CAAC;gBACpI,KAAK,EAAE,CAAC,gCAAgC,EAAE,GAAG,WAAW,CAAC;aAC1D,CAAC;QACJ,KAAK,gBAAgB;YACnB,OAAO,EAAE,QAAQ,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAC/D,KAAK,SAAS;YACZ,OAAO,EAAE,QAAQ,EAAE,CAAC,4BAA4B,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACxK,KAAK,aAAa;YAChB,OAAO,EAAE,QAAQ,EAAE,CAAC,4BAA4B,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,CAAC,eAAe,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC;QAClQ,KAAK,eAAe;YAClB,OAAO,EAAE,QAAQ,EAAE,CAAC,+BAA+B,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACzM,KAAK,cAAc;YACjB,OAAO,EAAE,QAAQ,EAAE,CAAC,wBAAwB,EAAE,sBAAsB,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAC9H,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAwD;IAClF,OAAO;QACL,UAAU;QACV,2BAA2B;QAC3B,0BAA0B;QAC1B,wBAAwB;QACxB,iCAAiC;QACjC,oBAAoB;QACpB,yBAAyB;QACzB,0BAA0B;QAC1B,sBAAsB;QACtB,4BAA4B;QAC5B,yBAAyB;QACzB,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAoB,EAAE,QAAkB;IACjE,IAAI,CAAC,KAAK,CAAC,oBAAoB;QAAE,OAAO,QAAQ,CAAC;IACjD,OAAO;QACL,GAAG,QAAQ;QACX,gCAAgC;QAChC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,4BAA4B,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1H,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,+BAA+B,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,4BAA4B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5J,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpH,8BAA8B;QAC9B,gCAAgC;QAChC,8BAA8B;QAC9B,sBAAsB;KACvB,CAAC;AACJ,CAAC"}

package/dist/core/worldbook-builder.d.ts

@@ -0,0 +1,6 @@
+import type { SillyTavernWorldbook } from "../schemas/sillytavern-worldbook.js";
+import type { WorldbookDraftEntry } from "../schemas/worldbook-draft.js";
+export declare function buildWorldbookJson(input: {
+    name: string;
+    entries: WorldbookDraftEntry[];
+}): SillyTavernWorldbook;

package/dist/core/worldbook-builder.js

@@ -0,0 +1,60 @@
+import { positionToNumber } from "./position-map.js";
+export function buildWorldbookJson(input) {
+    const sorted = [...input.entries].sort((a, b) => {
+        const positionDiff = positionToNumber(a.position) - positionToNumber(b.position);
+        return positionDiff || a.order - b.order || a.comment.localeCompare(b.comment, "zh-Hans-CN");
+    });
+    const entries = {};
+    sorted.forEach((draft, index) => {
+        entries[String(index)] = buildEntry(draft, index);
+    });
+    return { name: input.name, entries };
+}
+function buildEntry(draft, uid) {
+    return {
+        uid,
+        key: draft.keys,
+        keysecondary: draft.secondaryKeys ?? [],
+        comment: draft.comment,
+        content: draft.content,
+        constant: draft.constant,
+        vectorized: false,
+        selective: false,
+        selectiveLogic: 0,
+        addMemo: true,
+        order: draft.order,
+        position: positionToNumber(draft.position),
+        disable: !draft.enabled,
+        ignoreBudget: false,
+        excludeRecursion: true,
+        preventRecursion: true,
+        matchPersonaDescription: false,
+        matchCharacterDescription: false,
+        matchCharacterPersonality: false,
+        matchCharacterDepthPrompt: false,
+        matchScenario: false,
+        matchCreatorNotes: false,
+        delayUntilRecursion: false,
+        probability: 100,
+        useProbability: true,
+        depth: draft.position === "at_depth" ? draft.depth ?? 0 : draft.depth ?? 1,
+        outletName: "",
+        group: "",
+        groupOverride: false,
+        groupWeight: 100,
+        scanDepth: draft.scanDepth ?? (!draft.constant ? 2 : null),
+        caseSensitive: null,
+        matchWholeWords: null,
+        useGroupScoring: false,
+        automationId: "",
+        role: draft.position === "at_depth" ? 0 : 0,
+        sticky: 0,
+        cooldown: 0,
+        delay: 0,
+        triggers: [],
+        displayIndex: uid,
+        extensions: {},
+        characterFilter: { isExclude: false, names: [], tags: [] },
+    };
+}
+//# sourceMappingURL=worldbook-builder.js.map

package/dist/core/worldbook-builder.js.map

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

package/dist/core/worldbook-importer.d.ts

@@ -0,0 +1,7 @@
+import { type SillyTavernWorldbook } from "../schemas/sillytavern-worldbook.js";
+import type { WorldbookDraftEntry } from "../schemas/worldbook-draft.js";
+export declare function importWorldbookFromFile(path: string): Promise<{
+    book: SillyTavernWorldbook;
+    draft: WorldbookDraftEntry[];
+}>;
+export declare function worldbookToDraft(book: SillyTavernWorldbook): WorldbookDraftEntry[];

package/dist/core/worldbook-importer.js

@@ -0,0 +1,50 @@
+import fs from "node:fs/promises";
+import { SillyTavernWorldbookSchema } from "../schemas/sillytavern-worldbook.js";
+import { safeJsonParse } from "../utils/json.js";
+import { numberToPosition } from "./position-map.js";
+export async function importWorldbookFromFile(path) {
+    const text = await fs.readFile(path, "utf8");
+    const book = SillyTavernWorldbookSchema.parse(safeJsonParse(text));
+    return { book, draft: worldbookToDraft(book) };
+}
+export function worldbookToDraft(book) {
+    return Object.values(book.entries)
+        .sort((a, b) => a.uid - b.uid)
+        .map(entryToDraft);
+}
+function entryToDraft(entry) {
+    return {
+        comment: entry.comment || `uid_${entry.uid}`,
+        entryType: inferEntryType(entry),
+        keys: entry.key ?? [],
+        secondaryKeys: entry.keysecondary ?? [],
+        content: entry.content ?? "",
+        constant: entry.constant,
+        position: numberToPosition(entry.position) ?? "after_char",
+        order: entry.order,
+        enabled: !entry.disable,
+        depth: entry.depth,
+        scanDepth: entry.scanDepth ?? undefined,
+        preventRecursion: true,
+        excludeRecursion: true,
+    };
+}
+function inferEntryType(entry) {
+    const content = entry.content.trim();
+    if (/^<character>[\s\S]*<\/character>$/.test(content))
+        return "character_basic";
+    if (/^<personality>[\s\S]*<\/personality>$/.test(content))
+        return "character_personality";
+    if (/^<item>[\s\S]*<\/item>$/.test(content))
+        return "item";
+    if (/^<ability>[\s\S]*<\/ability>$/.test(content))
+        return "ability";
+    if (/^<scene>[\s\S]*<\/scene>$/.test(content))
+        return "scene";
+    if (/^<event>[\s\S]*<\/event>$/.test(content))
+        return "event";
+    if (entry.comment.includes("总纲") || entry.position === 0)
+        return "world_summary";
+    return "other";
+}
+//# sourceMappingURL=worldbook-importer.js.map