文件

Page Assist

Page Assist 原本是為本機 Ollama 打造的，同一個畫面也能設定託管端點：依序前往 Settings → OpenAI Compatible API → Add Provider → Custom，填入三個欄位後，側邊欄就能用 Claude 或 GPT 摘要目前分頁，而不是受限於筆電 RAM 能容納的模型。

Settings → OpenAI Compatible API → Add Provider → Custom：設定 Provider Name、保留 /v1 的 Base URL 與金鑰，然後從 Page Assist 自行取得的清單中勾選模型 ID。

設定 → OpenAI Compatible API → Add Provider → Custom

Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra

Base URL 要保留 /v1 後綴。 OpenAI Compatible API 頁面本身沒有明說——欄位說明有。其輔助文字寫道：「OpenAI API 提供者的 Base URL，例如 (http://localhost:1234/v1)」，而同一欄位的兩個相鄰提供者頁面所列的具體 URL 也一致：LM Studio 的「預設為 http://localhost:1234/v1」，以及 LLaMA.cpp 的 http://localhost:8080/v1。Page Assist 只會附加路徑，因此只填來源網址會得到 404，而非 401——這和 Anthropic 風格的用戶端正好相反；後者只需要來源網址。

通常會自動擷取模型清單，無須手動輸入。在 Save 後，Page Assist 會開啟 Model List，並顯示「請選取要搭配此提供者使用的聊天模型」，清單內容由端點提供。Kunavo 會回應 GET /v1/models，因此清單會自動填入。如果清單為空，擴充功能會顯示「找不到模型。請確認已使用正確的 Base URL 和 API 金鑰新增提供者」，這是準確的：清單空白更常是 Base URL 或金鑰問題，而非目錄問題。修改擴充功能前，請先用下方的 curl 確認問題所在。你也可以透過 Add Custom Model 手動新增 ID；其 Model ID 欄位可直接填入本頁表格中的代稱，無須修改。

選擇 Chat Model，而不是另一個單選選項。 Add Custom Model 表單提供 Model Type 選項，而 Kunavo 不提供 embedding 模型——目錄中沒有任何項目能回應該端點，因此第二個選項在此無從設定。Knowledge Base 功能需要這類模型：供應商自己的頁面指出，您必須在 RAG Settings 中設定一個，並建議使用 nomic-embed-text。請同時設定本機 Ollama 來處理這項工作——Page Assist 可以同時保留多個供應商，而且這兩種用途不必使用同一個來源。

音訊設定要另外處理。 Page Assist 的 Text-to-Speech 區段提供 OpenAI TTS 供應商，並有自己的 API Key、Base URL 和 TTS Model，而 Kunavo 不提供文字轉語音模型。反過來也是如此：Kunavo 不提供語音轉文字模型，而 Page Assist 的語音輸入使用的是瀏覽器內建辨識器，透過 Speech Recognition Language 設定，完全不會呼叫 API。這兩個區段維持目前的設定即可。

本設定是依據供應商的文件和介面文字，於下方日期查核整理而成。Kunavo 並未讓 Page Assist 連線至其端點——沒有固定擴充功能版本、側邊欄工作階段、串流回覆或工具往返測試。已發布的設定頁面不等於測試，因此本頁內容不應被視為測試結果。您可以在十秒內自行確認curl；擴充功能在可用端點上的行為則取決於您和 Page Assist。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Page Assist 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
按一下瀏覽器工具列上的 Page Assist 圖示，再按一下 Settings 圖示，然後前往 OpenAI Compatible API 分頁。
按一下 Add Provider。Kunavo 不在下拉式選單的預設選項中，因此請選擇 Custom——供應商在步驟 5 中指出，清單中沒有的項目都應選這個選項。
填入 Provider Name、Base URL = https://api.kunavo.com/v1 和 API Key，然後按一下 Save。
在開啟的 Model List 中，勾選您要使用的 ID。通常選兩個最合適：一個用於網頁摘要，另一個用於後續問題。
在實際網頁上開啟側邊欄——Ctrl+Shift+L 會開啟 Web UI——從選擇器中挑選模型，然後詢問它目前分頁的內容。包含實際內容的網頁比問候訊息更能提供資訊，因為產生成本的是網頁文字。

已於 2026年9月21日根據 Page Assist 的 OpenAI Compatible API 頁面進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Page Assist 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

模型 ID	Kunavo 輸入／輸出	它在 Page Assist 中的位置
`claude-haiku-4-5`	$0.70 / $3.50	適合側邊欄的預設選擇：處理網頁摘要和後續問題時，使用量是主要考量
`gpt-5-6-terra`	$0.70 / $4.20	適用於文件、討論串、逐字稿等長網頁，整份內容都傳送而不裁切
`claude-sonnet-5`	$1.40 / $7.00	適合摘要後的問題，答案必須正確時使用
`gpt-5-6-sol`	$2.00 / $12.00	來自另一個系列的第二個意見；以相同供應商再加入一個勾選的 ID

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

網頁會產生多少費用，以及哪些資料會離開瀏覽器

側邊欄用戶端的計費方式與編輯器不同，差別在於網頁內容。Page Assist 每次與目前分頁對話時，都會把擷取到的分頁文字作為輸入 token；文件頁面或長篇討論串可能包含數萬個 token，而且同一段對話中的每次追問都會再次傳送。因此，上方的模型表格會優先列出便宜的 ID：在這類用戶端中，輸入端的用量通常比輸出端高出一個數量級；讓 claude-haiku-4-5 或 gpt-5-6-terra 閱讀整頁，比讓更強的模型閱讀遭截斷的內容更划算。

供應商的 Settings 頁面列出了三項會增加額外流量的設定，即使您沒有明確要求這些功能：

使用 AI 產生標題——「根據對話自動產生聊天標題」。每段對話會多呼叫一次模型，使用當下選取的模型。
Internet Search，搭配預設為開啟的 Internet Search ON by default 和 Total Search Results——擷取的網頁會加入提示，因此 token 費用會隨結果數量增加。
頁面操作，即配套擴充功能——模型會「先讀取頁面，再逐步執行動作」，因此每個步驟都會讀取一次 DOM，而非每段對話只讀取一次。擴充功能的 每次操作前都需要核准預設為開啟，建議保持開啟。

隱私界線也依循相同原則。Page Assist 會將聊天、知識庫和設定儲存在瀏覽器的本機儲存空間；只有您傳送的內容會透過網路傳輸。選用此供應商後，這表示網頁文字、您的訊息和目前為止的對話內容都會傳送至 api.kunavo.com，再由該服務轉送給提供該模型 ID 的上游服務商——如需了解 Kunavo 端會保留哪些資料，請參閱隱私權政策。若某個網頁的內容是您不會貼到聊天視窗中的，請切回本機 Ollama；擴充功能可同時設定兩個供應商，正是為了讓您能透過下拉式選單快速切換。

如果您是從 OpenRouter 預設選項前來

OpenRouter 不需要使用 Custom 選項。它是供應商 OpenAI Compatible API 頁面列出的預設選項之一——與 Ollama、LM Studio、Groq、Together、Mistral、xAI 和約二十種其他選項並列——因此前四次點選相同，接著從下拉式選單選擇 OpenRouter，而非 Custom，在 API Key 欄位輸入 OpenRouter 金鑰，然後按一下 Save。此預設選項會自帶 Base URL，而且 OpenRouter 的模型 ID 帶有供應商前綴，格式如 anthropic/claude-sonnet-4.5；上方表格中的 ID 則沒有前綴。在此選擇供應商，也等於選擇您要輸入的 ID 命名空間。

特別是對這個用戶端而言，以下情況值得切換：您想在同一個畫面使用 Kunavo 沒有提供的模型，或是您已經有 OpenRouter 金鑰，額外設定成本為零。以下情況則值得切換至 Kunavo：表格中的 ID 也能用於您的程式開發工具，因此一把金鑰就能兩邊共用；此外，重新傳送網頁內容時的提示快取，才是側邊欄實際花費的主要影響因素——請參閱快取。您可以同時保留兩個供應商：Page Assist 會將它們一起列出，而模型選擇器不會限制模型來自哪一列。

常見問題

如何在 Page Assist 中使用自訂 API？

按一下瀏覽器工具列上的 Page Assist 圖示，開啟 Settings，前往 OpenAI Compatible API 分頁，再按一下 Add Provider。如果您的端點不在下拉式選單的預設選項中，請選擇 Custom，填入 Provider Name、Base URL 和 API Key，然後按一下 Save。接著 Page Assist 會開啟從端點取得的 Model List，您可以在其中勾選要搭配該供應商使用的聊天模型。如果取得清單時沒有任何結果，也可以透過 Add Custom Model 手動輸入 ID。

Page Assist 的 base URL 需要加上 /v1 嗎？

若使用 OpenAI 相容端點，就需要。OpenAI Compatible API 頁面沒有明確說明，但 Base URL 欄位本身的說明文字有寫——「OpenAI API 供應商的 base URL。例如 (http://localhost:1234/v1)」——LM Studio 和 LLaMA.cpp 頁面的相同欄位也列出相同後綴，分別是 http://localhost:1234/v1 和 http://localhost:8080/v1。Kunavo 的 URL 因此是 https://api.kunavo.com/v1。Page Assist 只會附加路由，因此省略後綴會產生 404，而不是驗證錯誤。

為什麼我新增供應商後，Page Assist 沒有顯示模型？

模型清單會使用您剛輸入的金鑰從端點取得，而擴充功能自己的訊息也指出應檢查什麼：「找不到模型。請確認您已新增正確的供應商，並填入 Base URL 和 API key。」使用 curl 對 /v1/models 發出請求，在擴充功能之外測試同一組 URL 和金鑰：收到 JSON 表示問題出在供應商設定；401 表示金鑰有誤；404 通常表示 Base URL 遺漏了 /v1。如果仍然無法解決，請透過 Add Custom Model 手動新增 ID；這種方式不依賴端點查詢。

Page Assist 可以使用 Claude 或 GPT 取代本機模型嗎？

可以。「OpenAI Compatible API」指的是線路格式，而不是供應商；模型 ID 會傳送至您設定的 Base URL，因此 Claude 或 GPT ID 會在該端點解析，而不是在擴充功能內解析。本機模型功能不受影響：Page Assist 可以同時保留多個供應商，因此 Ollama 和託管供應商可以並列，您也可以在模型選擇器中切換。

哪個模型最適合 Page Assist，費用也最低？

在這個用戶端中，輸入端的用量佔主要部分，因為與分頁對話時，每一輪都會重新傳送該分頁擷取到的文字。因此，適合的預設選項是便宜且上下文容量大的模型——一般網頁可用 claude-haiku-4-5，較長的網頁則用 gpt-5-6-terra——再加選 claude-sonnet-5 這類較強的 ID，處理答案攸關緊要的問題。本頁表格列出各模型每百萬 token 的費率；對側邊欄的費用而言，提示快取的影響比模型選擇更大。

Page Assist 的 Knowledge Base 可以使用 Kunavo 嗎？

無法用於索引部分。Knowledge Base 是 RAG 功能，供應商文件指出必須在 RAG Settings 中設定 embedding 模型，並建議使用 nomic-embed-text；Kunavo 不提供 embedding 模型，因此這個欄位需要改用其他供應商——通常會選本機 Ollama，與此供應商並用也不會衝突。聊天部分不受影響：文件完成索引後，您可以使用此供應商的任何聊天 ID 來回答文件相關問題。

Kunavo 測試過 Page Assist 嗎？

沒有。2026 年 9 月 21 日查核的是 Page Assist 自己的 OpenAI Compatible API 文件和擴充功能的英文介面文字——經由 Settings 的操作路徑、欄位標籤與順序、Base URL 範例，以及清單空白時顯示的訊息，均引自這些資料。Kunavo 並未安裝擴充功能、固定特定版本或透過它傳送請求，因此不對任何特定版本的串流、網頁擷取或 Model List 取得功能在該版本中的行為作出聲明。本頁的 curl 指令則可供您獨立驗證。