SeedVR2 v1.7.0 (portable offline bundles)

SeedVR2 1.7.0 — 便携离线分卷包

完全离线的便携发行包：解压即可运行，全过程不需要联网下载依赖。
合计约 5.21 GB，拆成多个分卷，每个文件都小于 GitHub 的 2 GB 上限。

本版变更（v1.7.0）

• 新增：Ctrl+V 粘贴上传 —— 从截图工具或网页复制图片后，在工作台直接粘贴即入队（焦点在输入框时不劫持；五语言提示）。
• 新增：服务端输出长边硬上限 inference.max_output_side（默认 6144，0=不限制）。resolution 超限直接 400 并给出可用上限；max_resolution 超限只钳位；两倍模式算出的分辨率同样受约束。
• 清理：移除 gaussian_blend / groupnorm_accumulate 两个无消费方的配置键（此前日志会打印"混合已开启"，但开关实际不存在）。tile 接缝一直由上游 VAE 的 raised-cosine 斜坡融合负责，决策与证据见 docs/adr/0006-gaussian-blend-not-adopted.md。
• 文档：新增 docs/adr/0005（事件总线不引入 VOSR2 EventBus 的依据）与对应语义哨兵测试。

这个包里有什么

组件	内容	分卷数
core	应用代码 + 便携 Python 3.12 解释器（已预装全部非 torch 依赖）+ start-portable.bat	1
torch	PyTorch / TorchVision 的 CUDA 13.2（cu132）wheel + TorchAudio 2.11.0（PyPI CPU 轮，与 cu132 搭配正常），含传递依赖	1
model-shared	ema_vae_fp16.safetensors + pos_emb.pt + neg_emb.pt	1
model-fp8	seedvr2_3b_mxfp8.safetensors（内置主模型，MXFP8 量化）	2

准确的文件名、分卷数量、SHA256 与各组件版本号以本次 Release 里的 manifest.json / SHA256SUMS.txt 为准。
manifest.json 中每个组件带 version 字段：core/torch 跟随应用版本与 torch 钉版，model-* 是权重内容哈希——权重没变，版本号就不变。

安装步骤

1. 下载同一组件的全部文件（缺任何一个分卷都会报错并停下）。至少要下 core + torch + model-shared + model-fp8 的全部 .00N 文件，外加 manifest.json、SHA256SUMS.txt、portable_bundle_lib.ps1、unpack_portable_bundle.ps1。

2. 把它们放进同一个文件夹。

3. 右键 unpack_portable_bundle.ps1 →「使用 PowerShell 执行」，或在其所在目录执行：

   powershell -ExecutionPolicy Bypass -File .\unpack_portable_bundle.ps1 -TargetDir D:\SeedVR2

   脚本会：校验每个分卷的 SHA256 → 合并 → 解压 → 用本地 wheel 离线安装 torch → 按清单核对落地结果。

4. 进入 D:\SeedVR2\SeedVR2-Portable\，双击 start-portable.bat，浏览器打开 http://127.0.0.1:7870。

只想先校验下载是否完整（不解压）：

powershell -ExecutionPolicy Bypass -File .\unpack_portable_bundle.ps1 -VerifyOnly

运行要求

• Windows 10/11 x64，NVIDIA 显卡，显存 ≥ 8 GB（内置的 3B MXFP8 权重）
• 磁盘预留 ≥ 15 GB（解压后约 12 GB，另需临时空间）
• 已安装 NVIDIA 驱动（torch 为 cu132 / CUDA 13.2 运行时，需较新驱动；驱动过旧时 torch.cuda.is_available() 会是 False，脚本会给出提示）
• 不内置 FFmpeg：图片修复开箱即用；视频修复请自行安装 FFmpeg 并加入 PATH（许可证原因，见 NOTICE 第 4 条）

从旧版本升级（增量解包）

从本脚本解包出的旧安装升级到新版本时，不需要重新下载没变化的组件：

1. 对比新旧两份 manifest.json 的组件 version 字段，只下载有变化组件的全部分卷（外加新的 manifest.json、SHA256SUMS.txt、unpack_portable_bundle.ps1、portable_bundle_lib.ps1）；

