GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 15 Pull Requests 3 Actions Packages Projects 3 Releases Wiki Activity
Files
e746559dc05365099a577fcdbfdab19649347bb9
Genarrative/docs/project-memory/shared-memory/project-overview.md
T
kdletters d2254d1e8c
Project CI / Repository checks (push) Successful in 2m16s
Details
Project CI / Frontend tests (push) Successful in 6m37s
Details
Project CI / Backend tests (push) Failing after 7m45s
Details
Project CI / Native shell tests (push) Failing after 7m6s
Details
抽取多 Agent 编排 crate 并支持运行中自主扩图 (#207) 
## 概要

- 抽取通用 `agent-runtime-orchestration` crate，承接多 Agent DAG 的构图校验、ready/wave、下游闭包和全量/返工选择。
- 保留 `platform-agent` 的游戏领域任务与语义路由，避免把 Runtime、Provider、ToolHost 和持久化职责下沉到公共编排层。
- 增加 `GraphProposal` / `TaskProposal` / `GraphEdge` / `GraphLimits`，允许宿主在执行中安全应用 LLM 提出的新增节点和边。
- 扩图采用候选图原子校验：未知 Agent/端点、重复边、自依赖、环及节点/边/深度/扇出预算都会拒绝，失败时原图保持不变；新增节点默认为 `Pending`。

## 验证

- `npm run agent-runtime-orchestration:check`（15 项通过）
- `cargo test --manifest-path server-rs/crates/platform-agent/Cargo.toml`（19 项通过）
- `npm run agc:skill-pack:check`
- `npm run check:encoding`
- `git diff --check`

前端 typecheck 本轮未执行：当前工作树未安装 `node_modules/tsc`，命令会报 `tsc is not recognized`。

Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/207
2026-08-31 10:51:11 +08:00

6.2 KiB
Raw Blame History

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 地址都必须读取同一份运行时状态。

当前后端路线

唯一有效后端路线：

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

  • 通用 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。它负责审核引用读取、标准美术准备、已登记资源有界查询、视频 / 角色动画 / 音效 / BGM 的 create-or-derive、已登记图片去背景、desktop/mobile 浏览器试玩和受控 agc_web_search；付费资源调用由客户端绑定回合、幂等账本、请求上限和投影权威。
  • DirectProject 的 Codex 原生文件、搜索、命令、图片查看和 Skill 仅在真实 game/ cwd 与 workspaceWrite(writableRoots=[game]) 内可用；原生命令网络保持关闭。多 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、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的材料不再作为实现依据。

Reference in New Issue View Git Blame Copy Permalink