dsh-smart-scenario-router

为 DeepSeek Harness（dsh）提供基于对话场景的模型路由。插件会根据用户消息选择合适的模型，并在请求失败时按候选链自动回退。

功能

• 根据消息内容识别以下场景：
  • 项目拆解 / 架构设计
  • 插件查找 / 工具推荐
  • 代码审查
  • 代码变更对比
  • 代码编写 / 调试
  • 复杂推理 / 科研 / Agent
  • 日常对话 / 快速问答
  • 极速高并发 / 批量抽取
  • 多模态（图文输入）
  • 长文本 / 数据分析
• 优先使用国产模型，配置的 GPT 模型作为兜底。
• 请求失败时自动尝试当前场景的下一个模型。
• 低置信度的消息会使用 deepseek-v4-flash-0731 进行场景判断。
• 在 dsh Web 设置页显示模型池、场景映射和当前路由状态。
• 模型池配置会通过 dsh settings 持久化保存。

安装

要求：

• DeepSeek Harness >= 0.1.1-rc.1
• Node.js 和 pnpm
• 已在 dsh 中配置至少一个可用的模型 Provider

直接从 GitHub 安装：

npx -y @deepseek-ai/dsh plugin --profile web add github:xobexo/dsh-smart-scenario-router

也可以使用完整仓库地址：

npx -y @deepseek-ai/dsh plugin --profile web add https://github.com/xobexo/dsh-smart-scenario-router.git

安装后重启 Web profile：

npx -y @deepseek-ai/dsh web

检查插件是否已安装：

npx -y @deepseek-ai/dsh plugin --profile web list

更新

更新已经安装的插件：

npx -y @deepseek-ai/dsh plugin --profile web update dsh-smart-scenario-router

如果是从 GitHub 安装的旧版本，也可以再次执行安装命令：

npx -y @deepseek-ai/dsh plugin --profile web add github:xobexo/dsh-smart-scenario-router

卸载

npx -y @deepseek-ai/dsh plugin --profile web remove dsh-smart-scenario-router

卸载后重启 dsh。

配置

打开 dsh Web 界面的设置页，找到“智能场景路由”。这里可以：

• 启用或停用模型池中的模型。
• 所有模型都通过下拉框从 dsh「设置 → 模型」中已配置的模型中选择，不需要手输模型名称。
• 为模型填写明确的 Provider（留空时自动解析）。
• 查看每个模型对应的场景和优先级。
• 编辑每个场景的候选链（模型下拉框 + 追加 / 移除候选，顺序即回退顺序）。
• 选择裁判模型（留空为自动，优先挑选可用的 Flash 模型）。

首次使用时，插件会把最开始的规则内容（默认模型池 + 每个场景的候选链）自动写入配置，不需要手动添加：默认模型在 dsh「设置 → 模型」里不存在时，会自动替换为同系列（deepseek / glm / qwen / gpt）的真实配置模型并填入自动解析的 Provider；连同系列都没有时才保留原名称（设置页标注“未配置”，路由时自动跳过）。模型名称按 Harness 已配置的原值传递；如果模型未注册、Provider 不可用或模型无法解析，插件会继续尝试候选链中的下一个模型。

插件不会保存 API Key。Provider 的认证信息仍由 dsh 自己管理。

502 上游错误排查

如果直接选择 GLM-5.2 可以正常调用，但启用本插件后出现 502 upstream service unavailable，请打开“智能场景路由”设置，确认 GLM-5.2 的 Provider 与 dsh「设置 → 模型」中实际可用的 Provider 完全一致。插件会校验 provider/model 组合后再注入请求；显式填写 Provider 时不会静默切换到同名模型的其他 Provider。修改配置后重启 Web profile，使已安装的插件包重新加载。

该错误通常发生在模型已配置但 Provider 路由不匹配、Provider 上游暂时不可用，或安装的插件包不是当前源码版本；502 是上游调用失败，不是 Go POST 接口返回的 HTTP 状态。

默认路由

