hermes-browser-extension

这是什么？适合谁？

Hermes Browser Extension 是 Hermes Agent（Nous Research）的浏览器原生侧边栏（Chrome/Edge/Chromium MV3，Side Panel API）。它不是浏览器聊天机器人—侧边栏连接的是真正的 Hermes Agent 运行时：可选本地网关（默认 http://127.0.0.1:8642）、Hermes Cloud（Trusted Dashboard Attach 签名标签页签发一次性 WebSocket 票据）或自托管远端网关。本地/远端 API 连接可用你已配置的模型、工具、技能、会话、记忆与 MCP 服务器；页面上下文（标题/URL/选中文本/正文/表单/链接/按钮）被打包为”不可信上下文”注入 Hermes 会话。作者 Jon Komet（@abundantbeing），社区扩展，v0.2.0 公测版（尚未上架 Chrome Web Store，需开发者模式加载）。

适合人群：已在使用 Hermes Agent 且日常在浏览器里工作的开发者与知识工作者；想让 Agent”看见当前页面”再对话的人；重视隐私边界（上下文可见、可裁剪、凭证 URL 自动剔除）的人。 使用前提：Hermes Agent 已安装可用；本地/远端 API 模式需启用 Gateway/API server；Node.js 20+；Chromium 114+（Firefox 142+ 有预览构建）。

快速上手（3 步）

第一步：构建并加载扩展

git clone https://github.com/abundantbeing/hermes-browser-extension
cd hermes-browser-extension
npm install && npm run build

在 chrome://extensions 打开开发者模式 -> “加载已解压的扩展程序” -> 选择 dist/ 目录。

第二步：连接你的 Hermes

侧边栏设置里选择连接方式：

• Local gateway：默认 http://127.0.0.1:8642（Hermes 本地 API）
• Hermes Cloud：需一个已登录的 HTTPS Hermes 云端 Agent 标签页（签发一次性票据，仅 Chat 模式）
• Remote gateway：自托管远端 API URL + token

第三步：带着页面上下文对话

打开任意网页，按 Alt+H 唤起侧边栏，直接提问。发送后可展开”What Hermes saw”回执，核对扩展到底把哪些页面内容发给了 Hermes。快捷命令 /summarize、/explain、/rewrite、/tabs、/action-items 开箱即用。

初级用法

• 上下文范围三档：Chat only / 跟随活动标签页 / 仅当前页，在输入框头部菜单切换；还可固定某个标签页或挑选哪些打开的标签进入提示。
• 会话管理：创建/切换/重命名会话、复制会话 ID、智能首条消息标题；固定标签页的会话彼此隔离（每标签本地历史 + Hermes 会话绑定）。
• Hermes Web 全页视图：打开扩展的完整视图，获得会话栏、富 Markdown、模型/运行时控制、生成媒体与上下文遥测面板。

高级玩法

1. Hermes Assist 起草回复：v0.2.0 的紧凑起草面板识别 31 种写作环境（邮件/工单/社媒等），按站点自适应”起草回复/帖子/消息”；模型动作全部经由连接的 Hermes 执行，草稿须显式用户动作才应用，永不自动点击发送。
2. 接全量 Hermes 能力：本地网关下自动同步 providers/models、profiles、skills、sessions；Hermes 会话里的运行时插件（社交/消息插件）可与扩展提供的页面上下文同场工作。
3. Copy Diagnostics 排障：一键导出支持报告（浏览器族/版本/扩展来源/网关来源/能力标志/上下文模式/最近错误，已剥离 token 与页面内容），配合兼容性面板把旧网关降级为明确的 fallback 模式而非报错。

常见踩坑（5 条）

踩坑 1：连接本地网关失败

• 现象：侧边栏报无法连接 127.0.0.1:8642
• 原因：Hermes Gateway/API server 未启用或端口不一致
• 解决：在 Hermes 中启用 API server 并核对端口；多实例时用 localhost agent picker 切换端口

踩坑 2：Cloud 模式没有页面上下文

