Files
Agent-Workbench/docs/orven/QA.md
T

86 lines
9.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Orven 改版验收
## 范围
正式产品品牌、配套文案、标识资源、主工作台信息结构、侧栏导航、工具发现、按需成果区、模型中心、扩展能力主题与手机伴随端身份。保留原 React/TypeScript/Vite 技术栈和业务 API,不迁移用户数据。
## 实际验证
| 检查 | 结果与范围 |
| --- | --- |
| TypeScript / 前端 / mobile shell / server / desktop bundle | 构建通过 |
| 新版浏览器主路径 | 10 组通过:真实独立服务、3 次本机协议请求、真实文件读取和写入、差异、刷新保持、权限保存、外部冲突、工具入口及品牌资产 |
| 模型中心原验收 | 6 组通过:连接/模型池/导入、历史工件分页与巡检、390px |
| Skills 原验收 | 4 组通过:登记与启用、源变化后审核新修订、390px、实际本机 HTTP 任务绑定修订与指纹 |
| MCP 原验收 | 6 组通过:登记、实际 stdio schema、变化后停用、中断保留 unknown、Task 归属、390px |
| 实际 Electron | 应用名、网页及原生标题、工作台渲染、工具箱与桌面宿主状态通过;自有窗口显示后截图并关闭 |
| 相关单元 | 25 个不同测试通过;首轮 2 项因 Node26 被拒,换仓库指定 Node24.22.1 后补验通过,未改断言 |
| 代表视口 | 1440×960、1280×800、1024×800、768×800、390×844;文档无意外横向/纵向溢出,输入区留在视口 |
| 文字对比样本 | 主入口、导航说明与工具箱实测 5.25:1–12.30:1;不是全应用可访问性认证 |
| 浏览器错误 | 新版主路径 pageerror 0 |
核心脚本为 `scripts/verify-orven-ui.mjs`,运行 `npm run verify:orven`。实际桌面验证为 `scripts/verify-orven-desktop.mjs`。使用仓库 Node24;现有系统 Node26 不符合桌面宿主身份核验要求。最终文案调整后 TypeScript、Vite 与 mobile shell 重新构建通过,新版浏览器 10 组和实际 Electron 复验通过。
## 观测后修正
1. 旧主题深色侧栏上的文件名对比不足,且蓝色、绿色主题混用;改为浅灰连续导航、石墨正文和角色明确的鸢尾色。
2. 快捷提示继承旧 430px 限制导致宽屏拥挤;取消限制并随主工作区宽度切换行列。
3. 顶部扩展图标缺少文字;收拢到可搜索工具箱,并为当前不可用项说明原因。
4. 默认成果区在无内容时挤占对话;改为按需展开,文件和差异可并排审查,窄屏用抽屉。
5. 品牌页首次交互因原 CSP 禁止内联脚本失败;改为同源外部脚本,维持 CSP,再次验收通过。
6. 外部文件修改后提交编辑,实际保留外部字节和草稿,给出冲突提示;未用假成功掩盖失败。
7. 首次 Electron 隐藏窗口截图超时:Windows 中从未显示的窗口不产生合成帧。验证器改为临时 `showInactive()`,等待实际宿主状态后截图,最后关闭自有测试窗口;没有改变产品启动方式。
## 保存的结果
最终主路径结果见 [浏览器记录](evidence/browser-result.json) 与 [Electron 记录](evidence/desktop-result.json)。代表截图来自真实渲染:
- [桌面主界面](screenshots/desktop.png)
- [任务执行与文件差异](screenshots/task-results.png)
- [390px 会话](screenshots/mobile-conversation.png)
- [品牌展示页](screenshots/brand.png)
原始截图与本轮首次失败保留在本地 `output/playwright/orven/`;模型中心、Skills、MCP 的原验收结果分别位于 `.qa/model-center-ui-9e9b7eb9-20fa-4131-b480-686bbd4b75f8`、`.qa/skills-ui-d64f3b6c-e635-446f-8f2c-ad6af2f9c219`、`.qa/mcp-ui-4ea6051a-1754-41f4-a62c-084f6525867e`。部分历史驱动仅迁移可见工具入口,没有宣称其全部业务场景本轮均已执行。
## 深青绿配色调整
用户要求与已有产品区分,主色改为 #176B5B,配合松墨 #28382F、雾灰 #F3F6F4 与白色画布。主工作台、模型中心、工具箱、手机伴随端主题、品牌页、SVG/PNG/ICO 及网页主题色同步更新;原紫调背景、边框和文字一并替换。
本轮 Vite 与 mobile shell 构建通过,现有新版浏览器 10 组复验通过,仍为 3 次本机协议请求、0 真实模型调用和 0 pageerror,见 [本轮浏览器记录](evidence/palette-browser-result.json)。实际查看桌面、模型中心、品牌页和 390px 会话;主色、正文、路径、导航及反白品牌说明等 9 个 DOM 样本的文字对比为 5.11:1–12.38:1,见 [配色与对比记录](evidence/palette-result.json)。这次配色调整没有重跑桌面宿主生命周期或正式安装。
上方代表截图已更新为深青绿版本,初版截图仍可从先前本地提交 b4b139a1 查看。
## 深青绿 / 雾蓝外观选择
按用户提供的数字教材工作台截图,取 #4F6EF7 强调、#F6F8FC 画布、#EDF1FF 选中与 #24334B 正文,新增「雾蓝」,保留默认「深青绿」。白字按钮采用 #4563E6,小字强调 #3D58CD。公共角色变量覆盖主界面、模型中心、文件/差异、工具面板和手机主题,成功、错误、确认和差异状态保持原语义。
本轮 TypeScript、Vite 与 mobile shell 构建通过;两套配色各完成现有主路径 10 组,共 20 组,各自使用 3 次本机协议请求、0 真实模型调用。选择面板另有 5 组通过:工具箱与直接入口、即时切换且保留草稿、刷新后恢复、原生单选键盘与焦点返回、多标签页同步、一次性预览链接、无效选择回退、390px/实际手机伴随端页面、保存不可用的明确提示。外观验证对后端写请求为 0。实际查看了桌面、差异、外观面板和伴随端截图。
- [深青绿 10 组结果](evidence/themes-green-result.json)
- [雾蓝 10 组结果](evidence/themes-blue-result.json)
- [外观 5 组及文字对比](evidence/appearance-result.json):7 个 DOM 文字样本为 4.94:1–5.79:1;其中白字按钮 5.02:1。不是全应用可访问性认证。
- [雾蓝主界面](screenshots/blue-desktop.png)、[任务与差异](screenshots/blue-task-results.png)、[选择面板](screenshots/appearance.png)、[390px 会话](screenshots/blue-mobile.png)。
首轮将原生 radio 裁成 1px 后,自动点击被标签拦截;改为透明 radio 覆盖整张选择卡,保持原生键盘语义并扩大点击范围。随后存储异常验证误等待窄屏中隐藏的连接状态为可见,修正为核对已连接 DOM 状态,产品连接未改。原本机失败输出保留在 `output/playwright/orven-appearance/`,后续 5 组通过。
复验命令为 `npm run verify:appearance`。现有主路径默认深青绿,设置 `ORVEN_QA_PALETTE=blue` 则验雾蓝。偏好按浏览器来源保存,同源多页同步,实际手机各自保存;未声称跨设备同步或实际 iPhone 配对。品牌展示页与安装图标沿用深青绿,本轮不涉及桌面宿主生命周期和正式安装。
## 三套配色与重新打开记忆
恢复初版「鸢尾紫」为第三套选择:#6253B5 操作、#F5F5F8 导航、纯白工作区、#37333F 正文。三套均使用同一偏好保存机制,首次打开为深青绿,之后恢复最后选择;面板明确显示「已设为默认配色,下次打开会继续使用」。桌面三列,600px 及以下纵排。
本轮 Node24 下 TypeScript、Vite 与 mobile shell 构建通过。紫色现有主路径 10 组通过,3 次本机协议夹具请求、0 真实模型、0 pageerror;外观 7 组通过,0 后端写请求。使用自有临时磁盘 profile,实际选择雾蓝、关闭浏览器并重启核对恢复,再对深青绿和鸢尾紫分别重复;未注入 storageState 或使用用户浏览器配置。另验证刷新/同源多页、原生键盘和焦点返回、紫色一次性链接、无效值回退、存储不可用提示,以及 600/390/320px 面板和实际伴随端 shell。
- [紫色 10 组主路径](evidence/themes-purple-result.json)
- [三套外观 7 组及文字对比](evidence/appearance-three-palettes-result.json):13 个 DOM 样本,其中紫色 6 个样本为 4.96:1–7.64:1,白字按钮 6.13:1。
- [紫色工作台](screenshots/purple-desktop.png)、[任务与差异](screenshots/purple-task-results.png)、[390px 会话](screenshots/purple-mobile.png)。
- [三套配色面板](screenshots/appearance-three-palettes.png)、[390px 选择面板](screenshots/appearance-three-palettes-mobile.png)。
实际查看上述桌面/差异、320/390px 和伴随端截图,三套选项及保存提示均完整可见。复验命令为 `npm run verify:appearance`;`ORVEN_QA_PALETTE=purple` 配合 `npm run verify:orven` 验紫色主路径。原两套测试记录保持,未重跑桌面宿主生命周期或正式安装。
## 边界
全部模型执行来自明确的本机测试接口;未用真实供应商验证新的模型能力。手机伴随端完成品牌和主题,主工作台窄屏已经实际验收;本轮未进行真实 iPhone 配对。安装器显示名更新仅在源码,未重制安装包或更改正式安装。名称的商标、域名和商店可用性尚未核验。
历史研究证据和其他对话正在进行的 AF/AG 工作不属于本次提交。4318 正式服务和真实凭据保持原状。独立设计预览在 4327,使用 `.qa/orven-design/data`。