| 场景 | 候选模型顺序 | 设计理由 | | --- | --- | --- | | project_planning | glm-5.2 → deepseek-v4-pro-0813 → gpt-5.6-sol | 中文架构 / 方案表达与结构化规划最佳 | | plugin_discovery | deepseek-v4-flash-0731 → glm-5.2 → gpt-5.6-luna | 检索推荐类轻量任务，快优先 | | code_review | deepseek-v4-pro-0813 → glm-5.2 → gpt-5.6-sol | 需要深层次逻辑与安全漏洞洞察 | | code_diff | glm-5.2 → deepseek-v4-flash-0731 → gpt-5.6-luna | 变更解释要求准确清晰，快模型兜底提速 | | coding | glm-5.2 → deepseek-v4-pro-0813 → gpt-5.6-sol | 编写 / 调试代码首选，中文交互好 | | reasoning | deepseek-v4-pro-0813 → qwen3.8-max → gpt-5.6-sol | 深度推理主用，数学 / 科研由 qwen 兜底 | | daily | deepseek-v4-flash-0731 → glm-5.2 → gpt-5.6-luna | 简单问答快速省，GLM 提升回答质量 | | fast | deepseek-v4-flash-0731 → gpt-5.6-luna | 极速抽取 / 批量任务，快优先 | | multimodal | qwen3.8-max → qwen3.7-max → gpt-5.6-sol | qwen 系视觉理解能力最强 | | long_context | qwen3.8-max → deepseek-v4-pro-0813 → gpt-5.6-sol | 长上下文 + 数据处理，deepseek 兜底 |

场景 → 模型设计原则

• 深度编写 / 审查 / 架构 → glm-5.2（中文代码能力最强、表达清晰）与 deepseek-v4-pro（深度推理）交替主用。
• 轻量问答 / 抽取 / 分类 / 推荐 → deepseek-v4-flash（快、省 token）。
• 复杂推理 / 科研 / 数学 / Agent → deepseek-v4-pro + qwen3.8-max（数学推理强）。
• 视觉 / 图片 → qwen 系（多模态支持）。
• 长文本 / 数据分析 → qwen3.8-max（长上下文 + 数据处理），deepseek-pro 兜底。
• GPT 只作最后兜底：sol（强）兜深度任务，luna（轻）兜轻量任务。

这些名称是默认候选值，不代表插件会自动提供模型或 Provider。首次使用时，插件会把上表中的规则内容自动写入：dsh「设置 → 模型」中存在的模型原样保留并自动解析 Provider，不存在的默认模型自动替换为同系列的真实配置模型（找不到时保留原名称并在路由时跳过），无需手动添加；也可以在设置页用下拉框调整。

升级注意：0.3.0 起引入了规则表版本（schemaVersion）。旧版安装升级后，持久化的默认规则会被自动替换为新的默认映射（这是升级默认路由的必要代价）；你在设置页手动定制过的候选链 / 模型池会保留，仅规则表版本号会被更新。

工作方式

1. 插件读取当前会话中的用户消息。
2. 如果包含图片，或消息明确涉及图片内容，路由到 multimodal。
3. 如果文本很长，路由到 long_context。
4. 其他消息先按高优先级意图匹配：插件查找 / 工具推荐进入 plugin_discovery，Git diff / 当前修改进入 code_diff，代码质量、漏洞和潜在问题分析进入 code_review，架构 / 方案 / 规划类请求进入 project_planning；编写、调试或修复代码，以及「开发 / 实现 / 搭建 / 构建系统、应用、接口等」请求进入 coding（首位候选为 GLM-5.2）。剩余消息再根据双语关键词表（含中英文、常见编程词）匹配场景；置信度低于阈值时，调用裁判模型（默认 Flash，可在设置页更换）按带示例的规则再次判断。
5. 插件检查候选模型是否可用，并选择第一个可用模型。
6. 请求失败时，继续尝试当前场景候选链中的下一个模型。

如果用户在 dsh 中手动选择了非默认模型，插件会保留这次手动选择，不强制替换。

本地开发安装

克隆仓库后，可以直接从本地目录安装：

git clone https://github.com/xobexo/dsh-smart-scenario-router.git
npx -y @deepseek-ai/dsh plugin --profile web add C:\path\to\dsh-smart-scenario-router

或者使用本地 tarball：

cd C:\path\to\dsh-smart-scenario-router
pnpm install
pnpm pack
npx -y @deepseek-ai/dsh plugin --profile web add C:\path\to\dsh-smart-scenario-router\dsh-smart-scenario-router-0.2.0.tgz

打包内容由 package.json 的 files 字段控制，不需要提交 node_modules。

许可证

MIT