fast-tavern 0.1.4 → 0.1.6

package/README.md

@@ -21,6 +21,7 @@ fast-tavern 是一个**与框架无关**的“提示词组装与调试引擎（p
 - **世界书触发与注入**：`always/keyword/vector`（vector 通过 hook）；支持概率与递归控制
 - **正则脚本**：对齐 `RegexScriptData`（targets/view/trim/{{match}}/macroMode/minDepth/maxDepth）
 - **宏与变量**：宏保持简单；变量对齐 `local/global` 且值为 `any`
+- **旧格式包装入口**：`buildPromptFromSillyTavern`（自动把 SillyTavern 旧结构转换为新格式后执行）
 - **输出多阶段结果**：`stages.tagged/internal/output/perItem`
 
 ### system role 策略
@@ -117,6 +118,30 @@ console.log(result.stages.output.afterPostRegex); // 最终输出
 console.log(result.variables.local);
 ```
 
+### 旧酒馆格式直接调用（包装入口）
+
+```ts
+import { buildPromptFromSillyTavern } from 'fast-tavern';
+
+const result = buildPromptFromSillyTavern({
+  preset: legacyPresetSettings, // 旧 ST preset/settings
+  character: legacyCharacter,   // 可选，旧 ST character
+  globals: {
+    worldBooks: legacyWorldbooks,
+    regexScripts: legacyRegexes
+  },
+  history: legacyChat,
+  view: 'model',
+  outputFormat: 'openai'
+});
+```
+
+如果你只想做转换，不马上构建，也可单独调用：
+
+- `convertPresetFromSillyTavern` / `convertWorldBookFromSillyTavern`
+- `convertRegexFromSillyTavern` / `convertCharacterFromSillyTavern` / `convertHistoryFromSillyTavern`
+
+
 ## 文档
 
 - **格式与组装流程（详细）**：[`docs/FORMAT_ZH.md`](docs/FORMAT_ZH.md)