Skip to content

角色卡绑定预设与人设

角色卡绑定功能允许角色卡作者为角色指定推荐的 Chat Completion 预设和默认人设(Persona),确保角色在最佳条件下运行。该功能依赖预设解耦来保证加载预设时不会破坏用户的 API 连接配置。

角色卡携带推荐预设

角色卡可以嵌入一份完整的 Chat Completion 预设。当用户打开该角色卡时,Luker 会:

  1. 从角色卡数据中提取预设内容
  2. 自动剥离连接字段 — 自动过滤掉所有连接相关的字段(如 API 地址、密钥、模型名称等),确保用户的连接配置不受影响
  3. 在预设选择器中注入一个标记为「角色卡绑定预设」的运行时选项
  4. 自动切换到该预设

Luker 会记录切换前的预设名称,以便在离开角色时自动恢复。

连接字段安全

角色卡绑定预设的加载始终跳过连接字段。即使角色卡作者在预设中包含了 API Key 或自定义端点,这些信息也不会被应用到用户的配置中。这是预设解耦机制的直接保障。

角色卡携带默认人设

角色卡可以指定一个或多个推荐人设(Persona)。这是一个全局级别的绑定——人设直接关联到角色卡本身,而不仅仅是某个聊天会话。当用户打开该角色卡时:

  • 如果用户当前没有选择人设,Luker 会自动切换到角色卡推荐的人设
  • 如果用户已有人设,Luker 会发出提醒,告知当前人设与角色卡推荐的不一致

绑定的人设会随角色卡一起导出。当其他用户导入该角色卡时,推荐人设信息也会一并导入,确保角色卡作者的推荐配置能够完整传递。

加载与离开时的自动切换

打开角色卡时

  1. 检测角色卡是否携带绑定预设
  2. 如果有,记录当前预设名称
  3. 在预设选择器中注入角色卡绑定预设选项
  4. 自动切换到绑定预设(仅应用生成参数,不影响连接配置)

离开角色卡时

  1. 检测是否有激活的角色卡绑定预设
  2. 自动恢复之前使用的预设
  3. 从预设选择器中移除角色卡绑定选项
  4. 重置绑定状态

对于群组聊天,离开时同样会触发恢复逻辑。

预设选择器中的特殊标识

当角色卡绑定预设处于激活状态时,预设选择器中会显示一个特殊的徽章(badge),让用户清楚地知道当前使用的是角色卡推荐的预设而非自己选择的预设。

Chat Persona 追踪

Luker 在聊天元数据中追踪当前使用的人设。每次人设变更时,会将当前人设信息写入聊天元数据并保存。

当重新打开一个聊天时,如果检测到当前人设与聊天记录中的人设不一致,会通过提示通知用户,避免在错误的人设下继续对话。

随角色卡导入导出

绑定预设和推荐人设作为角色卡数据的一部分,会随角色卡的导入导出自动携带。预设变更时会自动同步更新角色卡数据,处理过程在后台异步执行以避免阻塞界面。

依赖关系

角色卡绑定预设功能依赖预设解耦。没有预设解耦的字段分类机制,加载角色卡预设时就无法安全地跳过连接字段,整个功能将无法实现。

相关页面

Built upon SillyTavern