Web Highlights Docs

简体中文

English
Deutsch
Español
Português (Brasil)
Français
Tiếng Việt
日本語
한국어

简体中文

English
Deutsch
Español
Português (Brasil)
Français
Tiếng Việt
日本語
한국어

外观

排查 Chrome AI 功能 ​

需要 Chrome 138+ 或较新的 Microsoft Edge（Windows/macOS）

我们的 AI 功能需要 Chrome 138+，或 Windows / macOS 上较新的 Microsoft Edge。请更新浏览器以使用 AI 摘要及所有其他 AI 功能。不确定你的浏览器和操作系统能否运行 AI？见 AI 限制与常见问题。

如果你在 Chrome 中使用 Web Highlights 的 AI 摘要功能时遇到问题，本指南将帮你解决。这些功能依赖 Chrome 的内置 AI 能力，有时会遇到兼容性问题。

浏览器要求 ​

我们的 AI 功能需要浏览器安装本地 LLM（大型语言模型）。Chrome 使用 Google 的 Gemini Nano 模型，Edge 使用 Microsoft 的 Phi-4-mini 模型——两者都直接在你的设备上运行。每个浏览器为其不同的操作系统集合提供模型——见哪些浏览器和系统能运行 AI。

为什么需要下载？ ​

你第一次使用 AI 功能时，浏览器会把模型下载到设备上。下载大约 3–4 GB——一次性，由浏览器管理。

这 22 GB 是空闲空间，不是下载量

除非大约有 22 GB 空闲磁盘空间，否则 Chrome 不会开始下载——但它并不会用掉 22 GB。这个数字是 Chrome 在提交前希望卷上留有的余量；模型本身大约 3–4 GB。（如果之后空闲空间降到 10 GB 以下，Chrome 会移除模型，并在再次有空间时重新下载。）

把模型下载到设备，换来的是：

  • 隐私：数据留在本地
  • 速度：没有云端处理延迟
  • 离线：下载完成后无需网络也能用

你的内容从不会离开设备 🔒

这次下载就是隐私功能。Web Highlights 没有 AI 服务器：你的页面、高亮内容、笔记和问题由自己浏览器内的模型处理——从不为 AI 上传任何内容，甚至不会上传给我们。你可以在浏览器的 DevTools 网络面板中自行验证。模型到位后，AI 甚至可以离线工作。

为什么我们的 AI 以隐私为先 →

Chrome：第一次尝试使用 AI 功能时，会自动下载 Gemini Nano Edge（仅 Windows 和 macOS）：第一次尝试使用 AI 功能时，会自动下载 Phi-4-mini

任一浏览器下载过程中都必须保持浏览器打开。

检查下载状态

在以下位置监控下载进度：

  • Chrome：chrome://on-device-internals/ → 「Model Status」
  • Edge：edge://on-device-internals/ → 「Model Status」

可能需要重启浏览器

下载完成后，可能需要重启浏览器，AI 功能才会可用。

系统要求 ​

实验性功能 ⚠

Chrome 的 AI 功能仍属实验性，在某些系统上可能有兼容性问题。本指南中的解决方案针对用户最常遇到的问题。

Chrome 的 AI 功能需要特定的硬件和软件：

操作系统 ​

列表因浏览器而异，因为各自提供自己的模型：

  • Chrome（Gemini Nano）：✅ Windows 10/11 · ✅ macOS 13+（Ventura 及更高） · ✅ Linux
  • Microsoft Edge（Phi-4-mini）：✅ Windows 10/11 · ✅ macOS 13.3+ · ❌ Linux — Linux 版 Edge 没有设备端模型，因此 AI 功能无法在那里运行。请在 Linux 上改用 Chrome（详情）。
  • ❌ Android、iOS 或 ChromeOS — 任何浏览器尚未提供设备端模型

硬件要求 ​

  • 存储：Chrome 约需 22 GB 空闲空间（Edge 为 20 GB）——这是浏览器开始下载前的阈值；模型本身约 3–4 GB
  • GPU：Chrome 需要超过 4 GB VRAM（没有可用 GPU 时，Google 要求 16 GB RAM 且至少 4 个 CPU 核心）；Edge 需要 5.5 GB 及以上 VRAM
  • 网络：不限流量 / 非按流量计费的连接

常见问题 ​

AI 功能在不安全（http://）页面上无法使用 ​

Chrome 只在安全页面（https://）上暴露内置 AI。在普通 http:// 页面上，设备端模型完全不可用——即使是已安装模型、完全更新的 Chrome。你的浏览器没问题；拦路的是页面。

你可以这样做：

  • 如果网站支持，通过 https:// 重新打开页面
  • 在 Web Highlights 仪表盘 中打开你的高亮内容 — 它始终运行在安全页面上，因此 AI 摘要、聊天和记忆卡片生成可以在那里使用

