🎨 优化扩展模块，完成ai接入和对话功能

2026-02-12 23:12:28 +08:00
parent 4e611d3a5e
commit 572f3aa15b
779 changed files with 194400 additions and 3136 deletions
--- a/data/st-core-scripts/scripts/macros/definitions/instruct-macros.js
+++ b/data/st-core-scripts/scripts/macros/definitions/instruct-macros.js
@@ -0,0 +1,76 @@
+import { MacroRegistry, MacroCategory } from '../engine/MacroRegistry.js';
+import { power_user } from '../../power-user.js';
+
+/**
+ * Registers instruct-mode related {{...}} macros (instruct* and system
+ * prompt/context macros) in the MacroRegistry.
+ */
+export function registerInstructMacros() {
+    /**
+     * Helper to register macros that just expose a value from power_user.instruct.
+     * The first name is the primary, subsequent names become visible aliases.
+     * @param {string[]} names - First is primary, rest are aliases.
+     * @param {() => string} getValue
+     * @param {() => boolean} isEnabled
+     * @param {string} description
+     * @param {string} [category=MacroCategory.PROMPTS]
+     */
+    function registerSimple(names, getValue, isEnabled, description, category = MacroCategory.PROMPTS) {
+        const [primary, ...aliasNames] = names;
+        const aliases = aliasNames.map(alias => ({ alias }));
+
+        MacroRegistry.registerMacro(primary, {
+            category,
+            description,
+            aliases: aliases.length > 0 ? aliases : undefined,
+            handler: () => (isEnabled() ? (getValue() ?? '') : ''),
+        });
+    }
+
+    const instEnabled = () => !!power_user.instruct.enabled;
+    const sysEnabled = () => !!power_user.sysprompt.enabled;
+
+    // Instruct template macros
+    registerSimple(['instructStoryStringPrefix'], () => power_user.instruct.story_string_prefix, instEnabled, 'Instruct story string prefix.');
+    registerSimple(['instructStoryStringSuffix'], () => power_user.instruct.story_string_suffix, instEnabled, 'Instruct story string suffix.');
+
+    registerSimple(['instructUserPrefix', 'instructInput'], () => power_user.instruct.input_sequence, instEnabled, 'Instruct input / user prefix sequence.');
+    registerSimple(['instructUserSuffix'], () => power_user.instruct.input_suffix, instEnabled, 'Instruct input / user suffix sequence.');
+
+    registerSimple(['instructAssistantPrefix', 'instructOutput'], () => power_user.instruct.output_sequence, instEnabled, 'Instruct output / assistant prefix sequence.');
+    registerSimple(['instructAssistantSuffix', 'instructSeparator'], () => power_user.instruct.output_suffix, instEnabled, 'Instruct output / assistant suffix sequence.');
+
+    registerSimple(['instructSystemPrefix'], () => power_user.instruct.system_sequence, instEnabled, 'Instruct system prefix sequence.');
+    registerSimple(['instructSystemSuffix'], () => power_user.instruct.system_suffix, instEnabled, 'Instruct system suffix sequence.');
+
+    registerSimple(['instructFirstAssistantPrefix', 'instructFirstOutputPrefix'], () => power_user.instruct.first_output_sequence || power_user.instruct.output_sequence, instEnabled, 'Instruct first assistant / output prefix sequence');
+    registerSimple(['instructLastAssistantPrefix', 'instructLastOutputPrefix'], () => power_user.instruct.last_output_sequence || power_user.instruct.output_sequence, instEnabled, 'Instruct last assistant / output prefix sequence.');
+
+    registerSimple(['instructStop'], () => power_user.instruct.stop_sequence, instEnabled, 'Instruct stop sequence.');
+    registerSimple(['instructUserFiller'], () => power_user.instruct.user_alignment_message, instEnabled, 'Instruct user alignment filler.');
+    registerSimple(['instructSystemInstructionPrefix'], () => power_user.instruct.last_system_sequence, instEnabled, 'Instruct system instruction prefix sequence.');
+
+    registerSimple(['instructFirstUserPrefix', 'instructFirstInput'], () => power_user.instruct.first_input_sequence || power_user.instruct.input_sequence, instEnabled, 'Instruct first user / input prefix sequence.');
+    registerSimple(['instructLastUserPrefix', 'instructLastInput'], () => power_user.instruct.last_input_sequence || power_user.instruct.input_sequence, instEnabled, 'Instruct last user / input prefix sequence.');
+
+    // System prompt macros
+    registerSimple(['defaultSystemPrompt', 'instructSystem', 'instructSystemPrompt'], () => power_user.sysprompt.content, sysEnabled, 'Default system prompt.');
+
+    MacroRegistry.registerMacro('systemPrompt', {
+        category: MacroCategory.PROMPTS,
+        description: 'Active system prompt text (optionally overridden by character prompt)',
+        handler: ({ env }) => {
+            const isEnabled = !!power_user.sysprompt.enabled;
+            if (!isEnabled) return '';
+
+            if (power_user.prefer_character_prompt && env.character.charPrompt) {
+                return env.character.charPrompt;
+            }
+            return power_user.sysprompt.content ?? '';
+        },
+    });
+
+    // Context template macros
+    registerSimple(['exampleSeparator', 'chatSeparator'], () => power_user.context.example_separator, () => true, 'Separator used between example chat blocks in text completion prompts.');
+    registerSimple(['chatStart'], () => power_user.context.chat_start, () => true, 'Chat start marker used in text completion prompts.');
+}