Files

T

- 删除过时 PRD、设计、计划和退役文档
- 收口文档索引、产品基线、玩法链路和共享记忆
- 清理历史决策重复内容、断链和本机路径
- 更新 AGC Runtime、Provider、后端与运维当前约束

2026-08-26 10:11:46 +08:00

4.6 KiB

Raw Blame History

平台入口与玩法链路

更新时间：2026-08-25

本文只描述现役主站平台壳和图片画布编辑器链路。旧模板创作、生成、发布、公开业务详情及专属运行态不属于现役入口；历史持久化表仅按迁移白名单保留 schema 数据壳，不恢复旧业务行为。

现役平台入口

现役主站路由由 src/routing/activeAppPageRoutes.ts 固定，只有以下入口：

/creation：桌面端图片画布创作工具主页，读取编辑器项目与公开精选素材。
/project：桌面端图片画布项目列表；项目卡进入 /editor/canvas?projectid=<project_id>。
/profile：桌面端和移动端共用的“我的”稳定路由，承载账号、钱包、统计、充值、兑换码、反馈、通用设置、开发者 API Key 与法律信息等公共能力。
/editor/canvas：图片画布工作台；必须携带 projectid query。缺少项目 ID 时回到 /project，不创建隐式项目。

根路径 / 仍是平台壳入口；未知的旧玩法路径、旧运行态路径和旧作品详情路径按平台壳 fallback 处理，不再视为现役业务路由。

桌面端与移动端边界

桌面端侧边栏一级入口固定为 创作 / 项目 / 我的，分别进入上述现役路由；平台顶栏的搜索和账号操作只服务编辑器项目、已读取的公开精选素材及账户公共能力。
移动端底部 dock 只保留“我的”，根入口默认展示 /profile。进入站点壳时先显示 IP 欢迎遮罩，文案为“移动端仅支持作品展示”，只能点击“好”关闭；关闭状态只在当前页面生命周期内保留。
移动端直达 /creation、/project 或 /editor/canvas 时只显示桌面端创作提示，不挂载创作主页、项目列表或画布工具；提示底部保留唯一的“我的”Tab 作为返回入口。

现役数据源与契约

编辑器项目、素材和资源的 HTTP 路由由 server-rs/crates/api-server/src/modules/editor_project.rs 注册，DTO 与状态以 Rust 实现和共享契约为准：

项目列表：GET /api/editor/projects；最近项目：GET /api/editor/projects/recent。
项目详情与布局：GET/PATCH/DELETE /api/editor/projects/{project_id}；名称：PATCH /api/editor/projects/{project_id}/metadata。
项目资源：POST /api/editor/projects/{project_id}/resources；资源精选状态：PATCH /api/editor/project-resources/{resource_id}/showcase。
公开精选素材：GET /api/editor/showcase/resources；精选素材点赞：POST /api/editor/showcase/assets/{showcase_id}/likes。
项目内资产库：GET /api/editor/assets/library，以及 /api/editor/assets* 的现役增删改和精选提交路由。
资产上传和读取：先用 /api/assets/direct-upload-tickets、/api/assets/objects/confirm 完成直传登记，再通过 /api/assets/read-url 获取换签读取地址；前端不得把私有裸 path 当公开静态 URL。

/creation 的数据只由 CreationLandingView 调用编辑器项目与精选素材服务；不再读取旧玩法入口配置、旧模板卡、旧公开作品列表或旧运行态状态。前端只负责展示、交互和临时 UI 状态，项目、资源、生成任务与发布状态以后端 read model、资源清单和 revision 为准。

创建、打开与编辑链路

用户在 /creation 查看编辑器项目和精选素材，创建或选择一个编辑器项目。
项目列表 /project 读取当前账号项目；点击项目卡以 projectid 进入画布。
/editor/canvas?projectid=<id> 读取项目布局、资源和对话上下文；保存、重命名、资源登记、素材生成等动作全部走 api-server 编辑器路由。
生成或上传的资产先完成后端登记，再以换签 URL 回显；前端不自行推断项目状态，也不以本地摘要覆盖后端 revision。
/profile 仅承载账号及平台公共能力，不创建平行的项目或玩法链路。

退役与历史 schema 边界

旧玩法入口、模板工作台、旧创作/生成/发布 API、公开业务详情和专属运行态都不是当前契约；新代码和文档不得重新接入这些路径。历史表、迁移和必要兼容读取只为保留 schema 与既有数据，不构成旧功能可用性的承诺；任何 schema 删除、改名、重排或类型变更仍须先确认迁移计划。

资源安全规则

供应商密钥、Token、Cookie 和本地私密路径不得进入前端或文档示例。
生成或导入资产必须经过后端鉴权、对象确认和换签读取；上传失败或换签失败时显示可操作错误，不回退为公开裸路径。

4.6 KiB Raw Blame History