我最早写这些内容，不是为了整理一套 SDK 文档，而是想把自己已经跑在 Docker Compose 里的应用搬进懒猫商店。真正开始做，才发现打包只是第一步，后面还有路由、权限、登录、调试和证书。

开发篇从应用包的基本结构开始，接着处理 Devshell、现有 Compose 项目和纯前端项目的移植。应用真正进入构建阶段后，还会遇到 Apple 芯片上的多架构镜像、懒猫镜像仓库和 Compose Override。

OIDC 分成上下两篇，再补上本地开发环境的接入过程，因为只有把授权跳转、回调、Token 和用户信息走一遍，单点登录才不是一句配置说明。后面的 OpenResty 和自签名 SSL，则是应用真的跑起来之后遇到的路由问题。

这部分记录的是我验证过的路径，不替代官方文档。Manifest 字段、构建工具和商店规则可能调整，照着做之前最好再对照当前文档；但从项目到镜像、从镜像到应用包，再到路由和认证的思路，仍然可以复用。