Files

T

k88936 6fe91a169c 移除 AGC Skill 受控引用读取工具

删除 agc_read_skill_resource 的实现、MCP 暴露、审计分支与专用测试

将内置 Skill references 改为 Codex 原生相对路径读取

同步 Skill manifest 指纹、Runtime 提示词与 AGC 项目文档

保留既有 references 安装与隔离 HOME 校验

2026-09-02 19:00:31 +08:00

6.6 KiB

Raw Permalink 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，并在启动时额外读取客户端扩展仓库中已启用的第三方 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 仅在真实 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、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的材料不再作为实现依据。

6.6 KiB Raw Permalink Blame History Unescape Escape