KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

Lingrove

★ 40 Open GitHub ↗

一款沉浸式语言学习浏览器插件，用于收集、复习和巩固词汇。An immersive language learning browser plugin for collecting, reviewing, and consolidating vocabulary.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Lingrove - 沉浸式语言学习 Chrome 插件

智能替换网页词汇，创造沉浸式双语学习环境 
 基于「可理解性输入」理论，让语言学习融入日常生活

<a href="README_EN.md">English</a> | 中文

## 📸 功能展示

---

## === 2026-01-24 更新功能 ===

### ☁️ 自动同步功能

新增定时自动同步功能，无需手动操作即可定期备份数据：

- **定时自动备份** — 每小时自动检测并上传数据到 WebDAV 云端
- **智能文件管理** — 每天仅保留一个自动同步文件（`auto_sync_YYYY-MM-DD.json`），自动清理旧文件
- **静默运行** — 后台自动执行，不干扰用户正常使用
- **可选开关** — 可在设置页面自由启用/禁用自动同步功能

### 🔄 页面还原功能

新增快捷键支持临时还原页面到原始状态：

- **快捷键还原** — 按 `Alt+R` 快速还原页面到未翻译状态
- **智能状态管理** — 手动还原后自动禁用自动处理，避免重复翻译
- **快捷键拆分** — 将原 `Alt+T` 拆分为处理页面（`Alt+T`）和还原页面（`Alt+R`）两个独立快捷键
- **UI 优化** — Popup 操作区域改为网格布局，按钮并排显示

### 🚫 IP 地址过滤

新增 IP 地址自动过滤功能，跳过本地开发环境：

- **自动识别** — 自动识别并跳过 localhost、192.168.x.x、IPv6 等本地地址
- **一键开关** — 可在设置页面一键启用/禁用 IP 地址过滤
- **开发友好** — 避免在本地开发环境中触发不必要的翻译处理

### 🐛 翻译弹窗优化

修复翻译弹窗显示问题，提升用户体验：

- **智能定位** — 自动检测弹窗位置，确保完全显示在可视区域内
- **边界处理** — 弹窗超出屏幕边界时自动调整位置，避免被遮挡

---

## === 2026-01-10 更新新功能 ===

### 🌐 接入翻译API服务支持

新增独立的翻译服务模块，支持翻译网页指定文本并替换原文：

- **自定义翻译 API** — 可配置 Google、百度、腾讯云、有道等翻译服务
- **多节点配置** — 支持配置多个翻译服务节点，按优先级使用
- **自动降级处理** — 翻译服务不可用时，自动降级到 AI 翻译兜底

**支持的免费翻译 API：**

| 服务商 | 免费额度 | 文档地址 |
|--------|----------|----------|
| Google 翻译 | 50 万字符/月 | https://cloud.google.com/translate/pricing?hl=zh-cn |
| 百度翻译 | 5万字符/月（未认证） 100万字符/月（个人认证） | https://fanyi-api.baidu.com/product/112 |
| 腾讯云翻译 | 500 万字符/月 | https://cloud.tencent.com/document/product/551/35017 |
| 有道智云 | 一次性 50 元额度 | https://ai.youdao.com/DOCSIRMA/html/trans/price/wbfy/index.html |

### ☁️ 云同步功能

新增数据云同步功能，支持跨设备同步学习数据：

- 已学会词汇列表同步
- 需记忆词汇列表同步
- 扩展配置同步

### 📝 选中文本翻译

选中页面任意文本即可弹出翻译窗口：

- **短文本** — 直接显示翻译结果
- **段落文本** — 支持长段落翻译

### 👁️ 已学会词汇显示配置

可配置已学会词汇在页面上的显示方式：

- **隐藏** — 完全不显示已学会的词汇
- **原文** — 显示原文形式
- **译文** — 显示译文形式

### 📊 替换强度百分比优化

替换强度从固定词数改为百分比模式，根据段落长度动态计算替换数量，更加灵活智能。

### ⚡ 翻译阈值优化

支持自定义翻译阈值，优化翻译触发判断逻辑，使用动态最小文本长度，提升翻译触发的准确性。

---

