624e12ae46
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 5m38s
- 新增 4 个火山官方 API 文档（Seedance 2.0 1080P / seedance 模型价格 / seedance 2.0 系列教程 / 创建视频生成任务API） - 归档 6 个过期文档到 docs/archive/（旧 Seedance API 邀测版 / 旧 Assets API 邀测版 / celery 轮询修复 / design-review / prd / test-report） - 新增 docs/todo/ 目录（提示词 AI 优化功能待办） - changelog.md 补 v0.18.3 条目 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
66 lines
3.1 KiB
Markdown
66 lines
3.1 KiB
Markdown
# 提示词 AI 优化功能
|
||
|
||
**状态**：待开发
|
||
**创建日期**：2026-04-17
|
||
|
||
## 需求背景
|
||
|
||
用户写提示词时，经常写得过于简单或不符合 Seedance 2.0 的提示词规范（如没用「图片n」引用素材、缺少核心要素、镜头语言模糊等），导致生成效果不理想。
|
||
|
||
引入火山官方的 SKILL.md（Seedance 2.0 Prompt Optimizer）能力，让用户在写完提示词后一键优化。
|
||
|
||
## 功能设计
|
||
|
||
### 用户视角
|
||
1. 用户在提示词输入框输入原始提示词（带 @素材引用）
|
||
2. 点击输入框旁的「AI 优化」按钮
|
||
3. 弹出预览弹窗，显示优化后的提示词
|
||
4. 用户点「采纳」→ 替换原提示词；点「取消」→ 保留原文
|
||
5. 消耗一定 token 数（计入团队 token 池）
|
||
|
||
### 技术方案
|
||
|
||
**后端**
|
||
- 新接口：`POST /api/v1/prompt/optimize`
|
||
- 入参：`prompt`（原始提示词，含 `@素材` 标记）、`asset_refs`（素材引用列表：label + type + url）
|
||
- 调用豆包模型（推荐 `doubao-seed-2.0` 最新版本，具体 model id 需确认）
|
||
- System prompt：基于 SKILL.md 改造成**一次性输出**模式（不做多轮交互）
|
||
- 返回：`optimized_prompt`（优化后的文本）+ `token_used`（消耗 token 数）
|
||
- 同时扣减团队 token 池
|
||
|
||
**前端**
|
||
- `PromptInput` 组件右侧加「AI 优化」按钮（带 ✨ 图标）
|
||
- 点击后：loading 状态 → 调用后端接口 → 弹出 `PromptOptimizeModal` 预览弹窗
|
||
- 弹窗显示：原始 vs 优化对比、token 消耗提示、采纳/取消按钮
|
||
- 采纳后：把优化结果写回 editor（保持 @mention 标签正确渲染）
|
||
|
||
**SKILL.md 改造要点**
|
||
- 去掉 Step 0（主动引导提问）→ 一次输入一次输出
|
||
- 去掉 Step 3 的「多选模板交互」→ 如遇歧义/冲突，在输出里以备注形式标注（如 `【注：检测到 X 冲突，已按 Y 处理】`）
|
||
- 保留 Step 2（素材自动映射 `@图N`）、Step 4（结构化输出：优化后提示词 / 优化问题 / 相关原则）
|
||
|
||
## 计费设计
|
||
- 提示词优化和视频生成共用**同一个 token 池**（用户已熟悉的计费机制）
|
||
- 不单独限额，按实际 token 消耗扣减
|
||
- 前端展示："本次优化消耗约 X token"
|
||
|
||
## 模型选择
|
||
- **首选**：豆包 2.0 系列最强模型（需查火山文档确认最新 model id）
|
||
- 备选：`doubao-1-5-pro-32k`（成本更低，任务够用）
|
||
|
||
## 待确认事项
|
||
- [ ] 豆包 2.0 系列当前最强模型的具体 model id
|
||
- [ ] Token 池扣减逻辑是否需要团队/个人双重配额
|
||
- [ ] 优化失败时（LLM 报错、token 超限）的前端兜底提示
|
||
|
||
## 验收标准
|
||
1. 用户输入粗糙提示词（如「美女跳舞」）→ 优化后符合 SKILL.md 的三段式结构（全局设定 / 时间线脚本 / 质感风格与约束）
|
||
2. 带 `@素材` 的提示词 → 优化后正确使用 `@图1/@图2/@视频1` 等标记
|
||
3. 冲突/缺失场景 → 在输出中以备注标明，不擅自填充
|
||
4. Token 消耗正确扣减到团队池
|
||
5. 用户可在弹窗中选择采纳或取消
|
||
|
||
## 参考文件
|
||
- SKILL.md（火山提供的原始技能文件）
|
||
- `docs/API文档/seedance 2.0 系列教程.MD` 第 2152 行起的「提示词技巧」部分
|