前言¶
DeepSeek Harness(DSH)裏,網關、模型、MCP 和技能往往分散在 YAML 與多處配置裏改。團隊用 LiteLLM 發 Virtual Key 時,使用者還要自己拼供應商、模型列表和 MCP 條目。下面介紹社區插件 dsh-resource-center(維護者 backtomyfuture),它把上述能力收進側邊欄「LiteLLM資源中心」,在頁面裏完成生效、勾選、安裝與消耗查看,減少手改 cordis.patch.yml 的次數。
這是什麼¶
dsh-resource-center 是 DSH 側邊欄裏的資源與工具中心:通過一把 LiteLLM Virtual Key,在同一界面管理整條 LiteLLM 鏈路是否生效、可用模型、網關授權的 MCP 服務器、LiteLLM 上的 Skill,以及該鑰匙的 spend logs。插件以 MIT 許可發佈,當前 package 版本爲 0.1.0,要求 Node >=20。對照的 DSH 側邊欄槽爲 sidebar.panellist 與 main(README 寫明對照 DeepSeek Harness 0.2.1-rc.5;DSH 仍在開發預覽,槽名以後可能變化)。
核心功能¶
LiteLLM 選項卡¶
這一頁管整條鏈路是否生效。綠點表示網關接受了虛擬鑰匙;打開「生效」會拉取該鑰匙能用的全部模型並寫入對話。關掉會從對話裏去掉 LiteLLM 供應商,已安裝的 MCP 也會停掉。DSH 不接受沒有模型的自定義供應商,因此關閉相當於刪掉這一條。
模型選項卡¶
勾選不會立刻改對話,需點 保存並寫入 DSH。一個都不選再保存,會去掉 LiteLLM 供應商。點「詳情」可查看上次同步到的屬性(只讀)。上下文、最大輸出、輸入類型和思考等級只按 LiteLLM model_info 裏已設置的值寫入,不按模型名補全。
MCP 選項卡¶
打開頁面即列出該虛擬鑰匙被授權的服務器;每行有「未安裝 / 已安裝」開關,安裝與卸載時頁面上有進度。點「工具」只展示網關返回的工具,沒有單獨的工具開關;網關返回空列表時會說明原因。連接走網關轉發(DSH 連到網關的 /服務器名/mcp),上游密鑰留在 LiteLLM,不在此頁填寫。
Skill 選項卡¶
列出 LiteLLM 上的技能;安裝開關把技能放進 ~/.dsh/skills,安裝時有進度,DSH 會熱加載。已在 ~/.agents/skills 或其他本機目錄裏的同名技能標爲「本機已有」,可預覽,不能從此覆蓋。未落地的技能需安裝後才能預覽;不從其他 Git 或 HTTP 地址挑選。
消耗選項卡¶
讀取 LiteLLM 裏該 Virtual Key 的 spend logs,按模型彙總請求數、Token 和美元。Virtual Key 的 Allowed Routes 需包含 spend_tracking_routes,否則 LiteLLM 會返回 HTTP 403。
鑰匙怎麼發¶
網關管理員保留 LITELLM_MASTER_KEY 和 Salt Key,不要隨插件分發。在 LiteLLM 裏爲每人建 Virtual Key,只勾選其可用模型並設好額度。使用者只需兩樣:網關 Base URL 與 自己的 Virtual Key。
安裝與啓用¶
插件以當前 DSH 進程權限運行;安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證。
- 完全退出 DeepSeek Harness。
- 在 desktop profile 下安裝:
dsh plugin --profile desktop add dsh-resource-center
若使用 dsh web,將命令中的 desktop 換成 web。
- 重新打開 DSH,側邊欄出現 LiteLLM資源中心。
頁面只接受本機迴環請求。虛擬鑰匙保存在 $DSH_HOME/resource-center/litellm.key(權限 0600);插件將其放入憑據名 DSH_LITELLM_KEY 並交給 DSH 憑據庫,供 apiKeyEnv 使用。只放進進程環境變量而不寫入憑據庫時,模型菜單可能爲空。不會寫進 cordis.patch.yml,也不會修改 LITELLM_MASTER_KEY。改完插件代碼或配置後,必須完全退出再打開,正在運行的進程不會重新加載腳本。
典型用法:第一次使用¶
- 在 LiteLLM 選項卡填寫發給你的 Virtual Key,打開「生效」。鑰匙保存到本機,模型從網關拉取並寫入對話。
- 打開 模型 選項卡按需少選,再點 保存並寫入 DSH。點「詳情」查看同步屬性(不可在此修改)。
- MCP 選項卡對授權服務器切換安裝開關;Tavily 等上游密鑰在 LiteLLM 的 MCP 服務器上配置,不在本頁填寫。
- Skill 選項卡安裝所需技能到
~/.dsh/skills;本機已有同名技能時僅預覽,不覆蓋。 - 消耗 選項卡查看該鑰匙按模型的請求、Token 與金額。
狀態文件位於 $DSH_HOME/resource-center/state.json。刪除 $DSH_HOME/resource-center 目錄會清空面板裏保存的服務器、勾選和 Hub 記錄,不會刪除已安裝到 ~/.dsh/skills 的技能。
適用場景與注意¶
適合誰:已通過 LiteLLM 集中發 Virtual Key 的團隊或個人;希望在 DSH 裏用圖形界面切換模型、安裝網關分發的 MCP 與 Skill,並查看單鑰消耗,而不是反覆手改 YAML。
邊界與限制(摘自 README):
- 模型寫入走宿主的
configEditor;找不到llm-pi-ai或沒有編輯器時,頁面會給出可貼進cordis.patch.yml的片段。 - DSH 沒有面向新手的通用 MCP 管理頁;本插件只安裝 LiteLLM 分發下來的 MCP 服務器。
- 只有
~/.dsh/skills裏的技能可在頁面上停用(移至~/.dsh/resource-center/disabled-skills);項目倉庫內技能仍留在倉庫裏。 - MCP 熱啓停依賴
@deepseek-ai/dsh-mcp-client;解析不到包時會嘗試從 DSH 的app.asar加載,仍失敗則配置保存但運行狀態爲錯誤。
社區插件目錄 SkillHub 條目 與 GitHub 倉庫相互獨立引用;目錄站點與 DeepSeek / 幻方無官方從屬關係,屬於 DSH「一切皆插件」生態中的社區貢獻。
結尾¶
dsh-resource-center 把 LiteLLM Virtual Key 背後的模型、MCP、Skill 與消耗集中到 DSH 側邊欄,鑰匙與網關分工清晰:管理員管 Master Key 與額度,使用者只管 Base URL 與自己的 Virtual Key。需要細節與更新時,以倉庫 README 爲準。
- 目錄頁:https://www.skillhub.cn/plugins/backtomyfuture/dsh-resource-center
- GitHub:https://github.com/backtomyfuture/dsh-resource-center