学习精选 · AI 工具
AI 学习经验

不用调云端 API:用 Chrome 内置 AI 在本地搭一个翻译器

freeCodeCamp2026-11-17约 4 分钟读完AI 整理查看原文

Chrome 138+ 自带 Translator 和 Language Detector 两个 API,模型由浏览器按需下载、在用户设备上运行,没有按次计费,文本也不出设备。这篇教程用 Next.js 从零搭一个支持自动检测语言、流式输出、下载进度和降级处理的翻译应用,并讲清了四个必须绕开的限制。

今天就能做

  • 在桌面 Chrome 打开 Built-in AI Playground,先手动试试语言检测的置信度和语言包下载流程
  • 新项目里跑 npx create-next-app 加 npm install -D @types/dom-chromium-ai,十分钟就能跑通第一个本地翻译调用
  • 给现有应用加翻译功能时,先检查 availability() 的四种返回值并设计好降级 UI,再考虑功能本身

先分清 i18n 和 AI 翻译

  • i18n 处理界面文案、日期货币格式、RTL 布局等预先写好的内容,AI 翻译适合评论、客服消息等没人提前写过的用户生成内容
  • 两者是互补关系,按钮和菜单仍需要人工审校的固定文案,Translator API 填补的是其余场景
  • 典型用例:客服聊天里用户用母语发消息,网站在消息离开设备前就翻译成客服语言

两个 API 怎么协作

  • LanguageDetector 返回按置信度排序的语言列表,分数在 0 到 1 之间;Translator 则针对一个语言对(如英译西)创建实例
  • 模型和语言包由 Chrome 按需下载,首次翻译某个语言对会触发下载,之后复用
  • 调用流程是先查 availability() 再 create(),全程异步且可监听下载进度
  • 短文本检测准确率低,官方建议先在 Built-in AI Playground 里对比单词和整句的置信度

四个设计约束

  • 需要用户手势(如点击)才能在触发下载时创建 translator 或 detector
  • 两个 API 都不能在 Web Worker 里用,只能在主线程调用(模型推理本身不阻塞 UI)
  • 翻译是串行处理的,大请求会阻塞后续请求,需要分块并显示加载状态
  • 默认只在顶层窗口和同源 iframe 可用,跨域 iframe 需要 Permissions Policy

动手搭建的关键步骤

  • 环境要求 Node.js 20.9+ 和桌面版 Chrome 138+(Edge 148 也支持),移动端和 Firefox、Safari 均不可用
  • 安装 @types/dom-chromium-ai 获得 TypeScript 类型定义,编辑器即可自动补全 Translator.create()
  • 目录按职责分层:lib/ 封装 Chrome API 调用,hooks/ 转成 React 状态,components/ 放 UI
  • 语言列表硬编码了 39 种语言的 BCP 47 代码(如 zh、zh-Hant),阿拉伯语和希伯来语标记 rtl 以支持从右到左渲染

可用性状态与隐私细节

  • availability() 返回四种值:unavailable、downloadable、downloading、available,UI 要分别处理
  • Chrome 为保护隐私会隐藏具体语言对的下载状态:在你为某个语言对创建 translator 之前,所有语言对都报告为 downloadable
  • 不支持这些 API 的浏览器要有降级提示组件,教程里用 unsupported-notice 处理

上线前要知道的局限

  • 语言支持列表是 Chrome 特定实现且可能变动,目前没有动态获取的接口,所以每次翻译前仍要调 availability()
  • 教程还实现了流式输出、复制、朗读、语言互换和取消下载等完整交互,代码在 freeCodeCamp 仓库中

原文:How to Build a Translator with Chrome’s Built-In AI

来源:freeCodeCamp · 2026-11-17

查看原文

本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。

登录后可以点赞、查看和发表评论