什麼是HammerAI？
HammerAI 是一款本地優先的人工智慧角色聊天和寫作應用程序，具有外部 LLM 代理模式。
本 HammerAI 指南使用官方代理模式欄位：以 /v1 結尾的 API 基礎、確切的提供者模型名稱、API 金鑰以及僅應在已知時設定的可選上下文長度。代理模式將字元聊天模型請求路由到外部 API，而 HammerAI 繼續提供本地對話介面。使用 API 根和確切的模型名稱，將上下文長度留空，除非驗證值已知，並在測試短響應和較長會話之前重新載入聊天。
HammerAI 的官方 Proxy Mode 將角色聊天產生請求傳送至外部 OpenAI-compatible 服務。它使用四個代理字段，不需要本地模型下載或 HammerAI 託管模型帳戶。
从HammerAI官方界面启用代理
- 打開任意角色聊天。
- 將右側面板切換至 Settings。
- 找到 LLM 選單。
- 捲動到底部並選擇 Proxy。
- 使用以下值填寫代理表格。
将四个字段映射到TokenHub
- Proxy URL:
https://us-api.tokenhub.com/v1 - Proxy Model: TokenHub 型號目錄中的完整型號 ID
- Proxy API Key: 您的 TokenHub API 金鑰
- **Proxy Context Length:**可選；當真實極限未知時將其留空
官方的Proxy範例使用API基礎，例如LM Studio的/v1，而不是完整的請求路徑。最近的 HammerAI 版本可能會修剪意外提供的 /chat/completions 或 /completions 後綴，但直接輸入 /v1 根。
考慮 Web 和桌面之間的差異
TokenHub 是遠端 HTTPS 服務，通常不需要額外的 CORS 設定。當 Web 應用程式連接到本機服務（例如 LM Studio）時，HammerAI 中的 CORS 說明適用。不要將這些本機伺服器指令傳送到遠端 TokenHub URL。
使Proxy配置生效
儲存，發送一條短信，並在TokenHub請求日誌中確認其型號ID。 HammerAI 指出，某些服務需要在建立連線之前重新載入完整的應用程式。如果所有四個欄位都正確但沒有回應到達，請重新載入 HammerAI 並再次測試。
對於長聊失敗，請先清除或修正Proxy Context Length。對於 401，檢查 Proxy API Key。對於 404，確認 Proxy URL 停在 /v1。如果該型號不存在，則再次複製Proxy Model。檢查這四個欄位比應用不相關的局部模型參數更有用。
官方參考
如何選擇推薦模型？
HammerAI 代理模式常見問題解答
我應該輸入什麼作為代理 URL？
輸入以 /v1 結尾的 TokenHub API 庫。 HammerAI 的官方代理模式範例使用基本 URL 而不是完整的請求路徑。
我應該填寫代理上下文長度嗎？
它是可選的。當您不知道模型的最大上下文時，請將其留空；否則輸入準確值。
為什麼我保存後代理沒有反應？
檢查基本 URL、確切的型號名稱和 API 金鑰，然後重新載入聊天。 HammerAI 官方指南指出，某些服務需要完全重新載入。
HammerAI 在代理模式下將資料傳送到哪裡？
該角色聊天的模型請求將轉到配置的外部 API，而 HammerAI 提供本地介面。使用前檢查每個服務的資料處理。
如何安全測試 HammerAI 代理模式？
保存後重新加載聊天，發送短信，並在長時間對話之前在 TokenHub 日誌中確認確切的模型和請求狀態。
參考資料
本頁設定依據 TokenHub 教學與官方資料，最後驗證日期為 2026-09-08。
