fix(codex): keep multirouter wizard within small windows

Root cause: the Codex MultiRouter wizard constrained only the middle grid to 82vh while the header and footer were outside that limit. On the default 1000x650 / minimum 900x600 Tauri window the sum of header + 82vh + footer could exceed the viewport, so the bottom actions were clipped even though the wizard state was correct.

Fix: make the overlay a bounded flex container, give the wizard shell max-h-full/min-h-0 flex-column layout, keep header and footer shrink-0, and let the middle body fill remaining height with independent scrolling for content and the step list.

Tests: add a layout regression assertion for the shell/body/footer constraints, run CodexMultiRouterWizard Vitest, typecheck, renderer build, and git diff whitespace check. Record the debugging note in root memory.md.

Author: BigStrongSun

memory.md

@@ -1,5 +1,11 @@
 # CC Switch Repository Memory
 
+## 2026-06-30 Codex MultiRouter Wizard Small Window Layout Fix
+
+- 用户截图显示 Codex MultiRouter 向导在较小窗口、尤其接近 Tauri 默认 `1000x650` / 最小 `900x600` 时底部按钮区被裁掉。根因不是向导状态机或步骤跳转，而是 `CodexMultiRouterWizard` 中间 grid 使用 `max-h-[82vh]`，但外层没有整体高度约束，最终高度约等于 header + `82vh` + footer，默认高度下会超过视口。
+- 修复边界：只调整 `src/components/codex/CodexMultiRouterWizard.tsx` 的遮罩弹窗布局。外层 overlay 改成 flex 居中并 `overflow-hidden`，向导 shell 改为 `max-h-full flex flex-col min-h-0`，header/footer `shrink-0`，中间 body `flex-1 min-h-0 overflow-hidden`，右侧内容和左侧步骤栏各自滚动。不要通过单纯提高 `tauri.conf.json` 默认窗口高度来掩盖问题，因为用户仍可能缩小窗口或恢复旧窗口状态。
+- 回归测试落点：`tests/components/CodexMultiRouterWizard.test.tsx` 断言向导 shell/body/footer 的关键布局类，避免后续把高度约束重新放回 `82vh` 内容区。验证命令：`pnpm vitest run tests/components/CodexMultiRouterWizard.test.tsx`、`pnpm typecheck`、`pnpm build:renderer`、`git diff --check`。浏览器直接打开 Vite renderer 会因缺少 Tauri IPC 出现 `window.__TAURI__` 相关错误，只能作为有限页面加载检查；完整交互仍以 Tauri 桌面或组件测试为准。
+
 ## 2026-06-30 Codex MultiRouter Post-Setup Validation Refresh
 
 - 用户追问“配置完返回的校验和刷新流程”，排查范围仍只限 Codex MultiRouter。现有成功判定已经正确：`StatusTab` 只在本地代理运行、Codex 接管、当前 provider 是选中 MultiRouter、入口/规则启用，并且当前方案 route 有真实成功转发证据时才触发 `onRuntimeReady`，不会因为其它 Codex 请求 200 就提前进入历史修复。

src/components/codex/CodexMultiRouterWizard.tsx

@@ -1043,9 +1043,15 @@ export function CodexMultiRouterWizard({
     []) as CodexCatalogModel[];
 
   return createPortal(
-    <div className="fixed inset-0 z-[120] bg-black/70 text-foreground backdrop-blur-sm">
-      <div className="absolute inset-x-3 top-4 mx-auto w-[min(96vw,1280px)] rounded-lg border border-white/15 bg-background shadow-2xl">
-        <div className="flex items-start justify-between border-b px-5 py-4">
+    <div className="fixed inset-0 z-[120] flex items-center justify-center overflow-hidden bg-black/70 p-3 text-foreground backdrop-blur-sm sm:p-4">
+      <div
+        role="dialog"
+        aria-modal="true"
+        aria-labelledby="codex-multirouter-wizard-title"
+        data-testid="codex-multirouter-wizard-shell"
+        className="flex max-h-full w-[min(96vw,1280px)] min-h-0 flex-col rounded-lg border border-white/15 bg-background shadow-2xl"
+      >
+        <div className="flex shrink-0 items-start justify-between border-b px-5 py-4">
           <div className="flex items-start gap-3">
             <div className="rounded-md bg-primary/10 p-2 text-primary">
               <CurrentStepIcon className="h-5 w-5" />
@@ -1054,7 +1060,12 @@ export function CodexMultiRouterWizard({
               <div className="text-sm text-muted-foreground">
                 第 {stepIndex + 1} / {STEPS.length} 步
               </div>
-              <h2 className="text-xl font-semibold">{currentStep.title}</h2>
+              <h2
+                id="codex-multirouter-wizard-title"
+                className="text-xl font-semibold"
+              >
+                {currentStep.title}
+              </h2>
               <p className="mt-1 text-sm text-muted-foreground">
                 {currentStep.description}
               </p>
@@ -1070,8 +1081,11 @@ export function CodexMultiRouterWizard({
           </Button>
         </div>
 
-        <div className="grid max-h-[82vh] grid-cols-[15rem_minmax(0,1fr)] overflow-hidden">
-          <div className="space-y-1 border-r bg-muted/30 p-3">
+        <div
+          data-testid="codex-multirouter-wizard-body"
+          className="grid min-h-0 flex-1 grid-cols-[15rem_minmax(0,1fr)] overflow-hidden"
+        >
+          <div className="space-y-1 overflow-y-auto border-r bg-muted/30 p-3">
             {STEPS.map((step, index) => {
               const StepIcon = step.icon;
               return (
@@ -1094,7 +1108,7 @@ export function CodexMultiRouterWizard({
             })}
           </div>
 
-          <div className="overflow-y-auto p-5">
+          <div className="min-h-0 overflow-y-auto p-5">
             <div className="mb-4 rounded-lg border bg-muted/30 p-3 text-sm">
               <div className="flex flex-wrap items-center gap-2">
                 <Badge variant="outline">状态机：{flowState.status}</Badge>
@@ -1529,7 +1543,7 @@ export function CodexMultiRouterWizard({
           </DialogContent>
         </Dialog>
 
-        <div className="flex items-center justify-between border-t px-5 py-4">
+        <div className="flex shrink-0 items-center justify-between border-t px-5 py-4">
           <Button variant="ghost" onClick={() => closeWizard(true)}>
             跳过
           </Button>

tests/components/CodexMultiRouterWizard.test.tsx

@@ -74,6 +74,28 @@ describe("CodexMultiRouterWizard", () => {
     ).toBeInTheDocument();
   });
 
+  it("keeps the wizard controls inside small app windows", () => {
+    renderWithQueryClient(
+      <CodexMultiRouterWizard
+        open
+        providers={[provider()]}
+        onOpenChange={vi.fn()}
+        onCreateProvider={vi.fn()}
+        onOpenWorkspace={vi.fn()}
+        onEnablePlan={vi.fn()}
+      />,
+    );
+
+    const shell = screen.getByTestId("codex-multirouter-wizard-shell");
+    const body = screen.getByTestId("codex-multirouter-wizard-body");
+    const footer = screen.getByRole("button", { name: "下一步" })
+      .parentElement?.parentElement;
+
+    expect(shell).toHaveClass("flex", "max-h-full", "flex-col");
+    expect(body).toHaveClass("min-h-0", "flex-1", "overflow-hidden");
+    expect(footer).toHaveClass("shrink-0");
+  });
+
   it("opens, navigates steps, and stores dismissed flag when skipped", () => {
     const onOpenChange = vi.fn();