AI 学习经验
不用调云端 API:用 Chrome 内置 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 阅读原文后整理,未经人工逐字核对,内容以原文为准。
登录后可以点赞、查看和发表评论