Chrome 148 正式版 Gemini Nano 本地AI完整使用教程

Gemini Nano 是 Chrome 内置的本地端轻量大模型，无需联网、无需API密钥，所有对话推理均在本地设备完成，响应速度快、隐私性极强。本文针对Chrome 148 正式版（x86_64）编写，解决新版API变更、控制台警告、组件缺失、window.ai 未定义等全部常见问题，全程实操、零冗余步骤。

一、前置必备条件（缺一不可）

1. 浏览器版本要求

必须使用 Chrome 128+ 版本，推荐 Chrome 148 正式版（本文适配版本），不支持极速版、改版Chrome、无痕/访客模式。查看版本：地址栏输入 chrome://settings/help。

截图参考：Chrome版本查看界面，确认版本号≥148正式版

2. 基础环境要求

• 账号：Chrome 必须登录有效 Google 账号
• 存储：系统盘剩余空间 ≥22GB（模型文件约4GB）
• 网络：无需联网，完成模型下载后即可使用
• 设备：支持 Windows10/11、macOS 13+ 系统

Chrome 默认隐藏 Gemini Nano 功能，需手动开启两个核心参数，配置后必须重启浏览器生效。

1. 开启模型绕过性能检测

地址栏输入：chrome://flags/#optimization-guide-on-device-model

下拉选择：Enabled BypassPerfRequirement（必须选择带Bypass选项，普通Enabled无效）

截图参考：该Flag配置页面，选中 Enabled BypassPerfRequirement 选项

2. 开启Prompt AI接口

地址栏输入：chrome://flags/#prompt-api-for-gemini-nano

下拉选择：Enabled

截图参考：Prompt API开关页面，设置为Enabled状态

3. 生效配置

点击页面右下角 Relaunch 重启浏览器，完全关闭所有Chrome进程后重新打开，确保配置生效。

三、安装/更新AI模型组件

1. 调取组件列表

地址栏输入：chrome://components

查找 Optimization Guide On Device Model 组件：

• 无该组件：重启浏览器、刷新组件页面，即可正常加载
• 版本为0.0.0.0：点击「检查更新」，等待模型自动下载（约5-10分钟）
• 版本 ≥2024.5.21.1031 为有效版本

截图参考：chrome://components页面，显示Optimization Guide On Device Model组件

2. 确认模型就绪状态

地址栏输入：chrome://on-device-internals/

显示 Foundational model state: Ready 即代表模型下载完成、加载就绪，支持GPU加速推理，可正常使用AI功能。

截图参考：模型就绪页面，展示Ready就绪状态

四、关键适配：Chrome148新版API规则

Chrome 148 正式版彻底废弃旧版 window.ai API，新版统一使用 LanguageModel API，且存在强制规则：

1. 不支持 zh 中文参数，仅支持官方指定3种语言：en（英文）、es（西班牙语）、ja（日语）
2. 必须在 LanguageModel\.create\(\) 中传入 language:en 消除控制台警告
3. 禁止在 chrome:// 页面、空白页、本地file文件测试，必须在 localhost/HTTPS安全上下文 运行

提供成品聊天页面，支持Markdown渲染、代码高亮、清空对话、回车发送、加载提示，屏蔽官方冗余警告，开箱即用。

1. 完整代码（直接复制保存）

新建文件命名为index\.html，粘贴以下全部代码：

  charset="UTF-8">  Gemini Nano 本地聊天    
header"> Gemini Nano 本地聊天 清空对话 

container" id="chat">

area"> 发送 

2. 启动本地服务运行

1. 将文件放在空文件夹中，打开终端，进入文件夹目录
2. 执行命令启动本地服务：python3 \-m http\.server 8000
3. 浏览器访问：http://localhost:8000，即可开始本地AI对话

截图参考：本地服务启动命令、浏览器聊天界面最终效果

六、核心功能说明

• 本地离线推理：无需联网，所有对话、代码生成、文案创作均在本地完成
• Markdown完美渲染：支持代码块高亮、标题、列表、加粗、引用等语法
• 便捷操作：支持点击清空全部对话、回车发送消息、实时加载提示
• 无冗余警告：内置脚本屏蔽Chrome官方强制语言提示，控制台干净无报错

1. window.ai is undefined

原因：Chrome148 正式版已废弃旧API，不再支持 window.ai，必须使用新版 LanguageModel API，按本文代码替换即可解决。

2. 找不到 Optimization Guide On Device Model 组件

解决方案：完全重启Chrome、重新刷新组件页面，强制触发组件注册与更新，无需特殊网络即可加载。

4. 模型状态异常、无法响应

解决方案：检查磁盘空间、重启浏览器进程，等待模型完全加载为Ready状态即可。

八、使用注意事项

• 禁止在无痕模式、chrome://页面、本地file文件运行API，仅支持localhost和HTTPS安全域名
• 模型首次加载较慢，后续对话响应极速，无需重复下载
• 虽然配置语言为英文参数，但模型完全支持中文对话输出
• 关闭广告拦截、隐私类扩展，避免拦截AI接口注入