superboy911/dsh-model-router

dsh-model-router

中英配套主页

dsh-model-router 是 DeepSeek Harness（DSH）的薄路由策略插件。模型提供方、凭据、模型目录、模态能力和重试仍由 DSH 管理；本插件只增加确定性的关键词路由、默认关闭的白名单 model_route 工具，以及隔离的 image_gen 生图通道。

DSH 官方模型页面仍是唯一的模型提供方配置入口。

当前版本：v0.2.2，已在 DSH 0.1.0-rc.6 验证。image_gen 仍为 Beta；视频、音频和 3D 尚未实现。

维护者的话

这是我第一次维护开源仓库。我还在学习插件设计、测试、安全、文档和项目维护。当前版本已经可以使用并有自动化测试，但我不会把它包装成成熟或完美的方案；代码里仍可能存在错误、粗糙之处，或者更好的架构选择。

非常欢迎熟悉 DSH、TypeScript、安全、模型路由和技术文档的朋友参与。一个 Issue、一条审查意见、一份复现记录、一次文档修正或一个 Pull Request 都很有价值。提出修改时也欢迎说明原因，让我能跟着一起学习。

• 如何参与
• 公开路线图
• 社区行为准则

能做什么

插件不会再调用一个模型去“猜”应该选谁，而是执行你在设置 → 模型中枢中配置的确定性规则。

模型购买策略

示例中的五个模型只是一套兼顾成本的起点，不代表通用排行榜，也不要求贡献者必须购买：

原则是“低成本模型做默认、复杂任务定向升级、媒体模型明确调用”。价格和模型可用性会变化，购买前请以各提供方当期官网为准。详细说明见模型策略与路由边界。

运行要求

• DeepSeek Harness 0.1.0-rc.6
• Node.js ^22.19.0 或 >=24.0.0
• 仅开发或重新构建时需要 pnpm 11

从 GitHub 安装

git clone https://github.com/superboy911/dsh-model-router.git
cd dsh-model-router

# 可选：复现仓库中的构建产物。
corepack enable
pnpm install --frozen-lockfile
pnpm build

# 安装到 DSH web profile。
npm exec @deepseek-ai/dsh -- plugin --profile web add --force "$PWD"

安装后重启 DSH Web，再打开设置 → 模型中枢。手动启动命令：

npm exec @deepseek-ai/dsh -- web

Seedream 生图通道

把真实密钥保存在 DSH Credentials 中，引用名使用 VOLCENGINE_ARK_API_KEY；不要把密钥值写进仓库。

model-router:
  mediaProviders:
    - id: volcengine-seedream
      name: 豆包 Seedream 5.0 Lite
      capabilities: [image_gen]
      adapter: openai-images
      baseUrl: https://ark.cn-beijing.volces.com/api/v3
      credential: VOLCENGINE_ARK_API_KEY
      models:
        - doubao-seedream-5-0-lite-260128
      allowedResultHosts:
        - ark-acg-cn-beijing.tos-cn-beijing.volces.com
      defaultSize: 1920x1920

会话头显示的是负责调度工具的文字模型，image_gen 工具结果才记录真正的生图提供方和模型。

路由示例

model-router:
  schemaVersion: 2
  enabled: true
  matchCase: false
  rules:
    - id: architecture-review
      enabled: true
      keywords: [架构, 重构, architecture, refactor]
      target:
        provider: deepseek-official
        model: deepseek-v4-pro
        reasoningEffort: high
  agentSwitch:
    enabled: false
    allow: []

未命中不改动会话：继续使用当前手动选择，或由 DSH 默认模型接管。

开发与验证

corepack enable
pnpm install --frozen-lockfile
pnpm test
pnpm check:secrets
pnpm build
pnpm pack:dry

accept:models 会真实调用外部模型并可能产生费用，因此不会在持续集成中运行。

文档

• 配置参考 · English
• 架构说明 · English
• 模型策略
• 脱敏示例
• 安全策略 · English
• 参与贡献 · English
• 更新记录 · English
• MIT 许可证 · 非正式中文译文

安全边界

• 不得提交密钥、DSH 设置、签名媒体地址、本机绝对路径或生成产物。
• 媒体 API 端点必须使用 HTTPS；只有本机回环开发端点可以使用 HTTP。
• 生图结果必须使用 HTTPS，并经过域名、重定向、DNS、大小和文件魔数校验。
• 设置页可以看到凭据引用名，但看不到凭据值。
• 仓库公开后 CodeQL 工作流会运行；私有仓库需要另行启用 GitHub Advanced Security，本项目不会自动开启该功能。

疑似漏洞请通过 GitHub Security Advisories 私下报告。