pikasTech-HWLAB/docs/reference/device-pod.md

Device Pod 参考入口

本文保留为旧链接兼容入口。HWLAB v0.2 正式 device-pod 接入规格以 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。

实施跟踪见 pikasTech/HWLAB#533。旧迁移计划和 CLI MVP 闭环全文已迁入该 issue 评论；其中本地 profile 权威口径不适用于正式 v0.2 多用户接入。