前言¶
在 DeepSeek Harness（DSH）裏做智能體或 Web 對話，模型來源通常要自己配 API Key、計費賬號，或維護本地推理棧。若你只想在 DSH 模型選擇器裏換一組可用模型、又不願先綁信用卡，社區裏會出現另一條路：把第三方「廣告資助的免費推理」接成 DSH 的 provider 插件。
下面介紹維護者 wawaTuna 發佈的 dsh-free-pi（npm 包名 dsh-free-pi，GitHub：wawaTuna/dsh-free-pi）。它把 free-pi 的 OpenAI 兼容端點註冊進 DSH，通過一次 GitHub 登錄拿到 JWT，無需自備 API Key。資料中稱當前可免費、不限量使用 DeepSeek V4.1 Flash、DeepSeek V4 Flash、GLM 5.3 Flash、Particle 等（以 free-pi 線上目錄爲準，會變動）。分類上屬於 模型推理 類 DSH 插件。
這是什麼¶
dsh-free-pi 是 DSH 的 provider 插件：在進程內註冊 free-pi 適配器，向 DSH 暴露一組可從模型選擇器選用的模型。上游爲 POST https://api.freepi.ai/v1/chat/completions，由 JWT、x-session-id、x-client-version 等頭做鑑權；插件不額外監聽本地端口。
插件版本（package.json）爲 0.2.2，許可證 MIT。運行環境要求 Node ^22.19.0 || >=24.0.0。倉庫說明標明：非 free-pi、DeepSeek 或模型方的官方產品。
核心功能¶
依據 README 與 package 描述，可覈對的能力如下。
- Free Unlimited 模型：資料列舉 DeepSeek V4.1 Flash、DeepSeek V4 Flash、GLM 5.3 Flash、Particle 爲 free-pi 標記的 Free Unlimited，不計入個人預算（促銷性質，可能隨時調整）。
- 按日預算的計量模型：其餘模型按賬戶每日 15,000 credits（約 1.125 美元）扣費，UTC 00:00 重置；目錄中的計量模型按上游成本與倍數扣 credits。
- 活目錄：模型列表從 free-pi 目錄接口刷新，增刪模型不必改插件版本。
- 多賬戶輪詢：可將多個 GitHub 賬戶寫入
~/.free-pi/agent/accounts.json（與credentials.json並列），插件按配額做 round-robin；流式請求中途不換賬戶。 - 配置項：
jwt（可選單 token）、hiddenModels（隱藏選擇器中的模型 id，熱生效）。
安裝與啓用¶
插件面向 web profile。安裝步驟以倉庫 Quick start 爲準。
1、安裝插件
dsh plugin --profile web add github:wawaTuna/dsh-free-pi
當前 DSH 會從包元數據註冊 bundle。可用下面命令確認配置裏出現 # == dsh-free-pi 段，然後重啓 dsh-web：
dsh --profile web --dump-config
2、登錄 free-pi
登錄即表示接受 free-pi 條款（含隱私與數據使用，見文末「適用場景與注意」）。任選一種方式寫入憑證（權限 0600）：
npx free-pi-cli@latest
憑證默認路徑：~/.free-pi/agent/credentials.json。也可在插件配置裏設 jwt，或設置環境變量 FREEPI_JWT。README 說明 token 在每次請求時重讀，重新登錄後不必重啓 DSH。
3、驗證
在模型選擇器的 free-pi 分組中選 DeepSeek V4.1 Flash，發送一條消息即可完成冒煙驗證。
典型用法¶
單賬戶日常對話¶
完成「安裝 → 登錄 → 重啓 web → 選 free-pi 模型」後，用法與 DSH 其他 provider 相同：在 Web 界面選模型、正常對話。計量模型消耗當日 credits；Free Unlimited 條目按 free-pi 當前策略不計預算。
隱藏部分模型¶
若不想在選擇器裏看到某些 id，可在插件配置中設置 hiddenModels（無需重啓）。
多賬戶與配額查看¶
在 free-pi-plugins monorepo 中可用：
node core/login.mjs --label work
爲池內增加第二個 GitHub 賬戶。兩賬戶時，計量模型日額度約爲 2 × 15,000 credits。查看餘額可在同 monorepo 運行 node core/quota.mjs；README 亦提到兄弟項目 magpie-free-pi 的 magpie quota 可展示同類數據。
Token 有效期約 90 天；過期後用原登錄方式重新登錄即可。
適用場景與注意¶
適合誰：已在用 DSH Web、願意用 GitHub 登錄 free-pi、並接受其商業模式（廣告資助 + 會話數據用於訓練等條款）的開發者；想快速試用 DeepSeek V4.1 Flash 等 Free Unlimited 模型，或在不買主站 API 的情況下用計量模型湊日額度。
運行與信任邊界：插件以當前 dsh 進程權限 運行，會讀取本機 ~/.free-pi/agent/ 下憑證並向外網 api.freepi.ai 發請求。安裝前建議自行查閱 GitHub 倉庫 源碼與 MIT 許可證；勿在未審閱的情況下在生產敏感代碼庫上登錄。
隱私：README 明確 free-pi 除廣告外會對會話（提示、代碼、文件、模型回覆）留痕並可能用於訓練或第三方共享；廣告側會收到近期對話摘錄。完整條款見 https://freepi.ai/terms 。僅在你能接受該交換的對象與代碼上使用。
穩定性：後端主要服務 free-pi 官方終端客戶端；本插件走相同協議，但 free-pi 可能加強校驗（例如要求實時廣告會話）。Free Unlimited 非永久承諾。
生態說明：DSH 奉行「一切皆插件」；SkillHub 目錄頁 爲社區收錄，與 DeepSeek / 幻方無官方應用商店從屬關係。
結尾¶
dsh-free-pi 把 free-pi 的 JWT 鑑權推理接到 DSH 的 free-pi 模型組：一條官方安裝命令、一次 GitHub 登錄，即可在 Web 端選用 DeepSeek V4.1 Flash 等模型，並可選多賬戶輪詢擴展計量額度。
- 目錄頁：https://www.skillhub.cn/plugins/wawaTuna/dsh-free-pi
- 源碼與文檔：https://github.com/wawaTuna/dsh-free-pi
