diff --git a/README.md b/README.md
index c35fe49..324edac 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,46 @@
     }
   ],
   "files": [],
-  "v": "2022-10-24"
+  "v": "2025-11-21"
 }
 ```
+
+字段说明：
+
+- `basename`: 文件名
+- `size`: 文件大小（字节）
+- `friendly_size`: 人类可读的文件大小
+- `mtime`: 文件修改时间（Unix 时间戳）
+- `head_115`: 115网盘头部哈希（前128KB的SHA1）
+- `head_baidu`: 百度网盘头部哈希（前256KB的MD5）
+- `ed2k`: ED2K 哈希
+- `md5`: MD5 哈希
+- `sha1`: SHA1 哈希
+- `sha256`: SHA256 哈希
+- `xxh128`: XXH3-128 哈希（用于快速校验）
+- `v`: 元数据格式版本号
+
+## 其他说明
+
+**进度显示**
+
+处理过程中会显示实时进度条，包括当前文件名、处理速度和剩余时间等信息。
+
+**软链接处理**
+
+程序会自动跳过所有软链接（符号链接），不进行递归处理。
+
+**自动排除的文件和目录**
+
+以下条目会在扫描时跳过（与 `constants.rs` 中 `SKIP_*` 及 `should_skip_file` 规则一致）：
+
+| 系统 / 环境 | 目录名（整段跳过） | 文件名（精确匹配） | 文件名模式 |
+|-------------|-------------------|-------------------|------------|
+| **群晖等 NAS** | `@Recently-Snapshot`（快照）、`@Recycle`（回收站）、`.@__thumb`（缩略图缓存）、`@Transcode`（转码） | — | — |
+| **Windows** | `$RECYCLE.BIN` | `Thumbs.db`、`desktop.ini` | 以 `Thumb_` 开头 |
+| **macOS** | — | `.DS_Store` | 以 `._` 开头（AppleDouble 资源叉） |
+| **本工具** | `meta`（元数据子目录） | `meta.json`、`meta-old.json`、`licsber-bak.json`（兼容旧工具） | — |
+
+**子目录递归优化**
+
+遍历目录时，如果某个子目录下已存在 `meta.json`，程序会直接加载并快速校验该子目录的元数据，而不是重新计算所有文件。这有助于加快大型目录树的处理速度。