docs: 回填 HWLAB Web 页面交付报告

2026-07-13 07:07:48 +02:00
parent aa974f7def
commit 3056a2b343
7 changed files with 92 additions and 6 deletions
@@ -0,0 +1,14 @@
+# R1.10 任务报告
+
+## 交付
+
+- HWLAB PR [#2520](https://github.com/pikasTech/HWLAB/pull/2520) 已重写 Performance、Gate、Skills、OpenCode 外壳及 Help/Settings 系统工具页。
+- 系统页统一“状态→问题→证据→动作”层次、Page Command、Status Strip、视图状态和有界详情；未为 Skills 虚构不存在的删除或启停合同。
+- OpenCode 保留同源 ticket、认证与 URL 安全边界，只增强加载、错误、重试和可调整三栏外壳。
+- Performance 使用 typed 性能事实、统一时间窗口和渐进披露，不在前端拼装关键后端结论。
+
+## 验证
+
+- OpenCode iframe retry 与 separator 键盘调整专项通过 4 项 Playwright 验证中的对应场景。
+- OpenCodeFrame 与 SplitWorkspaceLayout 测试纳入 11 项 Vitest，双宽度固定路由烟测无 pageerror。
+- Workbench 业务 store、提交链和事件投影未被系统工具页改写。
@@ -0,0 +1,15 @@
+# R1.11 任务报告
+
+## 迁移收口
+
+- HWLAB PR [#2520](https://github.com/pikasTech/HWLAB/pull/2520) 在 53 个文件中完成普通页面迁移，新增约 3907 行、删除约 758 行。
+- 旧 `DataTable` 已删除；普通页面统一到共享 DataGrid、ResourceCollection、AsyncBoundary、Dialog/Drawer 与 SplitWorkspaceLayout。
+- 非 Workbench 视图已无原生 `<table>` 和旧 `DataTable` 使用；卡片、列表、表格消费同一 typed DTO 与稳定实体 ID。
+- MDTODO 删除 Workbench 私有 store 依赖；Dashboard 关键事实迁到 typed bounded BFF，页面不再名称去重或猜测字段。
+- Workbench 路由、会话深链、提交/事件主路径保持原职责，普通页面样式和 bounded workspace 按职责组织。
+
+## 验证
+
+- `bun run check` 114/114，后端合同 8/8，Vitest 11/11，固定页面烟测 5/5，专项 Playwright 4/4。
+- `git diff --check` 通过；双 Vite build 与 dist freshness 通过。
+- follow-up PR [#2521](https://github.com/pikasTech/HWLAB/pull/2521) 的独立二轮复审无阻断。
@@ -0,0 +1,14 @@
+# R1.4 任务报告
+
+## 交付
+
+- HWLAB PR [#2520](https://github.com/pikasTech/HWLAB/pull/2520) 已合并到 `v0.3`，合并提交为 `47bd0da99638ff726ebfd0f31bce5a4ec635d98c`。
+- 登录、注册、404 与普通页面统一为工业控制台视觉；404 保持公开路由边界，不绕过 ACL 或登录 redirect。
+- Router 保留稳定 `navId`、实体深链和 Workbench 路径；共享壳继续区分 shellless 身份页与 Workbench 滚动所有者。
+- UniDesk PR [#1884](https://github.com/pikasTech/unidesk/pull/1884) 已删除 HWLAB 入口硬编码 IP，由 `config/frontend.yaml` 校验并下发正式 HTTP(S) URL。
+
+## 验证
+
+- Cloud Web 固定烟测覆盖 19 个路由、960px 与 390px 两档宽度，无 document 横向溢出和 pageerror。
+- `bun run check` 通过 114 项检查；OpenCode separator 键盘交互与双宽度布局专项通过。
+- Workbench 主路由、会话深链和既有 ACL 元数据未被普通页面重写替换。
@@ -0,0 +1,15 @@
+# R1.7 任务报告
+
+## 交付
+
+- HWLAB PR [#2520](https://github.com/pikasTech/HWLAB/pull/2520) 重写 Projects 与 MDTODO；Projects 使用服务端 `projectId`、状态查询和 `page.total`，详情切换不会泄漏旧快照。
+- MDTODO 保留有界三栏、Source/File 工具栏、任务树、正文、报告侧栏与 RESTful 深链；首窗固定 100 条，可按 100 条步进加载并精确恢复第 205 条任务。
+- Workbench 联动只调用公共 Launch API，不再导入 Workbench 私有 store。
+- HWLAB PR [#2521](https://github.com/pikasTech/HWLAB/pull/2521) 补齐 HWPOD 来源离线时的 typed partial 投影、全链路只读保护、projection-only 报告占位和贴底事实栏。
+- UniDesk PR [#1899](https://github.com/pikasTech/unidesk/pull/1899) 已让 analyzer 把任务树事实栏计为有效内容，消除布局误报而不降低阈值。
+
+## 验证
+
+- Project Management 后端合同覆盖 205 任务精确查询、`projectId` 过滤和 partial/stale/restricted。
+- follow-up 后端 13/13、Vitest 2/2、Playwright 3/3、TypeScript 与 build 均通过。
+- NC01/v03 observer `webobs-mriq0nci-aaf44f` 采样 20 次，项目 API 均为 200，任务正文与 Workbench Launch 可见；该 observer 已受控 force-stop。
@@ -0,0 +1,14 @@
+# R1.8 任务报告
+
+## 交付
+
+- HWLAB PR [#2520](https://github.com/pikasTech/HWLAB/pull/2520) 已重写 Dashboard、API Keys、Usage、Billing、Settings 与 Help 等现有用户页面。
+- 新增 bounded `GET /v1/dashboard/summary` 聚合读模型，按继续任务、HWPOD、额度和异常分区；单一上游失败时保留成功区块并显式呈现 partial、stale 或 restricted。
+- 集合页统一 ResourceCollection/DataGrid、卡片或列表视图、URL 状态、服务端分页与实体详情；低频创建、兑换等动作进入 Dialog。
+- 未虚构仓库中不存在的组织、支付、轮换或跨设备偏好能力；界面只展示 typed API 已提供的事实和可用动作。
+
+## 验证
+
+- Dashboard 与 Project Management 后端合同共 8 项通过，覆盖聚合部分失败和权限受限状态。
+- 19 路由双宽度烟测通过；ResourceCollection 与 URL view state 的 Vitest 包含在 11 项前端测试中。
+- 用户账务、用量与 API Key 的卡片、列表和详情消费同一 typed DTO。
@@ -0,0 +1,14 @@
+# R1.9 任务报告
+
+## 交付
+
+- HWLAB PR [#2520](https://github.com/pikasTech/HWLAB/pull/2520) 已重写 Users、Access、Secrets、ExternalSecret 详情、Admin Billing 与 Provider Profiles。
+- 页面统一集合、稳定实体深链、Inspector/详情与低频 Dialog；Users、账务和 Provider 集合采用服务端分页、筛选及 typed DTO。
+- Access 继续消费既有权限域；Secrets 与 ExternalSecret 只呈现对象、namespace、key、presence、fingerprint、状态与摘要，不增加运行面反解或浏览器 Apply。
+- Provider Profiles 收紧 URL authority 与 typed 状态，未知字段不再由前端猜测或拼装。
+
+## 验证
+
+- 相关路由纳入 19 路由 × 960/390 固定烟测，无横向溢出或 pageerror。
+- `bun run check` 114 项通过，包含 `vue-tsc`、零 explicit any、双 Vite build 和 dist freshness。
+- Access matrix、用户详情、Secret 详情和 Provider 详情继续使用稳定路由 ID 与既有 ACL。
@@ -27,7 +27,7 @@

 依赖 R1.1，可与 R1.2 并行；按硬件池、Agent编排、HarnessRL、客户端、用户管理和平台运维主责补齐 typed DTO、BFF/read model、服务端搜索/排序/cursor、详情与日志/operation 查询。评估抽取 hwlab-hwpod-service 统一 HWPOD registry、node connection、拓扑、operation 和诊断；Cloud API 只保留同源鉴权/路由/correlation，项目与用户事实继续归既有服务，拆分前先更新对应 SPEC，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.3_Task_Report.md)。

-### R1.4
+### R1.4 [completed]

 依赖 R1.2、R1.3，重写全站应用壳、登录、注册和 404：导航按用户工作流组织，保留或原子迁移 navId/ACL、同源 HttpOnly 会话与安全 redirect；桌面、紧凑桌面和移动端都有明确导航、上下文、命令区和滚动所有者。联动修正 UniDesk HWLAB 外链壳的硬编码 IP，使其从受控配置解析正式入口；共享壳变更不得改写或回退 Workbench 主工作流，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.4_Task_Report.md)。

@@ -39,23 +39,23 @@

 依赖 R1.2、R1.3，与 R1.5 协同重写“HWPOD Node”和“节点接入”子标签：管理已连接及声明离线 node，展示平台、版本、心跳、能力、in-flight、诊断和其挂载的零到多个 HWPOD；网页消费 update/download 元数据下载 Python 单文件，展示版本、大小、SHA 和安装条件。按 downloaded→installed→desktop-visible→registered→workspace-ready→hwpod-ready 分阶段引导，凭据仍只走 YAML sourceRef/受控 CLI，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.6_Task_Report.md)。

-### R1.7
+### R1.7 [completed]

 依赖 R1.2、R1.3，重写 Projects 与 MDTODO：Projects 提供项目卡片/表格、状态/来源筛选、项目详情、任务活动与 blocker 深链；MDTODO 保留成熟的有界三栏、Rxx 树→正文→报告、Source/File 工具栏、inline edit、报告关闭/调整/全屏、RESTful 深链和刷新恢复，并接入新的通用组件。删除 Workbench 私有 store 依赖，只通过公共 Project Management 与 Workbench Launch API 联动。执行见[HWLAB #2517](https://github.com/pikasTech/HWLAB/issues/2517)，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.7_Task_Report.md)。

-### R1.8
+### R1.8 [completed]

 依赖 R1.2、R1.3，重写 Dashboard、组织/用户协同、API Keys、Usage、Billing、Settings 与 Help：Dashboard 通过后端聚合 read model 提供继续项目/任务、HWPOD、额度和主要异常；集合页统一卡片/列表、筛选、分页和深链；创建/兑换等低频操作进入 Dialog。不得虚构未落地的支付、scope、轮换或跨设备偏好，缺失能力先更新用户管理 SPEC/API，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.8_Task_Report.md)。

-### R1.9
+### R1.9 [completed]

 依赖 R1.2、R1.3，重写 Users、Access、Secrets/External Secret、Admin Billing 与 Provider Profiles：统一集合→Inspector/深链详情→低频 Dialog，补 typed DTO、服务端分页、筛选、审计/验证历史和有界日志。Access 继续消费权限域真相；Secret 只展示对象、key、presence、fingerprint 与摘要，保留 dry-run/plan 和 YAML-first sourceRef，不新增运行面反解或前端 Apply，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.9_Task_Report.md)。

-### R1.10
+### R1.10 [completed]

 依赖 R1.2、R1.3，重写 Performance、Gate、Skills、OpenCode 外壳及其他非 Workbench 系统工具页：按“状态→问题→证据→动作”渐进披露，统一时间窗口、视图/密度、详情深链、日志/证据查看和异步状态；Performance 拆分大组件并保持有界可视化，Skills 不在缺少正式 API 时虚构删除/启停，OpenCode 保留同源 ticket、认证和安全 URL，只增强加载/错误/重试外壳，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.10_Task_Report.md)。

-### R1.11
+### R1.11 [completed]

 依赖 R1.4-R1.10，完成迁移收口：删除所有已被新设计系统替代的旧页面 shell、私有 Panel/Table/Dialog/Viewer、字段名猜测、名称去重、关键事实前端拼装、重复 CSS 和阻碍最新目标的兼容入口；把 Workbench 与普通页面样式按职责拆分，所有源码文件满足体积治理。保持稳定业务 ID、API、权限、Secret、深链和 Workbench 用户主路径无回退，完成任务后将详细报告写入[任务报告](./details/hwlab-web-product-experience/R1.11_Task_Report.md)。