前言¶
在 DeepSeek Harness(DSH)里做短视频,常见做法是自己在会话里反复写提示词、手动调 MetaOnticVideo 的生成工具。创意一变就要重讲流程,也容易在未定稿时就触发 video_generate,白白消耗上游额度。下面介绍维护者 wxsimon2022 发布的 metaontic-video-agent:一个纯配置的智能体预设(显示名「视频导演」),把「写脚本 → 人工确认 → 分镜与生成 → 验收合成」固定成工作流,生成能力仍由已安装的 MetaOnticVideo 提供,本包不接上游、不存密钥。
这是什么¶
metaontic-video-agent 是 DSH 的 agent preset bundle:无 JavaScript、无独立服务,安装后在新会话的智能体选择器里出现 视频导演(预设 id:video-director)。它复用 MetaOnticVideo 的 Seedance 能力,负责定规格、写脚本、分镜、逐镜提示词、调用生成、验收与 ffmpeg 合成;密钥与模型配置都在 MetaOnticVideo 侧完成。
- 目录页:skillhub.cn/plugins/wxsimon2022/metaontic-video-agent
- 源码与文档:github.com/wxsimon2022/metaontic-video-agent
- 当前包版本(package.json):
0.1.1,许可证 MIT,要求 Node>=20
DSH 社区插件目录由 skillhub.cn 等站点维护,与 DeepSeek / 幻方无官方从属关系;安装前请自行查看仓库源码与许可证。插件以当前 DSH 进程权限运行,涉及文件读写与 Shell,使用前请确认环境可信。
脚本确认门槛¶
默认行为是「先脚本、后生成」:
- 你发送一句或一段创意。
- Agent 写入
video-projects/<slug>/script.md(钩子、分镜表、台词、声音、结尾)。 - Agent 完整展示脚本并询问是否确认;只有你明确确认后才会调用
video_generate。 - 你可直接改脚本;改完后需再次确认,此前确认作废。
- 确认后才会写
shots.json、逐镜提示词并调用生成。
「不错」「再改改」不算确认;要出片需明确说「确认」「可以」「开始生成」「按这个来」等。脚本确认前不会消耗生成额度。
核心功能¶
| 你大致说什么 | Agent 做什么 |
|---|---|
| 短剧创意(如雨天送餐、递伞、差评客户反转) | 写脚本 → 你确认 → 提示词 → video_generate → 验收 → 交付 mp4 与制作目录 |
| 在已有口播上续拍几秒 | 先改脚本并确认 → video_extend 或拆镜再合并 |
| 多镜短片(如 30 秒三镜) | 脚本确认 → 分镜生成 → ffmpeg 拼接 → 抽帧验收 |
| 改竖屏 9:16 等规格 | 先按新画幅改脚本确认;已有成片可用 ffmpeg 裁切/补边 |
产物落在 video-projects/<slug>/,典型包括 brief.md、script.md、shots.json、prompts/、clips/、final/、production.md 等(详见仓库 README)。
工具名随 MetaOnticVideo 版本变化:1.2+ 为 video_generate / video_extend / video_status / video_config;1.1 及以前 为 seedance_* 系列。本预设 persona 与 skill 以新工具名为主,并提示 Agent 先看实际工具列表。
预设本身通过 cordis.patch.yml 做三件事:设定「视频导演」身份与「确认前不生成」;挂载文件、Shell、技能、展示等常规工具(Seedance 工具来自 Host 的 MetaOnticVideo);加载 skills/video-director/SKILL.md 及 references/ 中的工作流与手册。本包没有独立配置项,分辨率、时长、上游等均在 MetaOnticVideo 配置或 video_config 中修改。
安装与启用¶
只装本 Agent 不能出片:没有 MetaOnticVideo 就没有 video_generate,只能写脚本。按 README 建议顺序完成环境、视频插件、本预设三步。
0. Harness 与 ffmpeg¶
需要 DeepSeek Harness(Desktop 或 Web)以及 ffmpeg、ffprobe(多镜合成与探测时长)。Linux 示例:
sudo apt install ffmpeg
node -v && ffmpeg -version | head -1 && ffprobe -version | head -1
未装 ffmpeg 仍可能得到分段片段,但不会自动合成完整成片;路径不在 PATH 时可在 MetaOnticVideo 里配置 ffmpegBinary / ffprobeBinary。
1. 安装 MetaOnticVideo¶
侧栏 插件 → 添加插件 / 安装,填写例如:
github:wxsimon2022/metaontic-video
也可使用 npm 包名 metaontic-video 或本地目录绝对路径。装好后打开 MetaOnticVideo 开关,必要时重启 Harness。在插件配置中填写 API Key、基础地址、模型等(README 给出 New API 与火山方舟 ark 示例字段)。
2. 安装 metaontic-video-agent¶
同一入口 插件 → 添加插件 / 安装,填写:
github:wxsimon2022/metaontic-video-agent
固定版本示例:
github:wxsimon2022/metaontic-video-agent#v0.1.1
也可使用本地目录绝对路径,或 npm pack 得到的 metaontic-video-agent-0.1.1.tgz 路径。安装后 新建会话,在智能体选择器中选择 视频导演;已有会话不会自动切换预设。
3. 验证¶
新会话中可问:
你现在是什么角色?有哪些视频工具?会不会先让我确认脚本?
应回答身份为视频导演、具备 video_generate 等(或旧版 seedance_*),并说明先写脚本、确认后才生成。测试流程可不触发生成:
测试一下流程,别生成:一个人早上咖啡洒了,最后笑了。15 秒竖屏,有台词。
此时应只产出脚本并询问确认,不应调用 video_generate。
典型用法¶
第一次出片:在 视频导演 会话发送创意,例如 README 中的 15 秒竖屏短剧描述;Agent 回脚本 → 你回复「确认」或修改 → 确认后才生成(通常 1–5 分钟)→ 成片在 video-projects/<slug>/final/。
口播或带货示例(确认前仅脚本):
给这瓶粉饼做一个 10 秒竖屏带货口播,真实自然光,像朋友聊天,不要播音腔。
产品图在 ./assets/powder.jpg。
确认后可按镜重生成并重新合成,例如指定 video-projects/<slug> 某一镜的机位与台词不变只重生成该镜。
适用场景与注意¶
适合:已在 DSH 中使用 MetaOnticVideo、希望用固定工作流把「创意 → 脚本门禁 → Seedance → 本地制作包」串起来的人;需要多镜、续拍、ffmpeg 合成与项目目录规范的场景。
注意:
- 本包不含 API Key,也不捆绑 MetaOnticVideo;分享他人时需对方自行完成 README 中的 0–5 步。
- Key 只放在 profile 或环境变量(如
NEWAPI_API_KEY),不要写入仓库或会话分享内容。 - 内容审核、额度、时长上限等问题需按 MetaOnticVideo 与上游规则处理;README 常见问题表列了鉴权、时长 14 秒建议、ffmpeg 路径等排查方式。
- 定制默认画幅/风格可改
cordis.patch.yml的persona.prefix;工作流改skills/video-director/SKILL.md,改后对新会话或重载 bundle 生效。
结尾¶
metaontic-video-agent 把 DSH 里的短视频制作收成「视频导演」预设:脚本确认前不调用生成,确认后才走 MetaOnticVideo 的 Seedance 工具链与本地 video-projects 目录。安装 spec 以 README 为准:github:wxsimon2022/metaontic-video-agent。