2. 把它们放进一个文件夹，就地执行：

   powershell -ExecutionPolicy Bypass -File .\unpack_portable_bundle.ps1 -TargetDir D:\SeedVR2 -ExistingInstall D:\SeedVR2

   与现有安装一致的组件会被增量复用（分卷缺席也允许），只有变化的组件被重新解包；解包后按清单逐文件核对，旧文件被改动过会被发现。

模型说明

• 本包只内置 3B MXFP8 权重（Comfy-Org 量化格式）。config.yaml 的默认精度是 fp16，在只有 MXFP8 权重时程序会自动回退（日志里有一条 WARNING，属预期行为）。
• 想要 FP16 或 7B 权重，按仓库 README 的直链自行下载放入 SeedVR2-Portable\model\ 即可，无需重新打包。

与 exe 安装包的区别

本页只提供分卷压缩包。历史上另有 SeedVR2-Setup-Full-*.exe / SeedVR2-Torch-Installer-*（Inno Setup 路线），自 v1.27 起不再随 tag 自动发布。推荐直接使用本页的分卷压缩包：不需要管理员权限、不写注册表、不装第二遍。

校验

Get-FileHash .\SeedVR2-Portable-v*-model-fp8.zip.001 -Algorithm SHA256   # 与 SHA256SUMS.txt 比对

解包脚本本身会在解压前强制逐卷校验 SHA256，校验不通过会拒绝继续。

进阶验证（确认清单本身可信，Git Bash / WSL / Linux）：

sha256sum -c SHA256SUMS.txt
gpg --import release-signing-key.asc   # 公钥：仓库 website/docs/guide/release-signing-key.asc
gpg --verify SHA256SUMS.gpg SHA256SUMS.txt

SHA256SUMS.gpg 为发布链路自动生成的 GPG 分离签名（自配置签名密钥后的版本起提供）。

SeedVR2 v1.6.1

SeedVR2 v1.6.1

这是 v1.6.0 的补丁版本，修复三个使用体验问题。桌面完整分卷包无变化（壳与运行时未改动），已有桌面用户请直接通过应用内「检查更新」自动升级；新用户仍下载 v1.6.0 桌面完整包，首次启动后会自动提示更新到 v1.6.1。

修复内容

• 标题字体切换器「选了没反应」：主题重构时字体变量名错位（写入 --sv-font、CSS 消费 --sv-font-display），选中字体被保存但从未生效。现已修复——在「关于」页头部 Aa 菜单选择字体后标题字体即时变化并持久保存。
• 历史统计不排除回收站记录：删除记录（进入回收站）后统计卡数字不再回落、与列表页不一致。现已修复——统计与列表口径一致，从回收站恢复记录后自动重新计入。
• start.bat --dev 无法启动：开发者模式入口指向了不存在的模块属性。现已修复——新增专用开发入口，--dev 的 uvicorn 热重载可用。

升级方式

应用内自动更新（推荐）

托盘/关于页「检查更新」→ 下载 app-v1.6.1.zip → 自动完成替换与重启（runtime/、model/、数据与配置全部保留）。

手动更新

从下方资产下载 app-v1.6.1.zip 与 app-v1.6.1.zip.sha256，校验 SHA256 后在应用更新入口选择该文件。

校验

app-v1.6.1.zip.sha256 为压缩包的 SHA256 校验值。

完整变更见 CHANGELOG.md。

SeedVR2 v1.6.0

SeedVR2 v1.6.0

基于 SeedVR2 扩散模型的视频/图像超分辨率修复后端 + Tauri v2 桌面壳。

下载与安装

桌面完整版（推荐新用户）

• SeedVR2-Desktop-v1.6.0-win-x64.7z.001 ~ .00N 分卷 + unpack_desktop.ps1 + portable_bundle_lib.ps1
• 全内置：Tauri 壳 + 便携 Python 运行时 + PyTorch CUDA + 3B FP8 模型，解压即用，无需安装 Python
• 安装步骤：把分卷与两个 .ps1 放同一目录 → 右键 unpack_desktop.ps1「使用 PowerShell 运行」（或 powershell -ExecutionPolicy Bypass -File unpack_desktop.ps1）→ 完成后进入 SeedVR2\ 双击 SeedVR2.exe
• SHA256 见 SHA256SUMS.txt，manifest.json 为包体元数据

