Metadata-Version: 2.4
Name: aegis-watermark
Version: 0.1.3
Summary: 图片与PPT专业级隐形盲水印工具 | Professional blind watermarking tool for images and PPTX documents.
Home-page: https://github.com/your-repo/Aegis-Watermark
Author: LingQingyang
Author-email: 1739677116@qq.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: blind-watermark
Requires-Dist: opencv-python
Requires-Dist: numpy<2.0.0
Requires-Dist: click
Requires-Dist: Pillow
Requires-Dist: pyfiglet
Requires-Dist: rich
Requires-Dist: python-pptx
Requires-Dist: questionary
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Aegis (神盾) - 专业级隐形水印保护工具 🛡️
### Professional Hidden Blind Watermarking Tool

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

Aegis is a copyright protection tool based on frequency domain (DCT/DWT) blind watermarking technology. It embeds invisible "visual fingerprints" into images and PPTX documents. The watermark remains extractable even after screenshots, compression, re-photography, or format conversion.

---

## 🌟 核心亮点 | Key Features

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

## 🛠️ 技术栈

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

## 🚀 快速开始

### 1. 环境准备
确保你的系统安装了 Python 3.8+。

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

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

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

### 2. 运行工具
在终端输入命令即可启动：

```bash
aegis
```

### 3. 使用模式

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

## 📂 目录结构

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

## 🔒 安全建议

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

## 📝 路线图

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

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