NextAI Translator | ChatGPT 划词翻译插件与跨平台桌面应用 — 三步跑通 AI 划词翻译实战指南-平芜编程栈

NextAI Translator | ChatGPT 划词翻译插件与跨平台桌面应用 — 三步跑通 AI 划词翻译实战指南

【免费下载链接】nextai-translator基于 ChatGPT API 的划词翻译浏览器插件和跨平台桌面端应用 - Browser extension and cross-platform desktop application for translation based on ChatGPT API.项目地址: https://gitcode.com/GitHub_Trending/op/nextai-translator

nextai-translator 是一款基于 ChatGPT API 的划词翻译工具，同一个代码库同时产出 Chrome/Firefox 浏览器插件和 Windows/macOS/Linux 桌面应用（Tauri），支持 17 种 LLM 服务商接入。适合想脱离固定翻译软件、用 LLM 做划词翻译与内容总结的开发者。

仓库地址：https://gitcode.com/GitHub_Trending/op/nextai-translator（clone 用）
主要语言：TypeScript（React 18）+ Rust（Tauri 桌面端）
License：AGPL-3.0
构建工具：Vite + pnpm（package.json中锁定pnpm@9.1.3）

H2 · 快速上手：三步跑通 nextai-translator 开发环境 🚀

API Key 提示：任何运行形态都需要一个 OpenAI 兼容 API Key。以浏览器插件为例，插件加载后点击工具栏图标，在弹出的设置页填入 Key 即可；也支持在设置里切换 Azure、Ollama 等 17 种服务商引擎。

步骤 1：获取项目

克隆仓库到本地：

git clone https://gitcode.com/GitHub_Trending/op/nextai-translator

步骤 2：安装依赖

项目使用 pnpm 管理依赖（版本锁定在package.json的packageManager字段）：

cd nextai-translator && pnpm install

步骤 3：启动 Chromium 插件开发模式

dev-chromium会用 Vite 起一个带 HMR 的开发服务器，编译输出位于dist/browser-extension/chromium，随后在 Chrome 的chrome://extensions页面开启开发者模式并"加载已解压的扩展程序"指向该目录：

pnpm dev-chromium

预期输出：Vite 终端打印 "ready" 后，刷新页面即可划词翻译。桌面端则改用pnpm dev-tauri（需先装 Rust 工具链与 Tauri 平台依赖）。

H2 · 核心能力拆解：划词翻译、多引擎与跨端形态

三种翻译模式 + 流式输出

划词翻译的痛点是"等结果"。核心逻辑在 src/common/translate.ts 中，TranslateMode定义 6 种模式：translate（翻译）、polishing（润色）、summarize（总结），以及analyze、explain-code、big-bang（全文逐章解析）。翻译请求走 SSE 流式返回（依赖eventsource-parser），结果逐字追加，长文本也不用等。

17 种 LLM 服务商统一引擎

所有服务商实现同一个IEngine接口，注册表见 src/common/engines/index.ts：

类别	引擎
OpenAI 系	OpenAI、ChatGPT、Azure、Cerebras
网关/聚合	OpenRouter、TeamoRouter、LiteLLM
本地/自部署	Ollama
其他	Claude、Gemini、Groq、MiniMax、Moonshot、Kimi、ChatGLM、Cohere、DeepSeek

切换引擎只改设置页一个下拉框，Azure 需要额外拼 URL（见下），其余填 Base URL + Key 即可：

const API_URL = `https://${resourceName}.openai.azure.com` const API_URL_PATH = `/openai/deployments/${deployName}/chat/completions?api-version=${apiVersion}`

一份代码，五种端形态

仓库同时构建出：Chromium/Firefox 插件（vite.config.chromium.ts、vite.config.firefox.ts）、Tauri 桌面端（Rust 后端在 src-tauri/src/，含 OCR、系统托盘、全局快捷键）、Userscript（vite.config.userscript.ts）、PopClip/SnipDo 划词插件（clip-extensions/）。共享逻辑统一收在 src/common/，桌面端与浏览器端复用同一套翻译、词库、历史代码。

H2 · 真实场景与避坑提醒

场景 1：内网团队统一走 LiteLLM 网关

公司网络无法直连 OpenAI 时，先自建一个 LiteLLM 服务把各厂商 Key 收口成一个 OpenAI 兼容端点。nextai-translator 内置 LiteLLM 引擎，全员在设置页把服务商切到 LiteLLM、填入内网 Base URL，即可免个人 Key 使用划词翻译；配合插件市场分发（Chrome/Firefox）或 Tauri 打包的桌面端，覆盖办公 PC 上的 PDF、网页翻译需求。

场景 2：离线隐私场景用 Ollama + 截图翻译

处理合同、病历等不能出内网的文本时，本地起 Ollama（如拉取qwen2.5模型），引擎切到 Ollama 即可全链路离线。仓库桌面端内置 OCR（tesseract.js及 src-tauri/src/ocr.rs），截图翻译可直接作用于扫描件 PDF，无需先过一遍文本层。

⚠️ 常见坑

Azure 的 api-version 必须显式指定：漏掉api-version参数会直接 400，且该值会随 Azure 弃用旧版本失效，升级时需对照 Azure 官方支持的版本列表更新。
macOS 首次打开桌面端被拦截：提示"开发者无法验证"时，到设置 → 隐私与安全性点"仍要打开"，或执行sudo xattr -d com.apple.quarantine /Applications/NextAI\ Translator.app；划词快捷键失效则要在"辅助功能"里重新授权。
pnpm 版本不匹配：package.json锁死pnpm@9.1.3，高版本 pnpm 可能导致simple-git-hooks的 pre-commit 钩子安装失败，建议用 corepack 对齐版本。

H2 · 周边生态与延伸阅读

PopClip（macOS 划词工具）：仓库自带官方插件源码 clip-extensions/popclip/nextai-translator.sh，双击.popclipextz即可为任意应用划词翻译。
SnipDo（Windows 划词工具）：对应插件在 clip-extensions/snipdo/，以.pbar包分发。
LiteLLM：作为 OpenAI 兼容网关与本项目引擎层对接，适合做多模型收口与用量计费。

延伸阅读：docs/chatgpt-cn.md（ChatGPT 账号 Key 的国内使用说明）、CLIP-EXTENSIONS-CN.md（桌面端划词插件安装全流程）、README-CN.md（完整特性与发布包下载）。

nextai-translator 把"划词翻译 + 润色 + 总结"做成了一个可自部署、可换引擎、覆盖五端的开源翻译基建，浏览器插件和桌面应用共用一套核心逻辑。去 Star 一下仓库，把你的目标服务商适配需求丢进 Issue 推动它落地。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考