Page Assist浏览器扩展：让AI助手成为你的网页浏览伙伴

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正是这样一个创新的浏览器扩展，它让你在浏览任何网页时都能通过侧边栏与本地运行的AI模型互动。无论你是开发者、学生还是普通用户，这款工具都能显著提升你的网页浏览效率。

🚀 快速上手：从零开始安装Page Assist

准备工作：环境检查清单

在开始之前，请确保你的系统满足以下要求：

第一步：获取项目代码

打开你的终端或命令行工具，执行以下命令克隆项目仓库：

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

第二步：安装依赖环境

Page Assist使用Bun作为JavaScript运行时，安装过程很简单：

1. 安装Bun运行时：

   curl -fsSL https://bun.sh/install | bash

2. 配置环境变量： 安装完成后，需要将Bun添加到系统路径中：

   export PATH="$HOME/.bun/bin:$PATH"

   为了让这个设置永久生效，可以将上述命令添加到你的shell配置文件（如.bashrc或.zshrc）。

3. 验证安装：

   bun --version

   如果看到版本号输出，说明安装成功。

第三步：编译扩展程序

进入项目目录并安装依赖：

cd page-assist bun install

然后编译扩展程序：

bun run build

编译成功后，你会在项目根目录看到build文件夹，里面包含了扩展的所有必要文件。

📌小贴士：如果编译过程中遇到错误，可以尝试先清理缓存：bun clean，然后重新运行bun install和bun run build。

🛠️ 安装扩展：让AI助手进驻浏览器

Chrome浏览器安装步骤

1. 打开Chrome浏览器，访问chrome://extensions/
2. 开启右上角的"开发者模式"开关
3. 点击"加载已解压的扩展程序"按钮
4. 选择刚才生成的build文件夹
5. 确认扩展出现在列表中并显示"已启用"

安装成功后，你会在浏览器工具栏看到Page Assist的图标。点击图标或使用快捷键即可调出AI助手侧边栏。

Firefox浏览器安装步骤

对于Firefox用户，安装过程略有不同：

1. 访问about:debugging#/runtime/this-firefox
2. 点击"临时加载附加组件"
3. 选择项目中的manifest.json文件
4. 扩展将作为临时附加组件加载

⚠️注意：Firefox中的临时加载会在重启浏览器后失效，如需永久使用，需要通过Firefox附加组件商店安装。

🎯 核心功能：AI助手的多种使用场景

实时网页内容分析

Page Assist最强大的功能之一是能够分析你当前浏览的网页内容。当你打开一个技术文档、新闻文章或教程页面时：

1. 点击浏览器工具栏的Page Assist图标
2. 侧边栏会显示当前网页的摘要
3. 你可以直接提问关于页面内容的问题

例如，在浏览一篇编程教程时，你可以问："这个代码示例中的第3行是什么意思？"AI助手会基于页面内容给出精准回答。

多格式文件支持

除了网页内容，Page Assist还支持多种文件格式：

本地AI模型集成

Page Assist支持多种本地AI模型，包括：

• Ollama：轻量级本地模型运行框架
• LM Studio：桌面端模型管理工具
• llama.cpp：高效的推理引擎

这意味着你可以在完全离线的环境下使用AI助手，保护隐私的同时享受AI带来的便利。

🔧 常见问题与解决方案

问题一：扩展无法加载或显示错误

症状：Chrome提示"无法加载扩展程序"或"清单文件无效"

可能原因：

• 开发者模式未开启
• 选择了错误的文件夹（应选择build文件夹而非项目根目录）
• 编译过程出现错误

解决方案：

1. 确认已开启Chrome的开发者模式
2. 重新执行编译命令：bun run build
3. 删除旧扩展，重新加载build文件夹
4. 检查控制台错误信息（按F12打开开发者工具）

问题二：快捷键无法调出侧边栏

症状：按预设快捷键（默认Alt+P）无反应

可能原因：

• 快捷键被系统或其他应用占用
• 扩展快捷键设置错误

解决方案：

1. 访问chrome://extensions/shortcuts
2. 找到Page Assist扩展
3. 重新设置"激活扩展"的快捷键
4. 建议使用Ctrl+Shift+[字母]组合，避免与系统快捷键冲突

问题三：AI模型无法连接

症状：侧边栏显示"无法连接到AI模型"

可能原因：

