dsh-set-model
简体中文 ·
English
为 DeepSeek Harness（DSH / cordis plugin）提供动态模型与思考深度切换的插件：Agent 通过 set_model / list_models 工具按任务难度自主切换 provider、model 与 reasoningEffort，插件把活跃模型注入运行时上下文，并随 Plan 模式自动升降级模型。
攻坚疑难问题时升到高推理档位，日常执行保持高性价比档位——不再需要用户手动改配置。
模型看到什么
插件通过 systemPrompt.context 在每个 step 的 Runtime Context 快照尾部注入一行当前活跃模型（cache-safe 追加，模型随时自查、无需调用工具）：
[Current active model: deepseek/deepseek-chat · reasoning: low]
处于 Plan 模式时附带状态标记：
[Current active model: deepseek/deepseek-reasoner · reasoning: high] [Plan Mode Active]
工具：set_model
set_model({ provider?, model?, reasoningEffort?, reason }) —— reason 必填（每次切换都会使会话 KV cache 失效，工具说明要求 Agent 给出理由、避免频繁切换）：
{ "model": "deepseek-reasoner", "reasoningEffort": "high", "reason": "疑难并发问题排查，需要深度推理" }
工具返回：
Model successfully switched to deepseek/deepseek-reasoner · reasoning: high. Effective from the next step.
Reason: 疑难并发问题排查，需要深度推理
工具：list_models
list_models({ provider? }) 列出已注册 Providers 与模型能力（推理档位、上下文窗口）：
# Available Providers & Models:
## Provider: deepseek
- **deepseek-reasoner** (DeepSeek Reasoner) | Reasoning: [low, high, max] | Context: 128000
- **deepseek-chat** (DeepSeek Chat) | Context: 128000
切换自下一个 step 生效：插件向会话写入 model/selection 事件（与 GUI 模型选择器同一机制），Web UI 状态同步。
Plan 模式自动升降级
插件监听 agent/pre-step 的 Plan 投影状态变迁，零人工干预：
- 进入 Plan 模式（
/plan on）：暂存当前日常模型，自动切换到配置的 planModel（高智力规划模型）；
- 退出 Plan 模式（
exit_plan_mode 批准 / /plan off）：自动恢复进入前的日常模型（autoRestorePlanModel，默认开启）；
- 自动切换失败仅 warn 降级，绝不打断 step。
安全护栏
-
Provider 白名单：allowedProviders 非空时，白名单外的切换请求直接拒绝；
-
上下文窗口护栏：当前会话 token 水位超过目标模型 contextWindow 时拒绝切换，并提示先压缩上下文（如 clear_mind）：
Current session token pressure (70000 tokens) exceeds target model context window (65536 tokens).
Please compact context (e.g. clear_mind) before switching to this model.
-
路由校验：候选组合经 DSH 核心 ctx.llm.resolveCallConfig 校验（provider 适配器存在、模型合法、reasoningEffort 受支持），非法组合返回明确错误，不写入任何会话状态；
-
仅根 Agent：工具只注册给根 Agent（subagent 不提供自主调模）；enableAgentTools: false 可整体关闭。
配置
Settings 命名空间 dsh-set-model（Web Settings UI 可视化配置，改动运行时动态生效）：
dsh-set-model:
planModel: # 可选：进入 Plan 模式自动切换的目标模型
provider: deepseek
model: deepseek-reasoner
reasoningEffort: high
autoRestorePlanModel: true # 退出 Plan 模式自动恢复日常模型（默认 true）
enableAgentTools: true # 是否注册 set_model / list_models 工具（默认 true）
allowedProviders: [] # 可选：可切换 Provider 白名单（空 = 不限制）
安装
dsh plugin --profile web add dsh-set-model
安装后无需手动改配置，插件自带的 cordis.patch.yml 自动挂载生效。
从 GitHub 直装（源码安装，pnpm ≥10 需允许构建脚本）：
dsh plugin --profile web add github:john-walks-slow/dsh-set-model
# 首次 add 会被 pnpm 拦截：把 pnpm 提示的包名加入
# ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 后重跑
权限与兼容
- 零直接副作用：无外部服务、无插件自身网络请求（模型路由与能力查询均经由 DSH 核心
llm 服务）、无直接文件系统写入；仅通过会话事件 API 写入 model/selection 事件（由 DSH 会话系统落盘）并注入一行 Runtime Context
- 依赖：
@deepseek-ai/cordis 4.0.2 / @deepseek-ai/dsh-agent、dsh-llm、dsh-session、dsh-tools 0.1.2-rc.1（与 dsh 0.1.2-rc.1 锁定版本对齐）、zod ^3.24.2；Node ≥ 22.5
- 失败降级：Plan 模式自动切换失败只 warn 不打断 step；工具校验失败向 Agent 返回明确错误，不污染会话状态
本地开发
npm install
npm run build # tsc → dist/src
npm test # tsc(含 test) + node --test dist/test/*.test.js
License
MIT
