suzmii
c0d4f5c898
用户决定（本 PR 内落地）：把 codex 这块 provider 相关逻辑收敛到一个模块内，给该模块打上允许
dead code，而不是删除——上游 master 正在活跃编辑这些文件，删除会与其在飞工作反复冲突。
本次只影响 AGC 壳；server-rs、其它目录、其它 lint 与 CI 都不受影响。
逐行说明：
1. 新增 agent/codex_provider/mod.rs
- 顶部 `#![allow(dead_code)]`：唯一落点，覆盖本模块及其子模块（实测可压过 AGC 壳的
`#![cfg_attr(all(not(test), windows), deny(warnings))]`，但压不住 `unused_imports`）。
- `#[path = "../codex_app_server/mod.rs"] pub(crate) mod app_server;`
`#[path = "../codex_cli.rs"] pub(crate) mod cli;`
用 `#[path]` 就地挂载，不搬动文件——与上游活跃编辑区的冲突面只剩本文件与 agent.rs。
- `pub(crate) use cli as codex_cli;`：子树内部既有的 `super::codex_cli::…` 相对路径照旧可用。
2. agent.rs
- `mod codex_app_server;` + `mod codex_cli;` → `mod codex_provider;`
`+ pub(crate) use codex_provider::{app_server as codex_app_server, cli as codex_cli};`
对外路径（`crate::agent::codex_cli::…`、`super::codex_app_server::…`）不变，既有调用点零改动。
3. agent/codex_app_server/mod.rs：`resolve_direct_codex_project_authority` 由 `pub(super)` 放宽为
`pub(in crate::agent)`——挂载多了一层后，保持它在挂载前对 agent 子树的有效可见性。
4. agent/codex_app_server/direct_project_identity.rs：`use super::super::*;` → `use crate::agent::*;`
（同因，绝对路径与挂载前语义一致）。
5. agent/generation/llm_request.rs：删除 `AgentProgressEmitter` / `emit_agent_progress` 并同步模块文档。
理由：其唯一消费方 `maybe_generate_platform_art_asset_step` 已随退役批次删除（我们那侧），
master 对它的改动只是给死函数加日志；且 `allow(dead_code)` 压不住其它 lint，残留必须真删。
6. agent/thread_manager/turn_completion.rs：`host_dropped()` 加 `#[cfg(test)]`。理由：master 的生产
Drop 已改用 `host_dropped_with_detail`，该兼容构造只剩用例引用，生产口径下是死码。
7. browser/process.rs：删除 `BrowserLaunchFailure::setup`。理由：master 把它改名成
`setup_with_detail` 后遗留的未用构造（全仓无调用点）。
8. command_exec.rs：`project_command_actual_target` 收窄为 `#[cfg(target_os = "linux")]`。理由：
master 新增该函数，但其调用点全在 Linux 编译面（沙箱启动路径与该平台用例），Windows 生产构建无消费方。
结果（Windows msvc / rustc 1.98.1，编辑器 feature）：
- 生产口径 `cargo check`：0 warning / EXIT 0；
- `cargo check --all-targets`：EXIT 0（352 条告警全部落在这一个 bin 的 test harness 实例，属既有口径，
与本提交无关）；
- `npm run check:rustfmt`、`npm run check:encoding`、`git diff --check` 均通过。
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 资产与编码规范。