修复移动端顶栏折行与头像裁剪弹窗被底部主菜单遮挡

- 主站顶栏在所有断点保持单行：去掉顶栏与动作区的 flex-wrap，品牌和下载、泥点、账户入口不再折成两行
- 窄屏（<640px）下载入口收起为 44×44 图标按钮，保留 aria-label/title，≥640px 恢复「下载客户端」完整文案
- 窄屏（<480px）顶栏品牌只保留 IP 标识，让出空间给下载、泥点与账户入口，并收紧窄屏动作区间距
- 头像裁剪弹窗去掉 portal={false}，改由 UnifiedModal 默认 portal 渲染到 document.body
- 个人中心两级弹窗壳层同步去掉 portal={false}，昵称等个人中心弹窗一并回到页面级层级
- 弹窗不再受 .platform-desktop-layout 的 z-index:1 stacking context 限制，层级高于固定底部主菜单（z-index:60）
- 共享记忆补记单行顶栏口径与「内联弹窗被固定底栏压住」的排障经验

docs/project-memory/shared-memory/decision-log.md

@@ -9578,3 +9578,11 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 - 验证：`cargo test -p module-runtime --lib agc_models::`（4 passed）、`cargo test -p api-server --bin api-server agc` 与 `llm::`、AGC 客户端 `configuration::`、admin-web 页面定向 Vitest 与 typecheck、两套 workspace 的 `cargo fmt -- --check`、`check:encoding`/`check:doc-index`/`check:spacetime-schema`/`git diff --check`。
 - 验证（真实上游 smoke，本地 dev DB）：清空 `agc_model_catalog` 后启动 api-server → 日志 `已按上游模型列表初始化 AGC 模型目录 revision=1 model_count=6`；登录后 `GET /api/llm/models` 返回同一批模型、`displayName` 即上游原名、默认项为排序后第一项；上游不可达/非 2xx 时启动只记录 error、AGC 接口 `503` 且目录保持未初始化；目录已存在时重启不重写。
 - 边界（未验证/残留）：上游在售模型超过 32 条时同步会失败（目录项上限未改）；`qwen-image-3.0` 这类图像模型会一起进入目录，是否对 AGC 隐藏由 owner 在后台停用；混合版本期间未升级的 api-server 会把自己的 AGC 接口打到 `503`，module 与 api-server 必须同批发布/回滚。
+
+## 2026-09-24 移动端主站顶栏收成单行、个人中心弹窗统一走页面级 portal
+
+- 背景：移动端主站（`PlatformEntryActiveFlowShell` 工作台壳层）顶栏在 `e3682fd06` 加入「下载客户端」后，`flex-wrap` 让品牌与下载/泥点/账户入口折成两行；同一壳层里 `.platform-desktop-layout` 带 `z-index: 1` 形成 stacking context，把 `portal={false}` 的弹窗封在这个 context 内，低于 `z-index: 60` 的固定底部主菜单——头像裁剪弹窗的「取消 / 上传」正好被「游戏 / 我的」压住点不到。
+- 决策（顶栏）：顶栏在所有断点都保持单行（`flex-nowrap`），窄屏靠两个降级点让位：`< 640px` 下载入口收起为 44×44 图标按钮（保留 `aria-label="下载客户端"`），`< 480px` 顶栏品牌只留 IP 标识（`platform-desktop-topbar__brand` 内隐藏 `platform-brand-logo__copy`）。品牌字标、下载文案的完整形态在 `>= 640px` / `>= 480px` 恢复，桌面端外观不变。
+- 决策（弹窗层级）：个人中心的独立弹窗（`SquareImageCropModal`、`PlatformProfileModalShell` 两个壳层）改回 `UnifiedModal` 默认的页面级 portal（挂到 `document.body`），不再用 `portal={false}` 内联渲染；层级由现有 `z-[80]` 决定，仍在鉴权 / 法务 / 预览等 `z-[110]` 以上弹窗之下。`PlatformStatusDialog` 保持内联（承载运行态内嵌遮罩，不在本次范围）。
+- 影响范围：`src/components/platform-entry/PlatformEntryActiveFlowShell.tsx`、`src/components/creation-home/ClientDownloadEntry.tsx`、`src/components/common/SquareImageCropModal.tsx`、`src/components/platform-entry/PlatformProfileModalShell.tsx`、`src/index.css`。
+- 验证：本地 Vite + Chromium 真机尺寸复核（320/360/375/390/414/480/639/640/768/1024）：顶栏在 320–768 全部单行、右侧留白 16px；弹窗内「上传 / 保存」`elementFromPoint` 命中自身而非底部菜单，overlay 父节点为 `BODY`。定向 Vitest（`ClientDownloadEntry`、`PlatformProfileModalShell`、`PlatformActiveProfileView`、`PlatformEntryActiveFlowShell`、`UnifiedModalPortalTheme`）与 `prettier --check`、`eslint`、`tsc`、`check:encoding` 通过。

