前言¶
在 DeepSeek Harness(DSH)里做多模型开发时,常见做法是自己在对话里切换供应商、模型和推理档位。任务类型一变就要重新选,同一条对话里还可能混着写代码、改文档、做翻译。社区插件 dsh-decision-router(维护者 xinyang20)把「理解任务」和「执行任务」拆开:独立的决策模型根据任务从你在 DSH 里已配置的执行模型中做路由,并可选本地推理或经用户确认后的云端决策。
下面介绍插件定位、能力边界,以及安装与配置步骤。DeepSeek Harness 生态强调「一切皆插件」;SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系。
这是什么¶
DSH Decision Router 是为 DeepSeek Harness 提供的自动选模插件:决策模型负责选模型与推理强度,执行模型负责完成用户任务。简介为 Decision-model-powered routing for DeepSeek Harness, with local inference and opt-in cloud decisions;代码采用 MIT 许可证,当前发布版本 v0.1.0。README 写明已验证宿主版本为 DSH 0.2.0-rc.2,其他 DSH 版本需自行验证。
核心功能¶
手动优先、每轮决策¶
仅在 DSH 原生模型选择器里选中「自动选模 → 自动」时,插件才参与路由。每一轮用户交互决策一次,同轮内的工具调用沿用该次结果;若用户选中具体执行模型,下一次模型请求直接使用该模型及推理强度,路由模式不会覆盖手动选择。
2–6 条自定义路由¶
在「设置 → 自动选模」中配置 2–6 条路由:每条绑定已在 DSH 中配置好的供应商、执行模型、推理档位,并填写用途描述与补充说明。路由可按能力划分,也可按前端、后端、翻译等场景划分;列表顺序不代表强弱。需指定一条回退路由,在决策超时、服务失败或置信度不足时使用。本地决策失败不会自动切云端,云端失败也不会换其他决策服务。
路由模式¶
| 路由模式 | 选中「自动」后的行为 |
|---|---|
| 自动选择 | 请求决策模型,按结果执行;失败或置信度不足时使用回退路由 |
| 仅观察 | 请求并记录决策建议,实际始终使用回退路由 |
| 暂停决策 | 不请求决策模型,使用回退路由 |
修改配置从下一轮决策生效;主动切换具体模型则从下一次模型请求生效(含同轮后续工具步骤)。侧边栏「自动选模」提供只读总览与最近路由记录,可在设置中关闭;编辑配置请进入设置页。
决策方式¶
- 本地:支持 Laya 多语言、d1-3B、d1-omni-600M;本地辅助服务当前文档写明支持 macOS(d1 安装脚本仅 Apple Silicon arm64),通过
sandbox-exec限制模型子进程主动联网。 - 云端(可选):用户明确同意后可使用 System One 类 API;默认接口
https://api.typesafe.ai/v1/systemone,默认模型jev-latest。README 注明尚未用真实密钥验证 Jev API 调用,可用性与费用需自行验证。
三款本地决策模型当前在插件侧只处理文本路由(未下载图片/音频 projector)。
安装与启用¶
安装前需已有可运行的 DSH,并在 DSH 中配置好执行模型及凭据。插件安装需要 Node.js ^22.19.0 || >=24.0.0 和 pnpm。插件以当前 DSH 进程权限运行,安装前宜自行查看 GitHub 仓库 源码与许可证。
从 GitHub 安装 v0.1.0:
dsh plugin --profile web add github:xinyang20/dsh-decision-router#v0.1.0
仓库含预构建的 lib/client.js,安装无需执行 prepare。也可从 Releases 下载 dsh-decision-router-0.1.0.tgz,在下载目录执行:
dsh plugin --profile web add ./dsh-decision-router-0.1.0.tgz
安装后打开 DSH Web;若无插件入口,重启 DSH 并刷新。安装本身不会下载决策模型或启动本地推理服务。
首次配置与对话用法¶
- 打开「设置 → 自动选模」。初装为「暂停决策」,执行路由尚未配置。
- 配置 2–6 条路由及回退路由;选择决策方式(本地需先完成下文准备并保持服务运行;云端需确认数据传输并填写接口、模型与密钥)。
- 点击「保存模型配置」,将「路由模式」设为「自动选择」(或按需选「仅观察」)。
- 在对话原生模型选择器中选择「自动选模 → 自动」,再发送任务。
路由模式与侧边栏开关即时保存;模型、用途描述、回退路由等须点击「保存模型配置」。关闭设置页时若有未保存修改,可选择继续编辑、放弃或保存后关闭。
配置默认位于 $DSH_HOME/plugins/dsh-decision-router/model-tiers.json(即 DSH 数据目录下 plugins/dsh-decision-router/model-tiers.json),含路由、决策方式、回退、路由模式、侧边栏及可选云端凭据。路由记录在宿主进程内最多保留 200 条,重启清空;置信度反映候选概率分布集中程度,未与任务成功率校准。
本地决策:准备与服务¶
本地模式需在本机单独克隆同版本仓库用于准备与启动服务(与上述 dsh plugin add 安装插件是两条路径)。准备 Node.js、pnpm;使用 Laya 时还需 uv。
git clone --branch v0.1.0 --depth 1 https://github.com/xinyang20/dsh-decision-router.git
cd dsh-decision-router
pnpm install --frozen-lockfile
按 README 择一或同时准备模型:
| 模型 | 准备命令 | 说明 |
|---|---|---|
| Laya 多语言 | pnpm run laya:setup,再 pnpm run laya:download |
固定 Laya 0.3.28,uv + Python 3.12,CPU 推理 |
| d1-3B / d1-omni-600M | pnpm run d1:setup |
llama.cpp b11490 与 GGUF;仅 macOS arm64 |
d1-3B 文本权重约 1.67 GB(Q4_K_M);d1-omni-600M 约 407 MB(Q8_0),为实验选项。依赖与首次模型下载需联网,不携带任务内容;文件落在项目内 .venv、.runtime、.cache。
在仓库目录启动服务并保持终端运行:
pnpm run decision:serve
服务监听 127.0.0.1:39401,出现 ready: true 后在 DSH 设置中选择已安装的决策模型。每次只保留一个模型进程;本地 HTTP 不跟随重定向或环境代理,模型子进程不继承 API Key 与代理变量。执行模型是否联网仍由 DSH 中选择的供应商决定。
云端决策与数据范围¶
云端模式无需 decision:serve 与本地权重。选择「System One API(云端)」时会显示数据传输提示;确认后填写密钥并保存模型配置才会用于决策。发送内容包含任务组成的 state、最多两条近期用户输入,以及候选路由的用途描述与补充说明。密钥存本机配置文件、权限 0600、未加密;执行模型凭据仍由 DSH 管理。
仅在原生模型为「自动」且模式为「自动选择」或「仅观察」时请求云端;「仅观察」仍会发送数据。「暂停决策」、选手动执行模型或改回本地决策后,不再请求云端。
适用场景与注意¶
适合已在 DSH 中配置多条执行模型、希望按任务自动切换模型与推理档位的开发者。若只需固定单一模型,不必启用本插件。
注意点归纳如下:
- 宿主版本以 README 验证的 0.2.0-rc.2 为准;升级 DSH 后需重新验证。
- 本地决策服务文档当前面向 macOS;Linux 等系统尚未支持文档中的隔离运行方式。
- 云端决策涉及任务片段外传,须阅读设置内提示并自行评估协议与费用(参见 System One API 文档)。
- 插件安装不替代对执行模型供应商凭据的配置;决策路由效果取决于用途描述质量与决策模型能力,README 未提供准确率或费用基准数据。
链接¶
- 目录页:https://www.skillhub.cn/plugins/xinyang20/dsh-decision-router
- 仓库与说明:https://github.com/xinyang20/dsh-decision-router
- 问题反馈:https://github.com/xinyang20/dsh-decision-router/issues
若你已在 Harness 里铺好多条执行路由,希望把「选哪条」交给专用决策模型并在本地或可控云端完成,可按上文安装命令接入插件,再在设置中完成路由与决策方式配置。