设置界面配置（推荐）

装包后，dsh 设置导航会出现 dsh-rider 独立设置页：四个字段（视觉提供商 / 视觉模型 / 默认指令 / 单文件暂存上限（MB），保存即写入 dsh-rider settings 命名空间，live 生效无需重启） + 四张卡片（「为视觉模型补图片模态声明」「对话粘贴捕获开关」「对话文件暂存开关」「图片理解」）。等效于手改 settings.yaml：

dsh-rider:
  visionProvider: siliconflow
  visionModel: zai-org/GLM-5.2
  visionPrompt: 请详细描述这张图片的内容
  uploadMaxBytes: 32                # 单文件暂存上限（MB，0 = 默认 32）

为什么是独立设置页而非「设置→插件→插件配置」卡片：dsh rc.6 的「插件配置」tab 只为 settings namespace 被 apiproxy 显式暴露给 Web client 的插件渲染卡片（WEB_SETTINGS_NAMESPACES 硬编码 allowlist，仅含官方宿主插件如 agent-loop/bash/web-search-deepseek）。第三方插件 namespace 不在 allowlist，卡片必然不显示（框架 deferred work，尚未把 expose 决策下放到 settings.register()）。本插件改走 settings.section 独立设置页 + Node half 自建 HTTP 路由（对齐 plugin-registry 的薄控制台模式），绕开暴露限制。详见决策记录 decisions/implemented/2026-08-15-vision-settings-section-page.md。

使用

安装后对话中直接让 agent「搜索一下 XXX」，agent 会优先调用 duckduckgo_search：

工具：duckduckgo_search
参数：
  query      (必填) 搜索词，最长 400 字符
  count      (可选) 结果条数 1-20，默认 10
  safeSearch (可选) strict / moderate / off，默认 moderate

返回结构：{ engine: duckduckgo | bing, noResults, results: [{title, url, description, hostname}] } （engine 标明实际使用哪个引擎，便于判断 DDG 是否可用）。

示例输出：

引擎：duckduckgo，共 10 条结果
1. 张雪峰（教育博主、学业职业规划讲师）— 百度百科
   https://baike.baidu.com/item/...
   1984 年 5 月 18 日出生，2007 年从郑州大学毕业后开始北漂生涯……
2. ...

启停与配置覆盖

在 profile 层（不是本包内）覆盖，例如禁用整个插件：

- disabled: true
  id: dsh-rider

dsh-rider

AI 分析

安装

说明文档

设置界面配置（推荐）

使用

启停与配置覆盖