Build and Deploy / build-and-deploy (push) Successful in 5m38s

Details

docs: v0.18.3 文档整理 + 新火山 API 文档 + changelog

- 新增 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>

2026-04-17 18:03:49 +08:00

3.1 KiB

Raw Blame History

提示词 AI 优化功能

状态：待开发 创建日期：2026-04-17

需求背景

用户写提示词时，经常写得过于简单或不符合 Seedance 2.0 的提示词规范（如没用「图片n」引用素材、缺少核心要素、镜头语言模糊等），导致生成效果不理想。

引入火山官方的 SKILL.md（Seedance 2.0 Prompt Optimizer）能力，让用户在写完提示词后一键优化。

功能设计

用户视角

用户在提示词输入框输入原始提示词（带 @素材引用）
点击输入框旁的「AI 优化」按钮
弹出预览弹窗，显示优化后的提示词
用户点「采纳」→ 替换原提示词；点「取消」→ 保留原文
消耗一定 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 超限）的前端兜底提示

验收标准

用户输入粗糙提示词（如「美女跳舞」）→ 优化后符合 SKILL.md 的三段式结构（全局设定 / 时间线脚本 / 质感风格与约束）
带 @素材 的提示词 → 优化后正确使用 @图1/@图2/@视频1 等标记
冲突/缺失场景 → 在输出中以备注标明，不擅自填充
Token 消耗正确扣减到团队池
用户可在弹窗中选择采纳或取消

参考文件

SKILL.md（火山提供的原始技能文件）
docs/API文档/seedance 2.0 系列教程.MD 第 2152 行起的「提示词技巧」部分

3.1 KiB Raw Blame History Unescape Escape