docs/project-memory/shared-memory/pitfalls.md

@@ -6000,3 +6000,12 @@ Cocos Creator 根目录由 `package.json.creator.version` 与普通 `assets/`
 - **原因**：本地乐观用户气泡已删（ADR「DirectProject命令接单化」后续更新 2026-09-24）。用户气泡的唯一来源是宿主下发的开口条目（发点＝接单成立 + 用户条目落盘成功 + 起 codex 之前）。删它的收益是"回合归属只认身份"不再需要给本地消息一份同名身份，投影也少一个展示态（`awaiting-start`）。
 - **排查提示**：窗口期不要拿"有没有本地气泡"当发送成功的证据；证据是 `invoke` 返回 `Ok`（接单成立）与随后到达的 `turn.started` / 开口条目。显示时间与耗时也全以宿主事件为准：起点 `turn.started.at`、终点 `turn.completed.at`；重进项目读回来的历史回合两边都空，整条「本轮结束于 … 」直接隐藏（不再出现 0.0 秒）。
 - **关联**：`apps/ai-game-creator-shell/src/view/project-development/chat/conversation/directTurnPresentation.ts`、`.../chat/controller/useDirectProjectChatController.ts`、`.../chat/components/DirectProjectConversation/DirectProjectTurn.tsx`、`docs/adr/【ADR】DirectProject命令接单化-2026-09-23.md`。
+
+## 2026-09-24 移动端固定底部菜单会压住「内联」弹窗：`z-index` 高也点不到
+
+- **现象**：手机端主站从头像入口上传头像，裁剪弹窗的「取消 / 上传」被底部「游戏 / 我的」菜单盖住，点按钮命中底部菜单；弹窗遮罩、面板本身都正常渲染，只有底部一条区域失去交互。
+- **原因**：`.platform-desktop-shell--workbench .platform-desktop-layout` 带 `position: relative; z-index: 1`，**自成一个 stacking context**。底部主菜单（`.platform-mobile-bottom-dock`，`z-index: 60`）是 layout 的兄弟节点，而弹窗用 `portal={false}` 内联渲染在 layout 内部——弹窗自己的 `z-[80]` 只在 layout 的局部层叠里比较，整体被限制在 `z-index: 1` 之上、`z-index: 60` 之下。**在祖先 stacking context 内抬高子元素 `z-index` 无效，必须让弹窗跳出该 context**。
+- **处理（现行口径）**：独立弹窗一律走 `UnifiedModal` 默认的页面级 portal（挂 `document.body`），不要用 `portal={false}` 内联渲染。目前只剩 `PlatformStatusDialog` 保留内联（运行态内嵌遮罩，且它渲染位置本就在 layout 之外）。
+- **同时**：主站顶栏（`platform-desktop-topbar`）在窄屏必须保持单行——加 `flex-wrap` 后新增一个动作入口就会让品牌折到第二行；窄屏降级靠 `< 640px` 图标化下载入口、`< 480px` 只留品牌 IP 标识。
+- **验证**：真机尺寸下用 `document.elementFromPoint(按钮中心)` 断言命中的是按钮自身而不是底部菜单（`overlay.parentElement === document.body`）；顶栏断点矩阵（320–768）断言单行且无横向溢出。
+- **关联**：`src/components/common/SquareImageCropModal.tsx`、`src/components/platform-entry/PlatformProfileModalShell.tsx`、`src/components/platform-entry/PlatformEntryActiveFlowShell.tsx`、`src/index.css`。

src/components/common/SquareImageCropModal.tsx

