Back to Aionui

ACP 单聊 - AI 配置 (F-CONFIG)

docs/prds/conversations/acp/config.md

1.9.259.9 KB
Original Source

ACP 单聊 - AI 配置 (F-CONFIG)

本文档由 PM 从 prd-acp-scenarios.md 抽取,保持与源同步。 覆盖技术场景:S-CFG-01 ~ S-CFG-11


(F-CONFIG-01) 切换 AI 模型 [已实现]

用户故事:作为用户,我希望在对话中随时切换 AI 模型,以便根据任务复杂度选用最合适的模型。

前置条件:已打开一个 AI 会话

正常流程(用户视角):

  1. 用户点击会话界面中的模型选择控件 -> 看到当前可用模型列表
  2. 用户选择目标模型 -> 系统提示模型切换中
  3. 切换成功后,模型选择控件更新为新模型名称
  4. 用户继续发送消息 -> 系统使用新选择的模型进行回复
  5. 关闭并重新打开该会话 -> 模型仍然是用户之前选择的模型(自动记忆)

异常情况

  • 选择的模型不可用(已下线或无渠道):用户看到错误提示,系统自动回退到默认模型
  • AI 会话尚未完成初始化(如首次打开时切换过快):系统自动等待初始化完成后再执行切换
  • 切换失败:模型选择控件保持原模型不变,用户看到失败提示

不同 AI 后端的差异

  • Claude 后端:切换模型后,下一条消息中 AI 会收到一条系统提醒通知其模型已变更,确保后续对话使用新选择的模型
  • 其他后端:切换立即生效,无额外提醒

验收标准

  • 用户可以在模型列表中看到当前后端所有可用模型
  • 切换模型后,后续对话确实使用新模型
  • 模型选择在会话关闭重开后仍然保持
  • 当所选模型不可用时,用户收到明确的错误提示并自动回退

(F-CONFIG-02) 切换会话模式 [已实现]

用户故事:作为用户,我希望在对话中切换工作模式(如"规划模式"或"免确认模式"),以便让 AI 按不同策略工作。

前置条件:已打开一个 AI 会话

正常流程(用户视角):

  1. 用户点击会话中的模式切换控件 -> 看到可用模式列表(如:默认模式、规划模式、免确认模式等)
  2. 用户选择目标模式 -> 系统提示模式切换中
  3. 切换成功后,模式控件更新为新模式
  4. 关闭并重新打开该会话 -> 模式仍然是用户之前选择的模式(自动记忆)

异常情况

  • AI 会话尚未初始化:系统自动等待初始化完成后再执行切换
  • 切换失败:用户看到失败提示,模式保持不变

不同 AI 后端的差异

  • Codex 后端:模式切换在本地完成,同时影响其沙盒安全级别
  • 其他后端:模式切换直接发送给 AI 后端

验收标准

  • 用户可以在模式列表中看到当前后端支持的所有模式
  • 切换模式后,AI 的行为符合所选模式的预期(如规划模式下 AI 先制定计划再执行)
  • 模式选择在会话关闭重开后仍然保持
  • 从免确认模式切回普通模式后,AI 操作需要重新逐一确认

(F-CONFIG-03) 调整 AI 参数选项 [已实现]

用户故事:作为用户,我希望调整 AI 的参数选项(如推理深度等),以便微调 AI 的行为表现。

前置条件:已打开一个 AI 会话,且 AI 后端支持参数配置

正常流程(用户视角):

  1. 用户打开参数设置面板 -> 看到当前后端提供的可调参数列表(不包含模型和模式,它们有专门的控件)
  2. 用户修改某个参数的值 -> 系统立即应用
  3. 关闭并重新打开该会话 -> 参数设置仍然是用户之前调整的值(自动记忆)

异常情况

  • AI 会话尚未初始化:系统自动等待初始化完成后再执行设置
  • 后端不支持任何参数配置:参数面板显示为空或不可用

验收标准

  • 用户看到的参数列表不包含"模型"和"模式"(这两项有专门的交互控件)
  • 参数修改后立即生效
  • 参数设置在会话关闭重开后仍然保持

(F-CONFIG-04) 查看模型信息 [已实现]

用户故事:作为用户,我希望查看当前会话使用的模型信息(名称、可用模型列表、是否支持切换),以便了解 AI 能力。

前置条件:已打开一个 AI 会话

正常流程(用户视角):

  1. 用户查看会话顶部或侧边栏 -> 看到当前模型名称
  2. 若 AI 后端支持切换模型 -> 用户可以点击展开模型列表
  3. 若 AI 后端不支持切换模型 -> 模型名称仅为展示,不可交互

异常情况

  • AI 会话尚未初始化但之前使用过某模型:显示上次使用的模型名称(只读)
  • AI 会话尚未初始化且从未使用过:不显示模型信息

不同 AI 后端的差异

  • Claude:模型信息优先从其专用配置通道读取
  • 其他后端:模型信息由后端在会话创建时返回