应用增量更新（老用户）

• 已装 v1.5.x 桌面版：托盘「检查更新」自动拉取 app-v1.6.0.zip，或手动下载后从应用内更新入口选择
• 增量包只替换应用代码（runtime/、model/、data/、配置与密钥全部保留）

本版亮点（自 v1.5.7）

• 输出文件名沿用输入名（单文件/批量四条路径统一，重名自动 _1/_2），产物不再被改成时间戳缓存名
• 有损输出水印可靠性：JPEG/WebP 自动改用抗压缩档并在落盘后重读验签；可设 SEEDVR2_WATERMARK_PROOF_MODE=1 强制转 PNG 取证
• torch.compile 真实可用性探测：Windows 缺 triton 时设置开关置灰并说明原因，不再"能勾不生效"；torch_compile 拆 DiT/VAE 两段独立配置
• 桌面壳门禁：新增 desktop-shell workflow（clippy/test/能力 ACL 审计）；发布状态门禁 check_release_state.py 防版本号超前于实际发布
• 溯源增强：data/provenance/ 统一落盘、水印信封可反查任务与参数、--attacks 图像域攻击矩阵
• 一批维护修复：12 个 workflow 补并发组、DCO 按提交作者判定、性能门禁按 GPU 分流、firefox E2E goto 修根因等（完整清单见 CHANGELOG）

完整变更

见 CHANGELOG.md。

校验

SHA256SUMS.txt 列出全部分卷哈希；GPG 签名 SHA256SUMS.gpg 由发布工作流产出（如缺失见仓库说明）。

---

🔐 完整性校验（可选）

直接下载安装即可，普通用户无需校验。进阶用户可验证产物未被篡改：

sha256sum -c SHA256SUMS.txt
gpg --import release-signing-key.asc   # 公钥见仓库 website/docs/guide/
gpg --verify SHA256SUMS.gpg SHA256SUMS.txt

SeedVR2 v1.5.7（增量更新版）

SeedVR2 v1.5.7（增量更新版）

本版为增量更新通道交付版：代码内容与 v1.5.6 一致，以 app-v1.5.7.zip 形式发布，供已安装用户经程序内「检查更新」直接升级。

为何单独发一版：v1.5.6 的 Release 产物为便携分卷包（SeedVR2-Portable-*，误发），其中不含增量更新资产 app-v*.zip，已安装用户检查更新会命中版本号却取不到更新包。本版以增量资产重新交付同一份代码，修复该发布通道问题。

本版包含（v1.5.5 / v1.5.6 全部修复，首次经增量通道交付）

1. 显存/内存门禁不再误拒：预检改按实际会加载的精度估算，仅当最大降级仍放不下才拒绝。12GB 卡 + 仅下载量化权重的机器不再「提交即 503」。
2. 503「模型文件不存在」误导信息修正：区分「配置但未下载」与「磁盘有文件但显存不足被排除」，不再把存在但被门槛排除的权重报成文件缺失。
3. VAE 解码阶段卡死根治：① 阶段 3 解码前将 DiT 卸载到 CPU（空闲 <10GB 才卸，下一任务复用分支自动恢复）；② tiled 解码 tile size 改按空闲显存 + 实测峰值模型选型（弃用总显存）；③ 新增每 tile 进度日志与卡死看门狗（>20s 打主线程栈与显存状态）。
4. block swap 自适应：recommend_blocks_to_swap 按显存缺口「够用即可」反推换出块数，削减量按换出块数线性。
5. double_res 像素上限：新增 8MP 上限，防止一次放大到显存放不下。
6. 死代码清理：移除 GroupNormAccumulator / TiledVAEHook 空转路径与误导日志。
7. 完整性自检修复：核心模块完整性清单随 model_manager.py 变更重生成并以仓库密钥重签（Ed25519），发布版启动自检 11/11 通过。

