5分钟掌握SillyTavern脚本系统：从手动聊天到AI对话自动化的终极指南
5分钟掌握SillyTavern脚本系统：从手动聊天到AI对话自动化的终极指南
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
还在为重复的聊天操作感到烦恼吗？每次都要手动切换API、设置角色表情、调整对话背景？SillyTavern的脚本系统正是为你这样的"高级用户"量身打造的AI对话自动化利器！今天，咱们就来聊聊如何用脚本让AI对话变得轻松又有趣。
什么是SillyTavern脚本系统？
简单来说，SillyTavern脚本系统就像给你的AI聊天界面装上了"智能助手"。它允许你通过编写简单的命令和脚本，自动化执行各种聊天操作。想象一下，你只需要一个命令，就能同时完成API切换、角色表情设置、背景更换等一系列操作，是不是很酷？
这个系统主要由三部分组成：
- 宏系统- 智能文本替换引擎，用
{{宏名称}}就能动态插入各种信息 - STscript命令系统- 强大的交互控制语言，通过斜杠命令执行复杂操作
- 扩展系统集成- 无缝管理各种功能扩展
快速上手：你的第一个脚本
别担心，咱们从最简单的开始。打开SillyTavern的聊天界面，在输入框中试试这些命令：
// 切换API到OpenAI /api openai // 设置角色表情为"好奇" /set-expression curiosity // 更换聊天背景 /bg "default/content/backgrounds/japan classroom.jpg"看到效果了吗？角色立刻变成了好奇的表情，背景也变成了温馨的日本教室场景。
通过
/set-expression curiosity命令，你可以让角色展现出好奇的表情
小贴士：所有脚本命令都在public/scripts/slash-commands/目录下定义，你可以随时查看源码了解每个命令的具体功能。
核心功能详解：三大自动化利器
1. 宏系统：智能文本替换
宏是SillyTavern中最实用的功能之一。它使用双花括号语法{{macro_name}}，能自动替换为相应的动态内容。
常用宏示例：
| 宏名称 | 功能描述 | 示例输出 |
|---|---|---|
{{time}} | 当前时间 | "下午2:30" |
{{date}} | 当前日期 | "2025年9月4日" |
{{char}} | 当前角色名 | "Seraphina" |
{{lastMessage}} | 最后一条消息 | "你好，有什么可以帮助你的？" |
{{weekday}} | 星期几 | "星期三" |
试试在聊天中输入："现在是{{time}}，今天是{{weekday}}"，看看会发生什么！
2. STscript命令：聊天控制大师
STscript命令系统提供了丰富的控制功能，让AI对话变得像编程一样灵活。
基础命令分类：
- API管理：
/api openai、/api textgenerationwebui - 会话管理：
/renamechat "重要对话"、/delchat、/tempchat - 角色控制：
/char-find "助手"、/dupe（复制当前角色） - 扩展控制：
/extension-enable Summarize、/extension-disable Backgrounds
管道操作是STscript的一大亮点，让你可以像Linux命令行一样串联多个操作：
// 获取当前聊天名称，然后重命名 /getchatname | /renamechat "备份_{{pipe}}" // 检查扩展状态，根据结果执行不同操作 /extension-state Summarize | if {{pipe}} == "true" { /say Summarize扩展已启用 } else { /extension-enable Summarize }3. 扩展系统：功能无限扩展
SillyTavern的扩展系统可以通过脚本完全控制。在public/scripts/extensions/目录下，你可以找到各种功能扩展：
- Summarize- 对话摘要
- Backgrounds- 背景管理
- World-Info- 世界信息
- Character-Expressions- 角色表情控制
使用/bg命令可以快速切换聊天背景，营造不同的对话氛围
实战案例：构建你的自动化对话工作流
现在，咱们来创建一个完整的自动化对话脚本。假设你想创建一个"学习助手"场景：
// 学习助手启动脚本 // 1. 设置基础环境 /api openai quiet=true /instruct creative /context balanced // 2. 创建学习氛围 /bg "default/content/backgrounds/japan classroom.jpg" /set-expression neutral // 3. 启用必要扩展 /extension-enable Summarize,World-Info // 4. 设置初始问候 /say 你好！我是你的学习助手，今天我们来一起探索新知识吧！ // 5. 记录启动信息 /append-note "学习会话开始于{{isotime}}，使用OpenAI API"保存这个脚本为learning-assistant.stscript，放在default/content/presets/目录下，以后就可以一键启动了！
进阶技巧：让脚本更智能
条件判断与循环
// 批量处理所有角色 /char-find --all | foreach { /loadchar {{pipe}} /say 欢迎{{char}}加入讨论！ /wait 2 // 等待2秒，避免过快 } // 定时检查新消息 /set-interval 60 { /check-messages | if {{pipe}} > 0 { /notify "你有{{pipe}}条新消息" } }错误处理与重试
// 优雅的错误处理 /try { /api openai /say API连接成功！ } catch { /api textgenerationwebui /say 切换到备用API /append-note "主API连接失败，{{isotime}}启用备用" }自定义宏注册
如果你想创建自己的宏，可以在public/scripts/macros/definitions/目录下添加自定义文件：
// 自定义问候宏 MacrosParser.registerMacro('greeting', () => { const hour = new Date().getHours(); if (hour < 12) return '早上好'; if (hour < 18) return '下午好'; return '晚上好'; }, '返回基于时间的问候语'); // 使用方式 /say {{greeting}}！今天过得怎么样？中性表情适合正式的学习讨论场景，通过
/set-expression neutral设置
调试技巧：快速定位问题
遇到脚本不工作？别急，试试这些调试命令：
- 启用调试模式：
/debug on- 显示详细执行信息 - 检查变量：
/var-list- 列出所有变量 - 跟踪执行：
/trace /api openai- 跟踪特定命令 - 测试宏：
/macro-debug "{{time}} {{date}}"- 查看宏展开结果
最佳实践：开发复杂脚本时，先在调试模式下测试，确认无误后再投入正式使用。
性能优化：让脚本跑得更快
- 批量操作：使用管道减少界面刷新次数
- 安静模式：在多个命令前加
/quiet { ... }避免中间提示 - 缓存策略：对重复使用的宏结果进行缓存
- 异步执行：耗时操作使用异步避免阻塞
// 优化后的脚本示例 /quiet { /api openai /instruct creative /context balanced /extension-enable Summarize,Backgrounds,World-Info } /say 系统初始化完成，所有功能就绪！安全注意事项
虽然脚本功能强大，但使用时也要注意安全：
- ❌不要在脚本中硬编码API密钥
- ✅使用环境变量存储敏感信息
- ✅定期备份重要脚本和配置
- ✅审查第三方扩展的安全性
从今天开始你的自动化之旅
SillyTavern的脚本系统为AI对话带来了无限可能。无论是简单的文本替换，还是复杂的自动化工作流，你都能找到合适的工具。
核心源码路径参考：
- 宏系统：
public/scripts/macros/ - STscript命令：
public/scripts/slash-commands/ - 扩展系统：
public/scripts/extensions/
当你成功运行第一个自动化脚本时，角色的喜悦表情就是最好的奖励
现在就去试试吧！从简单的宏开始，逐步尝试更复杂的命令组合，你会发现AI对话可以如此轻松有趣。记住，最好的学习方式就是动手实践。打开SillyTavern，输入你的第一个脚本命令，开启自动化对话的新篇章！
行动号召：今天就开始创建你的第一个自动化脚本吧！从/api openai和/set-expression curiosity开始，体验一键切换API和表情的便利。分享你的创意脚本，让我们一起探索AI对话的更多可能性！
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考