abundantbeing/hermes-browser-extension

Hermes Browser Extension – 快速概览

是什么 – 一个基于 Chromium 的侧边栏扩展，可让你直接从浏览器与一个真正的 Hermes Agent（Nous Research 开发的开源 AI 代理运行时）通信。它不是一个独立的聊天机器人；它只是将当前网页上下文（活动标签页、选中文本等）转发到 Hermes 网关（本地、云托管或自托管），并显示代理的响应。

核心功能

• 多代理「Bot 模式」 – 可随时在任意 Hermes 配置文件/代理之间切换，保留每个代理的聊天历史，并支持群聊线程。
• 智能标签页作用域 – 默认仅发送活动标签页；可切换其他标签页的包含/排除，运行 AI 驱动的「/sort-tabs」聚类，或包含所有标签页。
• Hermes Assist – 站点感知的草稿面板，可检测 31 种常见写作环境（邮件、社交帖子、问题追踪器等），并让代理生成草稿，需用户显式插入。
• 页面注释 – 选择页面上任意元素，添加注释，并将其作为便签排队在聊天输入框旁边，而不会污染提示。
• 完整会话工作区（Hermes Web Alpha） – 更丰富的视图，包含会话轨道、Markdown 渲染、媒体预览、工具活动条和会话级模型绑定。
• 实时控制（MV3 控制器） – 可选的、需用户明确授权的功能，允许代理在租用标签页上执行特权操作（点击、输入、滚动）。
• 诊断与透明度 – 「Hermes 看到的内容」收据、复制诊断按钮，以及元数据端点（/meta、/metadata、/head），可精确显示发送的上下文。
• 主题 – 内置九种主题（Light/Dark/System + Nous、Midnight、Ember、Mono、Cyberpunk、Slate、Senter Space、Aphrodite、Solstice）。

支持的浏览器

• Chrome / Edge / Brave / 其他 Chromium 浏览器（Side Panel API，Chrome 116+）。
• Firefox（通过 AMO） – 聊天和上下文功能正常，但因 Firefox 缺少所需的 debugger API，高级标签页控制功能不可用。
• Safari – 目前未提供。

如何开始

1. 先决条件 – 运行中的 Hermes Agent（本地网关、Hermes Cloud 或远程 API）和 Node 20+。
2. 构建

   git clone https://github.com/abundantbeing/hermes-browser-extension.git
   cd hermes-browser-extension
   npm install
   npm run build   # 输出到 dist/
   

3. 加载
   • Chromium：打开 chrome://extensions，启用开发者模式，「加载未打包」→ dist/。
   • Firefox：从 AMO 页面安装（无需手动侧载）。
4. 通过扩展图标或 Alt+H（默认快捷键）打开侧边栏。
5. 在设置面板中选择 Local gateway、Hermes Cloud 或 Remote gateway，并根据需要提供 URL/API 密钥。

典型工作流程

1. 打开希望代理查看的网页。
2. 点击侧边栏，可选地切换其他标签页或使用 /sort-tabs。
3. 输入命令（/summarize、/explain、/rewrite 等）或提出自由形式的问题。
4. 观察流式响应，检查「Hermes 看到的内容」收据，若使用 Hermes Assist，则将草稿插入页面的编辑器中。

为何重要

• 保持完整的 Hermes 运行时（模型、工具、记忆、技能）在循环中，而非简化版聊天机器人。
• 提供细粒度隐私控制：仅发送显式作用域的标签页，URL 被脱敏，所有上下文在传输前均向用户展示。
• 桥接本地 AI 代理与日常网页工作流，无需离开浏览器即可实现强大、上下文感知的辅助。

---

资源

• 项目仓库：https://github.com/abundantbeing/hermes-browser-extension
• Hermes Agent 文档：https://hermes-agent.nousresearch.com/docs
• Firefox 扩展：https://addons.mozilla.org/en-US/firefox/addon/hermes-browser-extension/

以上所有细节均直接取自仓库的 README。