Skip to content

真实环境验收记录 ​

本目录保存真实 fnOS NAS、FPK 安装升级和发布环境的验收证据。它不是测试用例目录,也不能用本地构建结果替代目标环境结论。

记录模板 ​

复制以下字段创建 <功能 ID>-<环境>-YYYY-MM-DD.md:

yaml
---
feature: FNOS-001-10
acceptance: FNOS-001-10-AC-01
environment: fnOS NAS
fnosVersion: <版本>
appVersion: <FPK 版本>
pluginVersion: <插件版本>
verifiedAt: YYYY-MM-DD
status: passed|failed|blocked
---

正文至少记录:

  1. 设备架构、用户角色、安装/升级方式和前置配置;
  2. 操作步骤、预期结果和实际结果;
  3. 日志、截图、失败复现或外部链接;
  4. 遗留问题、回滚方式和下一步;
  5. 验收人和最终结论。

当前 FNOS-001 的真实 NAS 记录应按功能 ID 分开,完成后回写对应需求和计划状态。

Midscene 执行证据登记 ​

用 Midscene Bridge 执行的 UI 走查与 E2E 用例(测试用例文档规范)同样在本目录登记,格式与上表模板一致,另在正文记录:

  • Midscene CLI 版本与所选「提供方/模型」;
  • 生成的可视化报告与截图路径(报告在 midscene_run/ 下,属测试产物,按测试数据清理处理;需要长期留存的复制到本目录或附外部链接);
  • 自然语言指令与断言的原文——它们是该次验收的可复跑定义。

接入配置(.env)不入仓库,也不作为证据附件;本目录只登记结论与可追溯的产物位置。

证据只追加,不修改 ​

本目录下的验收记录是历史证据,写入后不再修改:它们记录的是「当时在哪个环境、按哪个版本验了什么」,事后改写会让结论失去依据。

  • 需要补充结论、复验或修正时,追加一份新的记录文件,并在正文中链接被取代的旧记录与差异。
  • 旧记录中过时的版本号、功能 ID 或结论保持在原位不动。
  • 状态徽章的回写发生在需求与计划文档中;对应需求已完成时,按 SDD 规格驱动维护规范 登记到当前开发中的需求,不回改已完成文档。

当前记录 ​

最后更新:

基于 VitePress 构建