Merge pull request #2711 from pikasTech/docs/hwpod-l0-host-local-boundary
Pipelines as Code CI / hwlab-web-probe-sentinel-nc01- Success
Pipelines as Code CI / platform-infra-gitea-nc01- Success
Pipelines as Code CI / unidesk-host- Success

docs(hwpod): 固化 L0 host 本地边界
This commit is contained in:
Lyon
2026-07-21 07:42:59 +08:00
committed by GitHub
2 changed files with 12 additions and 0 deletions
+6
View File
@@ -29,6 +29,12 @@ description: >-
- 不启动 API、Worker、Temporal、Web 或 Kubernetes workload。
- 用项目 CLI 直接调用 native function、dispatcher、repository 或本地执行器。
- L0 只访问当前 host 可见的本地文件系统和进程:
- `--local` 不提供跨 host 路由,也不把 owning spec 中的远端绝对路径映射到
当前 host
- 跨 host spec 在 L0 只验证 compiler/plan 合同,真实 workspace、build 和硬件
操作使用目标 host 的 L1 native API
- L0 文件副作用使用当前 host 的 disposable fixture 或本地 workspace 验证。
- 单个微服务内部、不启动服务进程且不跨服务通信的单元测试和组件测试属于 L0。
- 适合函数逻辑、配置解析、数据转换、领域服务、微服务内部单元和本地文件操作的快速开发。
- 只加载当前功能需要的本地依赖。
+6
View File
@@ -115,6 +115,12 @@ HWLAB v0.2/v0.3 仓库内 `docs/reference/spec-*`,以及已收编的 `cloud-wo
- 公网入口与 public-edge 是独立可选检查;
- 不得成为 L1 启动、执行或完成条件;
- HWPOD Web 无业务登录页时,由 owning YAML profile 声明 `authentication: none`,不得改用临时 Playwright 脚本或弱化浏览器错误断言。
- HWPOD L0 与 L1 的 host 边界:
- L0 `--local` 直接执行当前 host 的 function 和文件系统,不提供跨 host 路由;
- 跨 host 的 Windows spec 在 API host 做 L0 时,只比较 compiler/plan 合同;
- 真实 Windows workspace、Keil build 和硬件操作必须通过 API host 上的 L1
native API 路由到目标 HWPOD-NODE
- L0 workspace 和 bounded build 使用当前 host 的 disposable fixture 验证。
- Windows HWPOD-NODE 的连接入口和制品入口属于不同合同:
- WebSocket 注册入口来自节点 YAML 的桌面连接配置;
- 更新元数据和 Python 制品下载入口来自同一节点 YAML graph 的 artifact 配置;