@qihuang02/world-book-mcp 0.0.3

package/dist/core/character-card-query.js

@@ -0,0 +1,30 @@
+import fs from "node:fs/promises";
+import { safeJsonParse } from "../utils/json.js";
+import { resolveReadableCardPath } from "../storage/path-policy.js";
+export async function queryCharacterCard(input) {
+    const resolvedPath = resolveReadableCardPath(input.path);
+    const card = safeJsonParse(await fs.readFile(resolvedPath, "utf8"));
+    switch (input.mode) {
+        case "summary":
+            return {
+                name: card.data?.name ?? card.name,
+                spec: card.spec,
+                spec_version: card.spec_version,
+                greeting_count: 1 + (card.data?.alternate_greetings?.length ?? 0),
+                worldbook_name: card.data?.character_book?.name,
+                worldbook_entry_count: card.data?.character_book?.entries?.length ?? 0,
+                tags: card.data?.tags ?? card.tags ?? [],
+            };
+        case "worldbook_entries":
+            return {
+                name: card.data?.name ?? card.name,
+                entries: card.data?.character_book?.entries ?? [],
+            };
+        case "greetings":
+            return {
+                first_mes: card.data?.first_mes ?? card.first_mes,
+                alternate_greetings: card.data?.alternate_greetings ?? [],
+            };
+    }
+}
+//# sourceMappingURL=character-card-query.js.map

package/dist/core/character-card-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-card-query.js","sourceRoot":"","sources":["../../src/core/character-card-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAIpE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAqD;IAC5F,MAAM,YAAY,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,aAAa,CAAM,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI;gBAClC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,cAAc,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,IAAI,CAAC,CAAC;gBACjE,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI;gBAC/C,qBAAqB,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;gBACtE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE;aACzC,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI;gBAClC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,IAAI,EAAE;aAClD,CAAC;QACJ,KAAK,WAAW;YACd,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS;gBACjD,mBAAmB,EAAE,IAAI,CAAC,IAAI,EAAE,mBAAmB,IAAI,EAAE;aAC1D,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/core/character-card-validator.d.ts

@@ -0,0 +1,17 @@
+import type { CharacterCardConfig } from "../schemas/character-card.js";
+import type { WorldbookDraftEntry } from "../schemas/worldbook-draft.js";
+import { type ValidationIssue } from "./worldbook-validator.js";
+export interface CharacterCardValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    summary: {
+        worldbook_entry_count: number;
+        greeting_count: number;
+    };
+}
+export declare function validateCharacterCardConfig(input: {
+    config: CharacterCardConfig;
+    draft?: WorldbookDraftEntry[];
+    mvuEnabled?: boolean;
+}): CharacterCardValidationResult;

package/dist/core/character-card-validator.js

@@ -0,0 +1,42 @@
+import { validateGreetings } from "./greeting-validator.js";
+import { validateWorldbookDraft } from "./worldbook-validator.js";
+export function validateCharacterCardConfig(input) {
+    const errors = [];
+    const warnings = [];
+    const { config, draft } = input;
+    if (!config.card.name.trim()) {
+        errors.push({ field: "card.name", severity: "error", message: "角色卡 name 必填" });
+    }
+    if (!config.card.first_mes.trim()) {
+        errors.push({ field: "card.first_mes", severity: "error", message: "角色卡 first_mes 必填" });
+    }
+    if (config.card.description.trim()) {
+        warnings.push({ field: "card.description", severity: "warning", message: "当前规范建议 description 为空，角色信息放入世界书条目" });
+    }
+    const greetingValidation = validateGreetings({ config, mvu_enabled: input.mvuEnabled });
+    errors.push(...greetingValidation.errors);
+    warnings.push(...greetingValidation.warnings);
+    if (config.worldbook.source === "project_draft") {
+        if (!draft) {
+            errors.push({ field: "worldbook.source", severity: "error", message: "worldbook.source=project_draft 时项目必须有 draft" });
+        }
+        else {
+            const worldbookValidation = validateWorldbookDraft(draft);
+            errors.push(...worldbookValidation.errors.map((issue) => ({ ...issue, field: `worldbook.${issue.field ?? "unknown"}` })));
+            warnings.push(...worldbookValidation.warnings.map((issue) => ({ ...issue, field: `worldbook.${issue.field ?? "unknown"}` })));
+        }
+    }
+    else {
+        warnings.push({ field: "worldbook.source", severity: "warning", message: "未嵌入世界书，角色信息可能不足" });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        summary: {
+            worldbook_entry_count: config.worldbook.source === "project_draft" ? draft?.length ?? 0 : 0,
+            greeting_count: 1 + config.card.alternate_greetings.length,
+        },
+    };
+}
+//# sourceMappingURL=character-card-validator.js.map

