上传完成防抖核验

适用场景

处理 SMB、共享目录、同步盘或对象存储在创建、刷新属性和完成传输时产生的多次事件。

输入与输出

输入包含 eventpath、eventtime、observedsize、previoussize、observedhashref、previoushashref、cooldownseconds、eventcount 和 transferstate。输出 STABLE/WAIT/DUPLICATEEVENT/REVIEW、等待理由和 nextcheckafter。

安装与执行

无需第三方依赖。执行 python scripts/debounce.py examples/input.json，脚本不等待、不监听真实目录，只计算建议分支。

错误恢复

传输状态为 copying、大小或哈希仍变化时输出 WAIT；同一路径同一哈希在冷却窗内重复出现时输出 DUPLICATE_EVENT；缺事件时间或冷却窗口时输出 REVIEW。

权限与隐私边界

不操作目录、不删除事件、不阻塞生产队列、不保证网络文件系统一定只发一次事件。

验收方法

大小稳定且状态 complete 输出 STABLE；状态 copying 输出 WAIT；同路径同哈希在窗口内重复输出 DUPLICATE_EVENT。