OPC/dev_harness
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

将原型审核调整为线上优先和按需导出 #27

New Issue
Closed
opened 2026-08-26 15:59:13 +08:00 by ila · 2 comments
ila commented 2026-08-26 15:59:13 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：单元任务
  • 阶段：已完成
  • 原始需求来源：当前对话，2026-08-26
  • 关键需求摘要：实际开发默认在线查看 Quant-UX 原型；只有用户明确要求导出指定或全部原型时才导出本地。
  • 前置工单：无
  • 是否允许并行：是；不依赖其他未完成工单。
  • 设计证据：无 UI；本任务只调整原型审核与证据流程。

目标

  • 保留新页面、独立功能、重大交互和导航变化的原型确认门禁。
  • 将“审核前强制导出本地 HTML”改为“默认线上审核、显式按需导出”。
  • 明确线上原型的访问、版本、覆盖范围、确认和重新确认要求。
  • 定义“导出原型 #N”和“导出全部原型”的最小语义。

非目标

  • 不取消完整需求的原型确认。
  • 不新增 Quant-UX 自动导出脚本、API 包装、缓存或本地原型事实源。
  • 不批量导出现有原型。
  • 不修改任何产品 UI 或生产代码。
  • 不删除、覆盖或迁移现有 prototypes/ 快照。

已确认方案

  1. 可编辑原型以 Quant-UX 或其他线上设计工具为事实来源，默认通过线上链接审核。
  2. 工单记录原型链接、版本/revision 或确认日期、覆盖范围、确认人、确认时间和结论。
  3. 线上链接必须可访问并能识别审核版本；无法访问或无法区分版本时停止审核，等待等效方案。
  4. 页面、流程、状态、权限、异常处理或验收结果变化时，更新原型并重新确认。
  5. 只有用户明确要求“导出原型 #N”“导出全部原型”，或项目专用规则要求离线交付时，才导出到 prototypes/。
  6. 已确认的本地快照不得原位覆盖；已有快照继续作为历史证据。
  7. 不把截图或 HTML 快照作为可编辑设计源，原型不得包含凭据、真实账号、个人信息或生产数据。
  8. 严格检查固定默认线上审核与显式导出规则。

影响范围

  • AGENTS.md
  • Gitea Wiki：Development-Workflow、Product-Requirements-Overview
  • 本地镜像：docs/01-workflow.md、docs/09-product-requirements-overview.md
  • .gitea/issue_template/task.md
  • dev_scripts/harness.py 与相关测试

风险与回退

  • 风险：线上原型版本漂移、链接失效或审核对象不明确。
  • 控制：工单必须记录可识别版本和确认范围；无法稳定识别时停止审核并请求等效方案。
  • 回退：恢复完整原型审核前强制 HTML 快照要求；不涉及数据删除。

验证

  • python dev_scripts/harness.py check --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/harness.py sync --check
  • 场景检查：线上可访问、线上不可访问、版本变化、导出指定原型、导出全部原型、已有快照。

文档影响

  • 更新 Development-Workflow 和 Product-Requirements-Overview。
  • 同步核心 docs/ 镜像。
  • 默认不创建任务快照，不导出任何原型。

验收标准

  • 完整需求仍必须先确认原型，生产编码门禁不削弱。
  • 默认线上审核，不再强制每次导出本地 HTML。
  • 工单包含链接、版本、覆盖范围、确认人和确认时间。
  • 线上不可访问或版本不可识别时停止审核。
  • “导出原型 #N”和“导出全部原型”必须显式触发且不会隐式提交。
  • 不新增自动导出脚本，不导出现有原型。
  • 严格检查、单元测试和 Wiki 镜像一致性检查通过。
  • 提交推送并回写最终证据，工单保持待验收。
