goodbuddy/docs/features/unified-execution/user-stories.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、顺序、时间及远程来源字段做比较。真实图片生成另行记录提供商调用次数；配置检查不能替代生成验收。

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