这是 Chrome 的平台限制（AI API 需要 安全上下文），不是 Web Highlights 的限制。想了解为什么我们的 AI 在你的设备上运行？见为什么我们的 AI 以隐私为先。

「InvalidStateError: The device is unable to create a session to run the model」 ​

此错误通常出现在 Chrome 的 AI 模型（Gemini Nano）未正确安装或配置时。

「The AI model is unavailable. Please try again later.」 ​

这表示 AI 模型尚未准备好使用。

快速修复 ​

1. 启用 Chrome AI 标志（最常见的解决方案） ​

  1. 打开 Chrome 并前往 chrome://flags/
  2. 搜索并启用这些标志：
    • #optimization-guide-on-device-model → 设为：Enabled BypassPerfRequirement
    • Prompt API → 设为：Enabled
    • Summarization API for Gemini Nano → 设为：Enabled
    • #enable-on-device-model → 设为：Enabled
  3. 出现提示时点击「Relaunch」
  4. 再次尝试 AI 功能

2. 检查 Chrome 版本 ​

确保你使用的是 Chrome 138 或更高版本：

  1. 前往 chrome://settings/help
  2. 如有可用更新则更新 Chrome
  3. 重启 Chrome

Apple Silicon 用户 ​

如果你使用带有 Apple Silicon（M1、M2、M3）的 Mac，可能需要使用上面提到的绕过标志，因为 Chrome 有时难以在这些系统上检测 VRAM。

高级故障排除 ​

检查 AI 模型状态 ​

  1. 前往 chrome://on-device-internals
  2. 打开 Model Status 标签页
  3. 查看是否有任何错误消息或状态信息

检查 Optimization Guide 状态 ​

  1. 前往：chrome//components
  2. 找到 Optimization Guide On Device Model
  3. 点击检查更新

监控模型下载 ​

如果模型正在下载：

  1. 下载期间不要关闭 Chrome
  2. 保持触发下载的标签页处于活动状态
  3. 在 chrome://on-device-internals → Model Status 监控进度
  4. 预计下载时间：视网络连接而定，约 5–30 分钟

测试 AI 模型可用性 ​

打开 Chrome DevTools（F12），在控制台中运行此命令：

javascript
await LanguageModel.availability();

预期响应：

  • "unavailable" → 检查系统要求和标志
  • "downloadable" → 可以下载（很好！）
  • "downloading" → 模型正在下载
  • "available" → 模型已就绪可用

替代方案：使用 Chrome Canary ​

Chrome Canary 通常对实验性功能有更好的支持：

  1. 下载 Chrome Canary
  2. 与常规 Chrome 并排安装
  3. 应用相同的 AI 标志
  4. 在那里测试 AI 功能

替代方案：使用 Microsoft Edge ​

Microsoft Edge 使用自己的 AI 模型，不依赖 Chrome 的 Gemini Nano 下载系统，因此在 Chrome 有兼容性问题时它仍可能可用。

如果你在 Windows 或 macOS 上使用 Chrome 的 AI 遇到困难，在 Edge 上安装我们的扩展程序。这在 Linux 上无效——Microsoft 不为 Linux 版 Edge 提供设备端模型（详情）。

完全重置（如果其他方法都无效） ​

彻底移除 Chrome ​

如果问题仍然存在，你可能需要完全移除 Chrome 并重新安装：

  1. 完全关闭 Chrome
  2. 移除 Chrome 应用：
    bash
    sudo rm -rf "/Applications/Google Chrome.app"
sudo rm -rf "/Applications/Google Chrome Canary.app"
  3. 移除 Chrome 数据：
    bash
    rm -rf ~/Library/Application\ Support/Google/Chrome*
rm -rf ~/Library/Caches/Google/Chrome*
rm -rf ~/Library/Preferences/com.google.Chrome*
  4. 重启电脑
  5. 从 google.com/chrome 全新下载并安装 Chrome
  6. 在尝试 AI 功能前先启用 AI 标志

预防提示 ​

  • 保持 Chrome 更新到最新版本
  • 确保有足够存储空间（约 22GB 空闲——如果之后空闲空间降到 10GB 以下，Chrome 会删除模型）
  • AI 模型下载期间不要中断 Chrome
  • 在 Windows/Linux 上留意 GPU VRAM
  • 用稳定的网络连接下载模型

仍然有问题？ ​

如果这些方案都不奏效：

  1. 查看 AI 限制与常见问题 — 你的浏览器或操作系统可能根本不提供模型
  2. 查看 Chrome AI 文档：developer.chrome.com/docs/ai/get-started
  3. 提交 Chrome 错误报告：Chrome Support