kdletters
1498247e9f
新增 npm + Vite + Phaser 4.2.1 游戏工程脚手架 允许 DirectProject 在项目边界内安装依赖并执行构建 让预览、静态检查、投影和试玩导出统一使用 dist 产物 补充 Phaser Skill、技术方案、项目记忆和定向测试
78 lines
6.9 KiB
Markdown
78 lines
6.9 KiB
Markdown
# Genarrative 项目共享概览
|
||
|
||
更新时间：`2026-08-25`
|
||
|
||
## 一句话定位
|
||
|
||
Genarrative / 陶泥儿当前主站聚焦图片画布创作、编辑器项目与素材管理，以及账号、钱包、公共设置、后台管理和小程序 WebView 外壳。AI Game Creator（AGC）是独立的桌面创作 App，按 DirectProject Runtime 合同执行，不复用主站旧玩法入口。
|
||
|
||
产品 IP / 产品形象统一为 `public/branding/taonier-product-ip.png`：陶罐中探出的橙色耳朵形象。
|
||
|
||
## 当前主要能力
|
||
|
||
- 图片画布编辑器、编辑器项目、项目资源与公开精选素材。
|
||
- 账号、短信 / 密码 / 微信登录、个人资料、钱包、充值、邀请码、反馈、法律信息和后台管理。
|
||
- AGC DirectProject 的受限 Codex 工作区、客户端资源工具和 UI workflow。
|
||
|
||
## 当前入口与移动端边界
|
||
|
||
- 桌面端一级入口：`创作 / 项目 / 我的`，对应 `/creation`、`/project`、`/profile`。
|
||
- 图片画布工作台：`/editor/canvas?projectid=<id>`；缺少 `projectid` 时回到项目入口。
|
||
- 移动端底部 dock 只保留“我的”，根入口默认 `/profile`；站点壳进入时显示 IP 欢迎遮罩，点击“好”后本次页面生命周期内关闭。
|
||
- 移动端直达 `/creation`、`/project` 或 `/editor/canvas` 时显示桌面端创作提示，不挂载对应工具页面；提示底部保留唯一的“我的”Tab。
|
||
|
||
## 本地开发端口真相
|
||
|
||
`scripts/dev.mjs` 的默认值是 Web `3000`、API `8082`、BgFilter worker `8083`、SpacetimeDB `3101`、后台 Web `3102`。Linux 用户端口段会把这五个服务映射到 `start` 至 `start+4`，AGC Vite 使用 `start+5`；显式端口或端口段配置可覆盖默认值。
|
||
|
||
端口的运行时权威始终是当前工作区的 `.app/dev-stack.json` 与启动日志（该文件可能在未启动时不存在），不得从文档默认值推断当前监听端口。前端代理、API URL、SpacetimeDB 地址和 AGC Vite 地址都必须读取同一份运行时状态。
|
||
|
||
## 当前后端路线
|
||
|
||
唯一有效后端路线：
|
||
|
||
```text
|
||
server-rs + Axum + SpacetimeDB
|
||
```
|
||
|
||
SpacetimeDB crate、SDK、CLI / standalone 与生成 bindings 按 `2.8.3` 对齐；CLI / standalone commit 固定核对为 `8e410d2842147bd8e5a32a9589cc00c19f7478e2`，官方发行包和容器镜像使用 `v2.8.3` 标签。
|
||
|
||
职责边界：
|
||
|
||
- `api-server`：HTTP / SSE / BFF 门面和外部副作用编排。
|
||
- `spacetime-module`：SpacetimeDB 表、reducer、procedure、事务 adapter 和 row mapper。
|
||
- `spacetime-client`：后端访问 SpacetimeDB 的 typed facade。
|
||
- `module-*`：领域模型、命令、应用规则、领域事件和领域错误。
|
||
- `platform-*`：OSS、LLM、认证、语音等外部平台能力。
|
||
- `shared-contracts` / `packages/shared`：前后端 DTO、公开契约和无业务真相的共享 TypeScript 代码。
|
||
- 前端：表现、交互、临时 UI 状态和后端结果渲染，不承接正式业务真相。
|
||
|
||
旧 `server-node`、Express、PostgreSQL、Go、`maincloud` 和人工 `spacetime --root-dir` 均不是现役路线。
|
||
|
||
## AGC DirectProject 与 UI workflow
|
||
|
||
- 新 Web 游戏为 `game/` 下的 npm + Vite + Phaser 4.2.1 工程，使用包导入且允许其它依赖；npm 预览与导出只读取 dist，运行素材需纳入构建，已有单 HTML/Godot 不自动迁移。
|
||
|
||
- 通用 Agent Rust 分层为 `agent-runtime-core`（catalog、执行生命周期、ToolHost/spawn/all-join/Provider 契约）、`agent-runtime-orchestration`（动态无环任务图、ready、依赖波次、返工下游闭包和受限自主扩图提案）与 `platform-agent` 游戏适配器；循环返工通过新 pass / epoch 表达，不在单张依赖图中建立回边。LLM 可经宿主结构化 function call 提出新增节点/边，编排层只生成经校验的新候选图，epoch 与持久化仍由宿主掌控。
|
||
- DirectProject 始终连接客户端内置的 `agc_tools` STDIO MCP，并在启动时额外读取客户端扩展仓库中已启用的第三方 MCP 独立项。第三方 STDIO/HTTP 配置只写入本次隔离 `CODEX_HOME`，单项非 required，启停、重命名和内容指纹进入 app-server pool identity；完整 Plugin Runtime、hooks/apps 和单文件脚本手动指定入口仍关闭。Skill 正文与 references 由 Codex 原生按需读取；`agc_tools` 负责标准美术准备、已登记资源有界查询、视频 / 角色动画 / 音效 / BGM 的 create-or-derive、已登记图片去背景、desktop/mobile 浏览器试玩和受控 `agc_web_search`；付费资源调用仍由客户端绑定回合、幂等账本、请求上限和投影权威。
|
||
- DirectProject 的 Codex 原生文件、搜索、命令、图片查看和 Skill 仅在用户项目 cwd 与 `workspaceWrite(writableRoots=[project])` 内可用；原生命令允许联网以支持 npm 安装，npm 缓存位于项目内 `.npm-cache/`。多 Agent、Apps、插件、hooks、图片生成、Goals、Workspace Dependencies、Tool Suggestion 和原生浏览器/电脑控制保持关闭。app-server 使用隔离 `CODEX_HOME`，provider 凭据只由 AGC 客户端代理持有，不能进入模型上下文或 shell 环境。
|
||
- `ui-prototype`（设计图片）与 UI 编辑器 `UI` JSON 是不同资源。白名单 `ui.workflow.run` 按页面执行 `prepare → recognize → status → finalize`，由 provider-backed 识别、合并和组件绑定持久化 State/revision，并把 `reference-ready → structure-ready → merge-ready → binding-ready → application-ready → completed` 投影到 manifest。Provider 缺失、请求失败、工具缺失、结果不匹配或仍有待审节点时保留真实阶段并返回 blocker，不得用 deterministic seed 伪造完成。
|
||
- UI workflow 的资源桥接与 Runtime 边界以 `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md` 和 AGC 实施计划的 2026-08-24 覆盖段为准；只生成图片、登记空 JSON 或进入普通图片画布都不构成 workflow 完成。
|
||
|
||
## 退役边界
|
||
|
||
全部旧创作模板及其创作、生成、发布、公开业务详情与专属运行态已于 `2026-07-17` 退役。历史表和迁移仅按最小 schema 数据壳保留；旧前端、API、worker、procedure / reducer 和纯业务 crate 不属于当前编译或运行能力，不能重新作为兼容目标。
|
||
|
||
## 当前文档入口
|
||
|
||
- `docs/README.md`
|
||
- `docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md`
|
||
- `docs/【项目基线】当前产品与工程约束-2026-05-15.md`
|
||
- `docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`
|
||
- `docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`
|
||
- `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
- `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`
|
||
- `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md`
|
||
|
||
旧 PRD、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的材料不再作为实现依据。
|