补充策划Agent模型与推理档两步接入方案

在主方案中明确控件复用、配置生效和恢复边界
新增控件接入与回合模型生效两个里程碑
限定GameAgent兼容性验证范围,不扩展已有组件改造
This commit is contained in:
2026-09-20 20:34:03 +08:00
parent a2acfa9a6f
commit bdecb0c324
3 changed files with 152 additions and 1 deletions
@@ -0,0 +1,48 @@
# 策划 Agent 回合模型选择生效
| 字段 | 值 |
| --- | --- |
| Version | 1.0 |
| Status | proposed |
| Date | 2026-09-20 |
| Parent Spec | [策划 Agent 生产迁移与工作区浏览方案 §4.1](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#41-策划对话模型与推理档选择提案2026-09-20) |
## 目标
策划已有会话在后续执行时真正采用控件保存的模型和推理档,执行途中保持选择稳定,恢复不破坏既有工具副作用边界。
## 范围
- 新会话、旧会话后续消息、回答澄清、阶段审批继续和用户主动重试的选择生效。
- 同一次执行中的工具循环、自动重试固定使用开始时的选择。
- 活动回合自动恢复所需的最小模型、推理档快照及旧会话缺字段读取。
- 模型切换保留策划上下文、阶段、审批和产物。
## 不在范围内
- 不改变 GameAgent Runtime 或既有配置控件算法。
- 不调整模型目录、默认档位、供应商协议、提示词和阶段规则。
- 不建立 Agent 专属设置、通用快照框架、历史转换器或平行账本。
## 依赖与前置条件
- [控件接入里程碑](./【里程碑】策划Agent模型与推理档控件接入-2026-09-20.md) 已验收。
- 主规范和本里程碑已评审,实施前编写仅覆盖本步的实现计划。
- 生效时机、主动重试与自动恢复的区分遵循主规范,不通过重建会话实现切换。
## 验收标准
- [ ] 新策划会话和旧策划会话下一次执行都使用当前已保存选择;旧模型不再永久覆盖新选择。
- [ ] 发送、澄清、审批继续与主动重试的实际 Provider 请求使用新选择。
- [ ] 执行中改配置不影响本次后续工具请求或瞬态自动重试,下一次用户执行才生效。
- [ ] 自动恢复优先使用已有活动回合快照;旧记录缺推理档时按主规范补齐,不重复已执行工具副作用。
- [ ] 切换后上下文、阶段、产物和审批身份保留,纯读取不改历史模型信息。
- [ ] 配置/Provider 失败沿用可见错误,不静默降级、换模型或清空历史。
- [ ] GameAgent 既有选择和运行行为通过兼容回归,没有借机修正其本征不足。
## 证据要求
- 自动化:本地 Provider fixture 捕获请求模型和推理档;覆盖跨工具调用、自动重试、用户重试、审批/澄清继续及旧会话恢复;运行相关 Rust 定向测试、必要类型检查、编码和文档索引检查。
- 运行时:在现有策划项目选择另一模型及推理档,触发下一次执行核对实际请求;真实供应商是否接受跨模型历史需按环境记录实测或未验证。
- 边界:验证恢复幂等和凭据不进入新增快照;无需新增通用权限或供应商测试体系。
- 全部验收后将主规范提案改为当前行为,更新稳定项目记忆并删除本次已完成临时计划。
@@ -0,0 +1,47 @@
# 策划 Agent 模型与推理档控件接入
| 字段 | 值 |
| --- | --- |
| Version | 1.0 |
| Status | proposed |
| Date | 2026-09-20 |
| Parent Spec | [策划 Agent 生产迁移与工作区浏览方案 §4.1](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#41-策划对话模型与推理档选择提案2026-09-20) |
## 目标
策划对话复用已有模型和推理档控件,能够读取和保存全局选择,保持 GameAgent 兼容性。
## 范围
- 输入区域中控件的显隐、位置、策划面板布局与必要的宿主接线。
- 复用原有目录、默认模型、保存和错误提示,不复制逻辑。
- 策划发送、澄清、审批继续和主动重试中会调用 Provider 的入口,接入已有模型可用性检查;不改变原有审批和忙态含义。
- 重新进入策划时显示保存值;执行中可以调整后续选择,但原输入与提交忙态维持不变。
## 不在范围内
- 不修改策划 Provider 的模型选择和推理档采样逻辑,不声称旧会话已能切模型。
- 不检查、修复或重构 GameAgent 组件本征不足,不引入通用缓存、同步、保存、下拉或配置框架改造。
- 不为策划引入队列、语音或素材引用,不更改默认推理档。
## 依赖与前置条件
- 主规范本节与本里程碑完成评审。
- 实施前仅为本里程碑编写实现计划,确认现有 GameAgent 对应回归用例与策划宿主入口。
- 本步作为内部接入结果;第二步完成前不单独发布为完整可切模型功能。
## 验收标准
- [ ] 策划入口显示原模型及推理档控件,没有重复实现或第二份设置。
- [ ] 选择走原保存通道;重新进入显示已保存值;保存失败显示原有错误反馈。
- [ ] 策划会调用 Provider 的用户入口执行已有模型可用性检查,失败时不提交。
- [ ] 策划忙态、待审批/澄清行为保持;新增布局在宽/窄面板可操作。
- [ ] GameAgent 原控件的显示、选择、发送校验、忙态和运行行为通过相关回归。
- [ ] 交付明确记录旧策划会话仍沿用旧模型,留待下一里程碑解决。
## 证据要求
- 自动化:现有界面测试中增加策划入口的集成场景,复用 GameAgent 回归;运行 AGC 类型检查、文档索引、编码和 diff 检查。
- 运行时:桌面与窄面板选择、保存、重新进入和一次策划发送 smoke;缺失环境如实标注。
- 边界:只验证接入所需的失败和忙态,不扩展为现有组件全量审计。
- 通过本步验收后,才准备并执行模型生效里程碑的实现计划。