# TranslationPlugin

**Repository Path**: Chato/translation-plugin

## Basic Information

- **Project Name**: TranslationPlugin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-06
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Translator Plugin

## 简介 (Introduction)

**AI Translator** 是一款基于 Chrome Extension (Manifest V3) 开发的高效网页翻译插件。它利用先进的大语言模型 (LLM) 为用户提供精准、流畅的沉浸式翻译体验。支持选中网页文本后，通过快捷键或右键菜单快速唤起翻译弹窗，并在网页原位显示翻译结果。

## 功能特性 (Features)

*   **多模型支持**：集成了多种主流 AI 模型接口，包括：
    *   **SiliconFlow (硅基流动)**：默认使用 DeepSeek-V3，速度快且成本低。
    *   **Qwen (阿里通义千问)**：支持 Qwen-Plus 等模型。
    *   **DeepSeek (官方 API)**：支持 DeepSeek-Chat。
    *   **Ollama (本地运行)**：支持通过本地 Ollama 服务运行的 Llama3 等模型，保护隐私。
*   **便捷交互**：
    *   **快捷键触发**：默认 `Alt+K` (可自定义)，一键翻译选中内容。
    *   **右键菜单**：选中文本后右键点击 "翻译选中内容"。
    *   **图标点击**：点击浏览器插件图标即可唤起。
*   **智能显示**：
    *   **Shadow DOM 隔离**：翻译弹窗样式与网页样式完全隔离，互不干扰。
    *   **Markdown 渲染**：支持代码块、列表、加粗等 Markdown 格式的完美渲染。
    *   **流式体验**：(当前版本为非流式，但支持长文本自动分段翻译)。
    *   **位置记忆**：弹窗支持拖拽，并会自动记住您上次拖拽到的位置。
*   **隐私安全**：API Key 存储在本地 (Chrome Storage Local)，不会上传到任何第三方服务器。

## 兼容性 (Compatibility)

本插件基于 **Chromium** 内核的 **Manifest V3** 标准开发，支持所有主流 Chromium 浏览器：

*   **Google Chrome** (谷歌浏览器) - *完美支持*
*   **Microsoft Edge** (微软浏览器) - *完美支持*
*   **Arc Browser** - *支持*
*   **Brave Browser** - *支持*
*   **Vivaldi** - *支持*
*   **Opera / Opera GX** - *支持*
*   **国内主流浏览器** (需开启极速模式/Chromium内核模式)：
    *   360 极速浏览器 / 安全浏览器
    *   QQ 浏览器
    *   搜狗浏览器
    *   联想浏览器

*注：Firefox (火狐) 由于 Manifest V3 实现标准不同，暂不支持。*

## 安装指南 (Installation)

### Google Chrome
1.  地址栏输入 `chrome://extensions`。
2.  开启右上角 **"开发者模式"**。
3.  点击 **"加载已解压的扩展程序"**，选择本项目文件夹。

### Microsoft Edge
1.  地址栏输入 `edge://extensions`。
2.  开启左侧（或右上角）的 **"开发人员模式"**。
3.  点击 **"加载解压缩的扩展"**，选择本项目文件夹。


## 使用说明 (Usage)

### 1. 配置 API Key
首次使用前，需要配置 LLM 提供商的 API Key：
1.  点击浏览器工具栏上的插件图标（如果没有显示，请点击“拼图”图标将其固定）。
2.  在弹出的界面或右键插件图标选择 **"选项" (Options)**。
3.  在设置页面中：
    *   选择您偏好的 **提供商 (Provider)** (如 SiliconFlow)。
    *   填入对应的 **API Key**。
    *   选择 **目标语言 (Target Language)**。
    *   点击 **"保存设置" (Save Settings)**。

### 2. 开始翻译
*   **方法一（推荐）：快捷键**
    *   用鼠标选中网页上的任意一段文本。
    *   按下快捷键 **`Alt+K`** (Windows/Linux/Mac)。
    *   *注：如果快捷键不生效，请前往 `chrome://extensions/shortcuts` 检查是否被占用。*
*   **方法二：右键菜单**
    *   选中文本 -> 右键点击 -> 选择 **"AI Translator"** -> **"翻译选中内容"**。
*   **方法三：点击图标**
    *   选中文本 -> 点击浏览器右上角的插件图标。

## 常见问题 (FAQ)

**Q: 为什么按快捷键没有反应？**
A: 
1. 请检查 `chrome://extensions/shortcuts`，确保 "Translate selected text" 已绑定快捷键。
2. 某些浏览器受保护页面（如设置页、新标签页）无法运行插件脚本。请在普通网页（如新闻、博客）尝试。
3. 刷新一下当前网页，确保 content script 已重新加载。

**Q: 翻译报错 "Failed to fetch"？**
A: 请检查您的网络连接。如果您使用的是 Ollama，请确保本地服务已启动 (`ollama serve`) 并且允许跨域请求 (Ollama 默认绑定 localhost)。

**Q: 如何修改快捷键？**
A: 在浏览器输入 `chrome://extensions/shortcuts`，找到 AI Translator，点击笔形图标即可自定义快捷键。

## 开发与贡献 (Development)

感谢开发者@'Chato Ye bonefo_

## 许可证 (License)

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

---
*Created by AI Translator Team*