jimeng-video-cli-free

English

一个专门用于即梦网页端生视频的本地技能仓库。
它通过 skill 自带的私有 OpenCLI runtime 驱动浏览器，支持文生视频、图生视频、多种参考模式，以及自动下载视频并导出首帧、尾帧和封面图。

能力概览

能力	说明
文生视频	直接用 prompt 生成视频
图生视频	支持单图参考、首尾帧参考、智能多帧
模型	Seedance 2.0 Fast VIP 等 7 个模型
比例	21:9 16:9 4:3 1:1 3:4 9:16
时长	4s 到 15s
默认值	模型 seedance-2-fast-vip，比例 16:9，时长 6s
输出	mp4 + cover.jpg + first-frame.jpg + last-frame.jpg
浏览器	Chrome / Edge，复用你已经登录的即梦会话

项目特色

• 不依赖即梦开放 API，直接走网页端真实能力。
• skill 会维护自己的私有 OpenCLI runtime，避免本机全局适配器相互污染。
• 每次生成默认自动新建 workspace，降低命中旧结果的概率。
• 下载后自动导出首帧、尾帧和封面图，适合做二次剪辑、封面和归档。
• 已实测通过文生视频和图生视频。
• 已修复时长选择 bug：现在 --duration 10s 会实际生成约 10 秒视频，而不是误落到页面默认的 4s。

环境要求

• macOS
• node
• npm
• git
• gh
• curl
• tar
• unzip
• ffmpeg
• 已安装 Google Chrome 或 Microsoft Edge
• 浏览器中已经登录 https://jimeng.jianying.com

快速开始

1. 克隆仓库

git clone https://github.com/leigegehaha/jimeng-video-cli-free.git
cd jimeng-video-cli-free

2. 准备环境

bash bin/jimeng-video-cli-free ensure

这一步会：

• 安装或检查系统 opencli
• 下载浏览器扩展到 downloads/
• 同步 skill 私有 runtime
• 检查浏览器桥和即梦登录状态

3. 加载浏览器扩展

首次使用必须把 downloads/opencli-extension/unpacked 手动加载到 Chrome 或 Edge。

Chrome:

1. 打开 chrome://extensions
2. 开启开发者模式
3. 点击“加载已解压的扩展程序”
4. 选择 downloads/opencli-extension/unpacked

Edge:

1. 打开 edge://extensions
2. 开启开发人员模式
3. 点击“加载解压缩的扩展”
4. 选择 downloads/opencli-extension/unpacked

4. 登录即梦网页端

在同一个浏览器里打开并登录：

https://jimeng.jianying.com

5. 开始生成

文生视频：

bash bin/jimeng-video-cli-free generate "清晨的海边，镜头缓慢前推，海浪轻拍沙滩，金色阳光洒在水面上，电影感，写实风格"

单图参考：

bash bin/jimeng-video-cli-free generate "让人物轻微抬头并眨眼，镜头稳定，写实质感" \
  --reference ./portrait.png

首尾帧参考：

bash bin/jimeng-video-cli-free generate "人物从白天走到夜晚，镜头平稳推进" \
  --reference-mode start-end \
  --reference ./start.png \
  --reference ./end.png \
  --duration 8s

智能多帧：

bash bin/jimeng-video-cli-free generate "角色连续完成三个动作，镜头统一，写实风格" \
  --reference-mode multi \
  --reference ./f1.png \
  --reference ./f2.png \
  --reference ./f3.png \
  --duration 10s

支持的参数

模型

• seedance-2-fast-vip
• seedance-2-vip
• seedance-2-fast
• seedance-2
• seedance-1-5-pro
• seedance-1
• seedance-1-fast

比例

• 21:9
• 16:9
• 4:3
• 1:1
• 3:4
• 9:16

时长

• 4s
• 5s
• 6s
• 7s
• 8s
• 9s
• 10s
• 11s
• 12s
• 13s
• 14s
• 15s

参考模式

• none
• single
• start-end
• multi

如果未显式指定参考模式，skill 会按参考图数量自动推断：

• 0 张图：none
• 1 张图：single
• 2 张图：start-end
• 3 张及以上：multi

输出结构

每次成功生成会在 output/<timestamp>/ 下落一组文件：

output/20260414-065431/
├── 0001.mp4
├── cover.jpg
├── first-frame.jpg
├── last-frame.jpg
├── poster-source.jpg
├── prompt.txt
├── result.json
└── references/

工作原理

1. ensure_opencli_and_jimeng.sh 检查系统依赖、浏览器扩展和登录状态
2. sync_fork_patch.sh 下载并构建 leigegehaha/OpenCLI 的固定版本
3. skill 把自己的 jimeng video override 覆盖进私有 runtime
4. generate_video.sh 调用 jimeng video
5. 生成成功后自动下载视频并导出首帧、尾帧、封面图

安装到多个 Agent

bash scripts/install_links.sh

默认会链接到：

• ~/.agents/skills
• ~/.claude/skills
• ~/.opencode/skills
• ~/.workbuddy/skills
• ~/.codebuddy/skills

配置项

可修改 config.json：

• default_model
• default_aspect
• default_duration
• default_reference_mode
• default_output_format
• default_workspace
• auto_create_workspace
• runtime_source_mode
• runtime_pinned_commit
• generate_wait_seconds
• max_generate_attempts

仓库结构

.
├── SKILL.md
├── agents/
├── bin/
├── overrides/
├── scripts/
├── downloads/
├── output/
├── vendor/
├── config.json
└── LICENSE

故障排查

优先检查：

1. 浏览器是否打开
2. 扩展是否已加载
3. 即梦是否已登录
4. 账号是否还有可用积分
5. ffmpeg 是否可用
6. 网络是否可访问 GitHub 和即梦

常用诊断命令：

bash bin/jimeng-video-cli-free ensure
bash scripts/run_opencli.sh doctor
bash scripts/run_opencli.sh jimeng workspaces -f json

注意事项

• 这个仓库会真实消耗你的即梦额度。
• 当前主要在 macOS 上验证。
• 浏览器自动化能力依赖扩展和已登录会话，不能脱离浏览器独立运行。
• 如果你想保持仓库干净，不要把 downloads/、output/、info.json 提交回 git。

许可证与致谢

• 本项目采用 Apache-2.0
• 基于上游 OpenCLI 做了定制封装和适配增强
• 衍生代码来源说明保留在 NOTICE