LLM划词翻译 by Fitue

LLM 划词翻译 (LLM Selection Translator)

一个轻量级、现代化的浏览器划词翻译扩展，支持多种翻译引擎，特别优化了对 OpenAI 及兼容大模型（如 DeepSeek, Moonshot）的流式输出支持，并具备“思考过程”显示功能。

✨ 主要功能

• 划词即译：在网页上选中文字，右下角浮现翻译按钮，点击即刻翻译。
• PDF 划词翻译：打开 .pdf 链接时自动跳转到扩展内置 PDF.js viewer，并支持同样的划词翻译浮窗流程。
• 多引擎支持：
  • 浏览器内置 Translation API（实验）：优先在本地设备翻译文本，首次可能需要下载语言模型。
  • 浏览器内置 LanguageDetector（实验）：自动识别源语言，若不可用则回退本地规则检测。
  • OpenAI / 大模型 (推荐)：支持流式输出 (Streaming)，打字机效果，响应迅速。
  • WebLLM 本地模型 (实验)：在 Chrome/Edge 中基于 WebGPU 本地运行小模型翻译，支持模型选择、预下载与加载进度展示。
  • 思考模型支持：支持显示大模型（如 Jan-v1, DeepSeek-R1 等）的思维链 (Chain of Thought) 过程，可折叠查看。
  • 传统引擎：集成 Google、Bing 翻译。
• 智能识别：自动检测源语言，中英互译（中文->英文，其他->中文）。
• 美观 UI：现代化的卡片式设计，自适应高度，支持夜间模式（跟随系统或网页风格适配）。
• 高度可配置：自定义 API 地址、模型名称、字体、快捷键行为等。

⚙️ 配置说明

点击浏览器右上角的插件图标，进入设置页面进行配置：

1. OpenAI / 大模型设置 (推荐)

• API 地址: 填入 OpenAI 官方或兼容 API 的地址（例如 https://api.openai.com/v1/chat/completions 或您的代理地址）。
• API Key: 填入您的 API 密钥 (sk-...)。
• 翻译模型: 用于常规翻译的模型，如 gpt-4o-mini。
• 思考模型: (可选) 启用“显示思考”时使用的模型，如 gpt-5。
• 显示思考过程: 开启后，如果模型返回思考内容（通过 ground_truth 标记或 reasoning_content 字段），弹窗中将显示可折叠的思考区域。

2. 其他引擎

• Google 翻译: 可在“首选翻译引擎”中直接选择，无需 API Key。
• Bing 翻译: 可在“首选翻译引擎”中直接选择，无需 API Key。

3. WebLLM 本地模型（实验）

• 浏览器限制: 仅 Chrome/Edge 可用，Firefox 不显示该功能。
• 模型选择: 支持推荐模型和自定义 model id。
• 模型下载: 可在设置页点击“下载/预加载模型”，首次划词翻译也会按需加载并显示进度。
• 空闲回收: 若 20 分钟内未使用 WebLLM，会自动清理已加载模型与缓存。
• 性能建议: 扩展会检测 WebGPU/内存/CPU，设备偏弱时会提示不建议启用。

📖 使用方法

1. 划词：在任意网页上用鼠标选中一段文字。
2. 点击按钮：选中区域右下角会出现一个蓝色的“翻译”悬浮按钮，点击它。
3. 查看结果：翻译结果将以弹窗形式显示。
   • 如果是大模型翻译，结果会流式逐字显示。
   • 如果包含思考过程，点击“思考（展开）”即可查看模型的推理逻辑。
4. 关闭：点击弹窗右上角的 × 或点击页面空白处即可关闭弹窗。

PDF 使用

1. 直接打开任意 http/https/file 的 .pdf 地址。
2. 扩展会自动重定向到内置 PDF.js viewer（路径：vendor/pdfjs/web/viewer.html）。
3. 在 PDF 页面中选中文本后，按原网页一致的方式点击“翻译”按钮即可。

Firefox 本地 PDF（推荐入口）

1. 点击扩展图标，进入设置弹窗。
2. 点击 “打开本地 PDF（Firefox 兼容）”。
3. 将自动进入内置 PDF.js viewer 并尝试弹出文件选择器，选择本地 PDF 即可。

说明：Firefox 出于安全限制，moz-extension:// 页面不能直接加载 file:// 本地 PDF，
因此本扩展不会自动重定向本地 file:// PDF 到内置 viewer；网络 PDF（http/https）不受此限制。

🛠️ 常见问题

• Q: 为什么 OpenAI 翻译没反应？
  • A: 请检查 API Key 是否正确，以及 API 地址是否允许跨域 (CORS)。如果是自建代理，请确保 Header 中允许了 Access-Control-Allow-Origin: *。
• Q: Google / Bing 翻译报错？
  • A: 可能是目标站点网络受限或接口策略变更导致，请先切换网络环境并重试；也可临时切换到 OpenAI 或浏览器内置 Translation API。
• Q: 思考内容没有显示？
  • A: 请确保在设置中开启了“显示思考过程”，并且使用的模型确实支持输出思考内容（或 Prompt 中包含了思考指令）。