前言¶

DSH 的插件生態強調“一切皆插件”，社區插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

對於智能體開發者來說，一個常見訴求是：希望把某個模型能力接入 DSH，但不想先申請或配置 API Key。dsh-deepseek-web-adapter 面向這個場景，把 DeepSeek 網頁版（chat.deepseek.com）包裝成 DSH 的免 API Key 模型提供方。

下面介紹這個插件的定位、已覈實能力、安裝方式、典型配置，以及當前需要關注的限制。

這是什麼¶

dsh-deepseek-web-adapter 是 huermi 維護的一個 DSH 插件。

它做的事情是：

• 讓 DSH 通過本地網關訪問 DeepSeek 網頁版；
• 插件加載後自動拉起本地網關；
• 插件卸載時回收網關；
• 對外提供 OpenAI 兼容 API；
• 使用本地 MOCK_LLM_KEY，網關不校驗該值。

它的核心對象是 DeepSeek 網頁版賬號，而不是 DeepSeek 官方 API Key。

核心功能¶

當前資料中可覈實的 capability 包括：

1、免 API Key 的 DeepSeek 網頁版模型提供方。
2、插件加載後自動拉起本地網關，卸載時回收。
3、提供 OpenAI 兼容 API。
4、連續對話。
5、工具調用。
6、模型校準。
7、子 agent 併發；資料標註該能力未充分驗證。

需要注意，這是開發者預覽版本，未經大規模真實環境測試。

已驗證：

• 登錄；
• 基本問答；
• 專家模式切換；
• 單次工具調用；
• 網關自動拉起/回收。

未充分驗證：

• 多輪工具循環；
• 長對話遷移；
• 子 agent 併發；
• 無頭模式；
• 識圖模式；
• 斷線恢復。

安裝與啓用¶

插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。該倉庫使用 MIT License，允許自由 fork、修改、繼續開發、再發布。

先安裝插件：

dsh plugin --profile web add dsh-deepseek-web-adapter

插件加載後，網關會自動啓動。資料中給出的啓動時間是約 3-8 秒，DSH 終端日誌會顯示：

DeepSeek 網頁版網關已監聽 5688

配置 DSH 模型提供方¶

下一步是告訴 DSH 使用這個本地網關。

先編輯 ~/.dsh/settings.yaml，在 llm-pi-ai.providers 中加入 dsweb provider。示例如下：

dsweb:
  {
    displayName: DeepSeek 網頁版 (免 API),
    apiKeyEnv: MOCK_LLM_KEY,
    api: openai-completions,
    baseURL: http://127.0.0.1:5688/v1/,
    models:
      [
        { id: deepseek-chat, name: DeepSeek 快速 },
        { id: deepseek-reasoner, name: DeepSeek 專家 },
        { id: deepseek-vision, name: DeepSeek 識圖 }
      ]
  }

這裏的 baseURL 指向本地網關的 OpenAI 兼容接口。

再編輯 ~/.dsh/.credentials.yaml，加入：

MOCK_LLM_KEY: sk-mock-any-value

MOCK_LLM_KEY 可以是任意值，因爲網關不校驗它。

完成配置後，在 DSH 模型選擇器中選擇 DeepSeek 網頁版，可選：

• DeepSeek 快速；
• DeepSeek 專家；
• DeepSeek 識圖。

登錄¶

本包只有 host，沒有 client 卡片 UI，因此登錄需要手動完成。

在瀏覽器打開：

http://127.0.0.1:5688/login

然後登錄 chat.deepseek.com。登錄頁如有“保持登錄/記住我”，資料建議勾上。

注意當前限制說明仍將登錄態描述爲內存 cookie，並提示關閉窗口後需重新登錄。

典型用法¶

先驗證網關是否可用。執行：

curl http://127.0.0.1:5688/v1/models

這個命令用於查看網關日誌/狀態。

如果網關需要重啓，可以用卸載再安裝的方式：

dsh plugin --profile web remove dsh-deepseek-web-adapter && dsh plugin --profile web add dsh-deepseek-web-adapter

如果要本地啓動網關調試，可以執行：

node resources/dsweb-gateway.js --port 5688 --base resources/runtime

如果要跑解析器迴歸測試，可以執行：

node tests/test-parser-all.js

適用場景與注意¶

適合：

• 想在不配置 DeepSeek API Key 的情況下，把 DeepSeek 網頁版接入 DSH；
• 想通過 OpenAI 兼容 API 使用本地網關；
• 想在 DSH 模型選擇器中直接選擇 DeepSeek 快速、專家、識圖；
• 願意手動完成瀏覽器登錄，並接受當前 Beta 狀態。

需要特別注意：

1、本插件是開發者預覽版本，未經大規模真實環境測試。
2、插件加載後自動拉起本地網關，卸載時回收網關。
3、依賴本機安裝 Chrome。
4、登錄態是內存 cookie，關閉窗口需重新登錄。
5、依賴 DeepSeek 網頁版 UI；網頁改版可能導致選擇器失效，需要更新 driver.js。
6、工具調用解析器有兜底但非萬能；54 場景迴歸覆蓋常見格式，極端怪異格式仍可能失敗。
7、本包只有 host，無 client 卡片 UI；登錄需手動打開 http://127.0.0.1:5688/login，配置可用 curl 調 /config，當前資料未給出 /config 的具體請求參數或示例。
8、需要 Node 18+ 與 Chrome，無第三方運行時依賴。
9、插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

鏈接¶

目錄頁：

https://www.skillhub.cn/plugins/huermi/dsh-deepseek-web-adapter

GitHub：

https://github.com/huermi/dsh-deepseek-web-adapter