前言¶
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
