From 25b975c3795b0553191eb75d08c0d3f8d2cc3bd4 Mon Sep 17 00:00:00 2001 From: CEQ151 Date: Sun, 26 Apr 2026 16:22:13 +0800 Subject: [PATCH 1/2] docs: internationalize master readme --- README.md | 129 +++++++++++++++++++++++----------------------- README.zh-CN.md | 134 ++++++++++++++++++++++++++++++++++++++++++++++++ package.json | 30 ++++++++++- 3 files changed, 226 insertions(+), 67 deletions(-) create mode 100644 README.zh-CN.md diff --git a/README.md b/README.md index e0c7d97..2096b41 100644 --- a/README.md +++ b/README.md @@ -1,92 +1,89 @@

LuminCrypt

-

桌面级 Unicode 隐写检测与鲁棒水印（文本/图片）工具箱

+

Local-first Unicode steganography detection and robust watermark toolkit for text and images.

- - - - - + 简体中文

- - logo +

+ Electron + React + TypeScript + Python + License +

+ + LuminCrypt logo
--- -LuminCrypt 是一个基于 Electron + React + TypeScript 构建的现代桌面安全工具，致力于解决文本中的可疑 Unicode 字符检测问题，并提供强大的文本与图片隐写水印能力。 +LuminCrypt is a desktop security toolkit for **Unicode hidden-character detection**, **encrypted invisible text watermarking**, and **robust blind image watermarking**. It helps researchers, creators, publishers, and security teams inspect suspicious Unicode content, embed recoverable text fingerprints, and test image watermarks against compression, resizing, cropping, and platform re-encoding. -## 🌟 核心功能 +## Key Features -- **异常字符检测**：精准识别并高亮文本中的零宽字符、BiDi 控制符、同形字、Tags 区块等隐形或易混淆的 Unicode 字符。 -- **文本水印 (隐写)**：基于 AES-256-GCM 加密，利用不可见字符将水印信息隐写至普通文本中，支持高容错的鲁棒冗余模式（即使载体丢失 10~30% 仍可恢复）。 -- **图片盲水印**：内置强大的 Python 盲水印引擎（Block-DCT + QIM + Reed-Solomon），支持多尺度嵌入，强力抵抗缩放、裁剪、平台二次压缩等破坏。 -- **批量处理与导出**：支持批量扫描文件，并将检测报告一键导出为 JSON、CSV 或 PDF 格式。 +- **Unicode hidden character detection**: finds zero-width characters, BiDi controls, homoglyphs, Unicode Tags, variation selectors, and non-standard spaces. +- **Encrypted text watermarking**: embeds AES-256-GCM protected payloads into normal text with invisible Unicode carriers and robust redundancy. +- **Blind image watermarking**: uses a Python image watermark engine based on block-DCT, QIM-style embedding, Reed-Solomon recovery, and multi-scale extraction. +- **Batch processing and reports**: scans files in batches and exports detection results as JSON, CSV, or PDF. +- **Local desktop workflow**: built with Electron, React, TypeScript, and a Python helper for image watermark processing. ---- - -## 📸 截图示例 +## Screenshots - - - + + - - + + - - + +
LuminCrypt screenshot 1LuminCrypt screenshot 2
LuminCrypt screenshot 3LuminCrypt screenshot 4
LuminCrypt screenshot 5LuminCrypt screenshot 6
---- - -## 🛠️ 环境要求 +## Requirements -| 工具 | 最低版本 | 说明 | -|------|----------|------| -| **Node.js** | 18+ | 运行 Electron 和前端构建 | -| **npm** | 9+ | 包管理工具 | -| **Python** | 3.8+ | 仅图片盲水印引擎需要 | +| Tool | Version | Notes | +|---|---:|---| +| Node.js | 18+ | Electron and frontend build | +| npm | 9+ | Package manager | +| Python | 3.10+ recommended | Required for the image watermark backend | -## 🚀 本地开发 +## Quick Start -### 1. 安装 Node 依赖 +Install Node dependencies: ```bash npm install ``` -### 2. 安装 Python 依赖（仅图片水印功能需要） +Install Python image-watermark dependencies: ```bash -pip install numpy opencv-python scipy reedsolo +pip install -r blind_watermark/requirements.txt ``` -### 3. 启动开发模式 +Start the development app: ```bash npm run dev ``` -### 4. 类型检查 +Run TypeScript checks: ```bash npm run typecheck ``` -## 📦 打包构建 - -### 构建 Electron 应用 +## Build ```bash -# Windows（输出安装包 + 便携版） +# Windows npm run build:win # macOS @@ -96,40 +93,42 @@ npm run build:mac npm run build:linux ``` -### 可选：将 Python 引擎打包为独立 exe（无需用户安装 Python） +Build the Python image-watermark helper: ```bash npm run build:python ``` -> 提示：需要先安装 PyInstaller (`pip install pyinstaller`)。 -> 产物将输出至 `resources/bin/bwm_helper.exe`，后续执行 `electron-builder` 打包时会自动将其包含在内。 - -## 🪟 Windows 一键脚本 +The packaged helper is written to `resources/bin/bwm_helper.exe` and included by `electron-builder`. -项目根目录提供了几个方便 Windows 开发者使用的批处理脚本： +## Windows Helper Scripts -- `start.bat`: 一键启动器，提供交互式菜单，可选择启动开发模式（热重载）或预览已构建的版本。 -- `pack.bat`: 一键打包脚本，自动检查环境、安装依赖、构建 Python 引擎，并最终调用 electron-builder 生成 Windows 安装包和便携版。 -- `build.bat`: 兼容性构建脚本，若存在 `pack.bat` 则会直接转调 `pack.bat`。 +- `start.bat`: interactive launcher for development and preview workflows. +- `pack.bat`: one-click Windows packaging script that checks the environment, installs dependencies, builds the Python helper, and runs `electron-builder`. +- `build.bat`: compatibility wrapper that delegates to `pack.bat` when available. -## 📂 项目结构 +## Repository Layout ```text LuminCrypt/ -├── src/ -│ ├── main/ # Electron 主进程 (安全策略、IPC 通信) -│ ├── preload/ # 预加载脚本 (上下文隔离) -│ └── renderer/ # React 前端 UI -│ ├── core/ # 文本水印引擎与字符检测逻辑 (TypeScript) -│ └── components/ # React 组件 -├── blind_watermark/ -│ ├── rwm_engine.py # 图片盲水印核心算法 (Python) -│ └── bwm_helper.py # 与 Electron 通信的 CLI 桥接脚本 -└── resources/ # 打包所需的静态资源与预编译二进制文件 +|-- src/ +| |-- main/ # Electron main process, security policy, IPC +| |-- preload/ # Context-isolated preload bridge +| `-- renderer/ # React UI and TypeScript logic +| |-- core/ # Text watermarking and Unicode detection +| `-- components/ # React components +|-- blind_watermark/ +| |-- rwm_engine.py # Image blind watermark engine +| `-- bwm_helper.py # CLI bridge used by Electron +`-- resources/ # Static assets and packaged binaries ``` -## 📄 许可证 +## Search Keywords + +Unicode steganography, Unicode watermark, invisible watermark, AI watermark detection, zero-width character detector, homoglyph detection, BiDi control detector, text watermarking, blind image watermark, robust image watermarking, digital watermarking, image forensics, content provenance, Electron security tool. + +## License + +LuminCrypt is released under the **GPL-3.0** license. See [LICENSE](LICENSE). -本项目采用 **GPL-3.0** 许可证，详见 [LICENSE](LICENSE) 文件。 -图片水印引擎基于开源项目 [blind_watermark](https://github.com/guofei9987/blind_watermark) 深度定制，相关版权声明详见 [NOTICE](NOTICE) 文件。 +The image watermark engine includes customization based on the open-source [blind_watermark](https://github.com/guofei9987/blind_watermark) project. See [NOTICE](NOTICE) for attribution. diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000..86ecbba --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,134 @@ +
+

