lareina0011 APP 发版上架测试报告
按用户意图选择模式后生成大纲。两种模式输出结构不同，勿混用。
最终交付格式：一律为 .docx（Word）。不要用 Markdown / txt 作为最终交付物。
（工作说明、中间草稿可用 Markdown；交给用户审阅与落盘文件必须是 .docx。）
正式报告统一落盘路径（模式 A/B 皆适用）：D:\work\APP发版上架测试报告\正式测试报告\
生成前若目录不存在则创建；文件名如 {版本}APP测试报告.docx。仅当用户明确指定其他路径时才改存别处。
模式判断
| 用户情况 | 模式 | 参考样例 |
|---|---|---|
| 新品上线，并提供/引用 APP 规格书 | 模式 A：新品全量测试 | V2.0.34APP测试报告.docx |
| 已知问题优化、修复、文案/SDK 调整等小版本上架 | 模式 B：优化回归模版 | V2.0.23（壳+老品优化收尾）；短文备选 1.7.73/1.7.75 |
| 未说清 | 先问一句：新品规格全量，还是优化点回归？ | — |
详细说明与空白 Word 模版：
- new-product-template.md → 空白稿 new-product-blank-template.docx
- optimization-template.md → 空白稿 optimization-blank-template.docx
生成 Word 时优先用 python-docx（见 scripts/generate_templates.py 的字体写法）。需要时复制空白模版再填内容，或按同等样式新建 .docx。
模式 A：新品全量测试（规格书 → 用例）
输入
用户提供：产品 APP 规格书（docx/pdf/md/截图文字均可）、产品型号、APP 版本号（可选）、涉及老品回归范围（可选）。
若规格书未给全，缺什么问什么：产品名称/型号、APP 版本、测试环境、双端范围、是否含老品回归。
工作流
- 读规格书，拆出功能模块（配网、主页状态、工作模式、智慧场景、设置、记录、故障、引导等）。
- 对齐报告结构（见下方「文档骨架」与 new-product-template.md）。
- 按模块写用例：从规格书提取参数范围、默认值、互斥、联动、记忆逻辑，写入「测试内容 / 预期结果」。
- 补通用项：异常与边界、双端（iOS/Android）、与机器联调相关项；若有老品，加回归清单。
- 优先级：核心控制/参数/互斥/联调 → 高；展示/引导/次要 UI → 低（与 V2.0.34 风格一致，可用 高/低）。
- 输出
.docx：写入D:\work\APP发版上架测试报告\正式测试报告\，文件名如{版本}APP测试报告.docx或用户指定名。可先基于new-product-blank-template.docx扩展。 - **「是否通过 / 备注」**列留空，供实测填写（不要默认填
y）。
文档骨架（对标 V2.0.34）
Word 内结构：
- 标题：
APP测试报告 - 项目名称 / 测试环境 / 测试时间
- 表格：测试基本信息（测试产品、APP版本号、测试类型、测试系统、测试设备、测试人员）
- 分章：
一、{产品A}→1. {模块}测试→ 用例表列：序号 | 测试项 | 测试内容 | 预期结果 | 优先级 | 是否通过 | 备注 - 多产品分章；含异常边界、老品回归（如有）
用例写作规则
- 一条用例一事：测试项短名；测试内容写操作步骤；预期结果写可判定现象（含数值范围、默认值、禁用态、弹窗文案要点）。
- 规格数值原样写入：时长档位、温度、水量步进、字数限制等必须来自规格书，禁止臆造。
- 互斥/联动单独成条。
- 多产品：每产品独立章节，模块编号按章内连续。
- 覆盖检查：规格书每个可交互能力至少 1 条正向；关键参数加边界；关键状态加展示与操作限制。
文档规范（.docx）
来自《测试报告文档规范》：
- 标题：黑体小二；正文/表格：宋体小四；行距按规范统一。
- 英文字母/数字：Times New Roman。
- 内容须含：测试范围、测试内容、预期结果、优先级；每次测新品须覆盖相关老品回归（涉及 APP 与小程序上架）。
模式 B：已知问题优化（回归模版）
输入
用户给出优化点/修复点，或只要空白模版后续自填。可附 APP 版本号、涉及机型。
工作流
- 判定为优化/修复上架 → 用 V2.0.23 报告壳，不要生成新品那种整机全量模块用例。
- 正文只写优化点：每个优化/修复点 → 测试范围一行 + 一章用例表（可对标 V2.0.23「13. 老品优化」写法）。
- 最后一章固定：
已上线产品回归测试（对标 V2.0.23 TC-108：相关型号连接、基础功能使用正常）。 - 若用户只要模版 → 交付 optimization-blank-template.docx（空白模版可仍放 skill 目录；正式填好的报告一律进下方统一路径）。
- 若用户列出优化点 → 生成填好的
.docx到统一路径。用户说「帮我填进去」→ 只改对应章节。 - 仅当用户明确要「上架内容三段短文」时，才退回 1.7.x 短文格式。
模版结构（对标 V2.0.23）
见 optimization-template.md 与 optimization-blank-template.docx。
APP测试报告 + 项目名称/环境/时间
1. 测试概述 + 测试基本信息
1.1 测试范围（M01…=优化点；Mn=已上线产品回归测试）
2. M01 {优化点1} 用例表
…
N. 已上线产品回归测试（连接、基础功能使用正常）
写作规则
- 用例重心在优化点，禁止顺便铺开配网/全模式/全场景全量表。
- 用例列对齐 V2.0.23：
用例编号 | 测试项 | 前置条件/操作步骤 | 预期结果 | 优先级 | 是否通过。 - 回归章保持冒烟粒度；波及机型写全；「是否通过」留空。
输出约定
- 最终文件格式：
.docx（也可用.doc，优先.docx）。 - 默认目录：
D:\work\APP发版上架测试报告\正式测试报告\（不存在则创建）；生成后告知完整路径。 - 标题统一「APP测试报告」（模式 A/B 皆可）；模式 B 短文例外时可不加长标题。
- 自检：模式正确、优化点有对应用例、末尾有已上线回归、通过列留空、扩展名是
.docx、文件已在统一目录。 - 若该目录已有同版本报告，表格列与章节命名与之对齐（或按用户要求覆盖/另存）。