3步快速部署：如何让你的本地AI助手立即为你工作

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

Page Assist是一款革命性的开源浏览器扩展，它能让你的本地AI模型无缝集成到日常网页浏览中。无论你是开发者、研究人员还是技术爱好者，这款工具都能将你的浏览体验提升到全新高度。想象一下：阅读技术文档时，AI助手能实时解释复杂概念；研究论文时，它能帮你总结要点；浏览代码仓库时，它能分析实现逻辑——这一切都在你的浏览器侧边栏中即时完成，完全离线运行，保护你的隐私。

🌟 为什么你需要Page Assist？

场景一：技术文档阅读困境 你正在研究一个复杂的API文档，面对几十页的技术说明，时间有限但需要快速掌握核心概念。传统方式需要反复翻阅、搜索、记录，效率低下。

场景二：代码审查挑战 在GitHub上查看一个开源项目，面对数千行代码，需要快速理解架构设计和关键实现逻辑，但缺乏直接的对话接口。

场景三：多语言内容理解 浏览外文技术博客或文档，语言障碍让你无法快速获取有价值的信息，传统翻译工具缺乏上下文理解能力。

Page Assist正是为解决这些问题而生。它不仅仅是一个AI对话工具，更是你的智能浏览伴侣，将本地AI的强大能力直接注入到你的浏览器中。

🚀 5分钟快速启动指南

第一步：一键安装扩展

根据你的浏览器选择安装方式：

浏览器类型	安装方式	预计时间
Chrome/Edge/Brave	从Chrome网上应用店搜索安装	1分钟
Firefox	从Firefox附加组件商店安装	1分钟
开发者模式	从源码编译安装	3-5分钟

对于开发者或希望体验最新功能的用户，推荐源码编译安装：

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

# 安装依赖（需要Bun运行时）
bun install

# 构建扩展
bun run build

构建完成后，在浏览器扩展管理页面启用"开发者模式"，点击"加载已解压的扩展程序"，选择项目中的build目录即可。

第二步：连接你的AI模型

Page Assist支持多种AI服务连接方式：

本地模型方案（推荐）

# 安装Ollama（macOS/Linux）
curl -fsSL https://ollama.com/install.sh | sh

# 启动Ollama服务
ollama serve

# 拉取一个轻量级模型
ollama pull llama3.2:1b

云端API方案 如果你偏好使用云端服务，Page Assist同样支持：

• OpenAI API
• Anthropic Claude API
• Google Gemini API
• 任何兼容OpenAI接口的服务

第三步：基础配置优化

打开Page Assist设置页面（点击扩展图标→设置），进行关键配置：

配置类别	推荐设置	优化建议
模型选择	根据硬件选择	4GB内存：llama3.2:1b，8GB+：llama3.2:3b
上下文长度	4096	平衡性能与对话深度
温度参数	0.7	创造性回答与准确性的平衡
快捷键设置	Alt+P（侧边栏）	选择不易冲突的组合键

完成这三步后，在任意网页按下Alt+P，你的AI助手就会立即出现在侧边栏中。

🔧 核心功能深度解析

智能网页对话：你的私人技术导师

Page Assist最强大的功能之一是上下文感知对话。当你在浏览网页时，AI不仅能回答一般问题，还能理解当前页面内容：

// 项目中的智能对话处理逻辑位于
// src/chain/chat-with-website.ts
// 该模块负责将网页内容与AI模型进行智能整合

实际应用示例：

1. 代码解释：选中一段复杂代码，右键选择"用Page Assist分析"
2. 文档总结：让AI自动提取长篇文章的核心要点
3. 技术对比：比较不同框架或工具的优势与适用场景

多模型无缝切换

Page Assist的架构设计支持灵活的多模型管理：

图：Page Assist简洁的模型选择界面，支持本地和云端多种AI服务

模型适配器架构：

src/models/
├── ChatOllama.ts          # Ollama本地模型适配
├── ChatOpenAI.ts          # OpenAI API适配
├── ChatGoogleAI.ts        # Google AI适配
└── ChatChromeAi.ts        # Chrome内置AI适配

这种模块化设计让你可以根据任务需求灵活切换模型，比如用本地模型处理隐私敏感内容，用云端大模型处理复杂分析任务。

高级对话管理

Page Assist内置了完整的对话管理系统：

• 对话历史保存：所有对话自动存储在本地IndexedDB中
• 上下文记忆：AI能记住之前的对话内容，进行连贯交流
• 文件处理能力：支持上传PDF、Word、文本文件进行分析

// 对话历史管理位于src/db/chat.ts
// 使用Dexie.js实现高效的本地存储

⚡ 性能优化与最佳实践

硬件配置建议

