suzmii
10d1fcbc5f
对抗性复核（`local://verify-m2b.md`）确认三个真实缺口，本次按 P0 → P1-b 补齐；两端规则逐条对齐，parity 门禁仍绿。 - **P0-a 凭据/依赖识别**：任意层级目录新增 `.aws` / `.ssh` / `.kube` / `.docker` / `.gnupg` / `.terraform` / `.secrets`（服务端新增独立变体 `CredentialDirectoryNotAllowed`）；文件名前缀新增 `credentials` / `id_ecdsa` / `id_dsa` / `terraform.tfstate` / `service-account`；后缀新增 `.jks` / `.keystore` / `.ppk` / `.p8` / `.kdbx` / `.der`；全名新增 `.htpasswd` / `.pgpass`。另外对**小体积文本条目**（≤256 KiB、扩展名在白名单或无扩展名）做内容特征扫描：PEM 私钥块、`AKIA`+16 位、`ghp_`/`github_pat_`/`xox*-`（服务端新增 `SecretContentDetected`）；更宽的前缀启发（如 `sk-`）**故意不做**并在注释里写明理由（误报会直接阻断作者发布） - **P0-b 规模检查不再被声明值骗**：两侧校验器改为**读取层封顶**——`by_index(index)?.take(declared_size + 1)` + 预分配收紧到单文件硬上限 + 多读 1 字节即判溢出、短读同样失败；压缩比分母从整包字节改为**该条目自身的压缩字节**；**同一修法同步到发行包校验器**（`package.rs` 原有同款洞），常量注释改成与实现一致（明确它不是整包炸弹防线） - **P0-c 嵌套包识别**：扩展名并集 `.zip/.tar/.gz/.tgz/.7z/.rar/.jar/.whl/.nupkg` + **magic bytes 嗅探**（zip/7z/rar/gzip/tar-ustar），改名成 `.dat` 也拦。**一处有证据的偏离**：`by_index_raw` 拿到的是**压缩流**（zip 2.4.2 文档与实测一致），按它嗅探会漏拦，因此改为对**已按声明大小封顶读出的解压内容**判 magic；客户端命中即报错并点名路径与格式 - **P1-b 执行级交叉证据（走 dev-dependency 路，未退化到 fixture）**：客户端 crate 加 `[dev-dependencies] module-game-distribution`，新测试用真实打包器产出字节喂给服务端 `validate_project_bundle_zip` 断言接受（并逐项比对摘要/字节数/条目顺序），再手造含 `.env` 与 `node_modules` 的包断言服务端独立拒绝 - 客户端同时补上**路径形状检查**（`BUNDLE_FORBIDDEN_PATH_CHARS` / `_SUFFIX_CHARS` / `_SEGMENTS` + `bundle_entry_path_shape_error`），修掉「macOS/Linux 上 `src/a?.ts`、`x.` 客户端能打、服务端必 422」的不一致；客户端压缩比预检也改按条目压缩字节 - 测试：`cargo test -p module-game-distribution` **73 passed**（+4）；AGC `cargo test -- project_bundle` **24 passed**（含交叉证据那条）；**发行包回归**：`cargo test -p api-server game_distribution` **60 passed / 0 failed**（`package.rs` 改动无行为回归，新增「声明说谎 → ReadFailed」用例） - 门禁：`cargo check --all-targets` 0；两端 `cargo fmt --check` 0；policy parity 0（服务端 51 条全被客户端覆盖）；DTO parity 0；schema 0；encoding 0；`git diff --check` 0
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 资产与编码规范。