Renamed from arcdb: module path, cmd/archer, internal/archererr, docs, build scripts and ARCHER_* environment variables. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.2 KiB
2.2 KiB
Why
当前只支持 none|gzip|zstd,且压缩级别写死为 3,用户无法在"吞吐优先"与"空间优先"之间取舍。xz 能显著降低长期归档的存储成本,但压缩吞吐远低于 gzip/zstd;把它作为一个显式选项,同时把级别做成统一档位,才能让三种压缩器在同一语义下被选择。
What Changes
- 新增
--compress xz,每个分片是一个独立 xz 流,扩展名为.xz。 - 新增
--compress-level 1..9,默认 3;1–9 是跨格式统一档位,按格式映射到各自的压缩参数,9 表示该格式最强。默认档位 3 与现有行为一致。 --compress none与非默认--compress-level同时出现时视为配置错误。- 配置指纹:仅当
compress != none且level != 3时把compress_level纳入指纹,保证本功能之前启动的任务仍能无缝续跑;非默认档位变化仍会被识别并拒绝。 - 崩溃恢复扫描必须识别
.xz分片,避免重算序号覆盖已封分片。 - 收敛扩展名逻辑:dry-run 复用
Compressor.Ext,删除重复的compressExt表。 - 引入纯 Go 依赖
github.com/ulikunitz/xz。 - BREAKING: 无。未设置
--compress-level时,gzip/zstd 的产物与当前版本一致。
Capabilities
New Capabilities
(无)
Modified Capabilities
output-formats: 压缩 Requirement 从 3 种压缩器扩展为 4 种,并定义 1–9 档位到各格式的映射与 xz 场景。cli-contract: 默认值中加入--compress-level 3,参数依赖规则加入none与非默认档位的冲突校验。archive-core: 断点续跑指纹纳入非默认压缩档位,并明确档位变化时的拒绝行为。file-sharding: 文件命名与分片清单覆盖.xz,并明确崩溃后按压缩扩展名识别已封分片。
Impact
- 代码:
internal/cli/{config,parse,validate,hash}.go、internal/shard/{compress,manifest}.go、internal/app/{app,dryrun}.go - 依赖:
go.mod/go.sum新增github.com/ulikunitz/xz - 文档:
README.md压缩章节、档位表与 xz 导入示例 - 测试:
internal/shard/writer_test.go、internal/app/integration_test.go、internal/cli校验与指纹测试