Echelon
给 DeepSeek Harness 用的挡位式模型路由。把十几个模型收成几个你自己命名的名字，选中一个，背后是一条有序的真实模型链：按序调用、失败重试、自动降级。
English
dsh plugin --profile desktop add dsh-echelon
配置页
解决什么问题
DSH 的模型选择器会列出每一个能用的模型。接了几个供应商之后，这个列表变成十几个名字各异、能力不同的条目，每次开新对话都要重新判断该用哪个。
Echelon 把这一步换成命名：定义几个挡位（日常、深度、免费…），选择器里就只剩这几个名字。
三个关键点
能力不同的模型可以互相当备用
这是最不显然的部分。链里混放能力不同的模型会遇到三个障碍，每一个都会让"自动换模型"变成"悄悄降级"：
| 障碍 | Echelon 怎么做 |
|---|
思考档位命名不同（medium / max / 不声明） | 统一 off / low / middle / high / xhigh，派发时按成员翻译；翻译不到就用成员自己的默认 |
| 上下文窗口不同（1M 与 300K 混放） | 上报最大窗口，再按本次请求大小挑装得下的成员 |
| 视觉能力不同（多模态与纯文本混放） | 请求带图时跳过看不了图的成员 |
于是"强的"和"便宜的"可以共处一条链：小请求走便宜的，大请求落到大窗口，带图请求落到能看图的。你不用知道背后选的是谁。
调用日志
这张日志里的一次请求同时触发了三种判断：带图 → 跳过无视觉成员；上下文过大 → 跳过小窗口成员；随后限流重试成功。
选择器变干净
隐藏真实模型，只留挡位。默认「全部显示」，隐藏是你确认挡位可用后主动做的选择。挡位里没有可派发的成员时隐藏会自动放开 —— 菜单永远不会变成进不去设置页的空列表。
兼容现有插件
成员可以是其它插件的路由（它们都只是 供应商/模型 字符串）：dsh-our-free-model 的免费车道、dsh-model-fusion 的 auto、任何注册了 provider 的插件。
不修改 DSH 本体，不 patch 任何东西 —— 只注册一个 provider 路由，并包装一个公开只读方法来实现隐藏。
快速上手
dsh plugin --profile desktop add dsh-echelon
需要 DSH ≥ 0.2.0-rc.1、Node ≥ 22.14.0。装完重启 dsh，刷新页面。
- 配置 → 新增挡位，起个名字。
- 添加模型，按优先级排列 —— 顺序就是降级顺序。
- 确认能正常对话后，再把 设置 → 模型选择器的显示 切成「只显示挡位」。
首次安装是「全部显示」，你的模型一个都不会少。
高级功能
- 逐成员设置：重试次数、超时、思考强度、上下文长度、最大输出、视觉能力（模型能看图却没上报时手动指认）。
- 超时按"进展"算，不按"数据"算：只发心跳、空包、计量行不算活着，超时照样换下一个；模型的思考过程算进展。范围 3–60 秒，全新安装默认 6 秒，可以关掉。DSH 自己会重试，而重试通常比等待更划算。
- 挡位默认值：给整条链设一个超时和重试次数，成员没单独设置时生效。
- 新对话默认强度：跟随模型，或固定成五档之一。
- 思考强度映射开关：开启时选择器统一五档，选中后按成员翻译（成员没有就换成最接近的，完全没有就交给模型默认）；关闭时显示模型自己上报的档位并原样转发。成员编辑器里的那一栏永远只用该模型上报的档位 —— 那是给单个成员钉死档位的地方，不能钉一个它不认识的值。
- 图片路由：带图的请求优先选能看图的成员。开启 设置 → 高级 → 兼容视觉模型 后，只有时效范围内的图片才把整条链锁在视觉成员上（默认最近 5 条对话，也可按分钟计）；超出时效，非视觉成员重新参与派发，图片以
[图片] 纯文本发给它们，内容由模型从上下文推断。能看图的成员照旧收到真实图片。默认关闭，行为与之前一致：对话里只要还有图片就走视觉成员。
- 调用日志：每次请求 挡位 → 真实模型、档位怎么翻译的（
xhigh → max / 未发送）、试过谁、为什么被跳过、耗时与 token。写盘保存，重启不清空，默认保留 128 条，可关闭。
- 上下文写法：
1m、256k、128k、纯数字都行，不用数零。k=1000、m=1000000（十进制：看到什么就输入什么，数值不会被改写）。
- 保存即生效：改设置不用重启，也不用刷新页面。右上角一个按钮：有改动时保存并重新加载，没改动时只重新加载。
- 配置文件：
$DSH_HOME/model-router/settings.json，可手改（同样接受 "128k"）；写入走临时文件+重命名，不会留下半份配置。
超时是怎么判定的
界面里的说明只有一行，细节在这里。
看门狗量的不是"有没有收到数据"，而是"有没有进展"。这个区别很关键：不少网关在模型卡住时会持续发心跳、空 delta、只带 usage 的包，如果按"收到任何数据"算，这次尝试可以无限挂着——屏幕上什么都没有，计时器却一直在重置。
算进展的：
- 带非空白文字的
text-delta / reasoning-delta（一个字符也算）
- 带名字或非空参数的工具调用
- 块开始 / 块结束
- 结束包
不算进展的：空字符串、纯空白的 delta、只带 usage 的行、任何未知类型的心跳。
三处共用这一个预算，所以卡在哪一步都会被拦：
| 阶段 | 以前 | 现在 |
|---|
resolveModelInfo 查能力 | 无期限（卡住时日志是空的） | 8 秒，超时降级为「能力未知」 |
prepareCall 准备请求 | 无期限 | 成员自己的超时 |
| 流式输出 | 只在"完全没数据"时生效 | 同上，且按进展判定 |
超时后会主动取消该成员的请求，并且清理有 1 秒上限——否则清理本身会卡在同一个读上，出现"8 秒预算却跑了 277 秒"。
关于误伤：模型思考时在持续产出 reasoning delta，算进展；模型等待本地命令执行时，这次模型调用早已以工具调用块结束，看门狗根本不在等待——所以跑十分钟的本地任务不受影响。
输入框的行为
- 打字过程中不校验、不纠正：你可以先把 90 删成 9、再删空、再重新输入。
- 只有失焦或回车时才规范化：低于下限填下限，高于上限填上限，空着表示"不设置"。
- 不显示上下箭头，方向键和滚轮不会改动数值。
和其它方案的区别
Echelon 是 DSH 插件，不是独立的模型网关 —— 这个区别决定了它适合什么、不适合什么：
| Echelon | LiteLLM / One-API / New-API / OpenRouter |
|---|
| 形态 | DSH 内部插件 | 独立服务，对外提供 OpenAI 兼容端点 |
| 覆盖范围 | 只在 DSH 里生效 | 任何兼容 OpenAI 协议的客户端（Cursor、Cline、Cherry Studio、Chatbox 等） |
| 部署 | 装进 DSH 即用 | 需要单独起服务、配端口与密钥 |
| 路由依据 | 挡位 + 上下文大小 + 图片 + 思考档位 | 通常是模型名、权重、配额、限流 |
| 解决的是 | 「DSH 里该选哪个模型」 | 「所有客户端统一走一个入口」 |
所以：如果你要给 Cursor、Cline、Cherry Studio、Chatbox 这类客户端做一个统一的 OpenAI 兼容入口，LiteLLM 或 One-API 更合适 —— Echelon 不提供外部端点，做不到这件事。
如果你要的是在 DSH 里不用再记十几个模型名、还要失败自动降级、还要考虑上下文和图片，Echelon 就是为此设计的。两者也可以并存：把 LiteLLM 之类注册成 DSH 的一个 provider，再让 Echelon 把它和免费车道放进同一条挡位。
关键词
方便检索用的同义说法：
中文：模型路由 / 模型聚合 / 挡位 / 按序降级 / 接口兜底 / 失败自动切换 / 渠道自动切换 / 防限流 / 429 处理 / 免费模型聚合 / 多供应商 LLM / 思考档位映射 / 上下文窗口路由 / 视觉能力路由
English: model router, model cascading, sequential fallback, automatic failover, multi-provider LLM, provider routing, rate-limit handling (HTTP 429), request retry, reasoning-effort mapping, context-window routing, vision / multimodal routing, DeepSeek Harness plugin
其它安装方式
| 方式 | 命令 |
|---|
| npm（推荐） | dsh plugin --profile desktop add dsh-echelon |
| 指定版本 | 加 #v1.9.0 |
| GitHub 源码 | dsh plugin --profile desktop add github:Abnerluo123/dsh-echelon |
| 插件市场 | 插件 → 插件市场，搜索 Echelon |
desktop 换成你的 profile 名（dsh profile list）。
验证：dsh plugin --profile desktop list 应包含 dsh-echelon；设置里出现 Echelon。
卸载：dsh plugin --profile desktop remove dsh-echelon。配置保留在 settings.json，需要彻底清理时手动删除。
已知限制
- 隐藏依赖包装
llm.listModels：DSH 没有目录过滤钩子，绕过它直接读适配器的代码不会被过滤。
- 调用日志保留有限条数：默认 128 条，写盘所以重启不清空，但它是排障视图不是审计记录，超过上限的最旧条目会被丢掉。
- 未声明视觉能力的模型按"未知"处理：仍是图像请求的候选，但不会优先选中。
ABORTED 与 CONTEXT_WINDOW_EXCEEDED 不降级：前者是你取消的，后者换个模型也装不下。- 内部路由 id 仍为
model-router：改品牌时没有动它，已保存的会话和配置继续有效。
开发
node --test test/ # 219 项测试，无需网络
node scripts/verify-profile.mjs # 检查当前 profile 能否加载
test/integration.test.js 在本机有 DSH 应用包时，会用真实的 LlmRuntime 跑注册、派发、隐藏与降级。
| 文件 | 职责 |
|---|
index.js | Host 入口：注册路由、目录过滤、设置 API |
src/adapter.js | 按链派发、流式转发、重试、降级、写日志 |
src/config.js | 规范化、链展开、上下文与模态筛选 |
src/effort.js | 思考档位词汇与逐成员翻译 |
src/tokens.js | 请求大小估算与图片识别 |
src/catalog.js | 目录过滤（隐藏）与未过滤读取 |
client.js | 设置页与调用日志页 |
License
MIT
