luxueliu-reasoning-efforts

💡 Gemini / Grok / Kimi 在 DSH 里「不会思考」？预置 20 个示例档位，槽位无上限，你的模型随加随用

DeepSeek Harness 插件：让本地 LLM 网关路由上除 ds 系以外的任何模型，也能在 DSH 里显示推理强度（reasoning effort）选择器，并在 DSH 升级后一键重打档位。

由 luxueliu 制作并开源（MIT）。

这是什么

DSH 的模型选择器只在模型被声明为「可推理」时才会显示推理强度档位。走本地 LiteLLM 网关的手工声明模型（fable5 / opus5 / gemini3.x / grok / kimi-* / glm5.x 等）默认没有这个能力——于是它们既不显示档位选择器，也无法从对话里切换思考强度。这个问题官方长期未修，本插件就是它的补丁 + 档位真理源。

本插件提供三层能力：

1. 档位真理源 efforts.json：预置 20 个示例网关别名的 reasoningEfforts 档位表（off/low/medium/high/xhigh/max，按各模型真实支持的档位声明）——这只是示例，槽位无上限：网关里有什么模型就加什么，想加几个加几个。
2. 检查 / 重打命令 /efforts：对比 live ~/.dsh/settings.yaml 与金样档位表，检查漂移、一键重打（自动备份），DSH 升级或界面回写 settings 后档位漂了随时拉回来。
3. 路由级源码补丁 upstream.patch：给 llm-pi-ai 增加「路由级 reasoningEfforts 默认值」——整条网关声明一次档位表，所有未单独声明的手工模型继承（PR 分支已推送：luxueliu/deepseek-harness 的 feat/pi-ai-route-reasoning-efforts；上游 org 的 API 限制需在网页手动建 PR，合并前可先手动应用本补丁）。

安装

要求：Node.js 22.18+ 与一个 DeepSeek Harness Web profile。

dsh plugin --profile web add github:luxueliu/luxueliu-reasoning-efforts

重启 DSH 后：

/efforts        # 检查档位是否漂移
/efforts apply  # 把金样档位写回 live settings（先留 settings.yaml.bak-reapply-*）

源码补丁（可选，二选一）

路由级默认值是「网关档位表写一次」的便利特性；若只想让预置的 20 个示例别名显示档位，装完插件 /efforts apply 即可（模型级声明）。

要用路由级能力（或等官方合入前先体验）：

# 方式一：应用随包补丁（D:\DSH 已内置 reapply 脚本时走官方脚本）
powershell -NoProfile -ExecutionPolicy Bypass -File D:\DSH\reapply-after-dsh-upgrade.ps1

# 方式二：直接对 DSH 源码应用 upstream.patch（在仓库根执行）
git apply upstream.patch

命令

/efforts          # 检查 live settings.yaml 与 efforts.json 是否一致
/efforts apply    # 有漂移则重打（自动备份 settings.yaml.bak-reapply-*）

配置

插件的 cordis.patch.yml 已带默认配置，可在 profile 的 cordis.patch.yml 覆盖：

- insert:
    - id: luxueliu-reasoning-efforts
      name: luxueliu-reasoning-efforts
      config:
        settingsPath: ""        # live settings.yaml；留空自动探测 ~/.dsh/settings.yaml
        checkOnStart: true      # 启动时检查档位漂移并提示
        applyOnStart: false     # 启动时自动重打（默认关，先 check）
        effortsFile: "efforts.json"

文件说明

文件	用途
efforts.json	预置 20 个示例模型的 reasoningEfforts 档位真理源（槽位无上限，可任意添加）
settings.yaml.gold	完整 settings 快照（含默认模型，整份覆盖用，慎用）
litellm-config.yaml.gold	网关配置快照（含 allowed_openai_params: reasoning_effort）
reapply.py	独立重打脚本（只写档位，不动默认模型；--check 只查）
restore-settings-gold.ps1	整份 settings 回滚到金样（会覆盖默认模型，慎用）
upstream.patch	llm-pi-ai 路由级 reasoningEfforts 源码补丁
lib/index.js	/efforts 命令实现（检查 + 重打，文本级替换保 off: 拼写）

License

MIT © luxueliu