本地模型网页翻译插件

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

🚀 快速开始

安装步骤

1. 克隆仓库

   git clone https://github.com/firstddf/local-llm-translator.git
   cd local-llm-translator

2. 安装 Chrome 扩展

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

3. 启动本地模型服务

   • 下载 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 文件夹
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 团队
• Qwen 模型团队
• Chrome 扩展文档

---

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