Codex
7.5 KiB
7.5 KiB
PJ2026-0104 客户端
修改历史
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
|---|---|---|---|
| v0.3 | b5d8cee438 |
2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
| v0.2 | b0cbe9b721 |
2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653 |
2026-06-14 | 从迁移来源 pikasTech/HWLAB#1206 迁移到 UniDesk 项目管理目录。 |
正文
编号: PJ2026-0104 短名: 客户端 上级总项目: PJ2026-01 HWLAB 总规格 总规格文件: PJ2026-01-HWLAB.md 核对时间: 2026-06-14（北京时间） 核对口径: 以 HWLAB Cloud Web、hwlab-cli、HTTP API、公开入口、v0.3 Vue parity 和用户可见退化 issue 为准；本文档 定义用户入口契约和展示行为，不接管用户账本、Agent 内部调度、硬件库存或发布机制。
主责边界
- 主责对象: Web、CLI、HTTP API、SDK/IDE 插件、webhook、公开文档、兼容性、用户任务入口、状态展示和结果获取。
- 不负责: 用户/计费真相、Agent 调度内部、硬件库存与证据真实性、CI/CD 发布、Secret/配置下发。
- 交接方向: 用户管理、Agent编排、硬件池、HarnessRL、平台运维。
交叉引用
- 上游依赖: 用户管理 提供身份、权限、API key、额度和 admin 能力；Agent编排 提供任务状态、session 和结果指针；硬件池 提供资源/设备状态；HarnessRL 提供 evidence/aggregate；平台运维 提供公网入口和发布状态。
- 下游支撑: 所有用户入口通过客户端暴露；用户管理、Agent编排、硬件池和 HarnessRL 的用户可见能力需要客户端承载。
- 接口/证据边界: 本方向定义 Web/CLI/API/SDK/Webhook 的调用契约、展示行为、错误语义和兼容性；不定义账号账本、Agent 生命周期、HWPOD 语义或 Harness evidence 标准。
- 需同步回写: API/CLI/Web/SDK/Webhook 契约、兼容性、公开文档或用户入口变化时，回写 L0 总规格、用户管理、Agent编排、硬件池、HarnessRL 和 平台运维。
方向目标
形成统一的多客户端用户入口，让 Web、CLI、API、SDK/IDE 插件和 Webhook 围绕同一任务模型、权限模型、资源模型和结果模型协同演进。当前重点是把 v0.3 Vue 工作台退化、公开入口、API/CLI 一致性和用户管理页面补齐归到稳定 L2 下。
L2 课题
| 编号 | 短名 | 主责 | 关联 L1 | 边界 |
|---|---|---|---|---|
| PJ2026-010401 | Web工作台 | 定义 Cloud Web 的任务提交、session/history、trace/result、HWPOD/evidence、Access/Usage/Admin 和工作台交互。 | Agent编排、用户管理、硬件池、HarnessRL、平台运维 | 完成标准是 Web 原入口行为正确；身份真相、Agent 生命周期、HWPOD 语义和发布机制分别归对应 L1。 |
| PJ2026-010402 | CLI入口 | 定义 hwlab-cli/hwpod/case 等用户命令的参数、输出、错误、profile、同路径 smoke 和脚本可用性。 | Agent编排、硬件池、HarnessRL、用户管理 | 完成标准是 CLI 用户入口一致可用；HWPOD 执行语义归 硬件池，CaseRun 评价归 HarnessRL。 |
| PJ2026-010403 | API契约 | 定义 HTTP API/WebSocket 的路径、schema、错误码、鉴权转发、兼容性和客户端消费契约。 | 用户管理、Agent编排、平台运维 | 完成标准是公开/内部 API 行为可依赖；后端业务真相由对应 L1 定义。 |
| PJ2026-010404 | SDK插件 | 定义 SDK、IDE 插件、外部工具接入、任务创建/查询/结果读取封装和版本兼容。 | Agent编排、用户管理 | 完成标准是外部开发者可集成；不定义平台底层调度或账号账本。 |
| PJ2026-010405 | Webhook集成 | 定义外部回调、事件订阅、任务状态通知、证据通知和失败重试语义。 | Agent编排、HarnessRL、用户管理 | 完成标准是外部系统能可靠消费事件；事件事实来源归对应业务 L1。 |
| PJ2026-010406 | 文档兼容 | 定义公开文档、示例、迁移说明、兼容性矩阵、错误排查和多客户端一致性说明。 | 全部 L1 | 完成标准是用户入口可解释、可迁移；不把内部长期规格或阶段报告当作客户端交付。 |
当前开放缺口映射
- v0.3 Vue 工作台入口与会话发送退化：主归 PJ2026-010401 Web工作台，关联 Agent编排。
- v0.3 Cloud Web 直达 history 路由缺 SPA fallback：主归 PJ2026-010401，公开入口/发布归 平台运维。
- v0.3 域名工作台登录后 API 间歇 502 且停留登录页：客户端侧归 PJ2026-010401/API契约，运行面归 平台运维。
- v0.3 Cloud Web check 受测试运行器兼容性与 timing 抖动影响：客户端侧归 PJ2026-010401，验证工具链归 平台运维。
- Agent Review 的 Web UI 承载部分：归 PJ2026-010401，评估/审查语义归 HarnessRL。
验收标准
- 原入口: Cloud Web 公网/内网入口、
hwlab-cli、HTTP API/WebSocket、SDK/插件样例和 Webhook 回调。 - Runtime/lane: HWLAB v0.2/v0.3；具体目标由下级 L2/L3 issue 指定。
- Evidence: Web smoke、CLI smoke、API 响应样例、SDK/plugin 示例、Webhook 投递记录、公开文档链接、兼容性记录和用户可见错误语义。
- 完成口径: 客户端只确认“用户入口一致、可用、可解释”；身份/账本由 用户管理 验收，任务生命周期由 Agent编排 验收，硬件事实由 硬件池 验收，evidence/aggregate 由 HarnessRL 验收，发布/入口健康由 平台运维 验收。
当前状态
- L2 编号和主责边界已固定；下级执行时按本表创建 L2/L3 issue，不再以单个页面、组件、测试脚本或框架迁移作为替代 L2。
- 当前优先收口 Web工作台、CLI/API 一致性、公开入口可用性和公开文档/兼容性，确保 v0.3 多用户与硬件工作流不会继续在客户端层分叉。