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。