目录交付与 SHA-256 内容核验

版本与入口

本页介绍的模块已包含于 2026-11-03 交付的测试安装包中。版本号相同也不代表功能相同，请先核对下载与构建说明。

在对象浏览中选好连接、桶和前缀，点击「目录交付」。仅 Electron 原生环境可执行；网页和浏览器预览不访问本地文件系统。只读连接只允许下载。

先预览，再开始

1. 选择上传本地目录或下载当前远端前缀，选择已存在时跳过或允许覆盖，再通过系统窗口选择本地目录。
2. 核对逐项相对路径、原始 Key、大小与冲突。上传保留子目录，不把所选根目录名加入 Key；下载移除当前前缀后映射到本地目录。
3. 检查阻止项后开始。预览授权 10 分钟有效且只可用一次；预览/运行时锁定连接配置。
4. 重新打开窗口查看批次进度、文件详情、取消与 JSON 清单。关闭窗口或切换页面不会停止批次。

MinIO/未知 S3 的 HEAD 检查不能保证并发下不覆盖，需显式允许覆盖后重新预览。跳过已有文件不代表验证其内容一致。

核验实际读取的内容

• 上传完整读取源文件计算 SHA-256，提交后 HEAD，再按 VersionId 或 ETag 条件额外完整 GET 远端内容比对；需要 GetObject 权限，并产生读取流量和请求成本。
• 下载计算 GET 流摘要，落盘后再次完整读取本地文件比对，并检查长度和远端版本。
• ETag 不是内容哈希；摘要只证明本次读取和传输的一致性，不提供来源认证、数字签名或永久不变保证。

提交完成但核验失败仍是失败，清单同时保留实际提交与核验错误。取消不删除已提交文件，也不撤回已完成的写入。

文件和批次限制

每次最多 1000 文件、10000 遍历项、32 层目录，单文件不超过 64 GiB，远端分页最多 100 页。超限或重复/缺失游标拒绝预览；符号链接、特殊文件、不安全文件名、大小写/Unicode 别名和文件/目录冲突作为阻止项，不静默改名。支持空文件，不创建空目录或目录标记对象。

最多两个活动批次，每批最多八项进入队列窗口；实际并发仍由设置中的 1–4 控制。独立保留最多 20 个终态批次，不受普通任务 200 条淘汰影响。重启将未完成批次标记中断，需重新选择目录与预览；批次项目不走普通任务重试。单文件分片续传仍是独立流程。

导出与交付

JSON 包含版本、批次时间、方向、桶/前缀、相对路径与原始 Key、逐项结果和两侧摘要，不含凭证、本地绝对路径或签名 URL。生成的公开 URL 标记 generated-not-access-verified，不代表匿名可访问；连接后续修改不会改写旧清单。

本地保存失败时及时导出当前会话结果。当前不做目录差异同步、自动删除、跨云迁移或目录整体原子提交。选择自己可控的目录，避免其他进程同时修改目录树。已有验证为隔离 macOS Electron 与回环存储夹具，不外推真实云账号、新安装包或其他系统。

原生界面示例