强大而克制，只做一件事——翻译。
English | 中文
只译是一款专注阅读体验的浏览器翻译扩展。它可以翻译网页正文、整页内容、划词、悬停文本、输入框和视频字幕，并尽量保留原页面的结构与阅读节奏。
- 从 Chrome Web Store 安装只译，打开需要翻译的普通网页。
- 点击浏览器工具栏中的只译图标，选择一个可用的翻译服务。微软翻译、Google 翻译等免配置服务可以直接使用；AI 服务需要先填写对应的 API Key。
- 初次使用建议选择「双语对照 + 识文」，然后点击「翻译当前页面」。需要恢复时，再次点击「还原原文」。
弹窗底部的「帮助」提供可搜索的完整操作说明，包括翻译模式、划词与悬停、输入框、视频字幕、服务配置和常见问题。帮助内容保存在扩展内，可以离线阅读。
- 识文 / 全页翻译：识文模式聚焦正文、评论等主要阅读内容；全页模式覆盖更多可见文本，适合文档、论坛和工具页面。
- 双语对照 / 仅译文：保留原文进行核对和学习，或只显示译文以获得更连贯的阅读体验。
- 多种操作入口：可从扩展弹窗、页面悬浮工具栏、快捷键或右键菜单翻译当前网页。
- 划词、悬停和输入框翻译：选中内容、指向文字，或在网页输入框中使用指定字符，即可快速翻译。
- 视频字幕翻译：自动获取支持站点的原字幕，结合上下文分段翻译并显示双语字幕；播放调度与本地缓存减少等待和重复请求。
- 灵活的翻译服务：提供微软翻译、Google 翻译、Chrome 内置翻译、DeepL、OpenAI、DeepSeek、Gemini、Claude 等预设，也支持 OpenAI Chat Completions 兼容网关。
- 进阶 AI 设置：支持按服务单独控制思考模式，也可以设置默认目标语言与互译语言。
- 内置使用帮助：简体中文、English、繁體中文、日本語四种语言均提供可搜索的离线说明和界面截图。
- 识文：适合文章、博客、帖子、评论和长内容。它会优先寻找主要阅读区域，减少菜单、导航等周边信息的干扰。
- 全页：适合文档、后台、论坛、工具站和信息密集页面。它会翻译更多可见内容，同时尽量保留页面结构和交互。
如果识文模式出现漏翻，可以切换到全页后重新翻译；动态加载的内容可以滚动到可见区域后再次触发翻译。
网页翻译适用于大多数普通网页。浏览器内部页、扩展商店、安全受限页面和部分嵌入内容可能不允许扩展运行。
| 平台 | 字幕翻译 | 网页翻译 |
|---|---|---|
| YouTube | ✅ | ✅ |
| Udemy | ✅ | ✅ |
| Coursera | ✅ | ✅ |
| Khan Academy | ✅ | ✅ |
| 通用网页 | — | ✅ |
字幕翻译依赖视频本身提供可读取的原字幕轨道。
- 只译本身免费、开源，不向项目方收集使用数据；设置保存在浏览器本地。
- 使用在线翻译服务时，待翻译文本会发送给你选择的服务商，并受该服务商的隐私政策约束。
- Chrome 内置翻译在浏览器本地处理，但是否可用取决于 Chrome 版本、语言组合和本地模型状态。
- 部分在线服务需要 API Key，并可能按各自规则收费。只译不会代替服务商管理账户、额度或账单。
- 翻译结果和视频字幕可能缓存在本地，以减少重复请求；可以随时通过弹窗底部的「清除缓存」删除。
- 前往 Releases 下载最新
.zip包并解压。 - 打开 Chrome，进入
chrome://extensions/。 - 开启右上角的「开发者模式」。
- 点击「加载已解压的扩展程序」，选择解压后的目录。
# 安装依赖
corepack pnpm install
# 开发模式（Chrome）
corepack pnpm dev
# 类型检查与完整测试
corepack pnpm verify
# 构建与打包
corepack pnpm build
corepack pnpm zip项目在 package.json 中声明了 pnpm 版本。建议使用 corepack pnpm ...，确保脚本使用项目声明的包管理器版本和本地依赖。
开发模式请在 Chrome 开发者模式中加载 .output/chrome-mv3-dev；生产构建请加载 .output/chrome-mv3，不要混用两个输出目录。
技术栈：WXT + Vue 3 + TypeScript，Manifest V3。
如果遇到无法翻译、页面漏翻或字幕异常，请先查看扩展内帮助；仍未解决时，可以前往 GitHub Issues 反馈。
OnlyTranslate 基于 FluentRead（流畅阅读） 开发。在保留核心网页翻译能力的基础上，重点补充了视频字幕翻译、识文 / 全页切换和更精简的设置体验。感谢原作者及所有贡献者的开源工作。
本项目遵循 GNU GPL v3.0 协议开源。