ClipPort 是一款使用 WinUI 3、C#、.NET 8 和 C++ 构建的 Windows x64 桌面应用。 它可以把存储卡或普通目录中的文件安全复制到指定位置，并按需重新读取源文件与目标文件，使用所选算法逐文件比较摘要。
应用不依赖账号、云服务或远程数据库。 设置、任务历史、日志和报告均保存在本机。
浅色与深色主题下的任务完成、复制与文件校验进度。
文件校验大小速度与项目数速度实时图表。
通过文件资源管理器右键菜单快速新建 ClipPort 任务。
| 模式 | 行为 |
|---|---|
| 复制并校验 | 使用所选算法重新读取并比较源文件与目标文件；默认在复制全部完成后校验，也可启用“拷贝时校验” |
| 仅复制 | 复制文件，但不计算校验摘要 |
| 只校验 | 不创建目标目录、不复制文件，仅校验目标目录中已有的对应文件 |
创建任务时至少需要启用复制或校验中的一项。
- 保留完整目录结构，包括空目录。
- 默认使用顺序异步复制，以 4 MiB 缓冲区流式处理文件。
- 先写入随机命名的
.clipport-partial临时文件，完整写入后再提交到正式目标路径。 - 取消或单文件失败时清理临时文件，避免用半成品覆盖现有目标文件。
- 尽力保留源文件的最后修改时间；无法保留时记录警告，但不中断整个任务。
- 复制前检查目标磁盘空间，并拒绝危险的源目录、目标目录重叠关系。
- 跳过目录联接和符号链接，并阻止目标路径穿过重解析点，避免意外递归或写入非预期位置。
- 源目录采用后台流式枚举；扫描、目标目录预处理、重复项探测和容量检查不会占住界面线程，并实时显示已发现的目录数、文件数、数据量和当前路径。
ClipPort 现在支持 SHA-256、SHA-512、SHA-1、MD5 和 xxHash64。
所选算法会贯穿普通任务、只校验、失败重试、覆盖后重新校验、历史记录和导出报告；旧历史记录或无效算法值会回退到 SHA-256。
所有算法均以 4 MiB 缓冲区流式读取文件，不会把整个文件一次性载入内存。 校验报告会标明实际算法，并记录源文件与目标文件的摘要。
开启“拷贝时校验”后，ClipPort 会用单个低 I/O 优先级后台工作器校验已经完整写入并提交的文件，复制始终具有更高优先级。 后台队列不会反向阻塞复制；队列繁忙或系统不支持后台优先级时，相关文件会在复制结束后继续校验。 后台工作器暂时没有可校验文件时，校验速度会立即显示为零，不再保留上一段校验速度。 该选项默认关闭，仅在同时启用复制和文件校验时生效；只校验任务仍按原有顺序执行。
目标位置已经存在同名文件时，可以选择：
- 询问：先继续处理其他文件，随后逐项或批量决定。
- 覆盖：安全写入完成后替换目标文件。
- 跳过：保留现有目标文件。
- 创建副本：自动生成不冲突的新文件名。
询问模式支持多选、全选和批量应用处理策略。
- 可以创建多个任务并加入执行队列；同一时刻只让一个任务实际读写，避免并发执行导致性能骤降或崩溃，任务会在“新任务”和“历史任务”区域中分别管理。
- 会阻止同时运行的任务使用相互冲突的源路径或目标路径。
- 创建“优先执行”任务后，当前普通任务会先在安全检查点确认停稳，再把执行权交给优先任务；优先任务暂停或全部完成后，原普通任务自动继续，多个优先任务按创建顺序执行。
- 每个任务都可以独立暂停、继续、取消；被优先任务暂停的普通任务也可点击“继续”强制执行，此时其他优先任务会转为暂停状态。
- 任务标题右侧会用灰色“优先任务”标识区分优先任务，并可选择在任务期间阻止电脑进入休眠。
- 失败、取消或意外中断的任务可以按原配置重新开始。
- 已完成复制的任务可以再次启动只校验任务，并沿用原任务选择的校验算法。
- 单个文件发生 I/O、权限或校验错误时，任务会继续处理其他文件。
- 任务结束前可以勾选失败文件并选择重试或跳过；摘要不一致的文件可以覆盖后重新校验。
- 显示当前阶段、当前文件、完成百分比、文件数量、数据量、速度和实际处理耗时；复制、校验及失败重试均使用独立的一秒单调时钟持续刷新，即使首次校验或校验大文件时暂时没有新的完成事件，耗时也会连续增加；等待用户选择重复项或失败处理方案时，相应阶段计时暂停；任务进入完成态后，速度栏立即改为对应阶段的平均速度。
- 扫描阶段显示不定总量进度和已发现的数据，不会把尚未完成的扫描误报为 100%。
- 分别记录复制与校验阶段的字节速度和项目数速度。
- 提供实时波形、当前值、最高值、最低值和动态刻度；横轴按可见采样时间线始终铺满图表，不再按任务完成百分比挤压采样点。刷新时横纵坐标都会从当前屏幕位置使用三次缓出动画连续过渡，新采样从上一帧尾点进入，避免坐标瞬移造成整条历史颤抖。长任务超过采样上限后会保留首尾与峰谷的多尺度摘要，避免历史文件和内存无限增长；拷贝时后台校验小文件的短暂队列间隙会保留最近一次有效速度和组合状态，不再反复跳到零速与“正在拷贝”。
- 只复制或只校验的任务仅显示对应的一组两张波形图；同时启用时显示两组图表，复制图表与校验图表都可以在并排布局和纵向堆叠布局之间切换。
- 吞吐采样会随任务历史保存，重新选择历史任务时仍可查看。
- 任务历史以 JSON 保存在本机，最多保留 200 条非活动记录。
- 活动任务不会因为历史数量达到上限而被删除。
- 单条损坏的历史记录会被隔离，不影响其他有效记录。
- 支持删除单条记录或批量删除已结束的记录；删除记录不会删除源文件和目标文件。
- 支持导出单个报告，也可以为多个任务批量生成报告。
- 报告内容跟随应用语言，并包含任务模式、实际校验算法、摘要、失败、警告和重复项处理明细。
- 支持跟随系统、浅色和深色三种外观模式。
- 支持 Windows 系统强调色，以及海沫绿、亮玫红、黄金色、浅薄荷色和紫影色五种预设颜色。
- 支持简体中文、English 和文言三种界面语言。
- 切换语言后可以立即安排应用安全重启，也可以稍后手动重启。
- 可以自定义日志和报告的保存目录。
- “设置 → 通知”可以同时添加并独立启用多个企业微信、钉钉、飞书、Bark 或 SMTP 邮件渠道，也支持添加多个同类型渠道。
- 企业微信、钉钉和飞书填写机器人 HTTP/HTTPS Webhook；Bark 填写包含设备 Key 的 HTTP/HTTPS 推送地址。它们不是 WebSocket 服务，因此不接受
ws://或wss://地址。 - SMTP 支持服务器、端口、登录账号、密码或授权码、发件人和多个收件人配置，连接会自动选择 SSL/TLS 或 STARTTLS。
- 每个渠道卡片底部都有“测试推送”，可以在正式启用前验证地址、凭据和服务响应。
- 可以分别选择“任务完成”和“任务失败”场景。失败场景包括部分完成、校验失败和执行失败；主动取消或应用中断默认不发送失败通知。
- 通知发送发生在任务结果、历史和报告保存之后；通知失败只写入日志，不会改变任务结果。多个已启用渠道会并行发送。
- Webhook/Bark 地址中的 Token 和 SMTP 密码使用 Windows DPAPI 按当前用户加密后写入设置文件；把设置复制给其他 Windows 用户时，这些凭据无法解密，需要重新填写。
- “设置 → 关于 → 检查更新”会从 GitHub Releases 获取最新版本（预发布版本也会纳入检查）。
- 发现新版本后可以查看发布说明；确认后自动下载并校验 SHA-256，再重启应用完成更新。
- 更新采用便携目录整体替换，不覆盖设置、任务历史、日志和报告。
| 算法 | 速度与摘要 | 兼容性与抗碰撞能力 | 建议用途 |
|---|---|---|---|
| SHA-256 | 速度与安全余量较均衡，256 位摘要 | 广泛支持，具备现代密码学抗碰撞能力 | 默认选择；重要素材交付和长期归档 |
| SHA-512 | 512 位摘要，计算开销通常更高 | 广泛支持，抗碰撞安全余量更高 | 对长期保存要求较高的归档 |
| SHA-1 | 通常较快，160 位摘要 | 便于兼容旧清单，但已不适合作为安全或防篡改证明 | 只用于必须兼容 SHA-1 的旧流程 |
| MD5 | 开销较低，128 位摘要 | 兼容性很高，但已不具备可靠的抗碰撞安全性 | 旧系统、旧清单或非安全兼容场景 |
| xxHash64 | 吞吐量优先，64 位摘要 | 非密码学算法，不用于防篡改证明 | 本机大批量快速完整性检查 |
校验摘要用于发现复制错误或文件变化，不等同于数字签名。 如果没有明确的兼容或吞吐量要求，建议保留默认的 SHA-256。
ClipPort 可以通过文件资源管理器右键菜单快速创建任务。
- 右击单个文件夹或文件夹空白处，打开“新建 ClipPort 任务”。
- 选择“作为源目录”或“作为目标目录”，ClipPort 会打开并预填新任务窗口。
- 如果 ClipPort 已在运行，请求会通过当前用户的本地进程协调通道转交给现有实例并恢复窗口；普通启动与稀疏包身份启动共用同一个主实例，不会让新进程把活动任务误判为中断。
- 新式菜单在多选或选择非目录项目时不会显示该命令；传统菜单只注册到文件夹与文件夹空白处。
- 菜单标题跟随简体中文、English 或文言界面语言。
“设置 → 快速开启”提供两个互相独立的入口：
- 传统右键菜单（无需证书）：直接注册到当前用户，无需管理员权限、签名证书或 MSIX。Windows 11 中从“显示更多选项”进入，也可用于 Windows 10。
- Windows 11 新式右键菜单：直接显示在首层右键菜单中，仅支持 Windows 11 版本 22000 或更高，由单独的稀疏 MSIX 组件提供。
如果只需要传统菜单，将完整发布目录放到固定位置，运行 ClipPort.exe 后打开“设置 → 快速开启”，仅开启“传统右键菜单（无需证书）”即可；下列证书与组件步骤都不需要执行。
若要启用 Windows 11 新式菜单：
- 将完整发布目录放到固定位置，再运行
ClipPort.exe。 - 打开“设置 → 快速开启”。
- 如果是使用开发证书签名的测试版，先核对证书来源和指纹，再按页面指引将公开证书安装到“受信任人”。
- 点击“安装组件”，等待页面确认注册成功。
- 打开“Windows 11 新式右键菜单”开关。
- 新开一个文件资源管理器窗口，右击文件夹或空白处进行测试。
发布目录需要同时包含 ClipPort.ShellExtension.dll、ClipPort.ShellIntegration.msix 和签名包所对应的 ClipPort.ShellIntegration.cer。
安装右键菜单组件后不要移动或拆分发布目录，因为稀疏包会引用该目录中的主程序和扩展 DLL。
构建与开发注册脚本会从应用原图生成清单规定的 50×50、44×44 和 150×150 PNG，避免包身份启动时任务栏退回占位图标。
- 点击“创建任务”，或通过文件资源管理器右键菜单预填源目录或目标目录。
- 选择源目录或存储卡。
- 如果启用复制，选择目标目录；可以额外填写目标子文件夹名。
- 选择任务模式、校验算法、是否拷贝时校验、重复文件策略、休眠防止和优先执行选项。
- 点击“开始任务”，在主界面查看实时进度与吞吐波形。
- 如果出现重复文件或失败文件，按界面提示逐项或批量处理。
- 任务结束后可以导出报告、重新开始或启动只校验任务。
| 内容 | 默认位置 |
|---|---|
| 设置 | %LOCALAPPDATA%\ClipPort\settings.json |
| 任务历史 | %LOCALAPPDATA%\ClipPort\history.json |
| 日志 | 用户文档目录\ClipPort\ClipPort.log |
| 自动报告 | 用户文档目录\ClipPort |
| 更新缓存与更新器日志 | %LOCALAPPDATA%\ClipPort\Updates |
日志和报告目录可以在设置中更改。
日志达到 5 MiB 后会轮换为 ClipPort.old.log。
通知渠道的非敏感字段保存在设置文件中；Webhook/Bark 地址与 SMTP 密码以当前 Windows 用户可解密的 DPAPI 密文保存。
- 当前发布目标仅为 Windows x64。
- 主程序是自包含目录发布，不是单文件程序，也不是完整应用 MSIX 安装包。
- Windows 11 右键菜单使用独立的稀疏 MSIX；测试版签名可能需要用户手动信任公开证书。
- 自动更新依赖 GitHub 网络访问；更新过程中应用会自动重启。
- C++ 原生复制引擎会随 Release 包构建和发布，但对应开关目前在界面中隐藏并禁用。
- 普通用户当前使用默认顺序复制路径；原生引擎和托管流水线仅用于代码级实验与回归测试，不应视为稳定的公开功能。
ClipPort
├── ClipPort.sln
├── packaging
│ └── ShellIntegration
├── scripts
│ ├── build-shell-package.ps1
│ ├── publish-beta.ps1
│ └── register-shell-package-for-development.ps1
├── src
│ ├── ClipPort
│ │ ├── Assets
│ │ ├── Models
│ │ ├── Services
│ │ ├── Strings
│ │ └── Views
│ ├── ClipPort.NativeCopy
│ └── ClipPort.ShellExtension
└── tests
└── ClipPort.CoreTests
- Windows 10 1809 或更高版本。
- .NET 8 SDK。
- Visual Studio 2022，并安装 MSBuild 与 C++ x64 桌面生成工具。
- 如需构建右键菜单包，还需要包含
MakeAppx.exe与SignTool.exe的 Windows SDK。
原生 C++ 项目需要 Visual Studio MSBuild。
不要使用 dotnet build ClipPort.sln 代替完整发布流程，否则可能因为无法解析 C++ targets 而失败。
git clone https://github.com/MEMZ-Edge01/ClipPort.git
cd ClipPortdotnet run --project .\tests\ClipPort.CoreTests\ClipPort.CoreTests.csproj -c Release当前核心测试共 47 项，覆盖：
- 本地化资源完整性与语言查找。
- Windows 系统强调色预览。
- 五种校验算法的复制后校验、只校验和损坏检测。
- 校验不一致覆盖、暂停、继续和取消安全。
- 重复文件的询问、覆盖、跳过和创建副本。
- 单文件失败继续执行与失败重试。
- 空目录、路径安全和符号链接保护。
- 吞吐波形采样与显示格式。
- 后台流式扫描响应性、1.6 TB 元数据统计、拷贝时校验与超宽窗口布局。
- 设置容错、本地历史、损坏记录隔离和历史保留。
- 多语言报告、警告保留和优先任务调度。
- 快速开启请求的参数解析与目录预填逻辑，以及打包原生 DLL 的接口可用性。
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\publish-beta.ps1脚本会：
- 使用 Visual Studio MSBuild 构建 Release x64 解决方案、C++ 原生 DLL 和 Shell 扩展。
- 检查
App.xbf、MainWindow.xbf、TraeWorkTheme.xbf和SettingsView.xbf。 - 发布
win-x64自包含运行时。 - 发布独立的
ClipPort.Updater.exe自包含更新器并放入发布目录。 - 验证
ClipPort.exe、ClipPort.dll、ClipPort.NativeCopy.dll、ClipPort.ShellExtension.dll、ClipPort.Updater.exe、resources.pri和语言资源。 - 以安全的暂存与替换流程写入
artifacts目录。 - 传入
-CreateZip时，额外生成ClipPort-{版本}-win-x64.zip与其.sha256校验文件，供 GitHub Release 上传。
默认输出位置：
artifacts\ClipPort-1.0.0-beta-win-x64
未提供签名参数时，普通发布仍会成功，但会跳过 ClipPort.ShellIntegration.msix。
发布 GitHub Release（例如打 tag v1.0.0-beta 或手动触发 release.yml）时，CI 会执行上述脚本并上传 zip 与 SHA-256 文件。
签名证书需要位于当前用户或本地计算机的 My 证书存储中，Publisher 必须与证书主题匹配。
$env:CLIPPORT_SHELL_PACKAGE_PUBLISHER = "CN=Your Publisher"
$env:CLIPPORT_SHELL_PACKAGE_CERTIFICATE_THUMBPRINT = "YOUR_CERTIFICATE_THUMBPRINT"
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\publish-beta.ps1脚本会构建并验证 ClipPort.ShellIntegration.msix，并把不含私钥的公开证书导出为 ClipPort.ShellIntegration.cer。
开发环境也可以在完成普通发布后使用松散清单注册，不需要生成可分发 MSIX：
powershell.exe -NoProfile -ExecutionPolicy Bypass `
-File .\scripts\register-shell-package-for-development.ps1 `
-ExternalContentDirectory .\artifacts\ClipPort-1.0.0-beta-win-x64- .NET 8 / C# 12
- WinUI 3 / Windows App SDK
- C++20 / Win32 /
IExplorerCommand System.Security.Cryptography与System.IO.Hashing- JSON 本地持久化
Copyright (C) 2026 MEMZ-Edge01
本项目采用 GNU General Public License v3.0 授权。 你可以依照 GPL-3.0 使用、研究、修改和重新分发本项目；分发修改版或衍生作品时，需要继续采用 GPL-3.0、保留相应版权与许可证声明，并按许可证要求提供对应源代码。 本项目不提供任何明示或默示担保，完整条款请参阅 LICENSE。
- 提交代码或文档前，请阅读 贡献指南 和 行为准则。
- 普通缺陷和功能建议请使用仓库的 Issue 模板。
- 安全漏洞不要提交公开 Issue，请按照 安全策略 通过 GitHub 的私密漏洞报告入口提交。
ClipPort is a Windows x64 desktop application for reliable media-card and directory transfers. It supports responsive streaming source scans, safe file copying, verification-only jobs, duplicate-file policies, a serial task queue with priority ordering, pause and cancellation, failure recovery, local history, localized reports, and real-time byte/item throughput charts.
File verification can use SHA-256, SHA-512, SHA-1, MD5, or xxHash64. SHA-256 is the default, and the selected algorithm is preserved across retries, re-verification, history, and reports. An optional, default-off “verify while copying” mode verifies fully committed files on one low-priority background worker without allowing queue pressure to block copying; any backlog is completed after the copy phase. Brief queue gaps between small files retain the latest useful verification rate and combined copy/verification status instead of flickering to zero and copy-only status.
On Windows 11, an optional sparse-MSIX shell component adds modern File Explorer commands for using a folder as the source or destination of a new ClipPort task. Activation is redirected through a per-user local channel, so packaged and unpackaged launches share the existing ClipPort process without rewriting active jobs as interrupted. Completed tasks replace their live transfer rates with the average copy and verification rates immediately. Settings can hold multiple WeCom, DingTalk, Feishu, Bark, and SMTP notification channels. HTTP providers use their native webhook payloads, SMTP negotiates SSL/TLS or STARTTLS, and completion/failure scenes can be selected independently. Provider secrets are protected with per-user Windows DPAPI before being written to disk.
The native C++ copy engine is built and packaged for engineering validation, but its UI switch is currently hidden and disabled. The default user-facing copy path is the sequential asynchronous implementation.
Run the 59 core tests:
dotnet run --project .\tests\ClipPort.CoreTests\ClipPort.CoreTests.csproj -c ReleaseBuild the self-contained Release package:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\publish-beta.ps1Copyright (C) 2026 MEMZ-Edge01
ClipPort is licensed under the GNU General Public License v3.0. You may use, study, modify, and redistribute the project under GPL-3.0. Distributed modified versions and derivative works must remain under GPL-3.0, retain the applicable notices, and provide the corresponding source code as required by the license.