# DSH Visual Acceptance `0.1.2` 响应式验收迭代

> English summary is included in each milestone.  
> 日期：2026-08-27  
> 状态：`0.1.2-beta.1` 已完成实现和本机验证，并作为 GitHub Pre-release 发布；稳定版与插件市场 Gate 仍保留。  
> 权威范围：[PRD](prd-v0.1.md) / [English PRD](prd-v0.1.en.md)

## 1. 第一性原理

Vibe Coding 的核心风险不是“尺寸选得不够多”，而是检查范围不可解释、状态不可复现、修改前后证据不可比较，以及规则候选被误写成人工结论。因此本轮竞争力来自一条连续机制：

```text
覆盖计划 → 可见 Matrix → 真实浏览器事实 → 跨视口证据 → 人工 Issue/Decision → 原 Matrix Retest → 人工确认
```

增加设备预设、总分或 AI 审美文案都不能替代这条机制。

## 2. 逐节点完成状态

### M1 — Responsive coverage / 响应式覆盖

- **实现：** Quick 2 项、Standard 8 项、Page-breakpoint、Custom；可访问 CSS Media Query 发现与 `complete / partial`；三项以上结果显示 Contact Sheet 和跨范围 Candidate 摘要。
- **验收：** 固定计划与断点解析自动测试通过；Fixture 发现 `640px / 900px`。
- **边界：** CSS 视口不代表具体设备；跨域样式不可读时不能声称完整。

### M2 — Deterministic quality / 确定性质量

- **实现：** Viewport Meta、`html[lang]`、图片 alt、表单标签、交互名称、重复 ID、水平越界交互元素；截图空白判定与一次重试。
- **验收：** Candidate 边界自动测试和 Chrome 事实 Spike 通过。
- **边界：** 这是基础规则集，不是完整 WCAG、键盘或读屏验收。

### M3 — Retest visual evidence / 复验视觉证据

- **实现：** 原 Matrix 下比较同尺寸基线与当前截图，保存 Baseline/Current/Diff、变化像素和比例。
- **验收：** Fixture 产生 7,881 个变化像素与有效 Diff PNG。
- **边界：** 变化只生成 Finding Candidate；`unreached`、缺失证据或尺寸不同均不得解释为解决。

### M4 — Controlled state recipes / 受控状态配方

- **实现：** `click / fill / select / press / wait / assert-ready`；最多 12 步；动作进入 Matrix 指纹；公开复现证据不回显填写值。
- **验收：** `fill → click → assert-ready` 在 Chrome Fixture 到达目标状态；非法动作与超时边界被拒绝。
- **边界：** 不执行任意 JavaScript；不得录入密码、令牌或其他凭据。

## 3. 本轮不做

- 参考设计图身份、对齐和语义比较；
- OCR、VLM 审美判断、Provider 实际推理；
- 真实设备农场、移动 Safari、触摸、DPR 或 UA 兼容声明；
- 自动创建 Issue、自动修改项目、自动发送 Agent、自动 `resolved`；
- Codex Skill、第二套 Harness UI 或公网 URL 验收。

## 4. 对抗式审查

| 反方问题 | 当前回答 | 停止条件 |
|---|---|---|
| 只是多了尺寸按钮？ | 计划版本、完整性、不可变 Matrix 与 Retest 证据共同构成资产 | 若真实用户不复用 Matrix，停止扩展预设 |
| Pixel Diff 噪声太大？ | 只做 Candidate，保留变化数与三联证据 | 若动画/字体噪声阻碍判断，先加稳定化与遮罩，不接 AI 评分 |
| 基础无障碍误导？ | 明示不是 WCAG；只输出具体元素证据 | 不得发布“无障碍通过率” |
| 状态步骤会变成低配 Playwright？ | 只保留六类、12 步、本地短流程 | 需要分支、循环、脚本时交给正式 E2E 工具 |
| DSH API 变化带来高维护？ | Host/Client 薄适配，Core/Runner 不依赖 DSH | 下个 DSH 版本不兼容时先修 Adapter，不扩产品面 |

## 5. 稳定版 / 插件市场 Gate

技术候选的最低证据已经完成：33 项自动测试、旧 Browser Spike、新 Responsive Spike。GitHub Pre-release 用于获取真实使用反馈；稳定版 / 插件市场 Gate 保持不变：

1. ~~新版 DSH Web 完成 Quick、Standard、Breakpoint、Custom、Run、Retest、关闭重开与 390px 实测；~~ 已于 2026-08-27 完成源码链接安装验收；
2. DSH Desktop 深浅色/关闭重开与下一个 DSH 版本兼容检查；
3. 5 个真实项目，其中至少 3 个完成实际修改与原 Matrix Retest；
4. 假性 `resolved` 必须为 0；
5. README、安装命令、版本标签和插件市场说明只声明已验证能力。

## 6. English summary

`0.1.2` adds versioned responsive coverage, readable-CSS breakpoint discovery, bounded deterministic quality signals, same-Matrix Retest Diff, and controlled state replay. These features preserve the product contract: facts create Candidates; people create Issues and confirm resolution. `0.1.2-beta.1` is published as a GitHub Pre-release to learn from real installation and use. DSH Desktop/future-version compatibility and the unchanged five-project/three-retest/zero-false-resolution Gate remain required for stable or marketplace release.