跳转到内容

在 Windows 上安装(预览)

  • Windows 10(22H2)或 Windows 11,64 位(x64)。暂不支持 Arm 版 Windows。
  • 足够的磁盘空间:应用本身(安装后约 1.5 GB)、语音识别模型(约 1.6 GB),以及你的成片。
  • 一个你已经能用的 AI:Claude Code 或 Codex 的登录、一个 API key,或一个本地模型,任选其一。什么都不接也能先用,出方案时会退回到简单规则。
Mac(Apple 芯片) Windows(预览)
语音识别 MLX Whisper,用 GPU faster-whisper,用 CPU,明显比 Mac 慢。可以用 NVIDIA 显卡,见下文
H.264 编码 VideoToolbox Windows 自带的 Media Foundation;没有可用的 Media Foundation H.264 编码器时(例如没装媒体功能包的 Windows N 版)自动改用 OpenH264
API key macOS 钥匙串 用 Windows DPAPI 按你的用户账户加密保存
安装包 已签名、已公证的 DMG,自动更新 GitHub Releases 上的未签名 NSIS 安装包,SmartScreen 会提示;同样从 Releases 检查更新
免费离线配音 Kokoro,约 330 MB,没有密钥也能配音 没有:配音(讲解视频、课程)需要 OpenAI 密钥或你在 persona 里设的声音
快捷键 ⌘ Ctrl(Ctrl+1 到 Ctrl+4 是首页、收件箱、全部项目、发布)
  1. 打开 最新发布,下载 Reelfold-<版本>-win-x64-setup.exe(从 v0.2.0 起,和 Mac 的 DMG 放在一起)。

  2. 运行它。安装包没有代码签名,Windows 会弹出「Windows 已保护你的电脑」:点 更多信息 → 仍要运行。只运行从本仓库 Releases 页面下载的安装包。

  3. 安装包会为当前用户安装千剪(不需要管理员权限,可以改安装目录),并在开始菜单里加快捷方式。它和 Mac 版一样自带 Python、ffmpeg 和引擎。

千剪会从 GitHub Releases 检查更新,退出时自动安装。Windows 上的自动更新是新功能:如果更新失败,从 Releases 下载新版安装包直接覆盖安装即可,项目和设置都会保留。

需要 Node.js 22+、Python 3.12(安装时勾选 Add python.exe to PATH)、Git for Windows,以及 PATH 里的 ffmpeg(例如 winget install Gyan.FFmpeg)。

  1. 在 PowerShell 里克隆仓库,安装引擎的 Python 依赖和应用的依赖:

    终端窗口
    git clone https://github.com/zyziyun/reelfold; cd reelfold
    python -m pip install -r requirements.txt
    npm install

    在 Windows 上 requirements.txt 装的是 faster-whisper,而不是 MLX Whisper。

  2. 启动应用:

    终端窗口
    npm run desk

    应用以 Reelfold 的名字打开,用 PATH 里的 python 启动引擎。如果用错了 Python,在设置里指定路径。

字体和人脸模型会在首次启动时由应用下载(设置 › 高级 › 下载内容)。Whisper 模型在第一次转写时下载。

维护者可以在 CI 里为任意分支打同样的未签名安装包(Actions → Desk release → Run workflow,勾选 windows),作为工作流产物保留 7 天。只运行本仓库自己的 Releases 或 Actions 打出的安装包。

打开 设置 › AI,和 Mac 版 一样。用订阅登录之前先装好命令行工具:

  • Claude Code: 原生安装器(irm https://claude.ai/install.ps1 | iex)或 npm install -g @anthropic-ai/claude-code。
  • Codex: npm install -g @openai/codex。

千剪会在 PATH、%USERPROFILE%\.local\bin 和 npm 的全局目录(%APPDATA%\npm)里找它们,所以应用开着时装好的命令行工具不用重启也能找到。

Windows 上 faster-whisper 默认用 CPU,因为它需要的 CUDA 库(CUDA 12 的 cuBLAS 和 cuDNN)不在应用里。如果你已经装好了,给你的用户设置环境变量 VSTUDIO_WHISPER_DEVICE=cuda(或 auto),然后重启千剪。如果 CUDA 库加载不了,转写会停下并提示原因;删掉这个变量(或设成 cpu)就回到 CPU。

  • 路径太深:Windows 默认限制路径 260 个字符,除非开启长路径(组策略「启用 Win32 长路径」)。如果渲染报路径错误,把项目放在短一点的目录,例如 D:\Reelfold。
  • 发布浏览器、定时发布和「创作」页的录制在 Windows 上测试得较少。
  • 安装包和应用都没有签名,在配置签名之前 SmartScreen(以及部分杀毒软件)会提示。
  • 还没有免费离线配音;要做有配音的视频,请添加 OpenAI 密钥。

各版本的对比:版本区别:Mac、App Store、Windows。

目录 内容
%APPDATA%\Reelfold 应用设置、下载的模型和字体(assets)、加密的 API key、发布浏览器里各平台的登录
%USERPROFILE%\.config\vstudio 引擎的主目录:项目列表、发布日历和偏好;新项目默认放在这里的 projects\
%USERPROFILE%\.cache\video-studio 引擎缓存:字体、模型、转写结果。和 Claude Code 技能共用
%USERPROFILE%\.cache\huggingface\hub 源码构建或技能下载的 Whisper 模型

你的原始素材不会被移动或修改。