jimeng-cli 是一个本地命令行工具，用来把即梦 / 剪映 Web 端的已登录工作流转换成可复用的 CLI。它基于真实浏览器流量研究接口，复用你自己的登录态，支持图片生成、视频生成、配音生成、数字人 / Agent 工作流、任务轮询、历史记录和媒体下载。
这个项目不是即梦或剪映官方工具。接口来自授权登录后的浏览器行为分析，页面或接口变更后可能需要重新捕获并更新实现。
直接用 npx 运行：
npx @deluxebear/jimeng-cli --help全局安装后使用 jimeng 命令：
npm install -g @deluxebear/jimeng-cli
jimeng --help本地开发：
npm install
npm link
jimeng --help从本地 tarball 安装：
npm pack
npm install -g ./deluxebear-jimeng-cli-0.1.0.tgz安装配套的 Agent Skill：
npx skills add deluxebear/jimeng-cli --skill jimeng-cli全局安装到 Agent：
npx skills add deluxebear/jimeng-cli --skill jimeng-cli -g -yGitHub 仓库名为 deluxebear/jimeng-cli。
先用真实浏览器完成登录：
jimeng auth login --profile default检查登录态和环境：
jimeng auth status --profile default
jimeng doctor --profile default
jimeng commands list默认数据目录：
- 登录态：
~/.jimeng-cli/profiles/<profile>/auth.json - 浏览器用户目录：
~/.jimeng-cli/browser-profiles/<profile>/ - 签名脚本缓存：
~/.jimeng-cli/sdk/ - 下载输出：当前工作目录的
outputs/，除非命令显式指定路径
~/.jimeng-cli 包含你的 Cookie、token 和会话信息。不要提交到 Git，不要贴给别人，也不要让 Agent 在回答里打印完整内容。
即梦接口依赖 msToken 和 a_bogus 等浏览器侧签名。当前 CLI 的默认目标是本地复现浏览器签名逻辑：
--algorithm-sign：纯 JS 复刻bdms/fn150签名算法，当前已经可用于真实请求。--local-sign/ node-sign：在 Node 中加载官方浏览器运行时脚本，让它产出签名 URL。--browser-sign：通过浏览器环境兜底签名。
建议优先使用 --algorithm-sign 做测试；如果即梦更新了风控脚本，再用 node-sign 或 browser-sign 对比差异。
签名健康检查：
jimeng signer compare --profile default文字生成图片：
jimeng image create \
--profile default \
--prompt "一只小猫在窗边睡觉，电影感，柔和光线" \
--model image-3.0 \
--ratio 1:1 \
--algorithm-sign等待并下载结果：
jimeng image wait --profile default --history-id <history-id>
jimeng image download --profile default --history-id <history-id> --index 0 --output-dir outputs参考图生成图片：
jimeng image create \
--profile default \
--prompt "保留主体姿态，改成赛博朋克夜景" \
--reference-image ./input.png \
--model image-3.0 \
--ratio 16:9 \
--algorithm-sign创建视频任务：
jimeng video create \
--profile default \
--prompt "一只小猫在窗边睡觉，电影感，柔和光线" \
--model seedance-2.0-vip \
--duration 5 \
--ratio 16:9 \
--algorithm-sign查询状态：
jimeng video status --profile default --history-id <history-id>等待完成：
jimeng video wait --profile default --history-id <history-id> --interval-ms 5000 --timeout-ms 600000下载视频：
jimeng video download --profile default --history-id <history-id> --index 0 --output-dir outputs一条命令完成创建、等待、下载：
jimeng video run \
--profile default \
--prompt "一只小猫在窗边睡觉，电影感，柔和光线" \
--model seedance-2.0-vip \
--duration 5 \
--ratio 16:9 \
--algorithm-sign \
--output outputs/cat.mp4已经真实验证过的参数组合：
model: seedance-2.0-vip
duration: 5
ratio: 16:9
signer: pure JS --algorithm-sign
result: 1280x720 MP4, about 5 seconds
查看可用命令：
jimeng commands list常用入口：
jimeng audio create --profile default --text "你好，欢迎使用即梦 CLI"
jimeng audio wait --profile default --history-id <history-id>
jimeng audio download --profile default --history-id <history-id> --index 0 --output-dir outputs
jimeng history list --profile default --limit 20
jimeng download --url "<media-url>" --output outputs/media.bin如果页面新增了模型、尺寸、时长或参考图参数，优先通过浏览器捕获真实请求，再把字段落到 CLI 参数里。
当页面改版、模型列表变化、任务失败，或需要研究新创作类型时，先启动复用登录态的真实浏览器：
jimeng auth login --profile default --port 9222然后在源码仓库里运行开发用抓包脚本，完成一次真实页面操作后保存 redacted 摘要：
node scripts/capture-browser-flow.mjs \
--port 9222 \
--mode manual \
--output captures/browser-flow-redacted.json摘要会写入：
captures/browser-flow-redacted.json
后续实现时应把新捕获的接口与 lib/client.mjs、lib/image.mjs、lib/video.mjs、lib/audio.mjs、lib/signer.mjs 和 lib/bdms-algorithm.mjs 对比，而不是只参考旧开源项目。
这个项目按 npm CLI 交付，不默认构建单文件 binary。
语法检查：
npm run check查看将发布到 npm 包里的文件：
npm run pack:dry本地 tarball 验证：
tmpdir="$(mktemp -d)"
npm pack --pack-destination "$tmpdir"
npm install --prefix "$tmpdir/global" -g "$tmpdir"/deluxebear-jimeng-cli-0.1.0.tgz
"$tmpdir/global/bin/jimeng" --help- 只在你拥有授权的账号和工作区中使用。
- 不要提交
auth.json、captures/、outputs/、签名 URL、Cookie、token 或完整请求头。 - 生成、删除、下载和发布类命令会消耗远端资源或改变远端状态，自动化前应确认意图。
- 如果接口返回风控或授权错误，先检查登录态和签名对比，不要盲目重试。