Replication

Replication 是一款桌面端视频复刻工具：输入一条短视频、替换人物图和音色参考，一次生成 3 个 Seedance 身份替换版本：

1. 黄金三秒开场；
2. 冲击链开场；
3. 异常转折开场。

原故事、场景、镜头逻辑和中心含义保持锁定。

Windows 便携版

普通使用者请从 GitHub Releases 下载：

Replication-0.3.0-windows-x64.zip

完整解压后：

1. 双击 Configure-Account.cmd，输入使用者自己的筷子 / Seedance 账号；
2. 双击 Replication.exe；
3. 选择本地视频、替换人物图和音色参考。

Windows 发布包已内置：

• Python 3.13；
• Python requests 及其依赖；
• FFmpeg 和 ffprobe；
• Replication 的生成运行脚本。

因此接收者不需要安装 Node.js、Python、pip、FFmpeg，也不会依赖开发者电脑上的 /Users/... 路径。API Key、Token、账号、密码、Cookie 和私人配置不会放进仓库或发布包。

当前 Windows 包未购买代码签名证书，SmartScreen 可能提示“未知发布者”。请只从本仓库 Releases 下载。Windows 便携包支持 Windows 10/11 x64。

MeowLoad 仍是可选组件：只有“粘贴视频链接导入”需要；直接选择本地视频不需要。

macOS / 源码运行

要求：

• Node.js 22.12 或更新版本；
• Python 3；
• FFmpeg（ffmpeg 和 ffprobe）；
• 有 Seedance 权限的筷子账号；
• 可选 MeowLoad，用于粘贴链接导入。

git clone https://github.com/francoeur003/replication.git
cd replication
npm install
npm run setup:python
brew install ffmpeg
npm run doctor
npm start

如果 FFmpeg 已安装，可跳过 brew install ffmpeg。npm run setup:python 只创建仓库内的 .venv，不会修改系统 Python。

私人账号配置

源码运行时执行：

npm run configure

默认配置位置：

• Windows：%APPDATA%\Replication\credentials.json
• macOS / Linux：~/.config/replication/credentials.json

支持两种配置：

• username 和 password；
• console_token 和 api_key。

也可使用环境变量：

export KUAIZI_USERNAME="..."
export KUAIZI_PASSWORD="..."

或：

export KUAIZI_CONSOLE_TOKEN="..."
export KUAIZI_API_KEY="..."

如需修改配置文件位置，可设置 REPLICATION_CREDENTIALS_FILE。请勿把真实值提交进仓库。

测试

npm run doctor
npm test
npm start

本地集成测试只准备 3 份 dry-run 合约，不会提交付费任务：

npm run test:integration -- \
  "/absolute/path/to/vertical-video.mp4" \
  "/absolute/path/to/person.png" \
  "/absolute/path/to/voice.mp3"

构建

macOS Apple silicon：

npm run build:mac

Windows x64 请在 PowerShell 中运行：

npm run prepare:win-runtime
npm run build:win

GitHub Actions 工作流会在真实 Windows runner 上完成依赖下载、SHA-256 校验、单元测试、依赖自检、打包、应用启动截图和 ZIP 产出。

付费边界

准备合约是本地免费操作。提交一次运行会创建恰好 3 个外部 Seedance 任务，可能产生费用。

APP 会保持在 waiting_authorization，直到使用者明确确认当前这 3 条任务。只有真实 MP4 已下载且通过媒体校验后才会显示成功；关闭 APP 不会自动重复提交。

第三方运行组件

Windows 便携包使用：

• Python Windows embeddable package，Python Software Foundation License；
• FFmpeg 推荐的 Windows essentials build，随包保留许可证；
• requests 及依赖，许可证保留在各自的 .dist-info 目录。