dsh-rider

dsh-rider

DSH 官方 bundle 插件：免费网络搜索工具 duckduckgo_search（零 API key）

• 前置视觉理解工具 vision_understand（会话模型不支持图片时， 用 dsh 配置的支持视觉的模型理解图片）。 DuckDuckGo（ddg-kit）优先，自动读取 Windows 系统代理；DuckDuckGo 不可达/限流时 自动回退 Bing。并注入系统提示指引让 agent 优先使用它（内置 deepseek 网页搜索仅作最终后备）。

能力面

Tools

工具	说明
duckduckgo_search	免费网络搜索：DuckDuckGo（ddg-kit）优先，失败自动回退 Bing；返回标题/URL/摘要列表，engine 字段标明实际来源
vision_understand	前置视觉理解：会话模型不支持图片输入时，把图片（本地路径 / http(s) URL / data: URL）交给 dsh 配置中支持视觉的模型理解，返回文字描述；模型选择：工具参数 > settings（dsh-rider.visionProvider/visionModel）> 自动发现

MCP servers

无（v0.1 的 duckduckgo-mcp-server 已因 VQD 失败被原生工具替换，见决策记录 decisions/implemented/2026-08-14-native-ddg-kit-tool.md）。

Skills

当前无 skill；仓库按多能力插件规划，后续能力以 SKILL.md 模式在 skills/ 扩展。

前置视觉理解（vision_understand）

使用场景：会话模型不支持图片输入（无 image 模态，如 deepseek-v4-flash）、 而用户想让 agent 看一张图时，agent 调用 vision_understand 让支持视觉的模型 理解图片，再把返回的描述转述给用户。系统提示已注入指引（tool:vision 段）， 模型会自动优先走此路径。

⚠️ 关于"直接粘贴图片"：DSH 框架在 dsh-host-apiproxy 的 prompt 入口处， 于进入 agent turn 之前校验——若消息含图片附件且当前会话模型不支持图片， 直接拦截并提示"当前模型不支持图片，请切换支持图片的模型"，含图片的消息不会 到达 agent（vision_understand 因此不会被触发）。这是框架级拦截 （MODEL_DOES_NOT_SUPPORT_IMAGES），第三方插件无法绕过。

正确用法：在纯文本会话模型下，以文字形式提供图片来源，让 agent 调 vision_understand，而不是直接粘贴图片附件：

• 「帮我看看 E:\screenshots\error.png 这张图是什么」
• 「这张图片里的文字是什么：https://example.com/chart.png」

消息是纯文本（不含 image block），不触发 DSH 拦截，进入 agent turn 后系统 提示会引导 agent 调用 vision_understand 传入该路径/URL。若会话模型本身支持 图片（如 gpt-4o），直接粘贴即可，无需本工具。

工具：vision_understand
参数：
  image    (必填) 图片来源：本地文件路径 / http(s) URL / data:image/...;base64,...
  prompt   (可选) 给视觉模型的指令（默认详细描述图片）
  provider (可选) 视觉模型提供商路由（如 deepseek-official / openai / siliconflow）
  model    (可选) 视觉模型 id（须与 provider 同时提供）

视觉模型选择优先级：

1. 工具参数 provider + model（显式指定即信任用户，不检查模态声明）；