文件哈希去重核验
适用场景
在文件上传、批处理或资料同步中,判断内容是否已见、是否只是同名新版本,并输出可解释的分支。
输入与输出
输入包含 intakestatus、sha256ref、sourcescope、existinghashes、versionkey 和 collisionpolicy。输出 NEW/DUPLICATE/REVIEW、匹配引用、版本结论和 decision_hash。
安装与执行
无需第三方依赖。执行 python scripts/dedup.py examples/input.json,不接数据库、不执行删除或覆盖。
错误恢复
接收状态不是 READY、哈希引用缺失、范围不明或同名策略未声明时输出 REVIEW;哈希命中时输出 DUPLICATE,保留已存在引用。
权限与隐私边界
只处理哈希和引用,不读取或上传文件,不删除重复项,不覆盖既有版本,不将哈希当作绝对安全证明。
验收方法
新哈希输出 NEW;已存在哈希输出 DUPLICATE;删除 sourcescope 输出 REVIEW;同名不同哈希按 versionkey 输出 NEW_VERSION 或 REVIEW。