Page Assist：本地AI浏览器扩展使用指南

Page Assist 是一款本地AI浏览器扩展，让你无需依赖云端服务即可在网页浏览过程中获得AI辅助。这款工具将强大的人工智能能力直接集成到你的浏览器中，支持隐私保护的离线交互，所有数据处理均在本地完成，无需上传个人信息至第三方服务器。通过直观的侧边栏和Web界面，你可以随时随地调用本地运行的AI模型，提升信息处理效率与网页交互体验。

新手入门通道：快速安装本地AI助手

商店一键安装

Page Assist 提供官方签名的浏览器扩展版本，支持主流浏览器平台：

• Chrome/Edge 用户：访问浏览器应用商店，搜索"Page Assist"并点击"添加至浏览器"
• Firefox 用户：在Firefox附加组件市场中找到"Page Assist"进行安装

安装完成后，浏览器工具栏将出现Page Assist图标，点击即可启动应用。首次使用时，系统会引导你完成基础配置，包括选择本地AI服务提供商（如Ollama、LM Studio等）。

验证安装状态

成功安装后，你可以通过以下方式确认扩展是否正常工作：

1. 打开任意网页
2. 使用快捷键 Ctrl+Shift+P 尝试调出侧边栏
3. 如看到Page Assist加载界面，则表示安装成功

⚠️ 注意事项：如果无法启动，请检查浏览器扩展权限设置，确保Page Assist拥有"读取网页内容"和"存储数据"权限。

开发者模式：从源码构建AI扩展

对于需要自定义功能或参与开发的用户，Page Assist提供完整的源码构建方案。这种方式允许你根据需求调整代码，并体验最新开发特性。

环境准备

在开始构建前，请确保你的开发环境满足以下要求：

• Node.js v18.0.0 或更高版本
• npm 或 yarn 包管理器
• Git 版本控制工具
• 本地AI服务（如Ollama）已安装并运行

完整构建流程

# 克隆项目仓库
git clone https://gitcode.com/GitHub_Trending/pa/page-assist
cd page-assist

# 安装依赖包
npm install

# 构建Chrome版本
npm run build

# 构建结果将输出到build目录
ls build
# 预期输出: assets  background.js  content.js  icons  manifest.json  popup.html

⚠️ 构建提示：如果需要构建Firefox版本，使用 npm run build:firefox 命令，该版本会生成适配Firefox扩展系统的 manifest.json 文件。

浏览器加载流程

Chrome/Edge加载步骤：

1. 打开浏览器，访问 chrome://extensions/
2. 开启右上角"开发者模式"开关
3. 点击"加载已解压的扩展程序"
4. 选择项目目录下的 build 文件夹

Firefox加载步骤：

1. 打开浏览器，访问 about:debugging#/runtime/this-firefox
2. 点击"临时载入扩展"
3. 导航至项目 build 目录，选择 manifest.json 文件

加载完成后，扩展将保持激活状态，直至浏览器关闭。如需永久使用开发版本，可在Firefox开发者版中签名扩展。

核心功能：激活你的AI浏览助手

Page Assist提供多种交互方式，满足不同场景下的AI辅助需求。无论是快速查询、深度分析还是内容生成，都能通过直观的界面和快捷键实现。

激活AI侧边栏

⚡️ 高效访问：使用快捷键 Ctrl+Shift+P 可在任意网页快速激活侧边栏，无需离开当前浏览上下文。侧边栏提供以下核心功能：

• 🔍 网页内容分析：自动提取当前页面关键信息
• 💬 即时对话：直接向AI提问关于当前页面的问题
• 📝 内容生成：基于页面内容创建摘要、笔记或扩展内容

侧边栏支持收起/展开操作，点击顶部折叠按钮可将其最小化至侧边，再次点击恢复显示。

使用Web UI模式

对于需要更大工作空间的场景，Page Assist提供独立的Web界面：

1. 点击浏览器工具栏中的Page Assist图标
2. 选择"打开Web界面"选项，或使用快捷键 Ctrl+Shift+L
3. 系统将在新标签页中打开完整Web UI

Web UI提供更丰富的功能，包括历史对话管理、知识库配置和高级模型设置等。界面布局分为左侧导航栏、中间对话区和右侧工具栏，支持自定义主题和字体大小。

自定义快捷键

为提升操作效率，Page Assist允许用户自定义所有功能的快捷键：

1. 在Web UI中点击右上角设置图标
2. 选择"快捷键配置"选项
3. 点击对应功能的输入框，按下新的按键组合
4. 点击"保存"应用更改

默认快捷键设置可在 src/hooks/keyboard/useKeyboardShortcuts.tsx 文件中查看，高级用户可直接修改该文件自定义快捷键逻辑。

功能对比矩阵：浏览器兼容性一览

Page Assist在不同浏览器中支持的功能略有差异，以下是主要浏览器的兼容性矩阵：

功能	Chrome	Firefox	Edge	Brave	Vivaldi
侧边栏交互	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持
网页内容分析	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持
Web UI界面	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持
快捷键自定义	✅ 完全支持	⚠️ 部分支持	✅ 完全支持	✅ 完全支持	✅ 完全支持
本地模型集成	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持
离线工作模式	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持	✅ 完全支持