LuminCrypt

+

本地优先的 Unicode 隐写检测与鲁棒水印工具箱，支持文本和图片。

+ +

+ English +

+ +

+ Electron + React + TypeScript + Python + License +

+ + LuminCrypt logo +
+ +--- + +LuminCrypt 是一款桌面安全工具箱，面向 **Unicode 隐藏字符检测**、**加密不可见文本水印** 与 **鲁棒图片盲水印** 场景。它可以帮助研究者、内容创作者、出版和安全团队检查可疑 Unicode 内容、嵌入可恢复的文本指纹，并测试图片水印在压缩、缩放、裁剪和平台二次编码后的可恢复能力。 + +## 核心功能 + +- **Unicode 隐藏字符检测**：识别零宽字符、BiDi 控制符、同形字符、Unicode Tags、变体选择器和特殊空格。 +- **加密文本水印**：使用 AES-256-GCM 保护载荷，并通过不可见 Unicode 字符写入普通文本，支持鲁棒冗余。 +- **图片盲水印**：使用 Python 图片水印引擎，基于 Block-DCT、QIM 风格嵌入、Reed-Solomon 恢复和多尺度提取。 +- **批量处理和报告导出**：支持批量扫描，并可导出 JSON、CSV 或 PDF 检测结果。 +- **本地桌面流程**：使用 Electron、React、TypeScript 构建，图片水印能力由 Python helper 提供。 + +## 截图 + + + + + + + + + + + + + + +
LuminCrypt screenshot 1LuminCrypt screenshot 2
LuminCrypt screenshot 3LuminCrypt screenshot 4
LuminCrypt screenshot 5LuminCrypt screenshot 6
+ +## 环境要求 + +| 工具 | 版本 | 说明 | +|---|---:|---| +| Node.js | 18+ | Electron 和前端构建 | +| npm | 9+ | 包管理 | +| Python | 推荐 3.10+ | 图片水印后端需要 | + +## 快速开始 + +安装 Node 依赖： + +```bash +npm install +``` + +安装 Python 图片水印依赖： + +```bash +pip install -r blind_watermark/requirements.txt +``` + +启动开发应用： + +```bash +npm run dev +``` + +运行 TypeScript 检查： + +```bash +npm run typecheck +``` + +## 构建打包 + +```bash +# Windows +npm run build:win + +# macOS +npm run build:mac + +# Linux +npm run build:linux +``` + +构建 Python 图片水印 helper： + +```bash +npm run build:python +``` + +构建产物会输出到 `resources/bin/bwm_helper.exe`，随后由 `electron-builder` 一起打包。 + +## Windows 一键脚本 + +- `start.bat`：交互式启动器，支持开发和预览流程。 +- `pack.bat`：Windows 一键打包脚本，会检查环境、安装依赖、构建 Python helper 并调用 `electron-builder`。 +- `build.bat`：兼容性脚本，存在 `pack.bat` 时会转交给它执行。 + +## 项目结构 + +```text +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 桥接 +`-- resources/ # 静态资源和打包二进制 +``` + +## 关键词 + +Unicode 隐写、Unicode 水印、不可见水印、AI 水印检测、零宽字符检测、同形字符检测、BiDi 控制符检测、文本水印、图片盲水印、鲁棒图片水印、数字水印、图片取证、内容溯源、Electron 安全工具。 + +## 许可证 + +本项目采用 **GPL-3.0** 许可证，详见 [LICENSE](LICENSE)。 + +图片水印引擎基于开源项目 [blind_watermark](https://github.com/guofei9987/blind_watermark) 定制，相关版权声明见 [NOTICE](NOTICE)。 diff --git a/package.json b/package.json index b853ac4..faa0a95 100644 --- a/package.json +++ b/package.json @@ -1,10 +1,36 @@ { "name": "lumincrypt", "version": "1.0.0", - "description": "LuminCrypt - Unicode steganography and watermark studio", + "description": "Local-first Unicode steganography detector, encrypted text watermark studio, and robust blind image watermark toolkit.", "main": "./out/main/index.js", "author": "LuminCrypt", - "homepage": "https://github.com/lumincrypt", + "homepage": "https://github.com/CEQ151/LuminCrypt", + "repository": { + "type": "git", + "url": "git+https://github.com/CEQ151/LuminCrypt.git" + }, + "bugs": { + "url": "https://github.com/CEQ151/LuminCrypt/issues" + }, + "keywords": [ + "unicode", + "steganography", + "watermark", + "unicode-watermark", + "text-watermark", + "blind-watermark", + "image-watermark", + "robust-watermarking", + "ai-watermark-detection", + "zero-width-characters", + "homoglyph", + "bidi-control", + "content-provenance", + "image-forensics", + "electron", + "react", + "typescript" + ], "scripts": { "format": "prettier --write .", "lint": "eslint --cache .", From be43f7bb111276fc290398d65998c3fa9f75859c Mon Sep 17 00:00:00 2001 From: CEQ151 Date: Sun, 26 Apr 2026 16:30:11 +0800 Subject: [PATCH 2/2] ci: report required master checks --- .github/workflows/python-engine.yml | 34 ++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/.github/workflows/python-engine.yml b/.github/workflows/python-engine.yml index 92493c0..900b090 100644 --- a/.github/workflows/python-engine.yml +++ b/.github/workflows/python-engine.yml @@ -33,4 +33,36 @@ jobs: wm = embed_watermark(img, 'hello world', password=42, quality='balanced') extracted = extract_watermark(wm, password=42, quality='balanced') assert extracted == 'hello world', f'Roundtrip failed: {extracted}' - print('All tests passed.') \ No newline at end of file + print('All tests passed.') + + mlwm-unit-tests: + runs-on: ubuntu-latest + name: MLWM unit tests + steps: + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 + with: + python-version: '3.10' + - name: Run MLWM unit tests when present + shell: bash + run: | + if [ -d blind_watermark/tests ]; then + pip install -r blind_watermark/requirements.txt + python -m unittest discover -s blind_watermark/tests + else + echo "No blind_watermark/tests directory exists on this branch yet." + fi + + typecheck: + runs-on: ubuntu-latest + name: Typecheck + steps: + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 + - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 + with: + node-version: '20' + cache: npm + - name: Install dependencies + run: npm ci + - name: Run TypeScript checks + run: npm run typecheck