Zero-Breach-Toolkit

环境要求

• Python 3.8 或更高版本（Windows 安装时勾选 Add python.exe to PATH）
• Windows 或 macOS 电脑（Linux 下用 sh scan/run-scan.sh 运行）
• 无需管理员权限，也无需安装额外 Python 包
• 约 20 分钟时间，扫描前关闭浏览器和聊天软件

安装与启动步骤

1. 1获取工具源码

   从 GitHub 选择 Code → Download ZIP 解压，或用 git clone 拉取仓库；后续所有命令都在该目录内执行

   git clone https://github.com/interplains/Zero-Breach-Toolkit.git

   复制

2. 2在工具目录开终端

   Windows 打开解压出的 Zero-Breach-Toolkit 文件夹，点地址栏输入 powershell 回车；macOS 在终端输入 cd 加空格后把文件夹拖进窗口回车

   cd Zero-Breach-Toolkit

   复制

3. 3更新指标特征库

   可选步骤，也是唯一需要联网的一步；不更新则只用内置的小型特征集，建议每隔几周重复一次

   python -X utf8 scan/zero-breach-toolkit.py --update

   复制

4. 4授权终端磁盘访问

   仅 macOS 需要：系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加终端并重新打开，否则部分目录会显示为未检查

5. 5运行标准扫描

   关闭浏览器与聊天软件后执行，出现菜单直接回车即扫描本机；Windows 也可双击 scan un-scan.cmd

   python -X utf8 scan/zero-breach-toolkit.py

   复制

6. 6扫描手机数据

   把手机采集数据或 iPhone 备份放到某个文件夹，用引号包裹路径后作为 --phone 参数传入；路径含空格必须加引号

   python -X utf8 scan/zero-breach-toolkit.py --phone "/your/path/backup"

   复制

7. 7导出其它格式报告

   --json 输出机器可读报告，--share-json 输出便于分享的最小摘要；--quick 跳过文件指纹以加快速度

   python -X utf8 scan/zero-breach-toolkit.py --json report.json

   复制

关键配置

如何确认成功

扫描结束后，工具目录旁的 findings 文件夹中会生成可读报告和 JSON 报告，打开即可查看可疑项与未检查项。

常见问题

注意事项

• 报告包含本机隐私信息，请勿放在共享或云同步文件夹中。
• 工具为只读设计，不修改原始证据和系统设置，仅写入临时数据库快照和你指定的报告。
• 若怀疑正被定向监控，应先联系 Access Now 数字安全热线或 Amnesty Security Lab 等专业机构求助。
• 源码运行时可复现：README 提供按发布标签重建单文件并与发布 SHA-256 比对的方法，可据此校验所运行代码。