kdletters
c36a5170f8
- 本地配置新增 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 模型选择规范、实施计划与共享概览
9.1 KiB
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
-
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_toolsSTDIO 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 编辑器UIJSON 是不同资源。白名单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.mddocs/【协作规范】Agent工作入口与执行准则-2026-06-22.mddocs/【项目基线】当前产品与工程约束-2026-05-15.mddocs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.mddocs/【玩法创作】平台入口与玩法链路-2026-05-15.mddocs/【开发运维】本地开发验证与生产运维-2026-05-15.mddocs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.mddocs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md
旧 PRD、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的材料不再作为实现依据。