v0.2 hwlab-cloud-web 服务规格

hwlab-cloud-web 是 v0.2 浏览器工作台，运行在 hwlab-v02 namespace，内部端口 8080，公网经 FRP 暴露为 http://74.48.78.17:19666/。

在系统中的职责划分

向用户提供 Cloud Workbench、Code Agent 对话、live status、device-pod 右侧面板、trace 展示和帮助内容。
只消费 hwlab-cloud-api，不直接访问 Postgres、gateway、device-pod Service、FRP、Kubernetes 或 provider Secret。
为浏览器提供同源代理，避免前端直接跨域调用内部 ClusterIP。

内部架构

web/hwlab-cloud-web/app.ts 是浏览器端主入口，和 app-device-pod.ts、app-conversation.ts、app-trace.ts、app-helpers.ts 共同组成实际 bundle 输入集合，组织 Workbench 状态、Code Agent 会话缓存、trace 轮询和 device-pod 面板。
internal/dev-entrypoint/http.mjs 提供静态服务、health 和 HTTP proxy 基础能力。
internal/dev-entrypoint/cloud-web-routes.mjs 定义可代理到 cloud-api 的同源 API route 和认证边界。
web/hwlab-cloud-web/auth.ts 管理工作台登录态；真正的用户权限 authority 仍应收敛到 cloud-api。

API 接口说明

接口	说明
`GET /`	Cloud Workbench 首屏。
`GET /health`、`GET /health/live`	返回 cloud-web 自身 health 和 build metadata。
`GET /help`	返回可用 route 摘要。
`GET /v1`、`GET /v1/...`	同源代理到 `hwlab-cloud-api`；公开的 Code Agent result/trace 轮询按 route policy 处理。
`POST /v1/agent/chat`、`POST /v1/agent/chat/cancel`	同源代理到 cloud-api 的 Code Agent 入口。
`POST /v1/m3/io`、`POST /json-rpc`	同源代理到受控 API；不能绕过 cloud-api 直连硬件服务。

测试规格

Cloud Web 的默认校验入口是 bun run --cwd web/hwlab-cloud-web check。该入口必须在 v0.2 CI 的 hwlab-cloud-web 镜像发布前执行，且保持秒级或低十秒级，不引入浏览器、Playwright、公网或真实 provider 依赖。

Cloud Web check 必须先对实际 bundle 输入集合运行 TypeScript 语义检查。语法检查和 Bun build 只能证明源码可解析或可打包，不能稳定发现未绑定标识符；isRequestTraceEvent is not defined 这类错误必须由 semantic check 在发布前拦截。实现上可以生成与 dist build 相同顺序的临时 app entry，再执行 tsc --noEmit 或等价 TS checker；只跑 node --check、bun build 或源码字符串断言不满足本规格。

Cloud Web 单元测试必须自动发现并执行 repo-owned web/hwlab-cloud-web/**/*.test.ts，不允许只维护硬编码文件清单。app-trace 的 trace row/render helper 必须有纯逻辑单测，直接构造 request、setup、commandExecution、assistant markdown 和 completion events，证明 trace 展示路径不会因为漏定义 helper、事件分类漂移或 markdown body 渲染变更而在浏览器运行期崩溃。

Cloud Web check 通过后仍需执行 bundle build 和 dist freshness 校验，确保实际发布的 dist/app.js 来自同一组 TypeScript 输入。默认 check 不恢复旧 quick prompt、旧 layout smoke、旧 M3 evidence、旧 DEV/D601 browser gate 或 Playwright；这些只能作为显式专项诊断，不得进入默认 CI/CD 关键路径。

T1

阅读 docs/reference/spec-v02-hwlab-cloud-web.md，然后用 cli 手动测试以下内容：访问 http://74.48.78.17:19666/ 和 /health/live，确认页面和 health 均来自 v02 cloud-web，而不是 DEV/PROD 端口。

T2

阅读 docs/reference/spec-v02-hwlab-cloud-web.md，然后用 cli 手动测试以下内容：从同源 19666 提交 Code Agent 短连接请求并轮询 result，确认请求经 cloud-web proxy 到 hwlab-cloud-api，且 trace 可回放。

T3

阅读 docs/reference/spec-v02-hwlab-cloud-web.md，然后用 cli 手动测试以下内容：打开 Workbench device-pod 面板，确认 status/freshness/blocker 显示来自 /v1/device-pods，未登录或未授权时必须显示认证/授权 blocker，不得把 fixture 或 blocked fallback 写成真实硬件 DEV-LIVE。

T4

阅读 docs/reference/spec-v02-hwlab-cloud-web.md，然后用 cli 手动测试以下内容：运行 bun run --cwd web/hwlab-cloud-web check，确认输出或日志显示已执行 Cloud Web TypeScript 语义检查、自动发现的单元测试、bundle build 和 dist freshness 校验；不得用只跑 bun build 或浏览器手工刷新替代该检查。

T5

阅读 docs/reference/spec-v02-hwlab-cloud-web.md，然后用 cli 手动测试以下内容：确认 trace 渲染相关单测覆盖 request、setup、commandExecution、assistant markdown 和 completion row；该测试必须能在无浏览器、无 Playwright、无公网、无真实 provider 的环境中执行。

规格的实现情况

规格项	状态	说明
Workbench 首屏	已实现	当前页面直接进入工作台，不是 landing page。
cloud-api 同源代理	已实现	受 route policy 控制。
Code Agent UI/trace/result	已实现	支持 provider profile、timeout、trace 轮询和取消。
device-pod 面板	未完全实现	当前主要消费 fake/只读 device-pod payload。
完整多用户 admin/user UI	未完全实现	登录态存在，权限 authority 仍需按 spec-user-access 收敛到 cloud-api。

5.3 KiB Raw Blame History