前言¶
DSH 的定位是「一切皆插件」，一個 agent 能不能看圖、能不能查公開資料，取決於它手上有哪些工具。而默認的 DSH chat 本身並不會把圖片理解和聯網搜索這兩件事轉發出去（README 原文：two capabilities that DSH chat does not forward on its own）。於是當默認模型是純文本模型、或者換模型之後，agent 就丟了這兩項能力。
下面介紹的 kinfxhk/dsh-model-senses 就是補這個缺口的插件。它由 Kinfxhk 維護，在插件分類裏屬於「聯網工具」，通過 DSH 當前部署默認的 API 提供看圖和搜索兩個動作；切換默認模型後，工具會在下一次調用時跟着走。它的目錄頁簡介爲：See images and search the web from any DSH agent through the live deployment-default API. MIT.
這是什麼¶
一句話定位：給任意 DSH agent 掛上 model_senses 工具，讓它能看圖、能聯網搜索，且這兩個能力跟隨當前生效的部署默認 API，不需要額外插件或額外配置。
它不新增 API key，也不修改模型設置，直接複用 DSH 裏已經配置好的 provider 憑據。
核心功能¶
model_senses 提供三個動作。
| 動作 | 作用 |
|---|---|
see |
看一張圖：本地 png／jpeg／webp／gif，或 https 圖片 URL，再加一條問題 |
search |
搜索公開資料；xAI 默認走原生 web search（includeX: true 時附加 X 搜索），其他 API 走 DSH 的 web provider |
status |
顯示當前 route 到哪個 provider／model／backend；probe: true 時做即時檢查 |
看圖路由¶
see 的選路順序是固定的，方便判斷最終是哪個後端在答：
- 先用同一個 API 裏支持視覺的模型；
- 不行就用部署默認；
- 再用其他已連接、有視覺能力的 API；
- 回覆裏會說明是誰答的（
selected／same-api／default／cross-api）。
所以即使把默認模型選成了純文本模型，也不會丟掉看圖能力。
搜索¶
- 默認 API 是 xAI：走 xAI 原生
web_search，includeX: true會附加x_search； - 其他 API：走 DSH 的
ctx.web，返回最多 8 個來源 URL； - 原生搜索失敗會自動 fallback 到 harness web，不會靜默失敗。
憑據¶
- 非 xAI：交給
ctx.llmadapter，使用你原本配置的 provider 憑據； - xAI：可以用
XAI_API_KEY，也可以用 DSH 裏已保存的 xAI OAuth grant；grant 會自動刷新，token 不會出現在工具結果裏。
安裝與啓用¶
插件要求 DSH 0.2.1-rc.5 或以上（來自 package.json 的 engines.dsh）。安裝分三步，命令來自 README。
1、先拿到源碼，兩種方式二選一：git clone，或者在 GitHub 上 Code → Download ZIP。
2、在 DSH 裏通過 plugin_manager 安裝，target 填插件文件夾的絕對路徑：
plugin_manager(action: "install_bundle", target: "C:\\path\\to\\dsh-model-senses")
3、重啓 DSH。之後 agent 就會帶上 model_senses 工具，無需額外配置。
需要確認版本時，可以看 package.json：
"name": "@local/model-senses"
"version": "1.1.1"
"license": "MIT"
"engines": { "dsh": ">=0.2.1-rc.5" }
典型用法¶
安裝並重啓後，不需要再寫配置，直接在對話裏觸發即可。
1、看圖：讓 agent 用 see 傳一張本地圖（png／jpeg／webp／gif）或 https 圖片 URL，再給一條問題。若當前模型看不清，插件會按上面的路由規則選一個能看的後端，並在結果裏標註 selected／same-api／default／cross-api。
2、搜索：讓 agent 用 search 查公開資料。默認 API 是 xAI 時走原生 web_search，includeX: true 附加 x_search；其他 API 走 ctx.web，最多返回 8 個來源 URL。原生搜索失敗會自動切到 harness web。
3、排障：用 status 查看當前 route 到哪個 provider／model／backend；加 probe: true 做一次實時檢查，確認後端是否真的可用。
適用場景與注意¶
適合：默認模型是純文本模型、但仍希望 agent 能看圖的開發者；希望搜索能力跟隨當前部署默認 API、而不是單獨維護一套 provider 的人；想在側欄之外再確認一次路由與憑據狀態的人。
需要注意：
- 插件以當前 DSH 進程權限運行；它不會自己加 API key，也不會改模型設置，但會把圖片發送給被路由到的 API，插件本身不額外存儲圖片。
- 圖片上限 8 MiB，答案最多 12,000 字；
see超時 120 秒，search超時 180 秒。 - 搜索結果最多 8 個來源 URL。
- 安裝前建議先讀一遍源碼，確認
cordis.patch.yml等打補丁內容符合你的預期；插件爲 MIT 許可證。
它屬於 Kinfxhk 的同系列插件¶
README 裏列出了同一批插件，Model Senses 的定位是「看圖＋聯網搜索，跟隨即時部署默認 API」，不需要額外安裝其他插件。同系列還包括 Attention Center（側欄通知收件箱）、Computer Use（側欄「電腦」頁，需要 Windows + Cua driver）、Model Shelf（側欄模型架）、Perplexity Guard（修正 Perplexity 的 Opus／Sonnet 5.5、GPT-6.1 Sol 請求與 provider 設置，需要 Perplexity API key）。
結尾¶
dsh-model-senses 的價值很直接：把 DSH agent 默認拿不到的看圖和聯網搜索補齊，並且讓它們跟隨當前生效的默認 API，減少切換模型後能力丟失的問題。它不引入新的憑據複雜度，代價是多一次源碼審查和一次重啓。確認你的 DSH 版本在 0.2.1-rc.5 以上後，按上面的步驟裝即可。
插件目錄頁：https://www.skillhub.cn/plugins/Kinfxhk/dsh-model-senses
源碼倉庫：https://github.com/Kinfxhk/dsh-model-senses
