# [页面名称] 原型说明

> **事实纪律**：只记录当前素材、上游契约或用户确认能支持的页面事实。精确读数写来源；近似判断标“近似”并说明校对方式；未知项写“待确认”。合法不适用项写 `N/A（具体原因）`，不得补成通用 UI。
>
> **产物定位**：把截图、设计文件、HTML、可运行页面或文字交互规格转换为按端、按页可实现、可测试、可视觉验收的约束。共享设计系统只引用一次，本页仅记录实际使用与偏差，不重复抄整套 token。
>
> **反退化纪律**：素材证据、组件契约、交互状态和验收锚点必须逐条对应本页事实；禁止空表、示例行、“其余同上”或无法定位到素材的视觉结论。

## 1. 输入形态与提取纪律

### 素材证据表

| 素材/契约 | 版本或时间 | 具体位置 | 可确认内容 | 确定性 | 校对方式 |
|---|---|---|---|---|---|
| | | | | 精确/近似/待确认 | |

- 权威素材及冲突优先级：
- 当前文件覆盖的画面/状态：
- 本期不覆盖的画面/状态及原因：
- 实现对照锚点：上表“具体位置”列即实现与审查阶段的对照入口（源码路径+行号区间／启动方式+端口+路由／图片路径）。有源码或可运行素材时，视觉值必须从源码或运行时读取，不得取图像近似。

## 2. 页面元数据

- 所属端（与 `intent.projects` / 架构端目录一致）：
- 页面名称：
- 页面标识（已有时填写）：
- 关联需求：
- 路由或入口：
- 访问角色/权限：
- 数据与外部依赖：

## 3. 设计令牌

- 共享设计系统、组件库或 token 权威来源：
- 本页使用的共享约束：
- 页面级新增、覆盖或例外：

> 只有素材中存在页面级差异时才列下表；完全继承共享设计系统时写 `N/A（本页无页面级覆盖，引用……）`。值可为 CSS 变量、Figma 变量、平台 token、命名颜色、图片近似值或其他项目原生表达，不强制某种技术格式。

| 约束 | 值或权威引用 | 适用对象 | 来源位置 | 精度/校对 |
|---|---|---|---|---|

## 4. 页面布局树

- 页面区域与层级：
- 关键对齐、尺寸、滚动、固定或叠层关系：
- 内容增长、空内容和溢出时的布局行为：
- 与共享外壳/导航的关系：

## 5. 组件数据绑定

### 组件契约表

| 组件/区域 | 职责 | 数据来源与字段 | 可见状态 | 事件与副作用 | 无障碍要求 | 来源 |
|---|---|---|---|---|---|---|
| | | | | | | |

> 静态内容也要写真实来源；没有数据绑定时可写 `N/A（纯静态内容，来源……）`，不能虚构 API 或字段。

## 6. 交互流转

### 交互与状态表

| 当前状态 | 事件 | 守卫/前置 | 成功状态与副作用 | 失败/取消状态 | 证据来源 |
|---|---|---|---|---|---|
| | | | | | |

> 无交互的展示页可用一行 `N/A（纯展示页，无用户或系统状态转换）`，但仍需在验收锚点中定义视觉验证。

## 7. 组件视觉状态

- 适用组件的默认、聚焦、悬停、按下、禁用、加载、成功、错误状态：
- 状态之间保持或清除的数据：
- 未在素材中出现但交付必须确认的状态：

> 只写当前组件和平台适用的状态；例如无 hover 的触屏端不应被迫补 hover，须写明原因。

## 8. 响应式断点

- 目标视口/设备或容器范围：
- 布局变化及触发条件：
- 素材未覆盖的尺寸与处理方式：

> 单一固定画布或非响应式平台可写 `N/A（原因与目标画布）`。不得从常见 768px/1024px 套默认断点。

## 9. 动效规范

- 素材确认的动效、反馈和减少动态效果行为：
- 时长/曲线/平台 token（有证据时）：
- 无动效或素材无法确认时的处理：

> 无动效写 `N/A（素材明确为静态或产品决定不使用动效）`；不得补通用 100ms/200ms 数值。

## 10. 边界与异常分支

- 加载、空、错误、权限、离线、超时或不可用状态中哪些适用：
- 恢复入口、数据保留和用户反馈：
- 不适用状态及事实理由：

### 验收锚点表

| 锚点 | 类型 | 可观察预期 | 验证方式 | 证据要求 |
|---|---|---|---|---|
| | 视觉/交互/数据/无障碍 | | | |

## 完成判定

- [ ] 每个关键约束都能定位到真实素材、上游契约或用户确认。
- [ ] 共享设计系统与页面级差异分开，未重复抄写或臆造 token。
- [ ] 组件、数据、状态和交互形成可实现闭环；不适用项均有具体原因。
- [ ] 响应式、无障碍、动效和异常状态按当前平台与风险处理，不套通用默认值。
- [ ] 验收锚点能指导后续真实交互与视觉验证，不把文档完整等同于页面正确。
- [ ] 文件路径服从当前 project map；默认路径仅为 `docs/analyze/{端}/pages/{页}-原型说明.md`。