@qihuang02/world-book-mcp 0.0.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"worldbook-importer.js","sourceRoot":"","sources":["../../src/core/worldbook-importer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAA6D,MAAM,qCAAqC,CAAC;AAE5I,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAY;IACxD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAA0B;IACzD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;SAC7B,GAAG,CAAC,YAAY,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,YAAY,CAAC,KAAgC;IACpD,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,GAAG,EAAE;QAC5C,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC;QAChC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;QACrB,aAAa,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;QACvC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,YAAY;QAC1D,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO;QACvB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;QACvC,gBAAgB,EAAE,IAAI;QACtB,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAgC;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChF,IAAI,uCAAuC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,uBAAuB,CAAC;IAC1F,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3D,IAAI,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACpE,IAAI,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9D,IAAI,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC;IACjF,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { Project } from "../schemas/project.js";
+import type { WorldbookPatch, WorldbookPatchOperation } from "../schemas/worldbook-patch.js";
+import type { WorldbookDraftEntry } from "../schemas/worldbook-draft.js";
+import { validateWorldbookDraft } from "./worldbook-validator.js";
+export interface PatchDiffItem {
+    op: WorldbookPatchOperation["op"];
+    target: string;
+    before?: unknown;
+    after?: unknown;
+}
+export interface PatchApplicationResult {
+    entries: WorldbookDraftEntry[];
+    diff: PatchDiffItem[];
+}
+export declare function createPatch(input: {
+    projectId: string;
+    sourcePath?: string;
+    operations: WorldbookPatchOperation[];
+}): WorldbookPatch;
+export declare function applyPatchToDraft(entries: WorldbookDraftEntry[], operations: WorldbookPatchOperation[]): PatchApplicationResult;
+export declare function previewPatch(project: Project, patch: WorldbookPatch): PatchApplicationResult & {
+    validation: ReturnType<typeof validateWorldbookDraft>;
+};

package/dist/core/worldbook-patch.js

@@ -0,0 +1,100 @@
+import { createId, nowIso } from "../utils/ids.js";
+import { validateWorldbookDraft } from "./worldbook-validator.js";
+export function createPatch(input) {
+    return {
+        id: createId("patch"),
+        projectId: input.projectId,
+        sourcePath: input.sourcePath,
+        operations: input.operations,
+        createdAt: nowIso(),
+    };
+}
+export function applyPatchToDraft(entries, operations) {
+    const next = entries.map(cloneEntry);
+    const diff = [];
+    for (const operation of operations) {
+        switch (operation.op) {
+            case "add_entry": {
+                const entry = normalizeEntry(operation.entry);
+                next.push(entry);
+                diff.push({ op: operation.op, target: `index=${next.length - 1}`, after: entry });
+                break;
+            }
+            case "update_entry": {
+                const index = resolveIndex(next, operation.match);
+                const before = cloneEntry(next[index]);
+                next[index] = normalizeEntry({
+                    ...next[index],
+                    ...operation.changes,
+                    scanDepth: operation.changes.scanDepth === null ? undefined : operation.changes.scanDepth ?? next[index].scanDepth,
+                });
+                diff.push({ op: operation.op, target: targetLabel(next[index], index), before, after: next[index] });
+                break;
+            }
+            case "delete_entry": {
+                const index = resolveIndex(next, operation.match);
+                const [removed] = next.splice(index, 1);
+                diff.push({ op: operation.op, target: targetLabel(removed, index), before: removed });
+                break;
+            }
+            case "reorder_entry": {
+                const index = resolveIndex(next, operation.match);
+                const before = cloneEntry(next[index]);
+                next[index] = normalizeEntry({ ...next[index], order: operation.order });
+                diff.push({ op: operation.op, target: targetLabel(next[index], index), before, after: next[index] });
+                break;
+            }
+            case "toggle_entry": {
+                const index = resolveIndex(next, operation.match);
+                const before = cloneEntry(next[index]);
+                next[index] = normalizeEntry({ ...next[index], enabled: operation.enabled });
+                diff.push({ op: operation.op, target: targetLabel(next[index], index), before, after: next[index] });
+                break;
+            }
+        }
+    }
+    return { entries: next, diff };
+}
+export function previewPatch(project, patch) {
+    if (!project.draft)
+        throw new Error("项目尚未保存 worldbook draft");
+    const result = applyPatchToDraft(project.draft, patch.operations);
+    return { ...result, validation: validateWorldbookDraft(result.entries) };
+}
+function resolveIndex(entries, match) {
+    if (match.index !== undefined) {
+        if (!entries[match.index])
+            throw new Error(`未找到 index=${match.index} 的条目`);
+        return match.index;
+    }
+    if (match.uid !== undefined) {
+        if (!entries[match.uid])
+            throw new Error(`未找到 uid=${match.uid} 的条目`);
+        return match.uid;
+    }
+    const index = entries.findIndex((entry) => entry.comment === match.comment);
+    if (index === -1)
+        throw new Error(`未找到 comment=${match.comment} 的条目`);
+    return index;
+}
+function normalizeEntry(entry) {
+    return {
+        ...entry,
+        keys: entry.keys ?? [],
+        secondaryKeys: entry.secondaryKeys ?? [],
+        enabled: entry.enabled ?? true,
+        preventRecursion: true,
+        excludeRecursion: true,
+    };
+}
+function cloneEntry(entry) {
+    return {
+        ...entry,
+        keys: [...entry.keys],
+        secondaryKeys: [...entry.secondaryKeys],
+    };
+}
+function targetLabel(entry, index) {
+    return `index=${index}; comment=${entry.comment}`;
+}
+//# sourceMappingURL=worldbook-patch.js.map

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

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

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

@@ -0,0 +1,41 @@
+import type { WorldbookDraftEntry, WorldbookEntryPlan } from "../schemas/worldbook-draft.js";
+import type { ValidationIssue } from "./worldbook-validator.js";
+export type SkillCardType = "single_character_card" | "multi_character_card" | "worldbook_only";
+export interface WorldbookPlanInput {
+    card_type: SkillCardType;
+    characters?: Array<{
+        name: string;
+        aliases?: string[];
+    }>;
+    world_sections?: string[];
+    items?: string[];
+    scenes?: string[];
+    events?: string[];
+    include_style_entries?: boolean;
+    include_chapter_entries?: boolean;
+}
+export declare function classifyWorldbookCardType(input: {
+    core_character_count: number;
+    has_character_card?: boolean;
+    is_system_driven?: boolean;
+}): {
+    card_type: SkillCardType;
+    reason: string;
+    strategy: string[];
+};
+export declare function createWorldbookEntryPlan(input: WorldbookPlanInput): {
+    card_type: SkillCardType;
+    entries_plan: WorldbookEntryPlan[];
+};
+export declare function validateWorldbookEntryPlan(input: {
+    card_type: SkillCardType;
+    plan: WorldbookEntryPlan[];
+}): {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    summary: {
+        entry_count: number;
+    };
+};
+export declare function validateDraftAgainstCardType(entries: WorldbookDraftEntry[], cardType?: SkillCardType): ValidationIssue[];

package/dist/core/worldbook-planning.js

@@ -0,0 +1,74 @@
+export function classifyWorldbookCardType(input) {
+    if (input.is_system_driven || !input.has_character_card) {
+        return { card_type: "worldbook_only", reason: "无角色卡承载或系统驱动世界书", strategy: ["条目默认蓝灯", "动态变化交给 EJS 或后续逻辑"] };
+    }
+    if (input.core_character_count <= 1) {
+        return { card_type: "single_character_card", reason: "只有 1 个核心角色", strategy: ["核心角色拆分条目全部蓝灯", "NPC/场景/物品按关键词绿灯"] };
+    }
+    return { card_type: "multi_character_card", reason: "存在 2 个及以上核心角色", strategy: ["角色速览蓝灯", "角色详情/性格绿灯 + keys + scanDepth=2"] };
+}
+export function createWorldbookEntryPlan(input) {
+    const plan = [];
+    const worldSections = input.world_sections?.length ? input.world_sections : ["世界观总纲"];
+    worldSections.forEach((name, index) => {
+        plan.push(planItem(name, index === 0 ? "world_summary" : "background", "before_char", index + 1, true, [], "世界观/背景信息应常驻并位于角色定义之前"));
+    });
+    const characters = input.characters ?? [];
+    if (input.card_type === "multi_character_card" && characters.length > 0) {
+        plan.push(planItem("角色速览", "character_overview", "before_char", 4, true, [], "多角色卡需要常驻速览，避免全部详情常驻"));
+    }
+    characters.forEach((character, index) => {
+        const keys = [character.name, ...(character.aliases ?? [])].filter(Boolean);
+        const constant = input.card_type === "single_character_card" || input.card_type === "worldbook_only";
+        plan.push(planItem(`${character.name}_基础设定`, "character_basic", "after_char", input.card_type === "single_character_card" ? 10 : 10 + index, constant, constant ? [] : keys, constant ? "单角色/纯世界书角色信息常驻" : "多角色详情按关键词触发"));
+        plan.push(planItem(`${character.name}_性格`, "character_personality", "after_char", input.card_type === "single_character_card" ? 30 : 35 + index, constant, constant ? [] : keys, "性格必须独立条目"));
+    });
+    (input.items ?? []).forEach((name, index) => plan.push(planItem(`${name}_物品`, "item", "after_char", 50 + index, input.card_type === "worldbook_only", input.card_type === "worldbook_only" ? [] : [name], "物品/装备按关键词触发")));
+    (input.scenes ?? []).forEach((name, index) => plan.push(planItem(`${name}_场景`, "scene", "after_char", 80 + index, input.card_type === "worldbook_only", input.card_type === "worldbook_only" ? [] : [name], "场景按关键词触发")));
+    (input.events ?? []).forEach((name, index) => plan.push(planItem(`${name}_事件`, "event", "after_char", 90 + index, input.card_type === "worldbook_only", input.card_type === "worldbook_only" ? [] : [name], "事件按关键词触发")));
+    if (input.include_style_entries) {
+        plan.push(planItem("文风规则", "other", "before_an", 1, true, [], "文风规则注入作者注之前"));
+    }
+    if (input.include_chapter_entries) {
+        plan.push(planItem("章节摘要模板", "event", "after_char", 100, false, ["章节", "剧情"], "章节摘要绿灯触发，scanDepth=2"));
+    }
+    return { card_type: input.card_type, entries_plan: plan };
+}
+export function validateWorldbookEntryPlan(input) {
+    const errors = [];
+    const warnings = [];
+    const hasWorldSummary = input.plan.some((entry) => entry.entryType === "world_summary" && entry.order === 1);
+    if (!hasWorldSummary)
+        warnings.push({ field: "plan", severity: "warning", message: "建议包含 order=1 的世界观总纲" });
+    input.plan.forEach((entry) => {
+        if (!entry.constant && entry.keys.length === 0)
+            errors.push({ entry: entry.comment, field: "keys", severity: "error", message: "绿灯规划必须提供 keys" });
+        if (["before_an", "after_an", "before_em", "after_em", "outlet"].includes(entry.position) && entry.entryType !== "other")
+            warnings.push({ entry: entry.comment, field: "position", severity: "warning", message: "普通世界书条目不建议使用该 position" });
+        if (input.card_type === "single_character_card" && ["character_basic", "character_personality"].includes(entry.entryType) && !entry.constant)
+            errors.push({ entry: entry.comment, field: "constant", severity: "error", message: "单角色卡核心角色条目必须蓝灯" });
+        if (input.card_type === "multi_character_card" && ["character_basic", "character_personality"].includes(entry.entryType) && entry.constant)
+            warnings.push({ entry: entry.comment, field: "constant", severity: "warning", message: "多角色卡详情条目建议绿灯，角色速览才蓝灯" });
+        if (input.card_type === "worldbook_only" && !entry.constant)
+            warnings.push({ entry: entry.comment, field: "constant", severity: "warning", message: "纯世界书条目默认建议蓝灯，动态变化交给 EJS" });
+    });
+    return { valid: errors.length === 0, errors, warnings, summary: { entry_count: input.plan.length } };
+}
+export function validateDraftAgainstCardType(entries, cardType) {
+    if (!cardType)
+        return [];
+    const issues = [];
+    entries.forEach((entry) => {
+        if (cardType === "single_character_card" && ["character_basic", "character_personality"].includes(entry.entryType) && !entry.constant)
+            issues.push({ entry: entry.comment, field: "constant", severity: "error", message: "单角色卡核心角色条目必须为蓝灯 constant=true" });
+        if (cardType === "multi_character_card" && ["character_basic", "character_personality"].includes(entry.entryType) && entry.constant)
+            issues.push({ entry: entry.comment, field: "constant", severity: "warning", message: "多角色卡角色详情建议为绿灯 constant=false" });
+        if (!entry.constant && entry.scanDepth !== 2)
+            issues.push({ entry: entry.comment, field: "scanDepth", severity: "warning", message: "绿灯条目建议 scanDepth=2" });
+    });
+    return issues;
+}
+function planItem(comment, entryType, position, order, constant, keys, reason) {
+    return { comment, entryType, position, order, constant, keys, reason };
+}
+//# sourceMappingURL=worldbook-planning.js.map

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

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

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

@@ -0,0 +1,7 @@
+export type QueryMode = "brief" | "uid" | "search" | "stats";
+export declare function queryWorldbook(input: {
+    path: string;
+    mode: QueryMode;
+    uid?: number;
+    query?: string;
+}): Promise<unknown>;

package/dist/core/worldbook-query.js

@@ -0,0 +1,58 @@
+import fs from "node:fs/promises";
+import { SillyTavernWorldbookSchema } from "../schemas/sillytavern-worldbook.js";
+import { safeJsonParse } from "../utils/json.js";
+import { resolveReadableWorldbookPath } from "../storage/path-policy.js";
+import { numberToPosition } from "./position-map.js";
+export async function queryWorldbook(input) {
+    const resolvedPath = resolveReadableWorldbookPath(input.path);
+    const text = await fs.readFile(resolvedPath, "utf8");
+    const book = SillyTavernWorldbookSchema.parse(safeJsonParse(text));
+    const entries = Object.values(book.entries).sort((a, b) => a.uid - b.uid);
+    switch (input.mode) {
+        case "brief":
+            return {
+                name: book.name,
+                entries: entries.map(toBrief),
+            };
+        case "uid": {
+            const entry = entries.find((item) => item.uid === input.uid);
+            if (!entry)
+                throw new Error(`未找到 uid=${input.uid} 的条目`);
+            return entry;
+        }
+        case "search": {
+            const query = input.query?.toLowerCase();
+            if (!query)
+                throw new Error("search 模式需要 query");
+            return {
+                name: book.name,
+                entries: entries.filter((entry) => searchable(entry).toLowerCase().includes(query)).map(toBrief),
+            };
+        }
+        case "stats":
+            return {
+                name: book.name,
+                entry_count: entries.length,
+                constant_count: entries.filter((entry) => entry.constant).length,
+                triggered_count: entries.filter((entry) => !entry.constant).length,
+                disabled_count: entries.filter((entry) => entry.disable).length,
+            };
+    }
+}
+function toBrief(entry) {
+    return {
+        uid: entry.uid,
+        comment: entry.comment,
+        keys: entry.key,
+        position: numberToPosition(entry.position) ?? entry.position,
+        order: entry.order,
+        constant: entry.constant,
+        enabled: !entry.disable,
+        preventRecursion: entry.preventRecursion,
+        excludeRecursion: entry.excludeRecursion,
+    };
+}
+function searchable(entry) {
+    return [entry.comment, entry.content, ...entry.key, ...entry.keysecondary].join("\n");
+}
+//# sourceMappingURL=worldbook-query.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { WorldbookDraftEntry } from "../schemas/worldbook-draft.js";
+export interface ValidationIssue {
+    entry?: string;
+    field?: string;
+    severity: "error" | "warning";
+    message: string;
+    suggestion?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    summary: {
+        entry_count: number;
+        constant_count: number;
+        triggered_count: number;
+    };
+}
+export declare function validateWorldbookDraft(entries: WorldbookDraftEntry[]): ValidationResult;

package/dist/core/worldbook-validator.js

@@ -0,0 +1,116 @@
+import { lintContent } from "./content-lint.js";
+const BAD_KEY_SEPARATORS = /[，、；;]/;
+export function validateWorldbookDraft(entries) {
+    const issues = [];
+    const orderSeen = new Map();
+    const commentSeen = new Set();
+    const keySeen = new Map();
+    if (entries.length === 0) {
+        issues.push({ field: "entries", severity: "error", message: "entries 不能为空" });
+    }
+    for (const entry of entries) {
+        if (!entry.comment.trim()) {
+            issues.push({ entry: entry.comment, field: "comment", severity: "error", message: "comment 不能为空" });
+        }
+        else if (commentSeen.has(entry.comment)) {
+            issues.push({ entry: entry.comment, field: "comment", severity: "warning", message: "comment 重复，后续按 comment 更新时可能定位不明确" });
+        }
+        else {
+            commentSeen.add(entry.comment);
+        }
+        if (!entry.content.trim()) {
+            issues.push({ entry: entry.comment, field: "content", severity: "error", message: "content 不能为空" });
+        }
+        if (!entry.preventRecursion) {
+            issues.push({ entry: entry.comment, field: "preventRecursion", severity: "error", message: "preventRecursion 必须为 true" });
+        }
+        if (!entry.excludeRecursion) {
+            issues.push({ entry: entry.comment, field: "excludeRecursion", severity: "error", message: "excludeRecursion 必须为 true" });
+        }
+        if (!entry.constant && entry.keys.length === 0) {
+            issues.push({ entry: entry.comment, field: "keys", severity: "error", message: "绿灯条目 constant=false 时必须提供 keys" });
+        }
+        if (entry.constant && entry.scanDepth !== undefined) {
+            issues.push({ entry: entry.comment, field: "scanDepth", severity: "warning", message: "蓝灯条目通常不需要 scanDepth" });
+        }
+        if (!entry.constant && entry.scanDepth === undefined) {
+            issues.push({ entry: entry.comment, field: "scanDepth", severity: "warning", message: "绿灯条目建议设置 scanDepth=2" });
+        }
+        for (const key of entry.keys) {
+            const normalizedKey = key.trim();
+            if (!normalizedKey) {
+                issues.push({ entry: entry.comment, field: "keys", severity: "error", message: "关键词不能为空白字符串" });
+                continue;
+            }
+            if (BAD_KEY_SEPARATORS.test(key)) {
+                issues.push({ entry: entry.comment, field: "keys", severity: "error", message: `关键词包含中文或错误分隔符: ${key}`, suggestion: "使用数组或英文逗号分隔后的独立字符串" });
+            }
+            const previousEntry = keySeen.get(normalizedKey);
+            if (previousEntry && previousEntry !== entry.comment) {
+                issues.push({ entry: entry.comment, field: "keys", severity: "warning", message: `关键词 ${normalizedKey} 已在 ${previousEntry} 中出现，可能导致多条目同时触发` });
+            }
+            else {
+                keySeen.set(normalizedKey, entry.comment);
+            }
+        }
+        if (!Number.isInteger(entry.order)) {
+            issues.push({ entry: entry.comment, field: "order", severity: "warning", message: "order 建议使用整数" });
+        }
+        if (entry.position === "at_depth" && entry.depth === undefined) {
+            issues.push({ entry: entry.comment, field: "depth", severity: "warning", message: "at_depth 应显式设置 depth=0" });
+        }
+        if (entry.position === "at_depth" && entry.depth !== 0) {
+            issues.push({ entry: entry.comment, field: "depth", severity: "warning", message: "at_depth 推荐只使用 depth=0", suggestion: "普通世界观不要使用 D1 及以上深度" });
+        }
+        if (entry.position === "outlet") {
+            issues.push({ entry: entry.comment, field: "position", severity: "warning", message: "outlet 位置第一版不推荐使用" });
+        }
+        if (looksLikeJson(entry.content)) {
+            issues.push({ entry: entry.comment, field: "content", severity: "warning", message: "content 疑似纯 JSON，世界书条目建议使用 XML 包裹 YAML 或自然语言 YAML" });
+        }
+        if (needsXml(entry.entryType) && !hasXmlWrapper(entry.content)) {
+            issues.push({ entry: entry.comment, field: "content", severity: "warning", message: `${entry.entryType} 建议使用 XML 包裹 YAML` });
+        }
+        const orderKey = `${entry.position}:${entry.order}`;
+        const previous = orderSeen.get(orderKey);
+        if (previous) {
+            issues.push({ entry: entry.comment, field: "order", severity: "warning", message: `order 与 ${previous} 在同一 position 中重复` });
+        }
+        else {
+            orderSeen.set(orderKey, entry.comment);
+        }
+        const lint = lintContent(entry.content);
+        for (const lintIssue of lint.issues) {
+            issues.push({
+                entry: entry.comment,
+                field: "content",
+                severity: lintIssue.severity,
+                message: lintIssue.term ? `文本问题：${lintIssue.term}` : lintIssue.message,
+                suggestion: lintIssue.suggestion,
+            });
+        }
+    }
+    const errors = issues.filter((issue) => issue.severity === "error");
+    const warnings = issues.filter((issue) => issue.severity === "warning");
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        summary: {
+            entry_count: entries.length,
+            constant_count: entries.filter((entry) => entry.constant).length,
+            triggered_count: entries.filter((entry) => !entry.constant).length,
+        },
+    };
+}
+function looksLikeJson(content) {
+    const trimmed = content.trim();
+    return (trimmed.startsWith("{") && trimmed.endsWith("}")) || (trimmed.startsWith("[") && trimmed.endsWith("]"));
+}
+function hasXmlWrapper(content) {
+    return /^\s*<([a-zA-Z_][\w-]*)>[\s\S]*<\/\1>\s*$/.test(content);
+}
+function needsXml(entryType) {
+    return !["world_summary", "background"].includes(entryType);
+}
+//# sourceMappingURL=worldbook-validator.js.map

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

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

