hhalperin/steganalysis-toolkit

# 隐写分析工具包 **隐写分析工具包**是一个用于研究隐藏信息方案在**文本和图像**中脆弱性或抗干扰能力的代码库——旨在探索哪些干扰或净化尝试仍会留下可检测的痕迹，以及哪些痕迹在验证中会被消除。其目的是防御性的：**红队告知蓝队**，以便水印和隐写设计师能够加固现实的威胁模型。 **本项目并非旨在击败 C2PA、SynthID 或任何生产环境的内容出处归属。** 此处的实验旨在针对**合成测试输入**或**您拥有并可修改的媒体**运行。使用此代码来研究攻防动态和检测器行为——而不是为了剥离您未创建的媒体的出处。 ## 工程贡献 最具可复用性的成果是**智能体循环**：**检测 → 修改 → 验证 → 重试**，并带有结构化日志和可选的实时预览。隐写分析基底（PNG 块、LSB 统计、频域特征、Unicode 异常、可见叠加层检测器等）是该循环所针对的领域；您可以将这种编排模式用于其他取证流程。 ## 功能（概述） - **多媒介信号** — 文本和图像路径共享命令行界面和报告理念；图像处理栈侧重于 PNG 结构、元数据和统计检测器。 - **检测** — 块分析、Unicode 扫描、LSB / 隐写统计、可见叠加层启发式方法、模式 / “高级废料”风格特征。 - **抗干扰实验** — 清洁和修复后端，用于压力测试标记是否能在迭代干扰中幸存（始终在授权的研究背景下进行）。 - **可视化** — 可选的仪表板和可视化助手，用于比较多轮检测结果。 主命令行工具（安装后）：**`stk`**。从代码库中您也可以运行 `python -m stega.cli`。 ## 快速开始 ``` git clone https://github.com/hhalperin/steganalysis-toolkit.git cd steganalysis-toolkit python -m venv .venv .venv\Scripts\activate # Windows # source .venv/bin/activate # macOS / Linux pip install -e . pip install -e ".[dev]" # optional: pytest, black, mypy pytest ``` 运行示例（在当前目录创建示例 PNG）： ``` python -m stega.examples ``` 分析一个 PNG 文件： ``` python stega/core/png_analyzer.py path/to/image.png stk detect path/to/image.png stk full-test path/to/image_dir # batch JSON report ``` 可选的更强修复功能（LaMa）：参见 `requirements-lama.txt`。 ## 适用场景 - **防御性水印设计** — 通过实证观察哪些扰动能去除或保留检测器可见的信号。 - **学术/实验室隐写分析** — 用于课程作业或出版物的可复现脚本（请引用本仓库；遵守您机构的伦理政策）。 - **了解保护与清除的军备竞赛** — 通过实践循环展示为何朴素的标记会失败，以及为何验证至关重要。 ## 仓库结构 ``` steganalysis-toolkit/ ├── stega/ # Python package (detection, cleaning, CLI, visualization) ├── tests/ # pytest suite ├── docs/ # Guides, ADRs, pipeline notes ├── assets/ # README only in git; local datasets stay ignored ├── .agents/skills/ # Agent skill stubs for research workflows ├── .github/ # Contributing, security, issue templates ├── pyproject.toml # Package metadata + stk entry point ├── requirements.txt # Mirror of runtime pins (optional alongside pip install -e .) └── README.md ``` ## 法律/伦理 MIT 许可证 — 详见 [许可证](LICENSE)。您有责任进行合法、授权的使用。作者对误用不承担任何责任。 ## 参考资料 - PNG: [https://www.w3.org/TR/PNG/](https://www.w3.org/TR/PNG/) - Unicode: [https://unicode.org/standard/standard.html](https://unicode.org/standard/standard.html)

标签：AI水印, EDR规避, LSB统计, meg, Mutation, PNG分析, Unicode扫描, 代理循环, 信息安全, 可视化, 图像检测, 多介质检测, 威胁建模, 媒体分析, 实时预览, 弹性测试, 数字取证, 文本检测, 检测修改验证, 研究工具包, 红队蓝队, 结构化日志, 自动化脚本, 逆向工具, 隐写分析, 频率域分析