4060415/Deepseek-harness-routing-layer-

README 摘要

DeepSeek Harness 专用自动路由插件 DeepSeek Harness 的可配置智能模型路由插件：根据每次请求的任务需求，从 已注册的模型 中自动选择最合适的 provider/model，而非固定使用一个模型。 纯插件实现，零核心修改 ——图片自动切视觉模型、代码任务切代码模型、限流自动换 provider、能力不足自动升级。 目录 - 为什么需要 - 特性 - 安装 - 快速开始 - 工作原理 - 配置参考 - Fallback 与 Escalation - 手动覆盖 - 安全边界 - 常见问题 - 测试 - License 为什么需要 默认情况下，dsh 用固定一个模型处理所有请求，这会带来几个问题： 问题 后果 图片发给纯文本模型 模型无视图片，答非所问（甚至卡住） 复杂代码 / 长文本发给轻量模型 能力不足，回复质量差、超上下文 单个 provider 限流 / 故障 请求直接失败，无法自动恢复 llm-router 在 agent/request 边界自动改写模型选择，让 每个请求都路由到最合适的模型 ——你只需要写配置，不用改任何代码。 特性 - 🧩 纯插件 ：不改 DSH 核心，通过 npm 包即可安装。 - 🎯 智能分类 ：规则 + 能力启发式识别 vision / coding / reasoning / tool use / 长文本等任务（非 ML，可解释）。 - 🖼️ 视觉路由 ：图片自动切到支持视觉的模型。 - 💻 代码路由 ：代码复杂度越高，越倾向能力强（贵）的模型。 - 🔁 自动 fallback ：限流 / 配额 / 超时等临时错误 → 换另一个 provider 重试。 - ⬆️ 自动 escalation ：空回复 / 超上下文等能力不足 → 升级更强模型（有上限）。 - 🔒 安全边界 ：模型只能从 Registry 选，任何「模型推荐」都经 ModelRegistry.resolve() 校验。 - ⚙️ 可配置可关闭 ：支持手动模式、 /model 覆盖、成本 / 延迟策略。 安装 本插件是 dsh 的 树外插件 （out-of-tree plugin），需与 dsh 一起使用。它依赖 dsh 已提供的 cordis / dsh-agent / dsh-llm / dsh-settings （作为 peerDependencies 声明）。 前置条件 ：已安装 DeepSeek Harness（ @deepseek-ai/dsh ）。 从 GitHub 安装 快速开始 示例中的 provider / model 名是示意，替换成你实际注册的即可。 第 0 步：确认有可路由的模型 Router 只从 已注册 的 Model Registry 里选模型，不硬编码任何模型名。先确认你的 dsh 里注…

分类