Seedance 视频生成器（Video Generator）

一个面向 Seedance 2.5（火山方舟 Ark）视频生成的完整本地套件，包含两个可独立使用的形态：

目录	形态	使用者	说明
dsh-plugin-seedance/	DSH 插件（Cordis bundle）	AI Agent	给 Agent 注册 seedance_generate_video / seedance_video_status / seedance_video_cancel 三个工具，按当前会话工作区组织任务与产物
ui/	本地 Web 工作台	普通用户	想法 → 智能扩写（梗概 + 分镜 + 提示词）→ 一键生成 → 状态跟踪 → 视频播放/下载，零依赖
dev/	开发工具	开发者	本地 mock 方舟 API + 43 项冒烟测试，不花真实额度验证全链路

特性

• 工作流：创意 → 故事梗概 → 1-4 镜分镜 → 合并正向提示词 → 固定基础负面黑名单 → 提交生成 → 轮询 → 产物落盘；
• 状态感知：Agent 版读取 session.header.cwd，产物与任务记录落在当前工作区；换轮次、重启后可用任务 ID 追回状态；
• 与 API 能力透明对齐：官方 Ark API 没有 negative_prompt/motion_strength 字段、时长只支持 5/10 秒——两个形态共用同一套映射代码（lib/index.js 导出），把负面词并入提示词、时长 3-15 就近修正、运动强度映射到 camera_control，并在返回值中如实报告；
• 降级兜底：工具/接口不可用时输出完整结构化参数，可手动复制提交。

快速开始

Agent 版（DSH 插件）

# 方式一：从 GitHub 克隆后本地安装
git clone https://github.com/Malenia12/seedance-video-generator.git
dsh plugin --profile web add ./seedance-video-generator/dsh-plugin-seedance
# 方式二：直接指向本地开发目录
dsh plugin --profile web add ./dsh-plugin-seedance
# 设置环境变量 ARK_API_KEY 后重启 dsh web

之后直接对 Agent 说：“用 Seedance 生成一个 9 秒的赛博朋克城市夜景短片”。

Web 工作台

node ui/server.mjs          # 或双击 ui/start-ui.cmd
# 打开 http://127.0.0.1:4321，右上角「设置」填入 ARK_API_KEY（DeepSeek Key 可选，用于 LLM 扩写）

开发验证

node dev/mock-ark.mjs       # 终端 1：本地 mock 方舟 API（127.0.0.1:3900）
node dev/smoke-seedance.mjs # 终端 2：冒烟测试（需先按插件 README「开发」一节建 node_modules junction）

目录结构

dsh-plugin-seedance/        # DSH 插件
  cordis.patch.yml          # bundle 补丁层（注册 tool-seedance 行）
  lib/index.js              # 插件主体：工具注册 + 映射规则 + 任务记录
  lib/client.js             # 火山方舟 Ark REST 客户端
  agent-role.md             # Agent 角色规范（故事扩写→分镜→调用工作流）
  README.md                 # 安装 / 配置 / 映射说明
ui/                         # Web 工作台
  index.html                # 单页 UI
  server.mjs                # 零依赖本地服务（扩写/提交/轮询/下载/播放）
  start-ui.cmd              # 一键启动
dev/                        # 开发工具
  mock-ark.mjs              # 本地 mock 方舟 API
  smoke-seedance.mjs        # 冒烟测试

许可

MIT