hash-check

文件哈希校验 — 生成/校验目录 SHA-256 清单：下载验 integrity、传输前后比对、防篡改留证（零依赖） 适用场景：当需要文件哈希校验能力时使用本技能；触发词：hash-check。

凡自治之物 · LGD 治理学 · 创造术家族 ｜ 评测协议：见平台质量门禁规范

English

When to use

1. After a file download, transfer or upload, to verify that no bit-rot, corruption or tampering occurred.
2. When an independent integrity manifest must be generated as a distribution credential for later client-side re-verification.
3. In version control, backup/restore or multi-party collaboration, when file fingerprints must be recorded to ensure ongoing consistency and keep audit evidence.

Usage

1. Run the Python script from the command line: python hash_check.py — zero-dependency.
2. Core parameters: --input (file or directory path) and --action (mode: check / generate / compare).
3. To batch-check a directory, pass the full path and set the output to JSON to fit automated pipelines.

Workflow

1. Initialize the script runtime; confirm the Python environment and stdlib (e.g. hashlib) are healthy.
2. Upload or point at the local target file/directory; ensure read/write permissions and correct paths.
3. Start the compute module: walk the directory or read the single file, hashing block by block and aggregating into a SHA-256 value.
4. The script auto-compares against the provided hashes (if expected values are configured) and returns a pass/fail status code to the console.
5. Save the verification result to a log file or the designated JSON output location, forming a tamper-evident credential record.

Evidence & safety statement

• Evidence: TBD (no evaluation / badge link yet; update here once it is produced)
• Version: 1.0.1
• Security: no independent security scan has been performed (TBD); the conclusion is pending and no endorsement is given until it is completed.

中文

何时用

1. 在文件下载、传输或上传完成后，用于校验数据是否发生比特翻转、损坏或被人为篡改。
2. 当需要生成一份独立的完整性清单（Manifest）作为分发凭证时，用于后续客户端二次比对验证。
3. 在进行版本控制、系统备份恢复或多方协作场景下，需记录文件指纹以确保持续一致性并保留审计证据。

用法

1. 直接通过命令行执行 Python 脚本，主要命令格式为 python hash_check.py，支持无依赖运行。
2. 核心参数包括 --input（指定输入文件或目录路径）和 --action（校验模式：check/generate/compare）。
3. 若需要批量校验目录结构，需传入完整路径并配置输出格式为 JSON 以适配自动化流程。

流程

1. 初始化脚本环境，确认当前 Python 运行环境与依赖库（如 hashlib）状态正常。
2. 上传或指定本地目标文件/目录，确保输入源权限可读写且路径无误。
3. 启动计算模块，遍历目录结构或读取单个文件并逐块哈希聚合生成 SHA-256 值。
4. 脚本自动比对双方提供的哈希值（如配置了预期值），并在控制台返回通过或失败状态码。
5. 将验证结果保存至日志文件或指定 JSON 输出位置，形成不可篡改的凭证留存记录。

证据与安全声明

• 证据：TBD（暂无评测/徽章链接；产生后在此更新实际链接）
• 版本：1.0.1
• 安全：未做独立安全扫描（TBD），结论待补；补全前不作推荐背书。