重做GameAgent单窗口首页

登录后直接进入单窗口客户端首页并保留兼容命令

首页支持做游戏做素材做方案切换、附件队列和目录创建流程

项目组和项目开发占位改为同窗口切换并保存首条需求

顶部泥点充值合并展示，账户帮助配置回到底部侧栏

补充账户泥点精选素材读取与首页项目视觉测试

同步AI游戏创作实施文档、决策记录和上下文术语

CONTEXT.md

@@ -16,6 +16,10 @@ _Avoid_: 在玩法页面内手写上传、参考图、重绘、预览、删除
 独立 `/editor` 中可保存、恢复和继续编辑的图片画布工作状态，包含画布视图、图层布局和资源引用；用于多图对比、生成结果衍生和画布级编辑，不替代玩法页面内的单图资产编辑。
 _Avoid_: 玩法结果页单图槽位、发布态作品、只存在前端内存里的临时画布
 
+**项目开发画布**:
+GameAgent 独立客户端中某个本地游戏项目的开发工作区概念，用于承载项目名、路径、首条需求、附件导入结果、最近 run 状态，以及后续真正的项目开发画布与 Agent 协作界面；当前首页改造阶段先落占位页。它属于 AI 游戏创作本地项目域，不等同于 `/editor` 的图片画布工程。
+_Avoid_: `/editor` 图片画布工程、画布资源 / 图层布局、启动器 / 主窗口切换概念、只用于首页输入的临时草稿
+
 **画布Agent对话**:
 图片画布工程右侧的对话式编辑器工具，用户通过自然语言调度画布已有的图片类生成与编辑能力（生成图片、生成角色形象、生成图标素材、生成 UI 设计图、基于附件的图片修改），并可附加画布素材或素材库图片作为参考；对话归属单个图片画布工程，可保存历史、新开会话和软删会话。属于画布域工具，不承接玩法创作、不产出玩法作品或模板，与「表单/图片输入创作工作台」的 Avoid 边界不冲突。
 _Avoid_: 对话式玩法创作工作台、绕过模型定价收口的生成入口、把对话消息当作画布布局真相、复用拼图专用 creative-agent 内存会话

apps/ai-game-creator-shell/scripts/check-config.mjs

@@ -48,7 +48,10 @@ const rustSharedContractSource = fs.readFileSync(
   ),
   'utf8',
 );
