portal-external-app · 外部镜像服务类应用接入

外部镜像 App = 服务端在别的 repo（任意语言/栈）、独立镜像交付、常驻（不走按需缩零）。鉴权与业务 API 遵循门户运行时契约；/health 支持平铺 JSON 与 Envelope，检测规则与平台运行时一致。本文件是判断与流程；具体契约按需读 references/（为本 skill 提炼的自包含参考，可整目录拷到外部团队 repo；权威源是门户仓库 docs/，冲突以门户仓库为准）。

路径约定（先读这条，能省一次白找）：本 skill 里出现的 apps/… packages/… docs/… deploy/… 这类路径都在门户仓。在 App 自己的 repo 里它们不存在 —— 它们标注的是 「门户侧要做什么」或某段内容的出处，不是让你去打开的文件。找不到不是配置错误： 别去创建、别去全局搜、别把它当缺失依赖报出来。你需要的一切都在本 skill 的 references/（自包含）。若你正在门户仓里工作，那这些路径就是可以直接打开的真实文件。

⚠️ 一个例外：/apps/<key>/（带前导斜杠）是线上 URL 路径——微应用产物的挂载点， 与仓内的 apps/<key>-app/ 目录无关，别混。

按任务读参考