LuminCrypt 是一款桌面安全工具箱，面向 Unicode 隐藏字符检测、加密不可见文本水印 与 鲁棒图片盲水印 场景。它可以帮助研究者、内容创作者、出版和安全团队检查可疑 Unicode 内容、嵌入可恢复的文本指纹，并测试图片水印在压缩、缩放、裁剪和平台二次编码后的可恢复能力。
- Unicode 隐藏字符检测：识别零宽字符、BiDi 控制符、同形字符、Unicode Tags、变体选择器和特殊空格。
- 加密文本水印：使用 AES-256-GCM 保护载荷，并通过不可见 Unicode 字符写入普通文本，支持鲁棒冗余。
- 图片盲水印：使用 Python 图片水印引擎，基于 Block-DCT、QIM 风格嵌入、Reed-Solomon 恢复和多尺度提取。
- 学习型鲁棒图片水印：提供实验性的 MLWM v1 alpha 引擎，支持短载荷图片水印、ONNX 推理、攻击模拟、评测 manifest，并可自动回退到 legacy 图片水印引擎。
- 批量处理和报告导出：支持批量扫描，并可导出 JSON、CSV 或 PDF 检测结果。
- 本地桌面流程：使用 Electron、React、TypeScript 构建，图片水印能力由 Python helper 提供。
| 模块 | 状态 |
|---|---|
| Unicode 隐藏字符检测 | 可用 |
| 加密文本水印 | 可用 |
| Legacy 图片盲水印 | 可用 |
| MLWM v1 神经网络图片水印 | Alpha，仅支持短载荷 |
mlwm-v1-alpha1 是第一个已提升的神经网络图片水印候选模型，适合内部 alpha 测试和可控验证；暂不建议直接宣称为无需边界说明的产业级能力。
 |
 |
 |
 |
 |
 |
| 工具 | 版本 | 说明 |
|---|---|---|
| Node.js | 18+ | Electron 和前端构建 |
| npm | 9+ | 包管理 |
| Python | 运行时 3.10+，ML 训练推荐 3.12 | 图片水印后端和 ML 训练工具需要 |
安装 Node 依赖：
npm install安装 Python 图片水印依赖：
pip install -r blind_watermark/requirements.txt启动开发应用：
npm run dev运行 TypeScript 检查：
npm run typecheck运行 Python 图片水印测试：
python -m unittest discover -s blind_watermark/tests只有在训练或导出神经网络候选模型时，才需要安装 ML 训练依赖：
pip install -r blind_watermark/requirements-ml.txt# Windows
npm run build:win
# macOS
npm run build:mac
# Linux
npm run build:linux构建 Python 图片水印 helper：
npm run build:python构建产物会输出到 resources/bin/bwm_helper.exe，随后由 electron-builder 一起打包。
start.bat：交互式启动器，支持开发和预览流程。pack.bat：Windows 一键打包脚本，会检查环境、安装依赖、构建 Python helper 并调用electron-builder。build.bat：兼容性脚本，存在pack.bat时会转交给它执行。
LuminCrypt/
|-- src/
| |-- main/ # Electron 主进程、安全策略、IPC
| |-- preload/ # 上下文隔离 preload 桥接
| `-- renderer/ # React UI 和 TypeScript 逻辑
| |-- core/ # 文本水印和 Unicode 检测
| `-- components/ # React 组件
|-- blind_watermark/
| |-- rwm_engine.py # 图片盲水印引擎
| |-- bwm_helper.py # Electron 调用的 CLI 桥接
| |-- mlwm/ # MLWM 神经网络水印训练、导出和推理模块
| `-- tests/ # Python 单元测试
|-- configs/mlwm/ # MLWM 训练、导出和评测配置
|-- docs/mlwm/ # MLWM 架构、训练和可追溯文档
`-- resources/ # 静态资源、打包二进制和已提升的 ONNX 模型
MLWM v1 是面向短文本或 ID 载荷的学习型鲁棒图片水印链路。它结合了固定 payload 协议、CRC 与 Reed-Solomon 恢复、经典同步思路、轻量 PyTorch 编码器/解码器，以及桌面端 ONNX Runtime 推理。
相关文档：
Unicode 隐写、Unicode 水印、不可见水印、AI 水印检测、零宽字符检测、同形字符检测、BiDi 控制符检测、文本水印、图片盲水印、鲁棒图片水印、数字水印、图片取证、内容溯源、Electron 安全工具。
本项目采用 GPL-3.0 许可证，详见 LICENSE。
图片水印引擎基于开源项目 blind_watermark 定制，相关版权声明见 NOTICE。