Page Assist：本地AI驱动的网页浏览增强工具全指南

功能价值篇：为什么选择本地AI辅助浏览？

核心优势解析

在隐私保护日益重要的今天，如何在不牺牲便利性的前提下掌控个人数据？Page Assist通过将AI能力完全部署在本地设备，实现了"数据不出本地，智能仍在身边"的突破。与传统云端AI工具相比，它带来三大核心价值：

• 隐私安全保障：所有对话和网页分析均在本地完成，避免敏感信息上传云端
• 离线可用特性：无需网络连接即可使用基础AI功能，适合旅行或网络不稳定场景
• 响应速度提升：本地模型直接处理请求，平均响应速度比云端服务快300ms

典型应用场景

Page Assist不是简单的聊天工具，而是深度整合网页浏览体验的AI助手：

• 智能内容摘要：自动提取长文章核心观点，节省70%阅读时间
• 跨语言实时翻译：支持20+种语言的网页内容即时转换，保留原文排版
• 技术文档解析：自动识别代码片段并生成解释，辅助开发者理解技术文档
• 个性化学习助手：根据浏览内容推荐相关学习资源，构建知识关联网络

技术解析篇：本地AI助手的架构与实现

整体技术架构

如何将复杂的AI能力压缩到轻量级浏览器扩展中？Page Assist采用了"核心引擎+模块化插件"的分层架构：

┌─────────────────────────────────┐
│           浏览器扩展层           │ ← UI交互与网页内容捕获
├─────────────────────────────────┤
│           核心服务层            │ ← 任务调度与模型管理
├─────────────────────────────────┤
│           本地AI引擎            │ ← Ollama/本地模型运行时
└─────────────────────────────────┘

关键技术选型解析

为什么选择TypeScript作为开发语言？

• 静态类型检查减少70%运行时错误，特别适合扩展开发
• 与Chrome/Firefox扩展API无缝集成，类型定义完善
• 强大的生态系统支持，从UI框架到AI工具链全覆盖

Bun vs Node.js：为何选择Bun作为构建工具？

• 冷启动速度比Node快4倍，显著提升开发效率
• 内置打包工具和测试框架，简化构建流程
• 原生支持TypeScript，无需额外配置

本地AI架构为何选择Ollama？

• 统一的模型管理接口，支持100+种开源模型
• 轻量级设计，最低仅需4GB内存即可运行基础模型
• 支持模型热切换，无需重启扩展即可更换AI模型

技术原理速览：本地向量数据库如何实现智能检索

Page Assist采用嵌入式向量存储技术，将网页内容转化为数学向量：

1. 当用户浏览网页时，扩展自动提取关键内容
2. 通过Ollama嵌入模型将文本转为768维向量
3. 向量存储在本地IndexedDB中，占用空间不到原始文本的1/5
4. 提问时，系统将问题向量化并与存储向量比对，快速找到相关内容

这种技术使本地AI能"记住"用户浏览过的内容，实现上下文感知对话。

实践指南篇：从零开始的本地AI助手部署

环境准备清单

如何确认你的设备是否满足运行条件？执行以下命令检查关键依赖：

# 检查Bun版本（需1.0.0+）
bun --version

# 检查Ollama是否安装并运行
ollama --version && ollama list

系统要求：

• 操作系统：Windows 10+ / macOS 12+ / Linux (Ubuntu 20.04+)
• 硬件要求：最低8GB内存（推荐16GB+），支持AVX2指令集的CPU
• 浏览器兼容性：

浏览器	最低版本	支持特性
Chrome	110.0+	完整功能
Firefox	109.0+	部分功能
Edge	110.0+	完整功能
Safari	16.0+	基础功能

安装部署流程

📌 任务1：获取项目代码

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

📌 任务2：安装依赖并构建

# 安装项目依赖
bun install

# 构建Chrome扩展（默认）
bun run build

# 如需Firefox版本
bun run build:firefox

📌 任务3：浏览器加载扩展

Chrome/Edge用户：

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

Firefox用户：

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

📌 任务4：配置本地AI模型

1. 首次打开扩展，点击"模型设置"
2. 选择已安装的Ollama模型（推荐默认的llama2）
3. 点击"测试连接"验证模型可用性
4. 调整资源分配（推荐分配4GB内存）

故障排查与优化

常见问题解决：

问题现象	可能原因	解决方案
扩展加载失败	构建过程错误	执行 bun run clean 后重新构建
AI无响应	Ollama未启动	运行 ollama serve 启动服务
内存占用过高	模型选择不当	切换至较小模型如phi3或llama2:7b
网页内容无法分析	权限不足	在扩展管理页开启"所有网站"权限

性能优化建议：

• 对于低配置设备，推荐使用4GB以下参数的模型
• 启用"内容过滤"功能，减少不必要的网页元素处理
• 定期清理向量数据库（设置 → 存储 → 清除缓存）

扩展功能配置

高级功能：自定义快捷键设置

通过修改 src/utils/keyboard/useKeyboardShortcuts.ts 文件配置个性化快捷键：

// 示例：修改打开侧边栏快捷键
{
  id: 'toggleSidebar',
  key: 'KeyP',
  modifiers: ['Control', 'Shift'],
  description: 'Toggle sidebar'
}

可用快捷键参考：

功能	默认快捷键	可自定义
打开侧边栏	Ctrl+Shift+P	✅
发送消息	Ctrl+Enter	✅
语音输入	Alt+V	✅
清除对话	Ctrl+Shift+Delete	✅

扩展能力：添加自定义模型

1. 确保Ollama已安装目标模型：ollama pull [模型名称]
2. 打开扩展设置 → "高级" → "添加自定义模型"
3. 填写模型名称、API路径和参数设置
4. 测试连接并保存配置

支持的自定义模型格式包括：llama.cpp兼容模型、GGUF格式模型和Hugging Face模型。

效率提升：快捷键速查表

操作	Windows/Linux	macOS	功能描述
打开/关闭侧边栏	Ctrl+Shift+P	Cmd+Shift+P	切换AI助手面板
发送消息	Ctrl+Enter	Cmd+Enter	提交当前输入内容
语音输入	Alt+V	Option+V	激活语音转文字输入
复制回复	Ctrl+Shift+C	Cmd+Shift+C	复制最后一条AI回复
新对话	Ctrl+T	Cmd+T	开始新的对话会话
切换深色模式	Ctrl+D	Cmd+D	切换明/暗主题

总结与展望

Page Assist通过将强大的AI能力本地化，重新定义了浏览器辅助工具的可能性。无论是科研工作者、开发者还是普通用户，都能在保护隐私的前提下享受AI带来的便利。随着本地AI模型的不断优化，未来我们可以期待更强大的离线功能和更智能的网页交互体验。

项目持续迭代中，欢迎通过官方文档了解最新功能和更新：docs/index.md