在 DeepSeek Harness (DSH) 的插件化生态中，模型路由是平衡成本与性能的关键环节。传统基于关键词或单一会话头信息的路由器，难以在同一个主要路由下精确区分不同的子任务类型（例如编程任务与硬编码任务）。dsh-quota-router 旨在解决这一问题，它通过保留“任务配置文件”与“候选链”的完整上下文，确保路由决策的确定性。
它是什么¶
这是一个纯策略驱动的多源模型路由插件，由 Liyuk 维护。它不依赖适配器或管理凭据，仅利用 DSH 原生注册的模型源，通过全局优先级列表与任务映射来构建候选链。该插件主要用于在混合源（免费、订阅、无限、低价、手动紧急）工作流中执行“成本源”管理。
核心功能¶
- 确定性任务配置文件：支持命名任务配置文件与有序候选链，确保每个轮次的路由逻辑清晰。
- 健康感知与回退：具备健康检查能力，能在基础设施故障时进行有界且可解释的回退。
- 可观测性：提供路由决策的观测接口，并准确测量路由使用量，而不夸大代币节省。
安装与启用¶
安装该插件需要使用 npm 命令：
npm install @liyuk/dsh-quota-router
安装完成后，在 DSH Web 配置文件中启用该包，即可使用。
典型用法¶
- 配置路由策略：在 DSH Web 界面中，进入 Settings → Quota Router。该页面会打开专用的配置入口，允许编辑全局优先级列表、重试策略、任务配置文件的关键词映射以及
modelBySource映射。 - 运行时检查：通过只读工具
quota_router_status检查运行时的决策状态，包括活跃的冷却期、路由决策以及使用情况。 - 路由流程：插件会将用户消息路由到指定的命名任务配置文件，然后在该配置文件的候选链上选择第一个健康且自动符合资格的源。
适用场景与注意¶
- 权限范围：仅使用 DSH 原生注册的提供商和模型，插件本身不拥有适配器或凭据。
- 排序权威：
sources.priority是源排序的唯一权威；sourceTier仅作为解释性元数据，不作为隐藏的重排规则。 - 手动与紧急候选：
manual和emergency候选项永远不会被自动选中。 - 付费回退：付费候选项需要显式的
allowPaidFallback: true选项才能被选中。 - 历史记录：上下文压缩由 DSH 独立配置和触发，此插件不会重写会话历史。
