gemma-chrome-translate

KO | EN

gitlite — search

#ai #typescript #llm #android #machine-learning #rust #deep-learning #linux #docker #java #kubernetes #pytorch #security #open-source

gemma-chrome-translate

(★ 51)

100% local, zero data upload — Stream-translate any English webpage into natural Chinese using Gemma 4 via oMLX. Privacy-first Chrome extension with deep X/Twitter integration.

gemma-chrome-translate Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Gemma Chrome Translate

> **100% 本地运行、零数据上传** — 用 Gemma 4 模型实时流式翻译任何英文网页为地道的中文。

一个 Chrome 扩展，通过本地部署的 [oMLX](https://github.com/niconi19/oMLX) 推理服务，调用 Google Gemma 4 模型，将海外网站的英文内容流式翻译为自然、地道、流畅的简体中文。所有数据留在你的 Mac 上，不经过任何云端 API。

## Why

- 现有翻译工具（Google Translate、DeepL 等）翻译质量参差不齐，且需要将页面内容上传到云端
- 在隐私敏感场景（公司内部文档、私人社交平台浏览等）中，本地翻译是刚需
- Gemma 4 模型在翻译质量上已经足够好，配合精心设计的 prompt，输出接近母语水平的中文

## Features

**Smart Site-Aware Extraction**
- X / Twitter 深度适配：推文、长文（Article）、侧边栏趋势、Today's News 卡片全覆盖
- 多站点适配器：Hacker News、Reddit、GitHub、Medium、StackOverflow 各自精准提取
- 通用网页：自动识别 `<main>` / `<article>` 内的正文，按链接密度打分过滤导航/样板
- 智能跳过：代码块、导航栏、按钮、`translate="no"` / `.notranslate`、已有中文内容自动过滤

**Streaming Translation**
- 翻译结果逐字流式显示，无需等待全文翻译完成
- 翻译过程中显示柔和的光泽扫过动画（shimmer），完成后有聚焦渐显效果
- 最多 2 路并发翻译，契合本地单实例推理后端；LRU 缓存 500 条，相同内容不重复调用
- 场景化 prompt（社交 / 新闻 / 技术 / 通用）+ few-shot，按页面类型自动切换译风

**Reliability First**
- 请求超时与中断：空闲 25s / 硬上限 90s 自动 abort，卡死的本地请求不再永久占用并发槽
- 卡死看门狗：内容侧 45s 兜底，丢失的翻译会转为「失败」而非无限转圈
- 缓存持久化：译文镜像到 `chrome.storage.session`，扛得住 MV3 Service Worker 回收
- DOM 复用感知：X 虚拟化时间线复用节点时自动识别并重置，避免「旧译文贴到新推文」
- 失败可重试：失败块显示「↻ 重试」，点击即可重新翻译
- 状态可见：工具栏图标 badge 实时显示待翻译数量；本地服务不可达时弹出提示

**Privacy First**
- 所有翻译请求发送到 `127.0.0.1`，不经过任何外部服务
- 无需注册、无需登录、无需 API key（除非你的 oMLX 配置了）
- 不采集任何使用数据

**Quick Toggle**
- 右侧 Command 键循环切换「仅译文 / 双语对照 / 仅原文」
- Popup 面板管理站点规则：记住哪些站点默认翻译
- X / Twitter 默认自动翻译，其他站点按需开启

## Quick Start

### 1. 启动本地推理服务

确保 [oMLX](https://github.com/niconi19/oMLX) 已安装，使用 Gemma 4 模型启动：

```bash
# oMLX 默认监听 http://127.0.0.1:8000
omlx serve gemma-4-e4b-it-4bit
```

### 2. 构建扩展

```bash
git clone https://github.com/lhfer/gemma-chrome-translate.git
cd gemma-chrome-translate
npm install
npm run build
```

### 3. 安装到 Chrome

1. 打开 `chrome://extensions/`
2. 开启「开发者模式」
3. 点击「加载已解压的扩展程序」
4. 选择项目中的 `dist/` 目录

### 4. 开始使用

- 打开任意英文网页（如 X / Twitter）
- 扩展自动翻译页面内容
- 按 **右侧 Command 键** 切换原文/译文
- 点击扩展图标管理站点设置

## Architecture

```
src/
  background/     # Service Worker — 翻译队列调度、LLM API 调用、缓存管理
  content/        # Content Script — 页面扫描、DOM 替换、可见性检测、快捷键
  popup/          # Popup UI — 站点开关、连接状态、oMLX 配置
  shared/         # 共享类型、消息协议、设置、哈希工具
public/
  manifest.json   # Manifest V3 配置
  content.css     # 翻译动画样式
  popup.html/css  # Popup 页面
```

**Tech Stack**: TypeScript, esbuild, Manifest V3, Vitest

## Configuration

在扩展 Popup 面板中可配置：

| 选项 | 默认值 | 说明 |
|---|---|---|
| oMLX 地址 | `http://127.0.0.1:8000/v1` | 本地推理服务地址 |
| 模型 | `gemma-4-e4b-it-4bit` | 任何兼容 OpenAI API 的模型 |
| API Key | （空） | 如果推理服务需要认证 |

## Development

```bash
npm install       # 安装依赖
npm run build     # 构建到 dist/
npm test          # 运行测试
npm run test:watch # 监听模式测试
```

## License

MIT

gemma-chrome-translate

gemma-chrome-translate Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gemma-chrome-translate

gemma-chrome-translate Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README