编排预设
每一种编排模式（spec / agenda / loop / director）都在两个作用域各自维护一份预设库：
- 全局 —— 预设存放在扩展设置里，对所有聊天可用。
- 角色卡 —— 预设存放在角色卡本身上，导出角色卡时随卡一起带走。
一份预设记录了该模式编排面板里的所有内容 —— 系统提示词、工具开关、子代理、planner 配置、loop 上限、capsule 注入策略。它不记录提示词预设或 API 预设；这两者在预设里只按名字引用，运行时再去解析。
为什么按模式分库
spec 预设和 director 预设在结构上没有任何共通的字段，所以它们活在彼此独立的库里。切换执行模式时露出的是当前模式的库，其它模式的库保持原样。
预设栏
预设栏位于每种模式编辑面板的顶部：
它提供了一组标准操作：
- 下拉菜单 —— 当前
（模式， 作用域）库下所有预设的列表。选中一项后，编辑器会重新加载为该预设的内容。 - 新建 —— 用当前模式的出厂默认数据起一份全新预设。
- 复制 —— 把当前激活预设克隆一份，起个新名字；克隆品成为新的激活预设。
- 重命名 —— 改名字。底层 id 保持不变，所以任何按 id 引用这份预设的地方都不会失效。
- 删除 —— 删除该预设。如果删的是当前激活预设，列表里的下一份会自动成为激活预设。如果整个库被删空，下一次读取时
Default会自动从出厂数据重新填回。 - 导入 / 导出 —— 使用标准的可移植 JSON 格式。导入时会让你起个名字，加进当前库；导出会把当前激活预设写到磁盘。
在面板里做的编辑会写回到当前激活预设。没有显式保存这一步 —— 关闭面板或切换预设时，当前状态已经持久化。
全局作用域 vs 角色卡作用域
作用域选择器决定预设栏当下展示的是哪一份库。
当 作用域 = 全局 时，预设栏展示该模式的全局库。在这里改动会影响所有没有自己角色卡覆写的聊天。
当 作用域 = 角色卡 时（需要先加载一张角色卡），预设栏切换到这张卡自己的库。使用角色卡覆写 开关决定卡上的激活预设是否在运行时盖过全局激活预设：
- 覆写关闭 —— 卡自己的库仍然存在并可编辑，但运行时以全局激活预设为准。适合在还没决定启用前先草拟一份卡专属预设。
- 覆写开启 —— 卡上的激活预设对这个角色生效；这次聊天里全局激活预设被忽略。
如果这张卡还没有自己的预设库，预设栏会展示一项叫 Default 的条目，内容从当前全局激活预设种出。一旦你开始编辑，卡的预设库就被透明地创建出来 —— 不存在「先初始化卡库」这一独立步骤。
角色卡导出时带上自己的预设库
导出角色卡时会把卡自己的预设库一并打包，所以在另一台机器导入这张卡时，卡上的预设也跟着过来。别人拿到你的卡，开箱就是一套能跑的完整编排配置，不需要额外导入任何文件。
编排预设和提示词预设、API 预设的关系
编排预设是一次生成里三个相互独立的层之一，另外两个是 SillyTavern 的提示词预设和连接配置：
| 概念 | 控制什么 | 存在哪里 |
|---|---|---|
| 编排预设 | 子代理、工具、planner、loop 上限、系统提示词、capsule 注入 | 扩展设置或角色卡上 |
| 提示词预设（chat completion preset） | token 预算、采样器、提示词顺序、越狱 | SillyTavern 预设 |
| API 预设（连接配置） | 端点、模型、API key | 连接管理器 |
编排预设按名字引用提示词预设和 API 预设 —— 例如一份 director 预设可以把它的 voice_critic 子代理钉到 Sonnet · 慢节奏评审、其它一切走 Haiku · 快速。切换激活的编排预设不会切底层提示词预设；切提示词预设也不会动到编排。
实际效果是：名为 审讯节奏 和 重叙事密度 的两份预设，可以共用同一份提示词预设和连接配置，只在编排形态上有差别 —— 不同的子代理、不同的 planner 指令、不同的注入深度。你在预设栏里前后切换，不用碰连接管理器，也不用动 SillyTavern 的预设下拉。
Agent 提示词预设解析优先读角色卡
当一份编排预设按名字把某个 agent 钉到某份提示词预设（Sonnet · 慢节奏评审、Haiku · 快速 等）时，这个名字是在生成时才解析的。查找顺序：
- 当前角色的卡内嵌预设集合——只要卡上有一份内嵌预设的名字命中，直接用它。
- 你本地的聊天补全预设库。
- 前两者都没命中时，回退到编排器设置里钉住的全局运行时默认。
卡优先的顺序在角色卡携带自己推荐预设时很关键：编排 profile 和它引用的预设一起走，接收方无需单独导入匹配的预设。若接收方本地有同名预设，卡上的副本仍然在该角色范围内胜出——卡作者调好的提示词形态不会被接收方本地随便起的同名预设遮盖。
编排器抽屉里每个 agent 的预设选择器顶部，当加载了角色卡时会展示一个「本卡内嵌」optgroup，列出卡上的内嵌预设——所以你能在同一个 UI 里同时看到并选择卡上的和本地的预设。
把编排配置提交到角色卡时按需内嵌引用的预设
向当前角色卡提交编排配置时，Luker 会先预检 agent 引用的提示词预设名字，查出哪些还没内嵌到卡上。这里的「提交」既包括编排器抽屉里的「保存到角色卡覆写」，也包括「AI 迭代工作台」弹窗里的「应用到角色卡」——两种入口共用同一次预检。
若有未内嵌的引用，会弹出汇总窗口列出它们，提供三个动作：
- 全部内嵌——把每个引用预设的本地内容复制到卡上，让编排 profile 在导出后端到端可跑。
- 只存名字——按原样持久化编排 profile，不嵌入预设内容。接收方若没有同名本地预设，那些 agent 会走运行时默认回退。
- 取消——中止提交。
在面板里编辑 agent 的预设引用本身不会触发弹窗——选择权属于提交这一步，不属于编辑那一步。
角色卡槽位如何管理、编辑、剥离连接字段，详见角色卡绑定预设与人设。
Default 预设
Default 是一个种子条目，不是受保护条目。你可以重命名它、随意编辑它、删除它 —— 名字上没有星号，系统也不会把它当成任何特殊存在。
唯一一条特殊行为：如果你把一个库里的预设全部删光，下一次读取这个库时 Default 会从出厂数据自动重新种出来。这意味着你不可能因为删得太狠就让某种模式陷入没法跑的状态；也意味着只要你想从头来，删光所有预设就能拿回出厂数据。
用法举例
预设栏支撑起的几种常见工作流：
- 同一张卡用两份预设 —— 给日常场景用一份又快又省的预设，给重头戏场景用一份慢一点但密度更高的预设。两份都保存在角色卡作用域下，需要时从下拉里翻。
- 把角色卡预设提升为全局 —— 把卡上的激活预设导出，再把预设栏切到全局作用域，导入这份 JSON。现在全局库里也有了同一份预设，对所有聊天可用。
- 试一份预设但不承诺 —— 复制一份当前激活预设，在副本上改。如果实验没跑通，从下拉里切回原版就回到了起点。
- 把调好的编排和角色卡一起交付 —— 在角色卡作用域上把预设迭代到位，保持
使用角色卡覆写开启，然后导出角色卡。拿到卡的人不需要任何额外配置就能得到你调好的整套编排形态。