⚠️ 兼容性说明：Firefox对部分高级快捷键自定义支持有限，特别是与浏览器默认快捷键冲突的组合。建议Firefox用户在设置时避开 Ctrl+T、Ctrl+W 等浏览器保留快捷键。

高级扩展指南：定制你的AI助手

Page Assist提供丰富的扩展接口，允许开发者或高级用户根据需求定制功能。通过事件通信系统，你可以将AI能力集成到其他网页应用中，或开发自定义插件扩展核心功能。

事件通信系统

Page Assist采用基于Chrome/Firefox扩展API的事件通信架构，主要包含三个层次：

1. 背景脚本：维护全局状态和长期运行的任务
2. 内容脚本：与网页DOM交互，提取内容和注入UI
3. 侧边栏/Web UI：用户交互界面，处理用户输入和显示结果

这些组件通过消息传递进行通信，形成一个松耦合的系统架构。

核心事件类型

Page Assist定义了多种标准事件，用于不同组件间的通信：

• PAGE_ASSIST:ACTIVATE - 激活侧边栏事件
• PAGE_ASSIST:ANALYZE_CONTENT - 分析网页内容事件
• PAGE_ASSIST:CHAT_MESSAGE - 聊天消息事件
• PAGE_ASSIST:SETTINGS_UPDATE - 设置更新事件

你可以通过监听这些事件来扩展功能，例如在特定网页自动触发内容分析。

事件通信示例

以下代码展示如何在内容脚本中发送消息到背景脚本：

// 向背景脚本发送分析请求
chrome.runtime.sendMessage({
  type: "PAGE_ASSIST:ANALYZE_CONTENT",
  payload: {
    url: window.location.href,
    content: document.body.innerText,
    selection: window.getSelection().toString()
  }
}, (response) => {
  console.log("Analysis result:", response);
});

背景脚本中对应的事件处理：

// 监听内容分析请求
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
  if (message.type === "PAGE_ASSIST:ANALYZE_CONTENT") {
    // 处理分析请求
    processContent(message.payload)
      .then(result => sendResponse(result))
      .catch(error => sendResponse({ error: error.message }));
    return true; // 表示将异步发送响应
  }
});

通过这种事件机制，你可以构建自定义的内容处理逻辑，或与其他扩展进行集成。

扩展开发资源

Page Assist源码中提供了完整的扩展开发文档和示例：

• API参考文档：docs/providers/
• 事件系统详解：src/chain/chat-with-x.ts
• 内容解析模块：src/parser/

这些资源可以帮助你快速理解系统架构，开发符合需求的自定义扩展。

隐私保护与离线使用

Page Assist的核心设计理念之一是保护用户隐私。与依赖云端API的AI工具不同，Page Assist所有的AI处理都在本地完成，不会将你的数据发送到外部服务器。

数据处理流程

1. 本地存储：所有聊天历史和设置都保存在浏览器本地存储中，路径为 chrome-extension://[extension-id]/indexeddb/
2. 内存计算：AI推理过程完全在本地内存中进行，不会产生网络请求
3. 临时缓存：网页内容分析结果仅在会话期间保留，关闭扩展后自动清除

离线工作能力

Page Assist完全支持离线工作模式，只要满足以下条件：

• 扩展已预先安装
• 本地AI服务（如Ollama）已启动并下载所需模型
• 目标网页已缓存或可离线访问

在没有网络连接的情况下，你仍然可以使用Page Assist分析本地文件或已缓存的网页内容。

故障排除与支持

尽管Page Assist设计为稳定可靠的工具，但在使用过程中可能会遇到各种问题。以下是常见问题的解决方法和获取支持的途径。

常见问题解决

无法启动本地AI服务：

1. 确认Ollama或其他AI服务已正确安装
2. 检查服务是否正在运行（ollama list 命令应显示已安装模型）
3. 验证Page Assist设置中的AI服务地址是否正确（默认：http://localhost:11434）

侧边栏无法打开：

1. 检查快捷键是否被其他扩展占用
2. 尝试通过扩展图标手动打开
3. 访问 chrome://extensions/ 确认Page Assist未被禁用

获取技术支持

如果遇到无法解决的问题，可以通过以下渠道获取帮助：

• 项目文档：docs/ 目录包含详细使用指南和故障排除信息
• 问题跟踪：通过项目仓库的Issues系统提交bug报告
• 社区支持：加入Page Assist用户社区，与其他用户交流经验

结语

Page Assist作为一款本地AI浏览器扩展，为用户提供了在网页浏览过程中获取AI辅助的便捷方式。通过将强大的AI能力与浏览器无缝集成，同时保持数据隐私和离线可用性，Page Assist重新定义了我们与网页内容交互的方式。

无论你是需要快速分析网页内容、生成摘要，还是希望在不离开当前页面的情况下获取AI解答，Page Assist都能满足你的需求。通过本文档介绍的安装配置方法，你可以立即开始体验这款隐私优先的AI辅助工具。

随着本地AI技术的不断发展，Page Assist将持续优化功能，为用户提供更强大、更智能的浏览体验。我们欢迎用户反馈和贡献代码，共同打造更好的本地AI浏览器扩展生态。