bob-plugin-grok-translator

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

bob-plugin-grok-translator

★ 12 Open GitHub ↗

一个支持xAI、OpenAI、Anthropic、Google、DeepSeek等公司模型的bob插件，自行输入API Key，高效翻译！

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Bob 多AI模型翻译插件

[English](README-en.md) | 简体中文

[![GitHub license](https://img.shields.io/github/license/n-AChegYag/bob-plugin-grok-translator)](https://github.com/n-AChegYag/bob-plugin-grok-translator/blob/main/LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/n-AChegYag/bob-plugin-grok-translator)](https://github.com/n-AChegYag/bob-plugin-grok-translator/stargazers)
[![GitHub issues](https://img.shields.io/github/issues/n-AChegYag/bob-plugin-grok-translator)](https://github.com/n-AChegYag/bob-plugin-grok-translator/issues)
[![Version](https://img.shields.io/badge/version-2.0.0-blue)](https://github.com/n-AChegYag/bob-plugin-grok-translator/releases)

**Bob 多AI模型翻译插件** 是一款为 [Bob](https://bobtranslate.com/) (macOS 翻译和 OCR 软件) 设计的插件，支持 **xAI、OpenAI、Google、Anthropic、DeepSeek** 及**自定义 AI 提供商**，利用强大的语言模型提供高质量的翻译服务。

## ✨ 功能特性

*   **🤖 多AI提供商支持**: 支持 xAI、OpenAI、Google、Anthropic、DeepSeek 及自定义提供商
*   **🔧 自定义提供商**: 可配置任意兼容 OpenAI API 格式的服务
*   **🎯 高质量翻译**: 利用先进的大语言模型进行精准翻译
*   **🌍 多语言支持**: 支持数十种语言之间的互译
*   **💾 智能缓存**: 内置 LRU 缓存机制（支持 TTL），提升响应速度
*   **🎨 Bob 集成**: 无缝集成到 Bob 应用中，提供便捷的划词翻译和截图翻译体验
*   **⚙️ 灵活配置**: 支持自定义提示词、API 密钥、模型选择等
*   **🏗️ 模块化架构**: v2.0.0 重构为模块化设计，易于维护和扩展

## 🚀 安装

### 方式一：直接安装（推荐）

1. 前往 [Releases](https://github.com/n-AChegYag/bob-plugin-grok-translator/releases) 页面下载最新的 `.bobplugin` 文件
2. 双击下载的 `.bobplugin` 文件，Bob 将自动完成安装
3. 在 Bob 的 `偏好设置` → `服务` → `文本翻译` 中，找到 "多AI模型翻译插件"，勾选启用

### 方式二：手动安装

1. 下载 `.bobplugin` 文件
2. 打开 Bob 的 `偏好设置` → `插件`
3. 将 `.bobplugin` 文件拖拽到插件列表中
4. 在 Bob 的 `偏好设置` → `服务` → `文本翻译` 中启用插件

## ⚙️ 配置

### 基础配置

1. 在 Bob 的 `偏好设置` → `服务` → `文本翻译` 中，选中 "多AI模型翻译插件"
2. 在右侧的配置界面中：
   - **选择AI提供商**: xAI / OpenAI / Google / Anthropic / DeepSeek / 自定义提供商
   - **填入API密钥**: 根据所选提供商填入对应的 API Key
   - **选择模型**: 从下拉菜单中选择要使用的具体模型
3. (可选) 自定义提示词、API基础URL等高级配置

### 获取 API 密钥

| 提供商 | 官网 | API密钥获取 |
|--------|------|-------------|
| **xAI** | [x.ai](https://x.ai/) | [控制台](https://console.x.ai/) |
| **OpenAI** | [openai.com](https://openai.com/) | [API Keys](https://platform.openai.com/api-keys) |
| **Google** | [ai.google](https://ai.google/) | [AI Studio](https://aistudio.google.com/apikey) |
| **Anthropic** | [anthropic.com](https://www.anthropic.com/) | [Console](https://console.anthropic.com/) |
| **DeepSeek** | [deepseek.com](https://www.deepseek.com/) | [平台](https://platform.deepseek.com/) |

### 自定义提供商配置

本插件支持任意兼容 OpenAI Chat Completions API 格式的服务：

1. 选择 AI 提供商为 **"自定义提供商"**
2. 填写以下信息：
   - **API Key**: 您的自定义服务的认证密钥
   - **API 基础 URL**: 完整的 API 端点地址（例如 `https://api.example.com/v1/chat/completions`）
   - **模型名称**: 要使用的模型名称（例如 `custom-model`）

## 📋 模型支持

当前版本（v2.0.0）集成了以下公司提供的语言模型：

### xAI (Grok)
- `grok-3-beta` - Grok 3 完整版
- `grok-3-fast-beta` - Grok 3 快速版
- `grok-3-mini-beta` - Grok 3 迷你版
- `grok-3-mini-fast-beta` - Grok 3 迷你快速版

### OpenAI
- `gpt-5.2` - GPT-5.2 最新旗舰模型
- `gpt-5-mini` - GPT-5 Mini 快速高效版本
- `gpt-5-nano` - GPT-5 Nano 最快最经济版本
- `gpt-4o` - GPT-4 Omni（仍然流行）
- `gpt-4o-mini` - GPT-4 Omni Mini
- `o3` - O3 推理模型
- `o3-mini` - O3 Mini 推理模型
- `o4-mini` - O4 Mini 快速推理模型

### Google (Gemini)
- `gemini-1.5-pro` - Gemini 1.5 Pro
- `gemini-1.5-flash` - Gemini 1.5 Flash
- `gemini-2.0-flash` - Gemini 2.0 Flash（推荐）
- `gemini-2.5-flash-preview-04-17` - Gemini 2.5 Flash 预览版
- `gemini-2.5-pro-preview-03-25` - Gemini 2.5 Pro 预览版

### Anthropic (Claude)
- `claude-sonnet-4-5` - Claude Sonnet 4.5 最新智能模型（推荐）
- `claude-haiku-4-5` - Claude Haiku 4.5 最快模型
- `claude-opus-4-5` - Claude Opus 4.5 最强大模型
- `claude-3-7-sonnet-latest` - Claude 3.7 Sonnet（旧版）

### DeepSeek
- `deepseek-chat` - DeepSeek Chat V3.2 对话模型
- `deepseek-reasoner` - DeepSeek Reasoner V3.2 推理模型

### 自定义提供商
支持任意兼容 OpenAI Chat Completions API 格式的服务，例如：
- OneAPI
- LocalAI
- Ollama（需配置 OpenAI 兼容接口）
- 其他第三方 API 代理服务

## 💡 使用

### 快捷操作

- **划词翻译**: 选中文本后按 `⌥ + D`（可自定义）
- **截图翻译**: 按 `⌥ + S`（可自定义），框选包含文本的区域
- **输入翻译**: 按 `⌥ + A`（可自定义），在弹出框中输入文本

### 提示

- 确保在 Bob 的服务设置中将本插件设为默认或启用的翻译服务之一
- 首次使用需要配置至少一个 AI 提供商的 API 密钥
- 智能缓存会自动记录翻译结果，相同内容会直接返回缓存（1小时内有效）

## 🏗️ 架构说明 (v2.0.0)

本插件采用模块化架构设计，从 v1.x 的单文件 850+ 行代码重构为清晰的模块化结构：

```
main/
├── main.js                 # 插件入口（仅14行）
├── lang.js                 # 语言代码映射
├── info.json               # 插件元数据
├── appcast.json            # 更新配置
├── providers/              # AI 提供商适配器
│   ├── base.js            # 基础提供商类
│   └── factory.js         # 提供商工厂
├── core/                   # 核心功能
│   ├── cache.js           # LRU 缓存（支持 TTL）
│   ├── prompt.js          # 提示词生成
│   └── translator.js      # 翻译核心逻辑
└── utils/                  # 工具函数
    ├── constants.js       # 常量定义
    ├── errors.js          # 错误处理
    └── validators.js      # 验证函数
```

### v2.0.0 主要改进

- ✅ **模块化架构**: 从单文件重构为 12 个模块化文件
- ✅ **真正的 LRU 缓存**: 实现正确的 LRU + TTL 缓存机制（之前是错误的 FIFO）
- ✅ **提供商抽象层**: 易于扩展新的 AI 提供商
- ✅ **Bug 修复**: 修复 Google API URL 硬编码、模型列表不一致等问题
- ✅ **代码质量**: 添加 ESLint 配置，统一代码规范
- ✅ **开发工具**: 添加 package.json 和构建脚本

详见 [REFACTOR_SUMMARY.md](REFACTOR_SUMMARY.md) 了解完整的重构说明。

## 🤝 贡献

欢迎各种形式的贡献！无论是报告 Bug、提出建议还是提交代码，我们都非常感谢。

### 报告问题

如果您在使用中遇到问题，请通过 [Issues](https://github.com/n-AChegYag/bob-plugin-grok-translator/issues) 提交详细的 Bug 报告，包括：
- 问题描述
- 复现步骤
- 预期行为
- 实际行为
- 环境信息（Bob 版本、macOS 版本等）

### 功能建议

如果您有功能建议或改进想法，欢迎在 [Issues](https://github.com/n-AChegYag/bob-plugin-grok-translator/issues) 中提出。

### 提交代码

1. Fork 本仓库
2. 创建新的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

### 添加新的 AI 提供商

本插件采用模块化设计，添加新的 AI 提供商非常简单：

#### 步骤 1: 创建提供商类

在 `main/providers/factory.js` 中添加新的提供商类：

```javascript
class NewProviderProvider extends BaseProvider {
    constructor() {
        super('NewProvider');
    }
    
    getHeaders(apiKey) {
        return {
            "Content-Type": "application/json",
            "Authorization": `Bearer ${apiKey}`
        };
    }
    
    extractContent(data) {
        return data.choices[0].message.content;
    }
}
```

#### 步骤 2: 添加常量配置

在 `main/utils/constants.js` 中添加：

```javascript
const API_URLS = {
    // ...
    NewProvider: "https://api.newprovider.com/v1/chat/completions"
};

const DEFAULT_MODELS = {
    // ...
    NewProvider: "model-name"
};
```

#### 步骤 3: 更新插件配置

在 `main/info.json` 的 `options` 数组中添加：

```json
{
  "identifier": "newproviderApiKey",
  "type": "text",
  "title": "NewProvider API Key",
  "desc": "填写 NewProvider 的 API KEY",
  "dependsOn": {
    "identifier": "provider",
    "value": "NewProvider"
  }
}
```

#### 步骤 4: 更新文档

更新 README.md 中的模型支持列表和配置说明。

#### 步骤 5: 测试

全面测试新添加提供商的翻译功能，确保：
- API 调用正确
- 错误处理完善
- 缓存机制正常
- UI 配置正确显示

## 🛠️ 开发

### 环境要求

- Node.js 14+
- npm 或 yarn

### 开发流程

```bash
# 克隆仓库
git clone https://github.com/n-AChegYag/bob-plugin-grok-translator.git
cd bob-plugin-grok-translator

# 安装依赖
npm install

# 代码检查
npm run lint

# 自动修复代码规范问题
npm run lint:fix

# 构建插件
npm run build
```

构建后的 `.bobplugin` 文件位于项目根目录。

### 代码规范

本项目使用 ESLint 进行代码规范检查，配置文件为 `.eslintrc.js`。提交代码前请确保：

```bash
npm run lint
```

通过所有检查。

## 📄 许可证

本项目采用 [MIT License](LICENSE) 开源。

## 🙏 鸣谢

- [Bob](https://bobtranslate.com/) - 优秀的 macOS 翻译软件
- [xAI](https://x.ai/) - Grok 语言模型
- [OpenAI](https://openai.com/) - GPT 系列模型
- [Google](https://ai.google/) - Gemini 系列模型
- [Anthropic](https://www.anthropic.com/) - Claude 系列模型
- [DeepSeek](https://www.deepseek.com/) - DeepSeek 系列模型

## 📮 联系方式

- 作者：n-AChegYag
- 项目主页：[GitHub](https://github.com/n-AChegYag/bob-plugin-grok-translator)
- 问题反馈：[Issues](https://github.com/n-AChegYag/bob-plugin-grok-translator/issues)

---

**免责声明**: 本插件是基于各 AI 提供商 API 开发的第三方工具，与各公司无直接关联。请遵守各提供商的服务条款和使用政策。使用本插件产生的 API 费用由用户自行承担。

bob-plugin-grok-translator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README