Z-Hound v0.3.0

Z-Hound v0.3.0 提供从高价值 IoC 导入、确认与价值标注，到真实资产拓线、证据研判和快照回放的完整流程。Z-Hunter 报告采集可作为种子来源，也可直接导入已有 IoC。

使用

git clone --branch v0.3.0 --depth 1 https://github.com/yyzpiero/Z-Hound.git
cd Z-Hound
cp .env.example .env

编辑 .env，填写自己的 FOFA_API_KEY；默认连接官方 https://fofa.info，FOFA_EMAIL 为可选旧账号兼容项。DEEPSEEK_API_KEY 可选，不填也能拓线。

cp -n data/source.example.csv data/source.csv
env UID="$(id -u)" GID="$(id -g)" docker compose up --build -d

访问 http://127.0.0.1:8080/#/hunting 。全新安装的种子和任务为空，导入自己的 IoC 并记录确认、价值和来源后开始真实查询。Windows Docker Desktop 使用 README 中的 PowerShell 步骤。

功能

• 独立种子库支持 TXT、CSV、JSON 导入，记录来源、人工确认与价值变更。
• FOFA 查询提取 JARM、证书 CN、页面标题与服务信息，组合生成拓线规则；请求预算、单次结果数、弱证据过滤和海量命中停止共同控制消耗。
• 结构化对照证书主体、签发机构、序列号、有效期及服务证据，区分匹配、差异和缺失；关联性与组织归属分别审核。
• DeepSeek 可对已有证据排序；导出和离线回放保留查询、响应与研判记录。
• Z-Hunter 保留报告抓取、IoC 提取、人工审核与 CSV 输出。

验证

• 384 项本地回归测试通过，独立代码 review 无阻塞问题。
• GitHub Docker CI 验证镜像构建、空库启动、导入与确认、进程重启和删除容器后重新挂载数据目录，审核状态及历史均保留。
• 真实 CN 案例使用 4 次 FOFA 搜索、0 次 DeepSeek，找回 7 个非种子 IP，其中 6 个有原始研究的历史关联佐证、1 个保持待定。案例及实际快照见仓库文档。

本轮真实资产试验使用已配置的 FOFA 兼容服务；官方 FOFA 请求字段和 key-only 配置经过文档核对及回归测试。账户权限和额度由使用者自己的官方账号决定。候选关联仍需人工核对，不自动成为已确认恶意 IoC。

附件提供源码包、Python wheel 和 SHA-256 校验文件。Docker 镜像从本版源码构建，不包含个人 API Key、本地数据库或用户私有来源目录。

验证记录：版本标签 Docker CI · 合并 PR #1。