diff --git a/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 b/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 index 952f2e6..e34613d 100644 --- a/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 +++ b/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) \ No newline at end of file