Add plugin ZTools 提供商 v1.0.0

plugins/f-provider/.github/workflows/release.yml

@@ -0,0 +1,69 @@
+# Build the native OCR runtime (wechat_ocr.node + wco_data) on Windows, bundle
+# it into native.zip, and publish native.zip as a GitHub Release asset.
+#
+# Scope: this workflow ONLY builds & ships the native bits. The frontend plugin
+# is released independently (npm run build) — its plugin.json carries the
+# native.downloadUrl / sha256 / version, maintained by hand there.
+#
+# Triggered by pushing a `v*` tag (e.g. v1.0.1). The tag becomes the Release
+# name; the Release carries a single asset: dist/native.zip.
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write   # required to create the Release and upload the asset
+
+jobs:
+  release:
+    # Pin to windows-2022 (VS 2022). windows-latest now ships VS 2026, which
+    # node-gyp 10.x (bundled in Node 20) cannot detect — see node-gyp #3282.
+    runs-on: windows-2022
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Setup Python (for node-gyp)
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install frontend dependencies
+        run: npm install
+
+      # copy:native writes into dist/, so produce it first (vite empties dist
+      # on build — run frontend BEFORE the native copy step, never after).
+      - name: Build frontend (produces dist/)
+        run: npm run build
+
+      - name: Build native (fetch wco_data + compile wechat_ocr.node)
+        run: npm run build:native
+        shell: bash
+
+      - name: Copy native assets into dist/ and bundle native.zip
+        run: npm run copy:native
+
+      - name: Resolve version
+        id: ver
+        shell: bash
+        run: |
+          # v1.0.1 -> 1.0.1
+          ver="${GITHUB_REF_NAME#v}"
+          echo "version=$ver" >> "$GITHUB_OUTPUT"
+
+      - name: Upload native.zip to a GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ steps.ver.outputs.version }}
+          tag_name: ${{ github.ref_name }}
+          files: |
+            dist/native.zip

plugins/f-provider/.gitignore

