AI 对话扩展
AI 对话扩展可以在 TurboWarp 中连接 DeepSeek、通义千问、豆包、智谱 GLM、Kimi、硅基流动和百度千帆等 AI 服务。扩展支持多轮对话、角色设定、历史容量管理和随时取消提问。
扩展需要以“不使用沙箱运行扩展”的方式加载。API Key 只保存在当前电脑的应用存储中，不会写入 Scratch 项目文件。AI 服务可能按量收费，请在相应平台查看价格和可用额度。
使用前准备
配置 AI 连接…
功能：打开 AI 连接配置窗口。选择服务商，填写 API Key，刷新并勾选需要使用的模型，然后测试或保存连接。
已经保存的连接可以在“使用 AI 连接”积木中选择。删除或修改连接会取消正在进行的提问。
参数：无
返回值：无
难度：☆
角色积木介绍
每个角色分别保存自己的连接、角色设定、对话记忆和提问状态。
使用 AI 连接[本机默认模型]
功能：选择当前角色提问时使用的 AI 连接。选择“本机默认模型”时，使用配置窗口中的第一个可用连接。
更换连接会清空当前角色的对话记忆、上次回答和错误状态。
AI 连接参数：固定参数积木，选项为已经在本机保存的服务商和模型。
返回值：无
难度：☆
设置 AI 角色为(系统提示词)
功能：设置当前角色对话时使用的角色说明。例如，可以要求 AI 使用适合小学生的语言回答，或让 AI 扮演故事中的人物。
重新设置角色说明会清空当前角色已有的对话记忆和状态。参数留空时，AI 默认作为一位友好的助手回答。
角色说明参数：椭圆形参数，发送给 AI 的角色、语气和回答要求。
返回值：无
难度：☆
设置对话记忆[开启]
功能：设置 AI 是否记住当前角色之前的提问和回答。开启后可以连续追问；关闭后，每次提问都是一段新的对话。
切换对话记忆会清空当前角色已有的对话记忆和状态。
对话记忆参数：固定参数积木，选项为“开启”或“关闭”，默认为“开启”。
返回值：无
难度：☆
清空对话记忆
功能：清空当前角色保存的对话内容、历史摘要、上次回答、错误说明和历史处理说明，相当于开始一段新对话。AI 连接、角色设定和容量设置不会改变。
如果 AI 正在回答，该提问也会被取消。
参数：无
返回值：无
难度：☆
向 AI 提问(提示词)并等待
功能：向当前角色选择的 AI 模型发送问题，并等待模型回答。积木执行结束后，可以通过“AI 的回答”“上次提问成功？”和“错误说明”积木读取结果。
如果当前角色已经在提问，再次执行本积木不会重复发送请求。
问题参数：椭圆形参数，需要发送给 AI 的问题。参数不能只包含空白字符。
返回值：无
难度：☆
AI 的回答
功能：读取当前角色上一次成功提问得到的文字回答。开始新的提问、清空对话或发生错误时，返回值会被清空。用于椭圆形参数积木和椭圆形下拉参数积木中。
在舞台上显示为监视器时，它会显示编辑器中当前所选角色的回答。
参数：无
返回值：AI 模型返回的文字回答。
难度：☆
上次提问成功？
功能：判断当前角色上一次提问是否成功获得完整回答。
用于菱形参数积木中。
参数：无
返回值：成功时返回 true，否则返回 false。
难度：☆
错误说明
功能：读取当前角色上一次提问失败的原因，例如连接未配置、密钥无效、余额不足、模型不可用、网络错误、等待超时或回答被取消。用于椭圆形参数积木和椭圆形下拉参数积木中。
扩展会隐藏 API Key 等凭据信息，不会把服务商返回的原始错误内容直接显示出来。
参数：无
返回值：便于阅读的错误说明；没有错误时返回空文字。
难度：☆
AI 正在回答？
功能：判断当前角色是否正在等待 AI 回答。可以用它控制等待动画、提示文字或按钮状态。
用于菱形参数积木中。
参数：无
返回值：正在回答时返回 true，否则返回 false。
难度：☆
取消当前提问
功能：取消当前角色正在进行的提问。取消后，“上次提问成功？”返回 false，“错误说明”返回“已取消本次提问。”。
如果当前角色没有正在进行的提问，执行本积木不会产生影响。
参数：无
返回值：无
难度：☆
历史达到上限时[摘要并保留最近对话]
功能：设置对话历史接近容量上限时的处理方式。
处理方式参数：固定参数积木，包含以下选项：
摘要并保留最近对话：让 AI 把较早的对话整理成摘要，同时保留最近的完整对话。默认使用此方式，摘要可能遗漏细节。
删除最早轮次：直接删除最早的完整提问和回答，不额外调用 AI 生成摘要。
到达上限时暂停：不修改历史，停止本次提问，并在“错误说明”中提示先清空记忆或调整设置。
返回值：无
难度：☆☆
设置对话容量[默认（32000）]token
功能：设置角色说明、对话历史、本次问题和预留回答共同使用的容量。容量越大，可以保留的上下文通常越多，但实际可用长度仍受所选模型限制。
容量参数：固定参数积木，选项为“较短（4000）”“适中（8000）”“较长（16000）”和“默认（32000）”。
返回值：无
难度：☆☆
设置回答 token 上限[2048]
功能：设置一次回答最多可以使用的 token 数量。数值越大，AI 可以生成更长的回答，同时会占用更多对话容量和服务商额度。
如果回答达到上限仍未完成，本次提问会失败，并在“错误说明”中提示缩短问题或增加上限。
回答上限参数：固定参数积木，选项为 1024、2048、4096 和 8192，默认为 2048。
回答 token 上限必须小于对话容量，否则提问时会提示对话容量不足。
返回值：无
难度：☆☆
历史处理说明
功能：用于查看本次提问时，扩展是否因为对话容量不足而整理了历史记录。它返回的是处理说明，不是历史对话或摘要正文。例如，返回较早对话被摘要或删除的轮数。选择“到达上限时暂停”，或者摘要处理失败时，原因显示在 “错误说明” 积木中。
参数：无
返回值：历史处理说明；
- 容量足够，无需处理历史：
空字符串 "" - 使用“删除最早轮次”：
已删除最早的 3 轮完整对话 - 删除轮次时也清除了旧摘要：
已删除最早的 3 轮完整对话及旧摘要 - 使用“摘要并保留最近对话”：
已将较早的 8 轮对话压缩为摘要，保留最近 2 轮完整对话，并留出后续空间。摘要可能遗漏细节
难度：☆☆
舞台积木介绍
同角色积木一致。舞台和每个角色分别保存自己的连接、角色设定、对话记忆和提问状态。