AIGameCreator App
72a6d635da
新增独立 Tauri 壳 apps/ai-game-creator-shell，只保留聊天入口，正式用户窗口不承载游戏预览画面，开发模式通过独立窗口展示任务、文件、记忆、预览和日志 新增游戏创作专业组与种子任务图契约，覆盖策划/美术/程序/数值/音乐/运营 6 组下 15 个组内角色 新增共享契约本地项目 manifest、内置命令权限枚举、run trace schema 和 ready-task 选择器 扩展平台 LLM 支持流式请求，增加 GENARRATIVE_GAME_CREATOR_LLM_STREAM 开关 新增 AI 游戏创作 App 的聊天命令集：/help /capabilities /audit /project /llm-status /status /files /assets /read /tasks /trace /smoke /run /preview /preview-status /preview-open /preview-stop /memory /remember /forget-memory /canvas /sync-canvas-project /import-canvas-asset /import-canvas-export 新增本地项目初始化、权限 gate（pending/confirm/cancel）、文件上传、受限命令白名单 game.static_smoke 和本地 HTTP 预览 新增 Planner / 6 组角色 agent / Generator / Evaluator / ArtifactWriter / Playtest 文件驱动 loop，最多 3 轮返工，结构化 repairRoutes 新增实时 run trace 写入 .agent/run.latest.json 与 .agent/runs/，包含 taskGraph、passPlans 和步级 toolCalls 新增短期/长期记忆 memory/session.md 和 memory/project.md，支持聊天读取/追加/覆盖/删除 新增画板对接：canvas.project_open、canvas.project_sync、canvas.asset_import、canvas.export_import 新增 npm run ai-game-creator-shell:check 开发验收入口，覆盖 typecheck、单元测试、端到端 smoke 新增 check:native-shells 静态守门：release 只登记 main 聊天窗口，CSP 禁止内嵌预览，开发窗口只在 debug 下打开，用户侧预览命令必须调用 open_local_game_preview
7.4 KiB
7.4 KiB
AGENTS.md
入口定位
- 本文件只保留 Agent 进入仓库后必须立即遵守的最高优先级规则；完整执行细则见
docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md。 - 团队级长期项目记忆位于
docs/project-memory/，供 3 名开发人员和各自本地 Agent 通过 Git 同步。 .hermes/只保存 Hermes 专用仓库级工具资源，例如 skills、plugins 和启用说明；长期项目知识不要写入.hermes/。- 若
docs/project-memory/shared-memory/与当前代码或最新docs/冲突，以代码和最新docs/为准，并同步修正过期共享记忆。
开始任务前
- 简单自包含任务可以直接执行；复杂开发、跨模块修改、后端 / UI / 文档体系调整前，按顺序读取：
- 落地工程修改前，先确认是否已有足够具体的 PRD、技术方案或当前融合文档；文档仍存在编码级歧义时，先补文档再编码。
- 本仓库的本地 RAG 位于
scripts/rag/；RAG 只作为候选上下文，不替代打开源文件核对。默认不安装 RAG 运行时依赖，需要启用时必须先询问用户，并只安装到 gitignored 的.rag/runtime/。
绝对约束
- 禁止提交个人
~/.hermes配置、.env、API Key、Token、Cookie、会话记录、认证文件、本地私密路径、构建产物、日志、缓存和数据库 dump。 - 不要在
.gitignore中新增.env.local。 - 不要擅自把现有中文文案、注释、剧情或文档改写成英文；看到中文乱码时先确认真实编码，不要沿用乱码或用英文替换。
- 修改包含中文的文件时优先局部补丁，避免整文件重写；修改后优先运行仓库编码检查。
- 后续新增 Markdown 文档文件名必须以分类标签开头，格式为
【标签名】中文标题-日期.md；历史文档不要求批量重命名，除非本次任务明确涉及。 - 工程修改要同步更新对应
docs/文档；产生长期有效的架构约定、接口变化、排障经验、开发流程或协作规则时，同步更新docs/project-memory/shared-memory/。 - 默认保持系统简洁：优先复用、修改、扩展现有系统、页面和公共组件，不新建平行系统或平行页面。
- UI 面板中不要默认写功能说明、规则描述或开发解释文案；移动端优先，同时保证网页端可正常显示和操作。
- 点击按钮弹出独立面板的设计，不要实现成在当前面板下面追加内容。
任务路由
- Issue 使用自托管 Gitea；优先用 Gitea UI/API 或
teaCLI，不使用 GitHubgh或 GitLabglab，除非仓库已迁移。默认 triage 标签：needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。 - 需要仓库级 Hermes skills/plugins 时，再读取
.hermes/README.md。 - 涉及 AI 游戏创作独立 App、多智能体 Runtime、本地项目产物或本地 HTTP 预览时，先读取
docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md。 - 新增、补齐、迁移或重构玩法入口、玩法类型、创作工作台、生成页、结果页、发布、运行态、作品架、广场或公开 read model 前，必须读取并按
genarrative-play-type-integration执行。 - 涉及
npm run dev/npm run dev:spacetime/npm run dev:api-server/npm run dev:web/npm run dev:admin-web的端口探测、端口漂移、SpacetimeDB publish server、api-server 环境变量、Vite 代理目标或后台 dev 端口时，按.hermes/skills/genarrative-dev-stack-port-routing/SKILL.md执行。 - 涉及 SpacetimeDB 的设计、实现、脚本、调试、发布、绑定生成、schema、reducer、procedure、view 或 Rust API 时，必须读取并按
spacetimedb-cli、spacetimedb-rust、spacetimedb-concepts中相关 skill 执行。
后端红线
- 后端最新技术约束以
docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md为准。 - 后端路线固定为
server-rs + Axum + SpacetimeDB；旧server-node、Express、PostgreSQL、Go 服务端、maincloud/Maincloud/MAINCLOUD只作为历史残留，不作为兼容目标。 - DDD 分层边界按总纲执行：领域规则沉到
module-*，SpacetimeDB 表和事务编排留在spacetime-module，后端访问 SpacetimeDB 统一经spacetime-clientfacade，HTTP/SSE/BFF 留在api-server，外部副作用留在platform-*，前后端 DTO 留在shared-contracts。 - 前端只做表现、交互和临时 UI 状态，不承接正式业务真相，不绕过后端投影或后端 API 直接实现业务规则。
- 契约、路由、DTO 去留和 breaking change 以当前后端架构文档、
server-rs/crates/api-server/src/app.rs、shared-contracts和packages/shared为准；不得在前端、api-server或临时兼容层中重新发明旧接口。 - SpacetimeDB 已有表新增字段时，字段必须放在 Rust 表结构体最后，并设置明确默认值；需要删除、改名、重排或改类型时，必须先询问用户并确认迁移计划。
- 修改 SpacetimeDB schema 后必须同步
migration.rs、表目录和生成绑定，并运行npm run check:spacetime-schema。 - 除 CI/CD 脚本内部受控用法外，人工命令、本地联调、排障步骤和文档示例禁止继续使用
spacetime --root-dir。
验证与提交
- 修改后按范围运行定向测试、类型检查、
npm run check:encoding和git diff --check；后端 API smoke 使用npm run dev:api-server拉起后端并检查/healthz。 - 修改 SpacetimeDB schema 后追加
npm run check:spacetime-schema；涉及发布或生产运维时按当前开发运维文档和脚本门禁执行。 - 提交代码时，提交标题必须使用中文；标题后逐行写明本次提交修改了什么，每条变更单独一行。
文档图谱
docs/
├─ README.md
├─ 【协作规范】Agent工作入口与执行准则-2026-06-22.md
├─ 【项目基线】当前产品与工程约束-2026-05-15.md
├─ 【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md
├─ 【玩法创作】平台入口与玩法链路-2026-05-15.md
└─ 【开发运维】本地开发验证与生产运维-2026-05-15.md