# 用户故事与验收

以下均为待执行验收，当前状态见[进度](./progress.md)。需求编号对应[产品需求](./prd.md)。

| 编号 | 场景与前提 | 操作 | 预期结果 | 需求 |
| --- | --- | --- | --- | --- |
| US-01 | 新安装用户已选择可用 Runtime | 创建项目并发送问题，然后要求在测试目录写文件 | 两次请求均无需选择模式；问题正常回答，受支持的工具任务实际完成 | FR-1、FR-2 |
| US-02 | 旧项目和会话分别保存 Ask、Execute、Plan 或缺省值 | 升级、打开、继续、分支并重启 | 不出现旧模式；操作行为不随历史值变化；消息和分支关系保留 | FR-4、FR-9 |
| US-03 | 用户启用并分配一个有写工具的 MCP 服务 | 调用其读写工具，再关闭或取消分配并发起新请求 | 启用时两类工具可用；关闭后目录不暴露，伪造调用也不能绕过设置 | FR-2、FR-3 |
| US-04 | 用户使用 Model 或本地 Agent Runtime | 检索、读文件、修改测试文件、运行有界命令并取消长任务 | 无模式拒绝；执行路径、输出、取消和清理符合对应 Runtime 能力 | FR-2、FR-7 |
| US-05 | 已有原生客户端历史和配置 | 从产品入口启动 OpenCode、Continue 或 DS Web，执行一次工具任务，再关闭重开 | 无旧模式插件或只读名单拦截；用户原生历史保留；能力设置变更不会复用过期配置 | FR-6、FR-9 |
| US-06 | 本地队列含旧格式待执行消息，日程包含旧模式 | 升级后恢复队列、运行一次定时任务和“立即运行” | 顺序、提示词、附件和任务身份不变；每个计划实例只执行一次 | FR-4、FR-5、FR-9 |
| US-07 | 通道项目已绑定账户且发送者符合原有规则 | 发送普通任务和带 `/ask`、`/execute`、中文旧前缀的消息 | 遵循执行规则中的前缀退役方案；不切换权限；正文完整进入正常处理 | FR-5、FR-8 |
| US-08 | 图片模型允许会话调用 | 生成、编辑、重新生成并保存到本地或远程测试目录 | 不要求 Execute；目标位置、图片引用、覆盖选项和失败信息仍正确 | FR-2、FR-7 |
| US-09 | 启用智能路由或手动选择专家 | 请求适合委派的任务并观察子代理 | 路由由已有设置和任务条件决定；子代理不继承模式，已关闭能力不因委派重新启用 | FR-5、FR-7 |
| US-10 | 魔法笔记分析、监督者评审、摘要调用已配置 | 输入会诱导工具调用的测试文本 | 这些内部调用仍不获得工具；正常输出与取消流程可用 | FR-7 |
| US-11 | Desktop 与 Agent 均为兼容版本 | 在真实 Linux Host 运行工具任务，并经历断开、恢复和 Agent 重启场景 | 无模式参数；已接受请求不会被静默重发；身份、结果和恢复顺序正确 | FR-6、FR-9 |
| US-12 | Desktop 对接旧 Agent 或旧外部委派服务 | 发起新请求或读取待恢复任务 | 兼容性处理符合技术设计；不因缺失模式丢任务，也不偷偷补 `execute` 重试 | FR-5、FR-6 |
| US-13 | 旧库包含消息、子代理差量事件和远程事件重复投递 | 在副本执行迁移、模拟失败、再次启动及重复重放 | 仅指定元数据改变；去重比较一致，无冲突误报、重复任务或丢失结果 | FR-4、FR-9 |
| US-14 | 中英文、浅深主题及窄窗口 | 使用输入区、项目表单、通道设置、任务详情及原生工具清单 | 无残留选择器、模式文案、空白占位或失效焦点；键盘菜单正常 | FR-1、FR-10 |
| US-15 | 所选模型不支持工具，或远程路径没有某项能力 | 发送普通文本请求并检查能力反馈 | 普通文本仍可用；真实能力缺失明确呈现，不退回一个隐藏 Ask 模式 | FR-2、FR-7 |
| US-16 | 历史正文、工具 JSON 含业务字段 `mode/workMode` 或单词 Ask/Execute | 升级并导出对比 | 用户内容逐项保留；只删除已确认由产品写入的模式元数据 | FR-4、FR-9 |
| US-17 | 旧配置含任意 `toolApproval` 值，且存在交互、通道、调度和外部委派入口 | 升级后执行启用工具，查看通用设置并取消一次数据清除 | 旧策略字段移除且不再拒绝工具；无一般工具审批等待；“安全”分类消失，数据清除及其确认保留；任务取消和超时正常 | FR-2、FR-4、FR-7 |

## 验收执行要求

工具调用至少覆盖生产入口到结果保存的链路。原生客户端必须检查实际生成文件与启动行为；远程场景须使用开发中的源码或包，不以已发布 Agent 的成功替代当前实现验证。

数据库验收使用一致性备份后的副本，并对原始内容、稳定 ID、顺序、时间及远程来源字段做比较。真实图片生成另行记录提供商调用次数；配置检查不能替代生成验收。

设置变更的生效时点沿用各能力已有生命周期，至少验证下一轮请求和重新启动客户端。当前已接受的任务不得因本次改造被重复提交。