package/dist/core/character-card-validator.js.map

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

package/dist/core/character-templates.d.ts

@@ -0,0 +1,29 @@
+import type { ValidationIssue } from "./worldbook-validator.js";
+export declare function createCharacterBasicEntryTemplate(input?: {
+    character_name?: string;
+}): {
+    template: string;
+    rules: string[];
+};
+export declare function createCharacterPersonalityEntryTemplate(input?: {
+    character_name?: string;
+}): {
+    template: string;
+    rules: string[];
+};
+export declare function validateCharacterEntryStructure(input: {
+    content: string;
+    kind: "basic" | "personality";
+}): {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+};
+export declare function validateCharacterAppearanceDistinctiveness(content: string): {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    summary: {
+        issue_count: number;
+    };
+};

package/dist/core/character-templates.js

@@ -0,0 +1,60 @@
+const UNIVERSAL_BEAUTY_TERMS = ["精致", "白皙", "好看", "美丽", "漂亮", "优雅", "温婉", "亭亭玉立"];
+const DEFAULT_APPEARANCE_PATTERNS = [/中国人.*黑发黑眼/, /日本人.*黑发/, /18岁.*年轻/, /精灵.*尖耳/];
+export function createCharacterBasicEntryTemplate(input = {}) {
+    const name = input.character_name ?? "角色名";
+    return {
+        template: `<character>\nname: ${name}\nname_en: \nage: \ngender: \nnicknames: []\nappearance:\n  height: \n  hair: \n  eyes: \n  skin: \n  build: \n  clothing:\n    daily: \n  distinguishing: \nbackground: |\n  \nabilities:\n  - name: \n    acquisition: \n    effects:\n      - \nrelationships:\n  - name: "{{user}}"\n    detail: \n</character>`,
+        rules: ["不要写 personality 字段", "外貌只写差异特征", "背景只写改变角色的关键事件", "关系写具体互动方式，不写抽象形容"],
+    };
+}
+export function createCharacterPersonalityEntryTemplate(input = {}) {
+    const name = input.character_name ?? "角色名";
+    return {
+        template: `<personality>\nname: ${name}\ncore_drive: \ntraits:\n  - 特征——行为依据\nlikes: \ndislikes: \nhabits: \nhidden_self:\n  - \n</personality>`,
+        rules: ["性格必须独立成条", "traits 每条都要有行为依据", "不要只写温柔/善良/冷酷等标签"],
+    };
+}
+export function validateCharacterEntryStructure(input) {
+    const errors = [];
+    const warnings = [];
+    const content = input.content;
+    if (input.kind === "basic") {
+        if (!/^\s*<character>[\s\S]*<\/character>\s*$/.test(content))
+            errors.push({ field: "content", severity: "error", message: "基础人设条目必须使用 <character> 包裹" });
+        if (/personality|性格特征|core_drive|核心驱动力/i.test(content))
+            errors.push({ field: "content", severity: "error", message: "基础人设条目不应混入性格内容，应拆到独立 personality 条目" });
+        if (!/relationships:|关系/.test(content))
+            warnings.push({ field: "relationships", severity: "warning", message: "建议包含关系设定，并用具体画面描述" });
+        warnings.push(...appearanceWarnings(content));
+        if (/感情深厚|好朋友|关系很好|羁绊很深/.test(content))
+            warnings.push({ field: "relationships", severity: "warning", message: "关系描写疑似抽象形容，建议改为具体事件和互动方式" });
+    }
+    else {
+        if (!/^\s*<personality>[\s\S]*<\/personality>\s*$/.test(content))
+            errors.push({ field: "content", severity: "error", message: "性格条目必须使用 <personality> 包裹" });
+        if (!/core_drive|核心驱动力/.test(content))
+            warnings.push({ field: "core_drive", severity: "warning", message: "性格条目建议包含核心驱动力" });
+        if (/温柔\s*$|善良\s*$|冷酷\s*$|强大\s*$/m.test(content))
+            warnings.push({ field: "traits", severity: "warning", message: "性格特征需要行为依据，不应只有标签" });
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+export function validateCharacterAppearanceDistinctiveness(content) {
+    const warnings = appearanceWarnings(content);
+    return { valid: true, errors: [], warnings, summary: { issue_count: warnings.length } };
+}
+function appearanceWarnings(content) {
+    const warnings = [];
+    for (const term of UNIVERSAL_BEAUTY_TERMS) {
+        if (content.includes(term))
+            warnings.push({ field: "appearance", severity: "warning", message: `外貌含万能修饰词：${term}`, suggestion: "改为可识别的差异特征" });
+    }
+    for (const pattern of DEFAULT_APPEARANCE_PATTERNS) {
+        if (pattern.test(content))
+            warnings.push({ field: "appearance", severity: "warning", message: "外貌疑似写入 AI 默认认知特征", suggestion: "默认特征不写，只写差异点" });
+    }
+    if (/如|像|仿佛|宛如/.test(content) && /眼|眸|肤|发|声音|声线/.test(content))
+        warnings.push({ field: "appearance", severity: "warning", message: "外貌疑似使用意象比喻，建议改为白描特征" });
+    return warnings;
+}
+//# sourceMappingURL=character-templates.js.map

package/dist/core/character-templates.js.map

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

package/dist/core/clarification.d.ts

@@ -0,0 +1,24 @@
+import type { SuggestedDecision } from "../schemas/decision.js";
+import { type TaskClassificationInput, type TaskClassificationResult, type WorldbookTaskClass } from "./task-classifier.js";
+export interface ClarificationStageInput {
+    request?: string;
+    task_type?: WorldbookTaskClass;
+    wants_character_card?: boolean;
+    wants_mvu?: boolean;
+    wants_html?: boolean;
+    wants_ejs?: boolean;
+    stage?: "intake" | "post_classification";
+}
+export interface ClarificationResult {
+    task_type: WorldbookTaskClass;
+    needs_clarification: boolean;
+    suggested_decisions: SuggestedDecision[];
+    notes: string[];
+}
+export interface ClassifyWithClarificationResult extends TaskClassificationResult, ClarificationResult {
+    recommended_next_tool?: string;
+}
+export declare function detectClarificationNeeds(input: ClarificationStageInput): ClarificationResult;
+export declare function classifyWorldbookTaskWithClarification(input: TaskClassificationInput): ClassifyWithClarificationResult;
+export declare function buildCardTypeDecision(): SuggestedDecision;
+export declare function buildWorldbuildingTypeDecision(): SuggestedDecision;

package/dist/core/clarification.js

@@ -0,0 +1,433 @@
+import { classifyWorldbookTask } from "./task-classifier.js";
+const ORIGIN_TYPE_DECISION = (sourceTool) => ({
+    id: "origin_type",
+    question: "请确认这次任务是原创还是二创？",
+    options: [
+        { value: "original", label: "原创", description: "无原作素材，由用户提供创意" },
+        { value: "derivative", label: "二创", description: "基于已有小说/游戏/网页等素材进行改编或提取" },
+        { value: "mixed", label: "混合", description: "原创为主，借鉴部分已有素材" },
+    ],
+    allow_custom: false,
+    multiple: false,
+    source_tool: sourceTool,
+});
+const TOGGLE_OPTIONS = [
+    { value: "yes", label: "是" },
+    { value: "no", label: "否" },
+];
+export function detectClarificationNeeds(input) {
+    const classification = classifyWorldbookTask({ request: input.request ?? "", wants_character_card: input.wants_character_card, wants_mvu: input.wants_mvu, wants_html: input.wants_html, wants_ejs: input.wants_ejs });
+    const taskType = input.task_type ?? classification.task_type;
+    const request = (input.request ?? "").toLowerCase();
+    const decisions = [];
+    if (input.stage !== "post_classification" && needsOriginClarification(taskType, request)) {
+        decisions.push(ORIGIN_TYPE_DECISION(taskTypeToTool(taskType)));
+    }
+    for (const decision of decisionsFor(taskType, input, request)) {
+        decisions.push(decision);
+    }
+    return {
+        task_type: taskType,
+        needs_clarification: decisions.length > 0,
+        suggested_decisions: decisions,
+        notes: notesFor(taskType, input, request, decisions.length > 0),
+    };
+}
+export function classifyWorldbookTaskWithClarification(input) {
+    const classification = classifyWorldbookTask(input);
+    const clarification = detectClarificationNeeds({ request: input.request, task_type: classification.task_type, wants_character_card: input.wants_character_card, wants_mvu: input.wants_mvu, wants_html: input.wants_html, wants_ejs: input.wants_ejs, stage: "intake" });
+    return {
+        ...classification,
+        ...clarification,
+        recommended_next_tool: clarification.needs_clarification ? "request_user_decision" : recommendedAfterClassify(classification.task_type),
+    };
+}
+function decisionsFor(taskType, input, request) {
+    switch (taskType) {
+        case "original_character_card":
+            return originalCharacterCardDecisions(input, request);
+        case "derivative_extraction":
+            return derivativeDecisions(input, request);
+        case "worldbuilding_only":
+            return worldbuildingOnlyDecisions(request);
+        case "item_ability_equipment":
+            return itemDecisions(request);
+        case "style_extraction":
+            return styleDecisions(request);
+        case "chapter_extraction":
+            return chapterDecisions(request);
+        case "modify_existing":
+            return modifyExistingDecisions(request);
+        case "query_existing":
+            return [];
+        case "mvu_zod":
+            return mvuDecisions(input);
+        case "ejs_dynamic":
+            return ejsDecisions(input);
+        case "html_beautify":
+            return htmlDecisions(input);
+        case "content_lint":
+            return contentLintDecisions();
+    }
+}
+function originalCharacterCardDecisions(input, request) {
+    const decisions = [];
+    decisions.push({
+        id: "card_type",
+        question: "请确认卡型（决定蓝绿灯策略）",
+        options: [
+            { value: "single_character_card", label: "单角色卡", description: "1 个核心角色，所有拆分条目蓝灯", is_recommended: true },
+            { value: "multi_character_card", label: "多角色卡", description: "2+ 核心角色，速览蓝灯/详情绿灯" },
+            { value: "worldbook_only", label: "纯世界书", description: "无角色卡承载，由系统/EJS 驱动" },
+        ],
+        allow_custom: false,
+        multiple: false,
+        source_tool: "classify_worldbook_card_type",
+    });
+    decisions.push({
+        id: "worldbuilding_type",
+        question: "请确认世界观类型 A/B/C",
+        options: [
+            { value: "A_realistic_background", label: "A 真实背景", description: "现代/历史现实舞台，只补必要细节" },
+            { value: "B_small_world", label: "B 小世界", description: "学校、宅邸、小镇等封闭舞台" },
+            { value: "C_large_world", label: "C 大世界", description: "架空大陆、奇幻/科幻文明" },
+        ],
+        allow_custom: false,
+        multiple: false,
+        source_tool: "classify_worldbuilding_type",
+    });
+    if (input.wants_mvu === undefined && !/\bmvu\b|状态变量|好感度|变量系统/.test(request)) {
+        decisions.push(toggleDecision("wants_mvu", "是否启用 MVU/ZOD 变量系统？", "create_mvu_schema_template"));
+    }
+    if (input.wants_ejs === undefined && !/\bejs\b|多阶段|动态条目|getwi/.test(request)) {
+        decisions.push(toggleDecision("wants_ejs", "是否启用 EJS 动态内容？（依赖 MVU）", "create_ejs_template"));
+    }
+    if (input.wants_html === undefined && !/html|状态栏|美化|前端/.test(request)) {
+        decisions.push(toggleDecision("wants_html", "是否启用 HTML 状态栏 / 前端美化？", "create_html_beautify_template"));
+    }
+    return decisions;
+}
+function derivativeDecisions(_input, request) {
+    const decisions = [];
+    if (!/小说|游戏|wiki|百科|网页|搜索|文本|资料/.test(request)) {
+        decisions.push({
+            id: "source_kind",
+            question: "请确认素材类型",
+            options: [
+                { value: "novel", label: "小说" },
+                { value: "game", label: "游戏" },
+                { value: "wiki", label: "wiki/百科" },
+                { value: "web_research", label: "网络搜索摘要" },
+                { value: "mixed", label: "多源混合" },
+            ],
+            allow_custom: false,
+            multiple: false,
+            source_tool: "create_derivative_extraction_template",
+        });
+    }
+    decisions.push({
+        id: "extraction_focus",
+        question: "请确认要提取哪些维度",
+        options: [
+            { value: "characters", label: "角色", is_recommended: true },
+            { value: "world", label: "世界观" },
+            { value: "items", label: "物品/能力" },
+            { value: "events", label: "事件" },
+            { value: "style", label: "文风" },
+            { value: "chapters", label: "章节" },
+        ],
+        allow_custom: false,
+        multiple: true,
+        source_tool: "create_derivative_extraction_template",
+    });
+    return decisions;
+}
+function worldbuildingOnlyDecisions(request) {
+    const decisions = [
+        {
+            id: "worldbuilding_type",
+            question: "请确认世界观类型 A/B/C",
+            options: [
+                { value: "A_realistic_background", label: "A 真实背景" },
+                { value: "B_small_world", label: "B 小世界" },
+                { value: "C_large_world", label: "C 大世界" },
+            ],
+            allow_custom: false,
+            multiple: false,
+            source_tool: "classify_worldbuilding_type",
+        },
+    ];
+    if (!/单角色|多角色|纯世界|系统驱动/.test(request)) {
+        decisions.push({
+            id: "card_type",
+            question: "世界观最终是否要承载角色卡？",
+            options: [
+                { value: "worldbook_only", label: "纯世界书", is_recommended: true },
+                { value: "single_character_card", label: "单角色卡" },
+                { value: "multi_character_card", label: "多角色卡" },
+            ],
+            allow_custom: false,
+            multiple: false,
+            source_tool: "classify_worldbook_card_type",
+        });
+    }
+    return decisions;
+}
+function itemDecisions(_request) {
+    return [{
+            id: "item_kind",
+            question: "请确认条目类别（可多选）",
+            options: [
+                { value: "clothing", label: "服装" },
+                { value: "special_item", label: "特殊道具" },
+                { value: "weapon", label: "武器" },
+                { value: "ability", label: "能力" },
+                { value: "equipment", label: "装备" },
+                { value: "generic", label: "通用物品" },
+            ],
+            allow_custom: false,
+            multiple: true,
+            source_tool: "validate_item_entry",
+        }];
+}
+function styleDecisions(_request) {
+    return [
+        {
+            id: "style_source_kind",
+            question: "文风来自原作素材还是用户自创？",
+            options: [
+                { value: "from_text", label: "原作文本提取" },
+                { value: "from_web_research", label: "网页搜索摘要" },
+                { value: "user_defined", label: "用户自创规则" },
+            ],
+            allow_custom: false,
+            multiple: false,
+            source_tool: "create_style_extraction_template",
+        },
+        {
+            id: "style_purpose",
+            question: "文风目的",
+            options: [
+                { value: "imitate", label: "模仿原作" },
+                { value: "new_rules", label: "自创规则" },
+                { value: "mixed", label: "模仿 + 补强" },
+            ],
+            allow_custom: false,
+            multiple: false,
+            source_tool: "create_style_extraction_template",
+        },
+    ];
+}
+function chapterDecisions(_request) {
+    return [
+        {
+            id: "chapter_count_hint",
+            question: "请粗略估计章节数量",
+            options: [
+                { value: "1-3", label: "1-3" },
+                { value: "4-10", label: "4-10" },
+                { value: "10-30", label: "10-30" },
+                { value: "30+", label: "30 以上" },
+            ],
+            allow_custom: true,
+            multiple: false,
+            source_tool: "create_chapter_extraction_template",
+        },
+        toggleDecision("need_line_index", "是否需要为每章标注原文行号？", "submit_derivative_extraction_outline"),
+    ];
+}
+function modifyExistingDecisions(_request) {
+    return [
+        {
+            id: "modification_kind",
+            question: "请确认修改类型（可多选）",
+            options: [
+                { value: "add_entry", label: "新增条目" },
+                { value: "update_entry", label: "更新条目" },
+                { value: "delete_entry", label: "删除条目" },
+                { value: "reorder_entry", label: "调整顺序" },
+                { value: "toggle_entry", label: "启用/禁用" },
+            ],
+            allow_custom: false,
+            multiple: true,
+            source_tool: "create_worldbook_patch",
+        },
+        {
+            id: "worldbook_path",
+            question: "请提供已有世界书 JSON 文件路径（output 下的相对或绝对路径）",
+            options: [],
+            allow_custom: true,
+            multiple: false,
+            source_tool: "import_worldbook_json",
+        },
+    ];
+}
+function mvuDecisions(input) {
+    const decisions = [{
+            id: "mvu_character_names",
+            question: "请输入需要追踪变量的角色名（用英文逗号分隔）",
+            options: [],
+            allow_custom: true,
+            multiple: false,
+            source_tool: "create_mvu_schema_template",
+        }];
+    if (input.wants_html === undefined) {
+        decisions.push(toggleDecision("wants_statusbar", "是否同时配置 HTML 状态栏？", "create_html_beautify_template"));
+    }
+    return decisions;
+}
+function ejsDecisions(input) {
+    const decisions = [];
+    if (!input.wants_mvu) {
+        decisions.push(toggleDecision("mvu_already_enabled", "EJS 依赖 MVU，请确认 MVU 是否已经启用？", "validate_mvu_config"));
+    }
+    decisions.push({
+        id: "ejs_template_type",
+        question: "请确认 EJS 模板类型",
+        options: [
+            { value: "phase_profile", label: "阶段人设", is_recommended: true },
+            { value: "palette", label: "调色盘" },
+            { value: "custom", label: "自定义" },
+        ],
+        allow_custom: false,
+        multiple: false,
+        source_tool: "create_ejs_template",
+    });
+    return decisions;
+}
+function htmlDecisions(input) {
+    const decisions = [{
+            id: "html_target",
+            question: "请确认 HTML 美化目标",
+            options: [
+                { value: "statusbar", label: "状态栏" },
+                { value: "global", label: "全局美化" },
+                { value: "both", label: "状态栏 + 全局" },
+                { value: "start_picker", label: "开场选择器" },
+            ],
+            allow_custom: false,
+            multiple: false,
+            source_tool: "create_html_beautify_template",
+        }];
+    if (input.wants_mvu === undefined) {
+        decisions.push(toggleDecision("wants_mvu_pairing", "是否需要与 MVU 状态变量联动？", "create_mvu_schema_template"));
+    }
+    return decisions;
+}
+function contentLintDecisions() {
+    return [{
+            id: "lint_scope",
+            question: "请确认禁词扫描范围",
+            options: [
+                { value: "single_text", label: "单段文本" },
+                { value: "project_all", label: "整个 project 产物", is_recommended: true },
+                { value: "single_entry", label: "单条目" },
+            ],
+            allow_custom: true,
+            multiple: false,
+            source_tool: "create_writing_optimization_report",
+        }];
+}
+function notesFor(taskType, input, _request, hasDecisions) {
+    const notes = [];
+    if (hasDecisions)
+        notes.push("用户描述存在歧义，建议依次调用 request_user_decision 后再继续工作流");
+    if (taskType === "ejs_dynamic" && !input.wants_mvu)
+        notes.push("EJS 必须先启用 MVU");
+    if (taskType === "html_beautify")
+        notes.push("HTML 美化资产最终需要通过角色卡或独立 regex 脚本承载");
+    return notes;
+}
+function recommendedAfterClassify(taskType) {
+    switch (taskType) {
+        case "derivative_extraction":
+            return "create_derivative_extraction_template";
+        case "worldbuilding_only":
+        case "original_character_card":
+            return "create_worldbuilding_outline";
+        case "item_ability_equipment":
+            return "validate_item_entry";
+        case "style_extraction":
+            return "create_style_extraction_template";
+        case "chapter_extraction":
+            return "create_chapter_extraction_template";
+        case "modify_existing":
+            return "import_worldbook_json";
+        case "query_existing":
+            return "query_worldbook";
+        case "mvu_zod":
+            return "create_mvu_schema_template";
+        case "ejs_dynamic":
+            return "create_ejs_template";
+        case "html_beautify":
+            return "create_html_beautify_template";
+        case "content_lint":
+            return "create_writing_optimization_report";
+    }
+}
+function needsOriginClarification(taskType, request) {
+    if (["mvu_zod", "ejs_dynamic", "html_beautify", "content_lint", "modify_existing", "query_existing"].includes(taskType))
+        return false;
+    if (/原创|原创设定|自创|完全原创/.test(request))
+        return false;
+    if (/二创|同人|原作|提取|根据.*(?:小说|文本|游戏|网页|资料)/.test(request))
+        return false;
+    return true;
+}
+function taskTypeToTool(taskType) {
+    switch (taskType) {
+        case "original_character_card":
+            return "classify_worldbook_card_type";
+        case "derivative_extraction":
+            return "create_derivative_extraction_template";
+        case "worldbuilding_only":
+            return "classify_worldbuilding_type";
+        case "style_extraction":
+            return "create_style_extraction_template";
+        case "chapter_extraction":
+            return "create_chapter_extraction_template";
+        case "item_ability_equipment":
+            return "validate_item_entry";
+        default:
+            return "classify_worldbook_task";
+    }
+}
+function toggleDecision(id, question, sourceTool) {
+    return {
+        id,
+        question,
+        options: TOGGLE_OPTIONS,
+        allow_custom: false,
+        multiple: false,
+        source_tool: sourceTool,
+    };
+}
+export function buildCardTypeDecision() {
+    return {
+        id: "card_type",
+        question: "请确认卡型（决定蓝绿灯策略）",
+        options: [
+            { value: "single_character_card", label: "单角色卡", description: "1 个核心角色，所有拆分条目蓝灯", is_recommended: true },
+            { value: "multi_character_card", label: "多角色卡", description: "2+ 核心角色，速览蓝灯/详情绿灯" },
+            { value: "worldbook_only", label: "纯世界书", description: "无角色卡承载，由系统/EJS 驱动" },
+        ],
+        allow_custom: false,
+        multiple: false,
+        source_tool: "classify_worldbook_card_type",
+    };
+}
+export function buildWorldbuildingTypeDecision() {
+    return {
+        id: "worldbuilding_type",
+        question: "请确认世界观类型 A/B/C",
+        options: [
+            { value: "A_realistic_background", label: "A 真实背景", description: "现代/历史现实舞台，只补必要细节" },
+            { value: "B_small_world", label: "B 小世界", description: "学校、宅邸、小镇等封闭舞台" },
+            { value: "C_large_world", label: "C 大世界", description: "架空大陆、奇幻/科幻文明" },
+        ],
+        allow_custom: false,
+        multiple: false,
+        source_tool: "classify_worldbuilding_type",
+    };
+}
+//# sourceMappingURL=clarification.js.map