WillHint

English

WillHint 是一款 Chrome 擴充功能，在你瀏覽網頁時悄悄解釋陌生詞彙與術語 — 以瀏覽器原生通知的方式呈現，完全不打斷你的閱讀節奏。

---

為什麼選擇 WillHint？

大多數查詢工具需要你停下來、複製單詞、切換分頁、貼到搜尋引擎或 AI 聊天介面、等待回應、再切換回來。光是拿到答案就要五個步驟。

WillHint 將這個流程縮短為：自動掃描零步驟，或右鍵一步取得解釋。答案以原生 OS 通知送達 — 不開新視窗、不跳出彈窗、不切換情境。

與其他工具的比較

	WillHint	Google 搜尋	AI 聊天
取得解釋所需步驟	0–1	5+	4+
打斷閱讀	否	是	是
瀏覽時自動運作	是	否	否
可自訂模式	是	否	否
用自然語言設定	是	—	—

---

功能特色

瀏覽器通知推送

解釋以原生 OS 通知送達 — 和收到電子郵件或訊息時一樣低調的小彈窗。不開新分頁、不彈出視窗、不中斷閱讀。瞄一眼，讀懂，繼續。

自動掃描 — 被動學習，邊看邊懂

開啟後，WillHint 會透過瀏覽器的 Intersection Observer API 偵測畫面上的可見內容。當它在你正在閱讀的文章中發現令人困惑的技術術語時，會自動送出提示通知。你什麼都不需要做。

自訂模式 — 打造你的專屬快捷工具庫

除了預設的「解釋」與「簡化」以外，你可以自訂任何模式，例如：

• 翻譯 — 將選取的文字翻譯為你的語言
• 摘要 — 將長段落壓縮成一句話
• 縮寫展開 — 解釋縮寫全稱（如 API、RLHF、SLA）
• 單位換算 — 轉換數值（如華氏轉攝氏、英里轉公里）
• 語氣改寫 — 正式或口語化改寫

每個模式就是一個提示詞範本。只需設定一次，之後任何頁面都能一鍵右鍵使用。

自然語言設定

你不需要手動編輯 JSON 或逐一操作設定面板。打開彈窗的「聊天」分頁，用中文描述你想要的變更：

「把掃描提示改成尋找醫學術語」 「新增一個叫做『翻譯』的模式，翻譯成繁體中文」 「關閉自動掃描」

聊天機器人會幫你更新設定。

框選即解釋

框選頁面上任意兩個字以上的文字，WillHint 會自動在短暫停頓後觸發你的第一個自訂模式 — 不需要右鍵。

---

支援的 AI 服務商

服務商	說明
Anthropic	Claude 系列模型（Haiku、Sonnet、Opus）
Google Gemini	Flash 與 Pro 系列
OpenRouter	提供多種模型，包含免費額度選項
OpenAI 相容格式	任何符合 OpenAI /chat/completions 格式的端點

---

安裝方式

WillHint 目前為開發者版本（尚未上架 Chrome 線上應用程式商店），請手動載入：

1. 複製或下載此儲存庫

   git clone https://github.com/yezuochen/WillHint.git
   

2. 開啟 Chrome，前往 chrome://extensions
3. 開啟右上角的開發人員模式
4. 點擊載入未封裝項目
5. 選取下載儲存庫中的 extension/ 資料夾

---

初始設定

首次啟動時會顯示設定表單：

1. 選擇 AI 服務商 — Anthropic、Gemini、OpenRouter 或 OpenAI 相容格式
2. 選擇模型 — 從清單選擇或手動輸入模型名稱
3. 貼上 API 金鑰 — 僅儲存於本機裝置，不會同步至任何伺服器
4. 點擊儲存

你的 API 金鑰儲存於 chrome.storage.local，不會上傳至 Google 的同步伺服器。

---

使用方式

右鍵解釋

1. 在頁面上選取任意文字
2. 右鍵 → 選擇模式（如解釋、簡化或你新增的自訂模式）
3. 通知送出，標題為關鍵詞，內容為解釋

框選自動解釋

1. 在任何頁面上框選兩個字以上的文字
2. WillHint 短暫停頓後自動執行你的第一個自訂模式
3. 通知送出 — 不需要任何點擊

自動掃描

1. 開啟擴充功能彈窗 → 設定分頁
2. 啟用自動掃描
3. 正常瀏覽即可 — WillHint 會偵測畫面上的內容，發現困難術語時自動通知你

新增自訂模式

1. 開啟擴充功能彈窗 → 設定分頁
2. 捲動至自訂模式 → 點擊 + 新增模式
3. 輸入模式名稱（如「翻譯」）
4. 撰寫提示詞範本，使用 {selected}（選取文字）與 {content}（頁面內容）作為變數
   • 提示詞必須要求 AI 輸出格式：[keyword]&[explanation]
   • 範例：將 '{selected}' 翻譯成繁體中文。僅輸出：[原文]&[翻譯]
5. 點擊儲存設定
6. 新模式立即出現在右鍵選單中

用自然語言設定

1. 開啟擴充功能彈窗 → 聊天分頁
2. 描述你想變更的內容：
   • 「新增一個『單位換算』模式，將溫度換算成攝氏」
   • 「把掃描提示改成專門尋找法律術語」
   • 「刪除簡化模式」
3. 助理更新設定並確認變更

---

提示詞格式

所有自訂模式的提示詞必須要求 AI 以以下格式輸出：

[keyword]&[explanation]

• keyword — 關鍵詞（1–3 個詞），顯示為通知的粗體標題
• explanation — 通知的內文說明

AI 輸出範例：[API]&[讓軟體之間互相溝通的一套規則]

---

隱私說明

• API 金鑰儲存於 chrome.storage.local — 僅限本機，不會同步
• 頁面文字會傳送至你選擇的 AI 服務商以生成解釋 — 等同於你自行複製貼上的資料
• WillHint 本身不蒐集任何資料

---

專案結構

WillHint/
├── extension/              ← 在 Chrome 中載入此資料夾
│   ├── manifest.json
│   ├── background/
│   │   └── service-worker.js
│   ├── content-scripts/
│   │   └── content.js
│   ├── popup/
│   │   ├── popup.html
│   │   ├── popup.js
│   │   └── popup.css
│   ├── settings/
│   │   └── defaults.json
│   └── assets/
│       └── icons/
└── .gitignore

---

授權

MIT