# local-llm-translator

**Repository Path**: firstddf/local-llm-translator

## Basic Information

- **Project Name**: local-llm-translator
- **Description**: 本地llama翻译chrome插件
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 本地模型网页翻译插件

基于本地 LLM 模型的 Chrome 扩展插件，将英文网页翻译成中文，完全本地运行，保护隐私。

## 🚀 快速开始

### 安装步骤

1. **克隆仓库**
   ```bash
   git clone https://github.com/firstddf/local-llm-translator.git
   cd local-llm-translator
   ```

2. **安装 Chrome 扩展**
   - 打开 Chrome 浏览器
   - 访问 `chrome://extensions/`
   - 开启"开发者模式"
   - 点击"加载已解压的扩展程序"
   - 选择 `release` 文件夹

3. **启动本地模型服务**
   - 下载 [llama.cpp](https://github.com/ggerganov/llama.cpp)
   - 下载翻译模型（如 Qwen3.5-4B）
   - 修改 `start-server.bat` 中的模型路径
   - 运行 `start-server.bat`

4. **配置插件**
   - 点击扩展图标
   - 进入"设置"
   - 确认 API 端点为 `http://localhost:8080`
   - 设置目标语言为"中文"

## 📁 文件结构

```
local-llm-translator/
├── release/                 # Chrome 扩展文件（安装此文件夹）
│   ├── manifest.json       # 扩展配置
│   ├── background.js       # Service Worker
│   ├── content.js          # 内容脚本
│   ├── popup.html          # 弹出界面
│   ├── popup.js            # 弹出逻辑
│   ├── options.html        # 设置页面
│   ├── options.js          # 设置逻辑
│   ├── styles.css          # 样式
│   ├── start-server.bat    # 启动脚本
│   ├── icon16.png          # 扩展图标
│   ├── icon48.png          # 扩展图标
│   ├── icon128.png         # 扩展图标
│   ├── LICENSE             # GPL-3.0 许可证
│   ├── README.md           # 使用说明
│   └── 快速开始.md          # 快速开始指南
├── .gitignore              # Git 忽略配置
└── README.md               # 本文件
```

## ✨ 功能特性

- **三种翻译模式**: 英汉对照、替换中文、恢复英文
- **批量翻译**: 一次翻译 50 条文本，提高速度
- **滚动翻译**: 向下滚动时自动翻译新内容
- **Shadow DOM 支持**: 支持翻译动态加载内容
- **隐私优先**: 所有翻译完全本地运行
- **完整日志**: 调试日志支持保存功能

## 📖 详细文档

详细使用说明请查看 [release/README.md](release/README.md)

## 🛠️ 开发

### 构建发布包

```bash
# 创建 release 文件夹
mkdir release

# 复制必要文件
xcopy *.js release\ /Y
xcopy *.html release\ /Y
xcopy *.css release\ /Y
xcopy *.png release\ /Y
xcopy *.bat release\ /Y
```

### 测试

1. 在 Chrome 扩展中加载 `release` 文件夹
2. 打开任意英文网页
3. 点击扩展图标进行翻译

## 📋 系统要求

- Chrome 88+
- Windows 10/11
- 本地 LLM 模型（推荐 Qwen3.5-4B）
- 8GB+ 内存（推荐 16GB）
- GPU 加速（可选）

## 📝 许可证

GPL-3.0 License

## 🔗 链接

- GitHub: https://github.com/firstddf
- Gitee: https://gitee.com/firstddf

## 🙏 致谢

- [llama.cpp](https://github.com/ggerganov/llama.cpp) 团队
- [Qwen](https://github.com/QwenLM/Qwen) 模型团队
- Chrome 扩展文档

---

**作者**: firstddf  
**版本**: v1.0  
**发布日期**: 2026-03-14