aegis-watermark 0.1.1

A professional hidden watermark tool for images and PPTX documents.

Aegis (神盾) - 专业级隐形水印保护工具

Aegis 是一个基于频域盲水印技术的版权保护工具。它能够为图像及 PPTX 文档嵌入肉眼不可见的“视觉指纹”，即使文件经过截图、压缩或格式转换，依然可以提取出清晰的版权证据。

🌟 核心亮点

• 视觉水印技术: 不同于脆弱的文本编码，Aegis 嵌入的是视觉轮廓，对图像损伤具有极强的抗性。
• SHA-256 安全加固: 支持任意长度字符串密钥，通过哈希拉伸技术，彻底杜绝暴力破解和撞库。
• 交互式控制台: 输入 aegis 即可进入专业感十足的中英双语交互式主菜单，无需记忆复杂指令。
• 全自动文档保护: 针对 .pptx 格式提供深度加固，自动识别并保护文档内部的所有高价值图像素材。
• 极简专业 UI: 借鉴现代 CLI 设计，提供 ASCII Banner、动态加载动画及结构化分析报告。

🛠️ 技术栈

• 核心驱动: blind-watermark (频率域 DCT/DWT 变换)
• 界面引擎: Rich (终端美化) & questionary (交互菜单)
• 图像处理: OpenCV, Pillow, NumPy
• 文档处理: python-pptx

🚀 快速开始

1. 环境准备

确保你的系统安装了 Python 3.8+。

# 克隆项目并进入目录
git clone https://github.com/your-repo/Aegis-Watermark.git
cd Aegis-Watermark

# 安装依赖
pip install -r requirements.txt

# 以开发模式安装
pip install -e .

2. 运行工具

在终端输入命令即可启动：

aegis

3. 使用模式

• 交互模式: 直接输入 aegis，跟随菜单引导完成操作。
• 命令模式: 支持静默调用，适合脚本集成：
  • 嵌入：aegis embed -i input.png -o output.png -t "ID:716" -k "MyPassword"
  • 提取：aegis extract -i output.png -k "MyPassword"

📂 目录结构

aegis/
├── cli.py           # 交互式双语 CLI 入口
├── core/            # 核心算法 (视觉水印 & 哈希加固)
└── handlers/        # 格式适配 (Image & PPTX)

🔒 安全建议

• 密钥设置: 建议使用包含字母和数字的长字符串作为密钥。
• 默认机制: 若不输入密钥，系统将默认使用密钥 "1"。
• 版权验证: 提取出的结果图片若能清晰辨认文字轮廓，即具备版权铁证效力。

📝 路线图

• 支持 PDF 矢量图层水印
• 增加多线程批量处理模式
• 集成 AI 深度学习水印算法

---

Aegis - 为每一份智力成果披上隐形神盾。