接入客户端登录和配套后端启动

启动客户端时先检查平台登录态，未登录展示登录页，登录后进入启动器首页独立客户端登录使用平台 auth 接口并对 refresh 做并发去重 Tauri 开发启动改为短命令 agc:serve，并先拉起配套 SpacetimeDB 与 api-server AGC Vite 代理读取 dev-stack 状态并暴露本地 marker，复用时校验 API target 恢复启动器项目目录输入、最近项目刷新移除和非空文件夹提醒交互补充启动器和登录 gate 测试，并更新 AI 游戏创作 App 开发文档
2026-07-08 02:25:31 +08:00
parent 3b3d9dcf8e
commit f9d8142068
13 changed files with 1188 additions and 104 deletions
@@ -51,6 +51,14 @@ npm install
 npm run dev
 ```

+AI 游戏创作独立客户端常用短命令：
+
+```bash
+npm run agc
+```
+
+`npm run agc` 会启动 Tauri 开发客户端；其 `beforeDevCommand` 通过 `npm run agc:serve` 先完成壳 typecheck，再启动或复用配套 SpacetimeDB、`api-server` 和固定 `127.0.0.1:3080` Vite。只需要浏览器预览同一客户端时可用 `npm run agc:serve`；只启动配套后端和数据库时可用 `npm run agc:backend -- --database <name>`。
+
 Linux 多用户共享同一台机器开发时，本地 dev 脚本会为当前 Linux 用户分配一个固定端口段并写入系统级注册表 `/var/tmp/genarrative-dev-port-ranges/registry.json`，自动分配从 `10000-10099` 开始，每段 100 个端口，四个 dev 服务依次使用 `start` 到 `start + 3`。可用 `GENARRATIVE_DEV_PORT_RANGE` 或 `npm run dev -- --port-range` 手动指定端口段用于特殊场景；注册表会阻止不同用户使用相同或重叠段，并让同一用户后续启动继续复用自己已占用的固定段。该机制只在 Linux 生效，Windows 仍沿用原有端口探测与漂移逻辑。

 本地 `npm run dev`、`npm run dev:spacetime` 和 `npm run dev:api-server` 会在 Rust 子进程环境中绕过项目默认 `sccache` wrapper，避免损坏的本机 cache daemon 阻断 `spacetime publish` 或 `api-server` 启动；显式设置的非 sccache 自定义 wrapper 会被保留。生产 / Jenkins 构建仍按流水线自身的 sccache 策略执行。
@@ -6,8 +6,8 @@

 ## 技术选择

- 桌面壳：新建 `apps/ai-game-creator-shell`，与现有 `apps/desktop-shell` 分离，避免把游戏创作本地能力塞进主站宿主壳；正式用户窗口只加载聊天页，开发构建单独打开开发窗口承载任务、文件、预览和日志面板。
- 平台后端：继续使用 `server-rs + Axum + SpacetimeDB`。
+- 桌面壳：新建 `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 作为核心。
 - 设计参考：借鉴 OpenAI Agents SDK 的 Agent、Tools、Handoffs、Guardrails、Tracing 抽象，但运行时由 Genarrative 自己掌控。