gwe-engine 3.2.0

package/dist/index.d.ts

@@ -0,0 +1,847 @@
+type NodeCategory = 'style' | 'vocab' | 'rule' | 'ai';
+interface NodeDefinition {
+    readonly id: NodeId;
+    readonly name: string;
+    readonly category: NodeCategory;
+    readonly description: string;
+    readonly required: boolean;
+    readonly defaultOptionId: string;
+    readonly options: OptionId[];
+}
+type NodeId = 'node_sentence_rhythm' | 'node_paragraph_density' | 'node_dialogue_style' | 'node_description_style' | 'node_battle_style' | 'node_emotion_style' | 'node_tone' | 'node_platform' | 'node_info_density' | 'node_payoff_frequency' | 'node_pov' | 'node_rhetoric' | 'node_vocab_sensory' | 'node_vocab_filler' | 'node_target_length' | 'node_anchor_density' | 'node_strictness' | 'node_opening_impact' | 'node_twist_frequency' | 'node_ending_hook' | 'node_ai_creativity' | 'node_ai_continue_length';
+type OptionId = string;
+/** 节点选项 .kb.json 文件格式 */
+interface NodeOptionKB {
+    readonly kb_version: '2.0' | '3.0';
+    readonly node_id: NodeId;
+    readonly option_id: OptionId;
+    readonly option_name: string;
+    readonly option_description: string;
+    /** 词汇表：词库类节点使用，其他节点可为空 */
+    readonly vocabulary?: {
+        readonly add?: {
+            readonly bodyParts?: string[];
+            readonly sensoryVerbs?: string[];
+            readonly environmentSignals?: string[];
+            readonly actionVerbs?: string[];
+            readonly fillerPatterns?: string[];
+            readonly dialogueTags?: string[];
+            readonly worldTerms?: string[];
+            readonly [category: string]: string[] | undefined;
+        };
+        readonly remove?: string[];
+    };
+    /** 检测阈值覆盖 */
+    readonly threshold_overrides?: Partial<Thresholds>;
+    /** 雷达权重调整（乘系数） */
+    readonly radar_weights?: Partial<RadarWeights>;
+    /** 启用/禁用检测项 */
+    readonly checks?: {
+        readonly disable?: string[];
+        readonly enable?: string[];
+    };
+    /** AI系统提示词（注入到system prompt） */
+    readonly system_prompt?: string;
+    /** 示例段落（给用户预览，也作为AI的few-shot） */
+    readonly examples?: Array<{
+        readonly text: string;
+        readonly note?: string;
+    }>;
+    /** 约束：AI必须遵守的硬规则 */
+    readonly constraints?: string[];
+    /** 依赖：必须同时选中这些选项才能生效 */
+    readonly requires?: OptionId[];
+    /** 冲突：不能和这些选项同时选中 */
+    readonly conflicts?: OptionId[];
+}
+interface Thresholds {
+    minAnchors: number;
+    anchorsPerWords: number;
+    maxAnchorGap: number;
+    maxFillerSentences: number;
+    maxFillerWords: number;
+    maxDashCount: number;
+    maxEllipsisCount: number;
+    maxParagraphLength: number;
+    targetParagraphLength: number;
+    minParagraphCount: number;
+    maxDialogueContinuous: number;
+    maxDialogueTagRepeat: number;
+    maxSentenceLength: number;
+    targetSentenceLength: number;
+    shortSentenceRatio: number;
+    maxExpositionContinuous: number;
+    infoPointsPerThousand: number;
+    minSensoryTypes: number;
+    sightRatio: number;
+}
+declare const DEFAULT_THRESHOLDS: Thresholds;
+interface RadarWeights {
+    bodyReaction: number;
+    sensorySignal: number;
+    action: number;
+    emotion: number;
+    infoAdvance: number;
+    twistFrequency: number;
+    hookStrength: number;
+}
+declare const DEFAULT_RADAR_WEIGHTS: RadarWeights;
+interface Preset {
+    readonly preset_id: string;
+    readonly preset_name: string;
+    readonly preset_description: string;
+    readonly based_on: string | null;
+    /** 节点选项选择 */
+    readonly selections: Record<NodeId, OptionId>;
+    /** 预设追加词库 */
+    readonly extra_vocab?: NodeOptionKB['vocabulary'];
+    /** 预设追加提示词 */
+    readonly extra_prompt?: string;
+    /** 预设追加约束 */
+    readonly extra_constraints?: string[];
+    /** 预设专属规则（正则/自定义检查） */
+    readonly extra_rules?: CustomRule[];
+    /** 预设阈值覆盖 */
+    readonly threshold_overrides?: Partial<Thresholds>;
+    /** 封面/标签 */
+    readonly tags?: string[];
+}
+interface CustomRule {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly severity: 'error' | 'warning' | 'info';
+    readonly pattern?: string;
+    readonly check?: (text: string) => RuleViolation | null;
+    readonly injectToPrompt?: boolean;
+}
+interface EngineConfig {
+    presetId: string | null;
+    selections: Record<NodeId, OptionId>;
+    userOverrides: UserOverrides;
+}
+interface UserOverrides {
+    thresholds?: Partial<Thresholds>;
+    vocab?: NodeOptionKB['vocabulary'];
+    prompt?: string;
+    rules?: CustomRule[];
+    targetLength?: number;
+}
+interface WritingContext {
+    book: BookMeta;
+    characters: Character[];
+    settings: Setting[];
+    volumes?: Volume[];
+    chapters: Chapter[];
+    subplots?: Subplot[];
+    currentChapterId: string;
+    cursorPosition: number;
+    selection: TextSelection | null;
+}
+interface BookMeta {
+    id: string;
+    title: string;
+    author?: string;
+    synopsis?: string;
+    tags?: string[];
+}
+interface Character {
+    id: string;
+    name: string;
+    aliases?: string[];
+    role: 'protagonist' | 'antagonist' | 'supporting' | 'minor';
+    tags?: string[];
+    description?: string;
+    background?: string;
+    relationships?: CharacterRelationship[];
+    speechStyle?: string;
+    attributes?: Record<string, unknown>;
+}
+interface CharacterRelationship {
+    targetId: string;
+    type: string;
+    description?: string;
+}
+interface Setting {
+    id: string;
+    name: string;
+    type: 'world' | 'location' | 'faction' | 'system' | 'item' | 'other';
+    description: string;
+    attributes?: Record<string, unknown>;
+}
+interface Volume {
+    id: string;
+    title: string;
+    number: number;
+    summary?: string;
+}
+interface Chapter {
+    id: string;
+    title: string;
+    number: number;
+    volumeId?: string;
+    content: string;
+    wordCount: number;
+    summary?: string;
+    status: 'draft' | 'writing' | 'done';
+}
+interface Subplot {
+    id: string;
+    name: string;
+    description: string;
+    status: 'active' | 'foreshadowing' | 'resolved';
+    relatedCharacterIds?: string[];
+}
+interface TextSelection {
+    from: number;
+    to: number;
+    text: string;
+}
+interface CheckResult {
+    score: number;
+    radarScores: RadarScores;
+    violations: RuleViolation[];
+    stats: TextStats;
+    passed: boolean;
+}
+interface RadarScores {
+    bodyReaction: number;
+    sensorySignal: number;
+    action: number;
+    emotion: number;
+    infoAdvance: number;
+    twistFrequency: number;
+    hookStrength: number;
+}
+interface RuleViolation {
+    ruleId: string;
+    ruleName: string;
+    message: string;
+    severity: 'error' | 'warning' | 'info';
+    position?: {
+        from: number;
+        to: number;
+    };
+    suggestion?: string;
+}
+interface TextStats {
+    totalChars: number;
+    totalWords: number;
+    paragraphCount: number;
+    avgParagraphLength: number;
+    sentenceCount: number;
+    avgSentenceLength: number;
+    shortSentenceRatio: number;
+    anchorCount: number;
+    fillerCount: number;
+    dialogueRatio: number;
+    sensoryMentions: Record<string, number>;
+}
+type ChatRole = 'system' | 'user' | 'assistant';
+interface ChatMessage {
+    role: ChatRole;
+    content: string;
+}
+interface LLMRequest {
+    messages: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    stream?: boolean;
+}
+interface LLMUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+interface StreamCallbacks {
+    onToken: (delta: string) => void;
+    onDone: (fullContent: string, usage?: LLMUsage) => void;
+    onError: (error: Error) => void;
+}
+interface LLMProvider {
+    readonly name: string;
+    chat(request: LLMRequest): Promise<{
+        content: string;
+        usage?: LLMUsage;
+    }>;
+    stream(request: LLMRequest, callbacks: StreamCallbacks): Promise<void>;
+}
+type EngineEventType = 'config:changed' | 'config:validated' | 'preset:loaded' | 'preset:saved' | 'preset:deleted' | 'check:done' | 'ai:token' | 'ai:done' | 'ai:error' | 'rule:violation';
+interface EngineEvent {
+    type: EngineEventType;
+    payload?: unknown;
+}
+type EngineEventListener = (event: EngineEvent) => void;
+interface ValidationResult {
+    valid: boolean;
+    conflicts: ConflictInfo[];
+    missingDeps: DependencyInfo[];
+}
+interface ConflictInfo {
+    optionA: OptionId;
+    optionB: OptionId;
+    nodeA: NodeId;
+    nodeB: NodeId;
+    message: string;
+}
+interface DependencyInfo {
+    optionId: OptionId;
+    nodeId: NodeId;
+    requiredOption: OptionId;
+    message: string;
+}
+interface MergedConfig {
+    thresholds: Thresholds;
+    radarWeights: RadarWeights;
+    vocabulary: MergedVocabulary;
+    systemPrompts: string[];
+    constraints: string[];
+    examples: Array<{
+        text: string;
+        note?: string;
+    }>;
+    extraRules: CustomRule[];
+    disabledChecks: Set<string>;
+    enabledChecks: Set<string>;
+}
+interface MergedVocabulary {
+    bodyParts: Set<string>;
+    sensoryVerbs: Set<string>;
+    environmentSignals: Set<string>;
+    actionVerbs: Set<string>;
+    fillerPatterns: Set<string>;
+    dialogueTags: Set<string>;
+    worldTerms: Set<string>;
+    [category: string]: Set<string>;
+}
+
+type TaskType = 'continue' | 'rewrite' | 'review' | 'polish' | 'expand' | 'compress' | 'outline' | 'dialog' | 'generate';
+interface NodeCatalog {
+    nodes: NodeDefinition[];
+    presets: Preset[];
+}
+declare class GWEEngine {
+    private config;
+    private merged;
+    private llmProvider;
+    private loadedOptions;
+    private presets;
+    private listeners;
+    private context;
+    private customNodes;
+    private basePrompt;
+    private baseVocab;
+    private userPresets;
+    constructor(provider?: LLMProvider);
+    /**
+     * 从KB数据加载节点选项（.kb.json文件内容）
+     */
+    loadNodeOption(kb: NodeOptionKB): void;
+    /**
+     * 批量加载节点选项
+     */
+    loadNodeOptions(kbs: NodeOptionKB[]): void;
+    /**
+     * 注册预设包
+     */
+    registerPreset(preset: Preset): void;
+    /**
+     * 设置基础提示词（base-prompt.md内容）
+     */
+    setBasePrompt(prompt: string): void;
+    /**
+     * 设置基础词库（base-vocab.json内容）
+     */
+    setBaseVocab(vocab: NonNullable<NodeOptionKB['vocabulary']>['add']): void;
+    /**
+     * 设置LLM Provider
+     */
+    setLLMProvider(provider: LLMProvider): void;
+    /**
+     * 注册自定义节点
+     */
+    registerCustomNode(nodeDef: NodeDefinition): void;
+    /**
+     * 注册自定义规则
+     */
+    addCustomRule(rule: CustomRule): void;
+    /**
+     * 加载预设包（一键配置所有节点）
+     */
+    loadPreset(presetId: string): void;
+    /**
+     * 设置单个节点的选项
+     */
+    setNodeOption(nodeId: NodeId, optionId: OptionId): void;
+    /**
+     * 批量设置节点选项
+     */
+    setNodeOptions(selections: Partial<Record<NodeId, OptionId>>): void;
+    /**
+     * 应用用户自定义覆盖
+     */
+    applyUserOverrides(overrides: UserOverrides): void;
+    /**
+     * 清除所有用户自定义覆盖（恢复到纯节点+预设状态）
+     */
+    clearUserOverrides(): void;
+    /**
+     * 重置用户自定义词库（用于面板重新输入词库时替换而非追加）
+     */
+    setUserVocab(vocab: NonNullable<UserOverrides['vocab']>): void;
+    /**
+     * 重置用户自定义阈值（替换而非合并）
+     */
+    setUserThresholds(thresholds: Partial<Thresholds>): void;
+    /**
+     * 清除用户自定义阈值（恢复预设/节点默认）
+     */
+    clearUserThresholds(): void;
+    /**
+     * 设置用户自由文本自定义规则（直接注入system prompt）
+     */
+    setCustomPromptText(text: string): void;
+    /**
+     * 获取用户自由文本自定义规则
+     */
+    getCustomPromptText(): string;
+    /**
+     * 获取当前引擎配置（可序列化）
+     */
+    getConfig(): EngineConfig;
+    /**
+     * 加载引擎配置（从保存的文件恢复）
+     */
+    loadConfig(config: EngineConfig): void;
+    /**
+     * 验证当前配置（冲突/依赖检测）
+     */
+    validateConfig(): ValidationResult;
+    /**
+     * 设置写作上下文（书籍/角色/章节等数据）
+     */
+    setContext(context: WritingContext): void;
+    /**
+     * 运行文本检测（审稿核心）
+     */
+    check(text: string, context?: WritingContext): CheckResult;
+    /**
+     * 构建AI系统提示词
+     */
+    getSystemPrompt(task: TaskType, context?: WritingContext): string;
+    /**
+     * 构建AI用户消息
+     */
+    getUserMessage(task: TaskType, context?: WritingContext, params?: Record<string, unknown>): string;
+    /**
+     * 非流式AI调用（审稿/大纲等不需要实时输出的场景）
+     */
+    callAI(task: TaskType, params?: Record<string, unknown>): Promise<{
+        content: string;
+        usage?: LLMUsage;
+        checkResult?: CheckResult;
+    }>;
+    /**
+     * 流式AI调用（续写/润色等实时输出场景）
+     */
+    streamAI(task: TaskType, callbacks: StreamCallbacks, params?: Record<string, unknown>): Promise<void>;
+    /** 流式续写 */
+    continueWrite(callbacks: StreamCallbacks): Promise<void>;
+    /** 流式改写选中文本 */
+    rewriteSelection(callbacks: StreamCallbacks, selectedText: string): Promise<void>;
+    /** 审稿（非流式，返回检测结果+AI建议） */
+    review(): Promise<CheckResult>;
+    /** 润色（流式） */
+    polishSelection(callbacks: StreamCallbacks, selectedText: string): Promise<void>;
+    /** 扩写（流式） */
+    expandSelection(callbacks: StreamCallbacks, selectedText: string): Promise<void>;
+    /** 缩写（非流式） */
+    compressSelection(selectedText: string): Promise<string>;
+    /**
+     * 获取所有可用节点和预设列表
+     */
+    getNodeCatalog(): NodeCatalog;
+    /**
+     * 保存当前配置为用户自定义预设
+     */
+    saveUserPreset(name: string, description?: string): string;
+    /**
+     * 删除用户自定义预设
+     */
+    deleteUserPreset(presetId: string): boolean;
+    /**
+     * 从localStorage加载用户预设
+     */
+    private loadUserPresetsFromStorage;
+    /**
+     * 保存用户预设到localStorage
+     */
+    private saveUserPresetsToStorage;
+    /**
+     * 获取某个节点的已加载选项
+     */
+    getNodeOptions(nodeId: NodeId): NodeOptionKB[];
+    /**
+     * 获取单个选项的完整KB数据（包含描述、示例、约束等）
+     */
+    getOption(optionId: OptionId): NodeOptionKB | undefined;
+    /**
+     * 获取当前合并后的运行时配置（用于调试/UI显示）
+     */
+    getMergedConfig(): MergedConfig | null;
+    /**
+     * 同步获取当前合并后的运行时配置（别名，UI用）
+     */
+    getMergedConfigSync(): MergedConfig | null;
+    /**
+     * 获取所有预设（内置+用户自定义）
+     */
+    getPresets(): Preset[];
+    /**
+     * 保存当前配置为预设（UI友好的别名，对应saveUserPreset）
+     */
+    saveAsPreset(opts: {
+        preset_name: string;
+        description?: string;
+        tags?: string[];
+    }): string;
+    /**
+     * 获取当前配置的简短文字摘要（用于注入到对话AI的system prompt中，轻量不占token）
+     */
+    getConfigSummary(): string;
+    on(event: EngineEventType, listener: EngineEventListener): () => void;
+    off(event: EngineEventType, listener: EngineEventListener): void;
+    private emit;
+    private ensureMerged;
+    private getTemperature;
+}
+
+interface OpenAICompatibleConfig {
+    apiKey: string;
+    baseURL: string;
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    timeoutMs?: number;
+}
+declare class OpenAICompatibleProvider implements LLMProvider {
+    readonly name = "openai-compatible";
+    private config;
+    constructor(config: OpenAICompatibleConfig);
+    chat(request: LLMRequest): Promise<{
+        content: string;
+        usage?: LLMUsage;
+    }>;
+    stream(request: LLMRequest, callbacks: StreamCallbacks): Promise<void>;
+}
+declare class MockProvider implements LLMProvider {
+    readonly name = "mock";
+    private mockContinue;
+    private mockRewrite;
+    chat(request: LLMRequest): Promise<{
+        content: string;
+        usage?: LLMUsage;
+    }>;
+    stream(request: LLMRequest, callbacks: StreamCallbacks): Promise<void>;
+}
+interface PresetProvider {
+    id: string;
+    name: string;
+    baseURL: string;
+    defaultModel: string;
+    docs?: string;
+}
+declare const PRESET_PROVIDERS: PresetProvider[];
+declare function createProvider(presetId: string, apiKey: string, model?: string): LLMProvider;
+
+interface LoadResult {
+    optionsLoaded: number;
+    presetsLoaded: number;
+    errors: string[];
+}
+/**
+ * 从 JSON 对象加载单个节点选项 KB
+ */
+declare function loadKBFromJSON(engine: GWEEngine, kb: NodeOptionKB): void;
+/**
+ * 加载所有内置 KB 数据到引擎
+ */
+declare function loadAllKB(engine: GWEEngine): LoadResult;
+/**
+ * 快速创建一个已加载所有内置知识库的引擎实例
+ */
+declare function createEngineWithKB(provider?: ConstructorParameters<typeof GWEEngine>[0]): {
+    engine: GWEEngine;
+    result: LoadResult;
+};
+
+/**
+ * 对文本执行全面质量检查
+ *
+ * @param text 待检查文本
+ * @param context 写作上下文（书籍/章节/角色等数据）
+ * @param mergedConfig 合并后的运行时配置
+ * @returns CheckResult 包含综合得分、雷达分、违规项、统计信息
+ */
+declare function check(text: string, _context: WritingContext | null, mergedConfig: MergedConfig): CheckResult;
+
+interface AnchorDetectionResult {
+    /** 检测到的锚点总数 */
+    count: number;
+    /** 质量加权后的有效锚点数（套路反应0.3倍，生理反应1.5倍） */
+    weightedCount: number;
+    /** 锚点在文本中的起始位置列表 */
+    positions: number[];
+    /** 按锚点类型分类的统计 */
+    types: Record<string, number>;
+    /** 按质量分级的统计：套路/普通/高质量 */
+    quality: Record<string, number>;
+    /** 检测到的锚点文本片段列表 */
+    matches: string[];
+}
+/**
+ * 检测文本中的身体锚点
+ * 锚点定义：身体部位词 + (0~MAX_ANCHOR_GAP个字符内) 感官动词或动作动词
+ *
+ * @param text 待检测文本
+ * @param vocab 合并后的词库（含bodyParts, sensoryVerbs, actionVerbs）
+ * @returns AnchorDetectionResult
+ */
+declare function detectAnchors(text: string, vocab: MergedVocabulary): AnchorDetectionResult;
+/**
+ * 计算锚点密度（每千字锚点数）
+ */
+declare function calculateAnchorDensity(count: number, totalChars: number): number;
+/**
+ * 计算锚点间最大间隔（字数）
+ */
+declare function calculateMaxAnchorGap(positions: number[], totalChars: number): number;
+
+interface FillerDetectionResult {
+    /** 检测到的填充词总数 */
+    count: number;
+    /** 包含填充词的句子列表 */
+    sentences: string[];
+    /** 填充词在文本中的位置列表 */
+    positions: number[];
+    /** 破折号"——"出现次数 */
+    dashCount: number;
+    /** 省略号"……"出现次数 */
+    ellipsisCount: number;
+    /** 重复对话标签信息 */
+    repeatedTags: Array<{
+        tag: string;
+        count: number;
+        positions: number[];
+    }>;
+    /** 检测到的填充词详情（词+位置） */
+    fillerDetails: Array<{
+        word: string;
+        position: number;
+    }>;
+}
+/**
+ * 检测文本中的填充词和相关问题
+ *
+ * @param text 待检测文本
+ * @param vocab 合并后的词库
+ * @param thresholds 检测阈值（用于对话标签重复判断）
+ * @returns FillerDetectionResult
+ */
+declare function detectFillers(text: string, vocab: MergedVocabulary, thresholds: Thresholds): FillerDetectionResult;
+/**
+ * 计算每千字填充词密度
+ */
+declare function calculateFillerDensity(count: number, totalChars: number): number;
+
+/** 雷达评分计算所需的统计信息 */
+interface RadarInput {
+    text: string;
+    stats: TextStats;
+    mergedConfig: MergedConfig;
+}
+/**
+ * 计算7维雷达评分（V3追读力增强版）
+ *
+ * 维度说明：
+ * - bodyReaction: 基于锚点密度（身体反应描写丰富度）
+ * - sensorySignal: 基于五感词汇出现次数和覆盖面
+ * - action: 基于动作动词密度和对话穿插
+ * - emotion: 基于情感词和身体反应表达
+ * - infoAdvance: 基于新信息点（名词/专有名词首次出现）
+ * - twistFrequency: V3新增：转折/反咬词密度，衡量信息反转频率
+ * - hookStrength: V3新增：章末钩子强度，衡量结尾追读力
+ *
+ * 每个维度0-100分，使用radar_weights做权重调整（乘法系数）
+ */
+declare function calculateRadar(input: RadarInput): RadarScores;
+/**
+ * 计算雷达综合得分（加权平均）
+ */
+declare function calculateScore(radar: RadarScores): number;
+/**
+ * 计算带自定义权重的综合得分
+ */
+declare function calculateWeightedScore(radar: RadarScores, weights: Partial<RadarWeights>): number;
+/** 统计五感词汇出现次数 */
+declare function countSensoryMentions(text: string): Record<string, number>;
+
+/**
+ * 验证当前选项选择是否合法
+ * @param selections 用户选择的节点->选项映射
+ * @param loadedOptions 已加载的选项KB数据（如果不传则从全局注册表取）
+ * @returns ValidationResult 包含conflicts和missingDeps列表
+ */
+declare function validate(selections: Record<NodeId, OptionId>, loadedOptions?: Map<OptionId, NodeOptionKB>): ValidationResult;
+/**
+ * 格式化验证结果为人类可读字符串（用于UI提示）
+ */
+declare function formatValidationResult(result: ValidationResult): string;
+/**
+ * 快速检查：某个optionId是否可以安全选中
+ * 返回true表示无冲突且依赖满足
+ */
+declare function canSelectOption(optionId: OptionId, selections: Record<NodeId, OptionId>, loadedOptions?: Map<OptionId, NodeOptionKB>): {
+    canSelect: boolean;
+    reason?: string;
+};
+
+interface MergeOptions {
+    /** 节点选择集 */
+    selections: Record<NodeId, OptionId>;
+    /** 已加载的选项KB数据 */
+    loadedOptions: Map<OptionId, NodeOptionKB>;
+    /** 预设包（可选） */
+    preset?: Preset | null;
+    /** 用户自定义覆盖 */
+    userOverrides?: UserOverrides;
+    /** 从文件加载的基础词库（覆盖硬编码BASE_VOCAB） */
+    baseVocabOverride?: Required<NonNullable<NodeOptionKB['vocabulary']>>['add'] | null;
+}
+/**
+ * 合并所有配置层，生成最终运行时配置
+ * 优先级（从低到高）：
+ *   1. 引擎内置默认值
+ *   2. 基础词库
+ *   3. 词库类节点选项（vocab.add追加，vocab.remove删除）
+ *   4. 风格/规则节点选项的threshold_overrides和radar_weights
+ *   5. 预设包extra_vocab和extra_prompt
+ *   6. 用户自定义词库追加
+ *   7. 用户自定义阈值覆盖
+ */
+declare function mergeConfig(options: MergeOptions): MergedConfig;
+/**
+ * 深拷贝一个MergedConfig（主要用于测试或快照）
+ */
+declare function cloneMergedConfig(config: MergedConfig): MergedConfig;
+
+type WriteTask = 'continue' | 'rewrite' | 'review' | 'polish' | 'expand' | 'compress' | 'outline' | 'dialog' | 'generate';
+interface BuildPromptOptions {
+    /** 当前任务类型 */
+    task: WriteTask;
+    /** 写作上下文 */
+    context: WritingContext | null;
+    /** 合并后的配置 */
+    mergedConfig: MergedConfig;
+    /** 预设包（可选） */
+    preset?: Preset | null;
+    /** 用户选择的NodeId->OptionId映射 */
+    selections?: Record<NodeId, OptionId>;
+    /** 自定义基础提示词（覆盖内置BASE_PROMPT） */
+    basePrompt?: string;
+    /** 用户自由文本自定义规则（直接拼接到system prompt） */
+    userCustomPrompt?: string;
+}
+/**
+ * 构建System Prompt（7层拼装）
+ *
+ * 拼装顺序：
+ * [1] 通用基础提示词（base-prompt）
+ * [2] 所有选中NodeOption的system_prompt（按节点顺序拼接，用---分隔）
+ * [3] 预设包的extra_prompt（如果有）
+ * [4] 用户自定义提示词（mergedConfig里如果有）
+ * [5] 上下文注入（书籍信息+前情摘要+角色卡+关系网+状态追踪）
+ * [6] 所有选中NodeOption的constraints（拼成"禁止/要求"列表）
+ * [7] 任务指令（根据task参数生成）
+ */
+declare function buildSystemPrompt(options: BuildPromptOptions): string;
+interface BuildUserMessageOptions {
+    task: WriteTask;
+    context: WritingContext | null;
+    /** 附加参数（如选中文字、额外指令等） */
+    params?: {
+        /** 选中的文本（用于rewrite/polish/expand/compress） */
+        selectedText?: string;
+        /** 光标前的上文内容 */
+        precedingText?: string;
+        /** 光标的后文内容 */
+        followingText?: string;
+        /** 用户额外的指令 */
+        userInstruction?: string;
+        /** 大纲生成的提示/要求 */
+        outlinePrompt?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * 构建User Message（发送给AI的用户侧消息）
+ */
+declare function buildUserMessage(options: BuildUserMessageOptions): string;
+
+/**
+ * 注册一个新节点（通常用于插件扩展）
+ * @param def 节点定义
+ * @throws 如果节点ID已存在则抛出错误
+ */
+declare function registerNode(def: NodeDefinition): void;
+/**
+ * 注册一个节点选项（从.kb.json文件加载）
+ * @param kb 选项KB数据
+ * @throws 如果选项所属节点不存在则抛出错误
+ */
+declare function registerNodeOption(kb: NodeOptionKB): void;
+/**
+ * 获取节点定义
+ * @param id 节点ID
+ */
+declare function getNode(id: NodeId): NodeDefinition | undefined;
+/**
+ * 获取已加载的节点选项KB数据
+ * @param optionId 选项ID
+ */
+declare function getNodeOption(optionId: OptionId): NodeOptionKB | undefined;
+/**
+ * 获取所有已注册的节点定义
+ * @param category 可选分类过滤
+ */
+declare function getAllNodes(category?: NodeCategory): NodeDefinition[];
+/**
+ * 获取所有已注册选项的数量
+ */
+declare function getRegisteredOptionCount(): number;
+/**
+ * 获取默认选项选择集
+ * 对每个必选节点使用defaultOptionId，非必选节点不选
+ */
+declare function getDefaultSelections(): Partial<Record<NodeId, OptionId>>;
+/**
+ * 获取完整的默认选择（包括非必选节点，也使用默认值）
+ */
+declare function getDefaultSelectionsFull(): Record<NodeId, OptionId>;
+/**
+ * 按分类获取节点
+ */
+declare function getNodesByCategory(category: NodeCategory): NodeDefinition[];
+/**
+ * 验证一个selections对象是否完整（所有必选节点都有选择）
+ */
+declare function validateSelectionsComplete(selections: Partial<Record<NodeId, OptionId>>): {
+    complete: boolean;
+    missingNodes: NodeId[];
+};
+/**
+ * 重置注册表（主要用于测试）
+ */
+declare function _resetRegistry(): void;
+
+export { type AnchorDetectionResult, type BookMeta, type BuildPromptOptions, type BuildUserMessageOptions, type CharacterRelationship, type ChatMessage, type ChatRole, type CheckResult, type ConflictInfo, type CustomRule, DEFAULT_RADAR_WEIGHTS, DEFAULT_THRESHOLDS, type DependencyInfo, type EngineConfig, type EngineEvent, type EngineEventListener, type EngineEventType, type FillerDetectionResult, type Chapter as GWEChapter, type Character as GWECharacter, GWEEngine, type Setting as GWESetting, type Subplot as GWESubplot, type Volume as GWEVolume, type LLMProvider, type LLMRequest, type LLMUsage, type LoadResult, type MergeOptions, type MergedConfig, type MergedVocabulary, MockProvider, type NodeCatalog, type NodeCategory, type NodeDefinition, type NodeId, type NodeOptionKB, type OpenAICompatibleConfig, OpenAICompatibleProvider, type OptionId, PRESET_PROVIDERS, type Preset, type PresetProvider, type RadarInput, type RadarScores, type RadarWeights, type RuleViolation, type StreamCallbacks, type TaskType, type TextSelection, type TextStats, type Thresholds, type UserOverrides, type ValidationResult, type WriteTask, type WritingContext, _resetRegistry, buildSystemPrompt, buildUserMessage, calculateAnchorDensity, calculateFillerDensity, calculateMaxAnchorGap, calculateRadar, calculateScore, calculateWeightedScore, canSelectOption, check, cloneMergedConfig, countSensoryMentions, createEngineWithKB, createProvider, detectAnchors, detectFillers, formatValidationResult, getAllNodes, getDefaultSelections, getDefaultSelectionsFull, getNode, getNodeOption, getNodesByCategory, getRegisteredOptionCount, loadAllKB, loadKBFromJSON, mergeConfig, registerNode, registerNodeOption, validate, validateSelectionsComplete };