验收标准

  • 用户始终能看到当前使用的模型名称(AI 初始化后)
  • 不支持模型切换时,用户无法触发切换操作
  • 模型列表仅展示实际可用的模型

(F-CONFIG-05) 查看当前模式 [已实现]

用户故事:作为用户,我希望查看当前会话的工作模式,以便确认 AI 正在按预期方式工作。

前置条件:已打开一个 AI 会话

正常流程(用户视角):

  1. 用户查看会话中的模式指示器 -> 看到当前模式名称(如"默认"、"规划"、"免确认"等)
  2. 若 AI 尚未初始化 -> 显示"默认"模式

验收标准

  • 用户始终能看到当前模式名称
  • 模式指示器准确反映实际运行模式

(F-CONFIG-06) AI 响应超时设置 [已实现]

用户故事:作为用户,我希望配置 AI 单次回复的最大等待时间,以便避免长时间无响应时一直等待。

前置条件:在应用设置中进行配置

正常流程(用户视角):

  1. 用户进入设置 -> 找到"AI 响应超时"���项
  2. 用户可以为特定后端单独设置超时,也可以设置全局默认值
  3. 设置生效后,每次 AI 回复若超过设定时间,系统自动取消请求并提示超时

异常情况

  • 超时时间设置过小(低于 30 秒):系统自动调整为最小值 30 秒

验收标准

  • 用户可以设置全局默认超时时间
  • 用户可以为特定后端设置独立的超时时间(优先级高于全局)
  • 超时发生时,用户看到明确的超时提示

(F-CONFIG-07) 免确认模式的自动迁移 [已实现]

用户故事:作为用户,我之前在旧版设置中开启过"免确认模式",升级新版后希望该设置自动保留,无需重新配置。

正常流程(用户视角):

  1. 用户升级到新版本后打开已有会话 -> 之前的免确认设置自动生效,行为与升级前一致
  2. 若用户在新版引导页中显式选择了某个模式 -> 以用户的新选择为准,旧设置不再生效

验收标准

  • 旧版免确认设置自动迁移到新的模式系统中
  • 用户显式选择新模式后,旧的免确认设置被自动清理
  • 迁移过程对用户透明,无需手动操作

(F-CONFIG-08) Codex 后端沙盒安全级别联动 [已实现]

用户故事:作为 Codex 后端用户,我希望切换模式时沙盒安全级别自动调整,以便安全策略与工作模式保持一致。

前置条件:当前使用的 AI 后端为 Codex

正常流程(用户视角):

  1. 用户首次创建 Codex 会话 -> 系统根据默认模式自动设置对应的沙盒安全级别
  2. 用户切换模式 -> 沙盒安全级别随之自动调整

验收标准

  • Codex 会话的沙盒安全级别始终与当前模式匹配
  • 非 Codex 后端不受此逻辑影响

(F-CONFIG-09) 配置自动保存与恢复 [已实现]

用户故事:作为用户,我希望所有 AI 配置(模型、模式、参数选项)在每次修改后自动保存,重新打开会话或会话恢复(如应用重启、断连重连)时自动重新应用。

正常流程(用户视角):

  1. 用户修改任何配置(模型/模式/参数)-> 系统自动保存,无需手动确认
  2. 用户关闭会话后重新打开 -> 所有配置恢复到最后一次修改的状态
  3. 应用重启或连接恢复后,用户重新打开会话 -> AI 自动使用之前选择的模型和模式
  4. 用户在多个会话中分别设置不同的模型/模式 -> 每个会话独立保存,互不影响

异常情况

  • 保存失败(如磁盘空间不足):不影响当前使用,仅在下次打开时可能丢失未保存的设置
  • 之前选择的模型已下线或无可用渠道:用户看到错误提示(如"您选择的模型暂时不可用,请配置对应渠道或选择其他模型"),系统自动回退到默认模型
  • 之前选择的模型不在当前可用列表中:系统自动忽略,使用默认模型
  • 模式恢复失败:系统静默回退到默认模式,不中断启动

验收标准

  • 模型、模式、参数选项修改后自动保存
  • 每个会话的配置独立保存、独立恢复
  • 会话恢复后(重启、重连),模型和模式自动重新应用
  • 模型不可用时,用户收到明确提示并自动回退
  • 模式恢复失败不阻塞会话启动
  • 保存失败不阻塞当前操作

(F-CONFIG-10) 后端能力信息缓存 [已实现]

用户故事:作为用户,我希望在 AI 连接建立前就能看到上次缓存的后端能力信息(可用模型列表、参数选项等),减少等待时间。

正常流程(用户视角):

  1. 用户打开一个之前用过的会话 -> 立即看到上次缓存的模型列表和参数选项(无需等待连接完成)
  2. AI 连接建立后 -> 列表自动更新为最新数据

验收标准

  • 首次连接后,后端能力信息被缓存
  • 后续打开会话时,缓存数据立即可用
  • 连接建立后,缓存自动更新为最新数据