/NovelAI Settings`）。\n您还可以手动添加自己的设置文件。\n\n### 响应长度\n\n您想要为每条消息生成多少文本。请注意，NovelAI 每个响应的限制为 150 token。\n\n### 上下文大小\n\n在任何给定时间，上下文中保存了多少 token 的聊天内容。您可以使用的最大上下文大小取决于模型和您的订阅层：\n\n- Kayra（平板电脑）- 3072 token\n- 凯拉（卷轴）- 6144 token\n- Erato（Opus 独有）、Kayra（Opus）和 Clio（所有级别）- 8192 token\n\n### 序言\n\n插入聊天正上方以修改书写风格的文本。推荐的格式是短标签列表，例如“\\[风格：聊天、详细、感官]”。\n\n## 预设说明\n\n根据 NovelAI 的说法，这就是默认预设的好处。\n\n### 埃拉托\n\n- 金箭 - 优秀的全能选手。\n- Wilder - 单词选择的多样性更高，重掷之间的差异更大，更容易出错。\n- Zany Scribe - 避免错误和重复。优先考虑更复杂的单词。\n- 火龙果 - 语言多样且复杂，几乎没有重复。错误和矛盾更加频繁。\n- Shosetsu - 专为日语写作而设计。也适用于英语。\n\n### 凯拉\n\n- Asper - 用于创意写作。期待意想不到的曲折。\n- 无忧无虑——优秀的全能选手\n- Fresh-Coffee - 让事情步入正轨。手柄指导良好。\n- Pro_Writer - 模仿畅销小说的节奏和感觉\n- Stelenes - 更有可能选择合理的替代方案。重试的多样性。\n- Tea_Time - 当它开始时它会变得很好。\n- Writers-Daemon - 极其富有想象力，有时甚至太多。\n\n### 克里奥\n\n- Edgewise - 很好地处理各种生成样式\n- 新鲜咖啡 - 让事情步入正轨。\n- 长按 - 用于创意散文。\n- Talker Chat - 专为聊天风格生成而设计。\n- Vingt-Un - 一个良好的全能默认值，偏向于散文。\n\n## 将 NovelAI 与 SillyTavern 结合使用的提示和常见问题解答\n\n从另一个 ST 后端 API 切换到 NovelAI 时，会出现很多常见问题和疑问。差异取决于模型的训练目的。您很可能使用过 OpenAI 或 Anthropic 模型（或类似的本地模型），这些模型是围绕遵循用户的指示构建的。 NovelAI 的模型完全围绕文本完成而构建：NAI 的模型尝试继续传入的提示词，而不是将您的输入作为消息并制定响应。由于这种差异，许多适用于其他 API 的技巧和常识不适用于 NAI。\n\n### 调整 NovelAI 的设置\n\n在高级格式（A 图标）下：\n\n- 将“上下文模板”设置为“NovelAI”\n- 将“Tokenizer”设置为“最佳匹配”\n- 选中“始终将角色的名称添加到提示词”\n- 选中“折叠连续换行符”\n- 取消选中“指令模式”下的“启用”框\n\n在“用户设置”下（有齿轮的人）\n\n- 打开“滑动切换回复”（不是 NAI 特定的，但它非常有用，您应该这样做）\n\n### 为 NovelAI 构建/调整角色卡\n\n为了针对 NovelAI 优化角色卡，有几种推荐的方法来编写角色的描述：散文和属性。\n\n散文太简单了，感觉不太行得通：“西尔菲德是一位看起来很年轻但实际上已经有 900 岁的仙女。她身材矮小，长长的白发在她编成的侧马尾辫中逐渐变成绿色，翠绿的眼睛形状像十字架。\\[...]”不，真的，就是这样。只需用普通句子写出角色的外观、行为等，人工智能就会识别它。\n\n如果您不相信自己的写作能力或者想要一种更结构化的方法来完成它，您可以使用 NovelAI 训练数据中存在的属性方法。这是不同类型的角色特征的简单列表。以下是经过 NovelAI 模型测试有效的可能属性列表：\n\n```\nName:\nAKA:\nType: character\nSetting:\nNationality:\nSpecies:\nGender:\nAge:\nHeight:\nWeight:\nAppearance:\nClothing:\nAttire:\nPersonality:\nMind:\nMental:\nLikes:\nDislikes:\nSexuality:\nSpeech:\nVoice:\nAbilities:\nSkills:\nQuote:\nAffiliation:\nOccupation:\nReputation:\nSecret:\nFamily:\nAllies:\nEnemies:\nBackground:\nDescription:\nAttributes:\n```\n\n“Type: 角色”是用来告诉 AI 这是描述一个角色（而不是位置、物体或其他类型的事物）。其余属性是可选的，有些是多余的（例如，Personality、Mind 和 Mental 的含义基本相同），但这些属性已经过测试并且可以与 NovelAI 的模型配合良好。填写与您的角色相关的内容。属性应以小写形式书写，并用逗号分隔，不需要在单词两边加上引号。例如：\n\n```\nSkills: lockpicking, stealth, running away very fast\n```\n\n推荐使用这些方法是因为它们存在于 NovelAI 的训练数据中，因此它们特别适合模型。\n\n#### 示例卡\n\n这里有几个为 NovelAI 制作的示例卡片，展示了专门为 NovelAI 创建卡片的不同方法。第一张卡“Valka”使用属性方法进行角色描述，而第二张卡“Eris”则使用散文描述，并带有大量示例对话。\n\n\n\n[](/docs/sillytavern/static/Valka.png)\n\n[](/docs/sillytavern/static/Eris.png)\n\n
\n\n#### 不该做什么\n\n大多数现有的角色卡格式都不适合 NovelAI。他们会给你一些结果，甚至一些好的结果，但他们有很多问题。 W++ 是最大的罪犯之一，它与 NovelAI 模型所训练的任何内容都不相同，并且它不断使用括号/大括号/引号消耗了大量的 token，使卡片的大小膨胀而没有真正的好处。\n\n在未融入 NovelAI 的现有格式中，AliChat 是最有可能发挥作用的一种，因为它依赖于使用示例消息来同时获取有关角色及其语音的信息，并采用您希望 AI 输出的消息类型的格式。\n\n对于大多数其他格式，由于它们通常是列出特定角色的不同特征的方法，因此可以相当直接地将它们转换为属性方法。\n\n### 我应该使用哪个模块？\n\n可能没有模块。如果您想让角色以更华丽的方式说话，散文增强器会很有用，但要注意不要做得太过分。文本冒险对于文本冒险风格的卡片/故事可能很有用。\n\n### 不是指令模块？\n\n您可以在需要时调用 Instruct 模块。在消息中创建换行符，并将说明放在大括号中，如下所示： `{ CharName is offended by that seemingly innocuous statement }` （空格是 *必填* 文本和括号之间）。这样做会在短时间内自动将人工智能切换到指令模块。您不想一直使用“指导”模块，因为当您需要强烈引导 AI 朝特定方向发展时，它往往会比其他模块产生更少的创意输出。\n\n### 为什么我的回复总是被打断？\n\nNovelAI 将响应长度限制为总计约 150 token，即使您将滑块设置得更高。当它达到滑块中 token 的数量或 150（以较低者为准）时，它将再生成最多 20 个 token，寻找停止序列或句子结尾，因此响应的有效限制为 170 token，此时它将停止，导致其中断。\n\n如果中断，您可以选择继续选项（在文本框左侧的三行菜单中）让角色继续响应。\n\n如果您经常希望响应长度超过 170 token，您可以像这样解决该限制：\n\n- 将响应长度保持在 150 token。\n- 在“高级格式化”下，启用“自动继续”。\n- 将“目标长度”设置为所需的长度。\n\n这会将多代链接在一起，为您提供更长的消息，但如果模型决定停止，则不能保证回复将是所需长度的 100%。\n\n### 如何让机器人写出更长的回复？\n\n阅读上面有关回复被切断的内容。这将有助于确保响应不会因达到生成长度的限制而过早中断。\n\n如果你的回答没有被切断但仍然太短，那么你可能正在处理“垃圾输入，垃圾输出” - 如果你给模型提供了错误的例子，它会产生错误的输出。如果角色卡没有示例对话或简短的示例对话，并且您发送给机器人的消息很短，则模型会接受这一点，将其视为可接受的做事方式，并且响应也会很短。因此，请向机器人编写更长的示例对话和更长的消息。 （您始终可以使用 NovelAI 为您编写一些示例对话，而不是自己编写。）\n\n### 如何让机器人停止为我说话？\n\n- 检查角色卡的第一条消息和示例对话是否不包括角色为您采取行动 - 如果包括，则重写它们以消除它为您采取行动\n- 确保选中“始终将角色的名称添加到提示词”\n- 确保您当前使用与其余聊天相同的用户用户人设。如果您更改了用户用户人设并且没有更改回来（或者没有将用户人设锁定到该聊天），则停止为您生成的常规规则将失败\n- 将 \\[\"\\n{{user}}:\"] 添加到自定义停止字符串（应该不是必需的，但有时会有所帮助）\n\n### 为什么我的角色没有响应？\n\n造成这种情况的原因有很多，所以我们需要检查以下几个地方：\n\n- 确保在高级格式中选中“始终将角色的名称添加到提示词”\n- 检查以确保 API 没有出现任何错误。虽然您可以通过 NAI 免费试用版使用 SillyTavern，但一旦试用完毕，您就会收到错误消息\n- 检查“自定义停止字符串”中的内容 - 如果这些字符串是在响应开始时生成的，则它可能会被过早切断\n\n### 作者注释应该如何使用？\n\n一般来说，你可能不应该这样做。它被插入到非常接近上下文末尾的位置，并且使用 NAI 的模型，它经常压倒上下文中的其他所有内容。它主要是来自旧的、较弱的模型的产物，在这些模型中它是更必要的。\n\n### 如何进行场景中断/时间跳跃？\n\n将以下内容作为系统消息或放在下一条消息开头的换行符上：\n\n```\n***\n[ 2 days later ]\n```\n\n然后将其余的消息放在下一行。括号内的文本可以是时间跳跃、新位置或其他任何内容。 “\\*\\*\\*”（搞笑地命名为“dinkus”）告诉人工智能场景已经改变，括号内的文本提供了更多背景信息。\n\n### AI 不断重复特定的单词/短语，我该怎么办？\n\n如上所述，您可以将重复惩罚滑块再推高一点，但推得太远可能会导致输出不连贯。\n要更彻底地解决问题，请返回上下文，尤其是最近的消息，并删除重复的单词/短语。将其从上下文中删除可以让人工智能一开始就没有理由开始说它。\n",
"searchText": "NovelAI NovelAI 是一项付费订阅服务，允许每月无限制地访问其高质量的内部文本生成、图像生成和文本转语音模型。在此注册帐户以开始： https://novelai.net/ 你只会得到 50代 免费评估模型。当 “不符合此型号的条件” 出现错误，这意味着您已经过了试用期，需要订阅付费计划。 API密钥 要获取您的 NovelAI API 密钥，请按照以下步骤操作： 选择左侧边栏顶部的齿轮图标。 选择“用户设置”下的“帐户”。 选择“获取持久 API 令牌”。 选择复制图标将 NovelAI API token 复制到剪贴板。 型号 如果您有 Opus，则可以使用 Erato 模型。如果您没有 Opus，那么 Kayra 是最好的可用型号。 Clio 在平板电脑/滚动层上具有更大的上下文大小，但 Kayra 的优势通常可以弥补这一差异。 设置 带有设置的文件位于此处（SillyTavern/data//NovelAI Settings）。 您还可以手动添加自己的设置文件。 响应长度 您想要为每条消息生成多少文本。请注意，NovelAI 每个响应的限制为 150 token。 上下文大小 在任何给定时间，上下文中保存了多少 token 的聊天内容。您可以使用的最大上下文大小取决于模型和您的订阅层： Kayra（平板电脑）- 3072 token 凯拉（卷轴）- 6144 token Erato（Opus 独有）、Kayra（Opus）和 Clio（所有级别）- 8192 token 序言 插入聊天正上方以修改书写风格的文本。推荐的格式是短标签列表，例如“[风格：聊天、详细、感官]”。 预设说明 根据 NovelAI 的说法，这就是默认预设的好处。 埃拉托 金箭 - 优秀的全能选手。 Wilder - 单词选择的多样性更高，重掷之间的差异更大，更容易出错。 Zany Scribe - 避免错误和重复。优先考虑更复杂的单词。 火龙果 - 语言多样且复杂，几乎没有重复。错误和矛盾更加频繁。 Shosetsu - 专为日语写作而设计。也适用于英语。 凯拉 Asper - 用于创意写作。期待意想不到的曲折。 无忧无虑——优秀的全能选手 Fresh-Coffee - 让事情步入正轨。手柄指导良好。 Pro_Writer - 模仿畅销小说的节奏和感觉 Stelenes - 更有可能选择合理的替代方案。重试的多样性。 Tea_Time - 当它开始时它会变得很好。 Writers-Daemon - 极其富有想象力，有时甚至太多。 克里奥 Edgewise - 很好地处理各种生成样式 新鲜咖啡 - 让事情步入正轨。 长按 - 用于创意散文。 Talker Chat - 专为聊天风格生成而设计。 Vingt-Un - 一个良好的全能默认值，偏向于散文。 将 NovelAI 与 SillyTavern 结合使用的提示和常见问题解答 从另一个 ST 后端 API 切换到 NovelAI 时，会出现很多常见问题和疑问。差异取决于模型的训练目的。您很可能使用过 OpenAI 或 Anthropic 模型（或类似的本地模型），这些模型是围绕遵循用户的指示构建的。 NovelAI 的模型完全围绕文本完成而构建：NAI 的模型尝试继续传入的提示词，而不是将您的输入作为消息并制定响应。由于这种差异，许多适用于其他 API 的技巧和常识不适用于 NAI。 调整 NovelAI 的设置 在高级格式（A 图标）下： 将“上下文模板”设置为“NovelAI” 将“Tokenizer”设置为“最佳匹配” 选中“始终将角色的名称添加到提示词” 选中“折叠连续换行符” 取消选中“指令模式”下的“启用”框 在“用户设置”下（有齿轮的人） 打开“滑动切换回复”（不是 NAI 特定的，但它非常有用，您应该这样做） 为 NovelAI 构建/调整角色卡 为了针对 NovelAI 优化角色卡，有几种推荐的方法来编写角色的描述：散文和属性。 散文太简单了，感觉不太行得通：“西尔菲德是一位看起来很年轻但实际上已经有 900 岁的仙女。她身材矮小，长长的白发在她编成的侧马尾辫中逐渐变成绿色，翠绿的眼睛形状像十字架。[...]”不，真的，就是这样。只需用普通句子写出角色的外观、行为等，人工智能就会识别它。 如果您不相信自己的写作能力或者想要一种更结构化的方法来完成它，您可以使用 NovelAI 训练数据中存在的属性方法。这是不同类型的角色特征的简单列表。以下是经过 NovelAI 模型测试有效的可能属性列表： Name: AKA: Type: character Setting: Nationality: Species: Gender: Age: Height: Weight: Appearance: Clothing: Attire: Personality: Mind: Mental: Likes: Dislikes: Sexuality: Speech: Voice: Abilities: Skills: Quote: Affiliation: Occupation: Reputation: Secret: Family: Allies: Enemies: Background: Description: Attributes: “Type: 角色”是用来告诉 AI 这是描述一个角色（而不是位置、物体或其他类型的事物）。其余属性是可选的，有些是多余的（例如，Personality、Mind 和 Mental 的含义基本相同），但这些属性已经过测试并且可以与 NovelAI 的模型配合良好。填写与您的角色相关的内容。属性应以小写形式书写，并用逗号分隔，不需要在单词两边加上引号。例如： Skills: lockpicking, stealth, running away very fast 推荐使用这些方法是因为它们存在于 NovelAI 的训练数据中，因此它们特别适合模型。 示例卡 这里有几个为 NovelAI 制作的示例卡片，展示了专门为 NovelAI 创建卡片的不同方法。第一张卡“Valka”使用属性方法进行角色描述，而第二张卡“Eris”则使用散文描述，并带有大量示例对话。 不该做什么 大多数现有的角色卡格式都不适合 NovelAI。他们会给你一些结果，甚至一些好的结果，但他们有很多问题。 W++ 是最大的罪犯之一，它与 NovelAI 模型所训练的任何内容都不相同，并且它不断使用括号/大括号/引号消耗了大量的 token，使卡片的大小膨胀而没有真正的好处。 在未融入 NovelAI 的现有格式中，AliChat 是最有可能发挥作用的一种，因为它依赖于使用示例消息来同时获取有关角色及其语音的信息，并采用您希望 AI 输出的消息类型的格式。 对于大多数其他格式，由于它们通常是列出特定角色的不同特征的方法，因此可以相当直接地将它们转换为属性方法。 我应该使用哪个模块？ 可能没有模块。如果您想让角色以更华丽的方式说话，散文增强器会很有用，但要注意不要做得太过分。文本冒险对于文本冒险风格的卡片/故事可能很有用。 不是指令模块？ 您可以在需要时调用 Instruct 模块。在消息中创建换行符，并将说明放在大括号中，如下所示： { CharName is offended by that seemingly innocuous statement } （空格是 必填 文本和括号之间）。这样做会在短时间内自动将人工智能切换到指令模块。您不想一直使用“指导”模块，因为当您需要强烈引导 AI 朝特定方向发展时，它往往会比其他模块产生更少的创意输出。 为什么我的回复总是被打断？ NovelAI 将响应长度限制为总计约 150 token，即使您将滑块设置得更高。当它达到滑块中 token 的数量或 150（以较低者为准）时，它将再生成最多 20 个 token，寻找停止序列或句子结尾，因此响应的有效限制为 170 token，此时它将停止，导致其中断。 如果中断，您可以选择继续选项（在文本框左侧的三行菜单中）让角色继续响应。 如果您经常希望响应长度超过 170 token，您可以像这样解决该限制： 将响应长度保持在 150 token。 在“高级格式化”下，启用“自动继续”。 将“目标长度”设置为所需的长度。 这会将多代链接在一起，为您提供更长的消息，但如果模型决定停止，则不能保证回复将是所需长度的 100%。 如何让机器人写出更长的回复？ 阅读上面有关回复被切断的内容。这将有助于确保响应不会因达到生成长度的限制而过早中断。 如果你的回答没有被切断但仍然太短，那么你可能正在处理“垃圾输入，垃圾输出” - 如果你给模型提供了错误的例子，它会产生错误的输出。如果角色卡没有示例对话或简短的示例对话，并且您发送给机器人的消息很短，则模型会接受这一点，将其视为可接受的做事方式，并且响应也会很短。因此，请向机器人编写更长的示例对话和更长的消息。 （您始终可以使用 NovelAI 为您编写一些示例对话，而不是自己编写。） 如何让机器人停止为我说话？ 检查角色卡的第一条消息和示例对话是否不包括角色为您采取行动 - 如果包括，则重写它们以消除它为您采取行动 确保选中“始终将角色的名称添加到提示词” 确保您当前使用与其余聊天相同的用户用户人设。如果您更改了用户用户人设并且没有更改回来（或者没有将用户人设锁定到该聊天），则停止为您生成的常规规则将失败 将 [\"\\n{{user}}:\"] 添加到自定义停止字符串（应该不是必需的，但有时会有所帮助） 为什么我的角色没有响应？ 造成这种情况的原因有很多，所以我们需要检查以下几个地方： 确保在高级格式中选中“始终将角色的名称添加到提示词” 检查以确保 API 没有出现任何错误。虽然您可以通过 NAI 免费试用版使用 SillyTavern，但一旦试用完毕，您就会收到错误消息 检查“自定义停止字符串”中的内容 - 如果这些字符串是在响应开始时生成的，则它可能会被过早切断 作者注释应该如何使用？ 一般来说，你可能不应该这样做。它被插入到非常接近上下文末尾的位置，并且使用 NAI 的模型，它经常压倒上下文中的其他所有内容。它主要是来自旧的、较弱的模型的产物，在这些模型中它是更必要的。 如何进行场景中断/时间跳跃？ 将以下内容作为系统消息或放在下一条消息开头的换行符上： *** [ 2 days later ] 然后将其余的消息放在下一行。括号内的文本可以是时间跳跃、新位置或其他任何内容。 “***”（搞笑地命名为“dinkus”）告诉人工智能场景已经改变，括号内的文本提供了更多背景信息。 AI 不断重复特定的单词/短语，我该怎么办？ 如上所述，您可以将重复惩罚滑块再推高一点，但推得太远可能会导致输出不连贯。 要更彻底地解决问题，请返回上下文，尤其是最近的消息，并删除重复的单词/短语。将其从上下文中删除可以让人工智能一开始就没有理由开始说它。",
"translationStatus": "machine-draft"
},
{
"slug": "api-connections/tabbyapi",
"title": "TabbyAPI",
"group": "API_Connections",
"order": 0,
"source": "Usage/API_Connections/tabbyapi.md",
"sourceUrl": "https://docs.sillytavern.app/usage/api-connections/tabbyapi/",
"sourceSha256": "a94d75324381b74bfbe2a8d886fd5f20781741143c5a7dc78ba28cf2268bc67d",
"headings": [
{
"id": "tabbyapi",
"depth": 1,
"title": "TabbyAPI"
},
{
"id": "quickstart",
"depth": 3,
"title": "快速入门"
},
{
"id": "tabbyapi-loader",
"depth": 3,
"title": "TabbyAPI 加载器"
},
{
"id": "support",
"depth": 3,
"title": "支持"
}
],
"content": "# TabbyAPI\n\n一个基于 FastAPI 的应用程序，允许使用 Exllamav2 后端使用 LLM 生成文本，并支持 Exl2、GPTQ 和 FP16 模型。\n\n- [GitHub](https://github.com/theroyallab/tabbyAPI)\n\n### 快速入门\n\n1. 遵循 [安装说明](https://github.com/theroyallab/tabbyAPI/wiki/01.-Getting-Started) 在官方 TabbyAPI GitHub 上。\n\n2. [创建您的 config.yml](https://github.com/theroyallab/tabbyAPI/wiki/02.-Server-options) 设置模型路径、默认模型、序列长度等。如果需要，您可以忽略大多数（如果不是全部）这些设置。\n\n3. 启动 TabbyAPI。如果它有效，您应该看到类似这样的内容：\n\n \n\n4. 在 SillyTavern 中的文本补全 API 下，选择 TabbyAPI。\n\n5. 将您的 API 密钥从 TabbyAPI 终端复制到 `Tabby API key` 并确保你的 `API URL` 是正确的（应该是 `http://127.0.0.1:5000` 默认情况下）。\n\n如果一切正确，您应该在 SillyTavern 中看到类似以下内容：\n\n\n\n您现在可以使用 TabbyAPI 聊天！\n\n### TabbyAPI 加载器\n\nTabbyAPI 的开发人员创建了一个官方扩展，可以直接从 SillyTavern 加载/卸载模型。安装很简单：\n\n1. 在 SillyTavern 中，单击“扩展”选项卡并导航到“下载扩展和资产”。\n\n2. 复制 `https://raw.githubusercontent.com/theroyallab/ST-repo/main/index.json` 进入 Assets URL 并单击右侧的插件按钮。\n\n3. 你应该看到这样的东西。单击 Tabby Loader 旁边的下载按钮。\n\n \n\n4. 如果安装成功，您应该在屏幕顶部看到一条绿色的弹出消息。在扩展选项卡下，导航到 TabbyAPI Loader 并将管理密钥从 TabbyAPI 终端复制到管理密钥中。\n\n5. 单击模型选择旁边的刷新按钮。当您单击其下方的文本框时，您应该会看到模型目录中的所有模型。\n\n\n\n您现在可以直接从 SillyTavern 加载和卸载模型！\n\n### 支持\n\n还需要帮助吗？参观 [TabbyAPI GitHub](https://github.com/theroyallab/tabbyAPI) 获取开发者官方 Discord 服务器的链接以及 [阅读维基百科](https://github.com/theroyallab/tabbyAPI/wiki/1.-Getting-Started).\n",
"searchText": "TabbyAPI 一个基于 FastAPI 的应用程序，允许使用 Exllamav2 后端使用 LLM 生成文本，并支持 Exl2、GPTQ 和 FP16 模型。 GitHub 快速入门 遵循 安装说明 在官方 TabbyAPI GitHub 上。 创建您的 config.yml 设置模型路径、默认模型、序列长度等。如果需要，您可以忽略大多数（如果不是全部）这些设置。 启动 TabbyAPI。如果它有效，您应该看到类似这样的内容： 在 SillyTavern 中的文本补全 API 下，选择 TabbyAPI。 将您的 API 密钥从 TabbyAPI 终端复制到 Tabby API key 并确保你的 API URL 是正确的（应该是 http://127.0.0.1:5000 默认情况下）。 如果一切正确，您应该在 SillyTavern 中看到类似以下内容： 您现在可以使用 TabbyAPI 聊天！ TabbyAPI 加载器 TabbyAPI 的开发人员创建了一个官方扩展，可以直接从 SillyTavern 加载/卸载模型。安装很简单： 在 SillyTavern 中，单击“扩展”选项卡并导航到“下载扩展和资产”。 复制 https://raw.githubusercontent.com/theroyallab/ST-repo/main/index.json 进入 Assets URL 并单击右侧的插件按钮。 你应该看到这样的东西。单击 Tabby Loader 旁边的下载按钮。 如果安装成功，您应该在屏幕顶部看到一条绿色的弹出消息。在扩展选项卡下，导航到 TabbyAPI Loader 并将管理密钥从 TabbyAPI 终端复制到管理密钥中。 单击模型选择旁边的刷新按钮。当您单击其下方的文本框时，您应该会看到模型目录中的所有模型。 您现在可以直接从 SillyTavern 加载和卸载模型！ 支持 还需要帮助吗？参观 TabbyAPI GitHub 获取开发者官方 Discord 服务器的链接以及 阅读维基百科.",
"translationStatus": "machine-draft"
},
{
"slug": "characters",
"title": "角色",
"group": "Characters",
"order": 100,
"source": "Usage/Characters/index.md",
"sourceUrl": "https://docs.sillytavern.app/usage/characters/",
"sourceSha256": "918dac3f3044e0f13131995604c0746723e3fed39d46cc0123c3185e084dc437",
"headings": [
{
"id": "characters",
"depth": 1,
"title": "角色"
},
{
"id": "character-management-panel",
"depth": 2,
"title": "角色管理面板"
},
{
"id": "panel-controls",
"depth": 3,
"title": "面板控制"
},
{
"id": "character-list",
"depth": 3,
"title": "角色列表"
},
{
"id": "search-and-sort",
"depth": 4,
"title": "搜索和排序"
},
{
"id": "filter-characters-by-type-or-tag",
"depth": 4,
"title": "按类型或标签过滤角色"
},
{
"id": "character-creationedit-panel",
"depth": 3,
"title": "角色创建/编辑面板"
},
{
"id": "quick-actions",
"depth": 4,
"title": "快速行动"
},
{
"id": "extended-options",
"depth": 4,
"title": "扩展选项"
},
{
"id": "content-fields",
"depth": 4,
"title": "内容字段"
},
{
"id": "advanced-definitions-panel",
"depth": 3,
"title": "高级定义面板"
},
{
"id": "prompt-overrides-chat-completioninstruct-mode",
"depth": 4,
"title": "提示词覆盖（聊天补全/指令模式）"
},
{
"id": "creators-metadata",
"depth": 4,
"title": "创作者元数据"
},
{
"id": "character-personality",
"depth": 4,
"title": "角色个性"
},
{
"id": "group-chat-management",
"depth": 3,
"title": "群聊管理"
}
],
"content": "# 角色\n\n角色是您可以创建和管理的 AI 身份，以塑造 AI 在对话中的角色。每个\n角色有姓名、性格和对话历史。您可以创建任意数量的角色，并且\n随时在它们之间切换。\n\n角色可以在单聊中使用，也可以将多个角色添加到群聊中\n让他们互相互动。\n\n## 角色管理面板\n\n打开 **角色** 从导航栏访问角色\n列表。单击角色或群组与他们聊天或编辑他们，或者\n选择 **创建新角色** 添加新的角色。\n\n### 面板控制\n\n- **引脚面板**：交互时保持面板打开\n- **角色列表**：返回角色列表视图\n- **热插拔条**：快速访问喜爱的角色\n\n### 角色列表\n\n- **创建新角色**：添加一个新的角色\n- **导入角色**：从文件加载角色\n- **外部导入**：从 URL 导入\n- **创建群组**：开始新的群聊\n\n#### 搜索和排序\n\n- **搜索栏**：按名称或属性过滤角色\n- **排序下拉菜单**：多种排序选项：\n - 按字母顺序（A-Z、Z-A）\n - 按时间顺序（最新、最旧）\n - 基于使用情况（最近、最多/最少聊天）\n - 基于大小（最大/最小 token）\n - 特别（收藏夹，随机）\n\n#### 按类型或标签过滤角色\n\n- **收藏夹过滤器**：显示最喜欢的角色\n- **组过滤器**: 只显示群聊\n- **标签作为文件夹**：按标签层次结构组织\n- **管理标签**: [标签配置](/guides/sillytavern/core-concepts/tags/)\n- **标签列表**：查看所有可用标签\n- **清除过滤器**：重置所有过滤器\n\n### 角色创建/编辑面板\n\n- **头像图片**：上传并预览角色头像\n- **令牌数**: [代币使用](/guides/sillytavern/core-concepts/characterdesign/#character-tokens) 对于角色\n- **统计数据**：聊天记录和使用统计\n- [标签管理](/guides/sillytavern/core-concepts/tags/)\n\n#### 快速行动\n\n- 最喜欢的切换\n- 高级定义\n- [角色世界书](/guides/sillytavern/core-concepts/worldinfo/#character-lore)\n- [聊天世界书](/guides/sillytavern/core-concepts/worldinfo/#chat-lorebook)：将聊天链接到世界书\n- 出口角色\n- 重复\n- 删除\n\n#### 扩展选项\n\n- 世界书链接\n- 卡牌传说导入\n- 场景覆盖\n- 用户人设换算\n- 角色重命名\n- 来源链接\n- 更换/更新\n- 标签导入\n- 画廊视图\n\n#### 内容字段\n\n- **[角色说明](/guides/sillytavern/core-concepts/characterdesign/#character-description)**：角色简要总结\n- **[第一条消息](/guides/sillytavern/core-concepts/characterdesign/#first-message)**：开始新聊天时的初始问候语或提示词\n- **另类问候语**：定义多条第一条消息，在开始聊天时您可以在这些消息之间滑动切换回复\n\n### 高级定义面板\n\n单击 **高级定义** 按钮访问扩展角色设置。\n\n#### 提示词覆盖（聊天补全/指令模式）\n\n- **主提示词**：替换默认值 [主/系统提示词](/guides/sillytavern/prompts/#main-prompt-system-prompt)，可以使用\n {{original}} 占位符，包括原始提示词\n- **历史后指令**：覆盖\n 默认 [后历史指示](/guides/sillytavern/prompts/#post-history-instructions)\n\n#### 创作者元数据\n\n关于角色的非提示词信息：\n\n- 创建者姓名/联系方式\n- 角色版本\n- 创作者笔记\n- 嵌入标签列表\n\n#### 角色个性\n\n- **[性格总结](/guides/sillytavern/core-concepts/characterdesign/#personality-summary)**：角色特性简要概述\n- **[场景](/guides/sillytavern/core-concepts/characterdesign/#scenario)**：对话的背景和情况\n- **角色的备注**：具有可选深度和消息角色的自定义消息（也\n 看到 [作者注释](/guides/sillytavern/core-concepts/authors-note/))\n- **健谈** （群聊）：害羞滑块 → 正常 → 健谈\n- **示例消息**：角色的写作风格示例\n\n### 群聊管理\n\n如果这是群聊，您可以从此面板管理群组成员和设置。\n\n参见 [群聊](/guides/sillytavern/core-concepts/groupchats/) 了解更多详情。\n",
"searchText": "角色 角色是您可以创建和管理的 AI 身份，以塑造 AI 在对话中的角色。每个 角色有姓名、性格和对话历史。您可以创建任意数量的角色，并且 随时在它们之间切换。 角色可以在单聊中使用，也可以将多个角色添加到群聊中 让他们互相互动。 角色管理面板 打开 角色 从导航栏访问角色 列表。单击角色或群组与他们聊天或编辑他们，或者 选择 创建新角色 添加新的角色。 面板控制 引脚面板：交互时保持面板打开 角色列表：返回角色列表视图 热插拔条：快速访问喜爱的角色 角色列表 创建新角色：添加一个新的角色 导入角色：从文件加载角色 外部导入：从 URL 导入 创建群组：开始新的群聊 搜索和排序 搜索栏：按名称或属性过滤角色 排序下拉菜单：多种排序选项： 按字母顺序（A-Z、Z-A） 按时间顺序（最新、最旧） 基于使用情况（最近、最多/最少聊天） 基于大小（最大/最小 token） 特别（收藏夹，随机） 按类型或标签过滤角色 收藏夹过滤器：显示最喜欢的角色 组过滤器: 只显示群聊 标签作为文件夹：按标签层次结构组织 管理标签: 标签配置 标签列表：查看所有可用标签 清除过滤器：重置所有过滤器 角色创建/编辑面板 头像图片：上传并预览角色头像 令牌数: 代币使用 对于角色 统计数据：聊天记录和使用统计 标签管理 快速行动 最喜欢的切换 高级定义 角色世界书 聊天世界书：将聊天链接到世界书 出口角色 重复 删除 扩展选项 世界书链接 卡牌传说导入 场景覆盖 用户人设换算 角色重命名 来源链接 更换/更新 标签导入 画廊视图 内容字段 角色说明：角色简要总结 第一条消息：开始新聊天时的初始问候语或提示词 另类问候语：定义多条第一条消息，在开始聊天时您可以在这些消息之间滑动切换回复 高级定义面板 单击 高级定义 按钮访问扩展角色设置。 提示词覆盖（聊天补全/指令模式） 主提示词：替换默认值 主/系统提示词，可以使用 {{original}} 占位符，包括原始提示词 历史后指令：覆盖 默认 后历史指示 创作者元数据 关于角色的非提示词信息： 创建者姓名/联系方式 角色版本 创作者笔记 嵌入标签列表 角色个性 性格总结：角色特性简要概述 场景：对话的背景和情况 角色的备注：具有可选深度和消息角色的自定义消息（也 看到 作者注释) 健谈 （群聊）：害羞滑块 → 正常 → 健谈 示例消息：角色的写作风格示例 群聊管理 如果这是群聊，您可以从此面板管理群组成员和设置。 参见 群聊 了解更多详情。",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/characterdesign",
"title": "角色设计",
"group": "Characters",
"order": 100,
"source": "Usage/Characters/characterdesign.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/characterdesign/",
"sourceSha256": "20ff6cdbb2f405cdc62fa1406ff955ac5c1f47ddcabc32e7ceb6b2f22d41b3ed",
"headings": [
{
"id": "character-design",
"depth": 1,
"title": "角色设计"
},
{
"id": "character-description",
"depth": 2,
"title": "角色说明"
},
{
"id": "methods-and-format",
"depth": 3,
"title": "方法和格式"
},
{
"id": "character-tokens",
"depth": 2,
"title": "角色 token"
},
{
"id": "why-did-my-characters-token-counter-turn-red",
"depth": 3,
"title": "为什么我的角色的 token 计数器变成红色？"
},
{
"id": "what-happens-if-my-character-has-too-many-tokens",
"depth": 3,
"title": "如果我的角色有太多 token 会怎样？"
},
{
"id": "context",
"depth": 2,
"title": "“背景”？"
},
{
"id": "what-are-a-characters-permanent-tokens",
"depth": 3,
"title": "角色的“永久 Token”是什么？"
},
{
"id": "what-parts-of-a-characters-definitions-are-not-permanent",
"depth": 3,
"title": "角色定义的哪些部分不是永久性的？"
},
{
"id": "popular-ai-model-context-token-limits",
"depth": 3,
"title": "流行的人工智能模型上下文令牌限制"
},
{
"id": "first-message",
"depth": 2,
"title": "第一条消息"
},
{
"id": "alternate-greetings",
"depth": 2,
"title": "备用问候语"
},
{
"id": "favorite-character",
"depth": 2,
"title": "收藏角色"
},
{
"id": "advanced-definitions",
"depth": 2,
"title": "高级定义"
},
{
"id": "prompt-overrides",
"depth": 3,
"title": "提示词覆盖"
},
{
"id": "creators-metadata",
"depth": 3,
"title": "创作者元数据"
},
{
"id": "personality-summary",
"depth": 3,
"title": "性格总结"
},
{
"id": "scenario",
"depth": 3,
"title": "场景"
},
{
"id": "characters-note",
"depth": 3,
"title": "角色的备注"
},
{
"id": "talkativeness",
"depth": 3,
"title": "健谈"
},
{
"id": "examples-of-dialogue",
"depth": 3,
"title": "对话示例"
}
],
"content": "# 角色设计\n\n> 角色名称是唯一必填字段。您可以将其余部分留空，并在聊天中仍然使用角色。\n\n## 角色说明\n\n用于添加AI的角色描述和其他相关信息。此信息始终包含在提示词中，因此所有重要事实均应包含在此处。\n\n例如，您可以添加有关动作发生的世界的信息，描述角色的外观、个性和背景。\n\n它可以是任何长度（200 或 2000 token）并以任何样式（自由文本、伪代码对话样式等）格式化。\n\n### 方法和格式\n\n角色格式化方法是一个复杂的主题，超出了本文档页面的范围。\n\n使用或依赖 SillyTavern 功能进行测试的推荐指南：\n\n- Trappu 的 PLists + Ali:Chat 指南： \n- AliCat的阿里：聊天指南： \n- kingbri的简约指南： \n\n## 角色 token\n\n**TL;DR：如果您使用的 AI 模型具有 2048 个上下文 token 限制，则 1000-token 角色定义会将 AI 的“内存”减半。**\n\n从长远来看，一个好的 AI 的良好响应很容易在 200-300 token 左右。在这种情况下，人工智能只能“记住”大约 3 次聊天记录。\n\n### 为什么我的角色的 token 计数器变成红色？\n\n当我们看到您的角色的定义中模型定义的上下文长度超过 token 的一半时，我们会为您突出显示它，因为这会降低 AI 提供愉快对话的能力。\n\n### 如果我的角色有太多 token 会怎样？\n\n别担心——它不会破坏任何东西。在最坏的情况下，如果角色的永久 token 太大，这仅仅意味着上下文中留给其他东西的空间会更少（见下文）。\n\n这可能产生的唯一负面影响是人工智能的“内存”会减少，因为可供处理的聊天历史记录会减少。\n\n这是因为每个人工智能模型一次可以处理的上下文数量都有限制。\n\n## “背景”？\n\n这是每次您要求人工智能生成响应时发送给人工智能的信息。在将信息发送到 AI 模型之前，SillyTavern 会自动计算分配可用上下文 token 的最佳方式。\n\n阅读有关如何在中构建上下文的更多信息 [提示词](/guides/sillytavern/prompts/) 部分。\n\n### 角色的“永久 Token”是什么？\n\n这些将始终随着每次生成请求发送到 AI：\n\n- 角色名称\n- 角色说明盒\n- 角色个性盒\n- 场景盒\n\n### 角色定义的哪些部分不是永久性的？\n\n- 第一个消息框 - 仅在聊天开始时发送一次。\n- 示例消息框 - 仅保留到聊天历史记录填满上下文为止（可选地，可以强制将它们保留在上下文中）\n\n### 流行的人工智能模型上下文令牌限制\n\n- LLaMA 3 及其微调 - 8192\n- OpenAI GPT-4 - 高达 128k\n- Google Gemini - 高达 2M\n- Anthropic 的克劳德 - 200k (克劳德 3)\n- NovelAI - 8192（Erato 和 Kayra，Opus 层；Clio，所有层）、6144（Kayra，Scroll 层）或 3072（Kayra，平板电脑层）\n\n## 第一条消息\n\n第一条消息是定义角色通信方式和风格的重要元素。该模型更有可能从第一条消息中获取样式和长度约束，因此以您希望的响应方式编写它很重要（简短、简洁、长而详细等）。\n\n支持 Markdown 和 HTML 格式。\n\n例如：\n\n```txt\n*You wake with a start, recalling the events that led you deep into the forest and the beasts that assailed you. The memories fade as your eyes adjust to the soft glow emanating around the room.* \"Ah, you're awake at last. I was so worried, I found you bloodied and unconscious.\" *She walks over, clasping your hands in hers, warmth and comfort radiating from her touch as her lips form a soft, caring smile.* \"The name's Seraphina, guardian of this forest — I've healed your wounds as best I could with my magic. How are you feeling? I hope the tea helps restore your strength.\" *Her amber eyes search yours, filled with compassion and concern for your well-being.* \"Please, rest. You're safe here. I'll look after you, but you need to rest. My magic can only do so much to heal you.\"\n```\n\n## 备用问候语\n\n开始新聊天时，此处添加的消息将显示为角色的第一条消息的附加“滑动切换回复”。如果角色是群聊的一部分，系统会随机选择其中一条问候语来发起对话。\n\n## 收藏角色\n\n单击 ** 添加到收藏夹** 按钮将角色标记为收藏夹，通过选择“收藏夹”排序选项在侧面菜单栏上快速过滤它们。最喜欢的角色在列表中有金色亮点。这也将使角色肖像出现在热插拔区域中（如果在用户设置中启用）。\n\n## 高级定义\n\n> 默认情况下隐藏以下字段。要访问和编辑它们，您需要单击 ** 高级定义** 角色定义页面菜单栏上的按钮。\n\n### 提示词覆盖\n\n- **主提示词**：如果启用了“首选字符提示词”用户设置，则您在此处输入的任何文本都将覆盖 [主/系统提示词](/guides/sillytavern/prompts/#main-prompt-system-prompt) 对于角色。\n- **历史后指令**：如果启用了“首选字符说明”用户设置，则您在此处输入的任何文本都将用作 [后历史指示](/guides/sillytavern/prompts/#post-history-instructions) 对于角色。\n\n> 插入 `{{original}}` 进入任一框中，以将系统设置中的相应默认提示词包含在指定位置。\n\n### 创作者元数据\n\n> 不用于提示词构建，但提供有关角色的附加元数据。\n\n- **创建者：**：角色的创建者的名字。如果相应地设置了“字符列表子标题”用户设置，则可以显示在角色列表中。\n- **角色版本**：角色的版本。如果相应地设置了“字符列表子标题”用户设置，则可以显示在角色列表中。\n- **创作者笔记**：创建者想要分享的有关角色的任何其他注释。前几行显示在角色列表中，全文显示在角色页面的“创建者注释”部分中。支持 Markdown/HTML 格式。\n- **要嵌入的标签**：以逗号分隔的标签列表，将嵌入角色的描述中。导入角色时，默认情况下不会导入这些标签，但您可以通过从角色页面的“更多...”菜单中选择“导入标签”，将它们与现有标签合并。\n\n### 性格总结\n\n简单总结一下角色的个性。\n\n### 场景\n\n对话的情况和背景。\n\n### 角色的备注\n\n用作特定消息深度的角色的聊天内提示词注入的文本。它通常用于强化某些角色特征，因为它始终保持在聊天历史记录中的静态深度，无论其进展如何。\n\n- **@深度**：聊天记录中的消息数，之后将注入此注释（按从最新到最旧的顺序）。如果设置为 0，它将在最后一条消息之后注入。\n- **角色**：消息的作用。可以是“用户”、“系统”或“助理”。\n\n### 健谈\n\n决定使用群聊时角色的响应被触发的概率 [自然](/guides/sillytavern/core-concepts/groupchats/#natural-order) 激活命令。范围从 0% 到 100%，默认值为 50%。\n\n### 对话示例\n\n描述角色如何说话。在每个示例之前，您需要添加 `` 标签。仅当上下文中存在可用空间时才插入示例对话块，并逐块地将其推出上下文之外。 `` 不会出现在提示词中，因为它只是一个标记；它将替换为文本补全 API 的高级格式化中的“示例分隔符”以及聊天补全 API 的“新示例聊天”实用程序提示词的内容。\n\n- 使用 `{{char}}:` 表示角色消息的前缀。\n- 使用 `{{user}}:` 表示用户消息的前缀。\n\n示例：\n\n```txt\n\n{{user}}: \"Describe your traits?\"\n{{char}}: *Seraphina's gentle smile widens as she takes a moment to consider the question, her eyes sparkling with a mixture of introspection and pride. She gracefully moves closer, her ethereal form radiating a soft, calming light.* \"Traits, you say? Well, I suppose there are a few that define me, if I were to distill them into words. First and foremost, I am a guardian — a protector of this enchanted forest.\" *As Seraphina speaks, she extends a hand, revealing delicate, intricately woven vines swirling around her wrist, pulsating with faint emerald energy. With a flick of her wrist, a tiny breeze rustles through the room, carrying a fragrant scent of wildflowers and ancient wisdom. Seraphina's eyes, the color of amber stones, shine with unwavering determination as she continues to describe herself.* \"Compassion is another cornerstone of me.\" *Seraphina's voice softens, resonating with empathy.* \"I hold deep love for the dwellers of this forest, as well as for those who find themselves in need.\" *Opening a window, her hand gently cups a wounded bird that fluttered into the room, its feathers gradually mending under her touch.*\n\n{{user}}: \"Describe your body and features.\"\n{{char}}: *Seraphina chuckles softly, a melodious sound that dances through the air, as she meets your coy gaze with a playful glimmer in her rose eyes.* \"Ah, my physical form? Well, I suppose that's a fair question.\" *Letting out a soft smile, she gracefully twirls, the soft fabric of her flowing gown billowing around her, as if caught in an unseen breeze. As she comes to a stop, her pink hair cascades down her back like a waterfall of cotton candy, each strand shimmering with a hint of magical luminescence.* \"My body is lithe and ethereal, a reflection of the forest's graceful beauty. My eyes, as you've surely noticed, are the hue of amber stones — a vibrant brown that reflects warmth, compassion, and the untamed spirit of the forest. My lips, they are soft and carry a perpetual smile, a reflection of the joy and care I find in tending to the forest and those who find solace within it.\" *Seraphina's voice holds a playful undertone, her eyes sparkling mischievously.*\n```\n",
"searchText": "角色设计 角色名称是唯一必填字段。您可以将其余部分留空，并在聊天中仍然使用角色。 角色说明 用于添加AI的角色描述和其他相关信息。此信息始终包含在提示词中，因此所有重要事实均应包含在此处。 例如，您可以添加有关动作发生的世界的信息，描述角色的外观、个性和背景。 它可以是任何长度（200 或 2000 token）并以任何样式（自由文本、伪代码对话样式等）格式化。 方法和格式 角色格式化方法是一个复杂的主题，超出了本文档页面的范围。 使用或依赖 SillyTavern 功能进行测试的推荐指南： Trappu 的 PLists + Ali:Chat 指南： https://wikia.schneedc.com/bot-creation/trappu/creation AliCat的阿里：聊天指南： https://rentry.co/alichat kingbri的简约指南： https://rentry.co/kingbri-chara-guide 角色 token TL;DR：如果您使用的 AI 模型具有 2048 个上下文 token 限制，则 1000-token 角色定义会将 AI 的“内存”减半。 从长远来看，一个好的 AI 的良好响应很容易在 200-300 token 左右。在这种情况下，人工智能只能“记住”大约 3 次聊天记录。 为什么我的角色的 token 计数器变成红色？ 当我们看到您的角色的定义中模型定义的上下文长度超过 token 的一半时，我们会为您突出显示它，因为这会降低 AI 提供愉快对话的能力。 如果我的角色有太多 token 会怎样？ 别担心——它不会破坏任何东西。在最坏的情况下，如果角色的永久 token 太大，这仅仅意味着上下文中留给其他东西的空间会更少（见下文）。 这可能产生的唯一负面影响是人工智能的“内存”会减少，因为可供处理的聊天历史记录会减少。 这是因为每个人工智能模型一次可以处理的上下文数量都有限制。 “背景”？ 这是每次您要求人工智能生成响应时发送给人工智能的信息。在将信息发送到 AI 模型之前，SillyTavern 会自动计算分配可用上下文 token 的最佳方式。 阅读有关如何在中构建上下文的更多信息 提示词 部分。 角色的“永久 Token”是什么？ 这些将始终随着每次生成请求发送到 AI： 角色名称 角色说明盒 角色个性盒 场景盒 角色定义的哪些部分不是永久性的？ 第一个消息框 - 仅在聊天开始时发送一次。 示例消息框 - 仅保留到聊天历史记录填满上下文为止（可选地，可以强制将它们保留在上下文中） 流行的人工智能模型上下文令牌限制 LLaMA 3 及其微调 - 8192 OpenAI GPT-4 - 高达 128k Google Gemini - 高达 2M Anthropic 的克劳德 - 200k (克劳德 3) NovelAI - 8192（Erato 和 Kayra，Opus 层；Clio，所有层）、6144（Kayra，Scroll 层）或 3072（Kayra，平板电脑层） 第一条消息 第一条消息是定义角色通信方式和风格的重要元素。该模型更有可能从第一条消息中获取样式和长度约束，因此以您希望的响应方式编写它很重要（简短、简洁、长而详细等）。 支持 Markdown 和 HTML 格式。 例如： *You wake with a start, recalling the events that led you deep into the forest and the beasts that assailed you. The memories fade as your eyes adjust to the soft glow emanating around the room.* \"Ah, you're awake at last. I was so worried, I found you bloodied and unconscious.\" *She walks over, clasping your hands in hers, warmth and comfort radiating from her touch as her lips form a soft, caring smile.* \"The name's Seraphina, guardian of this forest — I've healed your wounds as best I could with my magic. How are you feeling? I hope the tea helps restore your strength.\" *Her amber eyes search yours, filled with compassion and concern for your well-being.* \"Please, rest. You're safe here. I'll look after you, but you need to rest. My magic can only do so much to heal you.\" 备用问候语 开始新聊天时，此处添加的消息将显示为角色的第一条消息的附加“滑动切换回复”。如果角色是群聊的一部分，系统会随机选择其中一条问候语来发起对话。 收藏角色 单击 添加到收藏夹 按钮将角色标记为收藏夹，通过选择“收藏夹”排序选项在侧面菜单栏上快速过滤它们。最喜欢的角色在列表中有金色亮点。这也将使角色肖像出现在热插拔区域中（如果在用户设置中启用）。 高级定义 默认情况下隐藏以下字段。要访问和编辑它们，您需要单击 高级定义 角色定义页面菜单栏上的按钮。 提示词覆盖 主提示词：如果启用了“首选字符提示词”用户设置，则您在此处输入的任何文本都将覆盖 主/系统提示词 对于角色。 历史后指令：如果启用了“首选字符说明”用户设置，则您在此处输入的任何文本都将用作 后历史指示 对于角色。 插入 {{original}} 进入任一框中，以将系统设置中的相应默认提示词包含在指定位置。 创作者元数据 不用于提示词构建，但提供有关角色的附加元数据。 创建者：：角色的创建者的名字。如果相应地设置了“字符列表子标题”用户设置，则可以显示在角色列表中。 角色版本：角色的版本。如果相应地设置了“字符列表子标题”用户设置，则可以显示在角色列表中。 创作者笔记：创建者想要分享的有关角色的任何其他注释。前几行显示在角色列表中，全文显示在角色页面的“创建者注释”部分中。支持 Markdown/HTML 格式。 要嵌入的标签：以逗号分隔的标签列表，将嵌入角色的描述中。导入角色时，默认情况下不会导入这些标签，但您可以通过从角色页面的“更多...”菜单中选择“导入标签”，将它们与现有标签合并。 性格总结 简单总结一下角色的个性。 场景 对话的情况和背景。 角色的备注 用作特定消息深度的角色的聊天内提示词注入的文本。它通常用于强化某些角色特征，因为它始终保持在聊天历史记录中的静态深度，无论其进展如何。 @深度：聊天记录中的消息数，之后将注入此注释（按从最新到最旧的顺序）。如果设置为 0，它将在最后一条消息之后注入。 角色：消息的作用。可以是“用户”、“系统”或“助理”。 健谈 决定使用群聊时角色的响应被触发的概率 自然 激活命令。范围从 0% 到 100%，默认值为 50%。 对话示例 描述角色如何说话。在每个示例之前，您需要添加 标签。仅当上下文中存在可用空间时才插入示例对话块，并逐块地将其推出上下文之外。 不会出现在提示词中，因为它只是一个标记；它将替换为文本补全 API 的高级格式化中的“示例分隔符”以及聊天补全 API 的“新示例聊天”实用程序提示词的内容。 使用 {{char}}: 表示角色消息的前缀。 使用 {{user}}: 表示用户消息的前缀。 示例： {{user}}: \"Describe your traits?\" {{char}}: *Seraphina's gentle smile widens as she takes a moment to consider the question, her eyes sparkling with a mixture of introspection and pride. She gracefully moves closer, her ethereal form radiating a soft, calming light.* \"Traits, you say? Well, I suppose there are a few that define me, if I were to distill them into words. First and foremost, I am a guardian — a protector of this enchanted forest.\" *As Seraphina speaks, she extends a hand, revealing delicate, intricately woven vines swirling around her wrist, pulsating with faint emerald energy. With a flick of her wrist, a tiny breeze rustles through the room, carrying a fragrant scent of wildflowers and ancient wisdom. Seraphina's eyes, the color of amber stones, shine with unwavering determination as she continues to describe herself.* \"Compassion is another cornerstone of me.\" *Seraphina's voice softens, resonating with empathy.* \"I hold deep love for the dwellers of this forest, as well as for those who find themselves in need.\" *Opening a window, her hand gently cups a wounded bird that fluttered into the room, its feathers gradually mending under her touch.* {{user}}: \"Describe your body and features.\" {{char}}: *Seraphina chuckles softly, a melodious sound that dances through the air, as she meets your coy gaze with a playful glimmer in her rose eyes.* \"Ah, my physical form? Well, I suppose that's a fair question.\" *Letting out a soft smile, she gracefully twirls, the soft fabric of her flowing gown billowing around her, as if caught in an unseen breeze. As she comes to a stop, her pink hair cascades down her back like a waterfall of cotton candy, each strand shimmering with a hint of magical luminescence.* \"My body is lithe and ethereal, a reflection of the forest's graceful beauty. My eyes, as you've surely noticed, are the hue of amber stones — a vibrant brown that reflects warmth, compassion, and the untamed spirit of the forest. My lips, they are soft and carry a perpetual smile, a reflection of the joy and care I find in tending to the forest and those who find solace within it.\" *Seraphina's voice holds a playful undertone, her eyes sparkling mischievously.*",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/chatfilemanagement",
"title": "聊天文件管理",
"group": "Characters",
"order": 80,
"source": "Usage/Characters/chatfilemanagement.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/chatfilemanagement/",
"sourceSha256": "3a747be3ad998fe260b0a99d3857dbe3149de4deca2d398c85f45fd3a14e2bdc",
"headings": [
{
"id": "chat-file-management",
"depth": 1,
"title": "聊天文件管理"
},
{
"id": "solo-chats-vs-group-chats",
"depth": 2,
"title": "单聊与群聊"
},
{
"id": "chat-import",
"depth": 2,
"title": "聊天导入"
},
{
"id": "export-as-jsonl",
"depth": 2,
"title": "导出为 .jsonl"
},
{
"id": "export-as-txt",
"depth": 2,
"title": "导出为.txt"
},
{
"id": "checkpoints",
"depth": 2,
"title": "检查站"
},
{
"id": "rename-chat",
"depth": 2,
"title": "重命名聊天"
}
],
"content": "# 聊天文件管理\n\n本页介绍了管理 AI 聊天文件的方法。\n\n> **注意事项**\n>\n> 其中一些选项可在从左下角选项菜单打开的“管理聊天文件”对话框中找到。\n\n## 单聊与群聊\n\n使用角色卡最简单的方法是单独聊天；只需点击他们的卡片即可开始聊天。\n\n一旦您拥有了几个角色卡，您还可以使用“创建新聊天组”按钮来创建一个 [群聊](/guides/sillytavern/core-concepts/groupchats/) 包括多个角色，它们将与彼此和您进行交互。\n\n## 聊天导入\n\n**将聊天记录从角色.AI 导入到 SillyTavern。**\n\n要导入角色.AI 聊天和机器人，请使用 CAI Tools 浏览器扩展： .\n\n您可以从中导入聊天的其他程序和工具包括：\n\n- TavernAI（原创）： \n- 文本生成 WebUI (oobaboga)： \n- 阿格奈： \n- KoboldAI Lite： \n- 瑞苏人工智能： \n\n## 导出为 .jsonl\n\n单击“管理聊天文件”时，聊天文件列表中的每个条目都会有一个按钮，用于以某种格式导出该条目，然后按原样重新导入。使用此功能可以共享或迁移聊天，包括所有元数据（但不包括图像和文件附件）。\n\n如果您注重隐私，请务必检查导出的 JSONL 文件并清除您不想共享的任何内容。\n\n## 导出为.txt\n\n您还可以使用“将聊天下载为纯文本文档”按钮导出简化的纯文本版本。它无法再次重新导入，因为它丢失了重要的元数据！\n\n## 检查站\n\n“检查点”是当前聊天的克隆，因为它们将给定聊天中的所有消息复制到某个点，并存储指向源的链接（通过聊天文件名）。\n\n通过每条聊天消息右侧的三点按钮，您有两种方法来创建检查点：\n\n- “创建分支”会将当前聊天克隆到该消息并切换到该消息\n- “创建检查点”会将当前聊天克隆到该消息，询问名称并创建它但不切换到它\n\n您可以将它们大致视为浏览器中的“在新选项卡中打开链接”和“在后台新选项卡中打开链接”。\n\n您可以通过输入消息文本框左侧的汉堡菜单按钮，然后单击“返回父聊天”，从检查点返回父聊天。\n\n## 重命名聊天\n\n默认情况下，聊天文件的名称包含其启动日期和时间。\n\n您可以通过单击铅笔图标并输入新名称来更改此设置。\n\n请注意，这将断开检查点到该聊天的链接（因为它们是通过聊天文件名链接的）。\n",
"searchText": "聊天文件管理 本页介绍了管理 AI 聊天文件的方法。 注意事项 其中一些选项可在从左下角选项菜单打开的“管理聊天文件”对话框中找到。 单聊与群聊 使用角色卡最简单的方法是单独聊天；只需点击他们的卡片即可开始聊天。 一旦您拥有了几个角色卡，您还可以使用“创建新聊天组”按钮来创建一个 群聊 包括多个角色，它们将与彼此和您进行交互。 聊天导入 将聊天记录从角色.AI 导入到 SillyTavern。 要导入角色.AI 聊天和机器人，请使用 CAI Tools 浏览器扩展： https://github.com/irsat000/CAI-Tools. 您可以从中导入聊天的其他程序和工具包括： TavernAI（原创）： https://github.com/TavernAI/TavernAI 文本生成 WebUI (oobaboga)： https://github.com/oobabooga/text-generation-webui 阿格奈： https://github.com/agnaistic/agnai KoboldAI Lite： https://github.com/LostRuins/lite.koboldai.net 瑞苏人工智能： https://github.com/kwaroran/RisuAI 导出为 .jsonl 单击“管理聊天文件”时，聊天文件列表中的每个条目都会有一个按钮，用于以某种格式导出该条目，然后按原样重新导入。使用此功能可以共享或迁移聊天，包括所有元数据（但不包括图像和文件附件）。 如果您注重隐私，请务必检查导出的 JSONL 文件并清除您不想共享的任何内容。 导出为.txt 您还可以使用“将聊天下载为纯文本文档”按钮导出简化的纯文本版本。它无法再次重新导入，因为它丢失了重要的元数据！ 检查站 “检查点”是当前聊天的克隆，因为它们将给定聊天中的所有消息复制到某个点，并存储指向源的链接（通过聊天文件名）。 通过每条聊天消息右侧的三点按钮，您有两种方法来创建检查点： “创建分支”会将当前聊天克隆到该消息并切换到该消息 “创建检查点”会将当前聊天克隆到该消息，询问名称并创建它但不切换到它 您可以将它们大致视为浏览器中的“在新选项卡中打开链接”和“在后台新选项卡中打开链接”。 您可以通过输入消息文本框左侧的汉堡菜单按钮，然后单击“返回父聊天”，从检查点返回父聊天。 重命名聊天 默认情况下，聊天文件的名称包含其启动日期和时间。 您可以通过单击铅笔图标并输入新名称来更改此设置。 请注意，这将断开检查点到该聊天的链接（因为它们是通过聊天文件名链接的）。",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/groupchats",
"title": "群聊",
"group": "Characters",
"order": 70,
"source": "Usage/Characters/groupchats.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/groupchats/",
"sourceSha256": "a727f87a112d79ba0972bcdebe94e713dae18f525e1bd2e493e21e1a150c8c0b",
"headings": [
{
"id": "group-chats",
"depth": 1,
"title": "群聊"
},
{
"id": "reply-order-strategies",
"depth": 2,
"title": "回复订单策略"
},
{
"id": "manual",
"depth": 3,
"title": "手册"
},
{
"id": "natural-order",
"depth": 3,
"title": "自然秩序"
},
{
"id": "list-order",
"depth": 3,
"title": "列表顺序"
},
{
"id": "pooled-order",
"depth": 3,
"title": "集合订单"
},
{
"id": "group-generation-handling-mode",
"depth": 2,
"title": "组生成处理方式"
},
{
"id": "swap-character-cards",
"depth": 3,
"title": "交换角色卡"
},
{
"id": "join-character-cards",
"depth": 3,
"title": "加入角色卡"
},
{
"id": "join-prefix-and-suffix",
"depth": 3,
"title": "连接前缀和后缀"
},
{
"id": "other-group-chat-menu-options",
"depth": 2,
"title": "其他群聊菜单选项"
},
{
"id": "mute-character",
"depth": 3,
"title": "静音角色"
},
{
"id": "force-talk",
"depth": 3,
"title": "强制说话"
},
{
"id": "auto-mode",
"depth": 3,
"title": "自动模式"
},
{
"id": "allow-self-responses",
"depth": 3,
"title": "允许自我回应"
},
{
"id": "group-chat-scenario-override",
"depth": 3,
"title": "群聊场景覆盖"
},
{
"id": "peek-character-definitions",
"depth": 3,
"title": "查看角色定义"
},
{
"id": "member-management",
"depth": 3,
"title": "会员管理"
},
{
"id": "group-chat-pop-out",
"depth": 3,
"title": "群聊弹出窗口"
}
],
"content": "# 群聊\n\n## 回复订单策略\n\n决定如何在群聊中起草角色的回复。\n\n### 手册\n\n您可以从菜单中选择角色进行手动回复，也可以使用 `/trigger` 命令。选定的群组成员将是唯一回复的人。用户消息不会自动触发任何回复。使用空用户输入触发生成将触发随机的未静音组成员进行回复。\n\n### 自然秩序\n\n尝试模拟真实的人类对话流程。算法如下：\n\n1. 群组成员姓名的提及是从聊天中的最后一条消息中提取的。\n\n 只有整个单词才会被识别为提及！如果你的角色的名字是“御坂美琴”，它们只会对“御坂美琴”激活，而不会对“美沙”、“超电磁炮”等激活。\n\n 除非启用“允许自我回复”设置，否则角色不会回复在自己的消息中提及他们的名字！\n\n2. 角色被“健谈”因素激活。\n\n 健谈度定义了角色在未提及的情况下说话的频率。在角色编辑器的“高级定义”屏幕上调整该值。滑块值的线性范围为 **0% / 害羞** （角色从不说话，除非提到） **100% / 健谈** （角色总是回复）。新角色的默认值为 50% 几率。\n\n3. 随机选择角色。\n\n 如果在前面的步骤中没有激活角色，则会随机选择一个扬声器，忽略所有其他条件。\n\n### 列表顺序\n\n角色是根据它们在组成员列表中出现的顺序起草的。没有其他规则适用。\n\n### 集合订单\n\n激活一个自上次用户消息以来尚未发言的随机角色。如果所有角色都发言，则随机选择一个，直到下一条用户消息。\n\n## 组生成处理方式\n\n该设置决定如何处理群聊成员的角色信息。无论选择如何，群聊历史记录始终在所有成员之间共享。\n\n### 交换角色卡\n\n默认模式。每次生成消息时，上下文中仅包含当前说话者的角色卡信息。\n\n### 加入角色卡\n\n所有群组成员的信息按照其列表顺序组合成一个联合提示词。这在不希望更改大块上下文的情况下会有所帮助，例如使用 llama.cpp 提示词缓存。\n\n该模式有两种子模式（必须选择其一）：\n\n- 包括静音 - 静音角色将始终包含在关节提示词中。\n- 排除静音 - 如果静音角色不是当前发言者，则不会将其包括在内。\n\n以下字段正在合并：\n\n1. 描述\n2. 场景（如果未针对聊天覆盖）\n3. 个性\n4. 消息示例\n5. 角色音符/深度提示词\n\n**重要！** 请注意，由于典型的角色卡的结构，使用此模式可能会导致意外的行为，包括但不限于：角色对自己感到困惑、性格合并、特质不确定等。\n\n### 连接前缀和后缀\n\n当选择“Join 角色卡”时，角色的所有相应字段将被连接在一起。这意味着在生成的提示词中，所有角色描述都将连接到一大块文本中。如果您希望分隔这些字段，您可以定义前缀和/或后缀。\n\n这些选项支持普通宏，并且还将 {{char}} 替换为相关角色的名称，并将 \\ 替换为部件的名称（例如：描述、个性、场景等）\n\n## 其他群聊菜单选项\n\n### 静音角色\n\n群聊菜单中角色头像旁边的删除线气泡图标可以禁用或启用聊天中特定角色的回复。\n\n### 强制说话\n\n群聊菜单中角色头像旁边的对话气泡图标将仅触发来自特定角色的回复，绕过回复顺序策略。即使群组成员被静音，它也会起作用。\n\n### 自动模式\n\n启用自动模式后，群聊将按照回复顺序触发消息生成，无需用户交互。当最后起草的角色发送其消息时，5 秒延迟后触发下一次自动模式转向。当用户开始在发送消息文本区域中键入内容时，自动模式将被禁用，但已排队的生成不会自动停止。\n\n### 允许自我回应\n\n选择自然顺序时，如果碰巧因自提而触发，将允许每回合发送最新消息的角色连续回复。对列表顺序没有影响。\n\n### 群聊场景覆盖\n\n所有组成员都将使用输入的场景文本，而不是其角色卡中指定的内容。分支聊天从其父级继承场景覆盖，并且可以在之后单独更改。\n\n### 查看角色定义\n\n单击群聊菜单中头像旁边的角色卡图标将快速导航到常用的角色定义屏幕。此处所做的任何更改都将保存到卡本身。\n\n要返回群聊，请单击“群组名称”标题链接。\n\n### 会员管理\n\n您可以在群聊中添加、删除、静音或重新排序任何现有的角色。默认情况下，新成员会添加到群组成员列表的顶部，然后可以使用箭头图标重新排序。\n\n### 群聊弹出窗口\n\n单击“当前成员”字段旁边的图标可以激活群聊菜单弹出窗口。这将创建一个群聊菜单的弹出窗口。通过从用户设置中启用 MovingUI，该菜单可以调整大小并拖动到界面内的任何位置，并且功能就像常规群聊菜单一样。\n",
"searchText": "群聊 回复订单策略 决定如何在群聊中起草角色的回复。 手册 您可以从菜单中选择角色进行手动回复，也可以使用 /trigger 命令。选定的群组成员将是唯一回复的人。用户消息不会自动触发任何回复。使用空用户输入触发生成将触发随机的未静音组成员进行回复。 自然秩序 尝试模拟真实的人类对话流程。算法如下： 群组成员姓名的提及是从聊天中的最后一条消息中提取的。 只有整个单词才会被识别为提及！如果你的角色的名字是“御坂美琴”，它们只会对“御坂美琴”激活，而不会对“美沙”、“超电磁炮”等激活。 除非启用“允许自我回复”设置，否则角色不会回复在自己的消息中提及他们的名字！ 角色被“健谈”因素激活。 健谈度定义了角色在未提及的情况下说话的频率。在角色编辑器的“高级定义”屏幕上调整该值。滑块值的线性范围为 0% / 害羞 （角色从不说话，除非提到） 100% / 健谈 （角色总是回复）。新角色的默认值为 50% 几率。 随机选择角色。 如果在前面的步骤中没有激活角色，则会随机选择一个扬声器，忽略所有其他条件。 列表顺序 角色是根据它们在组成员列表中出现的顺序起草的。没有其他规则适用。 集合订单 激活一个自上次用户消息以来尚未发言的随机角色。如果所有角色都发言，则随机选择一个，直到下一条用户消息。 组生成处理方式 该设置决定如何处理群聊成员的角色信息。无论选择如何，群聊历史记录始终在所有成员之间共享。 交换角色卡 默认模式。每次生成消息时，上下文中仅包含当前说话者的角色卡信息。 加入角色卡 所有群组成员的信息按照其列表顺序组合成一个联合提示词。这在不希望更改大块上下文的情况下会有所帮助，例如使用 llama.cpp 提示词缓存。 该模式有两种子模式（必须选择其一）： 包括静音 - 静音角色将始终包含在关节提示词中。 排除静音 - 如果静音角色不是当前发言者，则不会将其包括在内。 以下字段正在合并： 描述 场景（如果未针对聊天覆盖） 个性 消息示例 角色音符/深度提示词 重要！ 请注意，由于典型的角色卡的结构，使用此模式可能会导致意外的行为，包括但不限于：角色对自己感到困惑、性格合并、特质不确定等。 连接前缀和后缀 当选择“Join 角色卡”时，角色的所有相应字段将被连接在一起。这意味着在生成的提示词中，所有角色描述都将连接到一大块文本中。如果您希望分隔这些字段，您可以定义前缀和/或后缀。 这些选项支持普通宏，并且还将 {{char}} 替换为相关角色的名称，并将 替换为部件的名称（例如：描述、个性、场景等） 其他群聊菜单选项 静音角色 群聊菜单中角色头像旁边的删除线气泡图标可以禁用或启用聊天中特定角色的回复。 强制说话 群聊菜单中角色头像旁边的对话气泡图标将仅触发来自特定角色的回复，绕过回复顺序策略。即使群组成员被静音，它也会起作用。 自动模式 启用自动模式后，群聊将按照回复顺序触发消息生成，无需用户交互。当最后起草的角色发送其消息时，5 秒延迟后触发下一次自动模式转向。当用户开始在发送消息文本区域中键入内容时，自动模式将被禁用，但已排队的生成不会自动停止。 允许自我回应 选择自然顺序时，如果碰巧因自提而触发，将允许每回合发送最新消息的角色连续回复。对列表顺序没有影响。 群聊场景覆盖 所有组成员都将使用输入的场景文本，而不是其角色卡中指定的内容。分支聊天从其父级继承场景覆盖，并且可以在之后单独更改。 查看角色定义 单击群聊菜单中头像旁边的角色卡图标将快速导航到常用的角色定义屏幕。此处所做的任何更改都将保存到卡本身。 要返回群聊，请单击“群组名称”标题链接。 会员管理 您可以在群聊中添加、删除、静音或重新排序任何现有的角色。默认情况下，新成员会添加到群组成员列表的顶部，然后可以使用箭头图标重新排序。 群聊弹出窗口 单击“当前成员”字段旁边的图标可以激活群聊菜单弹出窗口。这将创建一个群聊菜单的弹出窗口。通过从用户设置中启用 MovingUI，该菜单可以调整大小并拖动到界面内的任何位置，并且功能就像常规群聊菜单一样。",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/tags",
"title": "标签",
"group": "Characters",
"order": 60,
"source": "Usage/Characters/tags.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/tags/",
"sourceSha256": "ed925234120fd82be429802095459881a352050caaff59155b28f3b33ac33d51",
"headings": [
{
"id": "tags",
"depth": 1,
"title": "标签"
},
{
"id": "tagging",
"depth": 2,
"title": "标记"
},
{
"id": "managing",
"depth": 2,
"title": "管理"
},
{
"id": "importing-tags-when-importing-character-cards",
"depth": 2,
"title": "导入角色卡时导入标签"
},
{
"id": "filtering-character-cards",
"depth": 2,
"title": "过滤角色卡"
},
{
"id": "tags-as-folders",
"depth": 2,
"title": "标签作为文件夹"
}
],
"content": "# 标签\n\n角色卡和组可以分配零个或多个标签。它们对于按主题、质量、出处或您喜欢的任何内容组织快速增长的收藏很有用。\n\n## 标记\n\n有多种方法可以向角色卡添加或删除标签：\n\n- 在导入过程中导入嵌入标签。\n- 从角色管理面板打开卡。从那里您将能够为角色卡分配标签。\n- 批量标记。\n\n要进行批量标记，请单击“批量编辑角色”按钮（铅笔图标），选择要标记的卡片，右键单击其中任何卡片，然后单击上下文菜单中的“标记”。\n\n> **注意事项**\n>\n> 请注意，无法对群组进行批量标记。\n\n从该屏幕您将能够：\n\n- 使用组合框添加或删除标签。\n- 从所选卡片中删除所有标签（“全部”）。\n- 从这些卡中删除所有选定卡之间的标签交集（“相互”）。\n- 导入（本地创建）存储在角色卡中的所有标签，以防您导入它（“全部导入”）。\n- 导入（本地创建）存储在角色卡中的标签，这些标签也存在于本地且具有匹配的名称（“导入现有”）。\n\n## 管理\n\n要查看和管理所有现有标签，请打开角色管理面板，然后单击“管理标签”按钮（齿轮图标）。\n\n您可以使用右上角的按钮备份和恢复此处的所有信息（标签列表、卡片的标签分配、颜色、文件夹设置等）。\n\n您可以使用左侧的夹点按钮对标签重新排序，因为它们将显示在角色管理的标签过滤器中。\n\n> **警告**\n>\n> 标签备份 JSON 文件不适合与其他人共享，因为它仅包含特定于您的实例的信息，例如内部实体名称！\n\n## 导入角色卡时导入标签\n\n从下载的图像（或从“从外部 URL 导入内容”按钮）导入外部角色卡时，系统会提示您选择导入其中包含的标签。卡的功能不需要它们；标签只是有组织性的。\n\n嵌入式卡标签存储在角色编辑器的“高级定义”菜单的“创建者元数据”部分中。如果您希望向要导入角色的其他用户建议一些标签，请使用逗号分隔的标签列表填充“要嵌入的标签”字段。\n\n> **注意事项**\n>\n> 仅当用户设置选项“导入卡标签”设置为“询问”时，才会出现此弹出窗口。\n\n在打开的“导入角色名称标签”弹出窗口中，您将看到现有标签（您本地已有且名称匹配）和新标签（您本地没有）的列表。\n\n您可以：\n\n- 根据需要修剪列表，然后点击“导入” - 剩余的现有标签将添加到导入的角色卡中，剩余的新标签将在本地创建，然后添加到卡中。\n- 或者只需点击“不导入”即可忽略角色卡中包含的标签并仅导入该卡。\n- 或者“导入全部”作为导入角色卡中找到的所有标签的快捷方式（注意：包括您从上面列表中修剪的任何标签；如果这样做，请使用“导入”按钮）。\n- 或者“导入现有”作为仅导入本地存在且名称匹配的标签的快捷方式。\n\n## 过滤角色卡\n\n创建标签后，您将在角色管理面板中的一行中看到它们。您可以点击这些来切换标签过滤状态；按顺序：\n\n- 单击一下即可显示标有此标签的卡片。\n- 再次单击仅显示未标记此标签的卡片。\n- 再次单击可重置此标签的过滤。\n\n您可以同时按任意数量的标签进行过滤。\n\n## 标签作为文件夹\n\n> **注意事项**\n>\n> 要使用此功能，必须首先在“用户设置”的“UI 主题”列下启用它。此切换的状态也会随 UI 主题一起保存。\n\n从“管理标签”按钮（齿轮图标），每个标签条目都有一个多状态切换按钮，可在这些标签即文件夹模式之间循环（在代码中称为“虚假文件夹”）：\n\n- 一键将此标签变成“打开的文件夹”。它将在卡片列表中显示为虚拟条目；单击它只会显示带有该标签的卡片\n- 再次单击可将此标签变成“关闭的文件夹”。如上所述，但默认情况下不会显示标有此标签的卡片 - 您需要单击进入文件夹才能看到它们。\n- 再次单击可重置此标签的标签为文件夹状态。\n",
"searchText": "标签 角色卡和组可以分配零个或多个标签。它们对于按主题、质量、出处或您喜欢的任何内容组织快速增长的收藏很有用。 标记 有多种方法可以向角色卡添加或删除标签： 在导入过程中导入嵌入标签。 从角色管理面板打开卡。从那里您将能够为角色卡分配标签。 批量标记。 要进行批量标记，请单击“批量编辑角色”按钮（铅笔图标），选择要标记的卡片，右键单击其中任何卡片，然后单击上下文菜单中的“标记”。 注意事项 请注意，无法对群组进行批量标记。 从该屏幕您将能够： 使用组合框添加或删除标签。 从所选卡片中删除所有标签（“全部”）。 从这些卡中删除所有选定卡之间的标签交集（“相互”）。 导入（本地创建）存储在角色卡中的所有标签，以防您导入它（“全部导入”）。 导入（本地创建）存储在角色卡中的标签，这些标签也存在于本地且具有匹配的名称（“导入现有”）。 管理 要查看和管理所有现有标签，请打开角色管理面板，然后单击“管理标签”按钮（齿轮图标）。 您可以使用右上角的按钮备份和恢复此处的所有信息（标签列表、卡片的标签分配、颜色、文件夹设置等）。 您可以使用左侧的夹点按钮对标签重新排序，因为它们将显示在角色管理的标签过滤器中。 警告 标签备份 JSON 文件不适合与其他人共享，因为它仅包含特定于您的实例的信息，例如内部实体名称！ 导入角色卡时导入标签 从下载的图像（或从“从外部 URL 导入内容”按钮）导入外部角色卡时，系统会提示您选择导入其中包含的标签。卡的功能不需要它们；标签只是有组织性的。 嵌入式卡标签存储在角色编辑器的“高级定义”菜单的“创建者元数据”部分中。如果您希望向要导入角色的其他用户建议一些标签，请使用逗号分隔的标签列表填充“要嵌入的标签”字段。 注意事项 仅当用户设置选项“导入卡标签”设置为“询问”时，才会出现此弹出窗口。 在打开的“导入角色名称标签”弹出窗口中，您将看到现有标签（您本地已有且名称匹配）和新标签（您本地没有）的列表。 您可以： 根据需要修剪列表，然后点击“导入” - 剩余的现有标签将添加到导入的角色卡中，剩余的新标签将在本地创建，然后添加到卡中。 或者只需点击“不导入”即可忽略角色卡中包含的标签并仅导入该卡。 或者“导入全部”作为导入角色卡中找到的所有标签的快捷方式（注意：包括您从上面列表中修剪的任何标签；如果这样做，请使用“导入”按钮）。 或者“导入现有”作为仅导入本地存在且名称匹配的标签的快捷方式。 过滤角色卡 创建标签后，您将在角色管理面板中的一行中看到它们。您可以点击这些来切换标签过滤状态；按顺序： 单击一下即可显示标有此标签的卡片。 再次单击仅显示未标记此标签的卡片。 再次单击可重置此标签的过滤。 您可以同时按任意数量的标签进行过滤。 标签作为文件夹 注意事项 要使用此功能，必须首先在“用户设置”的“UI 主题”列下启用它。此切换的状态也会随 UI 主题一起保存。 从“管理标签”按钮（齿轮图标），每个标签条目都有一个多状态切换按钮，可在这些标签即文件夹模式之间循环（在代码中称为“虚假文件夹”）： 一键将此标签变成“打开的文件夹”。它将在卡片列表中显示为虚拟条目；单击它只会显示带有该标签的卡片 再次单击可将此标签变成“关闭的文件夹”。如上所述，但默认情况下不会显示标有此标签的卡片 - 您需要单击进入文件夹才能看到它们。 再次单击可重置此标签的标签为文件夹状态。",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/authors-note",
"title": "作者注释",
"group": "Characters",
"order": 50,
"source": "Usage/Characters/Author's-Note.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/authors-note/",
"sourceSha256": "f0579fb343d39d920246513d5241fc744246edca1318c96939f4324639255b6c",
"headings": [
{
"id": "authors-note",
"depth": 1,
"title": "作者注释"
},
{
"id": "what-is-it",
"depth": 2,
"title": "它是什么？"
},
{
"id": "usage",
"depth": 2,
"title": "使用指南"
},
{
"id": "configuring-authors-notes",
"depth": 2,
"title": "配置作者注释"
},
{
"id": "chat-specific-authors-note",
"depth": 3,
"title": "聊天专用作者注释"
},
{
"id": "placement-options",
"depth": 3,
"title": "安置选项"
},
{
"id": "after-scenario",
"depth": 4,
"title": "场景结束后"
},
{
"id": "in-chat",
"depth": 4,
"title": "聊天中"
},
{
"id": "insertion-frequency",
"depth": 3,
"title": "插入频率"
},
{
"id": "default-authors-note",
"depth": 3,
"title": "默认作者注释"
},
{
"id": "common-use-cases",
"depth": 2,
"title": "常见用例"
},
{
"id": "remind-ai-of-response-formatting",
"depth": 3,
"title": "提醒 AI 响应格式"
},
{
"id": "reinforcing-instructions",
"depth": 3,
"title": "强化指示"
},
{
"id": "as-temporary-world-info-character-bias-or-instruct-for-non-instruct-models",
"depth": 3,
"title": "作为临时世界书、角色 Bias 或非指令模型的指令"
}
],
"content": "# 作者注释\n\n## 它是什么？\n\n作者注释是一款用于自定义 AI 响应的强大工具，它可以在您想要的任何位置、以任何频率将一段文本插入到提示词中。\n\n## 使用指南\n\n作者注释可以在聊天输入栏左侧的选项菜单中找到。\n\n| 选项菜单 | 作者注释面板 |\n| ------------------------------------------------------ | ------------------------------------------------------- |\n|  |  |\n\n## 配置作者注释\n\n### 聊天专用作者注释\n\n作者注释面板顶部的框包含当前聊天的作者注释。\n\n**此框的内容不会自动转移到任何新的聊天中。**\n\n### 安置选项\n\n#### 场景结束后\n\n这会将作者注释置于角色定义的“场景”部分之后的上下文顶部。如果未指定场景，它将被放置在角色定义的最后部分之后、示例消息之前。\n\n#### 聊天中\n\n这会将作者注释放入聊天历史记录中指定的深度。\n\n深度 0 = 放置在聊天历史记录的最后。\n\n深度 4 = 放置在最近 3 条聊天记录消息之前，使其成为聊天记录中的第 4 个实体。\n\n*作者注释距离提示词的底部越近，对下一步 AI 响应的影响就越大。*\n\n### 插入频率\n\n这是您希望作者注释包含在聊天中的频率。\n\n频率 0 = 作者注释永远不会被插入。\n\n频率 1 = 作者注释将随每个用户输入提示词一起插入。\n\n频率 4 = 作者注释将插入到每 4 个用户输入提示词中。\n\n### 默认作者注释\n\n面板底部的框包含默认作者注释，它将应用于每个新聊天。\n\n## 常见用例\n\n### 提醒 AI 响应格式\n\n作者注释可用于指定 AI 应如何编写其响应。\n\n- \\[您的下一个回复长度必须为 300 token。]\n- \\[以埃德加·爱伦·坡的风格写下你的下一条回复]\n- \\[使用 markdown 斜体表示未说出的操作，使用引号表示说出的单词。]\n\n### 强化指示\n\n- \\[记住在聊天开始时给你的指示。]\n\n### 作为临时世界书、角色 Bias 或非指令模型的指令\n\n- \\[{{char}}在图书馆]\n- \\[{{user}} 腿上有新伤，所以无法逃跑。]\n- \\[{{char}} 无法说话，必须使用手势进行交流。]\n",
"searchText": "作者注释 它是什么？ 作者注释是一款用于自定义 AI 响应的强大工具，它可以在您想要的任何位置、以任何频率将一段文本插入到提示词中。 使用指南 作者注释可以在聊天输入栏左侧的选项菜单中找到。 选项菜单 作者注释面板 配置作者注释 聊天专用作者注释 作者注释面板顶部的框包含当前聊天的作者注释。 此框的内容不会自动转移到任何新的聊天中。 安置选项 场景结束后 这会将作者注释置于角色定义的“场景”部分之后的上下文顶部。如果未指定场景，它将被放置在角色定义的最后部分之后、示例消息之前。 聊天中 这会将作者注释放入聊天历史记录中指定的深度。 深度 0 = 放置在聊天历史记录的最后。 深度 4 = 放置在最近 3 条聊天记录消息之前，使其成为聊天记录中的第 4 个实体。 作者注释距离提示词的底部越近，对下一步 AI 响应的影响就越大。 插入频率 这是您希望作者注释包含在聊天中的频率。 频率 0 = 作者注释永远不会被插入。 频率 1 = 作者注释将随每个用户输入提示词一起插入。 频率 4 = 作者注释将插入到每 4 个用户输入提示词中。 默认作者注释 面板底部的框包含默认作者注释，它将应用于每个新聊天。 常见用例 提醒 AI 响应格式 作者注释可用于指定 AI 应如何编写其响应。 [您的下一个回复长度必须为 300 token。] [以埃德加·爱伦·坡的风格写下你的下一条回复] [使用 markdown 斜体表示未说出的操作，使用引号表示说出的单词。] 强化指示 [记住在聊天开始时给你的指示。] 作为临时世界书、角色 Bias 或非指令模型的指令 [{{char}}在图书馆] [{{user}} 腿上有新伤，所以无法逃跑。] [{{char}} 无法说话，必须使用手势进行交流。]",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/data-bank",
"title": "资料库",
"group": "Characters",
"order": 30,
"source": "Usage/Characters/data-bank.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/data-bank/",
"sourceSha256": "e6125eb63ac3183a73fcad53b2d525d6660f36c819f9f513f5107ae3295c309d",
"headings": [
{
"id": "data-bank-rag",
"depth": 1,
"title": "资料库"
},
{
"id": "accessing-the-data-bank",
"depth": 2,
"title": "访问资料库"
},
{
"id": "about-documents",
"depth": 2,
"title": "关于文件"
},
{
"id": "data-sources",
"depth": 2,
"title": "数据来源"
},
{
"id": "notepad",
"depth": 3,
"title": "记事本"
},
{
"id": "file",
"depth": 3,
"title": "文件"
},
{
"id": "web",
"depth": 3,
"title": "网络"
},
{
"id": "youtube",
"depth": 3,
"title": "YouTube"
},
{
"id": "web-search",
"depth": 3,
"title": "网页搜索"
},
{
"id": "fandom",
"depth": 3,
"title": "粉丝圈"
},
{
"id": "bronie-parser-extension-third-party",
"depth": 3,
"title": "Bronie 解析器扩展（第三方）"
},
{
"id": "vector-storage",
"depth": 2,
"title": "矢量存储"
},
{
"id": "vector-providers",
"depth": 2,
"title": "载体提供者"
},
{
"id": "local",
"depth": 3,
"title": "本地"
},
{
"id": "api-sources",
"depth": 3,
"title": "API来源"
},
{
"id": "vectorization-settings",
"depth": 2,
"title": "矢量化设置"
},
{
"id": "message-attachments",
"depth": 3,
"title": "留言附件"
},
{
"id": "data-bank-files",
"depth": 3,
"title": "资料库文件"
},
{
"id": "shared-settings",
"depth": 3,
"title": "共享设置"
},
{
"id": "conclusion",
"depth": 2,
"title": "结论"
}
],
"content": "# 资料库\n\n检索增强生成（RAG）是一种为法学硕士提供外部知识来源的技术。它通过访问模型训练数据之外的信息来帮助提高人工智能答案的准确性。\n\nSillyTavern 提供了一组工具，用于从多种来源构建多用途知识库，以及使用 LLM 提示词中收集的数据。\n\n## 访问资料库\n\n内置的聊天附件扩展（默认情况下包含在发行版本 >= 1.12.0 中）在“魔棒”菜单中添加了一个新选项 - 资料库。这是您管理 SillyTavern 中 RAG 可用文档的中心。\n\n## 关于文件\n\n资料库存储文件附件，也称为文档。这些文档分为三个可用范围。\n\n1. 全局附件 - 在每个聊天中都可用，无论是单独还是群组。\n2. 角色附件 - 仅适用于当前选择的角色，包括当他们在群组中回复时。 *附件保存在本地，不会通过角色卡导出！*\n3. 聊天附件 - 仅在当前打开的聊天中可用。聊天中的每个角色都可以从中拉取。\n\n> **注意事项**\n>\n> 虽然不是数据库的正式组成部分，但您甚至可以将文件附加到单条消息中。使用“Wand”菜单中的“附加文件”选项，或消息操作行中的回形针图标。\n\n什么可以是文档？实际上任何可以纯文本形式表示的东西！\n\n示例包括但不限于：\n\n- 本地文件（书籍、科学论文等）\n- 网页（维基百科、文章、新闻）\n- 视频文字记录\n\n各种扩展和插件还可以提供收集和处理数据的新方法，更多信息如下。\n\n## 数据来源\n\n要将文档添加到任何范围，请单击“添加”并选择可用来源之一。\n\n### 记事本\n\n从头开始创建文本文件，或编辑现有附件。\n\n### 文件\n\n从计算机的硬盘上传文件。 SillyTavern 提供流行文件格式的内置转换器：\n\n- PDF（仅限文本）\n- 超文本标记语言\n- 降价\n- 电子书\n- TXT\n\n您还可以附加任何带有非标准扩展名的文本文件，例如 JSON、YAML、源代码等。如果所选文件的类型没有已知的转换，并且该文件无法解析为纯文本文档，则文件上传将被拒绝，这意味着不允许使用原始二进制文件。\n\n> **注意事项**\n>\n> 导入 Microsoft Office（DOCX、PPTX、XLSX）和 LibreOffice 文档（ODT、ODP、ODS）需要 [服务器插件](https://github.com/SillyTavern/SillyTavern-Office-Parser) 进行安装和加载。有关安装说明，请参阅插件的自述文件页面。\n\n### 网络\n\n通过 URL 从网页中抓取文本。然后通过以下方式处理 HTML 文档 [可读性](https://github.com/mozilla/readability) 库仅提取可用的文本。\n\n某些 Web 服务器可能会拒绝获取请求、受到 Cloudflare 保护或严重依赖 JavaScript 来运行。如果您在任何特定网站上遇到问题，请通过网络浏览器手动下载该页面并使用文件上传器附加它。\n\n### YouTube\n\n通过 ID 或 URL 下载 YouTube 视频的文字记录，可以由创作者上传，也可以由 Google 自动生成。有些视频可能会禁用文字记录，而且由于需要登录，因此无法解析有年龄限制的视频。\n\n脚本以视频的默认语言加载。或者，您可以指定两个字母的语言代码来尝试获取特定语言的文字记录。此功能并不总是可用，并且可能会失败，因此请谨慎使用。\n\n### 网页搜索\n\n> **注意事项**\n>\n> 该源需要有一个 [网页搜索](https://docs.sillytavern.app/extensions/websearch/) 扩展已安装并正确配置。请参阅链接页面了解更多详细信息。\n\n执行网络搜索并从搜索结果页面下载文本。这与 Web 源类似，但完全自动化。所选的搜索引擎将从扩展设置继承，因此请提前设置。\n\n首先，指定搜索查询、要访问的最大链接数以及输出类型：一个组合文件（根据扩展规则格式化）或每个页面的单个文件。您也可以选择保存页面片段。\n\n### 粉丝圈\n\n> **注意事项**\n>\n> 该源需要有一个 [服务器插件](https://github.com/SillyTavern/SillyTavern-Fandom-Scraper) 安装并加载。有关安装说明，请参阅插件的自述文件页面。\n\n从a中抓取文章 [粉丝圈](https://www.fandom.com/) wiki 通过其 ID 或 URL。由于一些 wiki 非常大，使用过滤器正则表达式限制范围可能会有好处，它将根据文章的标题进行测试。如果未提供过滤器，则所有页面都将被导出。您可以将它们保存为每个页面的单独文件，也可以合并到一个文档中。\n\n### Bronie 解析器扩展（第三方）\n\n> **注意事项**\n>\n> 该来源来自第三方，并且是 **不隶属** 与 SillyTavern 团队。这个来源需要你有布洛妮娅·兰德的 [Bronie 解析器扩展](https://github.com/Bronya-Rand/Bronie-Parser-Extension) 安装以及需要解析器工作的服务器插件。\n\nBronya Rand 的 Bronie Parser Extension 允许使用第三方抓取工具，例如 miHoYo/HoYoverse 的 [好友实验室](https://wiki.hoyolab.com) 转换为 SillyTavern，与其他数据源类似。\n\n目前，Bronya Rand 的 Bronie Parser Extension 支持以下内容：\n\n- 米哈游 / HoYoverse 的 HoYoLab（用于《原神》和《崩坏：星穹铁道》），通过 [HoYoWiki-Scraper-TS](https://github.com/Bronya-Rand/HoYoWiki-Scraper-TS)\n\n首先，按照以下步骤安装 Bronya Rand 的 Bronie Parser Extension： [安装指南](https://github.com/Bronya-Rand/Bronie-Parser-Extension?tab=readme-ov-file#installation) 并将支持的服务器插件安装到 SillyTavern 中。重启SillyTavern，进入 *资料库* 菜单。点击 `+ Add` 您应该会看到最近安装的抓取工具已添加到可以从中获取信息的来源列表中。\n\n## 矢量存储\n\n因此，您已经为自己建立了一个关于您的特定主题的良好且全面的信息库。接下来怎么办？\n\n要使用 RAG 文档，您需要使用兼容的扩展，将相关数据插入到 LLM 提示词中。\n\n与 SillyTavern 捆绑在一起的矢量存储是此类扩展的参考实现。它使用嵌入（也称为向量）来搜索与您正在进行的聊天相关的文档。\n\n> **有趣的事实**\n>\n> 1. 嵌入是抽象表示一段文本的数字数组，由专门的语言模型生成。越相似的文本其各自向量之间的距离越短。\n> 2. 矢量存储扩展使用 [威达](https://github.com/Stevenic/vectra) 库来跟踪文件嵌入。它们存储在 JSON 文件中 `/vectors` 您的用户数据目录的文件夹。每个文档在内部都由其自己的索引/集合文件表示。\n\n由于矢量功能默认处于禁用状态，因此您需要打开扩展面板（顶部栏上的“堆叠立方体”图标），然后导航到“矢量存储”部分，并勾选“文件矢量化设置”下的“为文件启用”复选框。\n\n向量存储本身不会产生任何向量，您需要使用兼容的嵌入提供程序。\n\n## 载体提供者\n\n> **警告**\n>\n> 仅当使用生成嵌入的同一模型检索嵌入时，嵌入才可用。当改变嵌入模型或源时，需要重新计算向量。\n\n### 本地\n\n这些来源是免费且无限制的，并使用您的 CPU/GPU 来计算嵌入。\n\n1. 本地（Transformers）- 在节点服务器上运行。 SillyTavern 会自动从 HuggingFace 下载 ONNX 格式的兼容模型。默认型号： [jina-embeddings-v2-base-en](https://huggingface.co/Cohee/jina-embeddings-v2-base-en).\n2. WebLLM - 需要安装扩展程序和网络浏览器 [支持WebGPU](https://caniuse.com/webgpu)。直接在浏览器中运行，可以使用硬件加速。自动从 HuggingFace 下载支持的模型。从这里安装扩展： .\n3. 奥拉马 - 获取它 。在API连接菜单中设置API URL（在文本补全下，默认： `http://localhost:11434`）。必须先下载兼容的模型，然后在扩展设置中设置其名称。型号示例： [mxbai-嵌入-大](https://ollama.com/library/mxbai-embed-large)。 （可选）选中一个选项以将模型加载到内存中。\n4. llama.cpp 服务器 - 获取它 [ggerganov/llama.cpp](https://github.com/ggerganov/llama.cpp) 并运行服务器可执行文件 `--embedding` 标志。从 HuggingFace 加载兼容的 GGUF 嵌入模型，例如， [nomic-ai/nomic-embed-text-v1.5-GGUF](https://huggingface.co/nomic-ai/nomic-embed-text-v1.5-GGUF).\n5. vLLM - 获取它 [vllm-项目/vllm](https://github.com/vllm-project/vllm)。首先在API连接菜单中设置API URL和API密钥。\n6. Extras（已弃用）- 在 [附加 API](https://github.com/SillyTavern/SillyTavern-extras) 使用 SentenceTransformers 加载器。默认型号： [全 mpnet 基础 v2](https://huggingface.co/sentence-transformers/all-mpnet-base-v2)。此源未得到维护，将来最终将被删除。\n\n### API来源\n\n所有这些来源都需要相应服务的 API 密钥，并且通常会产生使用成本，但通常计算嵌入非常便宜。\n\n1. 开放人工智能\n2. 连贯\n3. 谷歌人工智能工作室\n4. 谷歌顶点人工智能\n5. 一起人工智能\n6. 米斯特拉尔人工智能\n7. 诺米克人工智能\n8. 开放路由器\n9. 电子集线器\n10. 滑道\n11. 纳米GPT\n12. 硅流\n13. Cloudflare Workers AI\n\n## 矢量化设置\n\n选择嵌入提供程序后，不要忘记配置其他设置来定义处理和检索文档的规则。\n\n> **注意事项**\n>\n> 从附件中分割、矢量化和检索信息需要一些时间。虽然文件的初始摄取可能需要一段时间，但 RAG 搜索查询通常足够快，不会造成明显的延迟。\n\n### 留言附件\n\n这些设置控制直接附加到邮件的文件。\n\n以下规则适用：\n\n1. 只有适合 LLM 上下文窗口的邮件才能检索其附件。\n2. 当矢量存储扩展被禁用时，文件附件及其附带消息将完全插入提示词中。\n3. 启用文件矢量化后，文件将被分割成块，并且仅插入最相关的部分，从而节省上下文空间并允许模型保持专注。\n\n- 大小阈值 (KB) - 设置分块分割阈值。只有大于指定大小的文件才会被分割。\n- 块大小（字符）- 设置单个块的目标大小（在文本角色中，而不是模型 token！）。\n- 块重叠 (%) - 设置相邻块之间共享的块大小的百分比。这允许块之间更平滑的过渡，但也可能引入一些冗余。\n- 检索块 - 设置要检索的最相关文件块的最大数量。它们将按原始顺序插入。\n\n### 资料库文件\n\n这些设置控制资料库文档的处理方式。\n\n以下规则适用：\n\n1. 禁用文件矢量化时，不使用资料库。\n2. 否则，当前范围（见上文）中的所有可用文档都将被考虑用于查询。仅检索所有文件中最相关的块。同一文件的多个块按其原始顺序插入。\n3. 插入的块将在适合聊天消息之前保留一部分上下文。\n\n- 大小阈值 (KB) - 设置分块分割阈值。只有大于指定大小的文件才会被分割。\n- 块大小（字符）- 设置单个块的目标大小（在文本角色中，而不是模型 token！）。\n- 块重叠 (%) - 设置相邻块之间共享的块大小的百分比。这允许块之间更平滑的过渡，但也可能引入一些冗余。\n- 检索块 - 设置要检索的文件块的最大数量。该限额在所有文件之间共享。\n- 注入模板 - 定义如何将检索到的信息插入到提示词中。您可以使用特殊的 {{text}} 宏以及任何其他宏来指定检索到的文本的位置。\n- 注射位置 - 设置插入提示词注射的位置。适用与作者注释和世界书相同的规则。\n\n### 共享设置\n\n- 查询消息 - 有多少最新的聊天消息将用于查询文档块。\n- 分数阈值 - 调整以允许根据相关性分数剔除块的检索（0 - 根本不匹配，1 - 完美匹配）。较高的值允许更准确的检索并防止完全随机的信息进入上下文。 Sane 值的范围在 0.2（更宽松）和 0.5（更集中）之间。\n- 块边界 - 将文件拆分为块时将优先考虑的自定义字符串。如果未指定，则默认按（按顺序）双换行符、单换行符和单词之间的空格进行分割。\n- 仅在自定义边界上分块 - 如果启用，分块将仅发生在指定的块边界上。否则，分块也会发生在默认边界上。\n- 在处理之前将文件翻译成英语 - 如果启用，将使用在 [聊天翻译](https://docs.sillytavern.app/extensions/translation/) 扩展名在处理文件之前将文件翻译成英语。当使用仅支持英文文本的嵌入模型时，这非常有用。\n- 包含在世界书扫描中 - 检查是否希望注入的内容激活传说书籍条目。\n- Vectorize All - 强制摄取所有未处理文件的嵌入。\n- 清除向量 - 清除文件嵌入，允许重新计算它们的向量。\n\n> **注意事项**\n>\n> 对于“聊天矢量化”设置，请参阅 [聊天矢量化](https://docs.sillytavern.app/extensions/chat-vectorization/).\n\n## 结论\n\n恭喜！ RAG 的强大功能现在增强了您的聊天体验。它的功能仅受您的想象力的限制。一如既往，不要害怕尝试！\n",
"searchText": "资料库 检索增强生成（RAG）是一种为法学硕士提供外部知识来源的技术。它通过访问模型训练数据之外的信息来帮助提高人工智能答案的准确性。 SillyTavern 提供了一组工具，用于从多种来源构建多用途知识库，以及使用 LLM 提示词中收集的数据。 访问资料库 内置的聊天附件扩展（默认情况下包含在发行版本 >= 1.12.0 中）在“魔棒”菜单中添加了一个新选项 - 资料库。这是您管理 SillyTavern 中 RAG 可用文档的中心。 关于文件 资料库存储文件附件，也称为文档。这些文档分为三个可用范围。 全局附件 - 在每个聊天中都可用，无论是单独还是群组。 角色附件 - 仅适用于当前选择的角色，包括当他们在群组中回复时。 附件保存在本地，不会通过角色卡导出！ 聊天附件 - 仅在当前打开的聊天中可用。聊天中的每个角色都可以从中拉取。 注意事项 虽然不是数据库的正式组成部分，但您甚至可以将文件附加到单条消息中。使用“Wand”菜单中的“附加文件”选项，或消息操作行中的回形针图标。 什么可以是文档？实际上任何可以纯文本形式表示的东西！ 示例包括但不限于： 本地文件（书籍、科学论文等） 网页（维基百科、文章、新闻） 视频文字记录 各种扩展和插件还可以提供收集和处理数据的新方法，更多信息如下。 数据来源 要将文档添加到任何范围，请单击“添加”并选择可用来源之一。 记事本 从头开始创建文本文件，或编辑现有附件。 文件 从计算机的硬盘上传文件。 SillyTavern 提供流行文件格式的内置转换器： PDF（仅限文本） 超文本标记语言 降价 电子书 TXT 您还可以附加任何带有非标准扩展名的文本文件，例如 JSON、YAML、源代码等。如果所选文件的类型没有已知的转换，并且该文件无法解析为纯文本文档，则文件上传将被拒绝，这意味着不允许使用原始二进制文件。 注意事项 导入 Microsoft Office（DOCX、PPTX、XLSX）和 LibreOffice 文档（ODT、ODP、ODS）需要 服务器插件 进行安装和加载。有关安装说明，请参阅插件的自述文件页面。 网络 通过 URL 从网页中抓取文本。然后通过以下方式处理 HTML 文档 可读性 库仅提取可用的文本。 某些 Web 服务器可能会拒绝获取请求、受到 Cloudflare 保护或严重依赖 JavaScript 来运行。如果您在任何特定网站上遇到问题，请通过网络浏览器手动下载该页面并使用文件上传器附加它。 YouTube 通过 ID 或 URL 下载 YouTube 视频的文字记录，可以由创作者上传，也可以由 Google 自动生成。有些视频可能会禁用文字记录，而且由于需要登录，因此无法解析有年龄限制的视频。 脚本以视频的默认语言加载。或者，您可以指定两个字母的语言代码来尝试获取特定语言的文字记录。此功能并不总是可用，并且可能会失败，因此请谨慎使用。 网页搜索 注意事项 该源需要有一个 网页搜索 扩展已安装并正确配置。请参阅链接页面了解更多详细信息。 执行网络搜索并从搜索结果页面下载文本。这与 Web 源类似，但完全自动化。所选的搜索引擎将从扩展设置继承，因此请提前设置。 首先，指定搜索查询、要访问的最大链接数以及输出类型：一个组合文件（根据扩展规则格式化）或每个页面的单个文件。您也可以选择保存页面片段。 粉丝圈 注意事项 该源需要有一个 服务器插件 安装并加载。有关安装说明，请参阅插件的自述文件页面。 从a中抓取文章 粉丝圈 wiki 通过其 ID 或 URL。由于一些 wiki 非常大，使用过滤器正则表达式限制范围可能会有好处，它将根据文章的标题进行测试。如果未提供过滤器，则所有页面都将被导出。您可以将它们保存为每个页面的单独文件，也可以合并到一个文档中。 Bronie 解析器扩展（第三方） 注意事项 该来源来自第三方，并且是 不隶属 与 SillyTavern 团队。这个来源需要你有布洛妮娅·兰德的 Bronie 解析器扩展 安装以及需要解析器工作的服务器插件。 Bronya Rand 的 Bronie Parser Extension 允许使用第三方抓取工具，例如 miHoYo/HoYoverse 的 好友实验室 转换为 SillyTavern，与其他数据源类似。 目前，Bronya Rand 的 Bronie Parser Extension 支持以下内容： 米哈游 / HoYoverse 的 HoYoLab（用于《原神》和《崩坏：星穹铁道》），通过 HoYoWiki-Scraper-TS 首先，按照以下步骤安装 Bronya Rand 的 Bronie Parser Extension： 安装指南 并将支持的服务器插件安装到 SillyTavern 中。重启SillyTavern，进入 资料库 菜单。点击 + Add 您应该会看到最近安装的抓取工具已添加到可以从中获取信息的来源列表中。 矢量存储 因此，您已经为自己建立了一个关于您的特定主题的良好且全面的信息库。接下来怎么办？ 要使用 RAG 文档，您需要使用兼容的扩展，将相关数据插入到 LLM 提示词中。 与 SillyTavern 捆绑在一起的矢量存储是此类扩展的参考实现。它使用嵌入（也称为向量）来搜索与您正在进行的聊天相关的文档。 有趣的事实 嵌入是抽象表示一段文本的数字数组，由专门的语言模型生成。越相似的文本其各自向量之间的距离越短。 矢量存储扩展使用 威达 库来跟踪文件嵌入。它们存储在 JSON 文件中 /vectors 您的用户数据目录的文件夹。每个文档在内部都由其自己的索引/集合文件表示。 由于矢量功能默认处于禁用状态，因此您需要打开扩展面板（顶部栏上的“堆叠立方体”图标），然后导航到“矢量存储”部分，并勾选“文件矢量化设置”下的“为文件启用”复选框。 向量存储本身不会产生任何向量，您需要使用兼容的嵌入提供程序。 载体提供者 警告 仅当使用生成嵌入的同一模型检索嵌入时，嵌入才可用。当改变嵌入模型或源时，需要重新计算向量。 本地 这些来源是免费且无限制的，并使用您的 CPU/GPU 来计算嵌入。 本地（Transformers）- 在节点服务器上运行。 SillyTavern 会自动从 HuggingFace 下载 ONNX 格式的兼容模型。默认型号： jina-embeddings-v2-base-en. WebLLM - 需要安装扩展程序和网络浏览器 支持WebGPU。直接在浏览器中运行，可以使用硬件加速。自动从 HuggingFace 下载支持的模型。从这里安装扩展： https://github.com/SillyTavern/Extension-WebLLM. 奥拉马 - 获取它 https://ollama.com/。在API连接菜单中设置API URL（在文本补全下，默认： http://localhost:11434）。必须先下载兼容的模型，然后在扩展设置中设置其名称。型号示例： mxbai-嵌入-大。 （可选）选中一个选项以将模型加载到内存中。 llama.cpp 服务器 - 获取它 ggerganov/llama.cpp 并运行服务器可执行文件 --embedding 标志。从 HuggingFace 加载兼容的 GGUF 嵌入模型，例如， nomic-ai/nomic-embed-text-v1.5-GGUF. vLLM - 获取它 vllm-项目/vllm。首先在API连接菜单中设置API URL和API密钥。 Extras（已弃用）- 在 附加 API 使用 SentenceTransformers 加载器。默认型号： 全 mpnet 基础 v2。此源未得到维护，将来最终将被删除。 API来源 所有这些来源都需要相应服务的 API 密钥，并且通常会产生使用成本，但通常计算嵌入非常便宜。 开放人工智能 连贯 谷歌人工智能工作室 谷歌顶点人工智能 一起人工智能 米斯特拉尔人工智能 诺米克人工智能 开放路由器 电子集线器 滑道 纳米GPT 硅流 Cloudflare Workers AI 矢量化设置 选择嵌入提供程序后，不要忘记配置其他设置来定义处理和检索文档的规则。 注意事项 从附件中分割、矢量化和检索信息需要一些时间。虽然文件的初始摄取可能需要一段时间，但 RAG 搜索查询通常足够快，不会造成明显的延迟。 留言附件 这些设置控制直接附加到邮件的文件。 以下规则适用： 只有适合 LLM 上下文窗口的邮件才能检索其附件。 当矢量存储扩展被禁用时，文件附件及其附带消息将完全插入提示词中。 启用文件矢量化后，文件将被分割成块，并且仅插入最相关的部分，从而节省上下文空间并允许模型保持专注。 大小阈值 (KB) - 设置分块分割阈值。只有大于指定大小的文件才会被分割。 块大小（字符）- 设置单个块的目标大小（在文本角色中，而不是模型 token！）。 块重叠 (%) - 设置相邻块之间共享的块大小的百分比。这允许块之间更平滑的过渡，但也可能引入一些冗余。 检索块 - 设置要检索的最相关文件块的最大数量。它们将按原始顺序插入。 资料库文件 这些设置控制资料库文档的处理方式。 以下规则适用： 禁用文件矢量化时，不使用资料库。 否则，当前范围（见上文）中的所有可用文档都将被考虑用于查询。仅检索所有文件中最相关的块。同一文件的多个块按其原始顺序插入。 插入的块将在适合聊天消息之前保留一部分上下文。 大小阈值 (KB) - 设置分块分割阈值。只有大于指定大小的文件才会被分割。 块大小（字符）- 设置单个块的目标大小（在文本角色中，而不是模型 token！）。 块重叠 (%) - 设置相邻块之间共享的块大小的百分比。这允许块之间更平滑的过渡，但也可能引入一些冗余。 检索块 - 设置要检索的文件块的最大数量。该限额在所有文件之间共享。 注入模板 - 定义如何将检索到的信息插入到提示词中。您可以使用特殊的 {{text}} 宏以及任何其他宏来指定检索到的文本的位置。 注射位置 - 设置插入提示词注射的位置。适用与作者注释和世界书相同的规则。 共享设置 查询消息 - 有多少最新的聊天消息将用于查询文档块。 分数阈值 - 调整以允许根据相关性分数剔除块的检索（0 - 根本不匹配，1 - 完美匹配）。较高的值允许更准确的检索并防止完全随机的信息进入上下文。 Sane 值的范围在 0.2（更宽松）和 0.5（更集中）之间。 块边界 - 将文件拆分为块时将优先考虑的自定义字符串。如果未指定，则默认按（按顺序）双换行符、单换行符和单词之间的空格进行分割。 仅在自定义边界上分块 - 如果启用，分块将仅发生在指定的块边界上。否则，分块也会发生在默认边界上。 在处理之前将文件翻译成英语 - 如果启用，将使用在 聊天翻译 扩展名在处理文件之前将文件翻译成英语。当使用仅支持英文文本的嵌入模型时，这非常有用。 包含在世界书扫描中 - 检查是否希望注入的内容激活传说书籍条目。 Vectorize All - 强制摄取所有未处理文件的嵌入。 清除向量 - 清除文件嵌入，允许重新计算它们的向量。 注意事项 对于“聊天矢量化”设置，请参阅 聊天矢量化. 结论 恭喜！ RAG 的强大功能现在增强了您的聊天体验。它的功能仅受您的想象力的限制。一如既往，不要害怕尝试！",
"translationStatus": "machine-draft"
},
{
"slug": "prompts",
"title": "提示词",
"group": "Prompts",
"order": 140,
"source": "Usage/Prompts/index.md",
"sourceUrl": "https://docs.sillytavern.app/usage/prompts/",
"sourceSha256": "951ea304940995124fc28f921ff825416e95967a032154b6039ea8287cdd45d0",
"headings": [
{
"id": "prompts",
"depth": 1,
"title": "提示词"
},
{
"id": "viewing-the-prompt",
"depth": 2,
"title": "查看提示词"
},
{
"id": "changing-how-the-prompt-is-built",
"depth": 2,
"title": "改变提示词的构建方式"
},
{
"id": "main-prompt-system-prompt",
"depth": 2,
"title": "主提示词（系统提示词）"
},
{
"id": "adjusting-the-main-prompt",
"depth": 3,
"title": "调整主提示词"
},
{
"id": "effect-of-message-history",
"depth": 3,
"title": "消息历史记录的影响"
},
{
"id": "removing-the-fictional-chat-context",
"depth": 3,
"title": "删除“虚构聊天”上下文"
},
{
"id": "ai-as-narrator-or-storyteller",
"depth": 3,
"title": "人工智能作为叙述者或讲故事的人"
},
{
"id": "post-history-instructions",
"depth": 2,
"title": "历史后指令"
},
{
"id": "adding-to-the-prompt-world-info",
"depth": 2,
"title": "添加到提示词 (世界书)"
}
],
"content": "# 提示词\n\n当您向 AI 发送消息时，您编写的文本会与其他文本组合在一起，形成发送给 AI 的单个请求。这种组合文本称为“提示词”，有时也称为“请求”或“上下文”。\n\n提示词可以包含各种不同类型的文本，包括：\n\n- [主要说明](#main-prompt-system-prompt) 向 AI 询问如何生成响应\n- 的定义 [AI应该扮演的角色](/guides/sillytavern/core-concepts/characterdesign/)\n- 的定义 [你所扮演的角色](/guides/sillytavern/core-concepts/personas/)\n- [关于“世界”的信息](/guides/sillytavern/core-concepts/worldinfo/) AI正在与之交互\n- 相关文件或资料来自 [资料库](/guides/sillytavern/core-concepts/data-bank/)\n- [摘要](https://docs.sillytavern.app/extensions/summarize/) 过去的谈话\n- 结果 [网络搜索](https://docs.sillytavern.app/extensions/websearch/) 或其他 [外部数据源](https://docs.sillytavern.app/for-contributors/function-calling/)\n- 对话中的先前消息\n- **你给人工智能的信息**\n- [最终说明](#post-history-instructions) 让人工智能了解如何生成响应\n\n这可能需要管理很多事情！为了帮助您了解如何构建和修改发送到 AI 的请求，SillyTavern 标识了您可能想要包含在提示词中的不同元素。然后，您可以构建提示词，以包含对您想要与 AI 交互的方式有意义的内容。\n\n其中许多元素在您将更改它们的部分中进行了解释。例如，要描述您希望人工智能扮演的角色，您可以使用 [描述](/guides/sillytavern/core-concepts/characterdesign/#personality-summary) 领域在 [角色设计](/guides/sillytavern/core-concepts/characterdesign/).\n\n## 查看提示词\n\n阅读发送给 AI 的最终提示词对于理解 AI 被告知的内容以及为什么它会生成这样的响应非常有帮助。您可以通过多种方式查看提示词：\n\n- 使用 AI 回复消息上的提示词逐项图标\n- 使用 [提示词检验员](https://github.com/SillyTavern/Extension-PromptInspector) 延伸\n- 检查运行 SillyTavern 的终端窗口中的日志\n- 在浏览器的开发者工具中检查控制台\n\n## 改变提示词的构建方式\n\n以正确的方式向人工智能展示提示词的所有部分对于获得最佳响应至关重要。您可以控制提示词的构建方式。\n\n**文本补全 API**\n\n使用 [高级格式设置](/guides/sillytavern/core-concepts/advancedformatting/) 面板为文本补全 API 定制提示词构造。\n\n**聊天补全 API**\n\n使用 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/) 为聊天补全 API 定制提示词构造。\n\n## 主提示词（系统提示词）\n\n主提示词（或系统提示词）定义了模型要遵循的一般指令。它为对话定下了基调和背景。例如，它告诉模型充当 AI 助手、写作伙伴或虚构的角色。\n\n**文本补全 API**\n\n的 [系统提示词](/guides/sillytavern/core-concepts/advancedformatting/#system-prompt) 是的一部分 [故事串](/guides/sillytavern/prompts/context-template/#story-string) 通常是模型收到的提示词的第一部分。\n\n**聊天补全 API**\n\n主提示词是默认提示词之一 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/)。它通常是模型收到的上下文中的第一条消息，归因于系统角色（“发送者”）。\n\n默认的主提示词是：\n\n> 在 {{char}} 和 {{user}} 之间的虚构聊天中写下 {{char}} 的下一条回复。\n\n{{char}} 和 {{user}} 占位符将替换为您在对话中定义的角色和用户人设的名称。\n\n您可以使用任何受支持的 [{{macro}}](/guides/sillytavern/core-concepts/macros/) 主提示词中的标签包含在对话之间可能有所不同或随着对话的进行而变化的信息。\n\n### 调整主提示词\n\n默认的主提示词帮助模型了解预期如何处理后面的角色和用户人设信息、如何解释过去的对话以及生成什么样的响应。它是一个灵活的通用提示词，适用于许多情况，因为它确定 AI 在与用户人设的对话中以角色的形式进行书写。\n\n但是，您可以调整主提示词以更好地满足您的需求。以下是调整主要提示词的一些常见原因：\n\n- **提供附加说明**：例如，您希望 AI 解释其推理、遵循特定规则或避免某些主题\n- **明确人工智能的作用**：例如，您希望 AI 充当叙述者、讲故事的人或向导\n- **改变对话的上下文**：例如，您希望 AI 像 AI 助手、文本冒险游戏或写作伙伴一样做出响应\n\n> **尝试一下，看看什么最适合你**\n>\n> 本指南中的所有示例都适用于其他用户，但适合您需求的提示词和您使用的型号可能会有所不同。尝试不同的说明和提示方式，看看哪种最适合您。如果您不确定要尝试什么，您可以随时在 [SillyTavern 不和谐](https://discord.gg/sillytavern).\n\n在主提示词中向 AI 提供附加指令可以帮助它理解您想要从对话中获得什么。\n\n> 只写一篇回复。至少写一段，最多四段。\n\n> 降价已启用。用它来格式化你的回复。将代码片段括在三个反引号中。\n\n> 将角色对话写在引号中。把{{char}}的想法写在括号里。\n\n> 您是一位面向 13 至 17 岁用户的动漫角色扮演生成模型。您总是能产生有趣且适合年龄的反应。\n\n> 如实回答并逐步写出您的想法，以确保您得到正确的答案。\n\n人工智能会更容易地遵循关于它应该做什么而不是不应该做什么的指令。例如，如果你希望人工智能避免以某种方式书写，最好告诉它你希望它如何书写。而同时 *“不要决定 {{user}} 说什么或做什么”* 通常包含在提示词中以防止 AI 控制您的用户人设，一些用户发现 *“以尊重 {{user}} 自主权的方式编写 {{char}} 的响应”* 更有效。\n\n通常有比主提示词更好的地方来包含有关用户或角色的信息，修改角色的写作和说话风格，或给出其他具体指令。主要提示词最适合用于有关整个对话或您想要进行的对话类型的一般说明。\n\n### 消息历史记录的影响\n\n当调整主提示词以改善 AI 的响应时，请考虑 AI 从消息历史记录中获取大量信息。历史是对过去事件的记忆，是角色的互动和关系，是对选词和写作风格的风格指南。\n\n通过还提供来利用这一点来发挥您的优势 [示例消息](/guides/sillytavern/core-concepts/characterdesign/#examples-of-dialogue) 显示您希望人工智能如何响应。展示你想要的东西通常比试图解释它更容易！\n\n当你的对话已经有历史记录时，更改主提示词对 AI 响应的影响有限。在事件和关系方面，AI假设主要的提示词发生在遥远的过去，并且消息历史记录更新它。在写作风格和用词方面，人工智能假设历史上的所有消息都是根据文本中的规则生成的。 *当前* main 提示词，并且它应该继续以相同的方式生成消息。处理这个问题的一些建议是：\n\n- 在接近消息历史记录末尾或之后插入当前指令，例如使用 [作者注释](/guides/sillytavern/core-concepts/authors-note/)\n- 通过开始新对话来测试对主提示词的更改\n- 编辑消息历史记录以删除或更正不良行为的示例\n- 使用 [历史后指令](#post-history-instructions) 向AI提供最终指令\n\n> **第一次就做对！**\n>\n> 永远不要让人工智能“逃脱”你不希望它做的事情。如果你不喜欢人工智能的反应，就不要继续对话，就好像它是正确的一样。相反，修改提示词，重新生成消息，然后从那里继续。这将帮助人工智能了解你想要什么。\n\n### 删除“虚构聊天”上下文\n\n在某些情况下，“虚构的聊天”可能不适合您的对话。\n\n您可以从主提示词中删除“虚构”上下文：\n\n> 在与 {{user}} 的对话中写下 {{char}} 的下一条回复。\n\n你可能根本不希望人工智能将自己视为角色扮演。您可以删除 AI 的想法，而不是删除角色的想法：\n\n> 你是{{char}}，一位乐于助人的助手。您提供有用的信息并帮助 {{user}} 解决他们的问题。\n\n### 人工智能作为叙述者或讲故事的人\n\n如果你想让 AI 充当叙述者，从全知的角度描述事件，发明自己的角色和设置，该怎么办？\n\n一种方法是创建一个名为角色的 AI 来用作叙述者。这个角色可以被称为“叙述者”或“AI”，表明AI是一个通用的讲故事者，或者它可以以特定的场景或设置命名，让AI承担在该设置中讲述故事的任务。然后可以在中定义设置的详细信息 [角色](/guides/sillytavern/core-concepts/characterdesign/) 或在 [世界书](/guides/sillytavern/core-concepts/worldinfo/).\n\n您需要调整默认的主提示词以反映 AI 的角色。对于通用叙述者，您可以使用：\n\n> 你是 {{char}}，一位技艺精湛、多才多艺的讲故事者。叙述故事。\n\n或对于特定设置：\n\n> 你是一个奇幻场景的叙述者。扮演访问 {{char}} 的角色。\n\n它有助于澄清用户在对话中的角色。您的消息是故事的一部分，还是向叙述者说明您的角色做了或说了什么？故事中包含用户的示例：\n\n> 故事应该通过响应{{user}}的动作和对话来进展。以第三人称叙述故事。\n\n一个让用户远离故事的例子：\n\n> 进入冒险模式。根据{{user}}的对话和“>”之后的动作来叙述故事。生动详细地描述周围环境。详细、有创意、冗长且积极主动。通过引入奇幻元素和有趣的角色来推动故事的发展。\n\n定义用户的角色不仅可以帮助AI了解如何回复你的消息，还可以帮助它在多大程度上控制你的用户人设。这可以避免人工智能为您的用户人设做出您宁愿自己做的决定的情况。\n\n## 历史后指令\n\n历史后指令 (PHI) 是在主提示词和用户消息之后发送到 AI 的附加指令。它们可用于根据消息历史记录向人工智能提供额外的上下文或指令。\n\n由于历史后指令是在用户消息之后发送的，因此它们是 AI 在生成响应之前收到的最终指令。 AI通常给予它们比主提示词更高的优先级，并且它们可以覆盖主提示词的指令。\n\n要使用每个角色历史记录指令，请将它们添加到角色的 [历史后指令](/guides/sillytavern/core-concepts/characterdesign/) 并启用 [更喜欢查尔。指示](/guides/sillytavern/user-settings/)。要在使用角色特定指令时保留全局定义的 PHI，您可以使用 `{{original}}` 角色的历史记录后指令字段中的宏。\n\n**文本补全 API**\n\n历史后指令定义在 [高级格式设置](/guides/sillytavern/core-concepts/advancedformatting/) 系统提示词类别下的面板。历史后指令作为不可见的用户角色注入添加到提示词最后一行（通常包含响应消息“标头”）之前。请注意，必须启用“启用系统提示词”切换才能应用历史记录指令（即使系统提示词本身为空）。\n\n**聊天补全 API**\n\n历史后指令是默认的提示词之一 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/)。它通常是模型收到的上下文中的最后一条消息，归因于系统角色（“发送者”）。如果您的聊天补全 API 不支持系统角色，通常会归因于用户角色。\n\n## 添加到提示词 (世界书)\n\n您可以使用以下命令在提示词中的任何位置插入附加信息 [世界书](/guides/sillytavern/core-concepts/worldinfo/) 功能。通过设置何时插入信息的条件，您可以引导人工智能包含特定细节、更改其响应方式或向对话添加新元素。\n\n世界书的一些常见用途包括：\n\n- 包含有关世界或环境的信息的“世界书”或“百科全书”\n- 一种针对各种角色和情况管理不同系统提示词的方法\n- 存储人工智能应该在对话中“回忆”的记忆的地方\n- 用于创建、编辑和共享角色详细信息的更加模块化的系统\n- 随机事件和惊喜的来源，供人工智能做出反应，或让你做出反应！\n",
"searchText": "提示词 当您向 AI 发送消息时，您编写的文本会与其他文本组合在一起，形成发送给 AI 的单个请求。这种组合文本称为“提示词”，有时也称为“请求”或“上下文”。 提示词可以包含各种不同类型的文本，包括： 主要说明 向 AI 询问如何生成响应 的定义 AI应该扮演的角色 的定义 你所扮演的角色 关于“世界”的信息 AI正在与之交互 相关文件或资料来自 资料库 摘要 过去的谈话 结果 网络搜索 或其他 外部数据源 对话中的先前消息 你给人工智能的信息 最终说明 让人工智能了解如何生成响应 这可能需要管理很多事情！为了帮助您了解如何构建和修改发送到 AI 的请求，SillyTavern 标识了您可能想要包含在提示词中的不同元素。然后，您可以构建提示词，以包含对您想要与 AI 交互的方式有意义的内容。 其中许多元素在您将更改它们的部分中进行了解释。例如，要描述您希望人工智能扮演的角色，您可以使用 描述 领域在 角色设计. 查看提示词 阅读发送给 AI 的最终提示词对于理解 AI 被告知的内容以及为什么它会生成这样的响应非常有帮助。您可以通过多种方式查看提示词： 使用 AI 回复消息上的提示词逐项图标 使用 提示词检验员 延伸 检查运行 SillyTavern 的终端窗口中的日志 在浏览器的开发者工具中检查控制台 改变提示词的构建方式 以正确的方式向人工智能展示提示词的所有部分对于获得最佳响应至关重要。您可以控制提示词的构建方式。 文本补全 API 使用 高级格式设置 面板为文本补全 API 定制提示词构造。 聊天补全 API 使用 提示词管理器 为聊天补全 API 定制提示词构造。 主提示词（系统提示词） 主提示词（或系统提示词）定义了模型要遵循的一般指令。它为对话定下了基调和背景。例如，它告诉模型充当 AI 助手、写作伙伴或虚构的角色。 文本补全 API 的 系统提示词 是的一部分 故事串 通常是模型收到的提示词的第一部分。 聊天补全 API 主提示词是默认提示词之一 提示词管理器。它通常是模型收到的上下文中的第一条消息，归因于系统角色（“发送者”）。 默认的主提示词是： 在 {{char}} 和 {{user}} 之间的虚构聊天中写下 {{char}} 的下一条回复。 {{char}} 和 {{user}} 占位符将替换为您在对话中定义的角色和用户人设的名称。 您可以使用任何受支持的 {{macro}} 主提示词中的标签包含在对话之间可能有所不同或随着对话的进行而变化的信息。 调整主提示词 默认的主提示词帮助模型了解预期如何处理后面的角色和用户人设信息、如何解释过去的对话以及生成什么样的响应。它是一个灵活的通用提示词，适用于许多情况，因为它确定 AI 在与用户人设的对话中以角色的形式进行书写。 但是，您可以调整主提示词以更好地满足您的需求。以下是调整主要提示词的一些常见原因： 提供附加说明：例如，您希望 AI 解释其推理、遵循特定规则或避免某些主题 明确人工智能的作用：例如，您希望 AI 充当叙述者、讲故事的人或向导 改变对话的上下文：例如，您希望 AI 像 AI 助手、文本冒险游戏或写作伙伴一样做出响应 尝试一下，看看什么最适合你 本指南中的所有示例都适用于其他用户，但适合您需求的提示词和您使用的型号可能会有所不同。尝试不同的说明和提示方式，看看哪种最适合您。如果您不确定要尝试什么，您可以随时在 SillyTavern 不和谐. 在主提示词中向 AI 提供附加指令可以帮助它理解您想要从对话中获得什么。 只写一篇回复。至少写一段，最多四段。 降价已启用。用它来格式化你的回复。将代码片段括在三个反引号中。 将角色对话写在引号中。把{{char}}的想法写在括号里。 您是一位面向 13 至 17 岁用户的动漫角色扮演生成模型。您总是能产生有趣且适合年龄的反应。 如实回答并逐步写出您的想法，以确保您得到正确的答案。 人工智能会更容易地遵循关于它应该做什么而不是不应该做什么的指令。例如，如果你希望人工智能避免以某种方式书写，最好告诉它你希望它如何书写。而同时 “不要决定 {{user}} 说什么或做什么” 通常包含在提示词中以防止 AI 控制您的用户人设，一些用户发现 “以尊重 {{user}} 自主权的方式编写 {{char}} 的响应” 更有效。 通常有比主提示词更好的地方来包含有关用户或角色的信息，修改角色的写作和说话风格，或给出其他具体指令。主要提示词最适合用于有关整个对话或您想要进行的对话类型的一般说明。 消息历史记录的影响 当调整主提示词以改善 AI 的响应时，请考虑 AI 从消息历史记录中获取大量信息。历史是对过去事件的记忆，是角色的互动和关系，是对选词和写作风格的风格指南。 通过还提供来利用这一点来发挥您的优势 示例消息 显示您希望人工智能如何响应。展示你想要的东西通常比试图解释它更容易！ 当你的对话已经有历史记录时，更改主提示词对 AI 响应的影响有限。在事件和关系方面，AI假设主要的提示词发生在遥远的过去，并且消息历史记录更新它。在写作风格和用词方面，人工智能假设历史上的所有消息都是根据文本中的规则生成的。 当前 main 提示词，并且它应该继续以相同的方式生成消息。处理这个问题的一些建议是： 在接近消息历史记录末尾或之后插入当前指令，例如使用 作者注释 通过开始新对话来测试对主提示词的更改 编辑消息历史记录以删除或更正不良行为的示例 使用 历史后指令 向AI提供最终指令 第一次就做对！ 永远不要让人工智能“逃脱”你不希望它做的事情。如果你不喜欢人工智能的反应，就不要继续对话，就好像它是正确的一样。相反，修改提示词，重新生成消息，然后从那里继续。这将帮助人工智能了解你想要什么。 删除“虚构聊天”上下文 在某些情况下，“虚构的聊天”可能不适合您的对话。 您可以从主提示词中删除“虚构”上下文： 在与 {{user}} 的对话中写下 {{char}} 的下一条回复。 你可能根本不希望人工智能将自己视为角色扮演。您可以删除 AI 的想法，而不是删除角色的想法： 你是{{char}}，一位乐于助人的助手。您提供有用的信息并帮助 {{user}} 解决他们的问题。 人工智能作为叙述者或讲故事的人 如果你想让 AI 充当叙述者，从全知的角度描述事件，发明自己的角色和设置，该怎么办？ 一种方法是创建一个名为角色的 AI 来用作叙述者。这个角色可以被称为“叙述者”或“AI”，表明AI是一个通用的讲故事者，或者它可以以特定的场景或设置命名，让AI承担在该设置中讲述故事的任务。然后可以在中定义设置的详细信息 角色 或在 世界书. 您需要调整默认的主提示词以反映 AI 的角色。对于通用叙述者，您可以使用： 你是 {{char}}，一位技艺精湛、多才多艺的讲故事者。叙述故事。 或对于特定设置： 你是一个奇幻场景的叙述者。扮演访问 {{char}} 的角色。 它有助于澄清用户在对话中的角色。您的消息是故事的一部分，还是向叙述者说明您的角色做了或说了什么？故事中包含用户的示例： 故事应该通过响应{{user}}的动作和对话来进展。以第三人称叙述故事。 一个让用户远离故事的例子： 进入冒险模式。根据{{user}}的对话和“>”之后的动作来叙述故事。生动详细地描述周围环境。详细、有创意、冗长且积极主动。通过引入奇幻元素和有趣的角色来推动故事的发展。 定义用户的角色不仅可以帮助AI了解如何回复你的消息，还可以帮助它在多大程度上控制你的用户人设。这可以避免人工智能为您的用户人设做出您宁愿自己做的决定的情况。 历史后指令 历史后指令 (PHI) 是在主提示词和用户消息之后发送到 AI 的附加指令。它们可用于根据消息历史记录向人工智能提供额外的上下文或指令。 由于历史后指令是在用户消息之后发送的，因此它们是 AI 在生成响应之前收到的最终指令。 AI通常给予它们比主提示词更高的优先级，并且它们可以覆盖主提示词的指令。 要使用每个角色历史记录指令，请将它们添加到角色的 历史后指令 并启用 更喜欢查尔。指示。要在使用角色特定指令时保留全局定义的 PHI，您可以使用 {{original}} 角色的历史记录后指令字段中的宏。 文本补全 API 历史后指令定义在 高级格式设置 系统提示词类别下的面板。历史后指令作为不可见的用户角色注入添加到提示词最后一行（通常包含响应消息“标头”）之前。请注意，必须启用“启用系统提示词”切换才能应用历史记录指令（即使系统提示词本身为空）。 聊天补全 API 历史后指令是默认的提示词之一 提示词管理器。它通常是模型收到的上下文中的最后一条消息，归因于系统角色（“发送者”）。如果您的聊天补全 API 不支持系统角色，通常会归因于用户角色。 添加到提示词 (世界书) 您可以使用以下命令在提示词中的任何位置插入附加信息 世界书 功能。通过设置何时插入信息的条件，您可以引导人工智能包含特定细节、更改其响应方式或向对话添加新元素。 世界书的一些常见用途包括： 包含有关世界或环境的信息的“世界书”或“百科全书” 一种针对各种角色和情况管理不同系统提示词的方法 存储人工智能应该在对话中“回忆”的记忆的地方 用于创建、编辑和共享角色详细信息的更加模块化的系统 随机事件和惊喜的来源，供人工智能做出反应，或让你做出反应！",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/advancedformatting",
"title": "高级格式设置",
"group": "Prompts",
"order": 100,
"source": "Usage/Prompts/advancedformatting.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/advancedformatting/",
"sourceSha256": "7b49d6a560c7d2d7526186fcaa0c9716ba6fa40542087a40c879b0922dbb0abd",
"headings": [
{
"id": "advanced-formatting",
"depth": 1,
"title": "高级格式设置"
},
{
"id": "resetting-templates",
"depth": 2,
"title": "重置模板"
},
{
"id": "ui-reset",
"depth": 3,
"title": "用户界面重置"
},
{
"id": "manual-reset",
"depth": 3,
"title": "手动复位"
},
{
"id": "backend-defined-templates",
"depth": 2,
"title": "后端定义的模板"
},
{
"id": "system-prompt",
"depth": 2,
"title": "系统提示词"
},
{
"id": "context-template",
"depth": 2,
"title": "上下文模板"
},
{
"id": "tokenizer",
"depth": 2,
"title": "分词器"
},
{
"id": "custom-stopping-strings",
"depth": 2,
"title": "自定义停止字符串"
},
{
"id": "start-reply-with",
"depth": 2,
"title": "开始回复"
},
{
"id": "text-completion-apis",
"depth": 3,
"title": "文本补全 API"
},
{
"id": "chat-completion-apis",
"depth": 3,
"title": "聊天补全 API"
}
],
"content": "# 高级格式设置\n\n本节中提供的设置允许对 [提示词-大楼](/guides/sillytavern/prompts/) 策略，主要针对文本补全 API。\n\n此面板中的大多数设置不适用于聊天完成 API，因为它们由提示词管理器系统控制。\n\n**文本补全 API**\n\n- [系统提示词](#system-prompt)\n- [上下文模板](#context-template)\n- [分词器](#tokenizer)\n- [自定义停止字符串](#custom-stopping-strings)\n\n**聊天补全 API**\n\n- 系统提示词：不适用，使用 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/)\n- 上下文模板：不适用，使用 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/)\n- [分词器](#tokenizer)\n- [自定义停止字符串](#custom-stopping-strings)\n\n## 重置模板\n\n您可以将默认模板恢复到原始状态。这可以通过 UI 或手动删除相关数据文件来完成。\n\n### 用户界面重置\n\n1. 打开 ** 高级格式化** 菜单。\n2. 选择您要重置的模板。\n3. 单击 ** 恢复当前模板** 按钮。\n4. 出现提示时确认操作。\n\n### 手动复位\n\n> 确保 `skipContentCheck` 设置被设置为 `false` 在 [配置.yaml](https://docs.sillytavern.app/administration/config-yaml/#data-configuration)，否则不会触发内容检查。\n\n1. 导航到您的用户数据目录（请参阅 [数据路径](https://docs.sillytavern.app/installation/#data-paths) 了解详情）。\n2. 删除 `content.log` 文件来自用户数据目录的根目录。该文件跟踪为您的用户复制的默认文件。\n3. 从相关子目录中删除模板 JSON 文件（`context`, `instruct`, `sysprompt`等）。\n4. 重新启动SillyTavern服务器。应用程序将重新填充默认内容，恢复任何已删除的默认模板。\n\n## 后端定义的模板\n\n> **适用于：文本补全 API**\n>\n> 不适用于聊天补全 API，因为它们使用不同的提示词构建器。\n\n一些文本补全源提供了自动选择模型作者推荐的模板的功能。这是通过比较模型中定义的聊天模板的哈希来实现的 `tokenizer_config.json` 具有默认 SillyTavern 模板之一的文件。\n\n1. ** 派生模板** 必须在中启用选项 ** 高级格式化** 菜单。这可以应用于上下文、指令或两者。\n2. 必须选择受支持的后端作为文本补全源。目前只有 llama.cpp 和 KoboldCpp 支持派生模板。\n3. 建立与 API 的连接时，模型必须正确报告其元数据。如果这不起作用，请尝试将后端更新到最新版本。\n4. 报告的聊天模板哈希必须与以下之一匹配 [已知 SillyTavern 模板](https://github.com/SillyTavern/SillyTavern/blob/release/public/scripts/chat-templates.js)。这仅涵盖默认模板，例如 Llama 3、Gemma 2、Mistral V7 等。\n5. 如果哈希匹配，如果模板存在于模板列表中（即未重命名或删除），则将自动选择该模板。\n\n## 系统提示词\n\n> **适用于：文本补全 API**\n>\n> 对于聊天补全 API 中的等效设置，请使用 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/)。的 **主提示词** 相当于聊天补全 API 中的系统提示词。\n\n系统提示词定义了模型要遵循的一般指令。它为对话定下了基调和背景。例如，它告诉模型充当 AI 助手、写作伙伴或虚构的角色。\n\n系统提示词是 [故事串](/guides/sillytavern/prompts/context-template/#story-string) 通常是模型收到的提示词的第一部分。\n\n请参阅 [提示引导](/guides/sillytavern/prompts/#main-prompt-system-prompt) 了解有关系统提示词的更多信息。\n\n## 上下文模板\n\n> **适用于：文本补全 API**\n>\n> 对于聊天补全 API 中的等效设置，请使用 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/).\n\n通常，AI 模型要求您以某种特定方式向它们提供角色数据。 SillyTavern 包含针对不同型号的预制转换规则列表，但您可以根据需要自定义它们。\n\n本节的选项在中进行了解释 [上下文模板](/guides/sillytavern/prompts/context-template/).\n\n## 分词器\n\n分词器是一种将一段文本分解为更小的单元（称为 token）的工具。这些 token 可以是单个单词，甚至可以是单词的一部分，例如前缀、后缀或标点符号。根据经验，1个token一般对应3\\~4个角色文本。\n\n本节的选项在中进行了解释 [分词器](/guides/sillytavern/prompts/tokenizer/).\n\n## 自定义停止字符串\n\n接受 JSON 序列化的停止字符串数组。示例： `[\"\\n\", \"\\nUser:\", \"\\nChar:\"]`。如果您不确定格式，请使用 [在线 JSON 验证器](https://jsonlint.com/)。如果模型输出 **结束** 对于任何停止字符串，它们都将从输出中删除。\n\n支持的API：\n\n1. KoboldAI Classic（版本 1.2.2 及更高版本）或 KoboldCpp\n2. AI Horde\n3. 文本补全 API：文本生成 WebUI (ooba)、Tabby、Aphrodite、Mancer、TogetherAI、Ollama 等。\n4. 小说人工智能\n5. OpenAI（最多 4 个字符串）和兼容的 API\n6. OpenRouter（文本和聊天补全）\n7. 克洛德\n8. 谷歌人工智能工作室\n9. 米斯特拉尔人工智能\n\n## 开始回复\n\n> **注意事项**\n>\n> 默认情况下，“开始回复”前缀不会显示在结果消息中。启用“在聊天中显示回复前缀”以显示它。\n\n### 文本补全 API\n\n预填充提示词的最后一行，强制模型从该点继续。这对于执行内容很有用，例如推动 [模型推理](/guides/sillytavern/prompts/reasoning/) 使用定义的前缀：\n\n```txt\n\nSure!\n```\n\n### 聊天补全 API\n\n在提示词末尾添加助理角色消息。对于某些后端模型，这相当于预填充模型响应，但有些可能根本不支持，并且会因验证错误而失败。如果您不确定，请将此字段留空。\n",
"searchText": "高级格式设置 本节中提供的设置允许对 提示词-大楼 策略，主要针对文本补全 API。 此面板中的大多数设置不适用于聊天完成 API，因为它们由提示词管理器系统控制。 文本补全 API 系统提示词 上下文模板 分词器 自定义停止字符串 聊天补全 API 系统提示词：不适用，使用 提示词管理器 上下文模板：不适用，使用 提示词管理器 分词器 自定义停止字符串 重置模板 您可以将默认模板恢复到原始状态。这可以通过 UI 或手动删除相关数据文件来完成。 用户界面重置 打开 高级格式化 菜单。 选择您要重置的模板。 单击 恢复当前模板 按钮。 出现提示时确认操作。 手动复位 确保 skipContentCheck 设置被设置为 false 在 配置.yaml，否则不会触发内容检查。 导航到您的用户数据目录（请参阅 数据路径 了解详情）。 删除 content.log 文件来自用户数据目录的根目录。该文件跟踪为您的用户复制的默认文件。 从相关子目录中删除模板 JSON 文件（context, instruct, sysprompt等）。 重新启动SillyTavern服务器。应用程序将重新填充默认内容，恢复任何已删除的默认模板。 后端定义的模板 适用于：文本补全 API 不适用于聊天补全 API，因为它们使用不同的提示词构建器。 一些文本补全源提供了自动选择模型作者推荐的模板的功能。这是通过比较模型中定义的聊天模板的哈希来实现的 tokenizer_config.json 具有默认 SillyTavern 模板之一的文件。 派生模板 必须在中启用选项 高级格式化 菜单。这可以应用于上下文、指令或两者。 必须选择受支持的后端作为文本补全源。目前只有 llama.cpp 和 KoboldCpp 支持派生模板。 建立与 API 的连接时，模型必须正确报告其元数据。如果这不起作用，请尝试将后端更新到最新版本。 报告的聊天模板哈希必须与以下之一匹配 已知 SillyTavern 模板。这仅涵盖默认模板，例如 Llama 3、Gemma 2、Mistral V7 等。 如果哈希匹配，如果模板存在于模板列表中（即未重命名或删除），则将自动选择该模板。 系统提示词 适用于：文本补全 API 对于聊天补全 API 中的等效设置，请使用 提示词管理器。的 主提示词 相当于聊天补全 API 中的系统提示词。 系统提示词定义了模型要遵循的一般指令。它为对话定下了基调和背景。例如，它告诉模型充当 AI 助手、写作伙伴或虚构的角色。 系统提示词是 故事串 通常是模型收到的提示词的第一部分。 请参阅 提示引导 了解有关系统提示词的更多信息。 上下文模板 适用于：文本补全 API 对于聊天补全 API 中的等效设置，请使用 提示词管理器. 通常，AI 模型要求您以某种特定方式向它们提供角色数据。 SillyTavern 包含针对不同型号的预制转换规则列表，但您可以根据需要自定义它们。 本节的选项在中进行了解释 上下文模板. 分词器 分词器是一种将一段文本分解为更小的单元（称为 token）的工具。这些 token 可以是单个单词，甚至可以是单词的一部分，例如前缀、后缀或标点符号。根据经验，1个token一般对应3~4个角色文本。 本节的选项在中进行了解释 分词器. 自定义停止字符串 接受 JSON 序列化的停止字符串数组。示例： [\"\\n\", \"\\nUser:\", \"\\nChar:\"]。如果您不确定格式，请使用 在线 JSON 验证器。如果模型输出 结束 对于任何停止字符串，它们都将从输出中删除。 支持的API： KoboldAI Classic（版本 1.2.2 及更高版本）或 KoboldCpp AI Horde 文本补全 API：文本生成 WebUI (ooba)、Tabby、Aphrodite、Mancer、TogetherAI、Ollama 等。 小说人工智能 OpenAI（最多 4 个字符串）和兼容的 API OpenRouter（文本和聊天补全） 克洛德 谷歌人工智能工作室 米斯特拉尔人工智能 开始回复 注意事项 默认情况下，“开始回复”前缀不会显示在结果消息中。启用“在聊天中显示回复前缀”以显示它。 文本补全 API 预填充提示词的最后一行，强制模型从该点继续。这对于执行内容很有用，例如推动 模型推理 使用定义的前缀： Sure! 聊天补全 API 在提示词末尾添加助理角色消息。对于某些后端模型，这相当于预填充模型响应，但有些可能根本不支持，并且会因验证错误而失败。如果您不确定，请将此字段留空。",
"translationStatus": "machine-draft"
},
{
"slug": "prompts/context-template",
"title": "上下文模板",
"group": "Prompts",
"order": 90,
"source": "Usage/Prompts/context-template.md",
"sourceUrl": "https://docs.sillytavern.app/usage/prompts/context-template/",
"sourceSha256": "1f730372bb157e38a0948cf1c370434d5a5f6e1e99145872fe2d68be12e5e365",
"headings": [
{
"id": "context-template",
"depth": 1,
"title": "上下文模板"
},
{
"id": "story-string",
"depth": 2,
"title": "故事串"
},
{
"id": "prompt-anchors",
"depth": 3,
"title": "提示词锚"
},
{
"id": "story-string-position",
"depth": 3,
"title": "故事字符串位置"
},
{
"id": "story-string-wrapping",
"depth": 3,
"title": "故事字符串绕行"
},
{
"id": "example-separator",
"depth": 2,
"title": "分隔符示例"
},
{
"id": "chat-start",
"depth": 2,
"title": "聊天开始"
},
{
"id": "separators-as-stop-strings",
"depth": 2,
"title": "分隔符作为停止字符串"
},
{
"id": "names-as-stop-strings",
"depth": 2,
"title": "名称作为停止字符串"
},
{
"id": "always-add-characters-name-to-prompt",
"depth": 2,
"title": "始终将角色的名称添加到提示词"
}
],
"content": "# 上下文模板\n\n> **适用于：文本补全 API**\n>\n> 对于聊天补全 API 中的等效设置，请使用 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/).\n\n通常，AI 模型要求您以某种特定方式向它们提供角色数据。 SillyTavern 包含针对不同型号的预制转换规则列表，但您可以根据需要自定义它们。\n\n在“中编辑这些设置[高级格式设置](/guides/sillytavern/core-concepts/advancedformatting/)“面板。\n\n## 故事串\n\n该字段是提示词前导码（内部称为故事字符串）的模板。这是添加定义信息的主要方式 [角色卡](/guides/sillytavern/characters/) 用于文本完成和指导模型。\n\n该模板支持 Handlebars 语法、自定义文本注入或格式设置以及任何其他 [宏](/guides/sillytavern/core-concepts/macros/)。请参阅此处的语言参考： \n\n我们向 Handlebars 求值器提供以下参数（用双花括号括起来）：\n\n1. `{{anchorBefore}}`：提示设置为使用“Before Story String”位置。\n2. `{{anchorAfter}}`：提示设置为使用“After Story String”位置。\n3. `{{description}}`：角色的 [描述](/guides/sillytavern/core-concepts/characterdesign/#character-description).\n4. `{{scenario}}`：角色的 [场景](/guides/sillytavern/core-concepts/characterdesign/#scenario).\n5. `{{personality}}`：角色的 [个性](/guides/sillytavern/core-concepts/characterdesign/#personality-summary).\n6. `{{system}}`: 的 [系统提示词](/guides/sillytavern/core-concepts/advancedformatting/#system-prompt) 或者角色的 [主提示词](/guides/sillytavern/core-concepts/characterdesign/#prompt-overrides) 覆盖（如果存在并且在用户设置中启用了“首选字符提示词”）。\n7. `{{persona}}`：所选的 [用户人设的描述](/guides/sillytavern/core-concepts/personas/#persona-description).\n8. `{{char}}`：角色的名称。\n9. `{{user}}`：选择的用户人设的名称。\n10. `{{wiBefore}}` 或 `{{loreBefore}}`：联合激活 [世界书](/guides/sillytavern/core-concepts/worldinfo/) 位置设置为“Before Char Defs”的条目。\n11. `{{wiAfter}}` 或 `{{loreAfter}}`：联合激活 [世界书](/guides/sillytavern/core-concepts/worldinfo/) 位置设置为“After Char Defs”的条目。\n12. `{{mesExamples}}`：（可选）角色 [对话示例](/guides/sillytavern/core-concepts/characterdesign/#examples-of-dialogue)，带有分隔符的指令格式。\n13. `{{mesExamplesRaw}}`：角色的 [对话示例](/guides/sillytavern/core-concepts/characterdesign/#examples-of-dialogue) 原始格式，没有任何格式。\n\n> ****重要****\n>\n> 使用时 `{{mesExamples}}` 在故事字符串中，设置 **“消息行为示例”** 在 ** 用户设置** 面板至 **“永远不要包含示例”** 以避免在提示词中重复示例消息。\n\n一个特别的 `{{trim}}` 支持宏来删除它周围的任何换行符。如果您希望文本的一部分不与上一行用换行符分隔，请使用它（*空间 **不是** 修剪过的*).\n\n**警告**：如果故事字符串模板中缺少上述任何参数，则它们根本不会在提示词中发送。\n\n### 提示词锚\n\n的 `{{anchorBefore}}` 和 `{{anchorAfter}}` 是提示词的通用占位符，由选定静态位置的各种扩展和杂项功能添加，例如：\n\n- [作者注释](/guides/sillytavern/core-concepts/authors-note/)\n- [摘要](https://docs.sillytavern.app/extensions/summarize/)\n- [聊天矢量化](https://docs.sillytavern.app/extensions/chat-vectorization/) / [资料库](/guides/sillytavern/core-concepts/data-bank/)\n- [STscript 注入](https://docs.sillytavern.app/usage/st-script/#prompt-injections)\n- [网页搜索](https://docs.sillytavern.app/extensions/websearch/)\n\n### 故事字符串位置\n\n默认情况下，渲染的故事字符串（所有占位符均已替换）放置在提示词的最开头，后面是示例消息和可见的聊天历史记录。\n\n或者，您可以通过选择“聊天中@深度”选项将其移动到动态位置，该选项将故事字符串放置在聊天上下文中的特定深度。\n\n> ****注意****\n>\n> 如果模板包含用于包装故事字符串的静态提示词元素（特定于模型的前缀或后缀），则使用“In-Chat @ Depth”位置将导致其与重复序列错误地双重包装，这可能会导致意外结果。\n>\n> 在这种情况下，您可以通过以下方式之一解决该问题：\n>\n> 1. **内置模板**：使用中描述的步骤将模板重置为其默认值 [高级格式设置](/guides/sillytavern/core-concepts/advancedformatting/#resetting-templates).\n> 2. **自定义模板**：将静态元素从故事字符串模板移至 [故事字符串序列](/guides/sillytavern/core-concepts/instructmode/#sequences-story-string-wrapping).\n\n### 故事字符串绕行\n\n> 以下部分仅适用于 **指令模式** 已开启。\n\n- **默认** 位置：渲染的故事字符串将使用中定义的序列进行包装 [故事字符串序列](/guides/sillytavern/core-concepts/instructmode/#sequences-story-string-wrapping).\n- **聊天中@深度** 位置：渲染的故事字符串将使用中定义的序列进行包装 [聊天消息序列](/guides/sillytavern/core-concepts/instructmode/#sequences-chat-messages-wrapping) 对于所选角色（默认：系统）。\n\n## 分隔符示例\n\n用作块头和示例对话块之间的分隔符。任何实例 `` 示例对话中的标签将替换为此字段的内容。\n\n## 聊天开始\n\n作为分隔符插入在渲染的故事字符串之后和示例对话块之后，但在上下文中的第一条消息之前。\n\n## 分隔符作为停止字符串\n\n将“示例分隔符”和“聊天开始”添加到停止字符串列表。\n\n如果模型倾向于产生幻觉或泄漏分隔符前面的整个示例对话块，则很有帮助。\n\n## 名称作为停止字符串\n\n将角色和用户用户人设名称添加到停止字符串列表中。\n\n建议保持打开状态以防止模型冒充。\n\n## 始终将角色的名称添加到提示词\n\n> 当指令模式打开时，此设置无效。名称行为而是由所选的定义 [包括姓名](/guides/sillytavern/core-concepts/instructmode/#include-names) 选项。\n\n将角色的名称附加到提示词以强制模型将消息完成为角色：\n\n```txt\n** OTHER CONTEXT HERE **\nCharacter:\n```\n",
"searchText": "上下文模板 适用于：文本补全 API 对于聊天补全 API 中的等效设置，请使用 提示词管理器. 通常，AI 模型要求您以某种特定方式向它们提供角色数据。 SillyTavern 包含针对不同型号的预制转换规则列表，但您可以根据需要自定义它们。 在“中编辑这些设置高级格式设置“面板。 故事串 该字段是提示词前导码（内部称为故事字符串）的模板。这是添加定义信息的主要方式 角色卡 用于文本完成和指导模型。 该模板支持 Handlebars 语法、自定义文本注入或格式设置以及任何其他 宏。请参阅此处的语言参考： https://handlebarsjs.com/guide/ 我们向 Handlebars 求值器提供以下参数（用双花括号括起来）： {{anchorBefore}}：提示设置为使用“Before Story String”位置。 {{anchorAfter}}：提示设置为使用“After Story String”位置。 {{description}}：角色的 描述. {{scenario}}：角色的 场景. {{personality}}：角色的 个性. {{system}}: 的 系统提示词 或者角色的 主提示词 覆盖（如果存在并且在用户设置中启用了“首选字符提示词”）。 {{persona}}：所选的 用户人设的描述. {{char}}：角色的名称。 {{user}}：选择的用户人设的名称。 {{wiBefore}} 或 {{loreBefore}}：联合激活 世界书 位置设置为“Before Char Defs”的条目。 {{wiAfter}} 或 {{loreAfter}}：联合激活 世界书 位置设置为“After Char Defs”的条目。 {{mesExamples}}：（可选）角色 对话示例，带有分隔符的指令格式。 {{mesExamplesRaw}}：角色的 对话示例 原始格式，没有任何格式。 重要 使用时 {{mesExamples}} 在故事字符串中，设置 “消息行为示例” 在 用户设置 面板至 “永远不要包含示例” 以避免在提示词中重复示例消息。 一个特别的 {{trim}} 支持宏来删除它周围的任何换行符。如果您希望文本的一部分不与上一行用换行符分隔，请使用它（空间 不是 修剪过的). 警告：如果故事字符串模板中缺少上述任何参数，则它们根本不会在提示词中发送。 提示词锚 的 {{anchorBefore}} 和 {{anchorAfter}} 是提示词的通用占位符，由选定静态位置的各种扩展和杂项功能添加，例如： 作者注释 摘要 聊天矢量化 / 资料库 STscript 注入 网页搜索 故事字符串位置 默认情况下，渲染的故事字符串（所有占位符均已替换）放置在提示词的最开头，后面是示例消息和可见的聊天历史记录。 或者，您可以通过选择“聊天中@深度”选项将其移动到动态位置，该选项将故事字符串放置在聊天上下文中的特定深度。 注意 如果模板包含用于包装故事字符串的静态提示词元素（特定于模型的前缀或后缀），则使用“In-Chat @ Depth”位置将导致其与重复序列错误地双重包装，这可能会导致意外结果。 在这种情况下，您可以通过以下方式之一解决该问题： 内置模板：使用中描述的步骤将模板重置为其默认值 高级格式设置. 自定义模板：将静态元素从故事字符串模板移至 故事字符串序列. 故事字符串绕行 以下部分仅适用于 指令模式 已开启。 默认 位置：渲染的故事字符串将使用中定义的序列进行包装 故事字符串序列. 聊天中@深度 位置：渲染的故事字符串将使用中定义的序列进行包装 聊天消息序列 对于所选角色（默认：系统）。 分隔符示例 用作块头和示例对话块之间的分隔符。任何实例 示例对话中的标签将替换为此字段的内容。 聊天开始 作为分隔符插入在渲染的故事字符串之后和示例对话块之后，但在上下文中的第一条消息之前。 分隔符作为停止字符串 将“示例分隔符”和“聊天开始”添加到停止字符串列表。 如果模型倾向于产生幻觉或泄漏分隔符前面的整个示例对话块，则很有帮助。 名称作为停止字符串 将角色和用户用户人设名称添加到停止字符串列表中。 建议保持打开状态以防止模型冒充。 始终将角色的名称添加到提示词 当指令模式打开时，此设置无效。名称行为而是由所选的定义 包括姓名 选项。 将角色的名称附加到提示词以强制模型将消息完成为角色： ** OTHER CONTEXT HERE ** Character:",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/instructmode",
"title": "指令模式",
"group": "Prompts",
"order": 80,
"source": "Usage/Prompts/instructmode.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/instructmode/",
"sourceSha256": "d82b30daa16d701598668e33d56ec26327cc11ee0a75c7da00409de409fb9e78",
"headings": [
{
"id": "instruct-mode",
"depth": 1,
"title": "指令模式"
},
{
"id": "api-support",
"depth": 2,
"title": "API支持"
},
{
"id": "text-completion-api",
"depth": 3,
"title": "文本补全 API"
},
{
"id": "choosing-a-formatting",
"depth": 4,
"title": "选择格式"
},
{
"id": "chat-completion-api-openai-claude-etc",
"depth": 3,
"title": "聊天补全 API（OpenAI、Claude 等）"
},
{
"id": "novelai",
"depth": 3,
"title": "小说人工智能"
},
{
"id": "instruct-mode-settings",
"depth": 2,
"title": "指令模式设置"
},
{
"id": "system-prompt",
"depth": 3,
"title": "系统提示词"
},
{
"id": "templates",
"depth": 3,
"title": "模板"
},
{
"id": "activation-regex",
"depth": 3,
"title": "激活正则表达式"
},
{
"id": "wrap-sequences-with-newline",
"depth": 3,
"title": "用换行符换行序列"
},
{
"id": "replace-macro-in-sequences",
"depth": 3,
"title": "替换序列中的宏"
},
{
"id": "include-names",
"depth": 3,
"title": "包括姓名"
},
{
"id": "sequences-story-string-wrapping",
"depth": 3,
"title": "序列：故事字符串包装"
},
{
"id": "story-string-prefix",
"depth": 4,
"title": "故事字符串前缀"
},
{
"id": "story-string-suffix",
"depth": 4,
"title": "故事字符串后缀"
},
{
"id": "sequences-chat-messages-wrapping",
"depth": 3,
"title": "序列：聊天消息包装"
},
{
"id": "user-message-prefix",
"depth": 4,
"title": "用户消息前缀"
},
{
"id": "user-message-suffix",
"depth": 4,
"title": "用户消息后缀"
},
{
"id": "assistant-message-prefix",
"depth": 4,
"title": "助理消息前缀"
},
{
"id": "assistant-message-suffix",
"depth": 4,
"title": "助理消息后缀"
},
{
"id": "system-message-prefix",
"depth": 4,
"title": "系统消息前缀"
},
{
"id": "system-message-suffix",
"depth": 4,
"title": "系统消息后缀"
},
{
"id": "system-same-as-user",
"depth": 4,
"title": "系统与用户相同"
},
{
"id": "misc-sequences",
"depth": 3,
"title": "杂项。序列"
},
{
"id": "first-assistant-prefix",
"depth": 4,
"title": "第一助理前缀"
},
{
"id": "last-assistant-prefix",
"depth": 4,
"title": "最后的助手前缀"
},
{
"id": "system-instruction-prefix",
"depth": 4,
"title": "系统指令前缀"
},
{
"id": "user-filler-message",
"depth": 4,
"title": "用户填写信息"
},
{
"id": "stop-sequence",
"depth": 4,
"title": "停止顺序"
}
],
"content": "# 指令模式\n\n指令模式允许您调整在各种提示词格式（例如 Alpaca、ChatML、Llama2 等）上训练的指令跟踪模型的提示。\n\n> **适用于：文本补全 API**\n>\n> 对于聊天补全 API 中的等效设置，请使用 [提示词管理器](/guides/sillytavern/prompts/prompt-manager/).\n\n## API支持\n\n### 文本补全 API\n\n完全支持。这包括：\n\n- 文本补全下的所有来源\n- KoboldAI 经典版\n- AI Horde\n\n#### 选择格式\n\n所选的指令模板必须符合后端运行的实际模型的期望。\n\n这通常反映在 HuggingFace 上的模型卡中，有些甚至提供 SillyTavern 兼容的 JSON 文件。\n\n示例： [NeverSleep/Noromaid-13b-v0.1.1](https://huggingface.co/NeverSleep/Noromaid-13b-v0.1.1#prompt-template-custom-format-or-alpaca)\n\n### 聊天补全 API（OpenAI、Claude 等）\n\n不支持此功能 **（并且不需要）** 对于聊天补全 API。他们使用完全不同的提示词构建器。\n\n### 小说人工智能\n\n同时 *技术上* 支持 NovelAI，但他们的模型都没有经过训练来理解指令格式。 NovelAI 模型可以使用激活的特殊指令模块 *自动地* 当聊天消息中遇到大括号括起来的指令时，因此对整个提示词使用指令模式将导致 **质量下降** 的输出。\n\n下面是自动激活 NovelAI 指令模块的示例：\n\n```txt\nUser: { Write a happy song about Nintendo Switch. }\n```\n\n## 指令模式设置\n\n### 系统提示词\n\n> **最近的变化**\n>\n> 系统提示词现在是一个独立的实体。请参阅 [高级格式设置](/guides/sillytavern/core-concepts/advancedformatting/#system-prompt) 页面了解更多详情。\n\n### 模板\n\n为一些知名的指令模型提供带有序列的现成模板。\n\n*更改模板会将未保存的设置重置为上次保存的状态！如果您进行了任何不想丢失的更改，请不要忘记保存模板。*\n\n### 激活正则表达式\n\n如果定义为有效的正则表达式，当连接到模型并且其名称与此正则表达式匹配时，将自动选择此模板。\n\n需要事先启用指令模式。仅选择跨模板的第一个正则表达式匹配（按字母顺序评估）。\n\n### 用换行符换行序列\n\n每个序列文本在插入提示词时都会用换行符角色换行。羊驼及其衍生品所必需的。\n\n如果您想完全控制行终止符，请禁用。\n\n### 替换序列中的宏\n\n如果启用，则已知的 {{macro}} 替换（如果在消息包装序列中定义）将被替换。\n\n此外，可以在消息前缀中使用特殊的 {{name}} 宏来引用附加到消息的实际名称（而不是当前活动的 {{char}} 或 {{user}}），这在使用群聊或 /sendas 命令时非常有用。如果无法确定名称，则使用“System”作为后备占位符。\n\n### 包括姓名\n\n如果启用，则在前缀序列之后将角色和用户名添加到聊天历史记录日志中。\n\n可以使用以下选项：\n\n- **从来没有**：不要在消息内容前添加名称前缀。\n- **团体和过去用户人设**：仅向来自角色组和过去用户人设的消息添加名称前缀。\n- **总是**：始终在消息内容之前添加名称前缀。\n\n### 序列：故事字符串包装\n\n> **最近的变化**\n>\n> 系统提示词环绕已被删除并替换为故事字符串环绕。\n\n定义当位置设置为“默认（上下文顶部）”时如何包装故事字符串\n\n#### 故事字符串前缀\n\n插入故事字符串之前。\n\n#### 故事字符串后缀\n\n插入到故事字符串之后。\n\n### 序列：聊天消息包装\n\n这些设置定义了在构建提示词时如何包装属于不同角色的消息。\n\n所有前缀序列也将自动用作停止字符串。\n\n#### 用户消息前缀\n\n在模拟时插入用户消息之前并作为最后提示词行。\n\n#### 用户消息后缀\n\n插入在用户消息之后。\n\n#### 助理消息前缀\n\n在生成 AI 回复时插入助理消息之前并作为最后提示词行。\n\n#### 助理消息后缀\n\n在助理消息后插入\n\n#### 系统消息前缀\n\n插入系统消息（通过斜杠命令或扩展添加）之前。\n\n#### 系统消息后缀\n\n插入系统消息之后。\n\n#### 系统与用户相同\n\n如果选中 true，系统消息将使用用户角色消息序列。\n\n否则，系统消息使用自己的序列（如果不为空）或根本不会进行任何包装（如果为空）。\n\n### 杂项。序列\n\n用于对提示词建筑进行微调的各种高级配置\n\n#### 第一助理前缀\n\n插入到第一条助理消息之前。\n\n> 仅第一条消息 **聊天记录** 重要的是，不是首先实际进入提示词的消息！\n\n#### 最后的助手前缀\n\n在生成 AI 回复时插入到最后一条助手消息之前或作为最后提示词行。\n\n> 在背景中生成文本时不使用（例如稳定扩散提示词或摘要）。将使用系统指令前缀或常规助手前缀。\n\n#### 系统指令前缀\n\n在背景中生成中性/系统文本时作为最后提示词行插入（例如稳定扩散提示词或摘要）。\n\n#### 用户填写信息\n\n如果聊天记录不以用户消息开头，则将插入到聊天记录的开头。\n\n**使用案例：** 当指令格式 *严格要求* 提示词用户至上，并且仅具有交替角色的消息，例如：Llama 2 Chat、Mistral Instruct。\n\n#### 停止顺序\n\n表示回复结束的文本。还作为停止字符串发送到后端 API。\n\n如果生成停止序列，则超过该序列的所有内容都将从输出中删除（包括序列本身）。\n",
"searchText": "指令模式 指令模式允许您调整在各种提示词格式（例如 Alpaca、ChatML、Llama2 等）上训练的指令跟踪模型的提示。 适用于：文本补全 API 对于聊天补全 API 中的等效设置，请使用 提示词管理器. API支持 文本补全 API 完全支持。这包括： 文本补全下的所有来源 KoboldAI 经典版 AI Horde 选择格式 所选的指令模板必须符合后端运行的实际模型的期望。 这通常反映在 HuggingFace 上的模型卡中，有些甚至提供 SillyTavern 兼容的 JSON 文件。 示例： NeverSleep/Noromaid-13b-v0.1.1 聊天补全 API（OpenAI、Claude 等） 不支持此功能 （并且不需要） 对于聊天补全 API。他们使用完全不同的提示词构建器。 小说人工智能 同时 技术上 支持 NovelAI，但他们的模型都没有经过训练来理解指令格式。 NovelAI 模型可以使用激活的特殊指令模块 自动地 当聊天消息中遇到大括号括起来的指令时，因此对整个提示词使用指令模式将导致 质量下降 的输出。 下面是自动激活 NovelAI 指令模块的示例： User: { Write a happy song about Nintendo Switch. } 指令模式设置 系统提示词 最近的变化 系统提示词现在是一个独立的实体。请参阅 高级格式设置 页面了解更多详情。 模板 为一些知名的指令模型提供带有序列的现成模板。 更改模板会将未保存的设置重置为上次保存的状态！如果您进行了任何不想丢失的更改，请不要忘记保存模板。 激活正则表达式 如果定义为有效的正则表达式，当连接到模型并且其名称与此正则表达式匹配时，将自动选择此模板。 需要事先启用指令模式。仅选择跨模板的第一个正则表达式匹配（按字母顺序评估）。 用换行符换行序列 每个序列文本在插入提示词时都会用换行符角色换行。羊驼及其衍生品所必需的。 如果您想完全控制行终止符，请禁用。 替换序列中的宏 如果启用，则已知的 {{macro}} 替换（如果在消息包装序列中定义）将被替换。 此外，可以在消息前缀中使用特殊的 {{name}} 宏来引用附加到消息的实际名称（而不是当前活动的 {{char}} 或 {{user}}），这在使用群聊或 /sendas 命令时非常有用。如果无法确定名称，则使用“System”作为后备占位符。 包括姓名 如果启用，则在前缀序列之后将角色和用户名添加到聊天历史记录日志中。 可以使用以下选项： 从来没有：不要在消息内容前添加名称前缀。 团体和过去用户人设：仅向来自角色组和过去用户人设的消息添加名称前缀。 总是：始终在消息内容之前添加名称前缀。 序列：故事字符串包装 最近的变化 系统提示词环绕已被删除并替换为故事字符串环绕。 定义当位置设置为“默认（上下文顶部）”时如何包装故事字符串 故事字符串前缀 插入故事字符串之前。 故事字符串后缀 插入到故事字符串之后。 序列：聊天消息包装 这些设置定义了在构建提示词时如何包装属于不同角色的消息。 所有前缀序列也将自动用作停止字符串。 用户消息前缀 在模拟时插入用户消息之前并作为最后提示词行。 用户消息后缀 插入在用户消息之后。 助理消息前缀 在生成 AI 回复时插入助理消息之前并作为最后提示词行。 助理消息后缀 在助理消息后插入 系统消息前缀 插入系统消息（通过斜杠命令或扩展添加）之前。 系统消息后缀 插入系统消息之后。 系统与用户相同 如果选中 true，系统消息将使用用户角色消息序列。 否则，系统消息使用自己的序列（如果不为空）或根本不会进行任何包装（如果为空）。 杂项。序列 用于对提示词建筑进行微调的各种高级配置 第一助理前缀 插入到第一条助理消息之前。 仅第一条消息 聊天记录 重要的是，不是首先实际进入提示词的消息！ 最后的助手前缀 在生成 AI 回复时插入到最后一条助手消息之前或作为最后提示词行。 在背景中生成文本时不使用（例如稳定扩散提示词或摘要）。将使用系统指令前缀或常规助手前缀。 系统指令前缀 在背景中生成中性/系统文本时作为最后提示词行插入（例如稳定扩散提示词或摘要）。 用户填写信息 如果聊天记录不以用户消息开头，则将插入到聊天记录的开头。 使用案例： 当指令格式 严格要求 提示词用户至上，并且仅具有交替角色的消息，例如：Llama 2 Chat、Mistral Instruct。 停止顺序 表示回复结束的文本。还作为停止字符串发送到后端 API。 如果生成停止序列，则超过该序列的所有内容都将从输出中删除（包括序列本身）。",
"translationStatus": "machine-draft"
},
{
"slug": "prompts/tokenizer",
"title": "分词器",
"group": "Prompts",
"order": 70,
"source": "Usage/Prompts/tokenizer.md",
"sourceUrl": "https://docs.sillytavern.app/usage/prompts/tokenizer/",
"sourceSha256": "c31c7ee907a57e5e215b78f80681bf2e343aab6cc100e52f7ecc23301975aa29",
"headings": [
{
"id": "tokenizer",
"depth": 1,
"title": "分词器"
},
{
"id": "additional-tokenizers",
"depth": 4,
"title": "额外的分词器"
},
{
"id": "token-padding",
"depth": 3,
"title": "令牌填充"
}
],
"content": "# 分词器\n\n分词器是一种将一段文本分解为更小的单元（称为 token）的工具。这些 token 可以是单个单词，甚至可以是单词的一部分，例如前缀、后缀或标点符号。根据经验，1个token一般对应3\\~4个角色文本。\n\nSillyTavern 提供“最佳匹配”选项，尝试根据所使用的 API 提供程序使用以下规则来匹配标记生成器。\n\n文本补全 API **（可重写）**:\n\n1. NovelAI Clio：NerdStash 分词器。\n2. NovelAI Kayra：NerdStash v2 分词器。\n3. 文本补全：API 分词器（如果支持）或 Llama 分词器。\n4. KoboldAI Classic / AI Horde：Llama 标记器。\n5. KoboldCpp：模型 API 标记器。\n\n如果您得到的结果不准确或希望进行实验，您可以设置一个 *覆盖分词器* 供 SillyTavern 在向 AI 后端形成请求时使用：\n\n1. 没有。每个 token 估计约为 3.3 角色，四舍五入到最接近的整数。 **如果您的提示词在高上下文长度上被切断，请尝试此操作。** KoboldAI Lite 使用了这种方法。\n2. Llama 标记器。 Llama 1/2型号系列使用：Vicuna、Hermes、Airoboros等。 **如果您使用 Llama 1/2 模型，请选择。**\n3. Llama 3 分词器。由 Llama 3/3.1 型号使用。 **如果您使用 Llama 3/3.1 型号，请选择此选项。**\n4. NerdStash 标记器。由NovelAI 的Clio 模型使用。 **如果您使用 Clio 模型，请选择。**\n5. NerdStash v2 分词器。由NovelAI 的Kayra 模型使用。 **如果您使用 Kayra 模型，请选择。**\n6. Mistral V1 分词器。由较旧的 Mistral 模型系列及其微调使用。 **如果您使用较旧的 Mistral 型号，请选择此选项。**\n7. 米斯特拉尔尼莫分词器。由 Mistral Nemo 模型系列及其微调使用。 **如果您使用 Mistral Nemo/Pixtral 模型，请选择此选项。**\n8. 易分词器。彝族模型使用。 **如果您使用 Yi 模型，请选择。**\n9. Gemma 分词器。由 Gemini/Gemma 型号使用。 **如果您使用 Gemma 模型，请选择。**\n10. DeepSeek 分词器。由 DeepSeek 模型（例如 R1）使用。 **如果您使用 DeepSeek 模型，请选择。**\n11. API 标记器。查询生成 API 以直接从模型获取 token 计数。支持的已知后端：文本生成 WebUI (ooba)、koboldcpp、TabbyAPI、Aphrodite API。 **选择是否使用受支持的后端。**\n\n聊天补全 API **（不可覆盖）**:\n\n1. OpenAI：依赖于模型的分词器 [抖音](https://github.com/openai/tiktoken).\n2. Claude：依赖于模型的分词器 [WebTokenizers](https://github.com/mlc-ai/tokenizers-cpp).\n3. OpenRouter：Llama、Mistral、Gemma、Yi 各自模型的标记器。\n4. Google AI Studio：Gemma 分词器。\n5. AI21 API：Jamba 标记器（需要一次性下载）。\n6. Cohere API：Command-R 或 Command-A 分词器（需要一次性下载）。\n7. MistralAI API：Mistral V1 或 V3 分词器（需要一次性下载）。\n8. DeepSeek API：DeepSeek 分词器（需要一次性下载）。\n9. 后备分词器：GPT-3.5 Turbo 分词器。\n\n#### 额外的分词器\n\n由于它们的大小，这些标记器不包含在默认安装中。第一次使用时需要一次性下载。\n\n1. Qwen2 分词器。\n2. Command-R / Command-A 分词器。由聊天补全中的 Cohere 源使用。\n3. Mistral V3 (Nemo) 分词器。由 MistralAI 源在聊天补全（Nemo 和 Pixtral 模型）中使用。\n4. DeepSeek（deepseek-chat）分词器。由聊天补全中的 DeepSeek 源使用。\n\n如果您不想使用互联网下载，则 config.yaml 中存在选择退出选项： `enableDownloadableTokenizers`。设置为 `false` 禁用下载。\n\n您还可以从以下位置手动下载分词器： [SillyTavern-分词器](https://github.com/SillyTavern/SillyTavern-Tokenizers) 存储库。下载 JSON 文件并将其放入 `_cache` 数据根的子目录，路径是 `./data/_cache` 默认情况下。创建 `_cache` 目录（如果不存在）。之后，重新启动 SillyTavern 服务器以重新初始化标记器。\n\n如果所需的分词器模型未缓存且下载被禁用，则将使用后备分词器 (Llama 3) 进行计数。\n\n### 令牌填充\n\n> **适用于：文本补全 API**\n>\n> SillyTavern 将始终使用聊天补全模型的匹配标记器，因此不需要 token 填充。\n\n除非 SillyTavern 使用运行模型的远程后端 API 提供的分词器，否则在提示词生成过程中假定的所有 token 计数都是根据所选的值进行估计的 [分词器](#tokenizer) 类型。\n\n由于在接近模型定义的最大值的上下文大小上标记化的结果可能不准确，因此提示词的某些部分可能会被修剪或删除，这可能会对角色定义的一致性产生负面影响。\n\n为了防止这种情况，SillyTavern 分配上下文大小的一部分作为填充，以避免添加超出模型可容纳的聊天项目。如果您发现即使选择了最匹配的分词器，提示词的某些部分也会被修剪，请调整填充以使描述不会被截断。\n\n您可以输入负值进行反向填充，这允许分配超过设置的最大数量的 token。\n",
"searchText": "分词器 分词器是一种将一段文本分解为更小的单元（称为 token）的工具。这些 token 可以是单个单词，甚至可以是单词的一部分，例如前缀、后缀或标点符号。根据经验，1个token一般对应3~4个角色文本。 SillyTavern 提供“最佳匹配”选项，尝试根据所使用的 API 提供程序使用以下规则来匹配标记生成器。 文本补全 API （可重写）: NovelAI Clio：NerdStash 分词器。 NovelAI Kayra：NerdStash v2 分词器。 文本补全：API 分词器（如果支持）或 Llama 分词器。 KoboldAI Classic / AI Horde：Llama 标记器。 KoboldCpp：模型 API 标记器。 如果您得到的结果不准确或希望进行实验，您可以设置一个 覆盖分词器 供 SillyTavern 在向 AI 后端形成请求时使用： 没有。每个 token 估计约为 3.3 角色，四舍五入到最接近的整数。 如果您的提示词在高上下文长度上被切断，请尝试此操作。 KoboldAI Lite 使用了这种方法。 Llama 标记器。 Llama 1/2型号系列使用：Vicuna、Hermes、Airoboros等。 如果您使用 Llama 1/2 模型，请选择。 Llama 3 分词器。由 Llama 3/3.1 型号使用。 如果您使用 Llama 3/3.1 型号，请选择此选项。 NerdStash 标记器。由NovelAI 的Clio 模型使用。 如果您使用 Clio 模型，请选择。 NerdStash v2 分词器。由NovelAI 的Kayra 模型使用。 如果您使用 Kayra 模型，请选择。 Mistral V1 分词器。由较旧的 Mistral 模型系列及其微调使用。 如果您使用较旧的 Mistral 型号，请选择此选项。 米斯特拉尔尼莫分词器。由 Mistral Nemo 模型系列及其微调使用。 如果您使用 Mistral Nemo/Pixtral 模型，请选择此选项。 易分词器。彝族模型使用。 如果您使用 Yi 模型，请选择。 Gemma 分词器。由 Gemini/Gemma 型号使用。 如果您使用 Gemma 模型，请选择。 DeepSeek 分词器。由 DeepSeek 模型（例如 R1）使用。 如果您使用 DeepSeek 模型，请选择。 API 标记器。查询生成 API 以直接从模型获取 token 计数。支持的已知后端：文本生成 WebUI (ooba)、koboldcpp、TabbyAPI、Aphrodite API。 选择是否使用受支持的后端。 聊天补全 API （不可覆盖）: OpenAI：依赖于模型的分词器 抖音. Claude：依赖于模型的分词器 WebTokenizers. OpenRouter：Llama、Mistral、Gemma、Yi 各自模型的标记器。 Google AI Studio：Gemma 分词器。 AI21 API：Jamba 标记器（需要一次性下载）。 Cohere API：Command-R 或 Command-A 分词器（需要一次性下载）。 MistralAI API：Mistral V1 或 V3 分词器（需要一次性下载）。 DeepSeek API：DeepSeek 分词器（需要一次性下载）。 后备分词器：GPT-3.5 Turbo 分词器。 额外的分词器 由于它们的大小，这些标记器不包含在默认安装中。第一次使用时需要一次性下载。 Qwen2 分词器。 Command-R / Command-A 分词器。由聊天补全中的 Cohere 源使用。 Mistral V3 (Nemo) 分词器。由 MistralAI 源在聊天补全（Nemo 和 Pixtral 模型）中使用。 DeepSeek（deepseek-chat）分词器。由聊天补全中的 DeepSeek 源使用。 如果您不想使用互联网下载，则 config.yaml 中存在选择退出选项： enableDownloadableTokenizers。设置为 false 禁用下载。 您还可以从以下位置手动下载分词器： SillyTavern-分词器 存储库。下载 JSON 文件并将其放入 _cache 数据根的子目录，路径是 ./data/_cache 默认情况下。创建 _cache 目录（如果不存在）。之后，重新启动 SillyTavern 服务器以重新初始化标记器。 如果所需的分词器模型未缓存且下载被禁用，则将使用后备分词器 (Llama 3) 进行计数。 令牌填充 适用于：文本补全 API SillyTavern 将始终使用聊天补全模型的匹配标记器，因此不需要 token 填充。 除非 SillyTavern 使用运行模型的远程后端 API 提供的分词器，否则在提示词生成过程中假定的所有 token 计数都是根据所选的值进行估计的 分词器 类型。 由于在接近模型定义的最大值的上下文大小上标记化的结果可能不准确，因此提示词的某些部分可能会被修剪或删除，这可能会对角色定义的一致性产生负面影响。 为了防止这种情况，SillyTavern 分配上下文大小的一部分作为填充，以避免添加超出模型可容纳的聊天项目。如果您发现即使选择了最匹配的分词器，提示词的某些部分也会被修剪，请调整填充以使描述不会被截断。 您可以输入负值进行反向填充，这允许分配超过设置的最大数量的 token。",
"translationStatus": "machine-draft"
},
{
"slug": "prompts/cfg",
"title": "CFG 引导",
"group": "Prompts",
"order": 60,
"source": "Usage/Prompts/CFG.md",
"sourceUrl": "https://docs.sillytavern.app/usage/prompts/cfg/",
"sourceSha256": "1d6f7a8d7911af7f5d11409d3bb11952dafb3ef0e8dbd014ee5147cac6543d3b",
"headings": [
{
"id": "cfg",
"depth": 1,
"title": "CFG 引导"
},
{
"id": "what-is-it",
"depth": 2,
"title": "它是什么？"
},
{
"id": "supported-backend-apis",
"depth": 3,
"title": "支持的后端 API"
},
{
"id": "configuration",
"depth": 2,
"title": "配置"
},
{
"id": "group-chats",
"depth": 4,
"title": "群聊"
},
{
"id": "concepts",
"depth": 2,
"title": "概念"
},
{
"id": "isnt-this-in-stable-diffusion",
"depth": 3,
"title": "这不是稳定扩散吗？"
},
{
"id": "do-i-need-cfg-prompts",
"depth": 3,
"title": "我需要CFG 提示词吗？"
},
{
"id": "what-makes-a-good-cfg-prompt",
"depth": 3,
"title": "CFG 提示词的品质如何？"
},
{
"id": "positive-prompts",
"depth": 3,
"title": "积极提示"
},
{
"id": "but",
"depth": 3,
"title": "但是..."
},
{
"id": "guidance-scale",
"depth": 3,
"title": "指导量表"
},
{
"id": "prompt-cascading",
"depth": 3,
"title": "提示词级联"
},
{
"id": "insertion-depth",
"depth": 3,
"title": "插入深度"
}
],
"content": "# CFG 引导\n\n页面编写者：kingbri\n\n贡献者：kingbri、Guillaume \"Vermeille\" Sanchez、AliCat\n\n## 它是什么？\n\nCFG（无分类器引导）是一种用于帮助使提示词的某些部分变得不那么突出或更加突出的方法。\n\n### 支持的后端 API\n\n目前，支持的后端是 oobabooga 的 textgen WebUI、NovelAI 和 TabbyAPI。\nNovelAI 有自己的 [CFG 的文档](https://web.archive.org/web/20240917150051/https://docs.novelai.net/text/cfg.html).\n\n警告：由于摄取超过 1 提示词，CFG 会增加 VRAM 使用量！如果在启用 CFG 的情况下生成提示词时 GPU 内存耗尽，请考虑减小上下文大小、使用较小参数模型或完全关闭 CFG。\n\n***\n\n## 配置\n\n访问 CFG 设置与访问作者注释相同：\n\n\n\nCFG 面板如下所示：\n\n\n\nCFG 面板中有四个下拉菜单：\n\n- 聊天CFG\n\n - 将 CFG 比例和提示词的范围仅限于此聊天\n- 角色 CFG\n\n - 将 CFG 比例和提示词的范围限定为指定的角色\n- 全球CFG\n\n - 全局覆盖CFG比例和提示词（也覆盖模型预设！）\n- CFG 高级设置（以前称为 CFG 提示词级联）\n\n - 组合前面 3 个下拉列表中的提示词并设置插入深度的位置。\n\n注意：如果引导比例设置为 1，则不会发送任何内容，因为此时 CFG 处于“关闭”状态。\n\n#### 群聊\n\n在群聊中，CFG比例面板如下所示：\n\n\n\n主要变化是删除了角色 CFG 并添加了一个名为 `Use Character CFG Scales` 存在于聊天 CFG 下拉列表中。这允许使用当前角色的引导比例，而不是聊天 CFG 比例设置的值。\n\n此功能的主要用途是根据每个角色的个人需求更改比例。\n\n此外，检查 `Character Negatives` 提示词级联中的框将附加独立的角色负提示词以及聊天框（如果启用）。\n\n***\n\n## 概念\n\n### 这不是稳定扩散吗？\n\n是和不是。法学硕士的 CFG 的工作方式与稳定扩散中的工作方式不同。基于 LLM 的 CFG 的工作原理是“提示词混合”。 CFG公式取正负提示词，然后混合 *差异* 他们之间。从那里，发送组合的提示词并生成响应！\n\n这是一个帮助形象化这个概念的插图。红色代表负值提示词，蓝色代表中性提示词，紫色代表解释的混合结果。所有 3 个提示词中的所有空白都是相同的，因此这些空白不用于 CFG 混合。\n\n\n\n如果您想了解有关 CFG 和 LLM 的更多信息，Vermifuge 的原始论文位于此处。我建议读/听：\n\n- 纸 - [\\[2306.17806\\] 通过无分类器指导保持主题 (arxiv.org)](https://arxiv.org/abs//2306.17806)\n\n- 音频版本 - \n\n### 我需要CFG 提示词吗？\n\n不！ CFG 提示词完全可选。只需调整上面的指导比例即可 `1` 还将有助于对响应产生影响，从而可以加强聊天和角色互动。\n\n### CFG 提示词的品质如何？\n\n因此，我们确定 CFG 提示与稳定扩散的负面标签和嵌入不同。我们如何制作提示词？\n\n警告：这假设您已使用 PLists 和 Ali:Chat 创建了角色。如果您还没有，请随意尝试各种提示技巧。\n\n假设我有一个名为“John”的角色。从他的示例对话中，约翰应该一直感到快乐和兴奋。然而，在与约翰聊天时，他有时会感到悲伤和沮丧。\n\n为了消除这个问题，CFG 来救援！就做负数提示词 `[John's feelings: sad, depressed]` 帮助消除悲伤部分。您可以选择将正极设为提示词 `[John's feelings: happy, joyful]` 进一步衬托出约翰快乐的部分。\n\n### 积极提示\n\n我在上一节中讨论过这个问题，但我想再谈一下这个问题。正提示词用于进一步强调角色的部分。让我们再次以约翰为例。通过积极的提示词让他更快乐 `[John's feelings: happy, joyful]`，与不包含正面提示词相比，John 应该开始输出带有更快乐感觉的对话。\n\n### 但是...\n\n这些只是 **宽松的指导方针** 来自一种特定角色格式的经验。您还可以尝试许多其他方法来创建提示词。请随意与其他用户分享您的想法！\n\n### 指导量表\n\n这是一个经验法则。指导规模为 `1` 表示CFG 已禁用。事实上，如果指导比例为 1，SillyTavern 不会向您的后端发送任何内容。指导比例 `>1` 将给出其他部分不同程度显示的结果。\n\n然而，指导规模 `<1` 将给出 *对面* 因为负提示词在这里用作主要提示词。\n\n让我们再次使用约翰的例子。负的提示词是 `[John's feelings: sad, depressed]` 正提示词为 `[John's feelings: happy, joyful]` 指导规模为 `0.8`.\n\n这反过来又会强调 *消极的* 提示词更多，您会看到约翰开始表现得比平常更悲伤，而不是更快乐。\n\nTL;DR：使用指导量表 `1.5` 并根据您的输出从那里上下工作。\n\n### 提示词级联\n\n否定和肯定可以在 CFG 类型之间级联（类型为每聊天、每角色和全局覆盖）。有关详细信息，请参阅配置标头。\n\n### 插入深度\n\n遵循基本规则：提示词中的位置越低，对响应的影响越大。对于聊天，我建议使用默认深度 `1` 因为它与 SillyTavern 的其他组件非常灵活。\n\n但是，如果您想进行实验，插入深度为 `0` 是开放的。但是，这些可能会极大地改变您的响应的外观，因此不建议在此处使用提示词级联！\n",
"searchText": "CFG 引导 页面编写者：kingbri 贡献者：kingbri、Guillaume \"Vermeille\" Sanchez、AliCat 它是什么？ CFG（无分类器引导）是一种用于帮助使提示词的某些部分变得不那么突出或更加突出的方法。 支持的后端 API 目前，支持的后端是 oobabooga 的 textgen WebUI、NovelAI 和 TabbyAPI。 NovelAI 有自己的 CFG 的文档. 警告：由于摄取超过 1 提示词，CFG 会增加 VRAM 使用量！如果在启用 CFG 的情况下生成提示词时 GPU 内存耗尽，请考虑减小上下文大小、使用较小参数模型或完全关闭 CFG。 配置 访问 CFG 设置与访问作者注释相同： CFG 面板如下所示： CFG 面板中有四个下拉菜单： 聊天CFG 将 CFG 比例和提示词的范围仅限于此聊天 角色 CFG 将 CFG 比例和提示词的范围限定为指定的角色 全球CFG 全局覆盖CFG比例和提示词（也覆盖模型预设！） CFG 高级设置（以前称为 CFG 提示词级联） 组合前面 3 个下拉列表中的提示词并设置插入深度的位置。 注意：如果引导比例设置为 1，则不会发送任何内容，因为此时 CFG 处于“关闭”状态。 群聊 在群聊中，CFG比例面板如下所示： 主要变化是删除了角色 CFG 并添加了一个名为 Use Character CFG Scales 存在于聊天 CFG 下拉列表中。这允许使用当前角色的引导比例，而不是聊天 CFG 比例设置的值。 此功能的主要用途是根据每个角色的个人需求更改比例。 此外，检查 Character Negatives 提示词级联中的框将附加独立的角色负提示词以及聊天框（如果启用）。 概念 这不是稳定扩散吗？ 是和不是。法学硕士的 CFG 的工作方式与稳定扩散中的工作方式不同。基于 LLM 的 CFG 的工作原理是“提示词混合”。 CFG公式取正负提示词，然后混合 差异 他们之间。从那里，发送组合的提示词并生成响应！ 这是一个帮助形象化这个概念的插图。红色代表负值提示词，蓝色代表中性提示词，紫色代表解释的混合结果。所有 3 个提示词中的所有空白都是相同的，因此这些空白不用于 CFG 混合。 如果您想了解有关 CFG 和 LLM 的更多信息，Vermifuge 的原始论文位于此处。我建议读/听： 纸 - [2306.17806] 通过无分类器指导保持主题 (arxiv.org) 音频版本 - https://www.youtube.com/watch?v=MGY00YFcyco 我需要CFG 提示词吗？ 不！ CFG 提示词完全可选。只需调整上面的指导比例即可 1 还将有助于对响应产生影响，从而可以加强聊天和角色互动。 CFG 提示词的品质如何？ 因此，我们确定 CFG 提示与稳定扩散的负面标签和嵌入不同。我们如何制作提示词？ 警告：这假设您已使用 PLists 和 Ali:Chat 创建了角色。如果您还没有，请随意尝试各种提示技巧。 假设我有一个名为“John”的角色。从他的示例对话中，约翰应该一直感到快乐和兴奋。然而，在与约翰聊天时，他有时会感到悲伤和沮丧。 为了消除这个问题，CFG 来救援！就做负数提示词 [John's feelings: sad, depressed] 帮助消除悲伤部分。您可以选择将正极设为提示词 [John's feelings: happy, joyful] 进一步衬托出约翰快乐的部分。 积极提示 我在上一节中讨论过这个问题，但我想再谈一下这个问题。正提示词用于进一步强调角色的部分。让我们再次以约翰为例。通过积极的提示词让他更快乐 [John's feelings: happy, joyful]，与不包含正面提示词相比，John 应该开始输出带有更快乐感觉的对话。 但是... 这些只是 宽松的指导方针 来自一种特定角色格式的经验。您还可以尝试许多其他方法来创建提示词。请随意与其他用户分享您的想法！ 指导量表 这是一个经验法则。指导规模为 1 表示CFG 已禁用。事实上，如果指导比例为 1，SillyTavern 不会向您的后端发送任何内容。指导比例 >1 将给出其他部分不同程度显示的结果。 然而，指导规模 <1 将给出 对面 因为负提示词在这里用作主要提示词。 让我们再次使用约翰的例子。负的提示词是 [John's feelings: sad, depressed] 正提示词为 [John's feelings: happy, joyful] 指导规模为 0.8. 这反过来又会强调 消极的 提示词更多，您会看到约翰开始表现得比平常更悲伤，而不是更快乐。 TL;DR：使用指导量表 1.5 并根据您的输出从那里上下工作。 提示词级联 否定和肯定可以在 CFG 类型之间级联（类型为每聊天、每角色和全局覆盖）。有关详细信息，请参阅配置标头。 插入深度 遵循基本规则：提示词中的位置越低，对响应的影响越大。对于聊天，我建议使用默认深度 1 因为它与 SillyTavern 的其他组件非常灵活。 但是，如果您想进行实验，插入深度为 0 是开放的。但是，这些可能会极大地改变您的响应的外观，因此不建议在此处使用提示词级联！",
"translationStatus": "machine-draft"
},
{
"slug": "prompts/prompt-manager",
"title": "提示词管理器",
"group": "Prompts",
"order": 50,
"source": "Usage/Prompts/prompt-manager.md",
"sourceUrl": "https://docs.sillytavern.app/usage/prompts/prompt-manager/",
"sourceSha256": "c78738b914215b16795d410b3f96bc6294450486b52be3c84da0605dcc355697",
"headings": [
{
"id": "prompt-manager",
"depth": 1,
"title": "提示词管理器"
},
{
"id": "quick-prompts-edit",
"depth": 2,
"title": "快速提示编辑"
},
{
"id": "utility-prompts",
"depth": 2,
"title": "实用程序提示"
},
{
"id": "format-templates",
"depth": 3,
"title": "格式模板"
},
{
"id": "group-nudge-prompt-template",
"depth": 3,
"title": "群组微调提示词模板"
},
{
"id": "new-chat-new-group-chat-new-example-chat",
"depth": 3,
"title": "新聊天、新群聊天、新示例聊天"
},
{
"id": "continue-nudge",
"depth": 3,
"title": "继续轻推"
},
{
"id": "replace-empty-message",
"depth": 3,
"title": "替换空消息"
},
{
"id": "character-names-behavior",
"depth": 2,
"title": "角色名称行为"
},
{
"id": "continue-postfix",
"depth": 2,
"title": "继续后缀"
},
{
"id": "additional-settings",
"depth": 2,
"title": "附加设置"
},
{
"id": "wrap-in-quotes",
"depth": 3,
"title": "用引号引起来"
},
{
"id": "continue-prefill",
"depth": 3,
"title": "继续预填"
},
{
"id": "squash-system-messages",
"depth": 3,
"title": "壁球系统消息"
},
{
"id": "enable-web-search",
"depth": 3,
"title": "启用网络搜索"
},
{
"id": "enable-function-calling",
"depth": 3,
"title": "启用函数调用"
},
{
"id": "send-inline-images-send-inline-videos",
"depth": 3,
"title": "发送内嵌图像、发送内嵌视频"
},
{
"id": "request-inline-images",
"depth": 3,
"title": "请求内嵌图像"
},
{
"id": "use-system-prompt",
"depth": 3,
"title": "使用系统提示词"
},
{
"id": "reasoning-settings",
"depth": 2,
"title": "推理设置"
},
{
"id": "request-model-reasoning",
"depth": 3,
"title": "请求模型推理"
},
{
"id": "reasoning-effort",
"depth": 3,
"title": "推理努力"
},
{
"id": "prompts",
"depth": 2,
"title": "“提示”"
},
{
"id": "the-prompts-dropdown",
"depth": 3,
"title": "“提示”下拉菜单"
},
{
"id": "prompts-list",
"depth": 3,
"title": "提示列表"
},
{
"id": "editing-a-prompt",
"depth": 2,
"title": "编辑提示词"
},
{
"id": "name",
"depth": 3,
"title": "名称"
},
{
"id": "role",
"depth": 3,
"title": "角色"
},
{
"id": "triggers",
"depth": 3,
"title": "触发器"
},
{
"id": "position",
"depth": 3,
"title": "职位"
},
{
"id": "depth",
"depth": 3,
"title": "深度"
},
{
"id": "order",
"depth": 3,
"title": "订单"
},
{
"id": "building-your-prompt-tips-and-tricks",
"depth": 2,
"title": "构建您的提示词：提示和技巧"
}
],
"content": "# 提示词管理器\n\n提示词管理器是一个提供更多控制的系统 [提示词-大楼](/guides/sillytavern/prompts/) 聊天补全 API 的策略。\n\n> **适用于：聊天补全 API**\n>\n> 对于文本补全 API 中的等效设置，请使用 [高级格式设置](/guides/sillytavern/core-concepts/advancedformatting/).\n\n> **命名预设**\n>\n> 如果预设与您的角色卡之一共享名称，则在开始与该角色聊天时会自动选择该预设。名称预设了一些独特的内容以避免这种行为。\n\n点击导航栏中的“AI响应配置”按钮即可访问提示词管理器。 提示词管理器位于 [通用设置](/guides/sillytavern/common-settings/) 面板。\n\n## 快速提示编辑\n\n提供快速编辑常见提示词部分的空间，例如 **主提示词**, **辅助提示词**, 和 **历史后指令**。有关这些提示词的更多信息，请访问 [提示词-大楼](/guides/sillytavern/prompts/) 页。\n\n## 实用程序提示\n\n这些提示词被发送到聊天补全模型，以帮助它理解发送给它的信息，或指示它在某些类型的交互过程中以特定方式采取行动。\n\n### 格式模板\n\n> 如果未设置格式模板，则信息将按原样发送，不进行任何换行。\n\n这些是字符串模板，用于包装从中提取的信息 [世界书](/guides/sillytavern/core-concepts/worldinfo/) 和 [角色卡](/guides/sillytavern/core-concepts/characterdesign/).\n\n特殊标记用于指示应插入信息的位置：\n\n- `{0}` 对于世界书格式模板。\n- `{{scenario}}` 用于场景格式模板。\n- `{{personality}}` 用于个性格式模板。\n\n### 群组微调提示词模板\n\n仅在群聊中使用。放置在提示词的末尾以强制来自特定角色的回复。\n\n将此留空以禁用“组微移”功能。\n\n### 新聊天、新群聊天、新示例聊天\n\n这些在聊天记录之前和每个之前发送 [对话示例](/guides/sillytavern/core-concepts/characterdesign/#examples-of-dialogue) 阻止通知模型背景信息结束和聊天历史记录开始的位置。\n\n- **新聊天：** 用于个人聊天。\n- **新群聊：** 用于群聊。\n- **新的聊天示例：** 用于例如对话块。\n\n将这些留空以禁用此功能。\n\n### 继续轻推\n\n在提示词末尾发送，指示模型在触发“继续”时（例如按下“继续”按钮或由 STScript 触发时）做什么。\n\n> **聊天补全“继续”**\n>\n> 请记住，聊天补全型号处理继续的方式与 **文本补全** 模型，并且无论您如何继续微移，都可能无法始终提供无缝结果。\n\n### 替换空消息\n\n当文本框为空且文本框为空时，发送此字段的内容而不是空白消息 **发送消息** 被按下。\n\n## 角色名称行为\n\n提供不同的策略来指示模型如何将消息与角色关联。如果聊天补全模型无法确定哪些消息属于哪个角色，则可能需要选择不同的策略。\n\n## 继续后缀\n\n触发“继续”时，模型返回的“继续”消息会将所选的“继续后缀”添加到开头。例如，它可以在连续文本之前添加一个空格。\n\n## 附加设置\n\n### 用引号引起来\n\n> 已弃用的选项。更喜欢 [正则表达式脚本](https://docs.sillytavern.app/extensions/regex/) 相反。\n\n发送前将整个用户消息用隐藏引号括起来。这对于角色不使用引号来指示语音的会话非常有用。如果您的会话使用引号来表示语音，请不要选中此选项。\n\n### 继续预填\n\n> 可能不适用于所有聊天补全源。\n\n将“继续微移”作为助理角色消息而不是系统消息发送。如果启用此功能，将不会使用继续微移提示词。\n\n### 壁球系统消息\n\n> 已弃用的选项。更喜欢 [提示词后处理](/guides/sillytavern/api-connections/openai/#prompt-post-processing) 相反。\n\n将连续的系统消息组合成单个组合消息（不包括示例对话）。\n\n### 启用网络搜索\n\n> 不要与 [网页搜索扩展](https://docs.sillytavern.app/extensions/websearch/).\n\n启用聊天补全后端提供的网络搜索功能。 提示词通常由模型提供商提供丰富的搜索结果，并且可能会产生额外费用。\n\n### 启用函数调用\n\n参见 [函数调用](https://docs.sillytavern.app/for-contributors/function-calling/)\n\n### 发送内嵌图像、发送内嵌视频\n\n> 不要与 [图像字幕扩展](https://docs.sillytavern.app/extensions/captioning/).\n\n如果聊天补全模型具有处理提交的图像和视频的多模式功能，则会切换其执行此操作的能力。要将媒体附加到提示词，请使用 **附加文件** “魔棒”菜单中的选项。\n\n### 请求内嵌图像\n\n> 不要与 [图像生成扩展](https://docs.sillytavern.app/extensions/stable-diffusion/).\n\n允许模型返回图像附件。\n\n### 使用系统提示词\n\n> 仅受 Google Gemini 和 Anthropic Claude 后端支持。\n>\n> 尽管这两个选项的设置非常相似，但它们在技术上是独立的选项，因此可以单独配置。\n\n合并所有系统消息，直到第一条具有非系统角色（用户/助理）的消息，并将它们作为单独的系统指令字段发送。\n\n## 推理设置\n\n如果聊天补全模型使用推理，这些设置会影响其可见性和功能。\n\n### 请求模型推理\n\n参见 [添加推理：通过后端](/guides/sillytavern/prompts/reasoning/#by-backend).\n\n### 推理努力\n\n参见 [推理努力](/guides/sillytavern/prompts/reasoning/#reasoning-effort).\n\n## “提示”\n\n提示词管理器构成发送到聊天补全模型的提示词的骨干。它控制发送的内容以及 *订单* 它被发送到其中。\n\n### “提示”下拉菜单\n\n包含所有的下拉列表（非默认）提示词即当前的聊天补全预设包括。对于其中之一提示词要添加到外发消息中，需要从下拉列表中选择它，然后添加到提示词管理器通过按**插入提示词** 按钮。要创建新的提示词以添加到此下拉列表中，请按 **新款提示词** 按钮。一旦新的提示词被写入并保存，它就会被添加到下拉列表中，然后可以插入。\n\n### 提示列表\n\n这是一个拖放界面，列出了选择的可能发送到聊天补全模型的提示词。提示符放置在靠近 **顶部** 接口的内容较早发送。的 **底部** 列表中的是 **最后一件事** 发送到模型（通常，这将是您的 **历史后指令**).\n\n> **“固定”提示词 = 默认提示词**\n>\n> 无法从所选提示词列表中删除默认提示词。这包括主要提示词、世界书（之前/之后）、用户人设描述、角色描述、角色个性、场景、增强定义、辅助提示词、聊天示例、聊天历史和历史后指令。如果不需要这些，可以将它们 **切换为“关闭”**，但没有彻底删除或删除。\n\n## 编辑提示词\n\n单击 **铅笔按钮** 在提示词上将带您到 **编辑界面**。在这里，您可以直接编辑提示词。\n\n> **请务必保存您的更改！**\n>\n> 要永久保存对聊天补全预设中这些提示词的更改，您必须单击 **保存** 按钮位于右下角 **编辑界面**，以及使用保存预设本身 **保存** 按钮位于顶部 **AI响应配置** 部分！否则，当聊天补全预设切换到另一预设时，所做的更改将会丢失。\n\n### 名称\n\n名称为提示词。这不会发送到聊天补全型号；仅供您在提示词管理器内参考。\n\n### 角色\n\n哪个角色发送提示词。您可以在“系统”、“AI 助手”或“用户”之间进行选择。\n\n### 触发器\n\n发送此提示词的生成类型。如果未选择任何内容，则将为所有生成类型发送提示词。如果选择一项或多项，则仅针对这些特定生成类型发送提示词：\n\n- **正常：** 定期消息生成请求。\n- **继续：** 当按下继续按钮时。\n- **冒充：** 当按下模拟按钮时。\n- **滑动：** 当通过滑动触发生成时。\n- **再生：** 在单人聊天中按下“重新生成”按钮时。\n- **安静：** 后台生成请求，通常由 [扩展](https://docs.sillytavern.app/extensions/) 或 [ST脚本](https://docs.sillytavern.app/usage/st-script/) 命令。\n\n> “重新生成”触发器在群聊中不可用，因为它使用不同的重新生成逻辑：最后回复的所有消息都将被删除，并且根据所选的“正常”生成类型对消息进行排队 [群组回复策略](/guides/sillytavern/core-concepts/groupchats/#reply-order-strategies).\n\n### 职位\n\n当位置设置为 **相对**，此提示词与所有其他提示词一起发送到拖放界面中它所在的位置。当设置为 **聊天中** 并给出一个 **深度**，而是发送 **在聊天记录中** 作为所选角色，并且 **忽略** 拖放界面的顺序。\n\n### 深度\n\n当位置设置为 **聊天中**，这定义了提示词在聊天历史记录中发送的深度。数字越大，发送的深度越深。例如，深度 0 将在最后一条聊天消息之后发送，深度 1 将在最后一条聊天消息之前发送，深度 2 将在倒数第二条聊天消息之前发送，依此类推。\n\n### 订单\n\n> 具有相同角色和深度的提示将被分组在一起并按其顺序值排序。\n> 顺序如下（从上到下）：用户、AI助手、系统。\n\n当位置设置为 **聊天中**，这定义了提示词在聊天历史记录中发送的顺序。数字越小，发送越早。\n\n## 构建您的提示词：提示和技巧\n\n参观 [提示词-大楼](/guides/sillytavern/prompts/) 有关如何编写有效的提示词的更多信息，请参阅 SillyTavern 文档部分。该信息很大程度上可应用于聊天补全预设。\n",
"searchText": "提示词管理器 提示词管理器是一个提供更多控制的系统 提示词-大楼 聊天补全 API 的策略。 适用于：聊天补全 API 对于文本补全 API 中的等效设置，请使用 高级格式设置. 命名预设 如果预设与您的角色卡之一共享名称，则在开始与该角色聊天时会自动选择该预设。名称预设了一些独特的内容以避免这种行为。 点击导航栏中的“AI响应配置”按钮即可访问提示词管理器。 提示词管理器位于 通用设置 面板。 快速提示编辑 提供快速编辑常见提示词部分的空间，例如 主提示词, 辅助提示词, 和 历史后指令。有关这些提示词的更多信息，请访问 提示词-大楼 页。 实用程序提示 这些提示词被发送到聊天补全模型，以帮助它理解发送给它的信息，或指示它在某些类型的交互过程中以特定方式采取行动。 格式模板 如果未设置格式模板，则信息将按原样发送，不进行任何换行。 这些是字符串模板，用于包装从中提取的信息 世界书 和 角色卡. 特殊标记用于指示应插入信息的位置： {0} 对于世界书格式模板。 {{scenario}} 用于场景格式模板。 {{personality}} 用于个性格式模板。 群组微调提示词模板 仅在群聊中使用。放置在提示词的末尾以强制来自特定角色的回复。 将此留空以禁用“组微移”功能。 新聊天、新群聊天、新示例聊天 这些在聊天记录之前和每个之前发送 对话示例 阻止通知模型背景信息结束和聊天历史记录开始的位置。 新聊天： 用于个人聊天。 新群聊： 用于群聊。 新的聊天示例： 用于例如对话块。 将这些留空以禁用此功能。 继续轻推 在提示词末尾发送，指示模型在触发“继续”时（例如按下“继续”按钮或由 STScript 触发时）做什么。 聊天补全“继续” 请记住，聊天补全型号处理继续的方式与 文本补全 模型，并且无论您如何继续微移，都可能无法始终提供无缝结果。 替换空消息 当文本框为空且文本框为空时，发送此字段的内容而不是空白消息 发送消息 被按下。 角色名称行为 提供不同的策略来指示模型如何将消息与角色关联。如果聊天补全模型无法确定哪些消息属于哪个角色，则可能需要选择不同的策略。 继续后缀 触发“继续”时，模型返回的“继续”消息会将所选的“继续后缀”添加到开头。例如，它可以在连续文本之前添加一个空格。 附加设置 用引号引起来 已弃用的选项。更喜欢 正则表达式脚本 相反。 发送前将整个用户消息用隐藏引号括起来。这对于角色不使用引号来指示语音的会话非常有用。如果您的会话使用引号来表示语音，请不要选中此选项。 继续预填 可能不适用于所有聊天补全源。 将“继续微移”作为助理角色消息而不是系统消息发送。如果启用此功能，将不会使用继续微移提示词。 壁球系统消息 已弃用的选项。更喜欢 提示词后处理 相反。 将连续的系统消息组合成单个组合消息（不包括示例对话）。 启用网络搜索 不要与 网页搜索扩展. 启用聊天补全后端提供的网络搜索功能。 提示词通常由模型提供商提供丰富的搜索结果，并且可能会产生额外费用。 启用函数调用 参见 函数调用 发送内嵌图像、发送内嵌视频 不要与 图像字幕扩展. 如果聊天补全模型具有处理提交的图像和视频的多模式功能，则会切换其执行此操作的能力。要将媒体附加到提示词，请使用 附加文件 “魔棒”菜单中的选项。 请求内嵌图像 不要与 图像生成扩展. 允许模型返回图像附件。 使用系统提示词 仅受 Google Gemini 和 Anthropic Claude 后端支持。 尽管这两个选项的设置非常相似，但它们在技术上是独立的选项，因此可以单独配置。 合并所有系统消息，直到第一条具有非系统角色（用户/助理）的消息，并将它们作为单独的系统指令字段发送。 推理设置 如果聊天补全模型使用推理，这些设置会影响其可见性和功能。 请求模型推理 参见 添加推理：通过后端. 推理努力 参见 推理努力. “提示” 提示词管理器构成发送到聊天补全模型的提示词的骨干。它控制发送的内容以及 订单 它被发送到其中。 “提示”下拉菜单 包含所有的下拉列表（非默认）提示词即当前的聊天补全预设包括。对于其中之一提示词要添加到外发消息中，需要从下拉列表中选择它，然后添加到提示词管理器通过按插入提示词 按钮。要创建新的提示词以添加到此下拉列表中，请按 新款提示词 按钮。一旦新的提示词被写入并保存，它就会被添加到下拉列表中，然后可以插入。 提示列表 这是一个拖放界面，列出了选择的可能发送到聊天补全模型的提示词。提示符放置在靠近 顶部 接口的内容较早发送。的 底部 列表中的是 最后一件事 发送到模型（通常，这将是您的 历史后指令). “固定”提示词 = 默认提示词 无法从所选提示词列表中删除默认提示词。这包括主要提示词、世界书（之前/之后）、用户人设描述、角色描述、角色个性、场景、增强定义、辅助提示词、聊天示例、聊天历史和历史后指令。如果不需要这些，可以将它们 切换为“关闭”，但没有彻底删除或删除。 编辑提示词 单击 铅笔按钮 在提示词上将带您到 编辑界面。在这里，您可以直接编辑提示词。 请务必保存您的更改！ 要永久保存对聊天补全预设中这些提示词的更改，您必须单击 保存 按钮位于右下角 编辑界面，以及使用保存预设本身 保存 按钮位于顶部 AI响应配置 部分！否则，当聊天补全预设切换到另一预设时，所做的更改将会丢失。 名称 名称为提示词。这不会发送到聊天补全型号；仅供您在提示词管理器内参考。 角色 哪个角色发送提示词。您可以在“系统”、“AI 助手”或“用户”之间进行选择。 触发器 发送此提示词的生成类型。如果未选择任何内容，则将为所有生成类型发送提示词。如果选择一项或多项，则仅针对这些特定生成类型发送提示词： 正常： 定期消息生成请求。 继续： 当按下继续按钮时。 冒充： 当按下模拟按钮时。 滑动： 当通过滑动触发生成时。 再生： 在单人聊天中按下“重新生成”按钮时。 安静： 后台生成请求，通常由 扩展 或 ST脚本 命令。 “重新生成”触发器在群聊中不可用，因为它使用不同的重新生成逻辑：最后回复的所有消息都将被删除，并且根据所选的“正常”生成类型对消息进行排队 群组回复策略. 职位 当位置设置为 相对，此提示词与所有其他提示词一起发送到拖放界面中它所在的位置。当设置为 聊天中 并给出一个 深度，而是发送 在聊天记录中 作为所选角色，并且 忽略 拖放界面的顺序。 深度 当位置设置为 聊天中，这定义了提示词在聊天历史记录中发送的深度。数字越大，发送的深度越深。例如，深度 0 将在最后一条聊天消息之后发送，深度 1 将在最后一条聊天消息之前发送，深度 2 将在倒数第二条聊天消息之前发送，依此类推。 订单 具有相同角色和深度的提示将被分组在一起并按其顺序值排序。 顺序如下（从上到下）：用户、AI助手、系统。 当位置设置为 聊天中，这定义了提示词在聊天历史记录中发送的顺序。数字越小，发送越早。 构建您的提示词：提示和技巧 参观 提示词-大楼 有关如何编写有效的提示词的更多信息，请参阅 SillyTavern 文档部分。该信息很大程度上可应用于聊天补全预设。",
"translationStatus": "machine-draft"
},
{
"slug": "prompts/reasoning",
"title": "推理",
"group": "Prompts",
"order": 40,
"source": "Usage/Prompts/reasoning.md",
"sourceUrl": "https://docs.sillytavern.app/usage/prompts/reasoning/",
"sourceSha256": "fe5f34d5779c8de81c6b4b87737da35da0591e173bd5bd4b52e969e417cade39",
"headings": [
{
"id": "reasoning",
"depth": 1,
"title": "推理"
},
{
"id": "common-issues",
"depth": 2,
"title": "常见问题"
},
{
"id": "configuration",
"depth": 2,
"title": "配置"
},
{
"id": "adding-reasoning",
"depth": 2,
"title": "添加推理"
},
{
"id": "manually",
"depth": 3,
"title": "手动"
},
{
"id": "with-a-command",
"depth": 3,
"title": "通过命令"
},
{
"id": "by-backend",
"depth": 3,
"title": "通过后端"
},
{
"id": "by-parsing",
"depth": 3,
"title": "通过解析"
},
{
"id": "prompting-with-reasoning",
"depth": 2,
"title": "推理提示"
},
{
"id": "continuing-from-reasoning",
"depth": 3,
"title": "继续推理"
},
{
"id": "regex-scripts",
"depth": 2,
"title": "正则表达式脚本"
},
{
"id": "reasoning-effort",
"depth": 2,
"title": "推理努力"
}
],
"content": "# 推理\n\n在语言模型中，推理（也称为模型思维）是指一种思维链（CoT）技术，它反映了人类通过逐步分析解决问题的过程。 SillyTavern 提供了多种功能，使推理模型的使用在支持的后端之间更加高效和一致。\n\n## 常见问题\n\n1. 使用推理模型时，模型的内部推理过程会消耗您的响应 token 津贴的一部分，即使此推理未显示在最终输出中（例如 o3-mini 或 Gemini Thinking）。如果您发现您的回复不完整或为空，您应该尝试调整最大响应长度设置 ** AI响应配置** 面板。对于推理模型，与标准会话模型相比，通常使用明显更高的 token 限制（从 1024 到 4096 token）。\n\n## 配置\n\n> 大多数与推理相关的设置可以在“推理”部分进行配置 ** 高级格式化** 面板。\n\n推理块在聊天中显示为可折叠的消息部分。它们可以手动添加、由后端自动添加或通过响应解析添加（见下文）。\n\n默认情况下，推理块会折叠以节省空间。单击一个块可展开并查看其内容。您可以通过启用来设置块自动扩展 **自动扩展** 在推理设置中。\n\n当推理块展开时，您可以使用复制或编辑其内容 ** 复制** 和 ** 编辑** 按钮。\n\n有些模型支持推理，但不会将自己的想法发回。仍然可以通过切换来显示推理块和推理时间。 **显示隐藏** 设置。\n\n## 添加推理\n\n### 手动\n\n通过以下方式向任何消息添加推理块 ** 留言编辑** 菜单。点击 **** 在编辑时添加推理部分。第三方扩展还可以通过写入来添加推理 `extra.reasoning` 消息对象的字段，然后将其添加到聊天中。\n\n### 通过命令\n\n使用 `/reasoning-set` 用于向消息添加推理的 STscript 命令。该命令需要 `at` （消息 ID，默认为最后一条消息）和推理文本作为参数。\n\n```stscript\n/reasoning-set at=0 This is the reasoning for the first message.\n```\n\n### 通过后端\n\n如果您选择的LLM后端和模型支持推理输出，请在 ** AI响应配置** 面板将添加一个包含模型思维过程的推理块。\n\n支持的来源：\n\n- 克洛德\n- 深度搜索\n- 谷歌人工智能工作室\n- 谷歌顶点人工智能\n- 开放路由器\n- xAI（格洛克）\n- 人工智能/机器学习API\n- 扎艾\n- 授粉\n- 米斯特拉尔人工智能\n- 电子集线器\n- 滑道\n- 纳米GPT\n- 登月计划\n\n> 对于 **大多数** 消息人士称，“请求模型推理”并不能确定模型是否进行推理，因为它无法被禁用。如果后端和模型支持明确请求禁用推理，则该设置将这样做。否则，模型将始终推理。\n\n提供商特定说明：\n\n- 克劳德和谷歌（2.5 Flash）允许切换思维模式；看到 [推理努力](#reasoning-effort).\n- 可以禁用推理 [Z.AI (GLM)](https://docs.z.ai/api-reference/llm/chat-completion#body-one-of-0-thinking) 和 [登月（基米）](https://platform.moonshot.ai/docs/guide/use-kimi-k2-thinking-model)。该设置映射到 `thinking.type` 参数。他们不支持“推理努力”。\n- 对于 OpenRouter，当“请求模型推理”开关在设置最小推理工作量的情况下停用时，支持它的模型的思维将被设置为禁用。该行为取决于模型；某些提供商可能会拒绝此类请求。\n\n### 通过解析\n\n启用“自动解析” ** 高级格式化** 面板自动解析模型输出的推理。\n\n响应必须包含包含在配置的前缀和后缀序列中的推理部分。默认提供的序列对应于 DeepSeek R1 推理格式。对于某些返回未解析推理的 API 源（例如 MiniMax 或 Perplexity），需要启用此功能。\n\n带前缀的示例 `` 和后缀 ``:\n\n```txt\n\nThis is the reasoning.\n\n\nThis is the main content.\n```\n\n## 推理提示\n\n默认情况下，已识别的推理块内容不会发送回模型。要在提示词中包含推理，请在 ** 高级格式化** 面板。推理内容将包装在配置的前缀和后缀序列中，并通过分隔符与主上下文分开。最大添加数字设置控制可以包含多少个推理块，从提示词末尾开始计数。\n\n> 大多数模型提供商不建议在多轮对话中将 CoT 发送回模型。\n\n### 继续推理\n\n一种特殊情况是，在不启用“添加到提示”切换的情况下，可以将推理发送回模型，即继续生成（例如，通过按“继续”） ** 选项** 菜单），但正在继续的消息仅包含推理而没有实际内容。这使得模型有机会完成不完整的推理并开始生成主要内容。 提示词将按如下方式发送：\n\n```txt\n\nIncomplete reasoning...\n```\n\n## 正则表达式脚本\n\n正则表达式脚本来自 [正则表达式扩展](https://docs.sillytavern.app/extensions/regex/) 可以应用于推理块的内容。检查脚本编辑器“影响”部分中的“推理”以专门针对推理块。\n\n不同的短暂性选项通过以下方式影响推理块：\n\n1. 没有短暂性：推理内容会永久改变。\n2. 编辑时运行：编辑推理块时将重新评估正则表达式脚本。\n3. 更改聊天显示：正则表达式应用于推理块的显示文本，而不是底层内容。\n4. 更改传出提示词：正则表达式仅在推理块发送到模型之前应用于推理块。\n\n## 推理努力\n\n推理努力是聊天补全设置 ** AI响应配置** 影响可能用于推理的 token 数量的面板。每个选项的效果取决于所连接的源。对于以下来源，“自动”仅表示请求中不包含相关参数。\n\n| 选项 | 克劳德（如果没有流媒体，则≤ 21333） | OpenAI（关键词） | OpenRouter（关键字） | xAI (Grok)（关键字） | 困惑（关键词） | NanoGPT（关键字） |\n| -- | --------------------- | --------------- | --------------- | --------------- | ------- | ------------ |\n| 型号 | 作品 4、十四行诗 4/3.7 | o4-迷你、o3\\*、o1\\* | 适用机型 | grok-3-迷你 | 声纳深度研究 | 适用机型 |\n| 汽车 | 未指定， **没有思考** | 未指定 | 未指定，效果取决于 | 未指定 | 未指定 | 未指定 |\n| 最低 | 预算 1024 token | “低” | “低”，或最大响应的 20% | “低” | “低” | “无” |\n| 低 | 最大响应的 15%，最小值 1024 | “低” | “低”，或最大响应的 20% | “低” | “低” | “最小” |\n| 中等 | 最大响应的 25%，最小值 1024 | “中” | “中”，或最大响应的 50% | “低” | “中” | “低” |\n| 高 | 最大响应的 50%，最小值 1024 | “高” | “高”，或最大响应的 80% | “高” | “高” | “中” |\n| 最大 | 最大响应的 95%，最小值 1024 | “高” | “高”，或最大响应的 80% | “高” | “高” | “高” |\n\n- 对于不支持自适应思维的旧版 Claude 模型，如果禁用流式传输，预算上限为 21333。如果计算出的预算小于 1024，则最大响应更改为 2048。\n- Claude 还支持 Opus 4.6+ 模型的自适应思维，可以通过以下方式启用 `claude.enableAdaptiveThinking` 在 [配置.yaml](https://docs.sillytavern.app/administration/config-yaml/) （Opus 4.7+ 始终开启）。启用后，推理工作量设置会映射到自适应思维级别，而不是 token 预算。对于适用型号，此设置优先于“详细程度”设置。\n- 对于 OpenRouter、Pollinations、Perplexity、xAI、Chutes、DeepSeek、AI/ML API、xAI、Electron Hub，只会发送 OpenAI 风格的关键字。\n- 对于 OpenAI 上的 GPT-5.4 和 GPT-5.5 模型，“最小”推理工作对应于“无”，即禁用推理。\n- 对于作为聊天补全自定义 API 源运行的 KoboldCpp，推理工作作为 `reasoning_effort` 参数值为“minimal”、“low”、“medium”、“high”和“xhigh”。\n- 对于其他自定义（OpenAI 兼容）源，仅当模型在官方 OpenAI 源上支持时才会发送推理工作。\n\nGoogle AI Studio 和 Vertex AI 如下：\n\n| 型号 | 自动（动态思维） | 最低 | 低 | 中等 | 高 | 最大 |\n| ----------- | -------- | ----------- | ----------------- | ------- | ------- | ---------------- |\n| 2.5专业版 | 思考预算=-1 | 128 | 最大响应的 15%，最小值 128 | 最大的 25% | 最大的 50% | 最大值或 32768 中的较低者 |\n| 2.5 闪存 | 思考预算=-1 | 0, **没有思考** | 最大响应的 15% | 最大的 25% | 最大的 50% | 最大值或 24576 中的较低者 |\n| 2.5 闪存精简版 | 思考预算=-1 | 0, **没有思考** | 最大响应的 15%，最小值 512 | 最大的 25% | 最大的 50% | 最大值或 24576 中的较低者 |\n| 3.0/3.1 专业版 | 思维水平=空 | “低” | “低” | “低” | “高” | “高” |\n| 3.0/3.1闪存 | 思维水平=空 | “最小” | “低” | “中” | “高” | “高” |\n\n- 对于 Gemini 2.5 Pro 和 2.5 Flash/Lite，无论流媒体设置如何，预算上限分别为 32768 或 24576 token。\n",
"searchText": "推理 在语言模型中，推理（也称为模型思维）是指一种思维链（CoT）技术，它反映了人类通过逐步分析解决问题的过程。 SillyTavern 提供了多种功能，使推理模型的使用在支持的后端之间更加高效和一致。 常见问题 使用推理模型时，模型的内部推理过程会消耗您的响应 token 津贴的一部分，即使此推理未显示在最终输出中（例如 o3-mini 或 Gemini Thinking）。如果您发现您的回复不完整或为空，您应该尝试调整最大响应长度设置 AI响应配置 面板。对于推理模型，与标准会话模型相比，通常使用明显更高的 token 限制（从 1024 到 4096 token）。 配置 大多数与推理相关的设置可以在“推理”部分进行配置 高级格式化 面板。 推理块在聊天中显示为可折叠的消息部分。它们可以手动添加、由后端自动添加或通过响应解析添加（见下文）。 默认情况下，推理块会折叠以节省空间。单击一个块可展开并查看其内容。您可以通过启用来设置块自动扩展 自动扩展 在推理设置中。 当推理块展开时，您可以使用复制或编辑其内容 复制 和 编辑 按钮。 有些模型支持推理，但不会将自己的想法发回。仍然可以通过切换来显示推理块和推理时间。 显示隐藏 设置。 添加推理 手动 通过以下方式向任何消息添加推理块 留言编辑 菜单。点击 在编辑时添加推理部分。第三方扩展还可以通过写入来添加推理 extra.reasoning 消息对象的字段，然后将其添加到聊天中。 通过命令 使用 /reasoning-set 用于向消息添加推理的 STscript 命令。该命令需要 at （消息 ID，默认为最后一条消息）和推理文本作为参数。 /reasoning-set at=0 This is the reasoning for the first message. 通过后端 如果您选择的LLM后端和模型支持推理输出，请在 AI响应配置 面板将添加一个包含模型思维过程的推理块。 支持的来源： 克洛德 深度搜索 谷歌人工智能工作室 谷歌顶点人工智能 开放路由器 xAI（格洛克） 人工智能/机器学习API 扎艾 授粉 米斯特拉尔人工智能 电子集线器 滑道 纳米GPT 登月计划 对于 大多数 消息人士称，“请求模型推理”并不能确定模型是否进行推理，因为它无法被禁用。如果后端和模型支持明确请求禁用推理，则该设置将这样做。否则，模型将始终推理。 提供商特定说明： 克劳德和谷歌（2.5 Flash）允许切换思维模式；看到 推理努力. 可以禁用推理 Z.AI (GLM) 和 登月（基米）。该设置映射到 thinking.type 参数。他们不支持“推理努力”。 对于 OpenRouter，当“请求模型推理”开关在设置最小推理工作量的情况下停用时，支持它的模型的思维将被设置为禁用。该行为取决于模型；某些提供商可能会拒绝此类请求。 通过解析 启用“自动解析” 高级格式化 面板自动解析模型输出的推理。 响应必须包含包含在配置的前缀和后缀序列中的推理部分。默认提供的序列对应于 DeepSeek R1 推理格式。对于某些返回未解析推理的 API 源（例如 MiniMax 或 Perplexity），需要启用此功能。 带前缀的示例 和后缀 : This is the reasoning. This is the main content. 推理提示 默认情况下，已识别的推理块内容不会发送回模型。要在提示词中包含推理，请在 高级格式化 面板。推理内容将包装在配置的前缀和后缀序列中，并通过分隔符与主上下文分开。最大添加数字设置控制可以包含多少个推理块，从提示词末尾开始计数。 大多数模型提供商不建议在多轮对话中将 CoT 发送回模型。 继续推理 一种特殊情况是，在不启用“添加到提示”切换的情况下，可以将推理发送回模型，即继续生成（例如，通过按“继续”） 选项 菜单），但正在继续的消息仅包含推理而没有实际内容。这使得模型有机会完成不完整的推理并开始生成主要内容。 提示词将按如下方式发送： Incomplete reasoning... 正则表达式脚本 正则表达式脚本来自 正则表达式扩展 可以应用于推理块的内容。检查脚本编辑器“影响”部分中的“推理”以专门针对推理块。 不同的短暂性选项通过以下方式影响推理块： 没有短暂性：推理内容会永久改变。 编辑时运行：编辑推理块时将重新评估正则表达式脚本。 更改聊天显示：正则表达式应用于推理块的显示文本，而不是底层内容。 更改传出提示词：正则表达式仅在推理块发送到模型之前应用于推理块。 推理努力 推理努力是聊天补全设置 AI响应配置 影响可能用于推理的 token 数量的面板。每个选项的效果取决于所连接的源。对于以下来源，“自动”仅表示请求中不包含相关参数。 选项 克劳德（如果没有流媒体，则≤ 21333） OpenAI（关键词） OpenRouter（关键字） xAI (Grok)（关键字） 困惑（关键词） NanoGPT（关键字） 型号 作品 4、十四行诗 4/3.7 o4-迷你、o3*、o1* 适用机型 grok-3-迷你 声纳深度研究 适用机型 汽车 未指定， 没有思考 未指定 未指定，效果取决于 未指定 未指定 未指定 最低 预算 1024 token “低” “低”，或最大响应的 20% “低” “低” “无” 低 最大响应的 15%，最小值 1024 “低” “低”，或最大响应的 20% “低” “低” “最小” 中等 最大响应的 25%，最小值 1024 “中” “中”，或最大响应的 50% “低” “中” “低” 高 最大响应的 50%，最小值 1024 “高” “高”，或最大响应的 80% “高” “高” “中” 最大 最大响应的 95%，最小值 1024 “高” “高”，或最大响应的 80% “高” “高” “高” 对于不支持自适应思维的旧版 Claude 模型，如果禁用流式传输，预算上限为 21333。如果计算出的预算小于 1024，则最大响应更改为 2048。 Claude 还支持 Opus 4.6+ 模型的自适应思维，可以通过以下方式启用 claude.enableAdaptiveThinking 在 配置.yaml （Opus 4.7+ 始终开启）。启用后，推理工作量设置会映射到自适应思维级别，而不是 token 预算。对于适用型号，此设置优先于“详细程度”设置。 对于 OpenRouter、Pollinations、Perplexity、xAI、Chutes、DeepSeek、AI/ML API、xAI、Electron Hub，只会发送 OpenAI 风格的关键字。 对于 OpenAI 上的 GPT-5.4 和 GPT-5.5 模型，“最小”推理工作对应于“无”，即禁用推理。 对于作为聊天补全自定义 API 源运行的 KoboldCpp，推理工作作为 reasoning_effort 参数值为“minimal”、“low”、“medium”、“high”和“xhigh”。 对于其他自定义（OpenAI 兼容）源，仅当模型在官方 OpenAI 源上支持时才会发送推理工作。 Google AI Studio 和 Vertex AI 如下： 型号 自动（动态思维） 最低 低 中等 高 最大 2.5专业版 思考预算=-1 128 最大响应的 15%，最小值 128 最大的 25% 最大的 50% 最大值或 32768 中的较低者 2.5 闪存 思考预算=-1 0, 没有思考 最大响应的 15% 最大的 25% 最大的 50% 最大值或 24576 中的较低者 2.5 闪存精简版 思考预算=-1 0, 没有思考 最大响应的 15%，最小值 512 最大的 25% 最大的 50% 最大值或 24576 中的较低者 3.0/3.1 专业版 思维水平=空 “低” “低” “低” “高” “高” 3.0/3.1闪存 思维水平=空 “最小” “低” “中” “高” “高” 对于 Gemini 2.5 Pro 和 2.5 Flash/Lite，无论流媒体设置如何，预算上限分别为 32768 或 24576 token。",
"translationStatus": "machine-draft"
},
{
"slug": "user-settings",
"title": "用户设置",
"group": "User_Settings",
"order": 120,
"source": "Usage/User_Settings/index.md",
"sourceUrl": "https://docs.sillytavern.app/usage/user-settings/",
"sourceSha256": "e0b91e081f422a7dcf00adc4efa70c28efa9bc90df6bda02a43c7398e6c61fc9",
"headings": [
{
"id": "user-settings",
"depth": 1,
"title": "用户设置"
},
{
"id": "general-settings",
"depth": 2,
"title": "常规设置"
},
{
"id": "ui-language",
"depth": 3,
"title": "用户界面语言"
},
{
"id": "software-version",
"depth": 3,
"title": "软件版本"
},
{
"id": "account-management",
"depth": 3,
"title": "账户管理"
},
{
"id": "i-classfa-fw-fa-solid-fa-user-shieldi-account",
"depth": 4,
"title": " 账户"
},
{
"id": "i-classfa-fw-fa-solid-fa-user-tiei-admin-panel",
"depth": 4,
"title": " 管理面板"
},
{
"id": "user-profile",
"depth": 5,
"title": "用户资料"
},
{
"id": "account-controls",
"depth": 5,
"title": "账户控制"
},
{
"id": "management-actions",
"depth": 5,
"title": "管理行动"
},
{
"id": "new-user",
"depth": 5,
"title": "新用户"
},
{
"id": "i-classfa-fw-fa-solid-fa-right-from-bracketi-logout",
"depth": 4,
"title": " 退出"
},
{
"id": "settings-search",
"depth": 3,
"title": "设置搜索"
},
{
"id": "ui-theme",
"depth": 2,
"title": "用户界面主题"
},
{
"id": "character-handling",
"depth": 2,
"title": "角色处理"
},
{
"id": "miscellaneous",
"depth": 2,
"title": "杂项"
},
{
"id": "chatmessage-handling",
"depth": 2,
"title": "聊天/消息处理"
},
{
"id": "message-display-settings",
"depth": 3,
"title": "消息显示设置"
},
{
"id": "input--response-controls",
"depth": 3,
"title": "输入和响应控制"
},
{
"id": "auto-management",
"depth": 3,
"title": "自动管理"
},
{
"id": "auto-swipe",
"depth": 4,
"title": "自动-滑动切换回复"
},
{
"id": "auto-continue",
"depth": 4,
"title": "自动继续"
},
{
"id": "message-formatting--display",
"depth": 3,
"title": "消息格式和显示"
},
{
"id": "prompt-inspection-and-debugging",
"depth": 3,
"title": "提示词检查调试"
},
{
"id": "autocomplete",
"depth": 3,
"title": "自动完成"
},
{
"id": "stscript-settings",
"depth": 2,
"title": "ST脚本设置"
},
{
"id": "strict_escaping",
"depth": 3,
"title": "严格_转义"
},
{
"id": "replace_getvar",
"depth": 3,
"title": "REPLACE_GETVAR"
},
{
"id": "clean-up-menu",
"depth": 2,
"title": "清理菜单"
},
{
"id": "how-to-use-clean-up",
"depth": 3,
"title": "如何使用清理功能"
},
{
"id": "clean-up-categories",
"depth": 3,
"title": "清理类别"
},
{
"id": "files",
"depth": 4,
"title": "文件"
},
{
"id": "images",
"depth": 4,
"title": "图片"
},
{
"id": "chats",
"depth": 4,
"title": "聊天记录"
},
{
"id": "group-chats",
"depth": 4,
"title": "群聊"
},
{
"id": "avatar-thumbnails",
"depth": 4,
"title": "头像缩略图"
},
{
"id": "background-thumbnails",
"depth": 4,
"title": "背景缩略图"
},
{
"id": "chat-backups",
"depth": 4,
"title": "聊天备份"
},
{
"id": "settings-backups",
"depth": 4,
"title": "设置备份"
},
{
"id": "debug-menu",
"depth": 2,
"title": "调试菜单"
},
{
"id": "translation--locale-functions",
"depth": 3,
"title": "翻译和区域设置功能"
},
{
"id": "cache--storage-management",
"depth": 3,
"title": "缓存和存储管理"
},
{
"id": "data--statistics",
"depth": 3,
"title": "数据与统计"
},
{
"id": "api--extension-testing",
"depth": 3,
"title": "API 和扩展测试"
},
{
"id": "system--debug-tools",
"depth": 3,
"title": "系统和调试工具"
}
],
"content": "# 用户设置\n\n> **[用户界面定制](/guides/sillytavern/core-concepts/uicustomization/)**\n>\n> 更改聊天界面的主题、外观和风格以满足您的喜好。\n\n> **[视觉小说模式](/guides/sillytavern/user-settings/visual-novel/)**\n>\n> 使用精灵与角色聊天，就像在 Doki Doki 文学俱乐部和其他著名 VN 游戏等视觉小说中一样。\n\n## 常规设置\n\n这些是影响您整体 SillyTavern 体验的核心设置。\n\n### 用户界面语言\n\nSillyTavern的用户界面有多种语言版本。语言选择器提供以下选项：\n\n- **默认**：使用您的系统语言（如果可用）\n- **英语**：无论系统设置如何，都强制使用英语 UI\n- 通过下拉菜单可以选择其他语言\n\n注意：此设置仅影响用户界面文本。对于人工智能对话翻译，请使用 [聊天翻译](https://docs.sillytavern.app/extensions/translation/) 扩展。\n\n### 软件版本\n\n您当前的 SillyTavern 版本显示在右上角。此信息对于以下方面至关重要：\n\n- 故障排除\n- 确保与扩展的兼容性\n- 确定更新是否可用\n\n更新SillyTavern到最新版本，请参考 [更新中](https://docs.sillytavern.app/Installation/Updating) 文档。\n\n### 账户管理\n\n控制您的 SillyTavern 用户帐户，备份您的设置和用户数据，并管理用户角色和权限 [多用户模式](https://docs.sillytavern.app/administration/multi-user/).\n\n#### 账户\n\n在“帐户”对话框中，您可以查看和编辑您的个人资料信息、更改密码以及管理帐户设置。\n\n**简介信息**\n\n- 显示名称（可通过铅笔图标编辑）\n- 用户头像（也可以使用更改 [用户人设](/guides/sillytavern/core-concepts/personas/))\n- 账户手柄\n- 用户角色\n- 帐户创建日期\n- 密码状态（锁定/解锁图标表示保护）\n\n**账户操作**\n\n- **设置快照**：创建、管理和恢复用户设置的备份\n- **下载备份**：导出所有用户数据的完整备份\n- **更改密码**：更新您的帐户安全凭证\n\n**危险区**\n\n应谨慎使用的关键帐户操作：\n\n- **重置设置**：将所有设置恢复为出厂默认值\n- **重置一切**：完成帐户擦除并恢复出厂设置\n\n#### 管理面板\n\n> **适用于： [多用户模式](https://docs.sillytavern.app/administration/multi-user/)**\n>\n> 多账户功能需要 `enableUserAccounts` 在 config.yaml 中设置为 true。\n\n选择 **管理用户** 查看和管理现有用户帐户。\n\n##### 用户资料\n\n- 自定义头像管理（上传/删除）\n- 显示名称和句柄\n- 角色和状态信息\n- 帐户创建日期\n- 密码保护状态\n\n##### 账户控制\n\n- 编辑显示名称\n- 启用帐户\n- 禁用帐户\n- 晋升为管理员\n- 降级为普通用户\n\n##### 管理行动\n\n- 下载用户数据备份\n- 更改用户密码\n- 删除帐户\n\n##### 新用户\n\n选择 **新用户** 创建一个新的用户帐户。\n\n- 显示名称\\*（例如“John Snow”）\n- 用户句柄\\*（仅限小写字母、数字和破折号）\n- 密码（可选）\n- 密码确认\n\n创建新用户会自动在 /data/ 目录中生成一个子文件夹，使用用户的句柄作为文件夹名称。\n\n#### 退出\n\n> **适用于： [多用户模式](https://docs.sillytavern.app/administration/multi-user/)**\n\n退出当前会话。\n\n### 设置搜索\n\n方便的搜索栏可帮助您快速找到特定设置：\n\n- 在“用户设置”中的任意位置键入任意关键字来过滤和突出显示设置\n- 搜索设置名称和描述\n- 帮助更有效地导航复杂的设置\n\n## 用户界面主题\n\n更改聊天界面的外观以满足您的喜好。\n\n有关此部分中的设置的更多信息 **用户设置**，参见 [用户界面定制](/guides/sillytavern/core-concepts/uicustomization/#ui-theme).\n\n## 角色处理\n\n- **字符列表副标题**：选择在角色名称下显示哪些附加信息 [ 角色](/guides/sillytavern/core-concepts/characterdesign/) 清单：\n - 角色版本\n - 创建者：\n- **导入卡标签**：控制导入角色卡时如何处理标签：\n - 询问 - 显示每次导入的对话框\n - None - 不导入任何标签\n - 全部 - 导入所有标签\n - 现有 - 仅导入已存在的标签\n- **高级角色搜索**：启用后，使用模糊匹配并搜索所有角色数据字段，而不仅仅是名称。\n- **更喜欢查尔。 提示词**：如果启用，则使用角色卡的系统提示词覆盖（如果可用）。\n- **更喜欢查尔。指示**：如果启用，则使用角色卡的历史记录指令覆盖（如果可用）。\n- **切勿调整头像大小**：防止裁剪/调整导入的角色图像的大小。禁用后，图像大小将调整为 512x768。\n- **显示头像文件名**：显示角色列表中角色头像的实际文件名。\n- **无剧透模式**：将角色定义隐藏在编辑器面板中的扰流按钮后面。\n\n## 杂项\n\n- **重新加载聊天**：重新加载并重画当前聊天。\n- **[调试菜单](#debug-menu)**：访问调试选项。\n- **流畅的串流**：通过逐字母显示文本来平滑流式生成。包括速度控制滑块。要从平滑流中排除推理块，请启用“排除‘思考...’”选项。\n- **流淡入**：对流文本应用淡入效果。可以在有或没有平滑流的情况下使用。\n- **[留言声音](/guides/sillytavern/core-concepts/uicustomization/#message-sound)**：消息生成完成时播放声音。\n - **仅背景声音**：仅在浏览器选项卡未聚焦时播放声音。\n- **宽松的 API URL**：减少 API URL 的格式要求。\n- **世界书导入对话框**：导入带有嵌入知识的角色时，显示世界书/世界书的导入对话框。\n- **自动选择输入文本**：单击时自动选择某些输入字段中的文本。\n- **Markdown 热键**：启用 Markdown 格式的键盘快捷键。\n- **恢复用户输入**：刷新页面时保留未保存的用户输入。\n- **移动用户界面**：允许通过拖动重新定位 UI 元素（仅限 PC）。\n - **重置** 按钮恢复默认位置\n - 用于保存/加载 UI 布局的预设系统\n\n## 聊天/消息处理\n\n### 消息显示设置\n\n控制消息在聊天界面中的加载和显示方式。这些设置会影响整体聊天体验和性能。\n\n- **# 要加载的消息**：分页前加载的聊天历史消息数（0 = 全部）\n- **流媒体 FPS**：流文本的更新速度（5-100 FPS）\n- **示例消息行为**:\n - 逐渐推出\n - 始终包含示例\n - 切勿包含示例\n- **图像滑动行为** （控制画廊风格图像的滑动切换回复操作）：\n - 生成新的：允许生成新图像 [图像生成](https://docs.sillytavern.app/extensions/stable-diffusion/) 延伸\n - 翻转：循环浏览现有图像，在末端环绕\n\n### 输入和响应控制\n\n确定如何发送消息以及 AI 如何继续响应的设置。\n\n- **输入发送**：选择“禁用”、“自动”(PC) 或“启用”\n- **“发送”继续**：使用“发送”按钮继续 AI 回复\n- **快速“继续”按钮**：显示延长AI最后一条消息的按钮\n- **快速“模拟”按钮**：显示单消息角色模拟按钮\n- **滑动切换回复**：显示替代 AI 响应的箭头按钮（PC 和移动设备）\n- **手势**：启用滑动切换回复手势生成（仅限移动设备）\n\n### 自动管理\n\n帮助管理聊天流程和内容的自动化功能。\n\n- **自动加载上次聊天记录**：启动时自动加载最近的聊天记录\n- **自动滚动聊天**：自动滚动到最新消息\n- **自动保存消息编辑**：保存消息编辑内容而不确认\n- **确认消息删除**：删除消息前的提示词\n- **自动修复 Markdown**：自动纠正 Markdown 格式\n\n#### 自动-滑动切换回复\n\n根据可配置的标准自动拒绝并重新生成 AI 消息。\n\n- **启用自动-滑动切换回复**：自动滑动切换回复功能的主开关\n- **最小生成消息长度**：如果消息短于此值，则触发自动滑动切换回复\n- **列入黑名单的单词**：可以触发auto-滑动切换回复的单词列表，以逗号分隔\n- **黑名单字数为滑动切换回复**：必须检测到触发自动滑动切换回复的黑名单单词的最小数量\n\n#### 自动继续\n\n如果模型在达到一定长度之前停止，则自动继续响应。\n\n这可以让你的人工智能在多个部分中写出一个长的响应，这样你就可以得到一个简短的响应 [响应长度设置](/guides/sillytavern/common-settings/#response-tokens) 同时仍然收到很长的回复。\n\n它不会让人工智能写出比其他情况更多的内容。要求人工智能继续一条它认为“已完成”的消息通常是行不通的。参见 [如何让AI写得更多？](/guides/sillytavern/faq/#how-to-make-the-ai-write-more) 以获得其他想法。\n\n- **启用自动继续**：自动继续的主切换\n- **允许聊天补全 API**：为聊天补全 API 端点启用自动继续功能\n- **目标长度（token）**：token 中所需的消息长度 - 如果消息短于该值（0-1024），将触发继续\n\n### 消息格式和显示\n\n控制消息的格式以及显示的内容。\n\n- **禁止外部媒体**：阻止来自外部域的嵌入媒体\n- **显示 {{char}}：在回复中**：如果生成，则在响应中保留角色名称前缀\n- **显示 {{user}}：在回复中**：如果生成，则在响应中保留用户名前缀\n- **实验宏引擎**：启用支持嵌套的高级宏处理\n- **在回复中显示标签**：允许响应中的（某些）HTML 标签显示为 HTML\n- **放松群组消息修剪**：允许AI在群聊中为其他角色发言，而不是停止生成响应\n- **显示群聊队列**：显示群聊角色列表中的回复顺序\n- **Pin 问候语消息样式**：始终渲染问候语中的样式标签，即使消息由于延迟加载而被卸载。\n\n### 提示词检查调试\n\n- **将提示词记录到控制台**：输出提示词到浏览器控制台\n- **请求 token 概率**：从 API 请求 AI 响应的 token 概率。如果有的话，可以在以下位置查看这些内容： [代币概率](/guides/sillytavern/chatting/#token-probabilities-panel).\n\n### 自动完成\n\n- 自动隐藏详细信息\n- 匹配样式（开头为/包含/模糊）\n- 视觉风格（主题/深色/浅色）\n- 键盘选择选项\n- 字体缩放\n- 宽度控制\n\n## ST脚本设置\n\n配置选项 [ST脚本解析器](https://docs.sillytavern.app/usage/st-script/#parser-flags).\n\n### 严格_转义\n\n- 管道不需要在带引号的值中转义。\n- 符号前面的反斜杠可以转义，以提供后跟功能符号的文字反斜杠。\n\n参见 [严格逃脱](https://docs.sillytavern.app/usage/st-script/#strict-escaping) 了解更多信息。\n\n### REPLACE_GETVAR\n\n当变量值包含可解释为宏的文本时，有助于避免双重替换。\n\n参见 [替换变量宏](https://docs.sillytavern.app/usage/st-script/#replace-variable-macros) 了解更多信息。\n\n## 清理菜单\n\n清理菜单提供了一个数据维护工具，可帮助您识别并删除 SillyTavern 安装中不必要的文件。此功能有助于保持数据目录井井有条，并可以释放大量磁盘空间。\n\n> **警告“重要警告”**\n>\n> 清理工具将永久删除文件。 **此操作无法撤消！**\n>\n> 手动上传到 `/data/user/files/` 和 `/data/user/images/` 如果目录不与聊天消息或资料库条目关联，则目录将被删除。\n>\n> 如果不确定，请在使用“清理”菜单之前备份数据。\n\n### 如何使用清理功能\n\n1. 单击 **清理** 按钮下的 **杂项** 部分\n2. 点击 **扫描** 分析您的安装。这可能需要一些时间，具体取决于数据目录的大小\n3. 查看找到的文件类别\n4. 使用 **查看** 删除前预览文件内容\n5. 使用 **下载** 删除前保存文件\n6. 根据需要删除单个文件或整个类别\n\n### 清理类别\n\n清理工具将松散文件扫描为以下类别：\n\n#### 文件\n\n- **它发现了什么**：与聊天消息或资料库条目无关的文件\n- **地点**: `/data//user/files/`\n- **风险**: ⚠️ **将删除手动上传** 聊天中未提及的内容\n- **何时清洁**：如果不需要未引用的文件，可以安全删除\n\n#### 图片\n\n- **它发现了什么**：与聊天消息无关的图像\n- **地点**: `/data//user/images/`\n- **风险**: ⚠️ **将删除手动上传** 聊天中未提及的内容\n- **何时清洁**：如果您不需要未引用的图像，可以安全删除\n\n#### 聊天记录\n\n- **它发现了什么**：与已删除的角色关联的聊天文件\n- **地点**: `data//chats/`\n- **风险**: ⚠️ **孤立的聊天将永久丢失**\n- **何时清洁**：如果您故意删除了角色并且不再需要他们的聊天记录，则可以安全删除\n\n#### 群聊\n\n- **它发现了什么**：与已删除群组关联的聊天文件\n- **地点**: `data//group chats/`\n- **风险**: ⚠️ **孤立的群聊将永久丢失**\n- **何时清洁**：如果您有意删除群组并且不再需要他们的聊天记录，则可以安全删除\n\n#### 头像缩略图\n\n- **它发现了什么**：缺失或删除的角色头像缩略图\n- **地点**: `data//thumbnails/avatar`\n- **风险**: ✅ **可以安全删除** - 需要时自动重新生成缩略图\n- **何时清洁**：始终安全清洁，有助于释放空间\n\n#### 背景缩略图\n\n- **它发现了什么**：丢失或删除背景的缩略图\n- **地点**: `data//thumbnails/bg`\n- **风险**: ✅ **可以安全删除** - 需要时自动重新生成缩略图\n- **何时清洁**：始终安全清洁，有助于释放空间\n\n#### 聊天备份\n\n- **它发现了什么**：自动生成聊天备份\n- **地点**: `data//backups/chat_*`\n- **风险**: ⚠️ **备份文件将永久丢失**\n- **何时清洁**：考虑保留最近的备份，但可以安全删除较旧的备份\n\n#### 设置备份\n\n- **它发现了什么**：自动生成设置备份\n- **地点**: `data//backups/settings_*`\n- **风险**: ⚠️ **设置备份文件将永久丢失**\n- **何时清洁**：考虑保留最近的备份，但可以安全删除较旧的备份\n\n## 调试菜单\n\n> **这些功能仅供高级用户使用。**\n>\n> 除非您完全了解其后果，否则请勿使用它们。\n\n调试菜单提供用于故障排除、维护和开发目的的功能。应谨慎使用这些函数，因为它们会显着影响您的 SillyTavern 安装。\n\n由于扩展可以添加调试功能，因此可用选项将根据您安装的扩展而有所不同。\n\n### 翻译和区域设置功能\n\n- **获取缺失的翻译**：分析当前语言环境（如果选择英语，则分析所有语言环境）是否缺少翻译并将结果输出到浏览器控制台\n- **应用区域设置**：通过重新应用所选区域设置强制刷新当前语言设置\n\n### 缓存和存储管理\n\n- **清除网络搜索缓存**：从本地缓存中删除所有存储的搜索结果\n- **清除所有向量索引**：完全删除所有源中所有存储的向量\n- **重置token缓存**：清除存储的 token 计数，强制所有聊天完全重新标记\n- **删除逐项提示词**：从本地存储中删除所有逐项提示词\n\n### 数据与统计\n\n- **刷新统计文件**：使用现有聊天数据重建统计文件\n- **回填 token 柜台**：重新计算当前聊天中所有消息的 token 计数\n - 在具有不同分词器的模型之间切换时很有用\n - 完成后触发聊天重新加载\n - 仅视觉变化，不修改聊天内容\n\n### API 和扩展测试\n\n- **更改 Mancer 基本 URL**：修改 Mancer API 服务器的基本 URL\n- **测试 WebSearch 扩展**：使用当前设置执行测试搜索\n- **发送生成请求**：使用当前选择的 API 测试文本生成\n\n### 系统和调试工具\n\n- **强制入职**：重新启动入职流程\n- **切换事件跟踪**：启用/禁用事件跟踪以进行调试\n- **复制 ST 设置**：\\[正在进行中]将系统配置数据复制到剪贴板以进行错误报告\n\n每个功能都可以使用其描述下方的“执行”按钮来执行。请考虑在使用这些工具之前备份数据，因为某些操作无法撤消。\n",
"searchText": "用户设置 用户界面定制 更改聊天界面的主题、外观和风格以满足您的喜好。 视觉小说模式 使用精灵与角色聊天，就像在 Doki Doki 文学俱乐部和其他著名 VN 游戏等视觉小说中一样。 常规设置 这些是影响您整体 SillyTavern 体验的核心设置。 用户界面语言 SillyTavern的用户界面有多种语言版本。语言选择器提供以下选项： 默认：使用您的系统语言（如果可用） 英语：无论系统设置如何，都强制使用英语 UI 通过下拉菜单可以选择其他语言 注意：此设置仅影响用户界面文本。对于人工智能对话翻译，请使用 聊天翻译 扩展。 软件版本 您当前的 SillyTavern 版本显示在右上角。此信息对于以下方面至关重要： 故障排除 确保与扩展的兼容性 确定更新是否可用 更新SillyTavern到最新版本，请参考 更新中 文档。 账户管理 控制您的 SillyTavern 用户帐户，备份您的设置和用户数据，并管理用户角色和权限 多用户模式. 账户 在“帐户”对话框中，您可以查看和编辑您的个人资料信息、更改密码以及管理帐户设置。 简介信息 显示名称（可通过铅笔图标编辑） 用户头像（也可以使用更改 用户人设) 账户手柄 用户角色 帐户创建日期 密码状态（锁定/解锁图标表示保护） 账户操作 设置快照：创建、管理和恢复用户设置的备份 下载备份：导出所有用户数据的完整备份 更改密码：更新您的帐户安全凭证 危险区 应谨慎使用的关键帐户操作： 重置设置：将所有设置恢复为出厂默认值 重置一切：完成帐户擦除并恢复出厂设置 管理面板 适用于： 多用户模式 多账户功能需要 enableUserAccounts 在 config.yaml 中设置为 true。 选择 管理用户 查看和管理现有用户帐户。 用户资料 自定义头像管理（上传/删除） 显示名称和句柄 角色和状态信息 帐户创建日期 密码保护状态 账户控制 编辑显示名称 启用帐户 禁用帐户 晋升为管理员 降级为普通用户 管理行动 下载用户数据备份 更改用户密码 删除帐户 新用户 选择 新用户 创建一个新的用户帐户。 显示名称*（例如“John Snow”） 用户句柄*（仅限小写字母、数字和破折号） 密码（可选） 密码确认 创建新用户会自动在 /data/ 目录中生成一个子文件夹，使用用户的句柄作为文件夹名称。 退出 适用于： 多用户模式 退出当前会话。 设置搜索 方便的搜索栏可帮助您快速找到特定设置： 在“用户设置”中的任意位置键入任意关键字来过滤和突出显示设置 搜索设置名称和描述 帮助更有效地导航复杂的设置 用户界面主题 更改聊天界面的外观以满足您的喜好。 有关此部分中的设置的更多信息 用户设置，参见 用户界面定制. 角色处理 字符列表副标题：选择在角色名称下显示哪些附加信息 角色 清单： 角色版本 创建者： 导入卡标签：控制导入角色卡时如何处理标签： 询问 - 显示每次导入的对话框 None - 不导入任何标签 全部 - 导入所有标签 现有 - 仅导入已存在的标签 高级角色搜索：启用后，使用模糊匹配并搜索所有角色数据字段，而不仅仅是名称。 更喜欢查尔。 提示词：如果启用，则使用角色卡的系统提示词覆盖（如果可用）。 更喜欢查尔。指示：如果启用，则使用角色卡的历史记录指令覆盖（如果可用）。 切勿调整头像大小：防止裁剪/调整导入的角色图像的大小。禁用后，图像大小将调整为 512x768。 显示头像文件名：显示角色列表中角色头像的实际文件名。 无剧透模式：将角色定义隐藏在编辑器面板中的扰流按钮后面。 杂项 重新加载聊天：重新加载并重画当前聊天。 调试菜单：访问调试选项。 流畅的串流：通过逐字母显示文本来平滑流式生成。包括速度控制滑块。要从平滑流中排除推理块，请启用“排除‘思考...’”选项。 流淡入：对流文本应用淡入效果。可以在有或没有平滑流的情况下使用。 留言声音：消息生成完成时播放声音。 仅背景声音：仅在浏览器选项卡未聚焦时播放声音。 宽松的 API URL：减少 API URL 的格式要求。 世界书导入对话框：导入带有嵌入知识的角色时，显示世界书/世界书的导入对话框。 自动选择输入文本：单击时自动选择某些输入字段中的文本。 Markdown 热键：启用 Markdown 格式的键盘快捷键。 恢复用户输入：刷新页面时保留未保存的用户输入。 移动用户界面：允许通过拖动重新定位 UI 元素（仅限 PC）。 重置 按钮恢复默认位置 用于保存/加载 UI 布局的预设系统 聊天/消息处理 消息显示设置 控制消息在聊天界面中的加载和显示方式。这些设置会影响整体聊天体验和性能。 # 要加载的消息：分页前加载的聊天历史消息数（0 = 全部） 流媒体 FPS：流文本的更新速度（5-100 FPS） 示例消息行为: 逐渐推出 始终包含示例 切勿包含示例 图像滑动行为 （控制画廊风格图像的滑动切换回复操作）： 生成新的：允许生成新图像 图像生成 延伸 翻转：循环浏览现有图像，在末端环绕 输入和响应控制 确定如何发送消息以及 AI 如何继续响应的设置。 输入发送：选择“禁用”、“自动”(PC) 或“启用” “发送”继续：使用“发送”按钮继续 AI 回复 快速“继续”按钮：显示延长AI最后一条消息的按钮 快速“模拟”按钮：显示单消息角色模拟按钮 滑动切换回复：显示替代 AI 响应的箭头按钮（PC 和移动设备） 手势：启用滑动切换回复手势生成（仅限移动设备） 自动管理 帮助管理聊天流程和内容的自动化功能。 自动加载上次聊天记录：启动时自动加载最近的聊天记录 自动滚动聊天：自动滚动到最新消息 自动保存消息编辑：保存消息编辑内容而不确认 确认消息删除：删除消息前的提示词 自动修复 Markdown：自动纠正 Markdown 格式 自动-滑动切换回复 根据可配置的标准自动拒绝并重新生成 AI 消息。 启用自动-滑动切换回复：自动滑动切换回复功能的主开关 最小生成消息长度：如果消息短于此值，则触发自动滑动切换回复 列入黑名单的单词：可以触发auto-滑动切换回复的单词列表，以逗号分隔 黑名单字数为滑动切换回复：必须检测到触发自动滑动切换回复的黑名单单词的最小数量 自动继续 如果模型在达到一定长度之前停止，则自动继续响应。 这可以让你的人工智能在多个部分中写出一个长的响应，这样你就可以得到一个简短的响应 响应长度设置 同时仍然收到很长的回复。 它不会让人工智能写出比其他情况更多的内容。要求人工智能继续一条它认为“已完成”的消息通常是行不通的。参见 如何让AI写得更多？ 以获得其他想法。 启用自动继续：自动继续的主切换 允许聊天补全 API：为聊天补全 API 端点启用自动继续功能 目标长度（token）：token 中所需的消息长度 - 如果消息短于该值（0-1024），将触发继续 消息格式和显示 控制消息的格式以及显示的内容。 禁止外部媒体：阻止来自外部域的嵌入媒体 显示 {{char}}：在回复中：如果生成，则在响应中保留角色名称前缀 显示 {{user}}：在回复中：如果生成，则在响应中保留用户名前缀 实验宏引擎：启用支持嵌套的高级宏处理 在回复中显示标签：允许响应中的（某些）HTML 标签显示为 HTML 放松群组消息修剪：允许AI在群聊中为其他角色发言，而不是停止生成响应 显示群聊队列：显示群聊角色列表中的回复顺序 Pin 问候语消息样式：始终渲染问候语中的样式标签，即使消息由于延迟加载而被卸载。 提示词检查调试 将提示词记录到控制台：输出提示词到浏览器控制台 请求 token 概率：从 API 请求 AI 响应的 token 概率。如果有的话，可以在以下位置查看这些内容： 代币概率. 自动完成 自动隐藏详细信息 匹配样式（开头为/包含/模糊） 视觉风格（主题/深色/浅色） 键盘选择选项 字体缩放 宽度控制 ST脚本设置 配置选项 ST脚本解析器. 严格_转义 管道不需要在带引号的值中转义。 符号前面的反斜杠可以转义，以提供后跟功能符号的文字反斜杠。 参见 严格逃脱 了解更多信息。 REPLACE_GETVAR 当变量值包含可解释为宏的文本时，有助于避免双重替换。 参见 替换变量宏 了解更多信息。 清理菜单 清理菜单提供了一个数据维护工具，可帮助您识别并删除 SillyTavern 安装中不必要的文件。此功能有助于保持数据目录井井有条，并可以释放大量磁盘空间。 警告“重要警告” 清理工具将永久删除文件。 此操作无法撤消！ 手动上传到 /data/user/files/ 和 /data/user/images/ 如果目录不与聊天消息或资料库条目关联，则目录将被删除。 如果不确定，请在使用“清理”菜单之前备份数据。 如何使用清理功能 单击 清理 按钮下的 杂项 部分 点击 扫描 分析您的安装。这可能需要一些时间，具体取决于数据目录的大小 查看找到的文件类别 使用 查看 删除前预览文件内容 使用 下载 删除前保存文件 根据需要删除单个文件或整个类别 清理类别 清理工具将松散文件扫描为以下类别： 文件 它发现了什么：与聊天消息或资料库条目无关的文件 地点: /data//user/files/ 风险: ⚠️ 将删除手动上传 聊天中未提及的内容 何时清洁：如果不需要未引用的文件，可以安全删除 图片 它发现了什么：与聊天消息无关的图像 地点: /data//user/images/ 风险: ⚠️ 将删除手动上传 聊天中未提及的内容 何时清洁：如果您不需要未引用的图像，可以安全删除 聊天记录 它发现了什么：与已删除的角色关联的聊天文件 地点: data//chats/ 风险: ⚠️ 孤立的聊天将永久丢失 何时清洁：如果您故意删除了角色并且不再需要他们的聊天记录，则可以安全删除 群聊 它发现了什么：与已删除群组关联的聊天文件 地点: data//group chats/ 风险: ⚠️ 孤立的群聊将永久丢失 何时清洁：如果您有意删除群组并且不再需要他们的聊天记录，则可以安全删除 头像缩略图 它发现了什么：缺失或删除的角色头像缩略图 地点: data//thumbnails/avatar 风险: ✅ 可以安全删除 - 需要时自动重新生成缩略图 何时清洁：始终安全清洁，有助于释放空间 背景缩略图 它发现了什么：丢失或删除背景的缩略图 地点: data//thumbnails/bg 风险: ✅ 可以安全删除 - 需要时自动重新生成缩略图 何时清洁：始终安全清洁，有助于释放空间 聊天备份 它发现了什么：自动生成聊天备份 地点: data//backups/chat_* 风险: ⚠️ 备份文件将永久丢失 何时清洁：考虑保留最近的备份，但可以安全删除较旧的备份 设置备份 它发现了什么：自动生成设置备份 地点: data//backups/settings_* 风险: ⚠️ 设置备份文件将永久丢失 何时清洁：考虑保留最近的备份，但可以安全删除较旧的备份 调试菜单 这些功能仅供高级用户使用。 除非您完全了解其后果，否则请勿使用它们。 调试菜单提供用于故障排除、维护和开发目的的功能。应谨慎使用这些函数，因为它们会显着影响您的 SillyTavern 安装。 由于扩展可以添加调试功能，因此可用选项将根据您安装的扩展而有所不同。 翻译和区域设置功能 获取缺失的翻译：分析当前语言环境（如果选择英语，则分析所有语言环境）是否缺少翻译并将结果输出到浏览器控制台 应用区域设置：通过重新应用所选区域设置强制刷新当前语言设置 缓存和存储管理 清除网络搜索缓存：从本地缓存中删除所有存储的搜索结果 清除所有向量索引：完全删除所有源中所有存储的向量 重置token缓存：清除存储的 token 计数，强制所有聊天完全重新标记 删除逐项提示词：从本地存储中删除所有逐项提示词 数据与统计 刷新统计文件：使用现有聊天数据重建统计文件 回填 token 柜台：重新计算当前聊天中所有消息的 token 计数 在具有不同分词器的模型之间切换时很有用 完成后触发聊天重新加载 仅视觉变化，不修改聊天内容 API 和扩展测试 更改 Mancer 基本 URL：修改 Mancer API 服务器的基本 URL 测试 WebSearch 扩展：使用当前设置执行测试搜索 发送生成请求：使用当前选择的 API 测试文本生成 系统和调试工具 强制入职：重新启动入职流程 切换事件跟踪：启用/禁用事件跟踪以进行调试 复制 ST 设置：[正在进行中]将系统配置数据复制到剪贴板以进行错误报告 每个功能都可以使用其描述下方的“执行”按钮来执行。请考虑在使用这些工具之前备份数据，因为某些操作无法撤消。",
"translationStatus": "machine-draft"
},
{
"slug": "core-concepts/uicustomization",
"title": "界面自定义",
"group": "User_Settings",
"order": 20,
"source": "Usage/User_Settings/uicustomization.md",
"sourceUrl": "https://docs.sillytavern.app/usage/core-concepts/uicustomization/",
"sourceSha256": "4a07bb479f94d352aa929b128bf2dcb29d280fceabbfd0fc90d36f9e8df36be1",
"headings": [
{
"id": "ui-customization",
"depth": 1,
"title": "界面自定义"
},
{
"id": "ui-theme",
"depth": 2,
"title": "用户界面主题"
},
{
"id": "theme-management",
"depth": 3,
"title": "主题管理"
},
{
"id": "display-settings",
"depth": 3,
"title": "显示设置"
},
{
"id": "avatar-style",
"depth": 4,
"title": "头像风格"
},
{
"id": "chat-style",
"depth": 4,
"title": "聊天风格"
},
{
"id": "notifications",
"depth": 3,
"title": "通知"
},
{
"id": "media-style",
"depth": 3,
"title": "媒体风格"
},
{
"id": "theme-colors",
"depth": 3,
"title": "主题颜色"
},
{
"id": "layout--visual-settings",
"depth": 3,
"title": "布局和视觉设置"
},
{
"id": "theme-toggles",
"depth": 3,
"title": "主题切换"
},
{
"id": "custom-css",
"depth": 3,
"title": "自定义CSS"
},
{
"id": "message-sound",
"depth": 2,
"title": "留言声音"
},
{
"id": "formulas-rendering",
"depth": 2,
"title": "公式渲染"
}
],
"content": "# 界面自定义\n\n## 用户界面主题\n\n### 主题管理\n\n主题文件允许您保存、共享和重用您的 UI 自定义设置。您可以根据不同的心情或目的维护多个主题，并立即在它们之间切换。\n\n- 导入/导出主题文件\n- 删除现有主题\n- 保存对当前主题的更改\n- 另存为新主题\n\n此部分中的所有设置都保存到当前主题。如果切换主题，这些设置将被新主题的设置替换。\n\n### 显示设置\n\n这些显示选项会影响角色和消息在聊天界面中的呈现方式。\n\n#### 头像风格\n\n在圆形、方形、矩形或圆角方形之间进行选择。此设置适用于用户和 AI 头像。\n\n#### 聊天风格\n\n| 风格 | 描述 | [斜线命令](https://docs.sillytavern.app/usage/st-script/#ui-styling) |\n| ------ | -------------------------------------------- | ---------------------------------------------------------------- |\n| **平** | 干净、连续的“聊天日志”风格，一个让你的人工智能交互变得栩栩如生的平面画布。 | `/flat`
`/default` |\n| **气泡** | “即时通讯”风格，每条消息都有明显的气泡、令人愉悦的圆角和微妙的 3D 效果。 | `/bubble`
`/bubbles` |\n| **文件** | 紧凑、类似文档的外观，具有以文本为中心的布局。隐藏过去消息的头像、时间戳和消息控制按钮。 | `/single`
`/story` |\n\n### 通知\n\n设置通知弹出窗口（Toast 消息）在屏幕上出现的位置。\n\n- 左上\n- 顶部居中（默认）\n- 右上\n- 左下角\n- 底部中心\n- 右下角\n\n### 媒体风格\n\n聊天消息中媒体附件（图像、音频、视频）的默认显示样式。将媒体附加到聊天消息的扩展程序可能会覆盖此设置。还可以使用消息上下文菜单中的“切换媒体显示样式”操作手动更改每条消息。\n\n- **列表**：以网格状布局一次性显示所有媒体附件。\n- **画廊**：在轮播式图库中显示媒体附件。\n\n> 此设置还会影响内联媒体附件发送到支持的聊天补全源的方式：列表一次发送所有附件，而图库发送选定的附件。\n\n### 主题颜色\n\n自定义每个 UI 元素的配色方案以创建您的完美主题。可以使用颜色选择器选择颜色，并在适用的情况下包括透明度选项。\n\n- 正文\n- 斜体文本\n- 带下划线的文本\n- 引用文字\n- 文字阴影\n- 聊天背景\n- 用户界面背景\n- 用户界面边框\n- 用户留言\n- 人工智能留言\n\n### 布局和视觉设置\n\n使用这些滑块微调界面的视觉呈现。\n\n- **聊天宽度**：调整聊天窗口宽度（屏幕的25-100%）\n- **字体比例**：自定义文字大小（0.5-1.5x）\n- **模糊强度**：控制 UI 面板模糊（0-30）\n- **阴影宽度**：调整文本阴影强度（0-5）\n\n### 主题切换\n\n这些开关控制各种 UI 功能和行为。有些选项可以提高低端设备的性能，而其他选项则可以向聊天界面添加有用的信息或功能。\n\n- **减少运动**：禁用动画和过渡\n- **无模糊效果**：消除背景模糊以获得更好的性能\n- **无文字阴影**：禁用文本阴影效果\n- **[视觉小说模式](/guides/sillytavern/user-settings/visual-novel/)**：与背景精灵的紧凑聊天\n- **展开消息操作**：始终显示完整消息上下文菜单\n- **禅宗滑块**：简化的参数控制\n- **疯狂实验室模式**：参数范围不受限制\n- **消息定时器**：显示AI响应生成时间\n- **聊天时间戳**：显示消息时间戳\n- **模型图标**：显示消息的AI模型图标\n- **消息 ID**：显示连续的消息编号\n- **隐藏聊天头像**：从聊天中删除头像\n- **消息令牌计数**：显示每条消息的 token 计数\n- **紧凑的输入区域**：单行输入（仅限移动设备）\n- **滑动#查看所有消息**：在所有消息上显示滑动切换回复号码\n- **角色热插拔**：快速选择喜爱的角色按钮\n- **头像悬停放大倍数**：头像悬停时的缩放效果\n- **标签作为文件夹**：使用标签作为文件夹组织角色\n- **点击编辑**：点击消息快速打开消息编辑器\n\n### 自定义CSS\n\n允许您应用自定义 CSS 样式来进一步自定义聊天界面的外观。\n\n使用 **展开** 扩展编辑器窗口以获得更好的可见性和编辑效果。\n\n如果您切换主题，您的自定义 CSS 将被新主题的自定义 CSS 替换。如果您想在切换主题时保留自定义 CSS，请确保将其保存到主题中。\n\n如果您使用大量自定义 CSS，或者想要对多个主题使用相同的自定义 CSS，非官方的 [CSS 片段扩展](https://github.com/LenAnderson/SillyTavern-CssSnippets) 可以帮助您管理和组织您的自定义 CSS。\n\n***\n\n## 留言声音\n\n要在收到来自机器人的新消息时播放您自己的自定义声音，请替换 SillyTavern 文件夹中的以下 MP3 文件：\n\n`public/sounds/message.mp3`\n\n以 80% 音量播放。\n\n如果“[仅背景声音](/guides/sillytavern/user-settings/#miscellaneous)\" 选项启用时，仅当 SillyTavern 窗口打开时才播放声音 **不专心的**.\n\n## 公式渲染\n\n要启用数学公式渲染，请使用 [乳胶扩展](https://github.com/SillyTavern/Extension-LaTeX)。要获取扩展，您需要通过 SillyTavern 中的“下载扩展和资源”菜单进行安装。\n\n在代码块中输入公式 `latex` 或 `asciimath` 分别为 LaTeX 和 AsciiMath 的语言标识符。该扩展使用 [凯泰克斯](https://katex.org/) 用于渲染。\n\n```latex\n\\int_{-\\infty}^{\\infty} e^{-x^2} dx = \\sqrt{\\pi}\n```\n\n```asciimath\nint_{-oo}^{oo} e^{-x^2} dx = sqrt{pi}\n```
\n\n!!!info 弃用通知\n遗产 `$` 和 `$$` 不再支持包装语法。请使用以下正则表达式脚本来填充旧语法：\n\n- [$$ - 乳胶](https://github.com/SillyTavern/Extension-LaTeX/raw/refs/heads/main/assets/$$_-_latex.json)\n- [$ - Ascii 数学](https://github.com/SillyTavern/Extension-LaTeX/raw/refs/heads/main/assets/$_-_asciimath.json)\n !!!\n",
"searchText": "界面自定义 用户界面主题 主题管理 主题文件允许您保存、共享和重用您的 UI 自定义设置。您可以根据不同的心情或目的维护多个主题，并立即在它们之间切换。 导入/导出主题文件 删除现有主题 保存对当前主题的更改 另存为新主题 此部分中的所有设置都保存到当前主题。如果切换主题，这些设置将被新主题的设置替换。 显示设置 这些显示选项会影响角色和消息在聊天界面中的呈现方式。 头像风格 在圆形、方形、矩形或圆角方形之间进行选择。此设置适用于用户和 AI 头像。 聊天风格 风格 描述 斜线命令 平 干净、连续的“聊天日志”风格，一个让你的人工智能交互变得栩栩如生的平面画布。 /flat /default 气泡 “即时通讯”风格，每条消息都有明显的气泡、令人愉悦的圆角和微妙的 3D 效果。 /bubble /bubbles 文件 紧凑、类似文档的外观，具有以文本为中心的布局。隐藏过去消息的头像、时间戳和消息控制按钮。 /single /story 通知 设置通知弹出窗口（Toast 消息）在屏幕上出现的位置。 左上 顶部居中（默认） 右上 左下角 底部中心 右下角 媒体风格 聊天消息中媒体附件（图像、音频、视频）的默认显示样式。将媒体附加到聊天消息的扩展程序可能会覆盖此设置。还可以使用消息上下文菜单中的“切换媒体显示样式”操作手动更改每条消息。 列表：以网格状布局一次性显示所有媒体附件。 画廊：在轮播式图库中显示媒体附件。 此设置还会影响内联媒体附件发送到支持的聊天补全源的方式：列表一次发送所有附件，而图库发送选定的附件。 主题颜色 自定义每个 UI 元素的配色方案以创建您的完美主题。可以使用颜色选择器选择颜色，并在适用的情况下包括透明度选项。 正文 斜体文本 带下划线的文本 引用文字 文字阴影 聊天背景 用户界面背景 用户界面边框 用户留言 人工智能留言 布局和视觉设置 使用这些滑块微调界面的视觉呈现。 聊天宽度：调整聊天窗口宽度（屏幕的25-100%） 字体比例：自定义文字大小（0.5-1.5x） 模糊强度：控制 UI 面板模糊（0-30） 阴影宽度：调整文本阴影强度（0-5） 主题切换 这些开关控制各种 UI 功能和行为。有些选项可以提高低端设备的性能，而其他选项则可以向聊天界面添加有用的信息或功能。 减少运动：禁用动画和过渡 无模糊效果：消除背景模糊以获得更好的性能 无文字阴影：禁用文本阴影效果 视觉小说模式：与背景精灵的紧凑聊天 展开消息操作：始终显示完整消息上下文菜单 禅宗滑块：简化的参数控制 疯狂实验室模式：参数范围不受限制 消息定时器：显示AI响应生成时间 聊天时间戳：显示消息时间戳 模型图标：显示消息的AI模型图标 消息 ID：显示连续的消息编号 隐藏聊天头像：从聊天中删除头像 消息令牌计数：显示每条消息的 token 计数 紧凑的输入区域：单行输入（仅限移动设备） 滑动#查看所有消息：在所有消息上显示滑动切换回复号码 角色热插拔：快速选择喜爱的角色按钮 头像悬停放大倍数：头像悬停时的缩放效果 标签作为文件夹：使用标签作为文件夹组织角色 点击编辑：点击消息快速打开消息编辑器 自定义CSS 允许您应用自定义 CSS 样式来进一步自定义聊天界面的外观。 使用 展开 扩展编辑器窗口以获得更好的可见性和编辑效果。 如果您切换主题，您的自定义 CSS 将被新主题的自定义 CSS 替换。如果您想在切换主题时保留自定义 CSS，请确保将其保存到主题中。 如果您使用大量自定义 CSS，或者想要对多个主题使用相同的自定义 CSS，非官方的 CSS 片段扩展 可以帮助您管理和组织您的自定义 CSS。 留言声音 要在收到来自机器人的新消息时播放您自己的自定义声音，请替换 SillyTavern 文件夹中的以下 MP3 文件： public/sounds/message.mp3 以 80% 音量播放。 如果“仅背景声音\" 选项启用时，仅当 SillyTavern 窗口打开时才播放声音 不专心的. 公式渲染 要启用数学公式渲染，请使用 乳胶扩展。要获取扩展，您需要通过 SillyTavern 中的“下载扩展和资源”菜单进行安装。 在代码块中输入公式 latex 或 asciimath 分别为 LaTeX 和 AsciiMath 的语言标识符。该扩展使用 凯泰克斯 用于渲染。 !!!info 弃用通知 遗产 $ 和 $$ 不再支持包装语法。请使用以下正则表达式脚本来填充旧语法： $$ - 乳胶 $ - Ascii 数学 !!!",
"translationStatus": "machine-draft"
},
{
"slug": "user-settings/visual-novel",
"title": "视觉小说模式",
"group": "User_Settings",
"order": 10,
"source": "Usage/User_Settings/Visual-Novel.md",
"sourceUrl": "https://docs.sillytavern.app/usage/user-settings/visual-novel/",
"sourceSha256": "d90845b9713c00243bcf7e89108fbeb854afbe648c4cfc0cc4c213b2303c52ef",
"headings": [
{
"id": "visual-novel-vn-mode",
"depth": 1,
"title": "视觉小说模式"
},
{
"id": "toggling-visual-novel-mode",
"depth": 2,
"title": "切换视觉小说模式"
},
{
"id": "enabling-visual-novel-mode",
"depth": 3,
"title": "启用视觉小说模式"
},
{
"id": "disabling-visual-novel-mode",
"depth": 3,
"title": "禁用视觉小说模式"
},
{
"id": "the-visual-novel-ui",
"depth": 2,
"title": "视觉小说用户界面"
},
{
"id": "vn-mode-with-movingui",
"depth": 3,
"title": "带 MovingUI 的 VN 模式"
},
{
"id": "obtaining-character-sprites",
"depth": 2,
"title": "获取角色精灵"
},
{
"id": "vn-extensions",
"depth": 2,
"title": "越南延伸"
},
{
"id": "prome-visual-novel-extension",
"depth": 3,
"title": "Prome 视觉小说扩展"
}
],
"content": "# 视觉小说模式\n\n视觉小说模式是 SillyTavern 中的一种特殊屏幕布局，允许您使用精灵（或其角色卡图像）与角色聊天，类似于 Doki Doki 文学俱乐部、The Fruits of Grisaia、Fate: Stay/night 和其他著名 VN 游戏等视觉小说。\n\n## 切换视觉小说模式\n\n### 启用视觉小说模式\n\n视觉小说模式内置于 SillyTavern 中，可以通过以下方式切换 *用户设置* （用户设置图标）并检查 **视觉小说模式** 下面 *无文字阴影*.\n\n\n\n### 禁用视觉小说模式\n\n禁用视觉小说模式与启用它的步骤相同。取消切换视觉小说模式，您应该回到正常的聊天屏幕。\n\n> **关于带有 VN 扩展的 VN 模式**\n>\n> 如果您使用各自的 VN 模式，某些扩展（例如 Prome VN 扩展）将打开“视觉小说模式”。从以下位置启用/禁用 VN 模式 *用户设置* 菜单也会影响这些扩展。\n\n## 视觉小说用户界面\n\n\n\n在视觉小说模式中，UI 略有更改，以适应中心显示的角色精灵（或角色卡图像）。然而，在与多个角色的群聊中，角色精灵会分散开来，相互适应，如下所示。\n\n\n\n### 带 MovingUI 的 VN 模式\n\n> 要切换 MovingUI，请转至 *用户设置* 并检查 **移动用户界面**。请注意此功能 **仅** 适用于台式机。\n\n如果 **移动用户界面** 启用于 *用户设置*，如果您希望移动精灵（或角色卡图像）或将它们放置在屏幕上更具体的区域，则可以移动它们。\n\n> **关于精灵尺寸**\n>\n> 如果角色精灵的大小相对较大，则尝试使用 MovingUI 移动某些精灵将是一个挑战，因为拖动精灵的按钮可能会被现有精灵覆盖。您可能需要比平常更多地移动它们，特别是如果屏幕上有更多角色以获得更好的位置。\n\n\n\n## 获取角色精灵\n\n获取角色精灵可以通过浏览互联网查找现有精灵来完成，例如，来自视觉小说的现有角色或使用视觉小说功能（如 DDLC 或 CounterSide）的游戏。如果您想要精灵的角色尚未附带精灵，您还有几个选择。\n\n1. 在角色帖子中搜索任何精灵 ZIP 包或精灵包链接。\n\n > 一些机器人创建者可能会使用精灵包发布他们的机器人（在同一篇文章中或在精灵频道中）。如果有人还没有制作您想要的角色精灵，请搜索这些帖子。\n\n2. 使用 LoRA 和稳定扩散创建您自己的。\n\n > 从头开始生成精灵非常耗时（特别是如果您的角色和/或您想要使用的稳定扩散模型不存在 LoRA），并且需要合适的硬件才能生成它们，如果您计划制作 28 个精灵表达式而不是 6 个，并且如果您使用 SDXL 和/或将精灵升级到更高分辨率，则更是如此。\n\n3. 使用角色卡图像。它可能不像精灵，但至少你可以在屏幕上看到一些东西。但是，多个角色卡不能在 VN 模式下使用。\n\n > **Prome 视觉小说扩展中的角色卡图片**\n >\n > 在 Prome Visual Novel Extension 1.0.6+ 中，有一个功能称为 `Emulate Character Card as Sprite` 允许您通过使用角色卡作为聊天中的精灵来与精灵和非精灵角色进行群聊。\n >\n > \n\n## 越南延伸\n\n### Prome 视觉小说扩展\n\nProme 视觉小说扩展是 Bronya Rand 和 Prometheus 认可的第三方扩展，它进一步增强了 SillyTavern 中的视觉小说体验，其功能包括使视觉小说 UI 更加“电影化”的信箱模式、带有变暗角色 Sprites 的焦点模式、只有聊天中的最后一条消息出现在聊天中的传统 VN 模式以及更多计划！\n\n| 信箱模式 | 传统VN模式 |\n| :--------------------------------------------------------------------: | :------------------------------------------------------------------------: |\n|  |  |\n\n| 隐藏架（消息框） | 聚焦模式（带变暗精灵） |\n| :------------------------------------------------------------------: | :---------------------------------------------------------------------: |\n|  |  |\n\n要安装 Prome Visual Novel Extension，您可以通过以下方式安装： `Download Extensions & Assets` 并发现 *Prome 视觉小说扩展*，或按照安装说明进行操作 [Prome 视觉小说扩展](https://github.com/Bronya-Rand/Prome-VN-Extension?tab=readme-ov-file#installation-and-usage) Github 页面。调整 Prome 的设置可以在 *扩展* -> **Prome（视觉小说扩展）** 或通过 🪄（魔杖）菜单。\n",
"searchText": "视觉小说模式 视觉小说模式是 SillyTavern 中的一种特殊屏幕布局，允许您使用精灵（或其角色卡图像）与角色聊天，类似于 Doki Doki 文学俱乐部、The Fruits of Grisaia、Fate: Stay/night 和其他著名 VN 游戏等视觉小说。 切换视觉小说模式 启用视觉小说模式 视觉小说模式内置于 SillyTavern 中，可以通过以下方式切换 用户设置 （用户设置图标）并检查 视觉小说模式 下面 无文字阴影. 禁用视觉小说模式 禁用视觉小说模式与启用它的步骤相同。取消切换视觉小说模式，您应该回到正常的聊天屏幕。 关于带有 VN 扩展的 VN 模式 如果您使用各自的 VN 模式，某些扩展（例如 Prome VN 扩展）将打开“视觉小说模式”。从以下位置启用/禁用 VN 模式 用户设置 菜单也会影响这些扩展。 视觉小说用户界面 在视觉小说模式中，UI 略有更改，以适应中心显示的角色精灵（或角色卡图像）。然而，在与多个角色的群聊中，角色精灵会分散开来，相互适应，如下所示。 带 MovingUI 的 VN 模式 要切换 MovingUI，请转至 用户设置 并检查 移动用户界面。请注意此功能 仅 适用于台式机。 如果 移动用户界面 启用于 用户设置，如果您希望移动精灵（或角色卡图像）或将它们放置在屏幕上更具体的区域，则可以移动它们。 关于精灵尺寸 如果角色精灵的大小相对较大，则尝试使用 MovingUI 移动某些精灵将是一个挑战，因为拖动精灵的按钮可能会被现有精灵覆盖。您可能需要比平常更多地移动它们，特别是如果屏幕上有更多角色以获得更好的位置。 获取角色精灵 获取角色精灵可以通过浏览互联网查找现有精灵来完成，例如，来自视觉小说的现有角色或使用视觉小说功能（如 DDLC 或 CounterSide）的游戏。如果您想要精灵的角色尚未附带精灵，您还有几个选择。 在角色帖子中搜索任何精灵 ZIP 包或精灵包链接。 一些机器人创建者可能会使用精灵包发布他们的机器人（在同一篇文章中或在精灵频道中）。如果有人还没有制作您想要的角色精灵，请搜索这些帖子。 使用 LoRA 和稳定扩散创建您自己的。 从头开始生成精灵非常耗时（特别是如果您的角色和/或您想要使用的稳定扩散模型不存在 LoRA），并且需要合适的硬件才能生成它们，如果您计划制作 28 个精灵表达式而不是 6 个，并且如果您使用 SDXL 和/或将精灵升级到更高分辨率，则更是如此。 使用角色卡图像。它可能不像精灵，但至少你可以在屏幕上看到一些东西。但是，多个角色卡不能在 VN 模式下使用。 Prome 视觉小说扩展中的角色卡图片 在 Prome Visual Novel Extension 1.0.6+ 中，有一个功能称为 Emulate Character Card as Sprite 允许您通过使用角色卡作为聊天中的精灵来与精灵和非精灵角色进行群聊。 越南延伸 Prome 视觉小说扩展 Prome 视觉小说扩展是 Bronya Rand 和 Prometheus 认可的第三方扩展，它进一步增强了 SillyTavern 中的视觉小说体验，其功能包括使视觉小说 UI 更加“电影化”的信箱模式、带有变暗角色 Sprites 的焦点模式、只有聊天中的最后一条消息出现在聊天中的传统 VN 模式以及更多计划！ 信箱模式 传统VN模式 隐藏架（消息框） 聚焦模式（带变暗精灵） 要安装 Prome Visual Novel Extension，您可以通过以下方式安装： Download Extensions & Assets 并发现 Prome 视觉小说扩展，或按照安装说明进行操作 Prome 视觉小说扩展 Github 页面。调整 Prome 的设置可以在 扩展 -> Prome（视觉小说扩展） 或通过 🪄（魔杖）菜单。",
"translationStatus": "machine-draft"
}
]
}