docs: 移除硬件池 L2 现状表述

2026-06-14 20:41:03 +00:00
parent 21a2ee72a8
commit 00b1a91f1e
4 changed files with 7 additions and 7 deletions
@@ -31,7 +31,7 @@

 HWPOD标准负责定义真实硬件资源的身份、四要素、能力声明、状态语义和错误语义，使 HWPOD 工具、服务、AI 网关、Agent 和 HarnessRL 能围绕同一硬件事实执行。

-当前实现已经能表达部分 HWPOD 资源、工具入口和 ioProbe 观测，但仍存在未声明资源、probe 绑定不完整和恢复能力不明确时无法安全执行写操作的情况。本课题的预期状态是：任何可被 CaseRun 或 Agent 写入的真实设备，都必须先拥有明确 HWPOD spec、workspace authority、debug probe 绑定、io probe 绑定、board-comm 端点、恢复能力和可解释错误语义。
+本课题的目标状态是：任何可被 CaseRun 或 Agent 写入的真实设备，都必须先拥有明确 HWPOD spec、workspace authority、debug probe 绑定、io probe 绑定、board-comm 端点、恢复能力和可解释错误语义。

 ### 2.2 范围内

@@ -31,7 +31,7 @@

 HWPOD工具负责把 HWPOD 标准和服务能力暴露为用户、Agent 和 CaseRun 可调用的原入口，使 spec 校验、inspect、build、download、UART、board-comm、ioProbe 和恢复动作都按同一硬件语义执行。

-当前实现已经具备部分 CLI/API 入口和 board-comm/ioProbe 调用链，但仍需要把缺失 spec、错误 probe、服务路由失败、节点协议失败和板侧 JSON-RPC 异常清楚分开。本课题的预期状态是：工具入口不静默切换目标，不把低层连接错误包装成成功，并能为上层 CaseRun 提供稳定、低噪声、可判定的命令结果。
+本课题的目标状态是：工具入口不静默切换目标，不把低层连接或协议错误包装成成功，并能为上层 CaseRun 提供稳定、低噪声、可判定的命令结果。

 ### 2.2 范围内

@@ -31,7 +31,7 @@

 HWPOD服务负责服务端资源注册、健康、租约、占用释放、权限交接、请求接收、节点路由和结果归属，使 HWPOD 工具和上层任务能通过服务端 authority 访问真实硬件资源。

-当前实现已经具备部分 HWPOD runtime API、registry 查询和节点转发路径，但仍需要把缺失资源声明、错误 HWPOD 复用、节点路由失败和板侧协议失败清晰暴露。本课题的预期状态是：服务端只路由已声明、可用、已授权且租约一致的资源，并把每次操作结果归属到明确 HWPOD、node、租约和调用方。
+本课题的目标状态是：服务端只路由已声明、可用、已授权且租约一致的资源，并把每次操作结果归属到明确 HWPOD、node、租约和调用方。

 ### 2.2 范围内

@@ -29,9 +29,9 @@

 ### 2.1 目的

-AI网关负责靠近真实硬件执行受控动作并回传原始硬件事实，使 HWPOD 服务能够触达 PC 侧工具、debug probe、board-comm、ioProbe、UART、CANopen、电压、电流和频率等实际设备能力。
+AI网关负责靠近真实硬件执行受控动作并回传原始硬件事实，使 HWPOD 服务能够触达 PC 侧工具、debug probe、board-comm、ioProbe、UART、CANopen、电压、电流和频率等设备能力。

-当前实现已经能通过节点侧工具触达部分真实板卡和观测链路，但仍存在部分目标 TCP 可达后 JSON-RPC 请求被板侧复位、缺少独立 HWPOD spec/reset/debugProbe 绑定、以及真实频率源写入链路未闭合的情况。本课题的预期状态是：节点能先完成只读连通与身份确认，再按声明能力执行写操作，并在失败时返回可区分的节点、协议、板侧处理或安全恢复错误。
+本课题的目标状态是：节点先完成只读连通与身份确认，再按声明能力执行写操作，并在失败时返回可区分的节点、协议、板侧处理或安全恢复错误。

 ### 2.2 范围内

@@ -54,7 +54,7 @@ AI网关负责靠近真实硬件执行受控动作并回传原始硬件事实，
 | --- | --- |
 | AI 网关 | 靠近真实硬件的节点侧执行能力，包含 PC 客户端、硬件网关盒子或等价 HWPOD node。 |
 | adapter | 网关侧执行某类硬件动作的适配器，例如 debug probe、UART、board-comm、ioProbe 或 CANopen。 |
-| board-comm | 通过板侧通信协议访问目标固件接口的能力，当前包含 JSON-RPC over TCP 等形态。 |
+| board-comm | 通过板侧通信协议访问目标固件接口的能力，可包含 JSON-RPC over TCP 等形态。 |
 | CANopen SDO | 通过 CANopen Service Data Object 读写设备对象字典的协议动作。 |
 | 安全恢复 | 在写操作前后把真实设备恢复到可继续使用状态的 reset、重新连接或清理输出能力。 |
 | 原始硬件事实 | 由节点直接观测或执行得到的协议响应、板外读数、probe 结果和错误语义。 |
@@ -111,7 +111,7 @@ AI网关应按 HWPOD spec 声明执行 debug、download、reset、UART、board-c

 AI网关应在写操作前后提供只读诊断、身份确认、reset 和安全恢复能力，使真实硬件不会在目标不明或恢复入口缺失时被继续写入。

-安全恢复必须绑定明确 debug probe、设备和 reset 能力。无法确认 probe 属于目标设备、板侧通信在接收请求后复位、或恢复命令只是空实现时，网关应返回受控失败并停止后续写操作。
+安全恢复必须绑定明确 debug probe、设备和 reset 能力。无法确认 probe 属于目标设备、恢复能力不可用或恢复结果不可判定时，网关应返回受控失败并停止后续写操作。

 ### 6.4 HWPOD-GW-REQ-004 原始硬件事实回传