@@ -0,0 +1,20 @@
+node_modules/
+dist/
+
+# Native OCR build output & dependencies
+native/build/
+native/node_modules/
+
+# Compiled native addon (product of build; do not commit)
+native/**/*.node
+*.node
+
+# Tencent proprietary runtime files — never committed. Obtain locally
+# (see native/wco_data/README.md) and drop here before building/running.
+native/wco_data/*.dll
+native/wco_data/*.exe
+native/wco_data/*.nas
+native/wco_data/*.xnet
+native/wco_data/RecDict
+native/wco_data/sohu_simp.txt
+native/wco_data/x64.config

plugins/f-provider/README.md

@@ -0,0 +1,241 @@
+# ztools-f-provider
+
+<div align="center">
+
+<img src="./public/logo.png" alt="Logo" width="120">
+
+**一个 ZTools 提供商插件，把本地 OCR 与多家翻译封装为可复用的「OCR / 翻译提供商」**
+
+_微信 OCR 离线识别 · 百度 / 谷歌 / 有道 / 微软翻译 · 代码命名翻译_
+
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)](#-平台与限制)
+[![ZTools](https://img.shields.io/badge/ZTools-插件-orange)](https://github.com/ZToolsCenter/ZTools)
+
+</div>
+
+---
+
+## ✨ 特性
+
+- 🔍 **离线 OCR** - 复用本机微信内置 OCR 引擎，无需联网即可识别图片文字，带坐标逐行结果
+- 🌐 **多家翻译** - 百度 / 谷歌 / 有道 / 微软四种翻译提供商，统一接口、可设默认、凭据隔离
+- 🧩 **Provider 抽象** - 以「提供商」形式注册进 ZTools，主程序与任意插件均可复用
+- ⌨️ **代码翻译** - 把中文（或任意文本）翻译为英文，并生成 8 种代码命名风格候选，纯键盘操作
+- 📸 **截图识别** - 进入即自动截屏框选区域，识别出文字并可视化悬浮在原图上，可点选复制
+- 🖼️ **图片识别** - 拖入 / 选择图片即识别，canvas 绘图 + 透明文字层，支持全屏缩放拖动
+- 🔁 **自动翻译** - 原文变化 1s 自动重译，支持语言互换、自动推断目标语言
+- 🔒 **凭据安全** - 敏感凭据按插件命名空间隔离存入 `ztools.dbStorage`
+- 🌍 **跨平台** - 翻译部分全平台可用，OCR 部分依赖 Windows 原生运行时
+
+## 📸 预览
+
+<div align="center">
+  <table>
+    <tr>
+      <td width="50%" align="center">
+        <img src="https://raw.githubusercontent.com/kaineooo/f-provider/main/.github/assets/screenshot-ocr.gif" alt="截图识别演示" width="100%">
+        <p><i>截图识别 - 进入即截屏 → OCR → 文字悬浮可复制</i></p>
+      </td>
+      <td width="50%" align="center">
+        <img src="https://raw.githubusercontent.com/kaineooo/f-provider/main/.github/assets/img-translate.gif" alt="图片识别与翻译演示" width="100%">
+        <p><i>图片识别与翻译 - 拖图识别 + 多提供商对比</i></p>
+      </td>
+    </tr>
+    <tr>
+      <td colspan="2" align="center">
+        <img src="https://raw.githubusercontent.com/kaineooo/f-provider/main/.github/assets/code-translate.gif" alt="代码翻译演示" width="60%">
+        <p><i>代码翻译 - 中文 → 英文 → 8 种命名风格，↑↓ 切换、回车粘贴</i></p>
+      </td>
+    </tr>
+  </table>
+</div>
+
+## 🚀 快速开始
+
+> `npm install` 只安装前端依赖；native 的依赖在 `build:native` 时自动安装，**不会**联网下载专有文件，也不会编译原生模块。
+
+### 安装依赖
+
+```bash
+npm install        # 仅装前端依赖；native 的依赖会在 build 时自动安装
+```
+
+### 构建
+
+```bash
+npm run build      # 前端打包：vue-tsc + vite build，产物在 dist/
+npm run build:native  # 构建 native 模块（Windows 原生 OCR 运行时）
+```
+
+native 部分由 GitHub Actions 在打 tag 时自动构建并发布。
+
+### 使用
+
+1. 安装插件后，OCR 引擎会在首次调用时自动拉起（仅 Windows）
+2. 在「设置 → 提供商」中启用 / 设为默认 OCR 与翻译提供商
+3. 主搜索框输入 `ZTools 提供商` 进入管理页，配置翻译凭据
+
+## 🔌 作为 Provider 接入
+
+本插件在 `plugin.json` 声明了 5 个 provider：`ocr` 与 `baidu` / `google` / `youdao` / `microsoft`（均为 `translation` 类型），并在 preload 中调用 `ztools.registerProvider(<key>, handler)` 注册实现。
+
+- 安装后，「设置 → 提供商」的「OCR」「翻译」tab 会分别列出这些 provider，可启用 / 设为默认
+- 任何插件都可通过消费方 API 复用：
+
+```js
+// 便捷封装（走默认 OCR 提供商）
+const { text, blocks, confidence } = await ztools.ocr('/path/to/image.png')
+
+// 便捷封装（走默认翻译提供商）
+const { text, detectedFrom } = await ztools.translate('hello', { from: 'en', to: 'zh-CN' })
+
+// 或显式指定某个 provider（key 即 plugin.json 的声明 key）
+await ztools.providers.invokeProvider('baidu', { text: 'hello', from: 'en', to: 'zh-CN' })
+```
+
+**OCR 契约**：输入 `{ image, lang? }`（`image` 为本地路径 / `data:` URI / `http(s)` URL），输出 `{ text, blocks?, confidence? }`。
+
+**翻译契约**（对齐宿主 `TranslationInput/Output`）：输入 `{ text, from?, to? }`（`from`/`to` 为语言码字符串，缺省视为自动检测 / 默认目标），输出 `{ text, detectedFrom? }`。语言码使用中性字符串：`auto` / `zh-CN` / `zh-TW` / `yue` / `en` / `ja` / `ko` / `fr` / `es` / `ru` / `de` / `it` / `tr` / `pt-PT` / `pt-BR` / `vi` / `id` / `th` / `ms` / `ar` / `hi` / `mn-Cyrl` / `mn-Mong` / `km` / `nb` / `nn` / `fa` / `sv` / `pl` / `nl` / `uk` / `uz`，各 provider 内部再映射到自家 API 的语种代码。
+
+### 翻译凭据配置
+
+| Provider | 是否需要凭据 | 说明 |
+| --- | --- | --- |
+| 百度 | ✅ | AppID / AppKey |
+| 有道 | ✅ | AppKey / AppSecret |
+| 微软 | ✅ | 鉴权方案（Edge Token 或 Signature） |
+| 谷歌 | ❌ | 免费反代端点，无需凭据 |
+
+凭据在「ZTools 提供商管理」入口（feature `code: manage`）侧边栏的「翻译设置」子页填写并保存。敏感字段统一存入 `ztools.dbStorage`（按插件命名空间隔离），键名 `translate.<provider>`。
+
+## 🧩 功能详解
+
+本插件提供**三个 feature**：
+
+### `code: manage` — 管理页
+
+通过不同类型 cmd 承载多种入口，全部进入同一管理页，根据进入方式自动切到对应 tab：
+
+- **关键词进入**（`text` 型 cmd `ZTools 提供商`）：可被搜索（支持拼音），默认打开「设置」tab
+- **图片进入**（`img` / `files` 匹配型 cmd）：拖入或选择图片文件后，自动切到「识别」tab，展示原图预览并用该图片跑 OCR，展示带坐标的逐行结果。仅 Windows
+- **文本翻译进入**（`regex` 型 cmd `翻译`，`match: ^[\s\S]*$`）：在主搜索框输入任意文本即可命中，进入后自动切到「翻译」tab，预填该文本并触发一次翻译
+
+管理页侧边栏子页（无分组，平铺）：
+
+- **设置** - OCR 引擎 + 翻译服务卡片网格（凭据 / 鉴权方案）
+- **识别** - 选图 / 拖拽 / 粘贴识别，画布绘制原图 + 透明文字层可点选复制；超级面板选图会先转 data URI 展示原图
+- **翻译** - 单 provider 实用翻译器，原文/译文左右结构、原文可编辑、顶部「自动翻译」开关——开启后原文变化 1s 自动重译，支持语言互换、自动推断目标语言
+- **批量测试** - 四 provider 并发对比，供验证凭据
+
+> OCR 子页在非 Windows 下打开会显示「引擎未就绪」并引导下载；翻译相关子页全平台可用。
+
+### `code: code-translate` — 代码翻译
+
+把选中的中文文本（或任意文本）翻译为英文，再按多种代码命名风格生成候选列表，纯键盘操作：
+
+- **进入**（`regex` 型 cmd `代码翻译`，`match: ^[\s\S]*$`）：主搜索框输入任意文本即可命中
+- **流程** - 含中文的文本经 translation provider（默认 microsoft → google → baidu → youdao 降级）翻译到英文（`auto` → `en`）；纯 ASCII 文本跳过翻译直接转换
+- **候选风格（8 种）** - camelCase、PascalCase、snake_case、CONSTANT_CASE、kebab-case、camel_Snake（混合下划线+驼峰）、Pascal_Snake、flatcase（全小写无分隔）、UPPERFLAT（全大写无分隔）
+- **键盘** - `↑` / `↓`（或 `Tab` / `Shift+Tab`）环形切换候选、`Enter` 确认、`Esc` 取消；也支持鼠标 hover/click
+- **确认动作** - `Enter` 调 `ztools.hideMainWindowPasteText` 把结果粘贴回原光标位置并退出；粘贴失败时回退到复制 + Toast 提示
+- **兜底** - provider 翻译失败时用原文做风格转换，保证候选列表非空
+
+### `code: screen-ocr` — 截图识别
+
+进入即自动调起系统截屏，框选区域后自动跑微信 OCR，可视化与「识别」页完全一致（canvas 绘图 + 透明文字层悬浮 + 全屏缩放/拖动 + 结果列表）：
+
+- **进入**（`text` 型 cmd `截图识别文字`）：可被搜索（支持拼音）。仅 Windows（`platform: ["win32"]`）
+- **流程** - 进入即自动触发 `ztools.screenCapture` → 用户框选屏幕区域 → 截图回调返回 base64 → 自动调 `ocrImageDetail` 识别 → canvas 绘制截图 + 透明文字层（按坐标悬浮，鼠标 hover 预览 / 点击复制）+ 结果列表双向高亮。顶部「重新截图」可反复截
+- **可视化**（复用 `OcrImageViewer`）- 图上文字鼠标悬浮弹出预览、点击复制；右下角「⛶」全屏预览，支持滚轮缩放（以鼠标为锚点）、拖动、按钮缩放/复位
+- **取消** - 截屏时按 `Esc` 取消（不报错，回到待截图态）；非截屏态按 `Esc` 退出插件
+- **复制** - 点击单行复制该行；「复制全部」复制全部识别文字
+- **引擎未就绪** - 渲染 native 引擎下载卡片（允许下载自救），下载就绪后自动补一次截屏
+
+> 💡 **关于 cmd 类型**：`text` 型 cmd（label 即搜索关键字）是唯一能进入 ZTools 主搜索列表的 cmd 类型；`img`/`files`/`regex`/`over`/`window` 仅在对应场景匹配时出现。因此若需要让插件「能被搜到且能打开」，至少要有一个 feature 携带 `text` 型 cmd。
+
+## 🛠️ 技术栈
+
+- **框架**: Vue 3 + TypeScript + Vite
+- **UI**: ztools-ui（与宿主一致的组件库）
+- **Provider 注册**: ZTools `ztools.registerProvider` API
+- **原生模块**: C++ (Node-API / node-addon-api)
+  - 微信 OCR 运行时（mmmojo IPC 桥接）
+  - 手写 protobuf 编解码
+  - 任务队列 + 回调
+- **翻译**: 移植自 [STranslate](https://github.com/ZGGSONG/STranslate) 的纯 Node.js 实现
+
+## 📁 项目结构
+
+```
+f-provider/
+├── native/                      # 原生模块工程
+│   ├── binding.gyp              # node-gyp 构建配置
+│   ├── package.json             # node-addon-api 依赖
+│   ├── index.js                 # .node 加载入口（require）
+│   ├── scripts/
+│   │   └── fetch-wco-data.cjs   # build 时自动获取 OCR 运行时数据
+│   ├── src/                     # C++ 源
+│   │   ├── addon.cc             #   N-API 绑定（init/ocr/dispose）
+│   │   ├── mmmojo.{h,cc}        #   IPC 桥接库动态加载封装
+│   │   ├── ocr_manager.{h,cc}   #   任务队列 + 回调
+│   │   ├── pb.{h,cc}            #   手写 protobuf 编解码
+│   │   └── ocr_protobuf.proto   #   消息定义（文档用）
+│   └── wco_data/                # OCR 运行时（git-ignored，build 时自动获取）
+├── public/
+│   ├── plugin.json              # 声明 providers.{ocr,baidu,google,youdao,microsoft} + 三个 feature
+│   ├── preload/services.js      # registerProvider(...) + 归一化输入
+│   └── logo.png
+├── src/                         # Vue 前端（交互式 feature，全部基于 ztools-ui）
+│   ├── App.vue                  #   按 action.code 分流
+│   ├── main.ts                  #   注册 ztools-ui + 同步宿主主题
+│   ├── components/              #   SettingLayout / EngineStatusCard / OcrImageViewer / GlobalFeedback
+│   ├── composables/             #   useNativeEngine / useCaseConvert
+│   ├── views/                   #   Settings / RecognizeTest / Translate / TranslateTest / CodeTranslate / ScreenOcr
+│   └── Manage/index.vue         #   manage feature 容器
+├── scripts/copy-native.mjs      # 构建后把 native 资源拷进 dist/
+└── package.json
+```
+
+## 📋 平台与限制
+
+| 功能 | Windows | macOS | Linux |
+| --- | :---: | :---: | :---: |
+| OCR（微信引擎） | ✅ | ❌ | ❌ |
+| 截图识别 | ✅ | ❌ | ❌ |
+| 翻译（百度/谷歌/有道/微软） | ✅ | ✅ | ✅ |
+| 翻译设置 / 批量测试 | ✅ | ✅ | ✅ |
+
+- **OCR** 仅 **Windows x64**（依赖原生运行时）。`plugin.json` 中 `screen-ocr` feature 已用 `platform: ["win32"]` 标注；`manage` feature 不限制平台，非 Windows 下可打开但「识别」子页会显示引擎未就绪
+- **翻译** provider 为纯 Node.js 实现，跨平台无原生依赖，其设置 / 测试子页随 `manage` feature 全平台可访问
+- OCR 首次调用时拉起引擎子进程；长时间不再使用时 preload 会按需 `dispose` 释放
+
+## 🐛 问题反馈
+
+遇到问题？请在 [Issues](https://github.com/Particaly/ztools-f-provider/issues) 中反馈。
+
+提交 Issue 时请包含：
+
+- 操作系统版本
+- 插件版本
+- 复现步骤
+- 错误日志（如有）
+
+## 💝 致谢
+
+- [STranslate](https://github.com/ZGGSONG/STranslate) - 翻译实现移植来源
+- [ZTools](https://github.com/ZToolsCenter/ZTools) - Provider 抽象与契约
+- [Vue.js](https://vuejs.org/) - 渐进式 JavaScript 框架
+- [Vite](https://vite.dev/) - 下一代前端构建工具
+
+## 📄 许可证
+
+代码部分采用 [MIT License](./LICENSE) 许可证。
+
+---
+
+<div align="center">
+
+**如果这个插件对你有帮助，请给个 Star ⭐️**
+
+</div>

plugins/f-provider/index.html

@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

plugins/f-provider/native/.gitignore

@@ -0,0 +1,13 @@
+# node-gyp build output
+build/
+
+# Compiled native addon (product of build)
+*.node
+
+# node modules
+node_modules/
+
+# Proprietary Tencent files — never committed. These must be obtained locally
+# (see README) and dropped into wco_data/ before running/rebuilding.
+wco_data/
+!wco_data/.gitkeep

plugins/f-provider/native/binding.gyp

@@ -0,0 +1,30 @@
+{
+  "targets": [
+    {
+      "target_name": "wechat_ocr",
+      "sources": [
+        "src/addon.cc",
+        "src/mmmojo.cc",
+        "src/ocr_manager.cc",
+        "src/pb.cc"
+      ],
+      "include_dirs": [
+        "<!@(node -p \"require('node-addon-api').include\")"
+      ],
+      "dependencies": [
+        "<!(node -p \"require('node-addon-api').gyp\")"
+      ],
+      "defines": [
+        "NAPI_DISABLE_CPP_EXCEPTIONS"
+      ],
+      "cflags_cc": ["-std=c++17"],
+      "msvs_settings": {
+        "VCCLCompilerTool": {
+          "ExceptionHandling": 1,
+          "AdditionalOptions": ["/utf-8"]
+        }
+      },
+      "msvs_disabled_warnings": ["4267", "4244", "4100", "4819"]
+    }
+  ]
+}