839· 73 forks· JavaScript· MIT开发工具

Hermes Agent 浏览器扩展:本地AI助手的网页上下文桥梁

abundantbeing/hermes-browser-extension

Chrome/Edge侧边栏扩展,连接本地或云端Hermes Agent运行时,将当前网页内容、标签页信息作为上下文发送给AI代理处理

成熟度维护活跃,最近提交1天前,open issues 3个,处于公开alpha阶段

项目体检

部署 · 浏览器扩展手动加载,需本地Hermes Agent运行时(默认http://127.0.0.1:8642),或连接Hermes Cloud/自托管远程网关

成本 · 依赖本地或远程Hermes Agent运行时(含API服务器),云端模式需已登录的HTTPS代理标签页签发临时票据,本地模式开箱即用无需外部Key

技术 · JavaScript开发,基于Chrome MV3扩展架构与Side Panel API,前端集成Hermes Desktop同款主题系统

许可 · MIT协议,可自由商用、修改和分发

活跃 · 最新版本v0.1.10发布于5天前,5位贡献者参与,最近提交1天前,活跃维护中

解决什么

传统浏览器AI插件通常是独立聊天机器人,无法复用本地已配置的AI运行时环境。Hermes Browser Extension打破这一局限,将Chrome/Edge侧边栏直接连接到本地或远程的Hermes Agent完整运行时。它能捕获当前网页的标题、URL、可读文本、元数据、表单、链接等结构化信息,作为上下文注入到Hermes会话中,让AI代理在处理任务时能"看见"浏览器正在做什么。这种设计让开发者可以在浏览器中直接调用本地配置好的模型、工具、技能和MCP服务器,而不是重新配置一套独立的浏览器插件环境。

为何火

该扩展在GitHub上线18天即获得839星,核心吸引力在于"浏览器原生+本地优先"的架构设计。它支持三种连接模式:本地网关(默认127.0.0.1:8642)、Hermes Cloud(通过已登录标签页签发临时票据)、自托管远程网关,满足从隐私敏感到团队协作的不同场景。扩展采用Chrome MV3规范的Side Panel API,无需debugger、cookies、历史记录等敏感权限,仅请求必要的activeTab和scripting权限。对于已经部署Hermes Agent的用户,这是最自然的浏览器集成方案——无需重新训练工作流,直接复用现有配置。

核心功能

扩展提供会话管理、上下文范围控制、工具调用可视化三大核心能力。会话管理支持创建/切换会话、复制会话ID、智能首消息标题生成,且浏览器内的模型选择不会影响Hermes全局默认配置。上下文范围可通过编辑器头部菜单切换"仅聊天"(不附加网页内容)、"跟随活动标签"、"固定特定标签"或"选择多个打开的标签页"。工具调用时会显示实时Tool Activity Strip,将Hermes运行时的工具执行过程结构化展示,而非混在回答文本中。

扩展内置快捷命令如/summarize(总结页面)、/explain(解释内容)、/tabs(分析打开的标签页)、/action-items(提取行动项),以及/meta命令用于分析捕获的页面元数据真实性。每次发送后会显示可折叠的"What Hermes saw"收据,透明展示发送给AI的上下文内容,便于调试。支持语音输入(优先使用Hermes音频转录,回退到浏览器语音识别),以及Desktop同款的6种主题(Nous/Midnight/Ember/Mono/Cyberpunk/Slate)和明暗模式切换。

安装

  1. 确保本地已安装并运行Hermes Agent(需启用Gateway/API服务器)
  2. 克隆仓库:git clone https://github.com/abundantbeing/hermes-browser-extension.git
  3. 安装依赖:npm install(需Node.js 20+)
  4. 构建扩展:npm run build
  5. 打开Chrome/Edge扩展管理页面,启用"开发者模式"
  6. 点击"加载已解压的扩展程序",选择构建输出目录
  7. 默认快捷键Alt+H打开侧边栏,可在chrome://extensions/shortcuts自定义

扩展尚未上架Chrome Web Store,需手动加载。本地模式下默认连接http://127.0.0.1:8642,可在设置中切换端口或配置远程网关地址。

适合谁

主要面向三类用户:1)已部署Hermes Agent的AI开发者,需要在浏览器中复用本地模型和工具链;2)注重隐私的用户,希望网页上下文在本地处理而非发送到第三方API;3)需要自托管AI助手的团队,可通过远程网关模式共享Hermes运行时。不适合纯云端AI服务用户——扩展设计假设你已有Hermes运行时环境,而非提供开箱即用的在线服务。中国大陆用户使用本地模式无需梯子,但Hermes Cloud模式需访问国外域名。

社区评价

暂无足量社区公开讨论,以下为基于项目本身的中立评估:该扩展在技术架构上体现了"浏览器扩展作为瘦客户端"的设计理念,将AI能力完全委托给后端Hermes运行时,避免了传统插件需要内置模型或重复配置的问题。v0.1.10版本引入的Copy Diagnostics功能和兼容性面板,显示出作者对生产环境调试需求的理解。项目处于公开alpha阶段,功能迭代较快(5天前发布最新版本),但文档中明确标注"Not on Chrome Web Store yet",说明尚未通过商店审核流程,可能存在稳定性或合规性待完善之处。

选型对比

与传统浏览器AI插件(如ChatGPT for Chrome、Monica)相比,Hermes扩展不是独立服务,而是本地AI运行时的前端界面。优势在于:1)复用Hermes已配置的模型、工具、MCP服务器,无需重复设置;2)支持完整的Hermes会话持久化和工具调用能力;3)本地模式下数据不出本机。劣势是:1)必须先部署Hermes Agent,安装门槛高;2)未上架商店,更新需手动操作;3)依赖Hermes运行时稳定性,网关崩溃则扩展不可用。

对比Hermes Desktop应用,扩展的取舍是:牺牲了独立窗口和系统级集成(如全局快捷键、通知),换取浏览器原生的标签页上下文捕获能力。扩展的"固定标签页模式"可为特定网页保持独立会话历史,这是桌面应用难以实现的场景。

已知坑

  1. 手动安装维护成本:未上架Chrome商店,每次更新需手动拉取代码重新构建加载,不适合非技术用户
  2. 依赖Hermes运行时版本:README提到兼容性面板会让旧版网关降级到"显式回退/手动模式",说明不同Hermes版本可能导致功能缺失
  3. Cloud模式限制:Hermes Cloud连接被设计为"Chat-only",无法使用完整工具链,仅适合轻量对话场景
  4. 权限范围有限:v0.1明确不包含debugger、cookies、历史记录、下载等权限,无法处理需要深度浏览器控制的任务
  5. Python异常透传:文档提到会捕获上游Hermes的Python NoneType/int()异常,说明后端错误可能直接暴露给用户,调试体验依赖Hermes运行时质量
  6. 中文网页处理:README未提及多语言支持,网页文本提取对中文排版(如竖排、复杂表格)的兼容性未知

安装方式:手动加载未打包扩展(Load unpacked)