粤ICP备2026098386号-2
PageMind：极简隐私优先的 AI 网页侧栏助手
返回首页
开源项目 0 次阅读

PageMind：极简隐私优先的 AI 网页侧栏助手

我的开源项目 PageMind 介绍：一款极简、隐私优先的 AI 网页侧栏助手，支持 Safari 与 Chrome，内置大模型上下文管理、长文阅读与多模态附件解析，数据全量本地存储。

PageMind 浏览器扩展 AI

项目简介

PageMind 是一款极简、智能且隐私优先的 Web 网页 AI 侧栏扩展助手，同时支持 Safari 与 Google Chrome（及所有 Chromium 内核浏览器）。

它内置大模型上下文管理、长文阅读分析、自适应排版 / 原生 Side Panel 支持、多模态附件解析与本地安全存储。相比传统「选中文本弹个气泡」的划词翻译式助手，PageMind 直接以侧栏形态常驻浏览器右侧，随时随地与当前页面对话。

核心特性

🍎 Safari 扩展支持

  • 针对 Safari 扩展架构与页面注入逻辑做了深层优化；
  • 支持无侵入的自适应网页排版伸缩，不会遮挡原网页正文；
  • 支持与 macOS Keychain 及 Native Companion 原生宿主通信，安全存储 API 密钥。

🌐 Chrome / Chromium 扩展支持

  • 采用 Chrome 原生 Side Panel（侧边栏 API），与浏览器右侧原生理化无缝集成；
  • 支持 Chrome、Microsoft Edge、Brave、Vivaldi 等所有 Chromium 内核浏览器；
  • 密钥防护自动匹配平台防泄露机制（chrome.storage.session）。

🤖 通用 AI 能力

  • 多模型支持：DeepSeek、OpenAI、Claude、Ollama 等主流大模型服务均可接入；
  • 多模态附件：支持图片、PDF、Markdown / 文本等多种格式附件解析与对话提问；
  • 上下文窗口管理：智能 Token 裁剪与压缩，长会话状态保持与快速恢复；
  • 本地安全存储：敏感数据与历史对话全量本地持久化（IndexedDB/Dexie），安全无泄露。

快速上手

安装到 Chrome（及 Edge / Brave）

  1. 打开扩展管理页：地址栏输入 chrome://extensions/（Edge 为 edge://extensions/）；
  2. 开启右上角 开发者模式；
  3. 将构建产出的 ZIP 包解压后，点击 「加载已解压的扩展程序」，选择解压后的文件夹（或 extension/dist/chrome 目录）；
  4. 导入成功后，点击浏览器右上角的扩展图标，将 PageMind 固定到工具栏即可唤起原生 Side Panel 对话界面。

安装到 Safari

  1. 打开 Safari > 设置 > 高级，勾选 「在菜单栏中显示『开发者』菜单」；
  2. 点击菜单栏 开发者，勾选 「允许未签名的扩展」；
  3. 点击 「添加临时扩展」，选择构建生成的 ZIP 包或解压目录 extension/dist/safari 即可。

开发与构建

环境要求

  • Node.js >= 18.0
  • pnpm >= 8.0（推荐）

安装依赖与本地开发

cd extension
pnpm install

# Safari 开发构建模式
pnpm dev

# Chrome 开发构建模式
pnpm dev:chrome

运行单元测试

cd extension
pnpm test

一键打包

项目提供了 zero-config 自动化打包脚本，会自动完成依赖校验、单元测试、构建校验，并生成带 SHA256 校验的 ZIP 插件包：

# 打包 Safari 扩展包
./scripts/package-safari.sh

# 打包 Chrome 扩展包
./scripts/package-chrome.sh

产物路径：artifacts/safari/PageMind-Safari-x.x.x.zip、artifacts/chrome/PageMind-Chrome-x.x.x.zip（均附带 .sha256 校验文件）。

项目结构

PageMind/
├── extension/             # 浏览器插件前端与 Engine 核心代码 (React + TypeScript + Vite + TailwindCSS)
│   ├── manifests/         # 多浏览器 Manifest 配置文件
│   └── src/
│       ├── background/    # Service Worker 后台脚本与消息路由
│       ├── content/       # Content Script & Safari 自适应排版控制器
│       ├── sidepanel/     # Chrome 原生 Side Panel 页面
│       ├── sidebar/       # Safari 注入式侧栏页面
│       ├── engine/        # AI Provider、上下文管理、IndexedDB 存储与解析器
│       └── options/       # 插件设置控制台
├── macos/                 # Safari Native Extension macOS 原生 Companion 宿主工程
├── scripts/               # 自动化打包与校验脚本
└── artifacts/             # 打包生成的 ZIP 安装包及 SHA256 校验产物

总结

PageMind 的核心思路是：把 AI 助手以最小侵入的方式嵌入浏览器侧栏，数据全部留在本地。无论你主力使用 Safari 还是 Chrome，都能获得一致的体验——上下文管理、长文阅读、多模态解析这些「重活」都内置在 Engine 层，开箱即用。

项目地址：github.com/Mutant-z/pagemind

如果你也常年在浏览器里划词提问、让 AI 帮忙读长文，不妨试试，也欢迎提 Issue 和 Star ⭐

PageMind浏览器扩展AI