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

一站式接入主流 AI 大模型，支持对话 · 生图 · 生视频，即开即用

ChatGPT Claude Gemini Grok DeepSeek 通义千问 Ollama

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+ 系统

二、开启核心功能开关（Flags配置）

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功能。

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

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

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

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

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

五、搭建可视化聊天界面（带完整功能）

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

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

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

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>Gemini Nano 本地聊天</title>
  <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
  
</head>
<body>
<div class="header">
  <h3>Gemini Nano 本地聊天</h3>
  <button class="clear-btn" onclick="clearChat()">清空对话</button>
</div>

<div class="chat-container" id="chat"></div>
<div class="input-area">
  <input id="input" placeholder="输入消息..." autocomplete="off">
  <button onclick="send()">发送</button>
</div>

<script>

let session;

// 初始化AI会话
(async () => {
  if (!window.LanguageModel) {
    add("❌ 浏览器不支持 Gemini Nano", "bot");
    return;
  }
  if (await LanguageModel.availability() !== "available") {
    add("⚠️ Gemini Nano 模型未就绪", "bot");
    return;
  }
  // 适配Chrome148 唯一有效语法
  session = await LanguageModel.create({ language: "en" });
  add("✅ Gemini Nano 已连接，可以聊天", "bot");
})();

// 发送消息
async function send() {
  const i = document.getElementById("input");
  const t = i.value.trim();
  if (!t || !session) return;
  add(t, "user");
  i.value = "";
  add("思考中...", "bot", true);
  try {
    const r = await session.prompt(t);
    document.querySelector(".loading")?.remove();
    add(r, "bot");
  } catch (e) {
    document.querySelector(".loading")?.remove();
    add("❌ 错误：" + e.message, "bot");
  }
}

// 清空对话功能
function clearChat() {
  const c = document.getElementById("chat");
  c.innerHTML = "";
  add("✅ 对话已清空", "bot");
}

// 回车快捷发送
document.getElementById("input").addEventListener("keypress", e => e.key === "Enter" && send());
</script>
</body>
</html>