在网页上选中文字，一点就译。

官网 · 当前版本 v0.1.4

LA-YEE Web Translate 是一款浏览器翻译插件，支持 Chrome 和 Microsoft Edge。选中文字后，旁边会出现「翻译」按钮，译文流式显示在页面上，不用切标签、不用复制粘贴。

适合大多数使用者的安装步骤

1. 打开 Releases 发布页
2. 下载最新版的 web-translate-vX.X.X.zip（不要下载 Source code）

把 zip 文件解压到任意位置，例如 下载/web-translate/。

解压后文件夹里应有 manifest.json。记住这个文件夹的位置，后面要用。

提示：不要只打开 zip 不解压，Chrome 无法直接加载压缩包。

1. 打开 Chrome，地址栏输入 chrome://extensions/ 回车
2. 打开右上角的 「开发者模式」
3. 点击 「加载已解压的扩展程序」
4. 选中刚才解压出来的那个文件夹
5. 完成！工具栏会出现 Web Translate 图标

如果没看到图标，点浏览器右上角的 拼图图标 → 找到 Web Translate → 点 图钉 固定。

1. 点击工具栏上的 Web Translate 图标
2. 首次使用点 「没有帐号？注册」
3. 填写邮箱、密码；服务器地址保持默认 https://api.la-yee.com
4. 查收验证邮件，点击链接完成验证
5. 回到插件 登录；顶部显示 「已连接」 即可使用

如有好友邀请码，可在注册时填写（选填）。

方法一：点按钮

1. 在任意网页上 选中一段文字
2. 点击选区旁边出现的 「翻译」 按钮
3. 译文会出现在旁边的浮层里

方法二：快捷键

点击插件图标，在弹窗里选择你想翻译成的语言（默认中文）。

Popup 顶部可复制 官网链接 分享给好友；登录后还可查看 我的邀请码，一键复制邀请信息。

选中了文字，但没有出现「翻译」按钮？

• 刷新一下当前网页再试
• 部分页面（如 Chrome 设置页、应用商店）不支持插件运行，这是浏览器限制
• arXiv PDF 页面（/pdf/ 链接）使用浏览器内置 PDF 阅读器，插件无法读取其中的选中文字。请改用 HTML 版本（论文页上的 “HTML” 链接，或 arxiv.org/html/论文编号），在 HTML 页面上即可正常选词翻译
• arXiv / ar5iv HTML 页面若仍无反应，请刷新页面后重试；较新版本已改进对 LaTeX HTML 多行选区的支持

插件显示「未连接」？

• 确认服务器地址为 https://api.la-yee.com
• 检查网络是否正常，退出登录后重新登录
• 仍不行请访问 官网 查看服务状态

快捷键没反应？

• 先选中文字，再按快捷键
• 打开 chrome://extensions/shortcuts，看看有没有和其他插件冲突

怎么更新插件？

1. 从 Releases 下载新版本并解压
2. 打开 chrome://extensions/
3. 找到 Web Translate，点 刷新 按钮（若更换了解压目录，需重新「加载已解压的扩展程序」）

• 只有在你 主动选中文字并点击翻译 时，才会把这段文字发送到服务器
• 登录信息只保存在你的浏览器本地，不会写入网页

以下内容面向希望阅读源码、自行构建或参与贡献的开发者。

• Node.js 18+
• npm 9+

git clone git@github.com:pminimd/WebTranslate-extension.git
cd WebTranslate-extension
npm install
npm run build

构建完成后，产物在 dist/ 目录。在 chrome://extensions/ 中加载 dist/ 文件夹即可。

npm run watch      # 开发时自动重建
npm run typecheck  # 类型检查

extension/
├── docs/               # README 配图（demo.gif 等）
├── manifest.json       # 扩展清单
├── src/
│   ├── background/     # 后台：连接服务器、消息处理
│   ├── content/        # 页面脚本：选词、翻译浮层
│   ├── popup/          # 弹窗：登录、设置
│   └── shared/         # 共享配置与类型
├── scripts/            # 构建脚本
└── dist/               # 构建产物（需本地 build 生成）

插件需要连接 Web Translate 后端才能翻译。

生产环境可在 src/shared/config.ts 中设置 ALLOWED_SERVER_HOSTS 域名白名单，修改后重新 build。

推送版本 tag 后，GitHub Actions 会自动构建并发布安装包：

git tag v0.1.4
git push origin v0.1.4

Release 中会附带 web-translate-vX.X.X.zip，解压后得到 web-translate/ 文件夹，按上方「安装插件」步骤加载即可。

1. Fork 本仓库
2. 创建功能分支
3. 运行 npm run typecheck 确保通过
4. 提交 Pull Request

本项目采用 MIT License（版权方：la-yee）。可自由使用、修改和商用，保留版权声明即可。

www.la-yee.com