suzmii
64b0d2f766
收敛外部错误体、注入提示词与锁诊断的不设界行为（PR #316 review） - resource_editor.rs:2476 [bug · medium] 已被修复：`error_details` 改为 `error.details` 优先、顶层 `details` 兜底，与 docstring 声明的取值顺序一致；新增「两种形状同时出现」用例钉住优先级。 - resource_editor.rs:2468 [performance · low] 已被修复：4xx 错误体改走 `bytes_stream` 有界读取（64KiB 上限，超限即放弃取原因），不再用 `response.text()` 无上限缓冲外部正文。 - resource_editor.rs:2514-2525 [maintainability · low] 已被修复：provider / assetKind / mediaType / code 四个追加字段各自按 80 字符截断（`MAX_EDITOR_ERROR_DETAIL_CHARS`），最终文案长度不再随外部正文增长；新增超长字段整串比对用例。 - direct_codex_references.rs:175-182 [performance · medium] 已被修复：`resourceIds` 超过 32 条直接按模块失败关闭口径拒绝，并在同一 id 的重复项上做去重，注入提示词的「关联素材 ID」行长度与 manifest 扫描次数都有界；新增去重 + 超限用例。 - direct_runtime.rs:1795-1797 [maintainability · low] 已被修复：`direct_project_history_contention_failure` 收窄为只认追加锁超时标记（项目写锁争用已在更早的专用分支判掉，是死代码），恢复提示文案相应去掉「或项目锁」；新增用例钉住两条判据互不重叠、各自命中正确提示。 - conversation.rs:984-989 [maintainability · medium] 已被修复：`DIRECT_PROJECT_HISTORY_RECORD_TYPE` 提升为 `pub(crate)`，读取侧 `is_direct_project_history_row` 引用同一常量，`project.jsonl` 的信封契约改为编译期共享。 - agent_db.rs:3570-3574 [other · medium] 已被修复：`lock_with_attempts` 的进程内锁改为有界 `try_lock` 轮询（窗口与调用方一致，2000/200 次 × 5ms），同进程读路径不再被写者的 10s 跨进程等待拖住；顺序仍是「进程内锁 → 跨进程锁」，无 ABBA；新增用例验证短窗口 <5s 失败且释放后立即可重取。 - agent_db.rs:3668-3669 [maintainability · low] 已被修复：新增与锁同级的旁路诊断文件（普通共享写入），诊断优先读它、读不到再退回锁文件，Windows 上 zero-share 独占锁文件时也能报出持锁方；新增「取锁写出旁路文件」「锁文件不可读时退到旁路」两条用例。仅存 pid/用途/时间戳，不参与判活、回收或抢占。 - agent_db.rs:3827-3828 [maintainability · low] 已被修复：仅当修复错误真的符合提权口径（`windows_acl_error_may_need_elevation`）时才追加「自动提权修复未完成」，否则原样透传底层错误，不再重复报同一个错误并谎称尝试过提权。 - main.rs:29-31 [maintainability · low] 判定为不适用/不改：实测删掉那四个 import 会产生 18 处 E0425（`direct_tool_bridge` / `canvas_generation` / `assets` / `manifest` / `resource_editor` / `resource_dependency_graph` / `recovery_tests` 等经 `use super::*` 从 crate 根复用它们），而保留它们并不产生 `unused_imports` 警告（cargo check --all-targets 无一条指向这几行）；已按原样恢复 main.rs，工作树中该文件无改动。
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 资产与编码规范。