DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在实际开发中，同一个逻辑模型 ID（如 deepseek-v4-flash）往往需要跨多家供应商或不同套餐调用。手动切换配置既繁琐又容易出错。welsione/dsh-model-router 插件通过统一 ModelID 路由，将多家供应商的候选模型聚合为一个逻辑入口，实现了基于套餐的三档分级、首 token 前故障转移与健康度择优。
插件简介¶
welsione/dsh-model-router 是一个 DeepSeek Harness (DSH) 统一模型路由插件。它将一个逻辑 ModelID 映射为多供应商候选链，支持按套餐（Route Group）划分 tier1/2/3 三档，并在首 token 前失败时自动切换。插件内置管理面板，可配置思考级别、冷却策略及模型能力，并自动持久化设置。
核心能力¶
插件主要包含以下功能：
* 多套餐路由：支持多个 Route Group 并存，每套餐独立管理三档候选链与自定义档位名。
* 自动故障转移：主候选在首 token 前失败（限流/认证/网络/空响应等）时自动切换；支持分级冷却（限流短、服务端中、认证长）及指数退避（封顶 30 分钟）。
* 健康度择优：基于滑动窗口时间衰减与错误码加权对候选进行评分重排，稳定成功的候选优先，频繁失败的延后。
* 三档分级与手动档位：tier1 轻量、tier2 标准、tier3 强大；对话窗口支持会话级手动选档。
* 思考级别：每候选可配置 reasoningEffort，并在保存时预检宿主支持的档位。
* 模型能力写回：管理面板可编辑自定义供应商模型能力（contextWindow/maxTokens），并写回宿主 llm-pi-ai，支持热重载。
* 管理面板：DSH 设置页内置「模型路由」卡片，实时显示路由统计、冷却状态与能力信息。
* 界面语言：支持 zh/en 双语，通过 model-router 命名空间注册表切换。
* 会话安全：支持跨 provider 自动清洗 replayState。
安装与启用¶
插件已发布至 npm，可通过 DSH 插件命令安装：
dsh plugin --profile web add @welsione/dsh-model-router
如需卸载：
dsh plugin --profile web remove @welsione/dsh-model-router
安装完成后，DSH 设置页将出现「模型路由」卡片，对话窗口的模型选择器将变为「套餐」选择器。
配置与使用¶
打开 设置 → 模型路由，添加一个统一 ModelID（例如 deepseek-v4-flash），并为 tier1/2/3 分别配置候选模型即可。插件修改会自动保存并即时生效。
权限与数据¶
插件运行时状态为内存态，手动档位持久化到宿主 settings。它不会对外发请求、不读写工作区文件、不上报遥测，也不接触 API Key。
兼容性¶
该插件仅支持 DSH 0.1.0-rc.x 至 0.1.5-rc.x 版本，需要 Node.js ≥ 22 环境运行。
结语¶
该插件通过逻辑 ID 统一与自动故障转移机制，降低了多供应商模型管理的复杂度。完整配置表与示例见 GitHub 仓库。
