diff --git a/project-management/PJ2026-01/specs/PJ2026-010101-hwpod-standard.md b/project-management/PJ2026-01/specs/PJ2026-010101-hwpod-standard.md index 5fbaa95d..ba6599cf 100644 --- a/project-management/PJ2026-01/specs/PJ2026-010101-hwpod-standard.md +++ b/project-management/PJ2026-01/specs/PJ2026-010101-hwpod-standard.md @@ -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 范围内 diff --git a/project-management/PJ2026-01/specs/PJ2026-010102-hwpod-tools.md b/project-management/PJ2026-01/specs/PJ2026-010102-hwpod-tools.md index 4a17e363..3512b8d5 100644 --- a/project-management/PJ2026-01/specs/PJ2026-010102-hwpod-tools.md +++ b/project-management/PJ2026-01/specs/PJ2026-010102-hwpod-tools.md @@ -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 范围内 diff --git a/project-management/PJ2026-01/specs/PJ2026-010103-hwpod-service.md b/project-management/PJ2026-01/specs/PJ2026-010103-hwpod-service.md index d90c2094..faf0f406 100644 --- a/project-management/PJ2026-01/specs/PJ2026-010103-hwpod-service.md +++ b/project-management/PJ2026-01/specs/PJ2026-010103-hwpod-service.md @@ -31,7 +31,7 @@ HWPOD服务负责服务端资源注册、健康、租约、占用释放、权限交接、请求接收、节点路由和结果归属，使 HWPOD 工具和上层任务能通过服务端 authority 访问真实硬件资源。 -当前实现已经具备部分 HWPOD runtime API、registry 查询和节点转发路径，但仍需要把缺失资源声明、错误 HWPOD 复用、节点路由失败和板侧协议失败清晰暴露。本课题的预期状态是：服务端只路由已声明、可用、已授权且租约一致的资源，并把每次操作结果归属到明确 HWPOD、node、租约和调用方。 +本课题的目标状态是：服务端只路由已声明、可用、已授权且租约一致的资源，并把每次操作结果归属到明确 HWPOD、node、租约和调用方。 ### 2.2 范围内 diff --git a/project-management/PJ2026-01/specs/PJ2026-010104-ai-gateway.md b/project-management/PJ2026-01/specs/PJ2026-010104-ai-gateway.md index 2052f025..13f7e94e 100644 --- a/project-management/PJ2026-01/specs/PJ2026-010104-ai-gateway.md +++ b/project-management/PJ2026-01/specs/PJ2026-010104-ai-gateway.md @@ -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 原始硬件事实回传