根据你的设备性能选择合适的配置：

设备配置	推荐模型	上下文长度	响应速度
低端设备（4GB RAM）	llama3.2:1b	2048	快速
中端设备（8GB RAM）	llama3.2:3b	4096	中等
高性能设备（16GB+ RAM）	llama3.2:7b	8192	流畅

常见性能问题解决

问题1：响应速度慢

# 检查Ollama服务状态
ollama ps

# 查看模型运行情况
ollama list

解决方案：

1. 降低模型大小或上下文长度
2. 确保没有其他程序占用大量内存
3. 在Page Assist设置中调整温度参数

问题2：内存占用过高

# 监控内存使用
top -o mem  # macOS
htop        # Linux

优化策略：

1. 使用更小的模型版本
2. 定期清理对话历史
3. 关闭不需要的浏览器标签页

隐私安全配置

Page Assist默认以隐私优先为设计原则：

• 完全离线模式：所有数据处理在本地进行
• 数据本地存储：对话历史不发送到任何服务器
• 可选的云端服务：仅在明确授权时使用API服务

🛠️ 进阶使用技巧

自定义快捷键配置

Page Assist支持完全自定义的快捷键系统：

// 快捷键配置位于src/utils/constant.ts
// 你可以根据个人习惯调整默认设置

推荐配置方案：

• Ctrl+Shift+Y：打开侧边栏
• Ctrl+Shift+L：打开Web UI
• Ctrl+Shift+O：新建对话
• Ctrl+B：切换历史记录侧边栏

多语言支持

Page Assist内置了完整的国际化支持：

src/assets/locale/
├── en/     # 英语
├── zh/     # 简体中文
├── zh-TW/  # 繁体中文
├── ja/     # 日语
└── ...     # 其他20+种语言

要切换语言，只需在设置中选择对应的语言包即可。

开发者扩展接口

如果你是开发者，Page Assist提供了丰富的扩展接口：

// 添加自定义模型支持
// 在src/models/目录下创建新的模型适配器

// 扩展UI功能
// 修改src/components/中的React组件

// 集成外部服务
// 通过src/services/添加新的服务接口

🚨 常见问题与解决方案

安装失败排查指南

症状：扩展无法加载

1. 检查浏览器版本是否支持Manifest V3（Chrome ≥ 102）
2. 确认已启用开发者模式
3. 验证加载的是build目录而非源码目录

症状：模型连接失败

# 测试Ollama连接
curl http://localhost:11434/api/tags

# 预期输出应包含已安装的模型列表

解决方案：

1. 确保Ollama服务正在运行：ollama serve
2. 检查防火墙设置，确保端口11434未被阻止
3. 在Page Assist设置中验证连接配置

功能异常处理

侧边栏不显示：

1. 检查快捷键设置（默认Alt+P）
2. 确认扩展已启用
3. 重启浏览器尝试

对话历史丢失：

1. 检查浏览器存储权限
2. 确认没有使用隐私浏览模式
3. 定期导出重要对话备份

📈 实际应用场景展示

技术文档学习

痛点： 阅读复杂技术文档时难以快速理解核心概念 解决方案： 使用Page Assist的"与网页对话"功能，让AI实时解释技术术语、总结章节要点、提供代码示例

代码审查辅助

痛点： 审查大量代码时容易遗漏关键问题 解决方案： 让AI分析代码结构、识别潜在bug、提供改进建议

研究资料整理

痛点： 收集多篇研究论文时难以快速提取关键信息 解决方案： 使用Page Assist批量处理网页内容，生成结构化摘要和对比分析

🎯 立即开始你的AI助手之旅

Page Assist不仅仅是一个工具，它是你浏览网页时的智能伙伴。通过将本地AI模型无缝集成到浏览器中，它重新定义了人机交互的方式。

今日行动清单：

1. ✅ 选择安装方式（商店安装或源码编译）
2. ✅ 配置本地AI模型（推荐从Ollama开始）
3. ✅ 设置个性化快捷键
4. ✅ 在常用网站测试基础功能
5. ✅ 探索高级功能（文件上传、多模型切换）

记住，最好的学习方式就是立即开始使用。打开你的浏览器，安装Page Assist，体验本地AI助手带来的效率革命。无论你是开发者、学生还是研究人员，这款开源工具都将成为你数字工作流程中不可或缺的一部分。

进阶提示： 关注项目的GitHub仓库，及时获取更新和新功能。作为开源项目，Page Assist正在快速发展，社区贡献让它的功能日益强大。如果你有改进想法或遇到问题，欢迎参与讨论和贡献代码！

---

Page Assist项目持续更新中，最新版本请访问项目仓库获取。祝你使用愉快！

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