@Elysia11451

dsh-auto-model-router

Name: dsh-auto-model-router
Availability: InStock
Author: Elysia11451

一个按会话来源自动切换模型与推理档位的 DSH 插件

Stars: 1
Language: JavaScript
Created: Oct 7, 2026
Updated: Oct 7, 2026

Tools

GitHub repo

Introduction

dsh-auto-model-router

一个按会话来源自动切换模型与推理档位的 DSH 插件：IM 闲聊走便宜的 Chat 档省 token，Agent 干活走免费池最强的 Work 档 deep 推理。

双档路由：IM 闲聊 → Chat 档（light）；主界面直用 / IM 明确干活 → Work 档（deep）。
三层判定：会话状态机 → 关键词兜底 → 默认 chat，关键词不反向覆盖状态机。
首轮弹窗：新会话首轮弹 Chat/Work 选择（DSH 主界面已验证）。
方向性冷却：chat→work 升档直通，降档受 switchCooldownMs 约束。
手动绝对优先：用户 durable 选择非本路由来源时一律不覆盖，只注解 kept。

工作原理

能力	接缝	说明
来源判断	`exec.agent.source / exec.meta`	微信/QQ/TG 等 IM 渠道 → `im`，其余 → `main`（`src/router.js: sourceFromMeta`）
任务分类	关键词表	命中"装插件/跑命令/写代码/操作文件…" → `agent-work`，否则 `chat`（`src/router.js: classifyTask`）
档位决策	三层判定	状态机在位直接用 → 失效走关键词兜底 → 双失效落默认 chat（`src/router.js: decideRoute` + 会话状态机）
真切落盘	`sessionController.selectModel`	期望档位经 fire-and-forget 落到会话本地选择，全局默认保持 report-only 不污染

数据流一句话：tools/pre-execute 链路上做非侵入式路由注解——读来源与任务类型、算期望档位、写 exec.autoModelRouter 旁路字段并真切，绝不改写工具参数、不阻断工具链。

状态机一句话：每会话持久化 mode/chatTurns/tool（JSONL 侧车 + 热 Map），task 命中钉 work、连 3 轮无工具无关键词才降 chat，首轮默认 chat 放行。

安装

dsh plugin --profile web add github:Elysia11451/dsh-auto-model-router

安装后重进 DSH（或冷启动一次）即生效；dump-config 应出现 auto-model-router 条目且无 WARN。

配置

配置项	默认	说明
`chatMode`	`auto`	`manual` 固定 `manualChatModel`；`auto` 走 `chatModelPriority` 链
`manualChatModel`	`""`	仅 manual 生效，格式 `provider/model`
`chatModelPriority`	`[]`	空数组——不预设 provider，用户按 `provider/model` 自填（便宜优先）；空时回退 `workModelFallback`，日志 `reason=chat-chain-empty`
`workModelFallback`	`mimo-v2.6-flash-free`	链全不中 / 清单未就绪时的最终回退值
`workModelPriority`	`mimo…/glm…/deepseek…`	静态降级链（动态榜不可用时按序挑可用者）
`chatEffort / workEffort`	`light / deep`	推理档位
`enableDynamicRanking`	`true`	`false` = 不请求 OpenRouter，直接走静态链
`reclaimUnknownModel`	`true`	台账外未知模型强制纠偏回路由；`false` = 保守不动
`manualWorkModel / manualWorkModelLocked`	`"" / false`	锁定 work 模型后跳过动态榜
`firstTurnPrompt / firstTurnPromptTimeoutMs`	`true / 60000`	首轮弹窗开关与超时（超时回退 chat）
`switchCooldownMs`	`5000`	同会话切换冷却（升档直通，降档受限）
`enableGroupHint / hintCooldownMs`	`false / 300000`	群聊 work 提示开关与节流

- insert:
    - id: auto-model-router
      name: 'dsh-auto-model-router'
      config:
        chatMode: auto
        chatModelPriority: []          # 自填，如 ['deepseek/deepseek-flash']
        workModelFallback: mimo-v2.6-flash-free
        workModelPriority:
          - mimo-v2.6-flash-free
          - glm-5.3-flash
          - deepseek-v4.1-flash
        enableDynamicRanking: true
        firstTurnPrompt: true
        switchCooldownMs: 5000

使用

日常零操作：IM 里闲聊自动走 Chat 档省 token，说"帮我装插件/写个脚本/跑一下测试"自动升 Work 档 deep 推理；会话里手动选过模型，路由自动让路不再覆盖。

# 新会话首轮会弹 Chat/Work 选择，选 Work 后干活全程走免费池最强模型 deep 档
dsh plugin --profile web exec auto-model-router.selftest

验证

已验（138 用例全绿）：npm test = router 46 / session-mode 7 / crash 49 / leaderboard 30 / first-turn 6，exit 0（含新增 chat-chain-empty 回退断言）。
离线（纯函数探针）：classifyTask/decideRoute/sourceFromMeta 20 条判定 17/20 正确，3 条为关键词覆盖缺口（见已知限制），无逻辑缺陷。
端到端（生产 profile web）：冷启动后 DSH 存活、dump-config 条目 present、link 版本一致、QQ 新会话 route=chat 真切可查（~/.dsh/logs/auto-router.jsonl）。

已知限制

IM 首轮弹窗待 v0.8.7（已知限制）：首轮 Chat/Work 弹窗目前仅在 DSH 主界面生效；IM 通道（QQ/微信/TG）暂不支持，因 DSH 框架层 ask_user_question 在非 Web 通道上的已知缺陷（Discussion #2544、#4708），后续版本修复。
首轮手动选择被覆盖（issues NTR 1）：手选 work 档模型 + 首轮 route=chat 时，首轮默认 chat 真切会覆盖一次，弹窗选 Work 后可纠回。
关键词覆盖不足（issues NTR 4）：查一下当前目录/跑一下测试/调用工具试试 3 条边界误判 chat 档，次轮可升 work。

依赖与致谢

本插件的完整功能依赖以下两个社区插件，特此致谢：

dsh-our-free-model by @Ebony-Vinyl Work 档的免费模型池来源。没有它，Work 档无法动态选模型。
@xmanrui/dsh-im by @xmanrui IM 通道桥接。没有它，微信/QQ/TG 无法接收路由结果。

感谢两位作者的无私开源，让这个插件有机会站在巨人的肩膀上。

关于作者

一个零基础开发者，用 AI 辅助完成了人生第一个开源项目。在这个过程中，最大的收获是学会了如何清晰地表达需求、如何把想法拆解成 AI 能理解的任务。

本项目从设计到实现，大量使用了 AI 工具。

License

MIT — 见 LICENSE。