前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常對話，常見做法是自備各家 API Key，或在多個客戶端之間切換模型來源。社區插件 dsh-our-free-model-fish 走另一條路徑：安裝後把匿名免費通道、Kilo 免費池，以及 CodeArts、CodeBuddy、TRAE 等十三個賬號渠道一併掛進 DSH 官方模型選擇器，並附帶 OpenAI / Anthropic 兼容的本地轉發端口，供 Claude Code、curl 或其它 harness 反代調用。
本倉庫是上游 Ebony-Vinyl/dsh-our-free-model 的社區改版（fork），以 npm 包名 dsh-our-free-model-fish 獨立發佈；能力主體來自上游，Fish-under-sea 在此基礎上做了少量增量。下文安裝與升級步驟以 GitHub README 爲準。
這是什麼¶
dsh-our-free-model-fish 是 DSH 的「模型推理」類插件（當前版本 2.2.0，許可證 MIT，README 標註適配 DSH 0.1.5–0.1.7–rc.2，狀態 beta）。維護者爲 Fish-under-sea；上游作者爲 Ebony-Vinyl。
插件行 id 與數據目錄名仍爲 our-free-model，設置與用量數據落在 $DSH_HOME/our-free-model/。從上游 npm 包切換過來時，目錄不變，設置可保留。
相對上游（截至 2.2.0）的本改版增量包括：
- 渠道目錄可見性總開關（
src/channel-visibility.js）：十三個 provider 的分組可一次性收起，不必逐個關模型。 - 免費通道按面積計價（
src/image-pricing.js）：缺少廠商視覺計價協議時，按圖片真實像素估算視覺 token，替代上游固定 1024 的兜底；已從請求中移除的圖片只計描述文本。 - 獨立 npm 包名與發佈；去掉上游
package.json的private，便於 npm 安裝。
核心功能¶
下面只列 README 與 package 描述中已寫明的、且與本 fork 使用直接相關的能力。
模型選擇器與探測¶
- 安裝後，在輸入框模型選擇器中出現 Our Free Model 等分組；清單隨上游刷新，可用性由本機網絡出口探測決定。
- 網關明確拒絕路由的模型會從下拉框移除，在設置頁「不在選擇器中」保留拒因；5xx、429、超時等不當作「模型不可用」。
- Effort 三檔 Light / Balanced / Deep 對應真實輸出 token 預算（非僅提示詞）；思考不可關閉的模型檔位整體上移，模型卡上會標註實際上限。
十三個白嫖渠道與免費池¶
- 十一個賬號渠道（CodeArts、CodeBuddy / WorkBuddy、LobsterAI、Qoder、TRAE、Cline、Loomy、Raccoon、MiniMax Code、ZCode、Gemini 等）外加 Kilo 免費車道與原匿名免費通道；各渠道支持登錄、賬號池、積分領取、模型開關，憑據寫入宿主憑據庫。
- 渠道本地 OpenAI 網關默認監聽 127.0.0.1:8326（Chat Completions + Responses）。
- 桌面端另有 EAC 協付通道（需 DeepSeek Harness 桌面端或 DSHEAC AIO）；命令行與其它宿主中該通道不存在。
本地網關與反代¶
- 設置 → Our Free Model → 本地轉發：啓用後提供 base URL 與 Key，支持
GET /v1/models、POST /v1/chat/completions、POST /v1/responses、POST /v1/messages等；可選 局域網訪問（獨立局域網 Key，默認關閉）。 - 聚合渠道頁可接入註冊表內多家提供商（README 稱 76 家），寫入 Key 後模型以
provider/model出現在選擇器，並可經同一本地網關調用。
設置界面與其它¶
- 九頁設置（免費模型、EAC、白嫖模型接入、數據看板、運行日誌、網關設置等）；用量統計留在本機。
- 公告中心輪詢倉庫 feed；
urgent級別可全屏彈窗。 - 省 Token：工具輸出壓縮（RTK）、可選提示詞瘦身、若干本地應答（默認行爲見 README「聚合渠道、省 Token、路由與本地網關」一節）。
安裝與啓用¶
插件以 純插件掛載 方式運行：不改 DSH 內核、無構建步驟、零 npm 依賴（插件包自身）。安裝前建議瀏覽 倉庫源碼 與 MIT 許可證；插件以當前 DSH 進程權限運行，會發起外網請求並可能寫入本機憑據與 Key。
命令行（純 dsh web profile）¶
將插件目錄放到本機後，在 profile 名稱處替換爲你的實際 profile（例如 web）：
dsh plugin --profile web add /絕對路徑/dsh-our-free-model-fish
安裝完成後重啓應用一次。
若從 Releases 下載發佈包並解壓，也可繞開 git 解析：
dsh plugin add <解壓目錄>
DSHEAC AIO / 桌面端¶
桌面端 profile 有符號鏈接/junction 閘門，不要使用 link: 依賴。推薦在應用內 設置 → 插件 安裝；或按 README 將發佈文件複製到 profile 下 node_modules/dsh-our-free-model-fish/，在 dependencies 寫入 "dsh-our-free-model-fish": "2.2.0"（版本隨 package.json 同步），並在 dsh.profile.bundles 末尾追加 "dsh-our-free-model-fish"。
命令行 dsh plugin add 無法寫入由 Electron 獨佔管理的 desktop profile；此類環境請在桌面端插件管理器操作。
本改版的升級方式（重要）¶
應用內「檢查更新」讀取的是上游簽名清單；對本 fork 點「立即升級」可能用上游文件覆蓋安裝目錄，並刪除 channel-visibility.js、image-pricing.js 等本改版文件，導致 bundle 名與 dsh.profile.bundles 失配。本改版升級請走 npm，不要點應用內升級按鈕：
npm i dsh-our-free-model-fish@latest
（在對應 profile 的依賴管理流程中執行，具體路徑以你的 DSH 安裝方式爲準。）回滾副本位於 $DSH_HOME/our-free-model/rollback/。
典型用法¶
在 DSH 裏直接選模型¶
- 打開對話輸入框的模型選擇器。
- 在 Our Free Model（及渠道相關分組）下選擇模型；選擇按會話持久化。
- 在同一菜單調整 Effort；若回答被截斷，可切到 Deep 或在設置中提高單次輸出上限。
- 若需收起十三個渠道在選擇器中的分組，使用本 fork 的渠道目錄可見性總開關（設置頁，見
channel-visibility相關 UI）。
給本機其它工具接 OpenAI 兼容 API¶
- 進入 設置 → Our Free Model → 本地轉發，啓用轉發並生成 Key。
- 複製面板給出的 base URL（端口被佔用時會順延，以設置頁顯示的實際端口爲準）。
- 客戶端按 OpenAI 習慣配置
base URL與api_key；需要 Claude Code / Anthropic SDK 時可使用POST /v1/messages。
示例（路徑與 Key 以設置頁爲準）：
curl "$BASE_URL/v1/chat/completions" \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<選擇器中的模型 id>","messages":[{"role":"user","content":"hello"}]}'
覈對地區與可用性¶
切換 VPN 或網絡出口後，在設置頁點擊 重新探測可用性；region-limited 分組中的模型會隨探測結果遷移。
適用場景與注意¶
適合誰
- 已在用 DSH（含 dsh web 或桌面端），希望在一個選擇器裏試用多路免費/賬號渠道模型，並可選本地網關給其它工具反代。
- 需要從上游 fork 保留「隱藏渠道分組」或更貼近像素面積的視覺計價邏輯的用戶。
使用前請知悉
- README 寫明：匿名免費車道等來源公開（如 OpenCode Zen、Kilo 公共網關）；Kilo 等池可能記錄 prompt 用於改進服務，勿發送敏感內容。
- 插件會登錄第三方賬號渠道、存儲 Key、探測模型；在無
connection服務的 composition 下，轉發 Key 與本機進程同信任級別，局域網中繼開啓時同網設備可能消耗本機額度。 - 功能與界面絕大部分繼承上游；通用 bug 與功能建議應優先提到 上游倉庫，僅本 fork 引入的問題提到 Fish-under-sea/dsh-our-free-model-fish。
- 社區目錄頁 skillhub.cn 插件條目 與 GitHub 無 DeepSeek / 幻方官方從屬關係；DSH 生態遵循「一切皆插件」，安裝來源需自行甄別。
結尾¶
dsh-our-free-model-fish 把多路免費與賬號渠道、模型探測、本地 OpenAI/Anthropic 網關收進一個 DSH 插件；本 fork 在不動數據目錄的前提下，增加了渠道分組總開關與按面積視覺計價，並用獨立 npm 包名發佈。若你使用此改版，請記住升級走 npm i dsh-our-free-model-fish@latest，避免誤用應用內上游升級。
- 目錄頁：https://www.skillhub.cn/plugins/Fish-under-sea/dsh-our-free-model-fish
- 倉庫：https://github.com/Fish-under-sea/dsh-our-free-model-fish
