设置·模块
RPG Roleplay 内部有多个 AI 子模块分别承担不同职责（主叙事、意图解析、向量嵌入、图像生成等）。这里可以给每个模块单独指定使用哪个模型，也可以直接设置主 GM 的个人默认模型。没有单独覆盖的模块会自动复用主 GM 的选择。
入口：顶栏「设置」→ 左侧导航「模块模型」。
关键概念
主 GM 默认模型
列表第一行是「主 GM 默认模型」，它写入个人偏好，影响新开局和所有未单独切换模型的存档。其他模块在没有覆盖设置时都跟随主 GM。
模块覆盖
每个模块行都有一个独立的模型选择器。选择「跟随主 GM」（留空）即清除该模块的覆盖，回到继承主 GM 的状态。只有向量嵌入和图像生成这两个模块要求必须单独选，不支持继承。
模型列表的来源
选择器只会列出你已在「API 密钥」中配置并成功同步过的供应商的模型。如果某个模型找不到，先去「API 密钥」页面确认对应供应商的 Key 已正确添加。
各模块说明
| 模块名 | 用途 | 建议档位 |
|---|---|---|
| 主 GM 默认模型 | 玩家对话的核心叙事模型 | 旗舰 |
| 上下文子代理 | 整理玩家意图、检索计划，把模糊输入变成结构化指令 | 中端 |
| 指令解析代理 | 解析 /set 命令的自然语言，转为结构化操作 | 中端或小型 |
| 控制台助手 | 侧栏管理员控制台专用模型 | 与主 GM 同级 |
| 叙事提取器 | GM 叙事二次解析，提取状态操作（两步式 GM 第二步） | 便宜小型 |
| 角色卡生成器 | 侧栏创意工具：生成或微调角色卡 | 中端旗舰 |
| AI 整理卡字段 | 导入酒馆卡时，用 AI 把自由文本整理成结构化字段；仅在导入时勾选「用 AI 整理字段」才调用 | 中端或小型 |
| 一致性评分 | 对角色卡生成结果打一致性评分（0–1，阈值 0.6） | 便宜小型 |
| 接受条件验证 | 校验 GM 输出是否满足 curator 设置的验收条件 | 便宜小型 |
| 阶段浓缩 (compact) | 把长局历史按阶段浓缩成摘要，供 GM 记忆远期剧情 | 中端或小型 |
| 黑天鹅事件代理 | 主动触发世界突发事件的子代理 | 中端 |
| 通用子代理兜底 | 其他未单独配置模型的子代理统一使用它 | 中端 |
| 向量嵌入 (RAG) | 向量嵌入模型，用于记忆召回和拆书后的语义检索 | 专用 embedding 模型 |
| 图像生成模型 | 聊天内 AI 生图、角色卡头像、剧本封面、人设图等全部走它 | 生图专用模型 |
常见任务
修改主 GM 的默认模型
- 进入「设置 → 模块模型」。
- 找到「主 GM 默认模型」行，点击右侧选择器，从列表中选择目标模型。
- 选择后即时保存，新开局和未单独切换模型的存档下次运行时生效。
给某个子模块单独指定模型
- 找到对应模块行，点击右侧选择器。
- 从已配置供应商的模型列表中选择，或直接手填模型 ID。
- 选择后即时保存，无需点击确认按钮。
取消某个子模块的覆盖，恢复跟随主 GM
- 找到该模块的选择器，选择「跟随主 GM」选项（通常是列表第一项或空值项）。
- 即时生效，之后主 GM 切换模型时该模块也会跟着切换。
配置向量嵌入模型
向量嵌入只能使用支持 embedding 接口的专用模型，不能填写普通的对话模型。
- 先在「API 密钥」中配置支持 embedding 的供应商（如 Vertex AI、OpenAI、Cohere）的 Key。
- 在「向量嵌入 (RAG)」行选择对应的 embedding 模型。
- 注意：切换 embedding 模型后，已处理过的剧本需要重新嵌入才会使用新模型，旧向量与新模型不互通。
普通用户若未配置 embedding Key，RAG 召回会降级。admin 和 VIP 用户有平台兜底（Gemini 免费额度），配置页会在该行下方显示当前兜底状态。
配置图像生成模型
- 先在「API 密钥」中配置支持生图的供应商 Key（如 Vertex AI、豆包、通义等）。
- 在「图像生成模型」行选择目标模型。此处的选择与生图弹窗里的模型选择同步。
- 如果未配置对应 Key，生图时平台会提示去配置，不会静默失败。
常见问题
Q: 我在列表里找不到想用的模型怎么办？ A: 模型列表只显示已配置 Key 且成功同步过的供应商的模型。请先去「API 密钥」页面添加对应供应商的 Key，然后点击「拉取模型」同步一次。
Q: 叙事提取器是什么，需要开启吗？ A: 叙事提取器是「两步式 GM」的第二步：主 GM 先生成叙事文本，提取器再把文本二次解析成结构化的状态操作。开启后状态一致性更好，但每次对话的 API 费用会增加约 20%。新手用默认单步 GM 就够，等出现状态错乱问题再考虑开启。
Q: 改了模块模型，什么时候生效？ A: 改动即时保存，后端各模块在下次被调用时读取新配置。正在进行中的对话不会被打断，下一条消息开始生效。
Q: Anthropic 和 DeepSeek 可以用作向量嵌入吗？ A: 不可以，这两家均无 embedding 接口，不会出现在向量嵌入模型的选择列表中。
Q: 通用子代理兜底是什么意思？ A: 当某个子代理没有单独配置模型时，会先看主 GM 的设置；「通用子代理兜底」是一个额外的中间层，用于统一管理未单独配置的子代理。大多数情况下跟随主 GM 即可。