kdletters
c36a5170f8
Project CI / AI game creator shell Rust shard 1/4 (push) Successful in 5m28s
Project CI / AI game creator shell Rust shard 3/4 (push) Successful in 5m29s
Project CI / AI game creator shell Rust shard 4/4 (push) Successful in 6m6s
Project CI / AI game creator shell Rust shard 2/4 (push) Successful in 6m6s
Project CI / AI game creator shell Rust smoke (push) Successful in 1m46s
Project CI / AI game creator shell Rust crates (push) Successful in 2m51s
Project CI / Frontend tests (push) Successful in 4m44s
Project CI / Native shell tests (push) Successful in 6m31s
Project CI / Repository checks (push) Successful in 4m17s
Project CI / Backend tests (push) Successful in 7m48s
Project CI / AI game creator shell web tests (push) Successful in 3m43s
- 本地配置新增 llm.customEnabled 与 llm.visibleModels，显式开启后保留自定义连接和勾选列表，官方路由下仍清空凭据 - 配置迁移始终写出 customEnabled、visibleModels、apiKey、baseUrl、model、apiKind、reasoningEffort，便于手写自定义连接 - 新增 discover_game_creator_llm_models 命令，直连自定义端点 GET /models，限制超时与响应大小并脱敏错误 - codex_app_server 自定义模式改用配置里的地址与 Key 走本地凭据代理，不再经过平台 /api/llm，也不回退官方路由 - 模型目录按官方与自定义来源隔离缓存，自定义模式只展示勾选模型，选项失效时回退第一项 - 设置页在自定义模式展示 API 地址、API Key、协议与推理档，并提供模型读取、搜索、勾选与已勾选预览 - 补齐固定项排版与读取按钮样式，同步 AGC 模型选择规范、实施计划与共享概览
86 lines
9.1 KiB
Markdown
86 lines
9.1 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
|
||
|
||
- AGC 的本地 `llm.customEnabled` 默认关闭，只能手动修改配置文件；开启后设置支持自定义 Responses 端点、读取 `/models`、勾选和预览 `visibleModels`。对话下拉只显示勾选项，LLM 请求经客户端凭据代理直连自定义上游；不会回退官方中转，平台资源服务仍使用账号权限。详见 AGC 后台模型别名与对话选择规范。
|
||
|
||
- DirectProject 对话先在完整历史中按回合/原始 item 身份关联，再分页渲染；每个回合只有一个呈现入口。有流按 item `seq` 交替文本和工具，无流采用历史正文；禁止位置猜配或同时展示累计回复与 item 正文。流写入单调归并，收尾等待落盘任务，不按磁盘“最后一段”猜最终回复位置。详见 AGC 实施计划的“DirectProject 回合展示唯一归属”。
|
||
- 回合生命周期只由活动 client 回合快照和 Direct 事件恢复；Provider 的历史终态通知不能创建活动 client 回合。消息发送时间保存在历史信封，原始 item 不混入宿主字段；完成后的中间文本和工具默认收进“执行过程”，最终回复及失败提示保持可见。
|
||
|
||
- AGC 安装产品名统一为“陶泥儿”，由 Tauri `productName` 控制安装项、快捷方式与 EXE 产品描述；Windows 内置 Codex 安装到顶层 `coding-agent/win-x64/`，打包资源映射与运行时查找路径必须一致。内部可执行文件名与应用 identifier 保持稳定。
|
||
|
||
- 新 Web 游戏为 `game/` 下的 npm + Vite + Phaser 4.2.1 工程，使用包导入且允许其它依赖；npm 预览与导出只读取 dist，运行素材需纳入构建。单 HTML → Phaser 迁移固定走 DirectProject：文件落盘后先用受控 `project.bootstrap` 在 `game` 执行无参数 `npm install`，再用支持相对 cwd 的 `project.verify` 构建并确认 `game/dist/index.html`，已有单 HTML/Godot 不通过 JSON Generator 伪装成 npm 工程。
|
||
|
||
- 通用 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`；付费资源调用仍由客户端绑定回合、幂等账本、请求上限和投影权威。
|
||
- 2026-09-09 起，AGC 已新增遵循 OpenAI Agent Plugins 组合模型的通用 Plugin Host/SDK：Plugin、Skill 和 MCP 进入统一扩展 catalog；插件生命周期、行分隔 JSON-RPC、UI 面板、Capability Registry、权限和审计由 `plugin_host` 统一承接，Skill/MCP 仍分别交给各自现有 loader/transport；目标编辑器只通过通用 `EditorAdapter` 扩展点接入。详见 `docs/technical/【技术方案】AGC通用插件宿主与编辑器适配-2026-09-09.md`。
|
||
- 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、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的材料不再作为实现依据。
|