AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

Windows 便携版内置 Python、FFmpeg 等依赖，无需额外安装环境；提供 dry-run 测试避免无意付费；一次生成三种不同开场风格，适合快速做视频变体测试。

适合谁使用

需要为视频制作多个开场版本供 A/B 测试的内容创作者
使用 Seedance 平台并希望本地替换人物和音色的用户
希望获得免安装便携式视频复刻工具的 Windows 用户

典型使用场景

从一条原始视频自动生成三个不同风格的开场用于营销推广
在本地替换人物图和音色参考，确认效果后再提交付费任务
在未安装 Node.js、Python、FFmpeg 的 Windows 电脑上直接运行

项目优势

Windows 便携版已内置 Python 3.13、FFmpeg 及 requests 库，解压即用
自动生成三种预设开场（黄金三秒、冲击链、异常转折），无需手动调整
提供 dry-run 集成测试，不会实际提交付费任务
支持用户名/密码或 token/api key 多种凭证配置方式

使用前须知

Windows 包未购买代码签名证书，SmartScreen 可能提示“未知发布者”
需要拥有 Seedance 权限的筷子账号才能使用
目前仅支持三种预设开场类型，无法自定义其他开场风格

README 快速开始

Replication

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

黄金三秒开场；
冲击链开场；
异常转折开场。

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

Windows 便携版

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

Replication-0.3.0-windows-x64.zip

完整解压后：

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

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 L

项目描述

One video in, three publishable replica videos out — Replication desktop skill workbench.

replication