Kocpy（原名 KocardPro）是一款专为影视制作现场 DIT（Digital Imaging Technician）设计的专业媒体备份软件。支持摄影机卡到多目的地的高速备份、哈希校验、PDF 报告生成，以及基于项目管理的智能化工作流。
- 三种备份模式：备卡模式（Card）、镜像模式（Mirror）、项目模式（Project），适配不同现场工作流
- 并行多目的地：同时备份至最多 4 个目的地，复制与校验并行执行
- 哈希完整性校验：支持 MD5 / SHA-1 / SHA-256，逐文件校验，确保数据 100% 一致
- 重复文件处理：可选「跳过」（默认）或「重命名（_copy_N）」两种策略，避免目的地文件被意外覆盖
- 实时进度监控：显示传输速度、已完成文件数、ETA 剩余时间
- 跳过文件统计：备份完成后透明展示跳过的系统隐藏文件数量及体积
- 任务持久化：应用重启后自动恢复任务状态，异常退出自动标记中断任务
- 优先执行：可为单个任务设置优先级，优先任务排在其他等待任务之前启动，支持在待机任务卡片上实时切换
- 保存为默认设置：哈希算法、重复策略、缩略图开关可一键持久化，下次新建任务时自动加载
- Webhook 推送：备份完成后可自动推送通知到钉钉/飞书/企业微信
- 摄影机卡自动识别：通过多维度评分模型（协议类型、文件系统、分区方案、块大小、容量、卷名等）区分数据卡与备份硬盘，自动填入素材源
- 支持卡型：SD · CFexpress Type A/B · CFast · CF · SxS · XQD
- 磁盘状态实时监控：5 秒轮询已连接存储设备，显示容量、剩余空间、设备类型
- 设备弹出：支持在界面内直接安全弹出外接设备
- 项目模板：预设拍摄日期范围、参与机器（A机/B机/DIT 等）、机位子标签、目的地路径
- 文件目录预创建：按拍摄计划自动批量创建
项目名/日期/机器/机位层级目录结构 - 智能路径解析：新建任务时自动关联项目，根据选定的日期、机器、机位自动解析完整目的地路径
- 项目归档：支持将已完成项目归档，与活跃项目区分管理
- 备份热力图：可视化展示项目备份活动分布
- 视频首帧缩略图：备份完成后可一键提取 MXF / MOV / MP4 / R3D / BRAW 视频文件首帧，ffmpeg 已内置，无需额外安装
- PDF 备份报告：包含任务摘要、源信息、每个目的地的文件校验列表，支持内嵌视频首帧缩略图，可导出存档
- macOS 11.0（Big Sur）及以上
- 支持 Apple Silicon（arm64）和 Intel（x64）
前往 Releases 页面下载最新版本：
| 架构 | 安装包 |
|---|---|
| Apple Silicon（M1/M2/M3/M4） | Kocpy-1.9.2-arm64.dmg |
| Intel | Kocpy-1.9.2-x64.dmg |
下载 .dmg 后，双击打开，将 Kocpy 拖入 Applications 文件夹即可。
首次启动提示：macOS 可能提示「无法打开，因为开发者未验证」。请打开「系统设置 → 隐私与安全性」，点击「仍然打开」，或运行 DMG 内附带的
安装 Kocpy.command脚本自动完成授权。
将素材卡中的文件备份到指定目的地，备份目录以「卷名_时间戳」命名，确保每次备份可唯一追溯。
- 打开软件，点击「新建备份任务」，选择「备卡模式」
- 在「素材卡」标签页选择已识别的摄影机卡（或切换「自定义」手动选择文件夹）
- 添加一个或多个目的地目录
- 按需配置哈希算法、重复文件策略、是否生成缩略图
- 点击「开始备份」，完成后自动逐文件哈希校验
完整镜像素材源的目录结构与文件名，目的地内容与素材源完全一致（A = B），适用于需要制作完全相同副本的场景。
- 选择「镜像模式」
- 选择素材来源
- 添加多个目的地（最多 4 个）
- 开始备份，所有目的地并行接收数据并独立校验
关联已创建的项目，实现智能化工作流：自动识别素材卡、自动填充目的地路径，按「项目 / 日期 / 机位 / 卷名_时间戳」层级归档。
- 在「项目管理」中提前创建项目，填写拍摄日期范围、机器与子机位，添加目的地，点击「创建文件结构」预建目录树
- 新建任务时选择「项目模式」，关联对应项目（目的地路径自动填入）
- 选择拍摄日期、机器、机位，软件自动解析完整备份路径并实时预览
- 确认卷名后开始备份，结果按层级自动归档
任务完成后，点击任务卡片上的「导出报告」按钮，选择保存路径，生成 PDF 备份报告。若任务开启了「视频首帧缩略图」，导出时可选择是否在报告中内嵌首帧图片。
- 项目正式更名为 Kocpy（原 KocardPro）
- 新增 Webhook 推送功能（钉钉/飞书/企业微信通知）
- 新增备份热力图可视化
- 其他稳定性改进
- 项目模式机位子位置校验：当项目中某机器配置了子位置时，新建任务必须选择子位置才能开始备份
- 跳过文件统计展示
- 重复文件处理策略（跳过 / 重命名）
- 保存为默认设置
- 优先执行
- 视频首帧缩略图
- 框架：Electron 28 + electron-vite
- 前端：React 18 + TypeScript + Tailwind CSS
- 状态管理：Zustand
- 构建：electron-builder（生成 DMG + ZIP，支持 arm64 / x64）
- 报告：HTML → PDF（Electron printToPDF）
# 安装依赖
npm install
# 开发模式
npm run dev
# 构建
npm run build
# 打包发布（macOS arm64 + x64）
npm run distMIT License