diff --git a/.agents/skills/unidesk-devlevel/SKILL.md b/.agents/skills/unidesk-devlevel/SKILL.md index 097e7068..e884844d 100644 --- a/.agents/skills/unidesk-devlevel/SKILL.md +++ b/.agents/skills/unidesk-devlevel/SKILL.md @@ -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。 - 适合函数逻辑、配置解析、数据转换、领域服务、微服务内部单元和本地文件操作的快速开发。 - 只加载当前功能需要的本地依赖。 diff --git a/docs/reference/hwlab.md b/docs/reference/hwlab.md index f9bf7ed4..a6f293b3 100644 --- a/docs/reference/hwlab.md +++ b/docs/reference/hwlab.md @@ -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 配置;