企业官网建设流程全解析

SillyTavern终极脚本指南：3步构建你的AI对话自动化工作流

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern

还在手动重复执行相同的聊天操作吗？SillyTavern的脚本系统让你告别繁琐操作，实现真正的AI对话自动化。作为一款专为高级用户设计的LLM前端，SillyTavern提供了完整的脚本编写能力，从基础宏替换到高级STscript命令，助你打造个性化的AI交互工作流。本文将深入解析SillyTavern的脚本系统，带你从入门到精通，掌握AI对话自动化的核心技巧。

🚀 为什么你需要掌握SillyTavern脚本系统？

想象一下这样的场景：每天打开SillyTavern，你需要手动切换API、设置指令模式、调整上下文、启用扩展、设置背景和角色表情……这一系列重复操作不仅耗时，还容易出错。SillyTavern的脚本系统正是为了解决这些问题而生。

核心价值：

• 时间节省：自动化重复性任务，专注创意对话
• 一致性保证：确保每次会话都按预设流程进行
• 复杂工作流：实现多步骤、条件判断的智能对话
• 个性化体验：打造完全符合你需求的AI交互环境

📁 项目结构与核心文件

在深入了解脚本功能前，先看看SillyTavern的脚本系统架构：

核心源码路径：

• 宏系统核心：public/scripts/macros/
• STscript命令系统：public/scripts/slash-commands/
• 扩展系统：public/scripts/extensions/
• 配置文件目录：default/content/presets/

SillyTavern的脚本系统就像一间井然有序的教室，每个组件都有其特定位置和功能

🛠️ 第一步：掌握宏系统基础

宏是SillyTavern中最基础的文本替换机制，使用双花括号语法{{macro_name}}。系统内置了丰富的宏变量，涵盖时间、聊天状态、系统信息等多个维度。

时间与日期宏

// 获取当前时间和日期 const currentTime = "现在是{{time}}，日期是{{date}}"; // 输出: "现在是2:30 PM，日期是2025年9月4日" // 国际化时间格式 const isoTime = "ISO时间: {{isotime}}, ISO日期: {{isodate}}"; // 输出: "ISO时间: 14:30, ISO日期: 2025-09-04" // 星期几 const weekday = "今天是{{weekday}}"; // 输出: "今天是星期三"

聊天状态检测宏

// 消息历史访问 const lastMsg = "最后消息: {{lastMessage}}"; const lastUserMsg = "用户最后说: {{lastUserMessage}}"; const lastCharMsg = "角色最后说: {{lastCharMessage}}"; // 系统状态信息 const systemInfo = `设备类型: {{isMobile}}, 最大上下文: {{maxPrompt}}`;

自定义宏注册

在public/scripts/macros/definitions/core-macros.js中，你可以看到宏系统的核心实现。注册自定义宏非常简单：

// 注册一个简单的问候宏 MacrosParser.registerMacro('greeting', () => { const hour = new Date().getHours(); if (hour < 12) return '早上好'; if (hour < 18) return '下午好'; return '晚上好'; }, '返回基于时间的问候语'); // 使用自定义宏 const message = "{{greeting}}，有什么可以帮助您的吗？"; // 输出: "下午好，有什么可以帮助您的吗？"

通过宏系统控制角色表情变化，让AI对话更加生动有趣

⚡ 第二步：精通STscript命令系统

STscript是SillyTavern的强大脚本语言，通过斜杠命令(/command)执行各种操作。这些命令可以直接在聊天界面输入，也可以通过脚本文件批量执行。

基础命令操作

// API连接管理 /api openai // 切换到OpenAI API /api textgenerationwebui // 切换到本地模型 // 聊天会话管理 /renamechat "重要对话记录" // 重命名当前聊天 /delchat // 删除当前聊天 /tempchat // 创建临时聊天会话 // 角色控制 /dupe // 复制当前角色 /char-find "助手" tag=helpful // 查找带有特定标签的角色

管道操作和条件执行

STscript支持Unix风格的管道操作和条件逻辑，这是其强大功能的核心：

// 管道传递结果 /getchatname | /renamechat "备份_{{pipe}}" // 条件执行示例 /extension-state Summarize | if {{pipe}} == "true" { /extension-disable Summarize } else { /extension-enable Summarize } // 复杂条件判断 /char-find "AI助手" | if {{pipe}} != "" { /say 找到助手角色: {{pipe}} } else { /say 未找到指定角色 }

扩展系统集成

SillyTavern的扩展系统可以通过脚本完全控制，实现功能模块的动态管理：