## 基本信息 - 类型：单元任务 - 阶段：已完成 - 原始需求来源：当前对话，2026-08-26 - 关键需求摘要：实际开发默认在线查看 Quant-UX 原型；只有用户明确要求导出指定或全部原型时才导出本地。 - 前置工单：无 - 是否允许并行：是；不依赖其他未完成工单。 - 设计证据：无 UI；本任务只调整原型审核与证据流程。 ## 目标 - 保留新页面、独立功能、重大交互和导航变化的原型确认门禁。 - 将“审核前强制导出本地 HTML”改为“默认线上审核、显式按需导出”。 - 明确线上原型的访问、版本、覆盖范围、确认和重新确认要求。 - 定义“导出原型 #N”和“导出全部原型”的最小语义。 ## 非目标 - 不取消完整需求的原型确认。 - 不新增 Quant-UX 自动导出脚本、API 包装、缓存或本地原型事实源。 - 不批量导出现有原型。 - 不修改任何产品 UI 或生产代码。 - 不删除、覆盖或迁移现有 `prototypes/` 快照。 ## 已确认方案 1. 可编辑原型以 Quant-UX 或其他线上设计工具为事实来源，默认通过线上链接审核。 2. 工单记录原型链接、版本/revision 或确认日期、覆盖范围、确认人、确认时间和结论。 3. 线上链接必须可访问并能识别审核版本；无法访问或无法区分版本时停止审核，等待等效方案。 4. 页面、流程、状态、权限、异常处理或验收结果变化时，更新原型并重新确认。 5. 只有用户明确要求“导出原型 #N”“导出全部原型”，或项目专用规则要求离线交付时，才导出到 `prototypes/`。 6. 已确认的本地快照不得原位覆盖；已有快照继续作为历史证据。 7. 不把截图或 HTML 快照作为可编辑设计源，原型不得包含凭据、真实账号、个人信息或生产数据。 8. 严格检查固定默认线上审核与显式导出规则。 ## 影响范围 - `AGENTS.md` - Gitea Wiki：Development-Workflow、Product-Requirements-Overview - 本地镜像：`docs/01-workflow.md`、`docs/09-product-requirements-overview.md` - `.gitea/issue_template/task.md` - `dev_scripts/harness.py` 与相关测试 ## 风险与回退 - 风险：线上原型版本漂移、链接失效或审核对象不明确。 - 控制：工单必须记录可识别版本和确认范围；无法稳定识别时停止审核并请求等效方案。 - 回退：恢复完整原型审核前强制 HTML 快照要求；不涉及数据删除。 ## 验证 - `python dev_scripts/harness.py check --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/harness.py sync --check` - 场景检查：线上可访问、线上不可访问、版本变化、导出指定原型、导出全部原型、已有快照。 ## 文档影响 - 更新 Development-Workflow 和 Product-Requirements-Overview。 - 同步核心 `docs/` 镜像。 - 默认不创建任务快照，不导出任何原型。 ## 验收标准 - [ ] 完整需求仍必须先确认原型，生产编码门禁不削弱。 - [ ] 默认线上审核，不再强制每次导出本地 HTML。 - [ ] 工单包含链接、版本、覆盖范围、确认人和确认时间。 - [ ] 线上不可访问或版本不可识别时停止审核。 - [ ] “导出原型 #N”和“导出全部原型”必须显式触发且不会隐式提交。 - [ ] 不新增自动导出脚本，不导出现有原型。 - [ ] 严格检查、单元测试和 Wiki 镜像一致性检查通过。 - [ ] 提交推送并回写最终证据，工单保持待验收。
ila commented 2026-08-26 16:09:09 +08:00
Author
Owner
Copy Link
Copy Source

最终实施证据（待验收）

完成内容

  • 完整独立需求仍必须先制作并确认原型，生产编码门禁没有削弱。
  • Quant-UX 或其他设计工具成为可编辑原型事实来源，默认直接使用可访问且版本明确的线上原型审核。
  • 工单模板要求记录线上链接、访问检查、审核版本识别方式、状态、确认人、确认时间和覆盖范围。
  • 线上链接无法访问或无法区分版本时停止审核；页面、流程、状态、权限、异常处理或验收结果变化时重新确认。
  • 只有用户明确发出 导出原型 #N、导出全部原型，或项目专用规则明确要求时，才导出到 prototypes/<工单号>/<版本>/index.html。
  • 已确认的本地快照不得原位覆盖；导出不扩大范围、不自动提交。已有快照继续作为历史证据。
  • 未新增 Quant-UX 自动导出脚本、API 包装、缓存或本地原型事实源。
  • 更新 Development-Workflow、Product-Requirements-Overview、共享 Agent 规则、工单模板、严格检查和测试。

提交

  • 68cf1f3 — 原型改为线上审核与按需导出。
  • c65e06b — 登记线上原型按需导出需求。
  • a75a778 — 明确外部原型仅按需保存本地快照。

均已推送到 origin/main。

验证

  • python dev_scripts/harness.py check --strict：通过。
  • python -m unittest discover -s tests -v：45/45 通过。
  • python dev_scripts/harness.py sync --check：15 个核心镜像一致。
  • 旧版强制 HTML 导出关键措辞扫描：非历史文档无残留；剩余相关文字均为“不要求每次导出”或显式导出失败处理。
  • 场景核对：线上可访问、线上不可访问、版本变化、指定工单导出、全部导出、已有快照均有明确规则。
  • 未验证：没有实际导出 Quant-UX 原型，因为用户未发出导出指令；没有修改任何产品 UI 或运行时代码。

