# Product

> English companion: [PRODUCT.en.md](PRODUCT.en.md). Update both documents when product scope changes.

<!-- impeccable:product-schema 1 -->

## Platform

web

## Stack

DeepSeek Harness Host + Web Client 插件；当前使用原生 JavaScript、React ModuleLoader、Node.js 与 Chrome DevTools Protocol，不新增运行依赖。

## Users

主要用户是使用 DSH 或 Codex 生成、修改本地 Web 产品的 AI 产品经理、设计师转产品经理、独立构建者和小团队负责人。他们在 Agent 声称“生成完成”后，需要亲自判断产出能否交付。

## Product Purpose

DSH Visual Acceptance 把分散的浏览器检查、视觉证据、产品状态覆盖、人工决定和修改后复验组织为可追踪的本地验收闭环。成功不是生成一份报告，而是用户能确认检查对象与范围、决定哪些问题允许修改，并在同条件下完成复验。

## Positioning

视觉工具解决“Agent 看见了什么”；本产品解决“这次验收检查了什么、哪里不合格、证据来自哪里、谁决定、修改后是否通过”。核心机制是 Target、Matrix、Evidence、Issue、Decision 和 Retest，而不是 OCR、VLM 或综合评分。

## Operating Context

- 运行在 DSH 会话级 `conversation.view` 中；
- 当前会话工作区是存储和路径权限边界；
- 用户选择快速、标准、页面断点或自定义覆盖计划；系统先生成并展示最多 8 个 Checkpoint，用户确认后才运行；
- 自定义 Checkpoint 可保存六类受控状态步骤；不接受任意 JavaScript 或状态猜测，界面明确禁止把凭据写入本地 Matrix；
- Host 启动一次性本地 Chrome 检查，Run 结束后释放浏览器和临时目录；
- 视觉 Provider 是可选能力，缺失时运行事实仍可完成；
- 用户确认的问题可生成本地只读修改包；当前由用户自行复制给 Agent，不提供自动会话注入。

## Capabilities and Constraints

- V0.1 只面向本地 HTML、localhost Web 产品和 UI 原型；
- 运行事实、视觉事实、AI 体验判断和产品判断必须分层；
- `unreached` 不得计为通过；
- 未经人工确认不得修改目标项目；
- 不复制没有差异化的 OCR、grounding、crop 或取色；当前 Pixel Diff 只服务原 Matrix Retest，并保持 Candidate 语义；
- 核心保持 Harness 中立，首个交付入口只做 DSH，Codex Skill 后置；
- DSH 仍快速变化，Adapter 必须薄且可关闭；
- 当前闭环 Beta 交付 Candidate、项目级 Issue、追加式 Decision、只读修改包、不可变 Matrix Retest 与人工复验确认；不宣称完整 V0.1。
- `0.1.2` 源码候选增加响应式覆盖计划、CSS 断点发现、基础无障碍/可达性信号、截图内容校验、Retest Diff 与状态配方；CSS 视口不等于真实设备。

## Brand Commitments

- 产品名：DSH Visual Acceptance；
- 中文界面默认使用“视觉验收”；
- 继承 DSH 原生 Operate 体验：安静、紧凑、任务导向，不做营销落地页；
- 文案明确区分事实、候选判断和人工决定；
- 不用单一总分隐藏具体问题。

## Evidence on Hand

- `docs/spike-report.md`：DSH Host、Chrome、Provider Adapter 和 Issue 复验 Spike；
- 本地 `artifacts/`：运行证据与截图；为保护工作区内容，不随公开仓库发布；
- 当前 DSH 安装版本 `0.1.1-rc.2`；
- 当前插件已通过本地 `link:` 安装并显示“视觉验收”Tab；
- `0.1.1-closed-loop-beta` 已在真实 DSH Web 完成 Fixture 闭环：1 个 Candidate 被人工立项并批准修改，生成本地修改包，原 Matrix Retest 后人工确认为 `unresolved`；
- `0.1.2` 响应式 Spike 已在 Chrome `151.0.7922.174` 验证断点发现、质量事实、非空截图、像素 Diff、受控状态复现与动作证据脱敏；尚未完成新版 DSH UI 正式安装验收；
- 尚无真实用户项目数据、主观视觉判断 Eval 或正式发布案例，不得虚构。

## Product Principles

1. 确定性问题由浏览器和规则回答，AI 不得猜测；
2. 候选结果、确定性事实、AI 判断和人工决定分开；
3. 每个结论绑定正确对象、覆盖范围、影响和决策人；
4. 本地优先，复用宿主，Provider 可替换；
5. 修改后的同条件复验比一次性报告更重要。

## Accessibility & Inclusion

工作台必须支持键盘焦点、深浅色、缩放和 390px 窄屏；状态不能只靠颜色表达，加载、空、错误和禁用状态都必须提供可读文本。