如何5分钟搞定Page Assist:终极本地AI浏览器助手完整指南
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
想要在浏览网页时随时与本地AI模型对话吗?Page Assist正是你需要的浏览器扩展神器!这款开源工具让你在Chrome浏览器中直接与本地AI模型交互,无论浏览任何网页都能随时调出侧边栏与AI对话。今天我将为你带来最完整的Page Assist安装使用指南,让你在5分钟内轻松上手这个强大的本地AI助手。
🚀 Page Assist是什么?
Page Assist是一款革命性的浏览器扩展,它让你能够在浏览网页的同时,通过侧边栏与本地运行的AI模型进行对话。这意味着你可以:
- 实时网页分析:在任何网页上快速获取摘要、翻译或解释
- 本地隐私保护:所有对话都在本地处理,数据不会上传到云端
- 多模型支持:支持Ollama、LM Studio、llama.cpp等多种本地AI模型
- 完全免费:开源项目,无需付费订阅
Page Assist的图标 - 你的本地AI浏览器助手
📦 准备工作:环境检查清单
在开始安装前,先确保你的系统满足以下要求:
✅ 系统要求
- 操作系统:Windows 10/11、macOS 10.15+、Linux (Ubuntu 20.04+)
- 浏览器:Chrome/Edge/Brave (Chromium内核) 或 Firefox
- 内存:至少8GB RAM(推荐16GB以上)
- 存储空间:10GB可用空间用于模型文件
✅ 软件依赖
- Node.js环境:用于运行Bun构建工具
- 本地AI模型:如Ollama、LM Studio等
- Git:用于克隆项目代码
🔧 3步快速安装指南
第1步:获取Page Assist扩展
你有两种方式获取Page Assist:
| 方式 | 优点 | 适合人群 |
|---|---|---|
| 从商店安装 | 最简单,一键安装 | 普通用户 |
| 从源码构建 | 最新功能,可自定义 | 开发者/高级用户 |
推荐新手从商店安装:
- 打开Chrome网上应用店
- 搜索"Page Assist"
- 点击"添加到Chrome"
- 确认安装权限
第2步:安装本地AI模型
Page Assist需要本地AI模型才能工作。以下是推荐的选择:
# 安装Ollama(最简单的方式) curl -fsSL https://ollama.ai/install.sh | sh # 启动Ollama服务 ollama serve # 下载一个模型(如Llama 3.1) ollama pull llama3.1:8b💡提示:首次运行Ollama可能需要几分钟下载模型文件,请确保网络连接稳定。
第3步:配置连接
- 点击浏览器工具栏中的Page Assist图标
- 在设置中选择"本地模型"
- 输入Ollama的地址(默认:http://localhost:11434)
- 选择已下载的模型
- 点击"连接测试"
Page Assist的设置界面,你可以在这里配置本地模型连接
🎯 核心功能深度体验
1. 智能侧边栏聊天
在任何网页上按下Alt+P(可自定义),立即调出AI助手侧边栏。你可以:
- 询问网页内容的任何问题
- 请求翻译或摘要
- 获取代码解释
- 进行创意写作
2. 网页操作功能(Page Action)
通过额外的Page Action扩展,AI可以直接在网页上操作:
| 功能 | 描述 | 使用场景 |
|---|---|---|
| 点击元素 | AI识别并点击页面元素 | 自动填写表单、导航菜单 |
| 输入文本 | 在输入框中自动输入 | 快速填写联系信息 |
| 滚动页面 | 控制页面滚动 | 浏览长文档 |
| 提取内容 | 获取特定区域文本 | 收集数据、保存信息 |
3. 多语言支持
Page Assist支持20多种语言界面,包括:
- 英语、中文、日语、韩语
- 法语、德语、西班牙语
- 俄语、阿拉伯语等
⚡ 实用技巧与最佳实践
快捷键优化配置
默认快捷键Alt+P可能与其他软件冲突,建议这样设置:
- 访问
chrome://extensions/shortcuts - 找到Page Assist
- 设置一个独特的组合,如
Ctrl+Shift+Q - 避免使用系统级快捷键(如
Alt+Tab)
模型选择建议
根据你的硬件选择合适的模型:
| 硬件配置 | 推荐模型 | 响应速度 |
|---|---|---|
| 8GB RAM | llama3.1:8b | ⚡ 快速 |
| 16GB RAM | llama3.1:70b | ⚡⚡ 中等 |
| 32GB+ RAM | mixtral:8x22b | ⚡⚡⚡ 流畅 |
内存优化技巧
- 关闭不必要的浏览器标签
- 定期清理浏览器缓存
- 使用轻量级模型进行日常对话
- 保存重要对话后关闭侧边栏
🔍 常见问题快速排查
❌ 问题1:扩展无法加载
症状:Chrome显示"无法加载扩展程序"
解决方法:
- 确保已开启开发者模式
- 检查manifest.json文件是否完整
- 重新执行构建命令:
bun run build - 重新加载扩展
❌ 问题2:AI模型无法连接
症状:侧边栏显示"连接失败"
解决方法:
# 检查Ollama服务状态 ollama list # 重启Ollama服务 ollama serve # 检查端口占用 sudo lsof -i :11434❌ 问题3:快捷键无效
症状:按下快捷键无反应
解决方法:
- 检查快捷键是否被其他软件占用
- 在Chrome快捷键设置中重新分配
- 重启浏览器
- 检查输入法快捷键冲突
📈 高级功能探索
MCP服务器集成
Page Assist支持Model Context Protocol (MCP),可以连接各种工具和服务:
// 示例:连接自定义MCP服务器 { "mcpServers": { "my-tools": { "command": "npx", "args": ["@modelcontextprotocol/server-my-tools"] } } }知识库功能
你可以在src/db/knowledge.ts中看到知识库的实现,支持:
- 文档上传和索引
- 智能检索
- 上下文记忆
自定义提示词
在docs/prompt.md中学习如何创建自定义提示词模板,优化AI响应质量。
🛡️ 隐私与安全
Page Assist的设计理念是隐私第一:
| 隐私特性 | 说明 |
|---|---|
| 本地处理 | 所有AI推理在本地完成 |
| 无数据上传 | 对话内容不会发送到云端 |
| 权限最小化 | 只请求必要的浏览器权限 |
| 开源透明 | 代码完全开源,可审查 |
🎨 自定义与开发
如果你想要定制Page Assist,可以:
- 克隆项目源码:
git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist- 安装依赖:
bun install- 开发构建:
bun run dev- 生产构建:
bun run build项目的主要目录结构:
src/components/- 所有UI组件src/libs/mcp/- MCP服务器集成src/models/- AI模型接口docs/- 完整文档
📚 学习资源
官方文档
- 功能文档 - 详细了解每个功能
- 提供商配置 - 各种AI模型配置指南
- 侧边栏使用 - 侧边栏功能详解
社区支持
- GitHub Issues:报告问题或请求功能
- Discord社区:与其他用户交流经验
- 项目讨论区:分享使用技巧
🚀 下一步行动
现在你已经掌握了Page Assist的所有核心知识,接下来:
- 立即安装:从Chrome网上应用店获取Page Assist
- 配置模型:安装并连接Ollama或其他本地模型
- 开始使用:在任意网页上体验AI助手
- 探索高级功能:尝试Page Action和MCP集成
记住,Page Assist是一个持续发展的项目,定期检查更新以获取新功能。如果你遇到任何问题,不要犹豫,查看官方文档或向社区寻求帮助。
祝你使用Page Assist愉快,让AI成为你浏览网页的智能伙伴!🎉
💡最后提示:Page Assist完全免费开源,如果你觉得这个项目有用,考虑在GitHub上给项目点个星,或者向开发者表达感谢!
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考