前言¶
在 DeepSeek Harness（DSH）裏接第三方模型，常見做法是本機再起網關、裝官方桌面客戶端，或自己維護一套轉發服務。若你只是想用 DeepAI Code 賬號裏的模型做推理，多出來的進程和客戶端往往會增加維護成本。
下面介紹社區插件 dsh-deepai-connector：把 DeepAI Code 上游模型接入 DSH，用瀏覽器完成一次 OAuth 授權即可，不需要安裝 DeepAI Code 桌面客戶端，也不需要額外的網關進程。插件由 REALOIYO 維護，在 SkillHub 目錄中歸類爲「模型推理」。
這是什麼¶
dsh-deepai-connector 是面向 DSH 的模型提供方插件。它在 Harness 進程內完成鑑權、請求頭對齊、簽到與 SSE 解析，直連 DeepAI Code 上游，而不是把對話再轉給本機上的 DeepAI Code 應用。
- 維護者：REALOIYO
- 許可證：MIT
- 當前包版本（npm / 倉庫）：0.1.2
- 目錄頁：https://www.skillhub.cn/plugins/REALOIYO/dsh-deepai-connector
- 源碼：https://github.com/REALOIYO/dsh-deepai-connector
社區插件目錄（SkillHub）獨立於 DeepSeek / 幻方，並非官方應用商店；安裝前宜自行閱讀源碼與許可證。插件與 DSH 同進程運行，權限邊界與當前 Harness 一致。
核心功能¶
以下能力均來自項目 README 說明，節選要點便於對照預期行爲。
登錄與模型列表¶
- 瀏覽器 OAuth 獲取 Key，採用 RFC 8252 本機回調，流程與桌面端同類。
- 模型目錄由上游下發，本地只做緩存；免費模型在 DSH 模型選擇器中帶「· 免費」標記。
協議與推理路徑¶
- 復刻上游請求頭形狀：
Api-Key鑑權、車道版本、進程實例號、機器指紋，User-Agent: node。 - 推理前自動簽到：先請求
/theos拉取 nonce 再回傳。 - 自建請求體與 SSE 解析，不依賴第三方 LLM SDK。
- 若上游以
400 This request is not one DeepAI Code sends.拒絕異形請求體，插件報錯後按桌面端字段白名單重排並重試一次。 - 內置車道版本探測；上游抬升車道版本時，舊值可能統一返回
426，較大協議變動需跟進插件更新。
本機標識¶
插件使用本機真實機器指紋（Windows 上優先 Win32_ComputerSystemProduct.UUID，否則回落 MachineGuid），僅上傳其 sha256，不上傳原始標識。可用環境變量 DEEPAI_MACHINE_ID 覆蓋。簽到按上游要求的最小間隔節流；命中 check_in_refused 後靜默鎖定 6 小時。
插件僅服務單個自用賬號，不包含賬號池、批量註冊或額度繞行邏輯。
安裝與啓用¶
DSH 要求版本 >=0.2.0-rc.1 且 <0.3.0-0（見 package.json 的 engines.dsh）。包內含預構建產物，安裝過程不執行構建。裝完後需重啓 DSH。
在「設置 → 插件」中按包名安裝，或使用插件管理器：
dsh plugin add dsh-deepai-connector
首次使用¶
- 打開「設置 → DeepAI Code」，點擊「登錄」。
- 將授權鏈接複製到瀏覽器，使用 Google 或 Apple 賬號完成授權。
- 授權成功後，模型會自動出現在 DSH 的模型選擇器裏。
之後在 Harness 中像選用其他提供方模型一樣選擇對應條目即可；具體 UI 以當前 DSH 版本爲準。
適用場景與已知限制¶
適合誰¶
- 已在 DeepAI Code 側有可用賬號，希望在 DSH 裏統一選模型、做智能體或對話開發。
- 不願在本機長期運行 DeepAI Code 桌面客戶端或單獨網關進程。
- 能接受社區插件隨上游協議變更而更新，並自行承擔賬號與網絡側限制。
賬號與額度¶
- 上游自 0.3.19 起僅允許 Google / Apple 登錄的賬號推理；郵箱密碼註冊賬號會得到
403 social_login_required，重試或換網絡無效。 - 免費額度按出口 IP 發放，同網段爲共享池；用盡後需等待上游在
403 network_bound中給出的refresh_at。 - 當日簽到次數用盡會返回
403 check_in_refused，推理仍可用，但可能落到替身後端。
緩存與後端¶
- 上游不提供 prompt 緩存：README 記載實測同一段 1028 token 前綴連發三次時，
prompt_tokens_details.cached_tokens與cache_write_tokens均爲 0，DSH 用量面板因此可能始終顯示 0% 命中，屬上游行爲。 - 即使協議對齊，請求仍可能被轉到另一條後端。判據爲響應中
usage.cost_details.upstream_inference_cost是否大於 0；狀態碼仍爲 200，無法僅靠狀態碼區分。
環境與依賴¶
- Node：
^22.19.0 || >=24.0.0（插件engines字段）。 - 與
@deepseek-ai/dsh-llm、@deepseek-ai/cordis及 DSH 客戶端 UI 相關包存在 peer 依賴，由 DSH 宿主環境提供。
開發與參考¶
若需從源碼構建或跑測試（一般使用者可跳過）：
# 構建（esbuild 爲構建期依賴，不寫入 package.json）
DEEPAI_ESBUILD=<esbuild 目錄> node build.mjs
# 測試
node --test "test/*.test.ts"
產物爲 lib/index.js（Host，ESM）與 lib/client.js（瀏覽器，CJS）。協議實現參考 2951461586/DeepAICode2API 的逆向文檔結論，插件形態參考同作者的 dsh-qwenwork-connector。
結尾¶
dsh-deepai-connector 把 DeepAI Code 上游模型以插件形式掛進 DSH：瀏覽器 OAuth、無桌面客戶端、無額外網關。使用前請確認 Google / Apple 登錄與網絡額度規則，並留意上游協議與車道版本變更。
- 目錄頁：https://www.skillhub.cn/plugins/REALOIYO/dsh-deepai-connector
- GitHub：https://github.com/REALOIYO/dsh-deepai-connector
