前言¶
在 DeepSeek Harness（DSH）裏接免費或匿名 LLM，常見做法是自行改 cordis.yml、填第三方 API Key，或依賴已經失效的「萬能 key」端點。模型一換、網絡一抖，還要自己維護分流和用量統計。社區插件 shendao325/dsh-freebridge（目錄頁：SkillHub）把匿名模型橋接、Token 記賬、網絡分流、桌面編排、操作守門和模塊級故障隔離收進一個工作流類插件，維護者爲 shendao325，目標是「裝完即用」：不登錄、不註冊、不填 API Key，模型直接進選擇器，設置頁有完整界面。
這是什麼¶
FreeBridge 是 DSH 一體化插件（版本 1.0.0，MIT 許可證）。它不替代 DSH 宿主，而是在插件進程內完成協議轉換、轉發與本地統計；主上游通道爲 Kilo Gateway（README 寫明匿名可直接 200、無需 key，並提到實測可拉到 408 個可用模型）。插件聲明零運行時依賴，Node 需滿足 ^22.19.0 || >=24.0.0，peer 依賴包括 @deepseek-ai/cordis、@deepseek-ai/dsh-llm、@deepseek-ai/schemastery。
DSH 生態理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能（六個模塊）¶
下面按 README 劃分的六個模塊說明能力邊界；任一模塊出錯不會阻斷 DSH 啓動，設置頁可查看狀態並單獨重啓。
Token 用量統計¶
雙計數避免重試虛增：邏輯級只記最終成功渠道（設置頁默認）；嘗試級記每次真實發出的請求。賬本按請求事件追加寫，編輯/撤回只改標記、不回溯扣減；旁支提問單獨記 branch=true；失敗請求記 attempt 但 billable=unknown，不算進渠道消耗。只存計數與元數據，不存 prompt/completion 原文。設置頁支持按渠道、模型、日趨勢查看，會話統計支持「會話 → 供應商 → 模型」三層下鑽。
按需網絡分流¶
直連優先，超時或失敗再走代理；規則自學習，不強制用戶維護域名列表。模型請求與網頁抓取分兩條策略；連續失敗 2 次才改判代理。節點健康只標記不刪除。
桌面操作編排¶
插件只做編排層，調用宿主已註冊的桌面控制能力；需要才拉起應用，無底層能力時提示手動操作，不靜默假裝成功。
操作邊界守門（默認開啓）¶
子操作（桌面、網絡、文件寫入等）發出前做範圍檢查：硬禁區直接 deny，意圖不匹配 ask，可選 AI 審查處理灰色地帶；審查失敗降級爲 ask。三態：allow / ask / deny。
零配置體驗¶
全部配置項有默認值；首次引導只問兩個問題（是否自動配置免費模型、是否開啓守門），均有默認「是」。探測失敗不阻塞啓動。
插件級故障隔離¶
模塊可降級運行；/freebridge/restart?module= 可單獨重啓某模塊。README 提到賬本與分流同時異常時對話仍可正常進行。
設置頁入口：重啓 DSH 後打開 設置，左側 FreeBridge，數據來自同源接口 /freebridge/*。
安裝與啓用¶
官方提供兩種方式；本地腳本要求實體拷貝到 profile 的 node_modules（軟鏈接會導致找不到宿主 @deepseek-ai/schemastery 而崩潰）。
方式一：本地安裝腳本（README 推薦）
git clone https://github.com/shendao325/dsh-freebridge.git
cd dsh-freebridge
node tools/install-local.mjs
腳本會把插件實體拷貝到 profile、註冊 dsh-freebridge 到 dsh.profile.bundles 並確認掛載點。完成後重啓 DSH。
方式二：標準插件命令
dsh plugin --profile desktop add dsh-freebridge
重啓 DSH 後，模型選擇器出現 FreeBridge 分組；選 kilo-auto/free 即可開始對話。首次啓動會自動完成上游探測、分流初始化、守門與統計賬本，無需改 cordis.yml（README 寫明重啓不會被覆蓋）。
典型用法¶
- 安裝並重啓 DSH，確認啓動日誌有
[freebridge] ready；若無 FreeBridge 分組，按 README 排查是否已重啓。 - 在模型選擇器選 FreeBridge 分組下的 Kilo 模型（如
kilo-auto/free），正常對話即可。 - 在設置 → FreeBridge 查看模塊狀態、Token 用量、分流與守門；需要時用設置頁或 HTTP 單獨重啓模塊。
宿主在 exposeHealth: true 時可只讀訪問健康與統計，例如：
/freebridge/health
/freebridge/stats?level=attempt
/freebridge/sessions
/freebridge/session?id=
/freebridge/restart?module=
完整路徑表見 GitHub README「接口」一節。
README 還對比了若干已失效的免費接入方式（如 LLM7 萬能 key、Pollinations 老端點、OpenCode -free 池等），並說明若對話報「額度已用盡」應切到 FreeBridge 的 Kilo 模型而非 OpenCode 免費池。
適用場景與注意¶
適合誰： 想在 DSH 裏快速試用匿名免費模型、同時需要本地 Token 統計、網絡分流和操作守門的工作流開發者；願意接受免費上游隨時變更的風險。
權限與安全： 插件以當前 DSH 進程權限運行；安裝前應自行審閱 源碼 與 MIT 許可證。README 明確：免費池可能記錄 prompt 用於改進服務，不要發送敏感內容；僅供個人學習與測試，遵守各上游服務條款。
自測： 倉庫內可運行 node test/all.mjs（14 套件、356 項斷言），用於驗證 adapter 契約、賬本、分流、守門等邏輯。
結尾¶
dsh-freebridge 把免費模型接入與用量、網絡、桌面、守門、隔離合成一條可落地的 DSH 插件路徑，減少手改配置和依賴失效端點。進一步瞭解請查看 SkillHub 目錄頁 與 GitHub 倉庫。
