AI Extension 扩展插件安装指南 本文档将详细介绍如何在 Chrome/Edge 浏览器中通过本地安装模式安装和使用 AI Extension 浏览器扩展插件。
概述 AI Extension 是一个基于 WXT 框架开发的浏览器扩展插件，它提供了 MCP（Model Context Protocol）工具调用功能，允许 AI 助手通过浏览器扩展与网页进行交互。本文档介绍的是本地安装模式，即不通过浏览器插件市场安装，而是直接下载并安装扩展文件。
前置要求 在开始安装之前，请确保你的浏览器满足以下要求：
浏览器要求 由于扩展使用了 userScripts API，需要以下最低浏览器版本：
Chrome：>= 120.0.0Microsoft Edge：>= 120.0.0其他基于 Chromium 的浏览器：版本 >= 120.0.0（基于 Chromium 120+）重要提示：userScripts API 是 Chrome 120 中引入的新特性，用于在页面的主世界（Main World）中执行脚本。如果你的浏览器版本低于 120，请先更新浏览器。
下载扩展 获取扩展文件 访问扩展下载地址，下载扩展 ZIP 文件：
下载地址：https://docs.opentiny.design/download/extension-0.0.1.zip
下载完成后，你会得到一个 ZIP 压缩文件，例如 extension.zip。
解压扩展文件 找到下载的 ZIP 文件右键点击 ZIP 文件，选择"解压到当前文件夹"或"解压到..."解压后会得到一个文件夹，例如 extension 或 chrome-mv3注意：请记住解压后的文件夹位置，后续安装时需要选择这个文件夹。
安装扩展 Chrome 浏览器安装步骤 步骤一：打开扩展管理页面 打开 Chrome 浏览器在地址栏输入 chrome://extensions/ 并回车或者点击浏览器右上角的三点菜单 → 更多工具 → 扩展程序步骤二：启用开发者模式 在扩展管理页面的右上角，找到"开发者模式"开关将开关切换到"开启"状态
步骤三：加载扩展 点击"加载已解压的扩展程序"按钮在文件选择对话框中，导航到解压后的扩展文件夹选择扩展文件夹（包含 manifest.json 文件的文件夹）并点击"选择文件夹"
步骤四：开启 User Scripts 权限（重要） 如果扩展中使用了 pageMcpServer 类型的 MCP 工具，必须开启 User Scripts 权限：
在扩展管理页面，找到已安装的扩展卡片点击扩展卡片上的"详细信息"或展开按钮找到"User Scripts"或"用户脚本"选项将开关切换到"开启"状态
注意：如果未开启 User Scripts 权限，pageMcpServer 类型的工具将无法正常工作，扩展会显示通知提示你开启此权限。
步骤五：确认安装 扩展加载成功后，会在扩展管理页面显示 检查扩展是否已启用（开关处于开启状态）检查 User Scripts 权限是否已开启（如果使用了 pageMcpServer 类型的工具）如果扩展图标显示在浏览器工具栏，说明安装成功Microsoft Edge 浏览器安装步骤 步骤一：打开扩展管理页面 打开 Microsoft Edge 浏览器在地址栏输入 edge://extensions/ 并回车或者点击浏览器右上角的三点菜单 → 扩展步骤二：启用开发人员模式 在扩展管理页面的左侧边栏，找到"开发人员模式"开关将开关切换到"开启"状态步骤三：加载扩展 点击"加载解压缩的扩展"按钮在文件选择对话框中，导航到解压后的扩展文件夹选择扩展文件夹（包含 manifest.json 文件的文件夹）并点击"选择文件夹"步骤四：开启 User Scripts 权限（重要） 如果扩展中使用了 pageMcpServer 类型的 MCP 工具，必须开启 User Scripts 权限：
在扩展管理页面，找到已安装的扩展卡片点击扩展卡片上的"详细信息"或展开按钮 找到"User Scripts"或"用户脚本"选项将开关切换到"开启"状态注意：如果未开启 User Scripts 权限，pageMcpServer 类型的工具将无法正常工作，扩展会显示通知提示你开启此权限。
步骤五：确认安装 扩展加载成功后，会在扩展管理页面显示检查扩展是否已启用（开关处于开启状态）检查 User Scripts 权限是否已开启（如果使用了 pageMcpServer 类型的工具）如果扩展图标显示在浏览器工具栏，说明安装成功其他 Chromium 浏览器 其他基于 Chromium 的浏览器（如 Brave、Opera 等）的安装步骤与 Chrome 类似：
打开浏览器的扩展管理页面（通常在设置或菜单中）启用开发者模式加载已解压的扩展程序选择解压后的扩展文件夹扩展权限说明 扩展需要以下权限才能正常工作，安装扩展时会自动请求这些权限：
storage：用于存储扩展数据tabs：用于管理浏览器标签页activeTab：用于访问当前活动标签页scripting：用于注入脚本contextMenus：用于添加上下文菜单userScripts：用于执行用户脚本（重要：如果使用了 pageMcpServer 类型的工具，必须手动开启此权限）notifications：用于显示通知host_permissions：*://*/*（访问所有网站，用于支持在不同网站上使用 MCP 工具）安装扩展时，浏览器会提示你授予这些权限，请点击"允许"以完成安装。
User Scripts 权限说明 重要：如果扩展中使用了 pageMcpServer 类型的 MCP 工具，必须在扩展管理页面手动开启 User Scripts 权限。
为什么需要开启 User Scripts 权限？
pageMcpServer 类型的工具需要在页面的主世界（Main World）中执行脚本传统的 Content Script 运行在隔离环境中，无法访问页面的全局变量和 JavaScript 上下文User Scripts API 允许扩展在页面的主世界中执行脚本，从而可以访问页面的完整 JavaScript 环境如何开启 User Scripts 权限？
打开扩展管理页面（chrome://extensions/ 或 edge://extensions/）找到已安装的扩展卡片点击扩展卡片上的"详细信息"或展开按钮找到"User Scripts"或"用户脚本"选项将开关切换到"开启"状态如何判断是否需要开启 User Scripts 权限？
如果扩展中使用了 pageMcpServer 类型的工具，需要开启此权限如果扩展中只使用了 contentScriptMcpServer 类型的工具，不需要开启此权限未开启 User Scripts 权限会怎样？
扩展会显示通知提示你开启 User Scripts 权限pageMcpServer 类型的工具将无法正常工作工具调用会失败，并显示错误信息使用扩展 打开侧边栏 在任意网页上，点击浏览器工具栏中的扩展图标或者右键点击扩展图标，选择"打开侧边栏"侧边栏会在浏览器右侧打开，显示 AI 对话框使用 AI 助手 在侧边栏的 AI 对话框中输入你的问题或指令AI 助手会根据当前网页的上下文，调用相应的 MCP 工具工具执行完成后，AI 助手会返回执行结果更新扩展 更新步骤 访问扩展下载地址，下载最新版本的扩展 ZIP 文件在扩展管理页面，找到已安装的扩展点击扩展卡片上的"移除"按钮，卸载旧版本的扩展解压新下载的 ZIP 文件按照"安装扩展"步骤重新加载新版本的扩展注意：更新扩展会清除扩展的存储数据，如果扩展使用了 localStorage 或 chrome.storage，数据会被清除。
调试扩展 查看扩展日志 后台脚本日志 在扩展管理页面，找到扩展卡片点击"背景页"或"Service Worker"链接在打开的开发者工具中查看控制台日志内容脚本日志 在任意网页上，按 F12 打开开发者工具在控制台中查看内容脚本的日志日志前缀通常包含扩展名称侧边栏日志 打开扩展侧边栏在侧边栏中右键点击，选择"检查"在打开的开发者工具中查看控制台日志使用 Chrome DevTools 在扩展管理页面，找到扩展卡片点击"检查视图"链接在打开的开发者工具中调试扩展常见问题排查 问题一：扩展无法加载 可能原因：
扩展文件夹路径错误或文件夹不存在manifest.json 文件格式错误扩展文件损坏或不完整解决方法：
检查扩展文件夹是否存在且路径正确检查 manifest.json 文件是否存在且格式正确重新下载扩展 ZIP 文件并解压问题二：扩展无法正常工作 可能原因：
扩展权限未授予网页不支持扩展功能浏览器版本过低解决方法：
检查扩展权限是否已授予检查当前网页是否支持扩展功能检查浏览器版本是否满足要求（>= 120.0.0）问题三：工具调用失败 可能原因：
MCP 服务器工具未正确注册工具参数不正确网页 DOM 结构发生变化解决方法：
查看扩展日志，检查 MCP 服务器工具是否正确注册检查工具参数是否正确检查网页 DOM 结构是否匹配卸载扩展 临时卸载 在扩展管理页面，找到扩展卡片点击扩展卡片上的开关，将扩展切换到"关闭"状态扩展会被禁用，但不会删除永久卸载 在扩展管理页面，找到扩展卡片点击"移除"按钮在确认对话框中点击"移除"扩展会被完全移除安全注意事项 1. 权限请求 扩展会请求访问所有网站的权限（*://*/*），这是为了支持在不同网站上使用 MCP 工具。如果你对扩展的权限有疑问，可以在安装前查看扩展的权限说明。
2. 来源可信 请从官方提供的下载地址下载扩展，确保扩展文件来源可信，避免安装恶意扩展。
3. 定期更新 定期检查扩展更新，下载最新版本的扩展，以确保使用最新功能和安全补丁。
总结 通过本文档，你应该已经了解了如何：
下载扩展 ZIP 文件解压扩展文件在 Chrome/Edge 浏览器中安装扩展使用扩展功能更新和卸载扩展调试扩展问题如果你在安装或使用过程中遇到问题，可以参考本文档的"常见问题"部分，或查看扩展的日志信息进行排查。
相关文档 mcp-servers 扩展插件工具开发指南NEXT-SDKs API 文档接入三方 AI 应用技术支持 如果你需要技术支持或反馈问题，可以通过以下方式联系：
提交 Issue 到项目仓库查看项目文档联系项目维护者