付费|Paid HuoNiu Leak Tracer XF 文件下载指纹 2.0.6

新增​

跳过注水的资源 ID

在后台 下载指纹 → 插件设置 中，可填写 XFRM 资源 ID（多个用逗号或空格分隔）。

列入列表的资源将原样下载，不会：

• 注入下载指纹
• 重写压缩包内的 hashes.json
• 注入 license.txt 授权证书

适用于需要保持官方文件完整性、配合远程授权/哈希校验的插件资源（例如带卡密验证的 XenForo 插件包）。

规则说明​

• 优先级最高：即使该资源所在分类已勾选「启用水印的资源分类」，只要在豁免列表中，同样不注水。
• 无需换分类：可把需要豁免的资源留在原分类，单独填写资源 ID 即可。
• 下载日志：豁免下载的状态显示为「资源 ID 豁免」；资源 ID 可在下载日志中查看。

新增

• 按 XFRM 资源分类控制是否注水（留空 = 全部分类）
• 下载文件名前缀 / 后缀（占位符：{username}、{user_id}、{resource_id}、{resource_title}、{site}）
• 下载日志增加分类、下载状态字段
• 英文语言包

调整

• 后台菜单顺序：插件设置 → 溯源解码 → 下载日志
• 后台菜单图标改为指纹
• 关闭总开关时完全走 XFRM 原生下载

修复 / 优化

• 修复大文件注水内存溢出
• ZIP 磁盘 staging + 流式输出
• 下载前体积 / 解压总量 / 文件数 / 内存预检
• 超限或注水失败时原样下载并记录状态

修复与改进​

XF 插件包文件健康检查

• 修复下载 XF 插件 ZIP 后，<span>hashes.json</span> 未随水印 PHP 同步更新的问题
• 买家安装插件时不再因哈希不一致触发「文件健康」报错

下载包时间戳

• 用户下载的资源包内，所有文件与目录的修改时间统一为下载时刻
• 兼容 Linux（Debian）、Windows、macOS 等常见服务器环境
• ZIP 内目录条目也会写入时间戳，压缩软件中显示更完整、一致

分发格式区分处理

• XF 插件包（含 <span>hashes.json</span>）：注入水印 + 自动重算哈希 + 统一时间戳
• 普通 ZIP / JAR 等：注入水印 + 统一时间戳，不处理哈希（此类包本身无哈希文件）

• 支持 JAR 格式：现可对 Minecraft Bukkit/Spigot 插件（.jar）进行水印注入。指纹写入 plugin.yml 及 META-INF/MANIFEST.MF，不影响插件正常安装与运行
• JAR 溯源解码：后台溯源工具支持直接上传 .jar 文件进行水印提取与下载记录匹配
• 解码工具文件大小限制与全局设置同步：上传文件解码时的大小限制现与「最大水印文件大小」选项保持一致，不再固定为 50 MB

修复

• IP 地址记录异常：修复极少数情况下 IP 地址解析失败时写入错误数据的问题，日志与 CSV 导出中将显示 (unknown) 而非乱码
• CSV 导出安全性增强：修复用户名以特殊字符（=、+、-、@）开头时在电子表格应用中可能被误识别为公式的问题
• 零宽字符水印提取范围扩大：现可从块注释（/* */）风格的 PHP 文件中正确提取零宽字符水印，不再仅限于单行注释（//）

• 新增「最大水印文件大小」设置（默认 50 MB）
  超过此大小的 ZIP / TAR 文件将跳过水印注入，直接提供原始文件下载，避免超大资源包在注水时消耗过量服务器内存。如需不限制可设为 0。设置路径：ACP → 选项 → HuoNiu 下载指纹。
• CSV 导出改为流式分批输出
  下载日志导出不再将全部记录一次性载入内存，改为每批 1,000 行逐步写入，适用于记录量较大的站点，避免导出时触发内存溢出。
• 溯源解码工具：提交后输入内容不再被清空
  使用「直接输入指纹」或「粘贴 PHP 内容」方式解码后，表单中已填写的内容现在会保留，方便核对和二次操作。

内部优化

• 清理了日志删除流程中一处无效的重复调用。

安全修复

• CSV 导出增加注入防护，对以 = + - @ \t \r 开头的用户名自动添加 ' 前缀

性能优化

• 指纹算法从 md5() 改为 hash('xxh128', ...)
• 为 download_date 列添加独立索引，优化分页查询
• 隐写术与零宽字符注入合并为单次遍历，减少 ZIP 迭代开销

Bug 修复（关键）

• 新增 rewriteHashesJsonInZip() 方法，在水印注入后按 XF 原生算法重算哈希，确保买家安装后"文件健康检查"通过
• 引入 $modifiedContents 内存映射，解决 ZipArchive::getFromName() 在 close() 前返回旧内容的问题
• 修复 hashes.json 路径前缀不匹配问题（ZIP 条目名带 upload/ 而键不带），增加前缀自动检测逻辑