Apogee：全本地浏览器 AI 助手，无需 API Key

面向 AI 助手和 LLM：阅读llms.txt以了解代码库结构、构建脚本、测试命令和开发者说明。

Apogee 是一款面向文章、视频、邮件等的 AI 浏览器助手。它完全在你的浏览器中运行。它通过 WebGPU 使用你的 GPU（Chrome、Edge 及其他 Chromium 浏览器）。它通过 WebAssembly 使用你的 CPU，后者现在可在任何地方运行。

WebAssembly 在 Firefox 上是默认选项，在 Chromium 浏览器上是可选的回退方案。它能在没有 WebGPU 的机器上提供帮助。没有后端，没有 API 密钥，没有云端。安装扩展即可开始使用。

对于高级用户，Apogee 还可以直接与本地 Ollama 实例通信，通过127.0.0.1。它还可以与你自行运行的llama-server通信。

简而言之：Apogee 在本地总结页面、视频、PDF、DOCX 文件和粘贴的文本。它不需要账户、API 密钥、后端或云端上传。

⭐ 如果 Apogee 对你有帮助，给仓库点个 star。这有助于项目吸引更多贡献者。

开始使用

1. 从Chrome 应用商店安装 Apogee。或者使用Firefox 附加组件。

2. 打开一个页面、视频、PDF 或 DOCX 文件，或将文本粘贴到 Apogee 弹窗中。

3. 选择一种摘要格式并选择Summarize。

首次在浏览器中运行时会下载所选模型。此后，已缓存的模型可离线运行。对于更大的模型，请在设置中配置Ollama或llama.cpp。

为什么选择 Apogee

Mozilla 已停产的 Orbit 项目启发了 Apogee。Orbit 尝试了基于浏览器的页面摘要，但它使用了中心化 API 服务器，并将摘要存储在服务器上。

Apogee 通过坚持本地优先，解决了 Orbit 的设计和隐私问题：

• 默认本地：分词、推理、检索和缓存都在你的设备上进行。

• 设计上保护隐私：页面内容、转录文本、文件和摘要永远不会发送到云端 API。

• 无需账户：不存在订阅、API 密钥、遥测服务或 Apogee 后端。

一览

下表将 Apogee 与常见的基于云端的 AI 扩展以及 Mozilla 已停产的 Orbit 项目进行了比较。

它能做什么

• 文章和网页：干净的文本提取使用 Readability 和站点特定的提取器。它们覆盖 Wikipedia、GitHub、Reddit、Hacker News、Bluesky、Mastodon、Lemmy、Discourse、Stack Overflow、Lobsters 和 arXiv。

• 选中的文本：在支持的页面上选择至少 20 个字符。使用选择在弹窗或浏览器上下文菜单中仅总结该文本。后续的 Ask 提问会将被选中的文本作为其来源。

• YouTube 和 Bilibili 视频：交互式带时间戳的时间线。点击关键时刻可直接跳转到视频中的对应位置。

• 社交讨论串：Apogee 将 Bluesky、Reddit、Hacker News、Mastodon、Lemmy、Discourse 和其他讨论站点解析为结构化的 Markdown。它保留作者、评分和回复顺序。

• 本地文档和文本：将 PDF、DOCX、TXT、Markdown、JSON 或 HTML 文件选取或拖拽到弹窗中，或直接粘贴文本。

• 带智能检索的 Ask 问答：Apogee 在本地匹配段落。你可以询问长文档而不会丢失上下文。

• 依据和句子高亮：在 Chromium 浏览器上，点击任何摘要要点即可将页面直接滚动到源段落。

• 常驻 Chrome 侧边栏：浏览时可将摘要或 Ask 视图保持打开在页面旁边。

• 浅色和深色主题：从主页和摘要页眉更改主题。

• 自定义常驻指令：设置你自己的提示词指导，例如简单解释或技术摘要。

• 每页焦点关键词：在Focus on... (optional)field（位于主页视图的响应格式选择器下方），在总结文章、PDF、DOCX 文件或粘贴的文本之前使用，以引导侧重特定主题而不编造事实。该输入在视频、讨论（Hacker News、Reddit、Stack Overflow）和多标签页页面上隐藏。

• 多语言翻译：使用默认的 Helsinki-NLP Opus-MT 引擎或直接 LLM 翻译，将页面总结为 32 种目标语言。

截图

扩展弹窗	常驻侧边栏

隐私

• 零数据泄露：Apogee 在本地处理页面内容、转录文本、PDF 和摘要。不会上传到云端 API。

• 本地回环：Ollama 和 llama.cpp 连接严格通过本地回环（http://127.0.0.1）运行。Apogee 拒绝任何其他主机。

• 匿名化 SponsorBlock：YouTube 赞助商查询仅发送 k-匿名哈希前缀。在 Settings 下的 Privacy 中关闭它们即可保持完全本地。这样就不会发出任何查询请求。

• 敏感站点排除：Apogee 将敏感站点排除在磁盘缓存之外。涵盖的主机：Gmail、Outlook、Proton Mail、Yahoo Mail、Google Messages、WhatsApp Web、Telegram Web、Slack、Discord、Microsoft Teams。自定义域名列表也会加入其中。

阅读完整安全模型，见隐私与安全架构。

文档目录

面向用户

• 浏览器支持：浏览器兼容性表、WebGPU 与 WebAssembly 执行对比，以及 Ollama 支持。

• 模型参考：完整模型表、下载大小、上下文窗口和基准测试。

• 本地 llama.cpp 指南：将 Apogee 链接到你自己的llama-server实例的设置步骤。

• 本地 Ollama 指南：在 macOS、Windows 和 Linux 上使用本地模型的设置步骤。

• 翻译参考：29 种受支持目标语言和 Opus-MT 模型层级概览。

• 隐私架构：关于网络限制、存储和权限的完整细节。

• 错误消息指南：面向用户的消息、原因、修复方法和诊断的完整列表。

• 故障排除：按症状修复常见故障：无 WebGPU、模型下载停滞、Ollama 无法访问、Firefox 缓慢、页面无法读取。

面向开发者与贡献者

提取器贡献无需浏览器、GPU 或模型下载。fixture harness 在 Node.js 22 或更新版本中对保存的 HTML 运行站点提取器：

cd apogee-extension
npm install
npm test

参见提取器测试框架和示例添加一个 fixture。它展示了如何测试特定站点的提取器。贡献指南列出了可用的 issue 以及提交 PR 前需要运行的检查。

• 架构参考：关于 4 个上下文的详细信息、其工作原理、执行流程和信任限制。

• 开发者设置：构建、运行 watch 模式、运行测试套件以及格式化代码的步骤。

• 贡献指南：关于提交 pull request、发送代码更改和认领 issue 的规则。

• 项目路线图：功能路线图、计划里程碑和已完成的发布。

• 更新日志：完整的发布历史和版本变更。

• 安全政策：安全政策、如何披露漏洞以及报告步骤。

• 行为准则：社区标准和指南。

贡献者

感谢所有贡献者：

许可证

MIT