docs: 完成任务 #21 归档

Task-21-Quant-UX%E5%8E%9F%E5%9E%8B%E6%9C%AC%E5%9C%B0HTML%E5%AE%A1%E6%A0%B8%E5%BF%AB%E7%85%A7.-.md

@@ -1,42 +1,69 @@
 # 21 Quant-UX原型本地HTML审核快照
 
-- 类型：需求 / 缺陷 / 重构
-- 所属 Epic：#
-- 所属 MVP / 版本：#
-- 状态：待验收 / 已完成
+- 类型：流程文档
+- 状态：待验收
 - 日期：2026-08-17
 - Gitea 工单：https://git.ilapage.cn/OPC/dev_harness/issues/21
 - Wiki 页面：Task-21-Quant-UX原型本地HTML审核快照
-- Wiki revision：见本地镜像头
+- 本地镜像：按 #14 规则不自动导出
 
 ## 背景与目标
 
-<!-- 原来有什么问题，这次达到什么结果。 -->
+解决线上 Quant-UX 原型不便浏览的问题，让重大 UI 需求在正式编码前具有可本地访问、与版本绑定且不可覆盖的 HTML 审核证据。
 
 ## 最终方案
 
-<!-- 说明实际实现。与建单方案不同之处必须写清原因。 -->
+- 新页面、独立用户功能、重大交互或导航的待审核原型必须生成 `prototypes/<工单号>/<版本>/index.html`。
+- Quant-UX 等工具保存可编辑设计源，Git HTML 保存审核快照，Wiki 和工单保存索引与确认记录。
+- 版本目录资源使用相对路径；需要静态服务时在工单记录最小启动命令。
+- 已确认版本不得覆盖；关键变化建立新版本目录、重新导出并重新确认。
+- 审核前检查入口、主要交互、图片、字体和资源，并清除凭据、账号、个人信息和生产数据。
+- 纯显示文案、小范围 UI、非 UI 和恢复既有行为的 Bug 不强制生成 HTML。
+- 工具不能生成可用 HTML 时停止审核，等待用户确认等效本地方案。
+- 不创建空目录、示例 HTML、导出脚本或第三方依赖。
 
 ## 修改文件
 
-- `<文件>`：<改动说明>
+- `AGENTS.md`：增加本地 HTML 审核快照门禁。
+- `.gitea/issue_template/task.md`：记录设计源、HTML 路径和本地浏览检查。
+- `dev_scripts/check_harness.py`：检查规则、Wiki 章节和模板字段。
+- `tests/test_harness_docs.py`：增加 HTML 快照规则测试。
+- `docs/01-workflow.md`：镜像线上工作流。
+- `docs/09-product-requirements-overview.md`：镜像原型索引和状态。
 
 ## 验收结果
 
 | 验收标准 | 结果 |
 |---|---|
-|  | 通过 / 未通过 |
+| 重大 UI 审核前生成本地 HTML | 通过 |
+| 路径、相对资源和版本规则明确 | 通过 |
+| 三类事实来源边界明确 | 通过 |
+| 工单模板记录设计源和 HTML | 通过 |
+| 关键变化新建版本且重新确认 | 通过 |
+| 小改动和非 UI 不被强制导出 | 通过 |
+| 脱敏和浏览完整性检查明确 | 通过 |
+| 未创建空原型或导出工具 | 通过 |
+| 工单保持待验收 | 通过 |
 
 ## 测试
 
-- 执行命令：`<命令>`
-- 结果：
-- **未验证部分**：<!-- 必填；没有就写“无”。 -->
+- `python dev_scripts/check_harness.py --strict`：通过。
+- `python -m unittest discover -s tests -v`：40 项全部通过。
+- `python dev_scripts/sync_wiki_docs.py --check`：14 个核心页面一致。
+- `git diff --check`：通过。
+- 人工场景：重大 UI 需要 HTML；纯文字和小范围 UI 不强制；关键变更新建版本并重新确认。
+- **未验证部分**：本任务没有实际产品 UI，因此没有创建或导出 Quant-UX 原型，也没有验证具体 Quant-UX 项目的导出兼容性。
+
+## Wiki 证据
+
+- Development-Workflow revision：`de2246483928433173f67cfe88a8473af874f0d0`
+- Product-Requirements-Overview 实施中 revision：`40dedc3cc0c0ac17f13d72281416df78697df626`
 
 ## 遗留问题
 
-<!-- 没有就删除本节。 -->
+无。
 
 ## 相关提交
 
-- `<提交哈希>` <提交说明>
+- `51a7c8b` docs: require local HTML prototype snapshots (#21)
+- `6f941e1` docs: sync prototype snapshot Wiki revisions (#21)