前言¶

在 DSH 裏接入自定義模型時，你可能會遇到這樣的情況：端點本身支持多模態，但在對話框裏發圖卻直接報「不支持圖片輸入」。原因是 DSH 的 host 端會讀取模型條目上的 input: ["text","image"] 聲明來決定是否把原圖直通給該模型，而「設置 → 模型 → 模型目錄」的界面一直沒有暴露這個聲明的入口。

dsh-vision-plugin 要解決的就是這一步：在模型目錄的模型頁上補一個「圖片輸入」勾選框，勾一下，聲明就寫進 DSH settings，自定義模型就能在對話框裏直接收圖。

它是什麼¶

dsh-vision-plugin 由 nexsjournal 維護，當前版本 1.1.1，MIT 許可證。一句話定位：給 DSH 的模型目錄補上「圖片輸入」聲明勾選框——勾一下，自定義模型就能在對話框裏直接收圖。

它是一個純 host 插件，「設置 → 插件 → 插件配置」裏不會出現它的卡片，這是正常現象，不是安裝失敗。

核心功能¶

• 在每次 DSH 啓動時，冪等地給「設置 → 模型 → 模型目錄」的模型頁裝上「圖片輸入」勾選框；
• 勾選 = 給該模型寫 input: ["text","image"]，走模型頁自身的保存流程存進 DSH settings；取消勾選 = 清除該字段；
• 數據完全走 DSH 原生，插件停用或卸載都不影響已保存的聲明繼續生效；
• 附帶一條 BYO（自帶端點）視覺中繼：註冊 vision provider 和 vision_analyze、vision_status、vision_test、vision_configure 4 個工具；
• 通過 vision_configure 或環境變量 DSH_VISION_* 熱配置 Base URL / 模型 / API Key 三項，不內置任何端點與密鑰。

補丁機制是防禦式的：已打過就跳過；錨點不匹配就跳過並記警告日誌，不會寫壞文件。

安裝¶

前提：DSH 已部署（web profile），pnpm 可用（dsh plugin 會轉發 pnpm）。包的 engines 要求 node >= 22.19。

npx @deepseek-ai/dsh plugin --profile web add github:nexsjournal/dsh-vision-plugin

安裝完成後需要完全退出並重開 DSH。重啓後確認三件事：

1. 「設置 → 插件 → 插件列表」出現 vision-plugin 一行（已啓用）；
2. 「設置 → 模型 → 模型目錄」，展開任意模型，「最大輸出 token」下方出現「圖片輸入」勾選框；
3. 「設置 → 插件 → 插件配置」沒有本插件的卡片——純 host 插件，正常。

依賴說明：本包把 @deepseek-ai/* 聲明爲 optional peerDependencies，安裝時不額外拉取，運行時由 profile 依賴樹解析，標準部署自帶。桌面端與網頁版共用 web profile，裝到 web 即兩端都生效。

怎麼勾選¶

以給自定義路由下的模型聲明圖片輸入爲例：

1. 「設置 → 模型」，選中你的自定義路由；
2. 進入「模型目錄」，點模型行右側的 > 箭頭展開；
3. 勾選「上下文窗口 / 最大輸出 token」下方的「圖片輸入」；
4. 回到對話框，模型選擇器選到該模型，直接發圖（原圖直通）。

注意：勾選只是聲明。生效前提是該路由的端點真的能處理圖片，DSH 不會替端點識別。

啓用與停用¶

「插件列表」本身是隻讀的，啓用 / 停用通過 profile 補丁文件 ~/.dsh/profiles/<profile>/cordis.patch.yml 控制。

停用：在頂層數組加一個條目，然後重啓 DSH：

- id: dsh-vision-plugin
  disabled: true

啓用：刪掉該條目，或把 disabled 改爲 false，重啓 DSH。

停用後模型頁勾選框補丁不再維護，但已裝上的勾選框和已保存的 input 聲明繼續有效——數據走 DSH 原生，不依賴插件存活。

附帶的視覺中繼¶

除了勾選框，插件還附帶一條 BYO（自帶端點）視覺中繼：host 端註冊 vision provider 和 4 個工具——vision_analyze（識別圖片文件）、vision_status（狀態自檢）、vision_test（端點連通測試）、vision_configure（對話裏熱配置）。

中繼不內置任何端點與密鑰，需要你通過 vision_configure 或環境變量 DSH_VISION_* 配置 Base URL / 模型 / API Key 三項。

常見問題與限制¶

模型頁展開後沒有「圖片輸入」勾選框時：

1. 跑 vision_status，看 modelsImageInputCheckbox：skipped > 0 說明 DSH 升級改了模型頁結構、錨點不匹配（插件不會寫壞文件），等插件新版適配；
2. 對頁面做硬刷新（Cmd/Ctrl+Shift+R）再確認。

一個已知的版本邊界：補丁針對 dsh-client-ui-settings-models 0.1.0-rc.6 的編譯產物。DSH 大版本升級改了模型頁後，勾選框會消失（插件記警告日誌、不寫壞文件），需要插件發佈新版適配。

安裝前的檢查¶

和所有 DSH 插件一樣，本插件以當前 dsh 進程的權限運行。安裝第三方插件前，建議先到 GitHub 倉庫閱讀源碼、確認許可證（本項目爲 MIT）再決定是否安裝。

結尾¶

dsh-vision-plugin 的價值在於把一個已有但沒暴露入口的原生能力補回 UI：不用手改配置，勾一下就完成 input: ["text","image"] 聲明，且數據走 DSH 原生，停用卸載都不影響已保存的結果。

• GitHub：https://github.com/nexsjournal/dsh-vision-plugin
• 社區目錄頁：https://www.skillhub.cn/plugins/nexsjournal/dsh-vision-plugin（該地址來自線索，未能與抓取資料覈對，以站點實際收錄爲準）

DSH 的理念是「一切皆插件」；社區目錄是獨立站點，與 DeepSeek、幻方沒有官方從屬關係。