portal-micro-app · 嵌入式微应用（iframe + SDK）开发

微应用是被 Portal 以沙箱 iframe 嵌入的普通 Web 页面：不自己实现登录、不持有 App Secret，身份由宿主经 postMessage 握手注入。本文件是工作流与红线；具体契约按需读 references/（为本 skill 提炼的自包含参考，可整目录拷到任何 repo 使用；权威源是门户仓库 docs/SSO与App开发指引.md，冲突以门户仓库为准）。

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

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

按任务读参考