更新方式

• 已安装用户（推荐）：程序内托盘「检查更新」→「立即更新」，自动下载 app-v1.5.7.zip → 校验 SHA256 → 停服换载（runtime/、model/、data/、logs/ 均保留）。
• 手动更新：下载本页 app-v1.5.7.zip + app-v1.5.7.zip.sha256，校验后解压覆盖安装目录下的 app\。
• 全新安装：见便携分卷 Release（v1.5.6）；增量包不含运行时与模型。

校验

app-v1.5.7.zip SHA256：4bc05cefc80dfd60e979b51e1675a0b358215a94ab8d928582a911bc08f1e126

（PowerShell：Get-FileHash app-v1.5.7.zip -Algorithm SHA256）

已知限制

• 壳不随增量包更新：涉及壳（SeedVR2.exe）功能变更时需重新下载安装器或单独壳文件。
• 本版无新增功能，仅修复发布通道并以增量形式交付既有修复。
• 未做代码签名：Windows 首次运行可能弹 SmartScreen，点「更多信息 → 仍要运行」。

SeedVR2 v1.5.6 · 便携分卷包（免安装，含便携 Python 与 3B FP8 模型）

这个 release 是什么

便携分卷包的唯一公开下载入口：core / torch / model-shared / model-fp8 共 5 个 .001/.002 分卷（合计约 5.6 GB），外加 manifest.json、SHA256SUMS.txt、SHA256SUMS.gpg 与解包脚本 unpack_portable_bundle.ps1 / portable_bundle_lib.ps1。

用法见 README「网页版 / 便携包」一节：全部放进同一目录后执行
powershell -ExecutionPolicy Bypass -File .\unpack_portable_bundle.ps1 -TargetDir D:\SeedVR2，
再双击 SeedVR2-Portable\start-portable.bat，浏览器打开 http://127.0.0.1:7870。

为什么它曾经挂着「已作废」

本 tag 当初是误发布：发布通道需要的是增量更新资产 app-v<ver>.zip（供已安装用户走托盘「检查更新」），而这里产出的是便携分卷包。v1.5.7 因此被单独发出来补那条通道，v1.5.6 遂被标为作废并转为草稿。

结果是把便携包一起藏掉了 —— 草稿 release 对未登录访客不可见，README 指向的下载路径断了一整个星期。现把它恢复公开，并明确其定位：便携包的下载入口，不是推荐的一键安装方式。

代码基线与已知差距（重要）

• 本包的代码内容等同 v1.5.7。
• 因此它不含 v1.5.7 之后合入 main 的修复，其中与安全相关的是：i18n 语言代码可越出 locales/ 目录读取任意 .json（POST /api/system/locale 的 locale 字段此前无校验；已在 main 上以 BCP-47 白名单收口），以及 checkpoint 任务 ID 的 sink 侧自守。
• 实际暴露面有限：应用仅绑定 127.0.0.1 且有 basic auth / CSRF / 限流；但仍建议对外分发优先用桌面版或后续正式 release。
• 校验：SHA256SUMS.txt 覆盖全部 5 个分卷与两个脚本，SHA256SUMS.gpg 为 detached 签名；清单与资产名逐条核对一致。

想要哪种就取哪种

需求	去处
一键安装（含依赖 + 3B MXFP8 模型）	v1.5.4 的 SeedVR2-Setup-v1.5.4.exe + SeedVR2-Data.7z.001/.002/.003
已安装用户「检查更新」	/releases/latest（v1.5.7）的 app-v1.5.7.zip
免安装便携包	本 release

---

🔐 完整性校验（可选）

直接下载安装即可，普通用户无需校验。进阶用户可验证产物未被篡改：

sha256sum -c SHA256SUMS.txt
gpg --import release-signing-key.asc   # 公钥见仓库 website/docs/guide/
gpg --verify SHA256SUMS.gpg SHA256SUMS.txt

SeedVR2 v1.5.4（正式稳定版）

SeedVR2 v1.5.4（正式稳定版）