@@ -319,7 +319,6 @@ export function SquareImageCropModal({
       closeLabel={labels.close}
       closeVariant="profileCompact"
       closeIcon="×"
-      portal={false}
       zIndexClassName="z-[80]"
       panelClassName="platform-remap-surface max-w-sm rounded-[1.4rem]"
       headerClassName="border-white/10 px-5 py-4"

src/components/creation-home/ClientDownloadEntry.tsx

@@ -75,14 +75,16 @@ export function ClientDownloadEntry() {
         tone="secondary"
         size="sm"
         shape="pill"
-        className="min-h-11 shrink-0 whitespace-nowrap"
+        aria-label="下载客户端"
+        title="下载客户端"
+        className="min-h-11 shrink-0 gap-0 whitespace-nowrap max-sm:h-11 max-sm:w-11 max-sm:px-0 sm:gap-2 sm:px-4"
         onClick={() => {
           setState({ status: 'loading' });
           setOpen(true);
         }}
       >
-        <Download className="h-4 w-4" aria-hidden="true" />
-        下载客户端
+        <Download className="h-4 w-4 shrink-0" aria-hidden="true" />
+        <span className="hidden sm:inline">下载客户端</span>
       </PlatformActionButton>
       <UnifiedModal
         open={open}

src/components/platform-entry/PlatformEntryActiveFlowShell.tsx

@@ -618,8 +618,8 @@ export function PlatformEntryFlowShellImpl({
             </aside>
 
             <div className="platform-desktop-main flex min-w-0 flex-1 flex-col">
-              <header className="platform-desktop-topbar flex min-h-16 shrink-0 flex-wrap items-center justify-between gap-1 gap-y-2 px-4 py-2 sm:flex-nowrap sm:gap-3 sm:px-6 sm:py-0">
-                <div className="min-w-0 shrink-0 lg:hidden">
+              <header className="platform-desktop-topbar flex min-h-16 shrink-0 flex-nowrap items-center justify-between gap-1 px-4 py-2 sm:gap-3 sm:px-6 sm:py-0">
+                <div className="platform-desktop-topbar__brand min-w-0 shrink-0 lg:hidden">
                   <ActivePlatformBrand />
                 </div>
                 <div className="platform-desktop-topbar__brand-search hidden min-w-0 flex-1 items-center lg:flex">
@@ -662,7 +662,7 @@ export function PlatformEntryFlowShellImpl({
                   </form>
                 </div>
 
-                <div className="platform-desktop-topbar__actions flex max-w-full shrink-0 flex-wrap items-center gap-1 sm:flex-nowrap sm:gap-2 lg:gap-3">
+                <div className="platform-desktop-topbar__actions flex min-w-0 shrink-0 items-center gap-1 sm:gap-2 lg:gap-3">
                   <ClientDownloadEntry />
                   {isAuthenticated ? (
                     <PlatformMudPointWalletEntry

src/components/platform-entry/PlatformProfileModalShell.tsx

@@ -84,7 +84,6 @@ export function PlatformProfileModalShell({
       showCloseButton={showCloseButton}
       closeOnBackdrop={false}
       closeOnEscape={false}
-      portal={false}
       size={size}
       zIndexClassName={zIndexClassName}
       overlayClassName={PROFILE_MODAL_OVERLAY_CLASS}
@@ -128,7 +127,6 @@ export function PlatformProfileSecondaryModalShell({
       showCloseButton={false}
       closeOnBackdrop={false}
       closeOnEscape={false}
-      portal={false}
       size={size}
       zIndexClassName={zIndexClassName}
       overlayClassName={

src/index.css

@@ -12626,6 +12626,22 @@ button.image-canvas-editor__reference-chip:disabled {
     min-width: 0;
     padding-inline: 0.12rem;
   }
+
+  .platform-desktop-shell--workbench
+    .platform-desktop-topbar
+    .platform-desktop-topbar__actions {
+    gap: 0.38rem !important;
+  }
+}
+
+/* 窄屏顶栏必须保持单行：品牌只保留 IP 标识，字标让位给下载、泥点与账户入口。 */
+@media (max-width: 479px) {
+  .platform-desktop-shell--workbench
+    .platform-desktop-topbar
+    .platform-desktop-topbar__brand
+    .platform-brand-logo__copy {
+    display: none;
+  }
 }
 
 .platform-desktop-shell--workbench .platform-desktop-rail {