>
> 本项目基于 [VocabMeld](https://github.com/lzskyline/VocabMeld) 二次开发。
>

---

## ✨ 核心亮点

- **多 LLM 支持** — 兼容 OpenAI、DeepSeek、Moonshot、Groq、Ollama 等主流 AI 服务
- **多节点故障转移** — 支持配置多个 API 节点，自动故障转移和速率限制轮询
- **智能语义分词** — 针对中文、英文等语言优化分词规则，准确识别词组和短语
- **提示词自定义** — 支持自定义 AI 提示词规则，优化翻译效果
- **CEFR 六级难度** — 精准控制学习词汇难度（A1-C2），只学你需要的
- **智能缓存加速** — LRU 缓存（最高 10000 词），二次访问毫秒级响应
- **双向翻译** — 自动检测页面语言，智能决定翻译方向
- **词汇管理** — 已学会词汇不再替换，需记忆词汇随时复习
- **主题定制** — 深色/浅色模式，多种配色方案可选

---

## 🚀 快速开始

### 安装

#### 方式一：从 Edge 商店安装（推荐）

直接从 Microsoft Edge 扩展商店安装，自动更新，最简单便捷：

👉 [Edge 扩展商店](https://microsoftedge.microsoft.com/addons/detail/pdkghihmaleolpieganmdjiifdhngpbc)

#### 方式二：从 Release 安装

1. 前往 [Releases 页面](https://github.com/zhdgzs/Lingrove/releases) 下载最新版本的 zip 文件
2. 解压下载的 zip 文件到本地目录
3. 打开 Chrome，访问 `chrome://extensions/`
4. 开启右上角"开发者模式"
5. 点击"加载已解压的扩展程序"，选择解压后的文件夹

#### 方式三：从源码安装

1. 克隆本仓库：`git clone https://github.com/zhdgzs/Lingrove.git`
2. 安装依赖并构建：`npm install && npm run build`
3. 打开 Chrome，访问 `chrome://extensions/`
4. 开启"开发者模式"
5. 点击"加载已解压的扩展程序"，选择项目文件夹

### 配置 API

1. 点击扩展图标 → 设置
2. 选择预设服务（**推荐魔搭社区**，免费额度充足）或自定义配置
3. 填入 API 密钥，测试连接

> **魔搭社区使用说明**：
>
> 魔搭社区单账号每天 2000 次总额度，但单模型限制 500 次。可以配置 4 个节点使用不同模型（如 DeepSeek-V3、DeepSeek-V3.2、Qwen2.5-72B、Qwen3-235B），充分利用 2000 次额度
> 
> 必须选择支持"推理 API-Inference"的模型才可使用，如下图所示：
>
> 
> <img src="assets/modelscope.png" alt="魔搭社区模型选择" width="80%">
>

### 支持的 API 服务

| 服务商 | 端点 | 推荐模型 | 备注 |
|--------|------|----------|------|
| **魔搭社区** ⭐ | `https://api-inference.modelscope.cn/v1/chat/completions` | deepseek-ai/DeepSeek-V3.2 | 免费额度充足，推荐 |
| DeepSeek | `https://api.deepseek.com/chat/completions` | deepseek-chat | |
| OpenAI | `https://api.openai.com/v1/chat/completions` | gpt-4o-mini | |
| Moonshot | `https://api.moonshot.cn/v1/chat/completions` | moonshot-v1-8k | |
| Groq | `https://api.groq.com/openai/v1/chat/completions` | llama-3.1-8b-instant | |
| Ollama | `http://localhost:11434/v1/chat/completions` | qwen2.5:7b | 本地部署 |

---

## 📖 使用技巧

| 操作 | 说明 |
|------|------|
| `Alt+T` | 快速处理当前页面 |
| `Alt+R` | 快速还原当前页面 |
| 悬停词汇 | 查看音标、难度、词典释义 |
| 点击音标 | 播放发音 |
| 点击"已学会" | 该词不再替换 |
| 点击"收藏记忆" | 加入记忆列表 |
| 选中生词 | 添加到需记忆列表 |

**推荐配置**：母语中文 + 学习英语 + B1 难度 + 适中强度

---

## 🔧 功能概览

### 替换强度

| 强度 | 每段最大替换 | 适用场景 |
|------|-------------|----------|
| 较少 | 4 词 | 轻度学习，保持阅读流畅 |
| 适中 | 8 词 | 日常学习，平衡阅读与学习 |
| 较多 | 14 词 | 强化学习，最大化词汇接触 |

### 显示样式

| 样式 | 显示格式 |
|------|---------|
| 译文(原文) | `translated(original)` — 默认 |
| 仅译文 | `translated` — 悬停查看原文 |
| 原文(译文) | `original(translated)` |

### 站点规则

- **所有网站模式**：默认在所有网站运行，可设置排除列表
- **仅指定网站模式**：只在指定的网站上运行
- 支持域名模糊匹配，Popup 中快速切换

### 提示词设置

支持自定义 AI 翻译提示词，优化语义分词和翻译效果：

- **分层架构** — 核心规则 + 源语言规则 + 目标语言规则 + 自定义规则
- **智能语义分词** — 针对不同语言优化分词策略：
  - 中文：按语义边界识别，避免「对方面无表情」被错误切分为「方面」
  - 英文：识别短语动词（give up、look forward to）和固定搭配
- **规则可编辑** — 源语言和目标语言规则支持自定义修改
- **完整预览** — 可预览发送给 AI 的完整提示词，包含所有动态参数

### 多节点管理

支持配置多个 API 节点，实现智能故障转移和负载均衡：

- **多节点配置** — 支持配置多个节点，每个节点可独立设置端点、密钥、模型和启用/关闭状态
- **自定义优先级** — 可以按照顺序，配置节点优先级，优先使用最优节点
- **自动故障转移** — 节点失败（网络异常、服务不可用、额度耗尽、RPM限制）时自动切换下一个
- **速率限制轮询** — 多节点轮流处理请求，突破单节点 RPM 限制
- **健康检查** — 5 分钟内 3 次失败标记异常，定期自动恢复

**典型场景**：
- 不够用，可以申请多个魔搭社区账号（每天 2000 次/账号），配置轮询叠加免费额度
- 配置不同服务商（DeepSeek + 魔搭）互为备份，提升可用性
- 免费节点优先，额度用完自动切换付费节点兜底

---

## 🔒 隐私政策

- **本地存储**：所有数据存储在浏览器本地，不上传任何服务器
- **API 请求**：仅在翻译时发送文本片段到您配置的 AI 服务
- **您控制一切**：API 密钥由您自行提供和管理
- **无追踪**：不包含任何分析、追踪或广告代码

---

## 📚 更多文档

- [技术文档](TECHNICAL.md) — 项目架构、核心算法、开发说明

---

## 📈 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=zhdgzs/Lingrove&type=Date)](https://star-history.com/#zhdgzs/Lingrove&Date)

---

## 📄 开源许可

本项目基于 [MIT License](LICENSE) 开源。

原项目：[VocabMeld](https://github.com/lzskyline/VocabMeld)

---

## ☕ 赞赏支持

Lingrove

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README