Wiki 证据

  • Development-Workflow：4e30058e244453bf5da5cf2b5a0aa59176649127
  • Product-Requirements-Overview：62d4117937c77ee95a6315e1c4d48e2833065ded

文档和快照

  • 核心 Wiki 已在线回读并同步本地 docs/。
  • 未导出任何原型。
  • 未创建或导出任务快照。

当前阶段：待验收。工单保持开启，等待用户明确验收。

## 最终实施证据（待验收） ### 完成内容 - 完整独立需求仍必须先制作并确认原型，生产编码门禁没有削弱。 - Quant-UX 或其他设计工具成为可编辑原型事实来源，默认直接使用可访问且版本明确的线上原型审核。 - 工单模板要求记录线上链接、访问检查、审核版本识别方式、状态、确认人、确认时间和覆盖范围。 - 线上链接无法访问或无法区分版本时停止审核；页面、流程、状态、权限、异常处理或验收结果变化时重新确认。 - 只有用户明确发出 `导出原型 #N`、`导出全部原型`，或项目专用规则明确要求时，才导出到 `prototypes/<工单号>/<版本>/index.html`。 - 已确认的本地快照不得原位覆盖；导出不扩大范围、不自动提交。已有快照继续作为历史证据。 - 未新增 Quant-UX 自动导出脚本、API 包装、缓存或本地原型事实源。 - 更新 Development-Workflow、Product-Requirements-Overview、共享 Agent 规则、工单模板、严格检查和测试。 ### 提交 - `68cf1f3` — 原型改为线上审核与按需导出。 - `c65e06b` — 登记线上原型按需导出需求。 - `a75a778` — 明确外部原型仅按需保存本地快照。 均已推送到 `origin/main`。 ### 验证 - `python dev_scripts/harness.py check --strict`：通过。 - `python -m unittest discover -s tests -v`：45/45 通过。 - `python dev_scripts/harness.py sync --check`：15 个核心镜像一致。 - 旧版强制 HTML 导出关键措辞扫描：非历史文档无残留；剩余相关文字均为“不要求每次导出”或显式导出失败处理。 - 场景核对：线上可访问、线上不可访问、版本变化、指定工单导出、全部导出、已有快照均有明确规则。 - 未验证：没有实际导出 Quant-UX 原型，因为用户未发出导出指令；没有修改任何产品 UI 或运行时代码。 ### Wiki 证据 - Development-Workflow：`4e30058e244453bf5da5cf2b5a0aa59176649127` - Product-Requirements-Overview：`62d4117937c77ee95a6315e1c4d48e2833065ded` ### 文档和快照 - 核心 Wiki 已在线回读并同步本地 `docs/`。 - 未导出任何原型。 - 未创建或导出任务快照。 当前阶段：**待验收**。工单保持开启，等待用户明确验收。
ila referenced this issue from a commit 2026-08-26 16:11:51 +08:00
docs: 记录 #27 验收通过
ila commented 2026-08-26 16:13:01 +08:00
Author
Owner
Copy Link
Copy Source

验收结论

  • 验收时间：2026-08-26（Asia/Shanghai）
  • 结论：用户明确表示 #27 验收通过。
  • 长期需求状态：Product-Requirements-Overview 已更新为“已交付”，revision 591f550c3a23da2bf2a4a1d53ea6208417137961。
  • 镜像提交：0b6ec76，已推送到 origin/main。
  • 验证：严格结构检查通过；15 个核心 Wiki 镜像一致。实现阶段的 45 项单元测试已全部通过。
  • 父工单：无。
  • 原型导出：未执行；本次没有“导出原型”指令。
  • 任务快照：未创建、未导出。

验收闭环完成，关闭工单。

## 验收结论 - 验收时间：2026-08-26（Asia/Shanghai） - 结论：用户明确表示 #27 验收通过。 - 长期需求状态：Product-Requirements-Overview 已更新为“已交付”，revision `591f550c3a23da2bf2a4a1d53ea6208417137961`。 - 镜像提交：`0b6ec76`，已推送到 `origin/main`。 - 验证：严格结构检查通过；15 个核心 Wiki 镜像一致。实现阶段的 45 项单元测试已全部通过。 - 父工单：无。 - 原型导出：未执行；本次没有“导出原型”指令。 - 任务快照：未创建、未导出。 验收闭环完成，关闭工单。
ila closed this issue 2026-08-26 16:13:02 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/dev_harness#27