-const allowedUncalledTauriCommands = [];
+const allowedUncalledTauriCommands = [
+  'open_game_creator_launcher_window',
+  'open_game_creator_workspace_window',
+];
 const sourceExtensions = new Set([
   '.json',
   '.md',
@@ -380,11 +383,11 @@ if (tauriConfig.app?.withGlobalTauri !== true) {
 if (
   !Array.isArray(tauriConfig.app?.windows) ||
   tauriConfig.app.windows.length !== 1 ||
-  tauriConfig.app.windows[0]?.label !== 'launcher' ||
+  tauriConfig.app.windows[0]?.label !== 'client' ||
-  tauriConfig.app.windows[0]?.url !== 'index.html?launcher'
+  tauriConfig.app.windows[0]?.url !== 'index.html'
 ) {
   throw new Error(
-    'AI game creator shell must start with only the launcher window',
+    'AI game creator shell must start with only the client window',
   );
 }
 
@@ -409,22 +412,22 @@ if (
 const windows = tauriConfig.app?.windows ?? [];
 if (
   windows.length !== 1 ||
-  windows[0]?.label !== 'launcher' ||
+  windows[0]?.label !== 'client' ||
-  windows[0]?.url !== 'index.html?launcher'
+  windows[0]?.url !== 'index.html'
 ) {
   throw new Error(
-    'AI game creator shell release config must expose only the launcher window',
+    'AI game creator shell release config must expose only the client window',
   );
 }
 
-const launcherWindow = windows[0];
+const clientWindow = windows[0];
 if (
-  launcherWindow.width !== 820 ||
+  clientWindow.width !== 820 ||
-  launcherWindow.height !== 640 ||
+  clientWindow.height !== 640 ||
-  launcherWindow.minWidth !== 720 ||
+  clientWindow.minWidth !== 720 ||
-  launcherWindow.minHeight !== 520
+  clientWindow.minHeight !== 520
 ) {
-  throw new Error('AI game creator shell launcher window must stay compact');
+  throw new Error('AI game creator shell client window must stay compact');
 }
 
 if (tauriConfig.build?.devUrl !== 'http://127.0.0.1:3080/') {

apps/ai-game-creator-shell/src-tauri/tauri.conf.json

@@ -13,9 +13,9 @@
     "withGlobalTauri": true,
     "windows": [
       {
-        "label": "launcher",
+        "label": "client",
         "title": "AI 游戏创作",
-        "url": "index.html?launcher",
+        "url": "index.html",
         "width": 820,
         "height": 640,
         "minWidth": 720,

apps/ai-game-creator-shell/src/main.tsx

@@ -1,26 +1,15 @@
 import React from 'react';
 import { createRoot } from 'react-dom/client';
 
-import { App, AuthenticatedClient, WorkspaceLauncher } from './App';
+import { AuthenticatedClient, WorkspaceLauncher } from './App';
 import './styles.css';
 
-function shouldRenderMainApp() {
-  const params = new URLSearchParams(window.location.search);
-  return (
-    params.has('main') || params.has('dev') || window.location.hash === '#dev'
-  );
-}
-
 createRoot(document.getElementById('root') as HTMLElement).render(
   <React.StrictMode>
     <AuthenticatedClient>
-      {({ user, logout }) =>
+      {({ user, logout }) => (
-        shouldRenderMainApp() ? (
+        <WorkspaceLauncher currentUser={user} onLogout={logout} />
-          <App />
+      )}
-        ) : (
-          <WorkspaceLauncher currentUser={user} onLogout={logout} />
-        )
-      }
     </AuthenticatedClient>
   </React.StrictMode>,
 );

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

@@ -16,6 +16,17 @@
 
 ---
 
+## 2026-07-08 AI 游戏创作 App v1 使用单窗口首页作为普通用户入口
+
+- 背景：GameAgent V1 首页需求把登录后的入口定义为单窗口客户端首页，旧“先选项目再打开主窗口”的启动器概念会让普通用户流程割裂，也不符合首页先输入需求再选择目录创建项目的交互。
+- 决策：普通用户启动 App 后先检查平台登录态，未登录只展示登录页，登录后进入同一个客户端壳。客户端左侧栏和顶部栏常驻，中部在首页、项目组、指南 / 反馈和项目开发占位之间切换；旧 Tauri 窗口 command 只保留兼容，不进入用户主流程。首页支持 `做游戏` / `做素材` / `做方案` 三种模式，发送需求时弹原生目录选择，非空目录必须二次确认；确认后只初始化本地项目、导入附件、追加首条用户需求和接收回执、写最近项目，并切到项目开发占位，不启动真实生成、不调用平台美术生成或 LLM 聊天。
+- 补充：项目组页在同一窗口管理最近项目、打开项目、新建项目和显示目录。打开项目只进入已初始化且 `.agent/manifest.json` 可读的本地项目并切到项目开发占位；无效项目禁用，不自动重建历史路径。首页最近项目最多展示 3 个，空时隐藏。
+- 补充：项目开发占位展示项目名、路径、创建模式、首条需求、附件导入结果、最近 run 状态和后续“项目开发画布”占位；“项目开发画布”是 GameAgent 项目的工作区概念，不等同于 `/editor` 图片画布工程。
+- 补充：首页账户 / 泥点 / 精选素材只读取平台真实接口 `/api/profile/dashboard`、`/api/profile/wallet-ledger` 和 `/api/editor/showcase/resources`；失败时显示轻量空态，不伪造后端未下发字段。
+- 影响范围：`apps/ai-game-creator-shell` 登录后渲染入口、首页 / 项目组 / 项目开发占位 UI、本地项目初始化与附件导入流程、AI 游戏创作 App 实施计划和 `CONTEXT.md`。
+- 验证方式：运行 `npm run test -- apps/ai-game-creator-shell/tests/appSurface.test.ts`、`npm --prefix apps/ai-game-creator-shell run typecheck`、`npm run check:encoding` 和 `git diff --check`。
+- 关联文档：`docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`、`CONTEXT.md`。
+
 ## 2026-07-03 AI 游戏创作 App 本地试玩包导出只打包运行白名单
 
 - 背景：AI 游戏创作 App 需要给普通用户提供首版本地试玩包，但不能把项目记忆、trace、日志、运行时配置或密钥类文件混入可分发 ZIP。
@@ -29,10 +40,10 @@
 
 - 背景：AI 游戏创作 App 已有 Godcoder 式本地工程护栏、项目黑板、角色私有记忆、manifest 和 run trace；新增结构化对话记录、agent 状态列表和单 agent 对话入口时，需要避免引入平行状态源或提前承诺后台 runner 能力。
 - 决策：v1 结构化对话记录统一使用本地 `.agent/conversations/` append-only JSONL。普通聊天写 `.agent/conversations/project.jsonl`；从 agent 状态列表进入单个 agent 后，用户消息、agent 回复、工具建议和错误只写对应 `.agent/conversations/agents/<agentId>.jsonl`。Agent 状态列表从 `.agent/manifest.json` 的任务 / 角色清单和 `.agent/run.latest.json` / `.agent/runs/<runId>.json` 的 step、taskGraph、passPlans、lifecycleStatus 派生，并把 `taskGraph.tasks` 的任务状态与 active / carry-over / ready 编排标记显示在主窗口和单 agent 对话入口中；单 agent 最近证据里的安全相对输入 / 输出路径只填入 `/read <path>` 草稿，仍由用户发送并走既有 `file.read` / `agent.trace_read` 权限流。不新增独立状态数据库。项目黑板和角色私有记忆继续只保存稳定摘要，不承载原始对话流水。
-- 补充：App 启动先进入独立启动器窗口；用户选择工作区后，Tauri 关闭启动器并打开主窗口，主窗口读取该工作区的主 conversation、manifest 和 run trace。启动器“新建项目”先调用 `init_local_game_project` 初始化成功，默认项目名取目标文件夹名，再写最近项目并打开主窗口；遇到非空目录时先弹确认，取消或初始化失败则不打开主窗口、不写最近项目。最近工作区只保存在本机 WebView storage，可单项移除或清空，不进入项目文件或共享记忆；已初始化项目优先显示 manifest 项目名并保留路径副信息，`.agent/run.latest.json` 可读时显示最近 run 状态。最近项目路径缺失、不是目录、缺少可读 `.agent/manifest.json` 或检查失败时禁用打开，刷新只重新执行只读检查；“显示”只用系统文件管理器打开已确认存在的本地目录，未初始化但存在的目录也可显示，避免把历史路径误当新项目重建。
+- 补充：2026-07-08 起普通用户入口改为单窗口客户端首页；旧独立启动器 / 主窗口切换口径废止。首页发送需求或项目组新建项目时，先选择目录并在非空目录时二次确认，初始化成功后写最近项目并切到项目开发占位；取消或初始化失败则不切换视图、不写最近项目。最近工作区只保存在本机 WebView storage，可单项移除或清空，不进入项目文件或共享记忆；已初始化项目优先显示 manifest 项目名并保留路径副信息，`.agent/run.latest.json` 可读时显示最近 run 状态。最近项目路径缺失、不是目录、缺少可读 `.agent/manifest.json` 或检查失败时禁用打开，刷新只重新执行只读检查；“显示”只用系统文件管理器打开已确认存在的本地目录，未初始化但存在的目录也可显示，避免把历史路径误当新项目重建。
-- 补充：主窗口“显示目录”复用同一只读目录打开能力，只打开当前本地项目目录，不初始化项目、不写项目文件、不切换工作区；主窗口头部只读显示 manifest 项目名、项目路径、最近 `.agent/run.latest.json` 的 run 状态摘要和当前预览状态，并通过“刷新状态”重新读取同一 trace，不新增状态数据库。最近项目资产入口只读展示 localPath、kind、mediaType 和 source.kind，点击仍走原 `file.read` 权限流；旁边的“读取命令”只填入 `/read <path>` 草稿，不直接读取文件或绕过权限。主窗口“记到黑板”“覆盖黑板”“清空黑板”只填入项目黑板相关 `/remember`、`/memory-set` 和 `/forget-memory` 草稿，项目黑板写入或删除仍走聊天确认；Agent 状态栏的 output / activity / context bundle 入口也只填入 `/read` 草稿，不直接读取 run 辅助文件；灵感草稿和权限策略快捷入口同样只填入输入框，不提交、不写 `.agent/policy.json`、不调用 LLM。
+- 补充：项目开发占位“显示目录”复用同一只读目录打开能力，只打开当前本地项目目录，不初始化项目、不写项目文件、不切换工作区；顶部只读显示 manifest 项目名、项目路径、最近 `.agent/run.latest.json` 的 run 状态摘要和当前预览状态，并通过“刷新状态”重新读取同一 trace，不新增状态数据库。最近项目资产入口只读展示 localPath、kind、mediaType 和 source.kind，点击仍走原 `file.read` 权限流；旁边的“读取命令”只填入 `/read <path>` 草稿，不直接读取文件或绕过权限。项目开发占位里的项目黑板和 Agent 状态快捷入口仍只填入聊天草稿，不直接读取 run 辅助文件、不写 `.agent/policy.json`、不调用 LLM。
-- 补充：启动器和主窗口共用同一个运行时配置弹窗，配置只读写 Tauri 应用配置目录中的 `game-creator.config.json`，不写入项目文件或对话历史。
+- 补充：首页、项目组和项目开发占位共用同一个运行时配置弹窗，配置只读写 Tauri 应用配置目录中的 `game-creator.config.json`，不写入项目文件或对话历史。
-- 补充：启动器“打开”只进入已初始化且 `.agent/manifest.json` 可读的 AI 游戏项目；路径不存在、不是文件夹或只是普通文件夹时不打开主窗口、不创建目录，用户需要创建或初始化时走“新建项目”。
+- 补充：项目组“打开”只进入已初始化且 `.agent/manifest.json` 可读的 AI 游戏项目；路径不存在、不是文件夹或只是普通文件夹时不切换到项目开发占位、不创建目录，用户需要创建或初始化时走“新建项目”。
 - 影响范围：`apps/ai-game-creator-shell` 的主窗口 agent 状态列表、单 agent 对话入口、本地项目文件结构、共享契约和 AI 游戏创作 App 实施计划。
 - 验证方式：文档更新先运行 `npm run check:encoding` 和 `git diff --check`；后续工程落地时补充壳 typecheck、Tauri Rust 测试和对话 JSONL / 状态派生的定向测试。
 - 关联文档：`docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`。
@@ -4043,9 +4054,9 @@
 - 2026-06-24 调整：普通用户通过聊天输入 `/project /绝对路径` 触发 `project.create` 待确认命令，用于授权并初始化本地项目目录；相对路径不会生成待确认命令；不要把开发窗口项目路径输入框暴露到正式用户界面。
 - 2026-06-25 调整：普通用户侧所有会写入、运行、查看 / 打开预览或导入本地产物的命令必须先完成 `/project` 初始化，包括 `game.generate_draft`、`asset.upload`、`game.run_local`、`command.run_limited`、`preview.start`、`preview.status`、`preview.open`、`preview.stop`、`memory.write`、`memory.delete`、`canvas.project_sync`、`canvas.asset_import` 和 `canvas.export_import`；没有已授权本地项目时只提示设置项目，不得落到默认 `/tmp` 草稿目录。
 - 2026-06-24 调整，2026-06-30 更新：终端测试入口使用同一个 Tauri Rust 二进制的 `--agent-run <本地项目绝对路径> <创作需求>`，只复用现有 `game.generate_draft`、`game.static_smoke` 和本地 HTTP 预览链路，不另建第二套 agent runtime；发布 App 的 LLM 配置从 Tauri 应用配置目录读取，不写入仓库默认配置或项目文件。需要自动验证时可追加 `--no-wait`，生成预览 trace 后立即停止本地预览，避免命令卡在回车等待。
-- 2026-07-04 调整：`apps/ai-game-creator-shell/src-tauri/src/main.rs` 拆成薄入口，继续只保留共享类型 / 常量、模块声明、CLI preflight、`tauri::Builder`、运行时配置初始化和 `invoke_handler` 清单；CLI 参数解析与终端运行输出放入 `cli.rs`，Tauri command 包装放入 `commands.rs`，运行时配置 / LLM 配置检查放入 `config.rs`，Agent loop 与生成编排放入 `agent.rs`，上传 / 画板 / 平台美术生成接入放入 `assets.rs`，本地项目文件、记忆、对话、权限、checkpoint、manifest 和通用路径工具放入 `project.rs`，本地 HTTP 预览 server、preview registry 和 preview Tauri command 放入 `preview.rs`，启动器 / 主窗口 URL 与窗口切换 command 放入 `windows.rs`，Rust 单测放入 `tests.rs`。拆分不得改变 Tauri command 名、JSON 字段、`.agent/*` 路径、项目权限策略或错误语义。
+- 2026-07-04 调整，2026-07-08 更新：`apps/ai-game-creator-shell/src-tauri/src/main.rs` 拆成薄入口，继续只保留共享类型 / 常量、模块声明、CLI preflight、`tauri::Builder`、运行时配置初始化和 `invoke_handler` 清单；CLI 参数解析与终端运行输出放入 `cli.rs`，Tauri command 包装放入 `commands.rs`，运行时配置 / LLM 配置检查放入 `config.rs`，Agent loop 与生成编排放入 `agent.rs`，上传 / 画板 / 平台美术生成接入放入 `assets.rs`，本地项目文件、记忆、对话、权限、checkpoint、manifest 和通用路径工具放入 `project.rs`，本地 HTTP 预览 server、preview registry 和 preview Tauri command 放入 `preview.rs`，旧窗口 URL 与兼容 command 放入 `windows.rs`，Rust 单测放入 `tests.rs`。拆分不得改变 Tauri command 名、JSON 字段、`.agent/*` 路径、项目权限策略或错误语义。
-- 2026-06-24 调整，2026-07-04 更新：AI 游戏创作 App 的 release 配置只登记 `launcher` 启动器窗口，选择工作区后由 Tauri command 关闭启动器并打开 `main` 主窗口；任务、文件、记忆、预览、日志和能力面板只能通过 Vite dev 的 `?dev/#dev` 分支查看，不进入普通用户窗口，Tauri 不再自动额外创建 `developer` 窗口。
+- 2026-06-24 调整，2026-07-08 更新：AI 游戏创作 App 的 release 配置只登记一个普通用户窗口，登录后在同一 WebView 中进入首页、项目组和项目开发占位；任务、文件、记忆、预览、日志和能力面板只能通过 Vite dev 的 `?dev/#dev` 分支或开发窗口查看，不进入普通用户窗口。旧工作区窗口切换 command 只保留兼容，用户主流程不得调用它。
-- 2026-06-24 调整，2026-07-04 更新：`check:native-shells` 必须静态守住 AI 游戏创作 App 的用户 / 开发边界：release 只保留 `launcher` 启动器窗口，工作区切换命令会关闭来源窗口，用户侧预览只交给系统外部浏览器，开发面板只能在 `devMode` 分支渲染，Tauri 不得自动额外打开 `developer` 窗口。
+- 2026-06-24 调整，2026-07-08 更新：`check:native-shells` 必须静态守住 AI 游戏创作 App 的用户 / 开发边界：release 只保留一个普通用户窗口，用户侧预览只交给系统外部浏览器，开发面板只能在 `devMode` 分支渲染，Tauri 不得自动额外打开 `developer` 窗口，用户主流程不得调用旧工作区窗口切换 command。
 - 2026-06-25 调整：`check:native-shells` 在 `ai-game-creator-shell:check` 之后必须追加 `ai-game-creator-shell:build -- --no-bundle`，让原生壳总门禁同时证明 AI 游戏创作独立 Tauri 壳能完成 release 编译，而不是只证明前端 / Rust 逻辑测试通过。
 - 2026-06-24 调整：普通用户通过聊天输入 `/preview` 触发待确认 `preview.start`，完成 `/project` 初始化后可通过 `/open-preview` 触发待确认 `preview.open` 并只打开当前已授权项目对应的 `127.0.0.1` 本地预览，通过 `/preview-status` 查询当前项目预览，通过 `/preview-stop` 停止当前项目预览；预览 iframe 和状态面板仍只在开发窗口可见，不能把 `preview.open` 扩展成任意 URL 打开能力，也不能打开、展示或停止其它本地项目遗留的全局预览。
 - 2026-06-25 调整：`/preview-status` 虽然是只读命令，也必须写入 `preview.status` 命令日志并向聊天返回错误，不得因查询失败产生未捕获异常或无审计记录。

docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md

@@ -6,7 +6,7 @@
 
 ## 技术选择
 
-- 桌面壳：新建 `apps/ai-game-creator-shell`，与现有 `apps/desktop-shell` 分离，避免把游戏创作本地能力塞进主站宿主壳；启动时先检查平台登录态，未登录只展示登录页，登录后才进入启动器 / 首页；正式用户窗口只加载聊天页，开发构建单独打开开发窗口承载任务、文件、预览和日志面板。
+- 桌面壳：新建 `apps/ai-game-creator-shell`，与现有 `apps/desktop-shell` 分离，避免把游戏创作本地能力塞进主站宿主壳；启动时先检查平台登录态，未登录只展示登录页，登录后进入单窗口客户端首页；正式用户窗口常驻左侧栏和顶部栏，并在首页、项目组、指南 / 反馈和项目开发占位之间切换，开发构建可额外打开开发窗口承载任务、文件、预览和日志面板。
 - 平台后端：继续使用 `server-rs + Axum + SpacetimeDB`；本地开发启动独立客户端时，`agc` / Tauri dev 会先启动或复用配套 SpacetimeDB 与 `api-server`，再启动固定端口 Vite，并通过 `/api` 代理访问实际后端端口。
 - 本地能力：使用 Tauri Rust command；正式用户 App 只启动 `127.0.0.1` 本地 HTTP preview 并交给外部浏览器，不在正式用户窗口内承载游戏预览画面。
 - Agent Runtime：扩展 `server-rs/crates/platform-agent`，不引入 LangChain、AutoGen、Microsoft Agent Framework 或 OpenAI Agents SDK sidecar 作为核心。
@@ -158,7 +158,9 @@ game-project/
 - 短期记忆、长期记忆、项目黑板和角色私有记忆按授权本地项目路径读写；普通用户仍只通过聊天命令访问短期 / 长期 / 黑板记忆，角色私有记忆只在单 agent 对话和生成 loop 中按目标 agent 读取。
 - 结构化对话记录按授权本地项目路径追加 JSONL；普通聊天、`/history`、工作区历史和单 agent 对话都读取 `.agent/conversations/`，最近 project / agent 对话可进入生成 prompt 上下文，但 v1 不提供 fork、archive 或云端同步。
 - Agent 状态列表从 `.agent/manifest.json` 的任务 / 角色清单和 `.agent/run.latest.json` / `.agent/runs/<runId>.json` 的 step、taskGraph、passPlans、lifecycleStatus 派生；v1 不新增独立状态数据库，也不承诺完整后台 runner。
-- App 启动先进入独立启动器窗口；选择工作区后关闭启动器并打开主窗口，主窗口复用 `init_local_game_project` 补齐目录，再从该工作区加载主 conversation、manifest、run trace 和最近 run 历史。最近工作区只保存在本机 WebView storage，用于下次快速选择，并允许用户在启动器中移除单个最近项目或清空最近项目列表；最近项目目标不存在、不是目录或缺少可读 `.agent/manifest.json` 时只显示状态并禁用打开，不自动重建目录。
+- App 启动先检查平台登录态；登录后进入同一个客户端首页，不再有面向用户的启动器 / 主窗口切换概念。首页按 `做游戏` / `做素材` / `做方案` 保存 `game` / `art` / `doc` 初始意图，发送时弹出原生目录选择，目标目录存在且非空时必须二次确认；确认后只调用 `init_local_game_project` 初始化本地项目、`upload_local_asset` 导入附件、`append_local_conversation_message` 记录首条需求和接收回执，再写入最近项目并切到项目开发占位页。本流程不调用 `generate_local_game_draft`、`generate_platform_art_asset` 或 LLM 聊天。
+- 首页最近项目只展示最近 3 个有效项目；项目组页在同一窗口管理最近项目、打开项目、新建项目和显示目录。打开项目只读取已初始化项目并切到项目开发占位页，不打开第二窗口；新建项目仍沿用非空目录确认，不自动重建无效历史路径。
+- 项目开发占位页保留左侧栏和顶部栏，展示项目名、路径、创建模式、首条需求、附件导入结果、最近 run 状态和后续“项目开发画布”占位；本轮不落地真正画板 + Agent 双栏。
 
 ## v1 验收证据矩阵
 
@@ -228,7 +230,7 @@ game-project/
 - `/publish` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、预览状态、资产来源和最近命令生成发布准备清单，提供 `/run`、`/trace`、`/agent-resume ` 或 `/export` 草稿，不触发 Tauri 读写、预览启动、文件读取或新增普通用户面板。
 - 主窗口策略快捷入口只填入 `/policy-confirm project.index`、`/policy-confirm asset.register`、`/policy-confirm memory.write`、`/policy-confirm preview.start`、`/policy-confirm preview.open`、`/policy-confirm preview.stop`、`/policy-confirm agent.run_status`、`/policy-confirm conversation.read` 或 `/policy-confirm conversation.write` 草稿；Agent 状态栏的“继续说明”只填入 `/agent-resume ` 草稿，不直接触发 run 生命周期写入。
 - 主窗口最近 checkpoint 列表展示 checkpoint id、文件数、大小和创建时间，同时提供直接对比、填入 `/diff`、确认回滚和填入 `/restore`；回滚继续走 `project.restore` 确认卡，不直接写项目文件。
-- `npm run check:native-shells`：覆盖 AI 游戏创作壳的 release/dev 边界、正式用户 App 不嵌入游戏预览 iframe、用户侧预览命令交给外部浏览器和 Tauri release `--no-bundle` 构建 smoke；用于证明正式发布只登记 `launcher` 启动器窗口，选择工作区后才关闭启动器并打开 `main` 主窗口，Tauri 不自动额外打开 `developer` 窗口，开发面板只在 Vite dev 的 `?dev` / `#dev` 分支渲染，独立壳能完成 release 编译。
+- `npm run check:native-shells`：覆盖 AI 游戏创作壳的 release/dev 边界、正式用户 App 不嵌入游戏预览 iframe、用户侧预览命令交给外部浏览器和 Tauri release `--no-bundle` 构建 smoke；用于证明正式发布只登记一个用户窗口，登录后同一 WebView 渲染首页、项目组和项目开发占位，Tauri 不自动额外打开 `developer` 窗口，开发面板只在 Vite dev 的 `?dev` / `#dev` 分支渲染，旧窗口切换 command 仅保留兼容、不进入用户主流程。
 - `npm run check:encoding` 与 `git diff --check`：覆盖中文文档、中文命令文案和补丁空白；用于避免乱码、尾随空白和无关格式漂移。
 - `npm run ai-game-creator-shell:llm-status`：只检查 LLM 客户端配置是否就绪，不请求上游、不显示 API Key；用于本机联调前确认配置。发布版启动时会在 Tauri 应用配置目录生成默认 `game-creator.config.json`，仓库内 `apps/ai-game-creator-shell/game-creator.config.json` 只作为默认模板。
 - `npm run ai-game-creator-shell:agent-run -- --no-wait /绝对项目路径 "游戏创作需求"`：使用真实 OpenAI-compatible 配置跑一次本地生成、落盘、自检和预览；用于人工验收真实 provider 路径。真实 provider 配置放在 Tauri 应用配置目录的 `game-creator.config.json` 中，至少设置 `llm.apiKey`，需要覆盖默认服务时设置 `llm.baseUrl`、`llm.model`；默认 API kind 为 `openai_responses`，旧 Chat Completions 兼容网关设置 `llm.apiKind` 为 `openai_chat`，Anthropic Messages 网关设置 `llm.apiKind` 为 `anthropic`，URL 会在 base URL 后拼 `/v1/messages`，例如 Minimax Anthropic base URL 可配置为 `https://api.minimaxi.com/anthropic`；真实网关长请求若在非流式响应前被 60 秒空闲连接切断，联调时设置 `llm.stream` 为 `true`。
@@ -237,11 +239,11 @@ game-project/
 
 - `apps/ai-game-creator-shell` 是独立 Tauri App，不复用 `apps/desktop-shell`。
 - 独立客户端启动时先进入平台登录检查；未登录页默认展示手机号验证码登录，并保留密码登录切换。验证码登录调用平台后端 `/api/auth/phone/send-code` 与 `/api/auth/phone/login`，密码登录继续调用 `/api/auth/entry`；Tauri dev 下 `/api` 走固定 3080 Vite 代理，发布版静态窗口下登录请求默认直连本机配套 `http://127.0.0.1:8082` API，网络层失败时展示登录服务不可达提示，不裸露 WebView 的 `Load failed`。
-- Tauri Rust 入口保持薄壳：`src-tauri/src/main.rs` 只保留共享类型 / 常量、模块声明、CLI preflight、`tauri::Builder`、运行时配置初始化和 `invoke_handler` 清单；命令行入口放在 `cli.rs`，Tauri command 包装放在 `commands.rs`，运行时配置与 LLM 配置检查放在 `config.rs`，Agent loop 与生成编排放在 `agent.rs`，上传 / 画板 / 平台美术生成接入放在 `assets.rs`，本地项目文件、记忆、对话、权限、checkpoint、manifest 和通用路径工具放在 `project.rs`，本地 HTTP 预览与 preview 命令放在 `preview.rs`，启动器 / 主窗口切换命令放在 `windows.rs`，Rust 单测放在 `tests.rs`。后续继续拆分时保持 Tauri command 名、JSON 字段、`.agent/*` 路径和错误语义不变。
+- Tauri Rust 入口保持薄壳：`src-tauri/src/main.rs` 只保留共享类型 / 常量、模块声明、CLI preflight、`tauri::Builder`、运行时配置初始化和 `invoke_handler` 清单；命令行入口放在 `cli.rs`，Tauri command 包装放在 `commands.rs`，运行时配置与 LLM 配置检查放在 `config.rs`，Agent loop 与生成编排放在 `agent.rs`，上传 / 画板 / 平台美术生成接入放在 `assets.rs`，本地项目文件、记忆、对话、权限、checkpoint、manifest 和通用路径工具放在 `project.rs`，本地 HTTP 预览与 preview 命令放在 `preview.rs`，旧窗口兼容命令放在 `windows.rs`，Rust 单测放在 `tests.rs`。后续继续拆分时保持 Tauri command 名、JSON 字段、`.agent/*` 路径和错误语义不变。
 - 本地项目初始化会创建 `game/`、`assets/`、`memory/`、`memory/agents/`、`exports/`、`.agent/logs/`，写入 `.agent/manifest.json`，生成 append-only JSONL 本地项目索引 `.agent/agent.db`，并生成默认 `game/index.html`。
 - v1 conversation 记录使用 append-only JSONL，每行带 `schemaVersion`、`role`、`content`、`agentId` 和 `updatedAt`，作为聊天历史和单 agent 对话历史的事实源；目录在首次写入时创建。
 - 普通用户可在聊天框输入 `/project /绝对路径` 生成待确认的 `project.create` 命令，用于授权并初始化本地项目目录；相对路径不会生成待确认命令；开发窗口仍可直接编辑项目路径。
-- 启动器可选择、打开、新建或显示当前输入的项目绝对路径；最近项目行也可显示目录，非法或相对路径不会调用系统文件管理器。
+- 单窗口首页和项目组页可选择、打开、新建或显示当前输入的项目绝对路径；最近项目行也可显示目录，非法或相对路径不会调用系统文件管理器。
 - 普通用户侧的生成、上传、运行、自检、预览状态 / 启动 / 打开 / 停止、记忆写入和画板资产导入都必须先完成 `/project` 初始化；未初始化时只提示设置本地项目，不落到默认临时目录。
 - 终端可用 `npm run ai-game-creator-shell:llm-status` 检查 LLM 客户端配置是否就绪；桌面 App 主窗口“配置”面板可读写 Tauri 应用配置目录中的 `game-creator.config.json`，`/llm-status` / 生成入口读取同一份配置，CLI 开发入口无 AppHandle 时才回退读取仓库旁边的配置模板和 gitignored 本机覆盖文件；不请求上游、不显示 API Key，缺配置时以非零状态退出或在聊天里提示未就绪。
 - 终端可用 `npm run ai-game-creator-shell:check` 跑 v1 开发验收：壳 typecheck、`platform-agent` 编排测试、共享契约测试、Tauri Rust 测试和无密钥本地 provider 端到端 smoke。
@@ -335,12 +337,12 @@ game-project/
 - 聊天输入 `/internals` 只列出项目内部真相源读取命令，覆盖 `.agent/manifest.json`、`.agent/run.latest.json`、`.agent/spec.md`、`.agent/findings.md`、`.agent/policy.json`、`.agent/project.index.json`、`.agent/agent.db` 和 `.agent/conversations/project.jsonl`；该命令不调用 Tauri 读写、不读取文件、不新增普通用户内部文件面板，真正读取仍由用户发送 `/read` 并走 `file.read` 权限流。
 - 聊天输入 `/publish` 只使用主窗口当前已加载的 manifest、最近 run trace、预览状态、资产来源和最近命令摘要，在聊天里生成发布准备清单，列出原型通过状态、预览、任务、资产、音频、包装说明和试玩包导出状态，并提供 `/run`、`/trace`、`/agent-resume ` 或 `/export` 草稿；该命令不调用 Tauri 读写、不启动或打开预览、不读取文件、不新增普通用户面板，真正导出仍由用户发送 `/export` 并走确认流。
 - 主窗口可从 agent 状态列表进入单个 agent 对话；该入口只加载目标 agent 的 conversation JSONL，发送消息后追加到同一 agent conversation，不开启平行任务图、不 fork run，也不归档历史会话。
-- v1 通过独立启动器窗口选择本地项目后再进入主窗口；主窗口只承载当前工作区的聊天、配置和 agent 状态，切换项目时关闭当前主窗口并回到启动器，主窗口按钮和 `/switch-project` 聊天命令都复用同一 Tauri 启动器入口，避免在主窗口内用遮罩面板混合多个工作区上下文。
+- v1 普通用户登录后直接进入单窗口客户端首页；同一窗口中切换首页、项目组、指南 / 反馈和项目开发占位。项目组页管理最近项目、打开项目、新建项目和显示目录；打开项目只切换到项目开发占位，不调用 `open_game_creator_workspace_window` 打开第二窗口。旧 Tauri 窗口 command 只保留兼容，不进入用户主流程。
 - 主窗口可通过系统文件管理器显示当前项目目录，也可在聊天输入 `/open-project` 走同一只读打开动作；该操作只打开本地目录，不初始化项目、不写项目文件、不切换工作区。主窗口头部显示最近 `.agent/run.latest.json` 的 run 状态摘要和当前项目预览状态，并通过“刷新状态”重新读取同一 trace，不新增状态数据库。
-- 启动器和主窗口共用同一个运行时配置弹窗，读写 Tauri 应用配置目录中的 `game-creator.config.json`；API Key 仍不进入本地项目、trace、manifest 或聊天记录。
+- 首页、项目组页和项目开发占位共用同一个运行时配置弹窗，读写 Tauri 应用配置目录中的 `game-creator.config.json`；API Key 仍不进入本地项目、trace、manifest 或聊天记录。
-- 启动器支持手动输入绝对路径，也支持通过 Tauri 原生目录选择器回填项目路径；用户取消目录选择时不覆盖已经输入的路径。
+- 首页发送和项目组新建都通过 Tauri 原生目录选择器选择项目路径；用户取消目录选择时不覆盖已有输入或草稿。
-- 启动器最近项目列表只来自本机 WebView storage，可移除单项或清空；这些操作不触碰项目目录，也不触发打开主窗口。启动器会只读检查最近项目路径，已初始化项目优先显示 `.agent/manifest.json` 里的项目名并保留路径副信息；如果 `.agent/run.latest.json` 可读，则显示最近 run 的 status / stopReason；缺失、非目录、未初始化或检查失败的条目禁用打开，用户可移除后重新选择。刷新最近项目只重新执行这组只读检查，不改项目目录或最近项目列表；刷新未完成时按钮显示“刷新中”并禁用，最近项目条目显示“检查中”且临时禁用打开 / 显示操作，避免重复触发并让用户知道检查仍在进行；“显示”只通过系统文件管理器打开已确认存在的本地目录，未初始化但存在的目录也可显示，缺失、非目录或检查失败时禁用，不初始化项目、不写最近项目、不打开主窗口。
+- 最近项目列表只来自本机 WebView storage，可移除单项或清空；这些操作不触碰项目目录，也不触发窗口切换。项目组页会只读检查最近项目路径，已初始化项目优先显示 `.agent/manifest.json` 里的项目名并保留路径副信息；如果 `.agent/run.latest.json` 可读，则显示最近 run 的 status / stopReason；缺失、非目录、未初始化或检查失败的条目禁用打开，用户可移除后重新选择。刷新最近项目只重新执行这组只读检查，不改项目目录或最近项目列表；刷新未完成时按钮显示“刷新中”并禁用，最近项目条目显示“检查中”且临时禁用打开 / 显示操作，避免重复触发并让用户知道检查仍在进行；“显示”只通过系统文件管理器打开已确认存在的本地目录，未初始化但存在的目录也可显示，缺失、非目录或检查失败时禁用，不初始化项目、不写最近项目。
-- 启动器中“打开”只进入已初始化且 `.agent/manifest.json` 可读的 AI 游戏项目；路径不存在、不是文件夹或只是普通文件夹时留在启动器提示，不自动创建目录；Tauri 打开主工作区窗口命令本身也拒绝空路径、相对路径或包含控制字符的路径。“新建项目”和主窗口 `project.create` 新建入口会先检查目标目录，目标目录已经存在且非空时必须弹出确认提醒；用户继续后才调用 `init_local_game_project`，默认项目名取目标文件夹名，再写入最近项目并打开主窗口；用户取消或初始化失败时不打开主窗口、也不写入最近项目。
+- 项目组页“打开”只进入已初始化且 `.agent/manifest.json` 可读的 AI 游戏项目；路径不存在、不是文件夹或只是普通文件夹时留在当前页提示，不自动创建目录。“新建项目”和聊天 `project.create` 新建入口会先检查目标目录，目标目录已经存在且非空时必须弹出确认提醒；用户继续后才调用 `init_local_game_project`，默认项目名取目标文件夹名，再写入最近项目并切到项目开发占位；用户取消或初始化失败时不切换视图、也不写入最近项目。
 - 聊天输入 `/commands` 会只读列出 Tauri runtime 暴露的受限命令白名单，读取失败或非 Tauri 环境下回退到共享契约默认列表；该命令不执行白名单命令，也不要求先初始化项目。
 - 聊天输入 `/smoke` 会生成待确认的 `command.run_limited` 内置命令，当前只映射到白名单 `game.static_smoke`，不开放任意命令解析。
 - 聊天输入 `/run` 会生成待确认的 `game.run_local` 内置命令，确认后复用白名单 `game.static_smoke` 运行当前 `game/index.html`，通过后启动只读本地 HTTP 预览并交给外部浏览器；该命令不开放任意 shell。
@@ -362,8 +364,8 @@ game-project/
 - 开发模式可执行 `canvas.asset_import`，将项目内已有文件按画板来源导入 manifest；也可执行 `canvas.export_import`，把现有画板素材导出 ZIP 回流为本地项目资产。`game.generate_draft` 在配置 `editorApi.apiKey` 时会自动复用 External Editor API 的图片生成接口生成首版美术素材，不新增平行资产模型。
 - 普通模式渲染聊天区、上传入口、Agent 状态列表和单 Agent 对话；Tauri 主窗口不承载工具台布局，也不承载游戏预览画面。
 - 聊天生成草案后会尝试启动只读 `127.0.0.1:<port>` 静态 HTTP server，调用系统外部浏览器打开预览，并把预览地址回到聊天消息；外部浏览器打开失败时保留本地 URL 供用户手动复制。
-- 开发模式仅在 Vite dev 环境响应 `?dev` 或 `#dev`，Tauri dev 会自动额外打开 `developer` 窗口显示专业组、本地项目、预览 iframe 和内置命令日志；正式构建忽略 dev 参数，release 配置只登记 `launcher` 启动器窗口，选择工作区后由 Tauri command 打开 `main` 主窗口。
+- 开发模式仅在 Vite dev 环境响应 `?dev` 或 `#dev`，Tauri dev 可额外打开 `developer` 窗口显示专业组、本地项目、预览 iframe 和内置命令日志；正式构建忽略 dev 参数，release 配置只登记一个用户窗口，登录后同窗口进入首页并在项目组 / 项目开发占位之间切换。
-- `check:native-shells` 会运行 `ai-game-creator-shell:check` 和 `ai-game-creator-shell:build -- --no-bundle`，并静态检查 release 只登记 `launcher` 启动器窗口、开发窗口只在 debug 下打开，开发面板必须挂在 `devMode` 分支内，正式用户 App 不能嵌入游戏预览 iframe，release CSP 也不能允许 `frame-src http://127.0.0.1:*`，用户侧预览命令必须调用 `open_local_game_preview` 交给系统外部浏览器。
+- `check:native-shells` 会运行 `ai-game-creator-shell:check` 和 `ai-game-creator-shell:build -- --no-bundle`，并静态检查 release 只登记一个用户窗口、开发窗口只在 debug 下打开，开发面板必须挂在 `devMode` 分支内，正式用户 App 不能嵌入游戏预览 iframe，release CSP 也不能允许 `frame-src http://127.0.0.1:*`，用户侧预览命令必须调用 `open_local_game_preview` 交给系统外部浏览器，用户主流程不得调用旧工作区窗口切换 command。
 - 共享契约提供 `GAME_CREATION_AGENT_CAPABILITIES` 和内置命令权限枚举；开发模式会展示能力列表。
 - 共享契约提供 manifest task schema 和 ready-task 选择器，用于记录任务拆分、专业组、角色模板、依赖、产物、验收条件和当前可执行任务。
 - 开发模式可读取、保存、删除短期记忆和长期记忆文件；普通用户通过聊天命令完成同类能力。