本地AI助手浏览器扩展：零基础离线部署与场景化应用指南

本地AI助手浏览器扩展：零基础离线部署与场景化应用指南

【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist

Page Assist是一款开源的本地AI助手浏览器扩展，无需GPU也能在本地运行AI模型，全程保护您的隐私数据。通过本指南，您将快速掌握从环境搭建到实际应用的全流程，让AI助手成为您网页浏览的得力帮手。

核心功能速览

这款本地AI助手浏览器扩展具备三大核心能力：首先是离线交互，所有AI计算在本地完成，无需上传数据至云端；其次是多模型支持，兼容Ollama、LM Studio等主流本地AI运行环境；最后是场景化辅助，可实现网页内容解读、智能摘要生成和跨页面信息整合。

环境准备：三步兼容性检测

1. 系统环境要求

确保您的设备满足以下基础条件：

• 操作系统：Windows 10/11、macOS 12+或Linux发行版（Ubuntu 20.04+推荐）
• 浏览器：Chrome 110+或Firefox 102+
• 存储空间：至少2GB可用空间（用于安装依赖和基础模型）

2. 核心依赖速查表

3. 环境检测脚本

执行以下命令检查关键依赖是否就绪：

# 检测Node.js版本 node -v && bun -v && ollama -v

🔍 验证要点：所有命令均能正常输出版本号，且版本满足最低要求。 ⚠️ 注意事项：若提示"命令未找到"，需先安装对应依赖。

分步部署：5分钟启动指南

1. 获取项目代码

git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist

2. 安装项目依赖

bun install

🔍 验证要点：命令执行完毕后，项目根目录会生成node_modules文件夹。

3. 配置模型参数

复制配置模板并根据需求调整：

cp examples/config.sample.json config.json

⚠️ 注意事项：首次使用建议保持默认配置，待程序运行正常后再进行个性化调整。

4. 构建扩展程序

根据目标浏览器选择对应命令：

# 构建Chrome扩展 bun run build # 构建Firefox扩展 bun run build:firefox

🔍 验证要点：构建完成后，项目根目录会生成build文件夹，内含扩展程序文件。

5. 加载扩展到浏览器

Chrome浏览器：

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

Firefox浏览器：

1. 打开about:debugging#/runtime/this-firefox
2. 点击"临时加载附加组件"
3. 选择build文件夹中的manifest.json文件

🔍 验证要点：浏览器工具栏出现Page Assist图标，点击后显示初始化界面。

场景化应用：三大核心功能实战

1. 网页内容智能解读

1. 打开任意网页，点击浏览器工具栏中的Page Assist图标
2. 在侧边栏输入框中提问"总结本页面核心观点"
3. 等待3-5秒，AI将生成内容摘要

⚠️ 注意事项：首次使用会自动下载基础模型（约800MB），请确保网络通畅。

2. 跨页面信息整合

1. 同时打开多个相关网页
2. 在侧边栏输入"对比所有打开页面的关键信息"
3. AI将自动提取各页面核心内容并生成对比表格

🔍 验证要点：输出结果应包含所有已打开标签页的关键信息对比。

3. 离线文档处理

1. 在扩展设置中启用"本地文件处理"
2. 拖放PDF或TXT文件到侧边栏
3. 提问"提取文档中的关键数据"

开发模式使用

如需进行二次开发或功能调试，可使用开发模式：

bun dev

该命令将启动热重载开发服务器，修改源代码后无需重新构建即可生效。

常见问题：避坑指南与故障排查

启动失败：端口占用问题

症状：构建时报错"Port 3000 is already in use" 解决方法：修改wxt.config.ts中的端口配置：

// wxt.config.ts export default defineConfig({ port: 3001, // 修改为未占用端口 })

模型加载缓慢

症状：首次启动时AI响应超过30秒 解决方法：

1. 检查网络连接，确保模型下载完整
2. 关闭其他占用内存的程序
3. 在设置中降低模型参数（牺牲部分性能换取速度）

浏览器兼容性问题

症状：Firefox中扩展功能异常 解决方法：

1. 确认Firefox版本≥102
2. 使用专用构建命令：bun run build:firefox
3. 清除浏览器缓存后重新加载扩展

故障排查流程图

当遇到其他问题时，可按照以下流程排查：

1. 检查依赖版本是否满足要求
2. 查看扩展背景页日志（Chrome: chrome://extensions/ → 详情 → 背景页）
3. 尝试删除node_modules并重新安装依赖
4. 检查系统防火墙是否阻止程序联网
5. 查看项目issue跟踪器寻找类似问题解决方案

高级配置：个性化您的AI助手

模型切换

1. 安装新模型：ollama pull llama3
2. 编辑config.json文件：

{ "defaultModel": "llama3" }

3. 重启扩展生效

快捷键设置

自定义打开/关闭侧边栏的快捷键：

1. 打开扩展选项页面
2. 进入"快捷键设置"选项卡
3. 按下您偏好的按键组合

隐私保护强化

在设置中启用"增强隐私模式"，该模式将：

• 禁用所有外部资源加载
• 自动清除会话历史
• 阻止AI学习您的交互数据

总结

通过本指南，您已掌握Page Assist本地AI助手浏览器扩展的完整部署流程和核心应用方法。这款工具的本地化特性确保了数据隐私安全，而跨浏览器支持则提供了灵活的使用选择。无论是日常网页浏览辅助还是专业内容分析，Page Assist都能成为您的得力助手。

如需进一步探索高级功能，请参考官方开发文档：docs/index.md。遇到问题时，欢迎查阅项目的常见问题解答或提交issue获取帮助。

祝使用愉快，让AI为您的网页浏览体验增添新的可能！

【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist