前言¶
在 DeepSeek Harness（DSH）中擴展能力時，常見問題不是“能不能加一個插件”，而是多個配置入口分散：MCP servers、用戶 skills、API key 輪換、圖像理解端點往往要分別改配置或寫額外工具。XJungit/omdp 把這些能力整理成三個可獨立安裝的 DSH 插件，並放在同一個 monorepo 中。每個插件位於獨立子目錄，也可以作爲獨立 DSH bundle 安裝。下面介紹它的功能、安裝方式和使用邊界。
這是什麼¶
XJungit/omdp 是一個 DeepSeek Harness（DSH）插件 monorepo，維護者爲 XJungit，許可證爲 MIT。它將三個 @omdp/* 插件放在不同子目錄中：
dsh-connector/：@omdp/dsh-connectordsh-key-fallback/：@omdp/dsh-key-fallbackdsh-vision-bridge/：@omdp/dsh-vision-bridge
倉庫通過 GitHub Actions 在每個 v* tag 自動發佈 npm 包。你可以按插件粒度安裝，也可以只安裝其中一個。
核心功能¶
@omdp/dsh-connector¶
在 DSH Web UI 的 Connector 設置頁管理三件事：
- MCP servers；
- 用戶 skills；
- 只讀 market explorer。
該插件的 market data 只保存在進程內存中，TTL 爲 30 分鐘，不落盤。
@omdp/dsh-key-fallback¶
提供多 API key 池、自動輪換、顯示實際使用的 key，並支持 key 冷卻/刪除等管理操作。失敗請求的重發由 DSH 的 dsh-llm-retry 負責。
@omdp/dsh-vision-bridge¶
讓 text-only 模型通過可配置的 OpenAI 兼容多模態端點處理粘貼或拖入的圖像。默認使用 Agnes agnes-2.5-flash。
安裝與啓用¶
npm 安裝¶
在 ~/.dsh/profiles/<name>/package.json 的 dependencies 中加入需要安裝的包。本文不固定具體版本號；請在 npm 上選擇當前可用版本後寫入：
@omdp/dsh-connector
@omdp/dsh-vision-bridge
@omdp/dsh-key-fallback
然後執行：
cd ~/.dsh/profiles/<name>
pnpm install
如果只安裝其中一個，只添加對應依賴即可。
更新¶
cd ~/.dsh/profiles/<name>
pnpm update @omdp/dsh-connector @omdp/dsh-vision-bridge @omdp/dsh-key-fallback
GitHub 安裝¶
如果不想先本地 clone，也可以用 dsh plugin add 從 GitHub 子目錄安裝：
dsh plugin --profile web add github:XJungit/omdp#path:dsh-connector
dsh plugin --profile web add github:XJungit/omdp#path:dsh-vision-bridge
dsh plugin --profile web add github:XJungit/omdp#path:dsh-key-fallback
如果沒有全局 dsh 命令，可以把 dsh 前綴替換爲 npx @deepseek-ai/dsh：
npx @deepseek-ai/dsh plugin --profile web add github:XJungit/omdp#path:dsh-connector
npx @deepseek-ai/dsh plugin --profile web add github:XJungit/omdp#path:dsh-vision-bridge
npx @deepseek-ai/dsh plugin --profile web add github:XJungit/omdp#path:dsh-key-fallback
pnpm ≥10 的 git 安裝¶
GitHub 安裝會獲取源碼。pnpm 默認會拒絕運行 git 依賴的 prepare/build 腳本；如果第一次 add 失敗，需要在 profile 的 pnpm-workspace.yaml 中顯式允許對應包的構建腳本：
allowBuilds:
'@omdp/dsh-connector': true
'@omdp/dsh-vision-bridge': true
'@omdp/dsh-key-fallback': true
保存後重新執行對應的 add 命令。這個白名單相當於允許在 install 時運行包代碼，因此應只對信任的來源開啓。對不信任來源，可以 pin commit，例如使用類似下面的選擇器：
github:XJungit/omdp#<sha>&path:<subdir>
典型用法¶
管理 MCP 與 skills¶
安裝 @omdp/dsh-connector 後，從 DSH Web UI 的 Connector 設置頁進入管理界面。可以在同一設置頁維護 MCP servers、用戶 skills，並瀏覽只讀 market explorer。market explorer 的數據只保留在進程內存中，30 分鐘 TTL 後過期，不會寫入磁盤。
管理多個 API key¶
安裝 @omdp/dsh-key-fallback 後，可以維護一個多 API key 池。它支持自動輪換、顯示實際使用的 key，以及 key 冷卻/刪除等管理操作。失敗請求的重發由 DSH 的 dsh-llm-retry 處理。
給 text-only 模型添加圖像理解¶
安裝 @omdp/dsh-vision-bridge 後，可以爲 text-only 模型配置一個 OpenAI 兼容多模態端點。當你粘貼或拖入圖像時，插件通過該端點處理圖像。默認使用 Agnes agnes-2.5-flash。
適用場景與注意¶
這個倉庫適合以下場景：
- 想把 MCP servers、skills 和 market 瀏覽放在 DSH Web UI 中統一管理；
- 需要多個 API key，並希望在請求間輪換、查看實際使用的 key；
- 使用 text-only 模型，但希望把圖像交給外部多模態端點處理。
使用前需要注意：
- DSH 插件以當前
dsh進程權限運行。安裝前應檢查源碼、依賴和許可證。該倉庫聲明 MIT 許可證，但仍建議對實際安裝來源做確認。 - git 安裝會拉取源碼。
allowBuilds不是普通依賴項，它會允許安裝時執行包內腳本或代碼；不信任來源應 pin commit。 @omdp/dsh-connector的 market data 只在內存中保留 30 分鐘，不適合當作持久化緩存。@omdp/dsh-key-fallback不負責重發；重發交給 DSH 的dsh-llm-retry。
