docs: update play type integration decisions

This commit is contained in:
kdletters
2026-05-20 21:53:12 +08:00
parent 1997de0f1a
commit 01da85a577

View File

@@ -1,6 +1,6 @@
---
name: genarrative-play-type-integration
description: 在 Genarrative 中新增一个创作入口/玩法类型时,按入口配置、前端分流、契约、后端接口、工作台、结果页、可选 runtime 与作品架的顺序接入。
description: 在 Genarrative 中新增或补齐一个创作入口/玩法类型时,按入口配置、前端分流、契约、后端接口、工作台、独立生成页、结果页、发布、统一作品详情、正式 runtime、公开 read model、基础统计与作品架/广场的顺序接入。
license: MIT
metadata:
author: Hermes Agent
@@ -40,10 +40,43 @@ metadata:
- 创作入口
- 工作台
- 草稿生成
- 独立生成页(如果存在自动资产生成)
- 结果页
- 发布
- 统一作品详情页
- 试玩 runtime
- 作品架 / 广场 / 分享
- 公开作品卡 / 作品架 / 广场 / 分享
- 正式 runtime 统计
## 公开闭环决策点
新增玩法如果要作为公开作品交付,先按这些决策点对齐,不要直接套某个玩法的具体字段或 UI
```text
创作入口 / 工作台
-> 草稿保存 / 编译
-> 独立生成页(自动素材,可选但推荐)
-> 结果页(确认、单槽重试、上传、发布)
-> 统一作品详情页 /works/detail?work=<公开作品码>
-> 正式 runtime
-> 基础统计 / 公开 read model
-> 作品架 / 发现流 / 分类推荐 / 今日卡片
```
必须先做这些决策:
1. **公开作品身份**:是否需要公开作品码;前缀、解析入口、分享 URL 和统一作品详情页如何映射。
2. **编辑契约边界**:哪些字段是 v1 公开编辑语义;旧字段是兼容、迁移、只读展示,还是明确不兼容。
3. **生成阶段归属**:是否有自动素材生成;生成动作放在工作台、独立 `*-generating` 页,还是结果页手动触发。
4. **失败承接策略**:全部失败、部分失败、单槽失败分别进入哪个页面;错误态由生成页还是结果页承接。
5. **结果页能力边界**:结果页只做确认 / 单槽重试 / 重新生成 / 上传,还是还允许批量生成、规则编辑或资源配置。
6. **发布后去向**:发布成功后默认进入统一作品详情页;只有明确需要时才新增专属详情页。
7. **公开卡片资产来源**:封面是复用已有素材合成、使用首图、还是新增独立封面资产。
8. **公开读取路径**:广场 / 发现流读取 SpacetimeDB view 或 public read modelapi-server 是否需要订阅缓存,避免每请求 procedure 热路径。
9. **runtime 模式差异**`draft``published` 的输入能力、mock/debug 开关、鉴权、开始条件是否不同。
10. **正式统计口径**:哪些 runtime 事件写正式统计草稿试玩、mock、debug 是否必须排除。
11. **规则参数归属**:哪些配置是创作者可编辑;哪些阈值、时长、冷却、计分、反作弊、裁决规则必须留在后端规则集。
12. **旧数据策略**:旧草稿、旧发布配置、旧分享码是迁移、降级展示、重新生成,还是明确不兼容。
## 推荐接入顺序