# MVP §7 测试与验收清单

对应 [mvp.md](./mvp.md) §7。自动化部分由 `pnpm run test:mvp` 执行；**UI 与安装包体验**须按下表人工勾选。

---

## 0. 运行自动化（推荐先做）

```bash
# 完整：build + 静态检查 + Electron 原生冒烟
pnpm run test:mvp

# 仅静态（无 Electron）
pnpm run test:mvp -- --static-only
```

报告输出：

- `test-results/mvp-acceptance-report.md`
- `test-results/mvp-acceptance-report.json`

### 可选环境变量

| 变量 | 用途 |
|------|------|
| `CHM_ASSISTANT_GBK_SAMPLE` | GBK 编码样例 `.chm` 路径（7.1） |
| `CHM_ASSISTANT_GBK_SEARCH_QUERY` | 全文搜索关键字，默认 `的` |
| `CHM_ASSISTANT_GBK_PAGE_QUERY` | 页内中文检索关键字（RD-08b 粗测） |
| `CHM_ASSISTANT_CORRUPT_SAMPLE` | 损坏样例；默认 `test/fixtures/corrupt/invalid.chm` |
| `CHM_ASSISTANT_LARGE_SAMPLE` | 超大 CHM（7.4） |

样例文件说明见 [test/fixtures/README.md](../test/fixtures/README.md)。

---

## 7.1 中文 GBK 样例 CHM（M1 / RD-08b）

**自动化**：设置 `CHM_ASSISTANT_GBK_SAMPLE` 后 `test:mvp` 覆盖打开、目录、正文中文、全文搜索。

| # | 步骤 | 预期 | 自动 | 人工 ✓ |
|---|------|------|------|--------|
| 7.1.1 | 打开 GBK 样例 CHM | 成功，无崩溃 | ✓ | ☐ |
| 7.1.2 | 侧栏目录 | 中文标题正常，点击可跳转 | 部分 | ☐ |
| 7.1.3 | 正文 | 无乱码（「自动」或 GBK 设置） | ✓ | ☐ |
| 7.1.4 | 全文搜索 | 中文关键词有结果 | ✓ | ☐ |
| 7.1.5 | Ctrl/Cmd+F 页内查找 | GBK 页内中文可命中（RD-08b） | — | ☐ |
| 7.1.6 | 工具栏「复制」 | 选区或整页纯文本含正确中文 | — | ☐ |

**记录**：样例路径 `____________` · 测试人 `____________` · 日期 `____________`

---

## 7.2 UTF-8 无 BOM 创作链（M3 / CR-06）

**自动化**：在已安装 `chmcmd` / `hhc` 时编译临时项目并验证产物中文。

| # | 步骤 | 预期 | 自动 | 人工 ✓ |
|---|------|------|------|--------|
| 7.2.1 | 新建项目 | `index.md` / `.chmproj` 无 BOM | ✓ | ☐ |
| 7.2.2 | 编写含中文 Markdown | 保存成功 | — | ☐ |
| 7.2.3 | 编译 CHM | 成功或可读错误日志 | ✓ | ☐ |
| 7.2.4 | 内置阅读器打开 | 中文无乱码 | ✓ | ☐ |
| 7.2.5 | 编译日志点击跳转 | 可定位到源 `.md` 行 | — | ☐ |

---

## 7.3 简 / 繁 / 英界面冒烟（IF-07）

**自动化**：核心 i18n key 三语包一致性。

| # | 步骤 | 预期 | 自动 | 人工 ✓ |
|---|------|------|------|--------|
| 7.3.1 | 设置 → 简体中文 | 首页、阅读器、创作器、设置、关于文案正确 | 部分 | ☐ |
| 7.3.2 | 设置 → 繁體中文 | 同上 | 部分 | ☐ |
| 7.3.3 | 设置 → English | 同上 | 部分 | ☐ |
| 7.3.4 | 跟随系统 | 切换系统语言后重启应用，界面跟随 | — | ☐ |
| 7.3.5 | 缺 key | 显示 key 字符串，不崩溃 | — | ☐ |

---

## 7.4 损坏 / 超大 CHM 降级（RD-02）

| # | 步骤 | 预期 | 自动 | 人工 ✓ |
|---|------|------|------|--------|
| 7.4.1 | 打开损坏文件 | 提示可读错误，应用不退出 | ✓ | ☐ |
| 7.4.2 | 打开超大 CHM | 可打开或进度/等待可接受；不长时间无响应 | 部分 | ☐ |
| 7.4.3 | 打开过程中取消 | 可取消或关闭标签（若已实现） | — | ☐ |

---

## 7.5 主平台安装包（§5.1）

| 平台 | 构建命令 | 安装/启动 | 打开 CHM | 编译（若适用） | 人工 ✓ |
|------|----------|-----------|----------|----------------|--------|
| macOS | `pnpm run dist:mac` | ☐ | ☐ | ☐（chmcmd） | ☐ |
| Windows | `pnpm run dist:win` | ☐ | ☐ | ☐（内置 chmcmd） | ☐ |
| Linux | `pnpm run dist:linux`（**非 MVP 必达**） | ☐ | ☐ | ☐ | ☐ |

**自动化**：`release/` 下存在 `.dmg`/`.zip`（mac）或 `.exe`（win）等。

---

## 签核

| 角色 | 姓名 | 日期 | 结论 |
|------|------|------|------|
| 开发 | | | ☐ 通过 ☐ 阻塞 |
| QA | | | ☐ 通过 ☐ 阻塞 |

**阻塞项**（如有）：

1. 
2.