# DSH Visual Acceptance 项目立项

> 阶段：V0.1 立项  
> 决策：基于 2026-08-26 技术 Spike，有条件进入开发。

## 1. 项目定义

DSH Visual Acceptance 是面向 AI 生成 Web 产品和 UI 原型的本地视觉验收与回归工作台。

它不回答“Agent 看见了什么”，而回答：

> 本次检查的对象和范围是否正确，哪些问题有证据，谁拥有决定权，修改后是否通过同条件复验。

## 2. 用户问题

AI Coding Agent 可以快速生成页面，但交付判断仍散落在截图对比、浏览器检查、人工经验和对话记录中，导致：

- 目标版本和参考对象容易选错；
- 默认页通过被误写为全状态通过；
- 浏览器事实与视觉模型猜测混在一起；
- 人工确认没有结构化记录；
- 修改后无法稳定区分修复、未解决和回归；
- 静态演示容易被描述成真实可用功能。

## 3. 第一性原理

可交付验收至少需要五个不可替代的组成：

```text
对象正确
  × 范围可复现
  × 证据可追溯
  × 决定权明确
  × 同条件复验
```

任一项为零，验收结论都不可靠。因此产品不以“检查项数量”或“综合分数”为核心，而以验收链是否闭合为核心。

## 4. 首批用户与场景

### 首批用户

使用 DSH/Codex 生成本地 Web 产品的个人开发者、AI 产品经理和小团队负责人，由本人承担最终交付判断。

### 首批场景

用户拥有参考截图和一个本地 HTML/localhost 页面，需要检查桌面、390px 窄屏、Light/Dark 及少量关键业务状态，并把已确认问题交给 Agent 修改后复验。

## 5. 产品差异化

| 层级 | 归属 |
|---|---|
| OCR、grounding、crop、VLM、pixel diff | 外部 Provider 或成熟库 |
| 页面运行、资源、控制台、溢出、可达性 | 确定性 Runner |
| Target、Matrix、Evidence、Issue、Decision、Retest | 本项目核心 |
| 允许修改、驳回、接受风险 | 人工 |
| 按已确认问题执行修改 | DSH/Codex Agent |

## 6. V0.1 成功定义

V0.1 不是“能生成报告”，而是能在真实项目中完成一次闭环：

1. 用户声明并确认验收矩阵；
2. 系统证明每个检查点是否到达；
3. 事实和 AI 候选判断分层展示；
4. 用户对 Issue 作出结构化决定；
5. Agent 修改后，同一 Issue 被正确复验；
6. 报告明确新增、未解决、已解决和回归。

### 建议试点门槛

- 至少 5 个真实本地 Web 项目；
- 每个项目至少完成 2 轮复验；
- 已知确定性 Fixture 的漏检为 0；
- 人工决定保留率 100%；
- 所有 `unreached` 状态不得计为通过；
- 主观 AI 判断只看“被人工保留的问题精度”，不看生成数量。

## 7. 停止或转向条件

- 用户只导出一次报告，不使用决策与复验；
- 真实项目中的 Issue 身份无法稳定维持；
- DSH 兼容成本持续高于核心产品迭代成本；
- 视觉 Provider 的输出无法提供可审计证据；
- 现有工具已经原生覆盖状态矩阵、人工决策和 Issue 复验闭环。

## 8. 已确认决策

- 定位：验收工作台；
- 入口：DSH 会话级工作台；
- 状态矩阵：用户手工声明；
- 架构：核心中立、DSH 优先、Codex Skill 后置；
- 修改权限：未经确认不修改用户项目。