# Device Pod 参考入口

本文保留为旧链接兼容入口。HWLAB `v0.2` 正式 `device-pod` 接入规格以 [spec-device-pod.md](spec-device-pod.md) 为权威。

关键口径：

- `device-pod` 是逻辑设备能力单元，不是 Kubernetes Pod name。
- profile 定义 `device-pod`，因此正式接入后 profile 必须由 `admin` 和 `cloud-api` 服务端权威管理。
- code agent 本地 `.device-pod/` profile 只属于早期 CLI MVP 闭环；正式多用户系统中不得作为路由、授权或硬件资源边界的 source of truth。
- v0.2 第一阶段使用一个 `hwlab-device-pod` Deployment/Service 管理多个逻辑 `devicePodId`，避免过早引入 per-device k8s workload 运维压力。
- 正式访问路径是 `device-pod-cli/cloud-web -> cloud-api -> hwlab-device-pod -> gateway -> device-host-cli -> target`。

迁移计划见 [../plan/v02-device-pod-spec-migration.md](../plan/v02-device-pod-spec-migration.md)。历史 CLI MVP 闭环见 [../plan/device-pod-cli-mvp.md](../plan/device-pod-cli-mvp.md)，但其中本地 profile 权威口径不适用于正式 v0.2 多用户接入。