• 下载最新的 translate.js 文件

    你可以通过以下网址任选其一,下载最新的 translate.js 文件,放到自己服务器。 Gitee 下载:https://gitee.com/mail_osc/translate/raw/master/translate.js/translate.js Github下载: https://raw.githubusercontent.com/xnx3/translate/refs/heads/master/translate.js/translate.js
  • 常见问题 - 我有多个页面,怎么都能每个页面都能翻译

    比如这种场景: 网站有三个页面: index.html 、about.html 、new.html 这三个页面,这三个页面全部都是中文的。 index.html 已经按照 [快速接入文档](532777 ) 完成了接入,并且能正常使用了。 此时,在 index.html 切换为英文进行浏览,如果点击跳转到 about.html 时,怎么能让 about.html 也能以英文来展示? 这个其实 index.html 怎么加入的 translate.js ,你 about.html 也怎么加入就好了。 不过有一点需要注意: ```` translate.execute(); ```` 这行是起到翻译进行执行的,也就是你加入 translate.js 后,在加入的最后别忘记了这一行代码,不然它是不会被自动翻译的。 ## 原理 你在 index.html 翻译为英文后,translate.js 会自动将你翻译为英文这个动作,及翻译为的语种,存入你的浏览器缓存 (localStorage 的 to 参数) 。 当你跳转到 about.html 页面时,如果触发了 ````translate.execute();```` ,它会自动去你浏览器寻找这个翻译为的目标语种(localStorage 的 to 参数的值),如果发现有值,那么说明你在上个页面已经切换到某个语种进行浏览了,那么在此页面也应该以这个语种浏览,他会自动进行语种翻译,让 about.html 也以这个翻译的目标语种进行浏览。 同样,再点击 new.html 页面时,它依旧会以翻译之后的语种浏览。 此时,如果你在 new.html 页面中切换为 韩语浏览,那么你再点 index.html 进入后,index.html 会以韩语的文字给你观看。 ## 实际使用 实际项目使用,你应该找个公共的尾部(所有页面都使用的尾部)、或者所有页面都会使用的一个js,将 translate.js 有关设置放到这个js、或者公共的尾部里。 这样就避免每个页面都要引入它了
  • 项目上线 - 更换更稳定响应更快翻译更好的大模型翻译通道

    [TOC] 默认不设置翻译通道时,使用的是我们开源的翻译通道,这个翻译通道绝大部分时候都是很正常的,但是毕竟用户基数太大,每日数十亿次的翻译,会有偶然的阻塞变慢的情况。 无服务器的翻译通道,也就是 [translate.service.use('client.edge');](4081.html) 通过这个设置所指定的翻译通道,它是无服务器模式的,没有服务端缓存介入,但是稳定性有一定的保证,在一些通用场景,比如你做了一个开源项目,其他人使用你的开源项目可以拿来直接用,你开源项目里的翻译通道使用这种通道就比较合适了,使用者也不需要提前进行任何配置,真的拿来就能稳定使用了。 **注意,以上两种方式使用的是google、微软的开放翻译服务,数据会外流到海外,对数据安全有要求的一定注意,数据安全请采用下面推荐二的私有部署方式** 这里我们重点推荐的是这两种通道: ## 推荐一:giteeAI 的大模型通道 【推荐,免费开放】 该通道的管理后台为 [http://admin.giteeai.zvo.cn/admin.html](http://admin.giteeai.zvo.cn/admin.html) 它是有 开源中国GiteeAI & 雷鸣云translate.js 联合打造的大模型翻译通道,提供高速、稳定的使用体验 ,大模型自助在线开通使用并启用内存缓存、文件缓存 两层加速的能力,你还可以通过管理后台就能修改某个文本翻译后的译文的文本,非常方便。 为保障资源避免被浪费,当前一个用户只限添加一个网站。如果你有多个网站,请参考 **推荐二私有部署** 的方式,自行部署翻译服务到自己服务器。 免费的企业级翻译通道,将免费提供每日翻译上限为300万的使用量、百万字符的内存级缓存、五百万字符的文件级缓存, 如果你是普通的企业网站,它基本就够了。 如果你想要更高的额度,可以购买相关套餐的方式进行提升。 如何接入使用: #### 1. 免费注册开通 网址: http://admin.giteeai.zvo.cn/admin.html 注意,如果你有邀请码,使用邀请码注册,将获得免费每日300万的翻译上限,而如果不使用邀请码注册,免费的日翻译上限只有100万! 你可以加 [QQ群](4030.html) 向其他群友求助索要邀请码 #### 2. 添加你的域名 注册成功后,进入 域名管理,按照引导提示,查看当前的功能及说明,然后将你的域名添加进去 ![](https://translate.zvo.cn/fileupload/2025/08/26/73f6a7780532497f93655fd8e66ab2b7.png) #### 3. 开通大模型 按照引导提示,冲入10元余额,开通激活按量计算的大模型通道,如下图所示: ![](https://translate.zvo.cn/fileupload/2025/08/26/21bfe3c705224305b1b5328ef856c3b0.png) 它会按照你进行翻译时,实际使用的大模型Tokens自动从你充值的余额扣费。 如果你就完全不想花钱,你记得选 qwen3-8B,这个当下是可以免费给你使用的。 如果你想获得更好的翻译效果及阅读通顺度,你可以选 Qwen3-30B-A3B、或者语种数量相对少一点但价格便宜非常多的腾讯混元大模型 Hunyuan-MT-Chimera-7B (对质量要求非常高,可以选 Qwen3-32B 等尺寸大的模型) #### 4. 在你的网站中接入此翻译通道 然后在你原本接入 translate.js 的地方,只需增加一行代码,即完成接入。 如果你有设置 translate.service.use('client.edge'); 需要你将其改为 : translate.service.use('giteeAI'); 如果你没有设置翻译通道,那就直接在 translate.execute(); 的前面增加一行: translate.service.use('giteeAI'); 如此,就完成了翻译通道的切换。你可以去你这个域名的页面,切换语言试试效果 如下图所示,这里也有此说明 ![](https://translate.zvo.cn/fileupload/2025/08/26/0610bae15c3f4f08ad0ff4d2db6a53b9.png) #### 5. 看使用数据 当你网站进行接入使用后,再回到翻译通道的控制台,刷新一下,即可看到已经产生了具体的数据。 这个也是用来判定你网站是否已经正常接入。 ![](https://translate.zvo.cn/fileupload/2025/08/26/ccf622f93ce341e18ac3c3c0246aa5eb.png) #### 扩展功能. 对翻译后的译文进行修改精调 它本身是一个通用的翻译,如果有的地方你感觉翻译结果不满意,你可以进行手动调整。 比如,下图的页面: ![](https://translate.zvo.cn/fileupload/2025/08/26/0df6ef6c944345a198498dcace68ec26.png) 这里 开启内存缓存 这个文本,正常翻译为英文,是这样的: ![](https://translate.zvo.cn/fileupload/2025/08/26/9076b45b875a4e018cb4474aa46496aa.png) 我想把它改成: kaiqi neicun huancun 那么可以通过翻译通道控制台中的 译文管理 ,来进行调节设置: ![](https://translate.zvo.cn/fileupload/2025/08/26/77c9a0f871b74510ba960f81a0e449d2.png) 如上图,在翻译文本 的输入框中,可以输入前几个字符,来进行搜索这几个字符相关的译文,然后点击右侧的 搜索 按钮,进行搜索跟着几个字有关的译文。 我们这里要修改的是第一个,点击英文的修改按钮 ![](https://translate.zvo.cn/fileupload/2025/08/26/23ab12e3163343ce878090a255f7a7a8.png) 即可打开修改窗口,进行修改 ![](https://translate.zvo.cn/fileupload/2025/08/26/ce1030e1ca0b4a7999b86881cf535076.png) 修改完后,进行保存。 然后,再去网站看一下。不过一定要记得,清除浏览器的缓存: ![](https://translate.zvo.cn/fileupload/2025/08/26/088c515b6e3a49b8a52cd29cbbaf3cc2.png) 通过审核元素 - 应用 - 本地存储空间 ,找到这个网站,在其上右键,出现 清除选项,点击清除。 然后你在刷新这个页面,切换为英文,即可看到,翻译结果已经变过来了: ![](https://translate.zvo.cn/fileupload/2025/08/26/af9759ff10f042c6b2e6ec76d2a4ffee.png) 如此,你已经完成了整个的接入! (提示:每当进行设置译文的内容后,文件缓存的用量会自动给你清空,以保证你的译文修改后的结果实时生效) ## 推荐二:私有化部署翻译服务【收费】 如果您是网络公司,有多个网站(或域名)需要使用,那么推荐一的方式一个账户只限一个的话就太局限了, 你可以私有部署一套相同的服务到自己服务器,可以自由添加多个域名,无上限。 具体私有部署的方式,可参考: [http://translate.zvo.cn/391129.html](https://translate.zvo.cn/391129.html) 这里私有部署完成后,你可以直接访问,按照提示引导,开通 giteeAI 大模型平台的接入,直接使用。 如果你是没有网络环境的场景,也可以私有部署大模型来做无网络环境下的整套自动化翻译切换方案。 另外如果你又没有网络,硬件配置又极低, 我们有专门针对此场景发布的大模型,支持百种语种的翻译,在无GPU的1核2G内存的超低配电脑即可运行 [https://huggingface.co/xnx3/translate100](https://huggingface.co/xnx3/translate100)
  • 快速使用 - 让你最快看到效果,了解它翻译的原理

    ## 快速接入体验 在网页最末尾, ```````` 之前,加入以下代码,一般在页面的最底部就出现了选择语言的 select 切换标签 ```` ```` 点击切换语言,即可快速体验效果。 如果对哪个地方不满意,还可以对其进行精准微调。 任何你所不满意的地方,都可以按照你的心意进行微调。如果不满足,那你告诉我,我们针对性增加这个功能。 **注意, translate.js 请下载到你自己服务器** 为保证你翻译的稳定,请将 translate.js 下载,放到自己服务器上引入,保证翻译js的稳定载入,免得在线的 translate.js 流量高峰时加载慢或无法加载,导致你网页翻译异常。
    从 [gitee](https://gitee.com/mail_osc/translate/raw/master/translate.js/translate.js) 或 [github](https://raw.githubusercontent.com/xnx3/translate/refs/heads/master/translate.js/translate.js) 下载 translate.js 文件放到你自己服务器
    ## 它的原理 它的原理是,对页面的所有node元素进行扫描、识别,将文本进行抽离处理,然后通过调用翻译API接口进行翻译,翻译完毕后,将结果在进行赋予,于是,你就看到了语言切换的效果。 将其加到页面最尾部,也是为了保证当页面渲染后、文本都正常显示出来后,在去对元素进行扫描。 后端翻译开放API接口有我方跟开源中国 GiteeAI 联合定制,针对某些特定场景,比如工厂、政务的无网络环境、以及大企业需要的极高速翻译等,我们也有 [翻译服务私有化部署版本](391129.html) 可供选择。 ## 注意事项 * ````translate.execute();```` 是最终触发翻译的自动执行,如果你只有设置,没有这一行,它是不会触发翻译的。 * 另外如果你当前业务需求不需要页面加载完后自动进行翻译,只需要手动点击按钮后才会触发翻译,那么可以通过点击按钮后触发 ````translate.changeLanguage('english');```` 这个来 [主动进行切换自己想要翻译的语言](4064.html)
  • 谷歌浏览器网页整体翻译插件

    当前 translate.js 已经做成谷歌浏览器插件,可在谷歌内核的浏览器使用,比如 Chrome、Edge 等
    它可直接针对你的网页进行整体翻译。 它的实际效果跟谷歌浏览器的 右键 - 翻译为中文 这个是一样的,但是谷歌浏览器中国境内这个右键翻译不能使用了,这个插件可以完美替代,让你在中国境内也能非常好的翻译整个网页 ## 安装 #### 1. Chrome 应用商店 安装 https://chromewebstore.google.com/detail/translate-web-page/eiaheeageapononkeckimdkkmfdgchll 不过这种安装需要翻墙,中国境内打不开这个网址 #### 2. 插件的离线安装包 http://down.zvo.cn/translate/chrome_plugin/eiaheeageapononkeckimdkkmfdgchll_v3.1.6.crx ## 源码 源码已开源: https://github.com/xnx3/translate/tree/master/extend/chrome_plugin
  • translate.js v2 升级 v3 注意事项

    首先,v2版本可完美升级到v3版本,无需做任何别的变动。 其次,v3版本感谢微软为此提供的翻译服务、感谢七牛云提供全球CDN加速服务。我们还是建议您进行以下方式的操作: ## 操作方式 ##### 1. 更换translate.js 的 CDN源【非必须】 如果您之前使用的是 ```` http://res.wang.market/translate/translate.js ```` 这个是放在了香港服务器,并未做全球cdn加速,建议您可以更换为七牛云提供的全球CDN加速的: ```` https://cdn.staticfile.net/translate.js/3.1.5/translate.js ```` ##### 2. 增加 client.edge 设定【非必须】 在 translate.execute() 前,加入一行 ```` translate.service.use('client.edge'); ```` 设置翻译通道不在依赖translate.service,而是直接有微软提供支持。注意的是 client.edge 支持 73 种翻译语种。 详细说明参见 [http://translate.zvo.cn/43086.html](http://translate.zvo.cn/43086.html) ## 说明 * v3版本增加了[翻译服务通道](43086.html)的设定,但是这种模式相比v2版本的,它的缺点是语种少了几十个,v2版本支持一百二十来个语种,而v3版本这个当下只是支持七十多个语种,当然常用的语种肯定是包含了的。两种版本支持的语种对比: [V3版本 client.edge 支持的语种](https://api.translate.zvo.cn/language_edge.json) | [V2版本 translate.service 支持的语种](https://api.translate.zvo.cn/language.json) * v2版本的翻译服务有私有部署的 translate.service 提供,也就是translate.js本身是脱离不了 translate.service 翻译服务的,而v3版本的翻译服务核心不再依赖 translate.service 翻译服务,有微软直接提供翻译服务,即使 translate.service 翻译服务宕机,也不会影响 translate.js 的正常使用 * 不再有日翻译字符上限!就算你网站一天翻译一百亿字符都可以。但是如果手动设置了 translate.service.use('translate.service'); 进行强制指定翻译服务有 translate.service 提供,那么还是有每日翻译上限额,并且每日翻译上限有2023年的每日500万字符上限,会进行逐步降低,目前暂定降低策略为2024.4.1日每日300万字符的上限,2024.6.1日每日 100万字符上限。 建议升级到 client.edge 的方式,享受翻译无字符上限。 * 使用它后,不再给你网址进行翻译字符数统计(因为不再有字符限制了) * 使用它后,不再局限于本地的几种语种了,例如你可以在日文网站上用(还需待大量实践验证) * 使用它后,你的翻译语句更通顺了,比如它来翻译文档或者小说,更易于阅读了。 * 拥有更好的自动容错能力,你对前端不需要太了解,就能非常好的把它植入你的网站中 这里变动的主要由于支持语种有一百二十多种降低到七十多种,如果您在使用时,有过自定义切换语种,并且自定义切换语种的界面所支持的语种比较多,那么您需要对比一下您自定义的语种是否在v3中有支持。如果您普通的使用比如英文、简体中文、繁体中文、法语、德语、俄语 等常用语种,那么肯定都是支持的,如果您切换语种非常多,有些非常不常见的语种,那么您需要进行跟v3的语种对比看看,免得这个切换的语种在v3中再不支持。 至于其他的没有什么不同,v2版本可无缝升级v3,无需任何其他改动 ## 感谢 v3版本的机器翻译服务有微软提供 v3版本的 translate.js 全球高速cdn通道有七牛云提供 服务器香港/美国 节点分别有指点云、AO3读者提供