yyzTools 开发者实战指南：一个集成了 40+ 工具的 Windows 桌面效率方案

摘要本文从开发者视角拆解 yyzTools 的核心功能与架构设计涵盖命令面板、本地 OCR、编码解码、批量处理、自定义扩展模块开发以及 C WebView2 混合架构的技术分析。适合 Windows 效率工具开发者、运维工程师、技术爱好者阅读。标签Windows效率工具本地OCRWebView2C桌面开发开源替代方案一、为什么开发者需要关注 yyzTools作为开发者我们日常会用到大量工具Everything 搜文件、Ditto 管剪贴板、Snipaste 截图、Postman 测接口、在线 JSON 格式化、在线正则测试、Base64 编解码、哈希校验……这些工具散落在桌面、任务栏和浏览器标签里各自为战。yyzTools 的思路是把这些工具原生融合进一个安装包——C 负责系统级操作WebView2 前端负责界面渲染两者通过桥接层通信。当前版本 v1.0.3.1300永久免费本地优先支持 12 种语言。本文不重复官网的功能列表而是从开发者实际使用场景出发拆解各个工具模块的技术细节和实战用法。二、架构设计C WebView2 混合方案先聊架构这决定了 yyzTools 的能力边界和性能特征。┌─────────────────────────────────────────┐ │ 前端页面 (Alpine.js JS) │ │ cmdplate / ocr / translate / ... │ ├─────────────────────────────────────────┤ │ WebView2 桥接层 (BindSync/Async) │ │ window.Zen.xxx() │ ├─────────────────────────────────────────┤ │ C NativeApi 层 │ │ FileManager / ProcessManager / │ │ ClipboardManager / OcrManager / │ │ DownloadManager / CmdManager ... │ ├─────────────────────────────────────────┤ │ Win32 系统 API │ │ 文件 / 进程 / 窗口 / 剪贴板 / 屏幕录制 │ └─────────────────────────────────────────┘设计要点C 层处理所有系统级操作文件管理、进程控制、窗口管理、剪贴板、OCR 引擎调用、屏幕录制、加密解密等。这些操作如果用 JS 实现要么做不到要么性能不够。前端层用 Alpine.js 原生 JS Vite 构建每个功能页面独立一个目录web/cmdplate、web/ocr、web/translate等互不耦合。界面迭代不需要重新编译 C。桥接层通过 WebView2 的BindSync同步返回和BindAsync异步回调把 C 能力暴露给前端。前端统一通过web/lib/zen_api.js的ZenAPI封装类调用不直接碰window.Zen。接口契约输入用位置参数输出恒为 JSON 对象{ error, errorMsg, ... }。error为 0 表成功非 0 表失败。前端统一用ZenAPI.isOk(res)判断不直接比较error字段因为 C 有两条 JSON 生成路径error类型可能是数字0也可能是字符串0。这种架构的实际意义文件搜索走 C 直接调 Everything SDK毫秒级响应OCR 走本地 RapidOCR 引擎离线运行界面改一行 CSS 不用重新编译 .exe只需更新前端 dist三、命令面板多域搜索引擎命令面板是 yyzTools 的统一入口Alt 空格唤起。它不是简单的应用启动器而是一个多域搜索系统用前缀切换搜索域前缀搜索域底层实现无应用 系统命令 系统设置 命令模块C 遍历注册表 Shell APIf全盘文件C 调用 Everything SDKp运行中进程C 遍历系统进程快照w窗口C EnumWindowsb浏览器书签C 解析浏览器书签数据库c剪贴板历史C 剪贴板监听 本地存储命令行C CreateProcess拼音搜索实现命令面板支持中文拼音搜索输入weixin或wx能命中微信。底层实现上yyzTools 对中文应用名生成拼音索引搜索时同时匹配原名和拼音。别名索引只取enzh_cn两种语言而非全部 12 种避免别名膨胀导致跨语误命中。即时计算搜索框输入数学表达式实时计算结果128*0.85 → 108.8 sqrt(144)3^2 → 15 0x1F 0b1010 → 47回车复制结果。算折扣、算进制转换、算公式不用单独开计算器。四、开发者工具集实战这一节重点讲 yyzTools 内置的开发者工具这是 CSDN 读者最关心的部分。4.1 正则表达式测试器实时匹配高亮、分组查看、常用表达式速查。实战场景验证手机号正则输入文本13800138000, 15812345678, 12345678901 正则^1[3-9]\d{9}$ → 逐行匹配高亮命中行分组1 区号分组2 号码4.2 编码解码工具支持 Base64 / URL / HTML / Unicode / 进制 / 摩尔斯电码等常见编码互转。实战场景JWT Token 解码输入Base64 编码的 JWT payload eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIn0 → Base64 解码 {sub:1234567890,name:John Doe}实战场景URL 参数解码输入 https%3A%2F%2Fexample.com%2Fapi%3Fq%3D%E4%BD%A0%E5%A5%BD → URL 解码 https://example.com/api?q你好4.3 哈希计算支持 MD5 / SHA-1 / SHA-256 / SHA-512 等摘要算法支持文本和文件校验。实战场景校验下载文件的完整性选择文件 → 选择算法 SHA-256 → 生成摘要 → 与官方公布的校验值比对4.4 加密解密基于 OpenSSL 实现支持对称加密AES 等和非对称加密RSA 等以及密钥生成。实战场景生成 RSA 密钥对选择算法RSA 密钥长度2048 → 生成公钥 私钥 → 导出 PEM 格式文件4.5 数据转换支持 JSON / YAML / XML / TOML / CSV 互转以及进制、大小写、全角半角转换。实战场景JSON 转 YAML// 输入 JSON { server: { host: localhost, port: 8080, timeout: 30 }, logging: { level: info, file: /var/log/app.log } }# 输出 YAML server: host: localhost port: 8080 timeout: 30 logging: level: info file: /var/log/app.log实战场景进制转换输入255 → 十进制255 → 二进制11111111 → 十六进制FF → 八进制3774.6 数据生成支持 UUID / GUID、ULID、随机字符串、测试数据批量生成。实战场景批量生成测试 UUID类型UUID v4 数量100 → 批量生成 100 个 UUID v4 → 一键复制4.7 命令行执行命令面板输入前缀直接执行系统命令 ipconfig → 查看网络配置 ping baidu.com → 测试连通性 netstat -ano → 查看端口占用支持管理员身份运行。五、本地 OCR 实战yyzTools 内置 RapidOCR 引擎完全离线运行不调云端 API。技术细节引擎RapidOCR基于 PaddleOCR 的 C 推理引擎模型本地模型文件随安装包一起分发调用方式C 层通过BindAsync异步调用OCR 是耗时操作不能阻塞 UI 线程识别能力中英文混排识别支持截图区域选择实战场景截图识别代码从视频教程或文档截图中提取代码文本截图识别表格从截图中的表格提取数据联动翻译OCR 识别结果 → 一键送翻译 → 一键回填剪贴板操作流程 1. Ctrl Shift 截图框选区域 → OCR 识别 2. 识别结果面板出现 → 点击「翻译」 3. 翻译结果出现 → 点击「复制」整个过程不联网翻译除外不上传任何数据。六、批量处理引擎yyzTools 内置了三个重量级命令行工具并封装成图形界面。6.1 图片批量处理ImageMagick操作参数示例场景批量缩放宽度 800px等比缩放电商商品图统一尺寸批量裁剪中心裁剪 300x300头像批量处理格式转换PNG → WebP压缩图片体积加水印右下角 20% 透明度版权保护压缩质量 80%减少文件体积6.2 视频批量处理FFmpeg操作参数示例场景批量转码H.264 → H.265节省存储空间截取片段00:00:10 - 00:00:30提取视频精华抽帧每秒 1 帧制作 GIF 素材压缩CRF 28减小视频体积提取音频MP4 → MP3提取背景音乐6.3 PDF 批量处理pdfcpu Ghostscript操作场景合并多份合同合并成一个文件拆分按页码范围拆分加水印添加机密水印压缩减小 PDF 体积加密/解密设置打开密码6.4 批量重命名支持多种规则组合改之前先预览规则示例场景序号file_001, file_002, ...批量排序替换把 副本 替换为空清理文件名正则匹配日期模式重新排列按日期归档EXIF 时间按拍摄时间命名照片照片管理大小写全部小写统一命名规范七、自定义扩展开发你自己的命令模块这是 yyzTools 最开发者友好的特性往 Modules 目录放一个 JSON 文件就能新增命令无需编译、无需重启。7.1 .zenmod 文件格式{ id: mydeploy, type: app, name: { zh_cn: 部署工具, en: Deploy Tool }, desc: { zh_cn: 快速打开内网部署平台, en: Quick open internal deploy platform }, icon: iVBORw0KGgo..., cmdPath: yyzBrowser.exe, cmdArgs: --urlhttps://deploy.internal.com --size1200x800 }字段说明字段类型说明idstring全局唯一标识语言无关typestringapp类型通过cmdPath调起外部程序nameobject多语言文案key 为语言码zh_cn/en/ja...descobject描述同样支持多语言iconstringBase64 编码的图标cmdPathstring可执行程序路径cmdArgsstring命令行参数7.2 实战新增一个 AI 工具入口假设你想在命令面板里快速打开自己的 AI 对话页面在src/Modules/AI/目录下创建myai.zenmod{ id: myai-chat, type: app, name: { zh_cn: 我的AI对话, en: My AI Chat }, desc: { zh_cn: 快速打开自定义AI对话窗口, en: Quick open custom AI chat window }, cmdPath: yyzBrowser.exe, cmdArgs: --urlhttps://chat.example.com --size900x700 }type: app会调用 yyzTools 内置的yyzBrowser.exe无边框轻量浏览器通过--url指定网址--size指定窗口尺寸。打开命令面板输入「我的AI」或拼音wodaiai直接命中。7.3 多语言文案规则语言码使用下划线小写风格zh_cn、zh_tw、en、ja、ko、fr、de、es、ru、ar、pt、it支持三级回落当前语言 →en→ 纯字符串写法纯字符串写法name: 部署工具仍然有效向后兼容一个.zenmod文件覆盖所有语言不做每语言一个文件7.4 添加系统命令如果想新增一个系统命令如打开设备管理器{ id: devmgmt, type: app, name: { zh_cn: 设备管理器, en: Device Manager }, desc: { zh_cn: 查看和管理硬件设备, en: View and manage hardware devices }, cmdPath: mmc.exe, cmdArgs: devmgmt.msc }放在src/Modules/Sys/目录下即可。7.5 使用 yyzCmd 执行系统操作yyzTools 还有一个独立的命令行执行器yyzCmd.exe支持关机、重启、音量控制、显示器管理、回收站操作、打开目录等。可以在.zenmod中通过cmdPath指向它{ id: monitor-off, type: app, name: { zh_cn: 关闭显示器, en: Turn Off Monitor }, desc: { zh_cn: 立即关闭显示器省电, en: Turn off monitor immediately }, cmdPath: yyzCmd.exe, cmdArgs: --monitoroff }八、其他实用功能速览功能说明文件预览空格键预览 Word/Excel/PPT/PDF/图片/视频/代码/压缩包/DXF免装 Office剪贴板历史后台记录文本与图片支持搜索、钉图到桌面、联动翻译/OCR超级翻译多引擎划词翻译可自选服务和目标语言屏幕截图区域截图 滚动长截图 贴图钉屏屏幕录制录制屏幕与音频鼠标跟随缩放按键提示一键导出文件下载基于 Aria2 多线程下载断点续传队列管理动态壁纸网页/视频贴到桌面图标层下方不遮挡操作应用统计记录各应用使用时长与激活次数提醒助手单次/每日/每周/每月提醒二维码生成与识别二维码计算稿纸多行连续计算支持变量与单位换算九、性能与隐私性能特征文件搜索C 直接调 Everything SDK全盘文件毫秒级响应OCR本地 RapidOCR 引擎无网络延迟内存占用所有功能共享一个进程比十几个独立工具各自驻留后台更省内存分包更新主程序、前端页面、命令模块、FFmpeg、OCR 模型各自独立打包更新只下载变化的子包隐私保障数据类型处理方式剪贴板历史本机存储不上传OCR 内容本地模型处理不联网文件索引本地 Everything 索引应用统计本机记录文件预览本地解析翻译内容需联网调翻译服务 API唯一需要联网的数据功能不要求注册账号不收集身份信息不做用户画像或行为埋点。十、与主流工具的技术对比维度yyzToolsPowerToysuToolsFlow Launcher架构C WebView2 前端C# WPFElectron 插件C# WPF功能集成40 全内置~20 模块松散共存插件市场拼装插件市场拼装本地 OCRRapidOCR 离线无插件可能联网插件批量处理ImageMagick/FFmpeg/pdfcpu无插件无文件预览Office/PDF/代码/压缩包SVG/PDF/MD插件无截图录屏截图/长截图/钉屏/录屏截图插件无扩展方式JSON 文件零编译C# 插件插件市场C# 插件数据联动剪贴板→OCR→翻译→回填无无统一数据层无内存模型单进程共享多模块各自进程Electron内存偏高多插件各自进程核心差异yyzTools 的JSON 文件即插件扩展模式扩展成本远低于 C# 插件方案代价是扩展能力受限于预定义的type类型当前主要是app类型。