• Ollama服务未启动
• 端口被占用
• 模型文件损坏或缺失

解决方案：

1. 检查Ollama服务状态：ollama serve
2. 确认端口11434未被占用：lsof -i :11434
3. 重启Ollama服务：ollama stop && ollama serve
4. 重新拉取模型：ollama pull [模型名称]

📋 优化使用体验的技巧

个性化设置建议

在Page Assist的设置页面，你可以根据需求调整：

1. 模型选择：根据你的硬件配置选择合适的模型

   • 高性能电脑：选择7B或更大参数模型
   • 普通配置：选择3B或以下参数模型

2. 响应速度优化：

   • 调整上下文长度：减少上下文可加快响应速度
   • 开启流式响应：获得更快的初始回复

3. 界面自定义：

   • 调整侧边栏宽度
   • 选择深色/浅色主题
   • 设置字体大小

高效工作流示例

场景：研究一个技术项目

1. 打开项目GitHub页面
2. 调出Page Assist侧边栏
3. 提问："这个项目的核心技术栈是什么？"
4. 阅读README文件时，选中复杂段落让AI解释
5. 查看代码文件时，让AI分析函数逻辑
6. 遇到问题时，让AI提供解决方案思路

安全使用注意事项

1. 隐私保护：

   • Page Assist默认在本地处理数据
   • 敏感信息不会上传到云端
   • 可完全离线使用

2. 资源管理：

   • 监控内存使用情况
   • 大型模型可能需要较多RAM
   • 适时清理对话历史

3. 内容验证：

   • AI回答仅供参考
   • 重要决策请多方验证
   • 技术问题建议查阅官方文档

🆘 获取帮助与支持

自助排查步骤

遇到问题时，可以按以下流程排查：

# 1. 检查依赖状态 bun --version ollama --version # 2. 重新编译扩展 bun clean bun install bun run build # 3. 查看日志信息 # Chrome: 按F12打开开发者工具，查看Console标签 # Firefox: 按Ctrl+Shift+K打开开发者控制台

问题反馈模板

如果你需要向开发者反馈问题，请提供以下信息：

问题描述：[简要说明遇到的问题] 复现步骤： 1. [第一步操作] 2. [第二步操作] 3. [实际结果与预期结果] 环境信息： - 操作系统：[如Windows 11 22H2] - 浏览器及版本：[如Chrome 112.0.5615.138] - Page Assist版本：[查看扩展详情页] - AI模型信息：[如Ollama + llama2:7b] 错误信息：[如有错误提示或截图]

学习资源推荐

• 官方文档：查看项目中的docs/目录获取详细指南
• 功能演示：参考docs/features/了解各项功能
• 配置说明：查看docs/providers/获取不同AI模型的配置方法

💡 进阶使用技巧

自定义提示词模板

Page Assist允许你创建和使用自定义提示词模板：

1. 打开扩展设置页面
2. 进入"提示词"设置
3. 点击"添加新模板"
4. 输入模板名称和内容

例如，创建一个代码审查模板：

请分析以下代码的质量： 1. 代码风格是否符合最佳实践 2. 是否存在潜在的性能问题 3. 安全方面有哪些需要注意的 4. 提供改进建议

多语言支持

Page Assist支持多种语言界面，包括：

• 英语、中文、日语、韩语
• 法语、德语、西班牙语
• 俄语、阿拉伯语等

要切换语言：

1. 打开扩展设置
2. 进入"通用设置"
3. 选择"语言"
4. 重启扩展使更改生效

知识库功能

你可以为Page Assist添加自定义知识库：

1. 准备文档文件（支持PDF、Word、文本等格式）
2. 在扩展设置中进入"知识库"选项
3. 上传文档文件
4. AI助手将基于这些文档提供更精准的回答

🎉 开始你的AI辅助浏览之旅

Page Assist将AI助手直接集成到你的浏览器中，让智能问答成为浏览体验的自然组成部分。无论你是需要快速理解复杂的技术文档，还是希望获得网页内容的个性化总结，这个工具都能为你提供强大的支持。

记住，最好的学习方式是实践。现在就开始使用Page Assist，探索AI辅助浏览的无限可能。如果在使用过程中有任何疑问，欢迎参考本文的解决方案，或向社区寻求帮助。

🌟最后提示：AI技术仍在快速发展，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