e5f537c807a14f2f4f874f01c2367c0ac2725ebe
首轮委派 task 由 Supervisor 自由撰写,实测它每次都把提问条件写成一个高门槛: 「若确有缺少且会实质改变结果的用户事实……否则直接创建并提交完整 GDD」。本机 13 个生产 project 里 8 个是 0 轮直出,CLI 同参基线 8 个 run 也有 3 个 0 轮、 均值 0.75 轮、无一顶满 3 轮预算。 病根是提问门槛这件事同时写在两个地方而且口径相反:plan/common.md 告诉 Supervisor「专业 Agent 若缺少会实质改变结果的用户事实才提问」,Supervisor 照抄 进 task;而子 Agent 的 role brief 只写了 3 轮上限,没写默认姿态、没有判断该不该 问的程序、也没有它自己两次引用的那份「默认建议」清单到底是什么。 按原型的做法收口——两边各一份闭集白名单,不给「可以无视 task」的授权: - roles/project-planning.md:出稿触发器收成四个(任务正文出现「直接出稿」四个字 / 已完成第 3 轮 / 剩余空白能被默认建议覆盖且不影响首个可玩闭环 / Runtime 超时 提示),任务正文能改变流程的只有第一条。Supervisor 写的门槛不在其中,自然不是 触发器,不需要授权无视。补上字段差距检测(逐项对照 plan-submit-gdd-input.v1 的 game 字段三分类,提问名额只花在空白项)和那份缺席的默认建议清单。 - plan/supervisor-playbook.md:本轮指令三选一(继续澄清 / 直接出稿 / 按意见修订), 不得自撰提问条件。独立成段,因为 both_playbooks_carry_the_same_anti_pre_deciding_contract 要求共享段在两条 lane 逐字相同,并进去就得改做游戏 lane。plan/common.md 那句病根改不动(planCommon 受逐字子集断言约束,且通用 common.md 的口径对其它专业 Agent 是对的),只能覆盖。 默认建议按本仓库的 GDD schema 重排,没有照抄原型:原型的「缺成长 / 缺探索 / 缺构建」三条落到 plan-submit-gdd-input.v1 上全在 pillars 与 coreLoop,而那两个字段 就是首个可玩闭环本身,给它们配默认值等于把最该花提问预算的两项默认掉,和 「提问顺序:核心行为与本局目标 → 重玩动力」的前两顺位直接打架。故清单只覆盖 genre.fusion / artStyle / targetUsers / outOfScope,并明写 pillars 与 coreLoop 没有默认建议。 实测(8 vs 8,同一句开场白、同一条 --swarm-chat --plan、同一个模型、决策卡一律 选 A):轮数均值 0.75 → 2.62,0 轮 3/8 → 0/8,顶满 3 轮 0/8 → 6/8;Supervisor 在 首轮 task 里写提问门槛 8/8 → 0/8。这会让用户明显感到问得多了,是有意的产品取舍。 补一条断言:这份 role brief 此前两次要求「按默认建议填写」却从未写出清单,就是 因为没有任何测试看着它。新断言钉住清单在场、按 schema 字段名写、pillars 与 coreLoop 被排除、出稿触发器是闭集。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Genarrative / 陶泥儿
一个 AI 原生互动内容与小游戏平台,当前主站聚焦图片画布创作、项目与素材管理,以及账号、钱包和后台管理等平台公共能力。
当前已经具备这些主要能力:
- 图片画布编辑、项目与素材管理
- 图片、视频、音频等外部生成任务
- 账号、钱包、充值、兑换码与个人资料
- 后台运营、配置与生产运维工具
- AI 游戏创作独立 App
运行
前置条件:
- Node.js
- Rust / Cargo
- SpacetimeDB CLI
安装依赖:
npm install
准备环境变量:
- 复制
.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-05-15 完成压缩整理,旧 PRD、设计、审计、阶段计划和技术流水账不再作为实现依据。当前只读取:
- 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:本地启动、检查、部署、埋点和运营查询。
- UI_CODING_STANDARD.md:像素 UI 资产与编码规范。
Description
Languages
Rust
54.6%
TypeScript
26.2%
JavaScript
9.9%
Java
3.5%
Go
3%
Other
2.6%