suzmii
694b545062
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Successful in 7m16s
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Failing after 5m9s
Project CI / AI game creator shell Rust crates (pull_request) Successful in 5m7s
Project CI / Frontend tests (pull_request) Successful in 3m34s
Project CI / Backend tests (pull_request) Successful in 8m30s
Project CI / AI game creator shell web tests (pull_request) Failing after 2m58s
Project CI / Repository checks (pull_request) Successful in 6m47s
Project CI / Native shell tests (pull_request) Successful in 9m33s
D1（由 1a86675f4 引入）：该提交删掉了 master 定义的 `resolve_project_bootstrap_spec_at`
（原 command_exec.rs:645 + 生产包装 :2500），但同文件 `#[cfg(test)] mod tests` 里
`#[cfg(target_os = "linux")] #[test] fn npm_command_targets_node_plus_npm_cli_on_linux`
仍在调用它（command_exec.rs:2641）⇒ Linux 测试目标必然 E0425；Windows 生产口径看不见（cfg 盲区）。
修法（取"按真实使用面收窄"这一支）：按 master 原文恢复该函数，并加
`#[cfg(all(target_os = "linux", test))]`：
- 比同文件先例 `project_command_actual_target` 的 `#[cfg(target_os = "linux")]` 更窄——那个函数
Linux 生产仍在调用（沙箱启动路径），这个的唯一生产调用方 project/export.rs 已被 master 删除，
只剩本文件用例调用，故按实际使用面写成 all(target_os="linux", test)，避免在 Linux 生产里留下一枚死函数。
- 引用侧有效 cfg = `#[cfg(test)] mod tests` + `#[cfg(target_os = "linux")]` 用例 = all(test, target_os=linux)，
与定义侧一致 ⇒ 「引用 1 处 / 定义 1 处（同 cfg）」。
- 函数体与 master 逐字相同；未删用例、未删断言、未用 #[allow]。
同类排查（1a86675f4 里删掉/收窄的每一项符号 × 引用 × 定义 × cfg）：
1. GAME_PACKAGE_UPLOAD_PROGRESS_EVENT（常量及其再导出）→ 删除；tip 引用 0 ⇒ 无悬空。
2. run_project_bootstrap_command_at → 删除；引用 0 ⇒ 无悬空。
3. project/bootstrap.rs 整模块（BOOTSTRAP_PACKAGE_MAX_BYTES / ProjectBootstrapResult /
read_bootstrap_file / run_project_bootstrap_at）+ project.rs 的 `mod bootstrap;` 与
`pub(crate) use bootstrap::*;` → 删除；`bootstrap::` 与 `run_project_bootstrap_at` 引用均为 0 ⇒ 无悬空。
4. run_project_verification_with_commit_at → 删除；引用 0 ⇒ 无悬空（下游
resolve_project_verification_spec_with_cwd_at 另有 taonier/build.rs:82 与 xhs_minitool/build.rs:46 调用，未受影响）。
5. TaonierArtifactPackage 再导出 → 移除；3 处引用全在 build.rs（定义/返回类型/构造）⇒ 无悬空。
6. read_form → 删除；引用 0 ⇒ 无悬空。
7. ensure_staging_path_in_dir → 收窄为 `#[cfg(test)]`；引用 3 处 = 定义 + 同文件 `#[cfg(test)] mod tests`
两处 ⇒ 兼容（test ⊆ test）。
8. NpmScript.package_json_relative 字段 → 收窄为 `#[cfg(test)]`；读取处两处用例断言（cfg(test)）+ 构造处
亦已 cfg(test) ⇒ 兼容；同名自由函数仍属生产并被 script.rs:76 使用。
9. resolve_project_bootstrap_spec_at → 本次按 D1 处理（见上），引用/定义各 1 处且 cfg 一致。
静态复查（方法自定）：对 AGC 壳全部 321 个 .rs 建「定义名 → cfg 链」与「use 绑定名」表，按 `#[cfg]`
属性 + 花括号深度重建每行的有效 cfg 链，筛出非 Windows 块（target_os=linux/macos/…、unix、
not(windows)）共 7315 行，再统计三类危险计数：
- ① 悬空（master 有定义、tip 无定义的名字在非 Windows 块仍有引用）：3 名 9 处命中，逐条核对全为假阳
（`"git"`/`"running"` 是字符串字面量；`process_identity` 是模块路径的另一符号）⇒ **0**。
- ② windows-only 定义被非 Windows 块引用：3 名 23 处，全为假阳（`is_empty` 是 std 方法调用；
`platform_art_windows_directory_open_policy`、`resume_suspended_tokio` 位于嵌套的
`#[cfg(windows)] { … }` 块内，是启发式未下钻）⇒ **0**。
- ③ not(test) 越用：3 名 4 处，全为假阳（`main`/`startup` 是字符串；`set_external_agent_runner_config_dir`
的 cfg 是 `any(not(test), unix)`，unix 测试构建中存在，且命中行是该定义行本身）⇒ **0**。
说明：`cargo check --target x86_64-unknown-linux-gnu` 在本机跑不通（GTK/webkit 的 -sys 与 ring 需要 Linux
工具链，pkg-config 无法交叉配置），故 Linux 侧证据以静态法给出；master 侧的非 Windows 改动由 master 自己的
Linux CI 兜底。
验证（Windows + 编辑器 feature；取数前 `cargo clean -p genarrative-ai-game-creator-shell`）：
AGC bin EXIT 0 / 0 warning（18 条 serde 宏提示非 lint）；AGC `--all-targets` EXIT 0（harness 实例 382 条）；
`npm run check:rustfmt` / `npm run check:encoding`（5549 文件）/ `git diff --check` 全 EXIT 0；
六组测试 6 / 17 / 74 / 1 / 65 / 4，全部 0 failed。
Genarrative / 陶泥儿
一个 AI 原生互动内容与小游戏平台，当前主站聚焦图片画布创作、项目与素材管理，以及账号、钱包和后台管理等平台公共能力。
当前已经具备这些主要能力：
- 图片画布编辑、项目与素材管理
- 图片、视频、音频等外部生成任务
- 账号、钱包、充值、兑换码与个人资料
- 后台运营、配置与生产运维工具
- AI 游戏创作独立 App
运行
前置条件：
- Node.js
- Rust / Cargo
- SpacetimeDB CLI
安装依赖：
npm install
该命令会按根 package.json 的 npm workspaces 一次安装主站、Admin、Mobile、Desktop、AGC、Preview Deployer、内部 packages 与工具依赖；仓库只使用根 package-lock.json，不要在子目录单独执行 npm install / npm ci 或提交嵌套 lockfile。
准备环境变量：
- 复制
.env.example为.env.local - 只填写本次联调所需配置；不要提交
.env.local、密钥、Token 或其它本地认证信息 - api-server 环境变量和 Provider 配置以
.env.example及当前开发运维文档为准
启动开发环境：
npm run dev
补充说明：
npm run dev会启动 SpacetimeDB standalone、独立bgfilter-worker、Rustapi-server、主站 Vite 与后台 Vite，适合完整联调；内部 worker ready 后才启动 API。- 主站默认地址是
http://127.0.0.1:3000，后台可从http://127.0.0.1:3000/admin/进入，也可直连http://127.0.0.1:3102。 - 五个模块可独立启动：
npm run dev:spacetime、npm run dev:api-server、npm run dev:bgfilter-worker、npm run dev:web、npm run dev:admin-web；其中dev:api-server会安全带起同 runner 的 BgFilter worker 依赖。 - 如需自动刷新后端模块，使用
npm run dev -- --watch；其中spacetime-module改动后只会重新发布模块，不会重启 standalone，Rust 源码改动会把api-server与bgfilter-worker作为一个组合单元重启。主站和后台前端源码变化交给 Vite 自身 HMR，不由外层 watcher 重启。非 watch 模式下可在npm run dev终端输入rs api-server、rs bgfilter-worker、rs web、rs admin-web、rs spacetime或rs all，其中rs spacetime也是只重新发布模块。
构建生产包：
npm run build
常用检查
类型检查：
npm run lint
编码检查：
npm run check:encoding
主要结构
主运行时：
- src/active-main.tsx
- src/ActiveApp.tsx
- src/AuthenticatedApp.tsx
- src/routing/activeAppRoutes.tsx
- src/components/platform-entry/PlatformEntryActiveFlowShell.tsx
创作与项目能力：
- src/components/image-editor/ImageCanvasEditorView.tsx
- src/components/creation-home/CreationLandingView.tsx
- src/components/project/ProjectGalleryView.tsx
文档入口
docs/ 已在 2026-08-25 按当前代码与运行态重新收口。旧 PRD、设计、审计、阶段计划和技术流水账不再作为实现依据；专题文档的现役清单统一从 docs/README.md 进入：
- docs/README.md：当前文档总入口。
- docs/【项目基线】当前产品与工程约束-2026-05-15.md：产品、命名、UI、协作和废弃路线。
- docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md：DDD 边界、API 分组、SpacetimeDB schema 规则和表目录。
- docs/【玩法创作】平台入口与玩法链路-2026-05-15.md：平台现役入口、项目页和画布链路。
- docs/【开发运维】本地开发验证与生产运维-2026-05-15.md：本地启动、检查、部署、埋点和运营查询。
- docs/project-memory/README.md：团队共享的当前项目记忆、决策和未关闭事项。
- UI_CODING_STANDARD.md：像素 UI 资产与编码规范。