v5.0.1

v5.0.1 — 修复大归档解包卡顿

修复内容

• 根因：大归档解包时，预取器把「已消费的块」也算进预取预算，池子被 265MiB 已消费块占满后，预取提交被拒约 1500 次，约 46% 的块退化成同步解密（主线程写文件时等解密）——表现为「时不时卡一下」+ CPU 只有 ~20%。
• 修复：预取预算只统计「在途」字节；块仅在仍有后续引用时驻留缓存（引用计数）；窗口指针只在预算接受时推进。
• 效果（3GB 归档同负载 A/B）：解包 40.6s → 31.2s（+23%），同步解密 715 → 0，主线程等待 3s → 0.4s，内存峰值 431MiB 与归档大小无关。
• 新增 unpack --debug：打印 IO/解密/预取统计，用于定位卡顿。

文件

• shuffle-arc-cli.exe / shuffle-arc-cli-zh.exe / shuffle-arc-gui.exe / shuffle-arc-gui-zh.exe（均为 v5.0.1）

v5.0.0

v5.0.0 — parallel streaming unpack + GUI multi-core

磁盘格式不变（v3），与 v4.x 归档完全兼容（v5 可解 v4，v4 可解 v5）。

新增

• 大归档并行流式解包：小归档整池并行；大归档用「有界预取」线程池按清单顺序提前解密待用块，在途明文内存由缓存预算封顶（256MB），任意大小归档都可并行。同机同负载 A/B 实测：解 3GB 归档比旧代码快约 20%。
• GUI 打包多核化：默认使用全部 CPU 核心（之前为规避 frozen exe 限制固定单进程）。
• GUI 压缩级别选项：zstd 1/3/6/9/19 可选。
• CLI --version：输出 shuffle-arc 5.0.0 (disk format v3)。
• README 双语同步更新。

回归验证

• _test_v5.py 8 项断言全过（真随机 roundtrip、去重、48MB 源流式打包峰值堆 <12MB、v4↔v5 双向交叉兼容、免密 list）。
• 300MB 随机数据 en/zh 双版 prefetch roundtrip 哈希一致。
• 9.73GB 全量（894 文件）：流式打包无换页；解包 894 文件全解出，30 文件抽样 SHA-256 全对。
• 4 个 exe 重建后 3GB roundtrip 848/848 哈希全对；GUI（en/zh）冒烟启动正常。

v4.0.0

shuffle-arc v4.0.0

双密码「分块打乱加密压缩」归档工具 v4 正式版。

本版更新

• v4 流式解包：LRU 块缓存（默认 256 MiB 上限），任意大小归档解包峰值内存有界，不再全量读入 RAM
• 安全加固（9/5）：封堵 Zip-Slip 路径穿越、头字段 DoS、越界块引用、条目表截断/载荷越界
• 全新主题 GUI（中/英）：Material 风格界面，替换旧版灰白面板
• Android 版同步加固：Kotlin 原生核心补齐同样的路径穿越/DoS/越界防护（APK v4.0.0）
• v1 旧档支持移除：格式保持 v3 字节级兼容（PC ↔ Android 互操作验证通过）

附件

文件	说明
shuffle-arc-gui.exe / shuffle-arc-gui-zh.exe	🖥️ GUI（中/英）
shuffle-arc-cli.exe / shuffle-arc-cli-zh.exe	⌨️ CLI（中/英）
shuffle-arc-android-debug.apk	📱 Android 应用（Kotlin 原生，minSdk 24）

下载

• Windows exe：直接下载对应文件即可
• Android：下载 APK 安装（需允许「安装未知来源应用」）

⚠️ 自定义格式，仅支持 v3 归档（v1 旧档支持已移除）。清单明文是设计取舍（免密 list）。忘记任意一个密码 = 数据永久不可恢复。

v3.0.0

shuffle-arc v3.0.0

双密码「分块打乱加密压缩」归档工具首个正式版本。

特性

• 双独立密码（加密 + 打乱），置换不入档，完全由打乱密码决定
• 分块去重：相同块只存一份，相似文件只存差异
• 明文清单：list 免密查看归档内容
• 每块 zstd 压缩 + AES-256-GCM 加密（AAD 绑定槽位防调包）
• 随机访问 --chunk N、v1 旧档兼容、绝不静默覆盖

附件

• shuffle-arc-v3.zip：Windows 免安装 exe（GUI + CLI）+ 源码 + README