From 6878c17a833e6a595d4f80e47e98c256d60ca9c0 Mon Sep 17 00:00:00 2001 From: ShuaixinHuang <1836656514@qq.com> Date: Sun, 22 Nov 2026 03:24:15 +0800 Subject: [PATCH] docs(artifacts): explain the per-file verification cost of extraction (#12745) Co-authored-by: ShuaixinHuang --- docs/getting-started/cli.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/getting-started/cli.md b/docs/getting-started/cli.md index 2befe4e4d2..b4ee84b14d 100644 --- a/docs/getting-started/cli.md +++ b/docs/getting-started/cli.md @@ -401,6 +401,13 @@ as archive corruption. The cap cannot be raised at runtime: recompress with a window of at most 128 MiB, or decompress externally before retrying. Deprecated method 20 and other unregistered ZIP codecs remain unsupported. +Extraction verifies each written file before publishing the output. REA syncs +the file, reopens it, and checks its size and SHA-256 against the bytes it wrote. +Each file adds filesystem work, so archives with many small files can take +longer to extract even when their total size is modest. If you only need the +archive inventory, run `rea inspect-artifact --json` to get it without +writing an extracted tree. + Inventory and extract UF2 or DfuSe regions: ```sh