No Swallow

一個專為 Firefox 設計的輕量級瀏覽器擴充功能。讓你在任何網頁連結上點選右鍵，即可自動在背景抓取內容、精簡雜訊，並調用本地的 Ollama AI 模型（如 Gemma 3）在側邊欄進行即時串流摘要。

功能特點

• 右鍵選單整合：免去複製貼上，一鍵「AI 連結分析」直接投遞目標網頁。
• 正文精準提取：內建 Mozilla 官方 Readability.js，自動剔除導航欄、廣告與頁尾等雜訊。
• 本地隱私安全：完全基於本地 Ollama API 運行，網頁數據與對話內容 100% 不外流。
• 動態模型切換：自動偵測並列出本地已下載的所有 Ollama 模型，支援在側邊欄隨時切換與持久化記憶。
• 流式傳輸 UI：支援 Stream 模式，AI 摘要像打字機一樣即時在側邊欄滾動呈現。
• 自訂深度提示詞：內建獨立的 prompt.js 模組，可自由調教專屬的摘要邏輯。

專案檔案結構

├── manifest.json         # 擴充功能設定檔 (Manifest V3)
├── background.js         # 背景服務邏輯 (處理右鍵、網頁抓取、Ollama 通訊)
├── prompt.js             # 自訂 AI 提示詞 (Prompt) 模組
├── sidebar.html          # 側邊欄 UI 介面
├── sidebar.js            # 側邊欄腳本 (處理模型下拉選單與串流接收)
└── lib/
    └── Readability.js    # Mozilla Readability 核心庫

配環境指南

由於瀏覽器擴充功能（moz-extension://）與本地 Ollama 之間存在跨來源資源共用 (CORS) 限制，在安裝套件前，請務必根據你的作業系統進行以下配置：

Linux (Systemd 服務版)

如果你是使用 Linux 且 Ollama 預設在背景以服務形式運行：

1. 開啟 Systemd 編輯器（此指令會自動建立 override 檔案，免手動建檔）：

sudo systemctl edit ollama.service

警告：此指令使用 Root 權限，風險自負。

1. 在開啟的設定檔加入以下環境變數（注意：請勿加引號）：

[Service]
Environment=OLLAMA_ORIGINS=moz-extension://*
Environment=OLLAMA_HOST=0.0.0.0

1. 儲存離開後，重新載入並重啟服務：

sudo systemctl daemon-reload
sudo systemctl restart ollama

1. 使用自訂的語言模型（確保以 ollama 使用者權限下載至系統路徑）：

ollama pull gemma3:4b # 範例，可以改成任何自己想要嘗試的模型，請自行斟酌電腦算力和所需的模型參數大小（建議 4B 以上）

Windows

1. 設定系統環境變數：

• 搜尋並開啟「編輯系統環境變數」。
• 點擊「環境變數」按鈕。
• 在「使用者變數」區塊點擊「新增」。
• 變數名稱：OLLAMA_ORIGINS，變數值：moz-extension://*。

1. 重啟 Ollama：

• 在右下角工作列系統匣找到 Ollama 圖示，右鍵選擇 Quit Ollama。
• 重新在開始功能表啟動 Ollama。

1. 下載模型：開啟 PowerShell 執行 ollama pull gemma3:4b。

MacOS

1. 設定臨時環境變數並重啟：

• 開啟終端機執行：

launchctl setenv OLLAMA_ORIGINS "moz-extension://*"

1. 重啟 Ollama：

• 點擊上方選單列 Ollama 圖示，選擇 Quit Ollama。
• 重新在應用程式資料夾中開啟 Ollama。

1. 下載模型：開啟終端機執行 ollama pull gemma3:4b。

安裝與使用步驟

1. 安裝 ollama 並設定好背景服務運行

請參考ollama 的官方文檔。

2. 載入至 Firefox

1. 開啟 Firefox，在網址列輸入 about:debugging#/runtime/this-firefox。
2. 點擊右側的 「Load Temporary Add-on...」 (載入暫時擴充功能)。
3. 選擇本專案目錄中的 manifest.json 檔案。

3. 安裝完成，開始使用

現在可以右鍵點擊網頁連結，按下「使用 No Swallow 分析此連結」，側邊欄會自動彈出，可以選擇本機有的模型對連結內容進行預覽和分析。

自訂提示詞說明

你可以直接編輯 prompt.js 中的 AI_SUMMARY_PROMPT 變數。該模組使用 JavaScript 樣版字面值（Template Literals）設計，支援多行文本，能讓你輕鬆調整 AI 的摘要風格、輸出格式或限制回答字數。

授權條款

本專案基於 MIT License 條款開源。