一款 Chrome 浏览器扩展，专为 WhatsApp Web（https://web.whatsapp.com）设计，提供三大核心能力：
- 自动翻译：对方发来的非中文消息会自动在气泡下方追加中文译文
- 一键翻译发送：你在输入框写中文 → 点「翻译」→ 预览 → 点「替换」→ 发送
- AI 润色：填入自己的 AI Key 后，点「润色」让文字更地道
- 下载源码
- 解压
whatsapp-translator.zip到任意目录，例如D:\whatsapp-translator - 打开 Chrome 浏览器，地址栏输入
chrome://extensions - 右上角打开「开发者模式」开关
- 点击「加载已解压的扩展程序」，选择解压出来的
whatsapp-translator文件夹 - 浏览器右上角会出现本扩展的图标（绿色对话气泡，带"文A"字样）
- 打开 https://web.whatsapp.com 扫码登录，扩展将自动开始工作
也支持 Edge（
edge://extensions）和 Brave（brave://extensions）等所有 Chromium 内核浏览器。
- 对方在 WhatsApp Web 中发来的非中文消息，会在气泡下方追加一行灰色译文
- 源语言由 Unicode 字符集自动识别（无需配置）
- 可在弹窗中关闭该开关
在输入框中输入中文后，输入框上方会出现三个按钮：
| 按钮 | 作用 |
|---|---|
| 翻译 | 把当前输入框的中文翻译为对方语言，结果显示在预览区 |
| 替换 | 把预览区的译文替换进输入框（替换后即可按回车发送） |
| 润色 | 调用 AI 让当前输入框的文字更地道（需先配置 AI Key） |
目标语言判断逻辑：
- 默认「自动检测」—— 根据对方最近一条消息自动判断
- 也可在弹窗中固定为某种语言（如英语、日语、俄语等）
- 在「设置」页面填入 OpenAI 兼容协议的 API Key（支持 OpenAI / DeepSeek / 硅基流动 / Moonshot / 智谱 / Ollama 等）
- 润色会保留原语言：输入中文润色为更地道的中文，输入英文润色为更地道的英文
- 三种风格可选：自然流畅 / 正式商务 / 口语化
- 点击浏览器右上角的扩展图标 → 点「配置 AI Key 与润色设置」
- 填写：
- API Key：在服务商控制台创建（如 https://platform.openai.com/api-keys）
- Base URL：默认
https://api.openai.com/v1 - 模型：默认
gpt-4o-mini，建议用便宜速度快的小模型即可 - 润色风格：按需选择
- 点击「测试连通性」验证 Key 是否有效
- 点击「保存设置」即可使用润色功能
预设按钮：设置页面下方提供 6 个一键预设（OpenAI、DeepSeek、硅基流动、Moonshot、智谱 GLM、本地 Ollama），点击即可自动填充 Base URL 和模型名，只需手动填入 API Key。
- API Key 通过 Chrome 的
chrome.storage.sync加密同步保存，仅在你登录的浏览器账户间同步 - 不向扩展开发者或任何第三方服务器发送 Key
- 所有 AI 调用均从你的浏览器直连服务商
- 自动翻译使用 Google 翻译免费公共端点，不消耗 AI Token
whatsapp-translator/
├── manifest.json # 扩展清单（Manifest V3）
├── background.js # Service Worker（设置同步）
├── content/
│ ├── content.js # 内容脚本（核心逻辑）
│ └── content.css # 注入样式
├── lib/
│ ├── detector.js # 语言检测（Unicode 启发式）
│ ├── translator.js # Google 翻译封装
│ └── ai.js # AI 润色封装（OpenAI 兼容）
├── popup/
│ ├── popup.html # 弹窗 UI
│ ├── popup.js # 弹窗逻辑
│ └── popup.css # 弹窗样式
├── options/
│ ├── options.html # 设置页 UI
│ ├── options.js # 设置页逻辑
│ └── options.css # 设置页样式
└── icons/
├── icon16.png
├── icon48.png
└── icon128.png
Q1：扩展加载后看不到翻译效果？ A：请刷新 WhatsApp Web 标签页（Ctrl+R / Cmd+R），确保 content script 重新注入。
Q2：自动翻译一直显示"翻译中…"或失败？
A：可能是网络访问 Google 翻译受限。可尝试在 Chrome 设置中开启"使用安全 DNS"，或在网络代理中允许 translate.googleapis.com。
Q3：润色按钮没反应？ A：请先在设置页填入 API Key 并保存。如已填入仍报错，点击「测试连通性」查看具体错误信息。
Q4：替换功能没把内容替换进输入框？ A：WhatsApp Web 的输入框是 contenteditable，部分情况下需要先点一下输入框激活焦点，再点替换。
Q5：支持 Firefox 吗？
A：当前版本基于 Manifest V3 + Chrome Extensions API，Firefox 需要做适配（主要差异在 chrome.* → browser.* 与 manifest 兼容性）。如有需要可后续提供。
Q6：会泄露我的聊天内容吗？ A：扩展只在本地处理消息文本，自动翻译走 Google 翻译公共端点，润色走你自己配置的 AI 服务商。扩展本身不收集、不上传任何数据。
- v1.0.0（2026-06-22）首发版本