简体中文 · English
本地离线 · 日用百宝箱
智能脱敏为核心 · PDF / PPT / 图像 / 音视频 / 文本 / 计算 / 系统 8 大中心 70+ 工具 · by zonlic
读入客户 PDF 工程图纸与办公文档，在框线约束内精准抹除敏感词、Logo 与保密标记。
同一工作台还集成了 PDF、PPT、图像、音视频、文本、计算与系统硬件工具——70+ 项全部本地离线运行。
文件不出本机，不修改原始文件，脱敏输出 原名_desensitized 后缀副本。
ZonKey 桌面版首页 —— 8 大中心宫格，全部工具本机离线运行
- 手机「打开」弹窗内直接预览：PDF 转 Word/Excel 的成果点「打开」在任务弹窗内直接渲染（docx/xlsx），本机处理、文件零上传，不跳转、不白屏
- 转换交付收口：转换完成不再自动下载——打开 = 预览 / 下载 = 按需存档
- 二维码 / 证件照手机网页版：浏览器引擎兜底（qrcode MIT / jsQR Apache-2.0），离线也能用；证件照支持手机竖拍 EXIF 自动转正与「仅裁剪尺寸」模式
- PPT 转 PDF / 长图：纯浏览器环境明确引导使用桌面版，不再报 405
历史版本：v2.1.0（PPT 工坊首页 · 手机顶栏修复 · 下载/访问统计）· v2.0.1（壳内导出根治 · IME 打字修复 · 图标真透明 · 窗口自愈 · macOS 自动构建）
Windows 桌面版实拍界面。手机网页版（zonkey.pages.dev）为同源响应式界面，文件只在浏览器内处理。
ZonKey 是一个三端一体的离线应用：桌面壳（pywebview）、Web 前端（React）、Python 后端引擎（FastAPI），三者在同一本机进程内协同工作。
flowchart TB
subgraph Desktop["🖥️ 桌面壳（Windows EXE）"]
Shell["PyWebView 无边框窗口<br/>app-region 拖拽 · 注册表隔离 · 本地存储"]
WebView["Edge WebView2 渲染引擎<br/>离线字体 · 主题持久化 · 窗口控制"]
end
subgraph Frontend["🎨 React 前端（TypeScript · Tailwind · Vite）"]
direction LR
UI["8 大中心路由"]
BrowserEngine["浏览器引擎降级<br/>pdf-lib · PDF.js · SheetJS · pptxgenjs<br/>〈后端离线时纯前端兜底〉"]
end
subgraph Bridge["🔗 FastAPI 桥接（Uvicorn · 127.0.0.1:8765）"]
API["REST API 网关<br/>文件上传 · Job 轮询 · 导出交付"]
BridgeLog["引擎日志 · 错误留痕 · 写探针"]
end
subgraph Backend["⚙️ Python 后端引擎"]
direction LR
Redact["智能脱敏引擎<br/>三通道检测 · 框线归位 · 字形级抹除"]
Tools["工坊工具集<br/>PDF 28项 · PPT 8项 · 图像 11项<br/>音视频 · 文本 · 计算 · 系统"]
Office["Office COM 桥<br/>Word · Excel · PowerPoint<br/>〈Windows 原生 COM 互操作〉"]
end
subgraph Core["🧠 Core 引擎层"]
direction LR
PdfIO["pdfio.py<br/>pypdfium2 渲染 · pdfplumber 抽取<br/>pikepdf 读写 · 坐标合同"]
Detector["detector/<br/>vector_channel · ocr_channel<br/>image_verify · seal_detector<br/>logo_matcher · box_finder"]
RedactEngine["redact/<br/>pikepdf_engine.py<br/>字形级删除 · 图像像素化<br/>线画三模式 · 内容流走查"]
end
Shell --> WebView
WebView --> Frontend
Frontend <--> Bridge
Bridge <--> Backend
Backend --> Core
BrowserEngine -.->|"后端离线时"| UI
| 层级 | 运行位置 | 核心职责 |
|---|---|---|
| 桌面壳 | 本机 EXE 进程 | 窗口管理、WebView2 宿主、注册表隔离、闪屏联动 |
| Web 前端 | 壳内 WebView2 / 手机浏览器 | 8 中心 UI、浏览器引擎降级、主题/字号/收藏持久化 |
| Python 后端 | 本机 FastAPI 进程 | 脱敏引擎、PDF 工坊、Office 转换、系统硬件探针 |
手机网页版（zonkey.pages.dev）剥离了 Python 后端，所有工具走浏览器引擎降级——文件仅在浏览器内处理，不上传任何服务器。需要本机引擎的功能（脱敏、OCR、Office 转换）会提示改用桌面版。
| 中心 | 能力 |
|---|---|
| 🛡️ 智能脱敏 | 工程图纸 / 行政 PDF / Word 三入口，三通道检测 + 框线归位 + 内容验证，规则中心 + 审计日志 |
| 📄 PDF 工坊（28 项） | 整理 8：批量 / 页面整理 / 合并 / 拆分 / 提取 / 旋转 / 裁剪 / 页码；编辑 5：书签 / 编辑器 / 水印 / 增强 / 填表；转换 12：转 Word/Excel/PPT/HTML/图片、OCR 导出、修复、压缩 / 深压缩；安全 3：加密 / 解密 / 证书签名 |
| 📊 PPT 工坊（8 项） | 批量图片导入建 PPT、转 PDF / 图片、图片 / 文字提取、压缩、大纲生成、AI 底稿 |
| 🖼️ 图像工坊（11 项） | 批量处理、格式转换、压缩、裁剪、图片打码、证件照换底 / 裁剪、颜色替换、拼接、图标生成、取色、色彩空间对比 |
| 🎵 音视频中心（7 项） | BPM 检测、音频剪辑 / 转码 / 提取、视频转码 / 抽帧 / 转 GIF |
| ✍️ 文本工坊（9 项） | Markdown 编辑器、字数统计、文本格式化、文本 diff、正则测试、批量重命名、文字朗读（TTS）、语音转写、打字测速 |
| 🧮 计算开发（15 项） | BMI、时间戳、房贷、复利、密码生成、JSON、Base64、URL 编解码、UUID、JWT、哈希加密、单位换算、进制换算、二维码生成 / 识别 |
| 💻 系统硬件（9 项） | 硬件总览、CPU / 内存、GPU / 显示器、主板、存储、功耗传感器、大文件清理、重复文件查找、C 盘清理 |
括号内为当前版本的工具有效数，与软件内「8 大中心」导航一一对应（首页 / 规则 / 审计等管理页不计入），随版本持续增长。
| 维度 | ZonKey |
|---|---|
| 数据安全 | 零云端、零外网请求，图纸与文档不出本机 |
| 工程图纸 | 矢量 + OCR + 视觉三通道融合，框线归位 + 内容验证后抹除，不污染尺寸与公差 |
| 办公文档 | 通用行政 PDF、Word 文档同一工作台处理 |
| 规则治理 | 规则中心 + 外部词表 / Logo 模板，按需自选公司名等脱敏规则，支持 GUI 热重载 |
| 交付形态 | Windows EXE 一键启动 · macOS DMG（GitHub Actions 自动构建）· 手机网页版（浏览器内处理，无需安装） |
| 桌面版 EXE | 手机网页版 | |
|---|---|---|
| 形态 | Windows / macOS 一键启动 | 手机浏览器直接打开，无需安装 |
| 引擎 | 本机完整引擎（FastAPI + PyMuPDF + RapidOCR + Office COM） | 浏览器内引擎（pdf-lib / PDF.js / Web Crypto 等纯前端实现） |
| 能力 | 全部功能 | 全部「纯前端可实现」的工具；需本机引擎的（脱敏、Office 转换、OCR 等）会提示改用桌面版 |
| 文件流 | 全程本机 | 文件只在浏览器内处理，不上传任何服务器 |
手机端只对「确实无法在浏览器实现」的工具提示下载桌面版，其余工具照常使用。
| 下载源 | 说明 |
|---|---|
| GitHub Release（主） | 仓库已公开，无需登录；含 Setup 安装包（推荐）、便携压缩包与 macOS DMG |
| Gitee Release（国内镜像） | 国内下载更快；大文件分卷时合并命令见 Release 说明 |
- Setup 安装包（
ZonKey_Setup_x64_*.exe）：双击一路下一步，自动创建桌面/开始菜单快捷方式，卸载干净。 - 便携版（
ZonKey_Windows_x64_*.zip/.7z）：解压即用，免安装，双击ZonKey.exe。
下载的文件均附 SHA256 校验值，可在 Release 页面核对完整性。软件内「帮助」按钮有完整使用说明。
自动构建（零本机环境）：仓库配置了 GitHub Actions（.github/workflows/macos-dmg.yml），每次推送 master 或打 v* tag 都会在 macOS runner 上自动构建 Apple Silicon + Intel 两个 DMG——在仓库 Actions 页或 Release 附件直接下载。
在 Mac 上手动执行以下任意一条：
# A. 源码构建（已装 Python 3.11 + Node 18+）
git clone https://github.com/zonlic0925-boop/ZonKey.git
cd ZonKey && pip install -r requirements.txt && cd frontend && npm install && npm run build && cd ..
./build_zonkey_mac.sh # 产物：dist/ZonKey.app
# B. 构建包（Mac 上无需 Node）
# 从 Release 下载 ZonKey_mac_build_kit_*.zip，解压后：
python3.11 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
./build_zonkey_mac.sh # 产物：dist/ZonKey.app + dist_release/ZonKey_macOS_*.zip完整步骤与故障排查见
packaging/macos/MAC_BUILD_ON_MAC.md（构建包内含副本）。 首次打开：右键 ZonKey.app → 打开（未公证应用需此步）；数据目录~/Library/Application Support/ZonKey/。
- 局域网：电脑运行「启动局域网手机访问.bat」，手机同 WiFi 打开提示地址
- 或直接访问 zonkey.pages.dev
# 克隆（GitHub 主仓库）
git clone https://github.com/zonlic0925-boop/ZonKey.git
# 或 Gitee 国内镜像
git clone https://gitee.com/zonlic/ZonKey.git
cd ZonKey
# Python 依赖
pip install -r requirements.txt
# 前端构建
cd frontend
npm install
npm run build
cd ..
# 启动现代化工作台
python run_modern_app.py
# 或
.\启动现代化脱敏工作台.bat| 层级 | 选型 |
|---|---|
| 前端 | React · TypeScript · Tailwind CSS · Vite |
| 前端离线引擎 | pdf-lib · PDF.js · Web Crypto · SheetJS · pptxgenjs · mammoth · html2canvas（浏览器内处理，零上传） |
| 桥接 | FastAPI · Uvicorn |
| 桌面 | PyWebView · PyInstaller |
| pypdfium2 · pikepdf · pdfplumber · reportlab | |
| OCR | RapidOCR ONNX Runtime |
| 文档 | python-docx · python-pptx · openpyxl |
| 测试 | pytest · Playwright |
ZonKey/
├── core/ # 脱敏引擎核心
│ ├── pdfio.py # 统一 PDF 读写层（pypdfium2/pikepdf/pdfplumber）
│ ├── detector/ # 检测通道（矢量/OCR/视觉/印章/Logo）
│ ├── redact/ # 抹除执行（pikepdf 字形级删除 + 图像像素化）
│ └── pipeline.py # 脱敏流水线编排
├── frontend/ # React 现代化 UI
│ ├── src/
│ │ ├── components/ # 视图组件（8 大中心 + 通用组件）
│ │ ├── lib/zonkey/ # 纯前端工具引擎（20+ 模块）
│ │ └── i18n/ # 三语国际化（zh-CN / zh-TW / en）
│ └── public/ # 静态资产（图标 · 字体 · PWA manifest）
├── server_bridge.py # FastAPI 本地桥接（REST API + Job 轮询）
├── desktop_app.py # PyWebView 桌面壳入口（无边框窗口 + WebView2）
├── backend_*.py # 后端工具集（convert / media / ppt / system / p3）
├── rules/ # 敏感词表与 Logo 模板（用户可配置）
├── packaging/ # Windows / macOS 打包脚本与配置
├── scripts/ # 发布验收 · 图标生成 · 公网隧道 · 干净导出
├── tests/ # 单元测试与发布契约
└── run_modern_app.py # 开发模式启动器
- 不联网：运行时无外部 API、无云 OCR、无模型上传
- 不改原文件：只在用户指定目录写入
_desensitized副本 - 样本隔离：客户图纸目录
Testing Drawings/已加入.gitignore，不会进入版本库 - 开源公开：MIT 许可，本仓库已公开，面向公开发布与通用客户场景
- 文本层零命中：输出 PDF 全文检索敏感词 → 0 命中
- 渲染目检：抹除块不越框线、不污染框外标注
- 样本回归：
Testing Drawings/全量三通道跑通并归档审计
| 版本 | 日期 | 亮点 |
|---|---|---|
| v2.2.0（Latest） | 2026-09-07 | 手机「打开」弹窗内直接预览 · 转换交付收口 · 二维码 / 证件照浏览器引擎 · What's New 补课 |
| v2.1.0 | 2026-09-03 | PPT 工坊首页 · 手机顶栏修复 · 下载 / 访问统计（本地隐私口径） |
| v2.0.1 | 2026-09-02 | 壳内导出根治 · IME 打字修复 · 图标真透明（小尺寸）· 窗口自愈 · macOS 自动构建 |
完整变更说明见 GitHub Releases 与 Gitee Releases。
zonlic — 一個在香港生存的普通人
Public repository · ZonKey © zonlic · 手机网页版 zonkey.pages.dev