插卡自动备份、双端校验、拷完给一张人话报告。
面向中文创作者与小团队的 Windows 拷卡(DIT offload)工具。开源、MIT、长期免费且含商用。
📖 上手教程 —— 面向第一次用拷卡工具的人,三分钟走通全流程 English: README.en.md
免费界不缺校验能力,也不缺正确架构——缺的是把这几件事装进同一个面向创作者的、真免费的壳里。既有方案各断一条腿:
| 方案 | 断在哪 |
|---|---|
| DaVinci Resolve 的 Clone Tool | 架构完全合格,但困在数 GB 的 NLE 与 DIT 术语里;校验遍慢到被官方论坛长期抱怨;写 MHL 但不能复验 |
| TeraCopy | 校验能力强,但多目的地与报告导出恰好锁在 Pro,免费版不含商用 |
| FastCopy | 引擎快,但单目的地,免费版不含商用 |
| FreeFileSync | 同步定位错配,校验开关藏在配置文件里且作者自认实现存疑 |
| rclone / robocopy | 人群不对;robocopy 根本无内容校验 |
| Hedge → OffShoot | 2023 年改名时撤销了免费档,空位至今无人补 |
稳拷要补的就是这个空位。它不承担营收,所以:零账号、零付费墙、零服务端依赖、离线可用、零遥测。
- 整卡镜像为默认。只排系统垃圾,看不懂的文件照拷——配套文件缺一个就可能让整条素材在剪辑软件里废掉(Canon 的
INDEX.MIF、Insta360 的双.insv) - 单遍读源、多目的地并行写(1–4 个)。源只读一遍,数据同时喂给全部目的地与哈希器
- 边读边算 XXH64,零额外读源;可选 MD5
- 无缓冲读回校验(
FILE_FLAG_NO_BUFFERING)。不绕过页缓存的「校验」读到的可能是内存副本,介质写坏完全测不出来——那比不校验更危险 - 校验失败自动重拷,重试集合逐轮收窄、指数退避
- 断点续传。账本作用域是「目的地 × 源卡」,判定已完成要三件事同时成立:清单有记录、当初校验通过、目的地上文件现在确实还在
- 一键复验四态:一致 / 已移动 / 丢失 / 新增。不压缩成布尔结论——你想知道的是「哪些文件出了什么问题」
- 中文人话报告:单文件 HTML,样式内联、可离线打开、可打印成 PDF,应用内直接查看
- 凭证随数据走:清单落在目的地目录内,整个目录搬走凭证跟着走
- 源卡只读:绝不向源设备写入任何东西,包括设备标记
- 预设任务 + 插卡即跑:卡插上就知道该拷进哪个项目、用什么参数。匹配由窄到宽三档(指定设备 / 某类设备 / 任何已分类的源),顺序即优先级
- 导图:把目的地目录树画成节点图,卡连线到文件夹节点,「全部开始」就按图落位——每根连线走的都是与预设 / 临时拷贝完全相同的执行与校验路径,树可存成模板复用。概念致敬一位已停更的先行者,本实现从零自写、全部开源
- 插卡之后一定有结论:九种「为什么没跑起来」各自可呈现——从未见过要先指认、已被忽略、没有匹配的预设、没有新素材、空间不足……不存在「插了卡什么都没发生」
- 未分类设备永不自动开跑:从没见过的设备一律停在指认这一步,危险区的「跳过确认」也绕不过去。拷贝是可恢复的,往不知道是什么的设备上自动动手不是
- 暂停 / 继续 / 取消:块边界响应;暂停中按取消会立刻醒
- 安全弹出:锁定 → 卸载 → 弹出,走系统接口,不依赖任何外部程序
- 任务台账:SQLite 存历史、文件明细与格式化留痕;schema 版本化,损坏不静默重建
- 格式化在危险区:默认关,双重确认(手输确认串 + 倒计时,最少 10 秒),安全链 G1–G4 逐项过,成功、失败、被拒、被取消一律留痕
两个安装包,选一个:
| 大小 | 什么时候用 | |
|---|---|---|
steadcopy_<版本>_x64-setup.exe |
约 4 MB | 默认选它。 本机已有 WebView2 就直接装完;没有的话装的时候会去拉一下运行时 |
steadcopy_<版本>_x64-setup-offline.exe |
约 206 MB | 片场没网、机器全新时选它。 WebView2 运行时整个打在包里,断网也能装 |
两个是同一个产品的两种装法,装完完全一样,也可以互相覆盖升级。另有便携版 zip(约 7 MB),解压即用、数据落在自己目录里。
下载地址:
- GitHub Releases
- 国内直连镜像:
https://api.ai-mcn.tv:9000/broadcast/steadcopy/(与 Releases 是同一批字节,校验码一致)
本版本未购买代码签名证书,首次运行 Windows 会提示「未知发布者」。这是预期行为。 请按下面的方法核对校验码来确认来源。任何时候都不要为了运行本程序去关闭系统防护或杀毒软件。
核对方法(PowerShell):
Get-FileHash .\steadcopy_0.1.1_x64-setup.exe -Algorithm SHA256把结果与 Releases 页面公示的值逐字比对,一致才安装。
两个安装包,选一个:精简版 4 MB(本机已有 WebView2 就直接装完,Win11 与 Win10 22H2 都自带),离线版 206 MB(运行时整个打进去,断网也能装)。片场没网是硬约束,所以离线版必须有;但为此让所有人都下 206 MB 又不合理。
引擎与界面共用同一套 core,命令行是一等公民(也是端到端测试的驱动面):
steadcopy devices # 列出本机卷,标注哪些可作为源
steadcopy scan E:\ --list # 扫描源
steadcopy plan E:\ -d D:\素材 -d F:\备份 -p 婚礼 # 预演,零副作用
steadcopy copy E:\ -d D:\素材 -d F:\备份 -p 婚礼 # 执行
steadcopy audit <清单.json> # 复验,四态结果
steadcopy report <清单.json> # 由清单生成报告
steadcopy watch # 事件驱动守着,插卡即按预设跑
steadcopy project / preset / device / config # 项目、预设、设备记忆、设置
steadcopy eject E: # 安全弹出
steadcopy format E: --yes-i-know-this-erases-data # ⚠️ 危险参数刻意冗长每个命令都支持 --json(stdout 只出 JSON,日志走 stderr)。退出码:0 成功 / 1 终态族 / 2 可重试族 / 3 取消 / 4 用法错误。「无新素材」是正常结果,退出码是 0;复验查出丢失是终态族 1(重跑同一份清单答案只会一样)。
cargo test # 引擎与命令行(安全轨,零副作用)
python scripts/check-scenarios.py # spec 场景 ↔ 测试覆盖自检
python scripts/build-release.py # 一条命令出全部发布产物build-release.py 依次做:许可闸门(发现 GPL 系依赖直接拦下)→ 安全轨测试 → 静态检查 → 命令行 → 安装包 → 便携版 → 校验码。产物落在 release/。
需要 Rust 1.85+、Bun、Python 3、以及 Windows 的 MSVC 生成工具。
中文与英文,默认跟随系统,可在「设置 → 语言」切换,切完即时生效。
当前状态如实说明:界面、插卡即跑链路、编排结论、拷卡报告、命令行输出、安全检查细节、九类错误描述均已双语。 唯一恒为中文的是命令行的
--help——clap 在编译期把它定死,运行期切不了;--lang en管的是运行期输出,这一点在--help里自己写明了。 译文缺失只会退回中文,不会变空白:Rust 侧是穷尽match、界面侧是Record<Key, string>,少一条编译就红。
- 仅 Windows。核心是平台无关的,mac 的位置留着了,但没做。
- 手机走 MTP,做不到可信备份。安卓与 iPhone 在 Windows 上是「便携设备」,没有盘符也不是文件系统对象:没有块级校验、文件大小可能被 32 位截断、时间戳不可信、≥4 GB 高危。目前建议手机用 SD 卡或外置 SSD,相机用读卡器。
- iPhone 默认会把 HEIC/HEVC 转码成 JPEG/H.264 再传给电脑(设置 → 应用 → 照片 → 传输到 Mac 或 PC)。转码发生在手机端,任何拷贝路径都逃不掉——默认设置下你拿到的不是原文件。要备份原片请先改成「保留原始格式」。
- 更新检查默认关闭,且永不自动安装。 没有账号、没有遥测、没有后台轮询——开了之后也只在你按下「检查更新」时才联网一次。查到新版本只告诉你,装不装你说了算。更新包由发布密钥签名,客户端用编译进程序的公钥离线验签,所以即使从不可信的镜像下载也伪造不出有效更新包。
- 格式化能力以虚拟机验收结论为准。它是唯一会不可逆销毁数据的功能,验收不在开发机上做,见
docs/danger-tests.md与docs/release-checklist.md的 R5。 - 便携版依赖系统 WebView2。安装包内置离线运行时,便携版没有;Win11 与 Win10 22H2 自带,更旧的系统请用安装包。
设备接入方式的完整调研见 docs/source-devices.md,
跨层命令与事件契约见 docs/facade-contract.md,
V1 能测什么 / 刻意没做什么见 docs/v1-acceptance.md。
本仓遵守三套制度。(openspec/ 是本仓的 submodule,指向一个私有仓;未获授权的读者拿不到它。三制度的要点已摘在下面。)
- SDD:OpenSpec,禁 propose→apply 一把梭,人审是不可跳过的闸门
- TDD:规格锚定的 Detroit 式——每条 spec 场景对应一个同名测试;不 mock 文件系统,用真实临时目录 IO;对抗测试是一等公民
- 双轨约束:会格式化、需管理员、碰物理设备的测试进危险轨,三重闸门且不在开发机执行,登记在
docs/danger-tests.md
发版前逐项走 docs/release-checklist.md 的 R1–R14,任一项未过就不发版。
MIT。见 LICENSE。