前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的架构。在使用多模型或搭建智能体时，供应商路由的稳定性与可维护性是核心痛点。dsh-smart-route 是一款解决这些痛点的插件，它作为 polyglot 的替代方案，提供了更精细的错误处理和路由管理能力。
插件介绍¶
名称：dsh-smart-route
维护者：Semidia
简介：智能路由：供应商自动路由（polyglot 替代）— 全错误码降级、一键启停、不污染模型列表。
核心功能¶
渠道链与全错误降级
插件按顺序配置真实 provider（如 deepseek-official、yunzhou、mze 等，必须是 DSH 已注册的 provider）。从上到下尝试，只要链上任意渠道报错（包括 4xx、HTTP_xxx、鉴权失败、传输错误等），都会自动尝试下一家。链上全部失败才返回最终错误。
冷却机制
某个渠道失败后，会进入冷却期（指数退避 + 抖动），冷却期内跳过，避免重复请求导致服务异常。
一键启停与多链管理
对话栏按钮和设置卡都能一键启用/停用整个路由。停用后 smart-route 虚拟 provider 直接拒绝请求（错误码 DISABLED），提示用户启用。设置卡支持新建、删除和切换默认链。
干净的模型列表
插件只注册一个虚拟 provider smart-route，不注册一堆 configurable provider。模型选择器不会冒出一堆渠道模型。
重试策略与渠道级配置
支持通过 settings 配置 retryPolicy（重试次数、退避延迟、抖动比率）。每个渠道可声明 baseUrl 或 apiKeyEnv，声明了 baseUrl 的渠道走内置 OpenAI 兼容分派。
安装与启用¶
使用官方安装命令：
dsh plugin --profile web add github:Semidia/dsh-smart-route
dsh web
重启 dsh web 后刷新页面。默认链为 deepseek-official + deepseek-v4-flash，可在设置卡或 cordis.patch.yml 里修改。
典型用法¶
对话栏按钮
模型选择旁会出现“智能路由”胶囊按钮（绿点 = 启用）。点击弹出面板，可切换启用/停用，查看冷却中的渠道。
设置卡
进入 设置 → 插件 → 智能路由，编辑默认链的渠道顺序，保存后下一个请求即生效。
注意事项¶
已知问题（rc.6）
设置 UI 依赖上游白名单，设置卡可能显示“命名空间未暴露”。核心路由功能不依赖设置 UI，无配置也能按默认链工作。上游进展见相关讨论。
停用行为
停用后请求会被直接拒绝，提示用户在对话栏或设置中启用。
结语¶
dsh-smart-route 提供了一套完整的供应商路由解决方案，适合需要高可用性和精细控制的 DSH 用户。
