docs: 完善 README 字段说明和使用说明
This commit is contained in:
42
README.md
42
README.md
@@ -52,6 +52,46 @@
|
|||||||
}
|
}
|
||||||
],
|
],
|
||||||
"files": [],
|
"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`,程序会直接加载并快速校验该子目录的元数据,而不是重新计算所有文件。这有助于加快大型目录树的处理速度。
|
||||||
|
|||||||
Reference in New Issue
Block a user