dsh-vision-bridge

配置

方式一：Web 设置页（推荐）

打开 设置 → 插件 → 明眸 VisionBridge（视觉桥），改完点保存，即时生效。

rc.6 的「设置 → 模型」页会同时出现一张由可配置提供方注册产生的同名占位卡，浏览器半已自动隐藏，属正常现象。

方式二：环境变量

| 变量 | 默认 | 说明 |

|---|---|---|

| DSH_VISION_ENABLED | true | 总开关 |

| DSH_VISION_PROVIDERS | 空（全部） | 生效的主模型 provider 列表，逗号分隔 |

| DSH_VISION_STRATEGY | cascade | cascade（自动升级，默认）/ race（并发赛跑，高级） |

| DSH_VISION_BASE_URL | https://api.siliconflow.cn/v1 | 视觉 API 端点 |

| DSH_VISION_MODEL | Qwen/Qwen3-VL-8B-Instruct | 首选识别模型 |

| DSH_VISION_MODEL_UPGRADE | Qwen/Qwen3-VL-32B-Instruct | 备选识别模型（首选失败/为空时自动切换） |

| DSH_VISION_API_KEY_ENV | SILICONFLOW_API_KEY | API Key 环境变量引用 |

| DSH_VISION_FAILURE_MODE | annotate | annotate / error |

| DSH_VISION_MAX_TOKENS | 4096 | 识别最大 token |

| DSH_VISION_TIMEOUT_MS | 180000 | 识别超时（毫秒） |

| DSH_VISION_PROMPT | 见源码 | 识别提示词 |

| DSH_VISION_VISION_MODELS | 空 | 额外强制视为视觉模型的 provider/model 或 model 列表，逗号分隔；用于启发式规则漏识别的模型 |

| DSH_VISION_DEBUG | 关 | 1 开启调试日志 |

方式三：API Key（二选一）

• 推荐：设置卡片直接粘贴 —— 设置 → 插件 → 明眸 VisionBridge，在「视觉 API Key」框粘贴 Key 并点「保存 Key」，写入 dsh 官方凭据库（不落盘到配置），卡片实时显示「已配置 ✓」。

• 或手动写入 ~/.dsh/.credentials.yaml：

SILICONFLOW_API_KEY: sk-xxx

方式四：内置视觉模型白名单（可选）

quchiai 等自定义 provider 中的部分视觉模型（如 MiniMax/MiniMax-M3、moonshotai/Kimi-K2.7-Code）可能被 dsh 标记为纯文本。本插件会在运行时自动给这些 adapter 追加 image input，无需再手动修改 ~/.dsh/settings.yaml。

如果你使用的视觉模型不在内置白名单，或想额外扩展，可通过设置页、环境变量 DSH_VISION_VISION_MODELS 或 vision-bridge.visionModels 追加：

vision-bridge:

  visionModels:

    - quchiai/MiniMax/MiniMax-M3

    - quchiai/moonshotai/Kimi-K2.7-Code

内置默认白名单会自动与你的自定义列表合并。

错误处理

• 空识别结果 → 自动切换备选模型重试；

• Key 缺失/无效（401/403）、限流（429）、服务异常（5xx）、超时、空结果 → 以中文可读的提示标注给主模型（annotate 模式），绝不静默丢图；

• 可切 error 模式严格报错。