DreamWeaver/dreamweaver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: describe asset completion results

Browse Source
This commit is contained in:
Yuyan
2026-04-18 13:26:58 +08:00
parent f1cbd202ab
commit 0444b81df6
3 changed files with 89 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
docs/planning/week-1-execution-backlog.md
View File

@@ -69,12 +69,13 @@
- 普通故事封面生成/重试
- 绘本缺失插图补全
- 故事音频缓存读取与 TTS 生成
- 已引入首版服务层 `AssetCompletionResult`，用于统一表达资产补全结果
### What Is In Progress
- 统一状态模型与统一外部 API 已落地，内部 service workflow 已开始收束公共步骤
- 旧生成 API 仍保留为兼容层，后续需要继续降低重复实现
- 资产补全已经具备统一重试入口首版，封面/绘本插图/音频已有 asset completion helper；后续需要继续抽象 generation job 边界
- 资产补全已经具备统一重试入口首版，封面/绘本插图/音频已有 asset completion helper 与结果对象；后续需要评估是否落库为 generation job
### What Is Still Pending

7
docs/product/unified-generation-workflow-prd.md
View File

@@ -43,13 +43,14 @@ DreamWeaver 当前同时支持普通故事生成、完整故事生成和绘本
- 上下文准备：档案/宇宙校验 + memory context 构建
- 主记录保存：文本故事与绘本统一持久化入口
- 资产补全：普通故事封面、绘本缺失插图、故事音频缓存/生成统一封装
- 已引入首版服务层 `AssetCompletionResult`，用于表达资产补全类型、状态、结果值、错误信息和是否阻塞主结果
- 故事详情页封面补全已切换到统一资产重试入口
- 管理端前端构建阻塞已修复，主前端与 admin 前端均可完成生产构建
### Still Missing
- 普通故事、完整生成、绘本生成已有统一外部入口，内部 workflow 已开始抽取公共步骤，但旧 service 函数仍作为兼容层保留
- 统一资产重试入口仍是首版：已覆盖普通故事封面、绘本缺失插图、故事音频，并已抽出 asset completion helper，但尚未抽象成完整 generation job 模型
- 统一资产重试入口仍是首版：已覆盖普通故事封面、绘本缺失插图、故事音频，并已抽出 asset completion helper 与 `AssetCompletionResult`，但尚未落库为完整 generation job 模型
- `partial_ready`、`retryable_assets` 等更细粒度状态仍停留在目标态
### What This Means
@@ -65,10 +66,10 @@ DreamWeaver 当前同时支持普通故事生成、完整故事生成和绘本
DreamWeaver 当前存在以下工作流层面问题：
1. **生成入口已建立，内部路径正在收束**
当前前端已切到 `/api/generations`，旧的 `/api/stories/generate`、`/api/stories/generate/full`、`/api/storybook/generate` 仍作为兼容入口保留。service 内部已抽取上下文准备、主记录保存、封面补全、绘本插图补全和音频补全 helper，下一步重点是把这些 helper 组织成更明确的 generation job 边界。
当前前端已切到 `/api/generations`，旧的 `/api/stories/generate`、`/api/stories/generate/full`、`/api/storybook/generate` 仍作为兼容入口保留。service 内部已抽取上下文准备、主记录保存、封面补全、绘本插图补全和音频补全 helper，并用 `AssetCompletionResult` 表达资产补全结果。下一步重点是决定这些结果是否需要进一步沉淀为可查询的 generation job。
2. **保存与资产补全过程正在统一**
文本故事和绘本已拥有更清晰的主记录保存 helper；普通故事封面、绘本缺失插图、故事音频生成/缓存已共用各自的 asset completion helper。剩余差异集中在还没有统一的 job 对象来描述资产任务。
文本故事和绘本已拥有更清晰的主记录保存 helper；普通故事封面、绘本缺失插图、故事音频生成/缓存已共用各自的 asset completion helper。服务层已经能表达资产任务结果，剩余差异集中在还没有持久化 job 对象。
3. **状态表达不统一**
系统缺少标准的“生成中、部分完成、已完成、失败、可重试”等状态定义，导致前端难以做出成熟体验。