82 lines
3.6 KiB
Markdown
82 lines
3.6 KiB
Markdown
# Change: 增加 Suno 歌词任务与画布落地适配
|
||
|
||
## Why
|
||
|
||
当前仓库已经具备 Suno 音乐生成的基础闭环：
|
||
|
||
- `audio` 已经是一等生成模态
|
||
- Suno 音乐提交与轮询已经有专门的 adapter / service
|
||
- 任务队列、自动插入和画布音频节点都已经围绕“音频资产”建立了展示和落地路径
|
||
|
||
但 `suno lyrics` 会打破当前实现里的一个默认前提：
|
||
|
||
- 它沿用 Suno 的提交与查询链路
|
||
- 但最终产物不是音频 URL，而是 `title / tags / text` 形式的文本结果
|
||
|
||
如果继续沿用当前“`audio` 任务必然产出可播放 URL”的假设，就会出现三类问题：
|
||
|
||
- 提交层无法选择 `/suno/submit/lyrics`
|
||
- 结果提取层会因缺少 `audio_url` 而把任务判定为无结果
|
||
- 任务队列、自动插入和画布会把歌词结果错误地当成音频卡片处理
|
||
|
||
因此需要把 Suno 的“提交动作”和“最终结果类型”显式拆开，并把歌词任务融入现有队列与画布能力中。
|
||
|
||
## What Changes
|
||
|
||
- 在现有 `audio / suno` 路由体系内新增 `lyrics` 动作
|
||
- 让 Suno 请求显式区分：
|
||
- 提交动作：`music` / `lyrics`
|
||
- 结果类型：`audio` / `lyrics`
|
||
- 新增 `POST /suno/submit/lyrics` 提交适配，并继续复用 `/suno/fetch/{task_id}` 轮询
|
||
- 为歌词查询结果增加标准化提取，保留 `text / title / tags / providerTaskId`
|
||
- 调整任务结果模型与持久化结构，使文本歌词结果不再依赖媒体 URL
|
||
- 在任务队列中为歌词任务提供独立展示与操作，而不是复用音频卡片假设
|
||
- 在画布中将歌词结果插入为文本或 markdown 卡片，而不是音频节点
|
||
- 在音频输入模式中增加动作切换，并让音乐专属参数只在 `music` 动作下展示
|
||
|
||
## Scope
|
||
|
||
### In Scope
|
||
|
||
- `lyrics` 动作的 submit / fetch / normalize 闭环
|
||
- 继续复用现有 `audio` 默认路由，不新增独立的 `lyrics` 默认路由
|
||
- 新增 `sunoAction` 和歌词结果字段
|
||
- 任务队列中的歌词任务展示、重试、恢复和插入能力
|
||
- 画布文本插入路径对歌词结果的适配
|
||
- 自动插入路径根据结果类型在音频卡片与文本内容之间分流
|
||
|
||
### Out Of Scope
|
||
|
||
- 独立的歌词编辑器或画布内富文本歌词组件
|
||
- 一键把歌词任务自动串联成音乐生成任务
|
||
- `suno-tags`、`suno_act_tags`、`suno-midi` 等其他 Suno 辅助动作
|
||
- 为歌词结果新增独立的默认模型类型或独立的产品入口页
|
||
|
||
## Impact
|
||
|
||
- Affected specs:
|
||
- `audio-generation`
|
||
- `generation-task-queue`
|
||
- `canvas-generated-text`
|
||
- Affected code:
|
||
- `packages/drawnix/src/services/audio-api-service.ts`
|
||
- `packages/drawnix/src/services/model-adapters/*`
|
||
- `packages/drawnix/src/services/provider-routing/*`
|
||
- `packages/drawnix/src/types/shared/core.types.ts`
|
||
- `packages/drawnix/src/services/task-queue-service.ts`
|
||
- `packages/drawnix/src/services/task-storage-reader.ts`
|
||
- `packages/drawnix/src/services/media-executor/task-storage-writer.ts`
|
||
- `packages/drawnix/src/components/ai-input-bar/*`
|
||
- `packages/drawnix/src/components/task-queue/*`
|
||
- `packages/drawnix/src/hooks/useAutoInsertToCanvas.ts`
|
||
- `packages/drawnix/src/services/media-result-handler.ts`
|
||
- `packages/drawnix/src/services/sw-capabilities/handler.ts`
|
||
|
||
## Relationship To Existing Changes
|
||
|
||
- 建立在 `add-audio-generation-suno-routing` 已定义的 `audio` 模态与 Suno 路由方案之上
|
||
- 与 `add-canvas-audio-playback` 互补：
|
||
- 音乐结果继续进入音频节点
|
||
- 歌词结果进入文本插入链路
|
||
- 本变更不会把歌词能力建成新的模态，而是在现有 `audio` 能力族中补齐新的动作和结果类型
|