当前稳定版本，整合 v1.5.3 壳更新、v1.5.4 应用修复与两轮壳补丁，更新链路完整可用。
完整安装包 = SeedVR2-Setup-v1.5.4.exe + SeedVR2-Data.7z.001/.002/.003（数据卷与 v1.5.1/v1.5.3 完全一致，已安装用户可复用本地数据卷，无需重新下载）。

本版包含

1. 更新链路完整可用：壳改用 native-tls（Windows SChannel）+ 系统代理/环境变量代理支持，解决部分网络环境下「检查更新」静默失败的问题；托盘点「检查更新」会唤起主窗口，结果弹窗不再被隐藏。
2. 版本显示修复：版本号统一从 pyproject.toml 读取，关于页显示真实版本（不再出现"下载 1.5.3 却显示 1.5.1"）。
3. 失败原因可见：任务失败事件下发 error 详情，错误卡片显示具体失败原因（如「模型文件不存在」），长错误自动换行 + 最大高度滚动，不再堆叠掩盖。
4. 换载修复（壳补丁 2）：更新换载前关闭壳日志句柄、工作目录移开，修复换载阶段 os error 32。
5. 孤儿进程清理（壳补丁 3）：停服务时扫描并终止所有属于本应用的 python 进程（命令行匹配 start_portable.py），孤儿进程不再持有 app 目录句柄，换载稳定可靠。
6. 日志可见：壳诊断日志写入 app\logs\seedvr2-shell.log，问题排查有据可查。

安装方式

• 全新安装：下载 SeedVR2-Setup-v1.5.4.exe + 三个数据卷分卷（SeedVR2-Data.7z.001/.002/.003），放入同一目录后双击运行安装包。安装过程会自动终止正在运行的 SeedVR2。
• 已安装 v1.5.1 / v1.5.2 / v1.5.3：程序内托盘「检查更新」→「立即更新」自动增量升级（推荐）；或下载本页 app-v1.5.4.zip 手动覆盖。
• 仅需更新壳（应用代码已是最新、壳版本较旧）：下载 SeedVR2-Shell-v1.5.4.exe，退出程序后覆盖安装目录下的 SeedVR2.exe。

校验

SHA256SUMS-v1.5.4.txt（PowerShell：Get-FileHash <文件名> -Algorithm SHA256 比对）

已知限制

• 未做代码签名（OV 证书费用高昂）：Windows 首次运行可能弹 SmartScreen，点「更多信息 → 仍要运行」，或右键安装包 → 属性 → 解除锁定。
• 壳不随增量包更新：涉及壳功能变更时需重新下载安装器或单独壳文件。
• 完整安装含全部依赖与模型（数据卷约 5.3GB），安装需约 12GB 磁盘空间；NVIDIA GPU，建议显存 8GB 以上。

SeedVR2 v1.5.3

SeedVR2 v1.5.3（正式版）

本次更新（壳更新：修复「检查更新无反馈」）

1. 网络通道修复：更新检查改用 native-tls（Windows SChannel），解决部分网络环境下直连 GitHub API 被 TLS 层阻断、检查更新静默失败的问题；同时支持系统代理 / 环境变量代理。
2. 托盘检查可见：托盘点「检查更新」会先唤起主窗口，结果弹窗不再因窗口隐藏到托盘而不可见。
3. 日志可见：Rust 侧日志写入 app\logs\seedvr2-shell.log（原 stdout 日志被隐藏，问题难排查）。
4. 支持测试版检查：更新检查现可发现 prerelease 版本。

安装说明

1. 下载全部文件放入同一目录：SeedVR2-Setup-v1.5.3.exe + SeedVR2-Data.7z.001 / .002 / .003。
2. 双击 SeedVR2-Setup-v1.5.3.exe 安装。如遇 SmartScreen 提示，点「更多信息 → 仍要运行」（本程序未购买代码签名证书，属正常现象）。
3. 安装过程会自动终止正在运行的 SeedVR2，完成覆盖安装。

校验

SHA256 见 SHA256SUMS-v1.5.3.txt。PowerShell 校验：Get-FileHash <文件名> -Algorithm SHA256

已知限制