// 扩展管理命令 /extension-enable Summarize reload=true /extension-disable SillyTavern-LALib /extension-toggle Backgrounds // 检查扩展状态 /extension-state Summarize /extension-exists Character-Expressions // 批量扩展操作 /extension-enable Summarize,Backgrounds,World-Info

通过脚本动态设置聊天背景，创造沉浸式的对话环境

🔄 第三步：构建自动化工作流

自动化对话启动脚本

下面是一个完整的自动化对话示例，展示如何组合使用各种脚本功能：

// 自动化对话启动脚本 /api openai quiet=true /instruct creative /context balanced /bg "default/content/backgrounds/japan classroom.jpg" // 设置初始提示 /say {{greeting}}！我准备好帮助您解答任何问题了。 // 自动启用相关扩展 /extension-enable Summarize /extension-enable Prompt-Manager // 记录启动日志 /append-note "会话开始于{{isotime}}，使用OpenAI API" // 设置角色表情 /set-expression curiosity

批量角色处理脚本

// 批量角色处理 /char-find --all | foreach { /loadchar {{pipe}} /say 你好 {{char}}，欢迎加入群聊！ } // 定时任务模拟 /set-interval 300 { /check-messages | if {{pipe}} > 0 { /notify "新消息到达" } }

错误处理和重试机制

// 优雅的错误处理 /try { /api openai /say API连接成功！ } catch { /api textgenerationwebui /say 备用API已启用 /append-note "主API在{{isotime}}失败" }

🎯 高级技巧与最佳实践

1. 模块化脚本设计

将常用功能封装为可重用的脚本模块：

// 保存在 default/content/presets/ 目录下 // startup.stscript /api {{api_provider}} /instruct {{instruct_mode}} /context {{context_mode}} /extension-enable {{extensions}} // 使用方式 /load-script startup.stscript api_provider=openai instruct_mode=creative

2. 性能优化策略

1. 宏缓存策略：对重复使用的宏结果进行缓存
2. 批量操作：使用管道减少界面刷新次数
3. 异步执行：对耗时操作使用异步避免阻塞
4. 资源清理：及时清理不再需要的监听器和定时器

// 优化后的脚本示例 /quiet { /api openai /instruct creative /context balanced /extension-enable Summarize,Backgrounds,World-Info } /say 系统初始化完成，所有功能就绪！

3. 调试和故障排除

STscript提供了丰富的调试工具，帮助你在开发过程中快速定位问题：

// 调试模式启用 /debug on // 变量检查 /var-list /var-get "lastResponse" // 执行跟踪 /trace /api openai | /instruct creative // 性能分析 /profile { /generate-long-response "请详细说明..." }

📊 实战案例：智能客服工作流

让我们看一个实际的智能客服工作流示例：

// 智能客服工作流脚本 /api openai model="gpt-4" /instruct professional /context detailed // 设置客服背景和表情 /bg "default/content/backgrounds/royal.jpg" /set-expression neutral // 启用必要扩展 /extension-enable Summarize,Quick-Reply,Memory // 初始化对话 /say 您好！我是{{char}}，很高兴为您服务。 /say 请告诉我您需要什么帮助？ // 设置自动回复规则 /auto-reply { if {{lastUserMessage}} contains "退款" { /say 关于退款问题，请提供订单号... } else if {{lastUserMessage}} contains "投诉" { /say 非常抱歉给您带来不便... } else { /say 我理解您的问题，让我为您查找相关信息... } } // 记录会话信息 /append-note "客服会话开始于{{isotime}}，客户IP: {{userIP}}"

🚀 开始你的自动化之旅

现在你已经掌握了SillyTavern脚本系统的核心技能，是时候开始实践了：

1. 从简单开始：先尝试使用内置宏和基础命令
2. 逐步复杂化：添加条件判断和循环逻辑
3. 模块化设计：将常用功能封装为可重用脚本
4. 测试优化：使用调试工具确保脚本稳定运行

核心源码路径参考：

• 宏系统核心：public/scripts/macros/
• STscript命令：public/scripts/slash-commands.js
• 扩展系统：public/scripts/extensions/
• 配置文件：default/content/settings.json

通过脚本系统，你可以让AI角色展现各种表情，创造更加丰富的对话体验

SillyTavern的脚本系统为高级用户提供了前所未有的控制能力。无论你是需要简单的文本替换，还是复杂的自动化工作流，这个系统都能满足你的需求。开始探索吧，让你的AI对话体验达到新的高度！

记住，最好的学习方式就是实践。从简单的宏开始，逐步尝试更复杂的STscript命令，最终构建出完全符合你需求的自动化对话系统。SillyTavern的强大脚本能力，等待你去发掘和创造！

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern