docs(#47): upgrade DevHarness baseline to bfdf648

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs/01-workflow.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Development-Workflow
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Development-Workflow.-
-wiki_revision: c62e9f4fbdc34036dda37a0298e0ae1ff12d7c94
-synchronized_at: 2026-08-17T03:27:49Z
+wiki_revision: d22ebd3709589b5defdf0abd705e76db6d0f1977
+synchronized_at: 2026-08-19T01:17:00Z
 <!-- gitea-wiki-mirror:end -->
 
 # 开发工作流
@@ -18,6 +18,16 @@ synchronized_at: 2026-08-17T03:27:49Z
 
 核心页面通过 `wiki-docs.json` 显式映射，固定执行 Wiki → `docs/` 单向同步。页面删除、重命名、映射变化或事实来源反向切换必须另行确认。
 
+## 新项目 Wiki 初始化门禁
+
+本项目 Wiki 已于 2026-08-17 初始化并启用 Wiki-first，本节适用于从本仓库派生新项目的场景。
+
+- 先创建 Gitea 远端仓库并启用工单和 Wiki，再配置 `wiki-docs.json`；不得把本地 `docs/` 当作线上 Wiki 已初始化的证据。
+- 优先使用已配置的 Gitea MCP 查询和写入 Wiki；MCP 不可用或不支持所需写操作时才使用 Gitea API，并在初始化工单记录回退原因。凭据只从环境或 MCP 安全配置读取。
+- 先查询线上页面列表；`Home` 不存在时必须先创建 `Home`，在线回读正文并记录 revision，再逐页创建或更新其他核心映射页面。
+- 每个核心页面写入后必须在线回读并取得 revision。页面缺失、回读失败或没有 revision 时停止初始化，不得开始产品代码。
+- 产品编码前必须运行 `python dev_scripts/harness.py sync --verify`，全部成功才表示初始化完成。
+
 ## 工单与设计证据双门禁
 
 正式实施前依次判断是否需要工单，以及需要什么设计证据。工单不能替代原型确认，原型也不能替代技术方案、安全检查和单元工单。
@@ -39,6 +49,17 @@ synchronized_at: 2026-08-17T03:27:49Z
 
 设计证据记录链接或路径、App ID/版本、草稿/已确认/已废弃状态、确认人、确认时间和覆盖范围。页面结构、主要流程、状态、权限、异常处理或验收结果变化时必须重新确认。
 
+### 本地 HTML 审核快照
+
+- 完整原型形成待审核版本后，必须在用户审核前生成本地可浏览 HTML 快照，保存到 `prototypes/<工单号>/<版本>/index.html`；版本目录内资源使用相对路径。
+- 可编辑设计源仍在 QuantUX，Git 中的 HTML 是版本化审核证据，Wiki 和工单只保存索引。
+- 已确认的 HTML 快照不得原位覆盖。页面结构、流程、状态、权限、异常处理或验收结果变化时，使用新版本目录重新导出并重新确认。
+- 提交审核前检查入口、主要交互和资源完整性，并删除凭据、账号、个人信息和生产数据。
+- QuantUX 无法生成可用 HTML 时，在工单记录限制并停止审核，等待用户确认等效的本地可浏览方案；不得只保留线上链接后直接编码。
+- 纯显示文案、小范围 UI、非 UI 需求和恢复既有行为的 Bug 不强制生成 HTML。
+
+**存量偏离（#47 确认）**：`prototypes/` 下已有的 `quantux-*.html` 平铺快照建立于本规则之前，保持原样不迁移，历史版本可在 Git 历史中查阅；工单号/版本目录结构自 #47 起对新增原型生效。
+
 ## 任务层级与状态
 
 ```text

docs/06-troubleshooting.md

@@ -2,12 +2,22 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Troubleshooting
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Troubleshooting
-wiki_revision: 779ea2d826cb6f09b7a3df98f243a22bdd8bf6f5
-synchronized_at: 2026-08-17T03:28:14Z
+wiki_revision: 6c4352598e1152ed562e998aa641f38415ac71c7
+synchronized_at: 2026-08-19T01:17:13Z
 <!-- gitea-wiki-mirror:end -->
 
 # 故障排查
 
+## 排查顺序
+
+1. 先确认现象可复现，并记录设备、App 版本、任务号和规则快照。
+2. 从服务端结构化任务日志与错误码入手，不先猜测 Android 端实现。
+3. 再看设备心跳、租约与任务状态是否自洽。
+4. 最后才进入 Android 侧控件与页面证据排查。
+5. 涉及创建订单、权限、凭据或数据删除时立即停止并等待人工确认，不通过重试获取反馈。
+
+以下按现象归类，均已实测确认。
+
 ## 设备显示离线
 
 1. 检查服务器 API 地址和 HTTPS 证书。