• 完整安装包含全部依赖与模型（数据卷约 5.3GB），安装需约 12GB 磁盘空间。
• 增量更新通道：已安装用户点「检查更新」会自动下载 app 增量包（不含模型/运行时），无需重下完整包。
• 本版本未做代码签名（OV 证书费用高昂），Windows 可能弹出 SmartScreen 提示。

SeedVR2 v1.5.2 增量更新首发

SeedVR2 v1.5.2 — 增量更新首发（正式版）

增量更新通道正式启用：以后小版本升级不再需要重新下载 5.6GB 完整安装包，托盘「检查更新」自动完成。

本次更新内容（增量包 app-v1.5.2.zip，约 1.3MB）

✨ 新增：增量更新通道

• 已安装 v1.5.1 的用户，点击托盘「检查更新」即可自动下载并更新程序。
• 增量包仅覆盖应用代码（Python + 前端，约 1.3MB），不含运行时（Python/CUDA）、模型权重、数据与日志——这些由本地保留，更新时自动跳过。
• 更新过程：SHA256 完整性校验 → 原子换载 → 失败自动回滚，模型、历史记录全部保留。

🐛 修复：任务失败无明确反馈 / 错误提示堆叠

• 原因：失败详情写入错误卡片后换行被折叠，长错误堆栈挤成一串、溢出被掩盖，看起来"没有错误反馈"。
• 修复：错误详情现在保留原始换行、超出部分可滚动查看，并带独立底色块便于阅读。

增量更新使用说明

1. 首次安装：下载 SeedVR2-Setup-v1.5.1.exe + 3 个数据卷（SeedVR2-Data.7z.001/.002/.003）放同一目录，双击安装（完整版，含全部依赖与模型）。
2. 之后每次升级：点击托盘 「检查更新」 → 确认 → 自动下载并更新，无需重下完整包。
3. 更新完成自动重启服务，版本变为 v1.5.2。

校验

• app-v1.5.2.zip SHA256: e9fb773eef2d2e25c9a14c643a7e580e8a607fc6bf03ed36562d6e9ca6f9c363
• 校验文件：app-v1.5.2.zip.sha256

已知限制

• 壳（SeedVR2.exe）不随增量包更新；涉及壳功能变更时需重发完整安装器。
• 更新通道仅识别 GitHub 正式版（Latest）；请勿将新版发布为 prerelease，否则已安装用户检查不到。

SeedVR2 桌面版 v1.5.1（测试版）安装程序

SeedVR2 桌面版 v1.5.1（测试版）— 安装程序版

本版变化

• 正式安装程序（NSIS）：双击安装，像普通软件一样安装/卸载
• 自动终止运行中的程序：安装或卸载时，若检测到 SeedVR2 正在运行（界面进程及后台 Python 服务），会自动终止后再继续，无需手动关闭
• 创建桌面与开始菜单快捷方式，写入卸载注册表（可在"设置 → 应用 → 已安装的应用"中卸载）

修复

• 修复安装器内数据解压失败问题（NSIS 3.10 的临时目录机制失效，改为独立临时目录）
• 修复卸载后残留少量文件的问题（延迟清理兜底）

⚠️ 若弹出 "Windows 已保护你的电脑"（SmartScreen 提示）

这是 Windows 对"尚未获得代码签名证书"的新发布程序的常规安全提示，并非程序异常。两种处理方式任选其一：

• 方式一：点击提示窗口中的 "更多信息" → "仍要运行" 即可继续安装。
• 方式二（彻底消除）：右键 SeedVR2-Setup-v1.5.1.exe → 属性 → 勾选 "解除锁定(K)" → 确定，之后双击安装不再弹提示。

安装包校验哈希见 SHA256SUMS.txt，可自行核对一致性。

内容说明

• 完整离线包：包含全部运行依赖与模型权重，开机即用，无需联网下载任何内容
• 数据分卷 3 个（每卷 ≤ 1.9GB），与安装程序放在同一目录即可

安装方法

