前言¶
在 DeepSeek Harness（DSH）里做多模型协作时，常见做法是手动挑一个默认模型，或在会话里临时换 provider。任务一旦被拆成多个有依赖的工作包，成本、质量下限和执行边界（只读预览还是可写工作区、是否走厂商 CLI）往往要在脑子里对齐，缺少一个能在本地规划、对比路由方案再执行的地方。
dsh-model-router（npm 包名 @ljwei-stak/dsh-model-router，仓库 Alice-Marx/dsh-model-router）是社区维护的 DSH 插件，维护者为 Alice-Marx，在社区目录中归类为模型推理相关能力。它把「任务规划、路由分配、依赖工作包执行、官方 CLI 发现与安装」收进同一工作台，并强调成本预览与显式执行权限。自 0.12.0 起，路由插件与 GAL 已拆分为独立插件；简介里的 GALGame 能力需通过单独的 @ljwei-stak/dsh-galgame 安装，本文只讨论 model-router。
这是什么¶
一句话定位：面向 DeepSeek Harness Desktop 的成本感知模型路由工作台——在本地做任务分类与复杂度分析，对比已配置的路由，检查执行权限，再通过模型 API 或支持的官方厂商 CLI 运行带依赖的工作包。
当前发布版本为 0.22.2，许可证 MIT。插件入口为包内 .dsh-plugin/index.mjs 导出的 apply(ctx)。README 声明的宿主兼容范围为 DeepSeek Harness Desktop 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2（含 Hermes/Pi 安装与终端支持）；超出该范围的兼容性未在资料中声明。
核心功能¶
下面按 README 能力表归纳当前行为，不展开未在资料中出现的接口细节。
任务规划与路由¶
- 任务规划：本地任务分类与复杂度分析；可给出单一路线推荐、带依赖的团队工作包，或显式指定已配置模型。
- 模型配置：从 Harness 读取精确的
provider/model路由；可选补充质量、USD 单价、专长、CLI 模型名、执行与计费偏好。 - 路由预设：经济、均衡、质量优先等预设；支持质量下限、预估 token 成本与有界分配搜索；缺失单价时保持为未知。
- 路由算法（0.22.x）：支持任务相关质量证据、模型与 effort 联合选择、历史 P90 资源估计与依赖感知搜索；算法推荐或手动为每个分解包指定 API/官方工具，保留依赖关系并刷新成本预览与重试目标。手动混合执行为只读；工具使用其配置的默认模型，可编辑的官方团队协作流程仍可用。
执行与官方工具¶
- 只读执行：在工作台预览并确认路由运行，或在官方 Harness 会话中调用；支持的无头 CLI 与模型目录 API 调用会返回记录结果。
- 可编辑 CLI 执行：工作台顺序 CLI 团队，或会话内单一受支持 CLI；使用经批准的隔离 Git worktree 与条件补丁集成。选择
cli-native可编辑团队时，在厂商 CLI 的正常 OS 用户权限下运行，worktree 收集编辑但不限制 OS 访问；CLI 保留各自配置的模型，除非显式映射。 - 官方工具：检测、安装/更新、检查启动就绪与登录状态，覆盖注册表中的十二种工具；安装任务有日志与取消。
- 交互终端：PowerShell/系统 shell 与十二种注册 CLI 目标（含在已验证的 Windows Desktop 安装上的 ZCode TUI），固定登录命令、实时输出与多会话。
成本、历史与边界¶
- 成本与订阅：日/月预算检查、经济降级或暂停、订阅优先路由、配额冷却及其他订阅失败的处理。
- 历史与质量：按包记录结果、依赖视图、失败详情、重跑/重分配、评分与可选更强模型复审。
- 执行边界：展示各路由可读/可写范围及进程是否使用 Harness 沙箱等限制（资料中表格未截断完整表述，以 README 为准）。
规划阶段在本地完成，不发起模型调用；执行阶段会把选定任务/上下文发往所选 API 或厂商 CLI，可能产生费用。
安装与启用¶
安装命令须使用资料中的 npm 包 spec，不要凭仓库名拼接 dsh plugin add github:...。单独 npm install -g 不会自动注册 Desktop 插件。
通过 DSH CLI（web profile）安装：
dsh plugin --profile web add @ljwei-stak/dsh-model-router@0.22.2
在 Harness Desktop 中使用：
先启动 Desktop 一次以初始化 desktop profile，完全退出 Desktop 后执行：
dsh plugin --profile desktop add @ljwei-stak/dsh-model-router@0.22.2
也可在 Harness Desktop → Plugins → Add plugin 中粘贴上述包 spec。安装后需重启 Desktop。
配置方式： 不支持导入用户自写的 JSON/YAML 配置文件。在 Harness 的 Models 页面配置 provider、模型与凭据；在插件设置中配置路由 profile 与偏好。路由持久状态位于 $DSH_HOME/model-router/state.json（默认 ~/.dsh/model-router/state.json）。厂商 CLI 保留各自的登录与配置；路由器不会把 API key 复制进模型 profile 或终端日志。
典型用法¶
资料指向更完整的 walkthrough，可按需阅读：
- 工作台：docs/WORKBENCH_USER_GUIDE.zh.md
- 安装：docs/INSTALLATION_GUIDE.zh.md
- 路由自测：docs/ROUTING_SELFTEST_STEPS.zh.md
可复现的主线如下：
- 在 Models 页配好
provider/model与凭据（及可选单价、质量等偏好）。 - 打开插件工作台，输入或导入任务，本地完成分类与分解，查看推荐路由或手动分配每个工作包。
- 对比经济/均衡/质量预设下的成本预览与质量下限，确认执行权限（只读预览、
workspace-write或 CLI 原生环境）。 - 在工作台确认后执行，或在官方会话中触发已路由的运行；需要厂商 CLI 时，先用插件内的官方工具流程完成检测、安装与登录检查。
- 在历史视图中查看按包结果、依赖与失败详情，按需重跑或重分配。
README 中的 routing workflow 图 概括执行流；0.20.0 Windows 验证报告 记录真实厂商执行证据及限制。资料注明 0.22.2 尚无经核实的端到端厂商运行；工作台截图使用 fixture 数据，为模拟 UI 预览而非 live 运行。
适用场景与注意¶
适合谁： 已在 DSH Desktop 上配置多模型路由、需要把复杂任务拆包并按成本/质量做分配的团队或个人；同时需要统一发现、安装十二种注册官方 CLI 并在 Harness 内做只读或可编辑执行的场景。
权限与风险： 插件随当前 DSH 进程权限运行；安装前应阅读仓库源码与 MIT 许可证，自行评估数据出境与计费条款。默认 Harness 受限环境区分只读与已批准的 workspace-write；显式选择 cli-native 可编辑团队时，权限等同于当前 OS 用户，不在 Harness 沙箱内。外部 provider 与 CLI 服务适用其各自的数据处理与计费条款。
生态说明： DSH 社区插件目录（如 skillhub 目录页）为独立站点，与 DeepSeek / 幻方无官方从属关系；分类「模型推理」来自社区归类，并非 DSH 官方应用商店分类。
结尾¶
dsh-model-router 把本地规划、成本感知路由、依赖工作包执行与官方 CLI 运维放进同一工作台，适合在 Harness Desktop 上系统化管理多模型任务而非单次会话里临时换模型。当前版本 0.22.2，GitHub 仓库约 205 stars（以目录/仓库页面为准）。
- 目录页：https://www.skillhub.cn/plugins/Alice-Marx/dsh-model-router
- GitHub：https://github.com/Alice-Marx/dsh-model-router
- npm：https://www.npmjs.com/package/@ljwei-stak/dsh-model-router