• 现象：Hermes Cloud 连接后只有纯聊天
• 原因：设计如此—Cloud 与票据式远端仪表盘连接强制 Chat-only，票据内存态、单次有效
• 解决：需要完整工具/技能/页面上下文时改用本地或远端 API 连接

踩坑 3：Firefox 装不上

• 现象：Firefox 加载扩展失败
• 原因：Firefox 包是预览态，需单独构建
• 解决：npm run build:firefox 产出 dist/firefox/；主力支持目标仍是 Chromium 系

踩坑 4：担心扩展偷看浏览记录

• 现象：安全评审质疑权限
• 原因：对 v0.2.0 权限清单不了解
• 解决：说明该版本无 debugger/nativeMessaging/cookies/history/bookmarks/checkout/导航/自主浏览器控制权限；带凭证的 tab URL（含解码后的 query/hash 参数）会从提示上下文中剔除

踩坑 5：旧版 Hermes 网关行为异常

• 玑象：部分功能报路由错误
• 原因：旧网关缺少新能力
• 解决：查看 Hermes 兼容性面板，旧网关会显示明确的 fallback/手动模式；升级 Hermes 或按面板提示操作

FAQ（5 个常见问题）

Q1：收费吗？上架商店了吗？ A：开源免费（公测 v0.2.0），尚未上架 Chrome Web Store，需”加载已解压”方式安装。

Q2：和直接开一个 Hermes 网页版有什么区别？ A：侧边栏的核心增量是活动浏览器上下文—当前页正文、选中文本、打开的标签列表都能注入会话，且每轮发送前有”What Hermes saw”回执可审计。

Q3：数据安全吗？ A：页面文本包装为不可信上下文；凭证 URL 剔除；上下文对用户可见、可选择范围；无高危权限。但页面内容终归会发给你连接的 Hermes 运行时，远端连接建议走 Tailscale/VPN 或 HTTPS 反代，不要把 Hermes 裸暴露公网。

Q4：能控制浏览器自动操作吗？ A：v0.2.0 明确不做自主浏览器控制（无 debugger/nativeMessaging）；Hermes Assist 只起草内容且永不提交。

Q5：支持哪些浏览器？ A：Chrome/Edge/Chromium 114+ 为主力目标；Brave/Comet 等 Chromium 分支尽力支持；Firefox 142+ 预览包；Safari 未发布。

小技巧（5 条）

1. Alt+H 快捷键：默认快捷键可在 chrome://extensions/shortcuts 自定义，配合”标签附加面板”模式几乎零切换成本。
2. 全局面板 vs 标签附加：默认随标签附加；跨标签连续工作时在设置里切成全局面板。
3. 语音听写：连接的 Hermes 支持音频转写时直接用；不支持时自动落到浏览器语音识别兜底。
4. Tool Activity Strip 看工具流：Hermes 流式输出时工具调用以结构化活动条展示，便于理解 Agent 在干什么。
5. 模型选择留在扩展内：浏览器侧的模型选择与每会话绑定不会改 Hermes 全局默认，多面板并行工作互不干扰。

进阶学习建议

• 精读 README 的 Trusted Dashboard Attach 设计：一次性 WebSocket 票据如何在免 cookie 导入的前提下安全连接云端 Agent，借鉴到自己的扩展鉴权设计
• 研究九套主题与 Light/Dark/System 模式的实现，以及 MV3 Side Panel API 的标签附加/全局切换策略
• 尝试 Hermes Browser Companion Plugin（只读缓存脱敏 Browser Context Protocol 元数据给 Hermes 工具/hooks），理解”被动上下文缓存”与”主动浏览器控制”的边界设计
• 对照 /meta 命令”只报告实际捕获到的元数据类”的诚实设计，学习如何给自己的 Agent 工具写不过度声称的输出

参考链接

• Hermes Browser Extension GitHub 仓库
• Hermes Agent 官方文档

本文基于公开资料于 2026-08-18 整理，社区指标反映 GitHub 公开数据。独立实测未进行，功能和配置项可能随版本更新而变化，请以官方文档为准。