1. 下载本 release 的 全部 5 个文件 到同一文件夹（安装程序 + 3 个数据分卷 + 校验文件）
2. 双击 SeedVR2-Setup-v1.5.1.exe
3. 按向导完成安装（勾选"立即运行"可启动）

系统要求

• 64 位 Windows 10/11
• NVIDIA GPU（建议显存 8GB 以上）
• 安装需约 12GB 磁盘空间

SeedVR2 v1.5.0 (portable offline bundles)

SeedVR2 1.5.0 — 便携离线分卷包

完全离线的便携发行包：解压即可运行，全过程不需要联网下载依赖。
合计约 5.44 GB，拆成多个分卷，每个文件都小于 GitHub 的 2 GB 上限。

这个包里有什么

组件	内容	分卷数
core	应用代码 + 便携 Python 3.12 解释器（已预装全部非 torch 依赖）+ start-portable.bat	1
torch	PyTorch / TorchVision / TorchAudio 的 CUDA 12.8 wheel（含传递依赖）	2
model-shared	ema_vae_fp16.safetensors + pos_emb.pt + neg_emb.pt	1
model-fp8	seedvr2_ema_3b_fp8_e4m3fn.safetensors（内置主模型，FP8）	2

准确的文件名、分卷数量与 SHA256 以本次 Release 里的 manifest.json / SHA256SUMS.txt 为准。

安装步骤

1. 下载同一组件的全部文件（缺任何一个分卷都会报错并停下）。至少要下 core + torch + model-shared + model-fp8 的全部 .00N 文件，外加 manifest.json、SHA256SUMS.txt、portable_bundle_lib.ps1、unpack_portable_bundle.ps1。

2. 把它们放进同一个文件夹。

3. 右键 unpack_portable_bundle.ps1 →「使用 PowerShell 执行」，或在其所在目录执行：

   powershell -ExecutionPolicy Bypass -File .\unpack_portable_bundle.ps1 -TargetDir D:\SeedVR2

   脚本会：校验每个分卷的 SHA256 → 合并 → 解压 → 用本地 wheel 离线安装 torch → 按清单核对落地结果。

4. 进入 D:\SeedVR2\SeedVR2-Portable\，双击 start-portable.bat，浏览器打开 http://127.0.0.1:7870。

只想先校验下载是否完整（不解压）：

powershell -ExecutionPolicy Bypass -File .\unpack_portable_bundle.ps1 -VerifyOnly

运行要求

• Windows 10/11 x64，NVIDIA 显卡，显存 ≥ 8 GB（内置的 3B FP8 权重）
• 磁盘预留 ≥ 15 GB（解压后约 12 GB，另需临时空间）
• 已安装 NVIDIA 驱动（torch 为 cu128；驱动过旧时 torch.cuda.is_available() 会是 False，脚本会给出提示）
• 不内置 FFmpeg：图片修复开箱即用；视频修复请自行安装 FFmpeg 并加入 PATH（许可证原因，见 NOTICE 第 4 条）

模型说明

• 本包只内置 3B FP8 权重。config.yaml 的默认精度是 fp16，在只有 FP8 权重时程序会自动回退到 FP8（日志里有一条 WARNING，属预期行为）。
• 想要 FP16 或 7B 权重，按仓库 README 的直链自行下载放入 SeedVR2-Portable\model\ 即可，无需重新打包。

与 exe 安装包的区别

本页只提供分卷压缩包。历史上另有 SeedVR2-Setup-Full-*.exe / SeedVR2-Torch-Installer-*（Inno Setup 路线），自 v1.27 起不再随 tag 自动发布。推荐直接使用本页的分卷压缩包：不需要管理员权限、不写注册表、不装第二遍。

校验

Get-FileHash .\SeedVR2-Portable-v*-model-fp8.zip.001 -Algorithm SHA256   # 与 SHA256SUMS.txt 比对

---

🔐 完整性校验（可选）

直接下载安装即可，普通用户无需校验。进阶用户可验证产物未被篡改：

sha256sum -c SHA256SUMS.txt
gpg --import release-signing-key.asc   # 公钥见仓库 website/docs/guide/
gpg --verify SHA256SUMS.gpg SHA256SUMS.txt