package/dist/core/worldbuilding.d.ts

@@ -0,0 +1,80 @@
+import type { ValidationIssue } from "./worldbook-validator.js";
+export type WorldbuildingType = "A_realistic_background" | "B_small_world" | "C_large_world";
+export interface WorldbuildingSummary {
+    world_type: WorldbuildingType;
+    title: string;
+    summary: string;
+    geography?: string;
+    history?: string;
+    factions?: string;
+    rules?: string;
+    society?: string;
+    technology?: string;
+    boundaries?: string;
+}
+export interface WorldbuildingValidationResult {
+    ok: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    summary: {
+        world_type: WorldbuildingType;
+        summary_length: number;
+        filled_dimension_count: number;
+    };
+}
+export declare function createWorldbuildingOutline(input?: {
+    title?: string;
+    world_type?: WorldbuildingType;
+}): {
+    world_type_options: Record<WorldbuildingType, string>;
+    template: WorldbuildingSummary;
+    rules: string[];
+};
+export declare function validateWorldbuildingSummary(summary: WorldbuildingSummary): WorldbuildingValidationResult;
+export interface WorldbuildingTypeClassification {
+    world_type: WorldbuildingType;
+    confidence: "high" | "medium" | "low";
+    reasons: string[];
+    recommended_dimensions: string[];
+}
+export declare function classifyWorldbuildingType(input: {
+    title?: string;
+    brief?: string;
+    tags?: string[];
+}): WorldbuildingTypeClassification;
+export declare function createWorldbuildingDesignTemplate(input: {
+    world_type?: WorldbuildingType;
+    title?: string;
+}): {
+    world_type: WorldbuildingType;
+    title: string;
+    sections: Array<{
+        name: string;
+        required: boolean;
+        guidance: string;
+        placeholder: string;
+    }>;
+    rules: string[];
+};
+export interface WorldbuildingDesignInput {
+    world_type: WorldbuildingType;
+    title: string;
+    geography?: string;
+    history?: string;
+    factions?: string;
+    rules?: string;
+    society?: string;
+    technology?: string;
+    boundaries?: string;
+}
+export interface WorldbuildingDesignValidationResult {
+    ok: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    summary: {
+        world_type: WorldbuildingType;
+        filled_required_count: number;
+        missing_required: string[];
+    };
+}
+export declare function validateWorldbuildingDesign(design: WorldbuildingDesignInput): WorldbuildingDesignValidationResult;