# luxueliu-reasoning-efforts

> 🧠 **DSH里只有ds能选推理强度？20个常用模型推理强度按钮已就位！涵盖grok/Gemini / Kimi/glm……20个模型仅预设，实际槽位无上限！可以任意添加你的本地网关模型！**

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

由 [luxueliu](https://github.com/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；合并前可先手动应用本补丁，DSH 升级后按需重打）。

## 安装

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

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

重启 DSH 后：

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

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

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

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

```powershell
# 方式一：应用随包补丁 + 随包 reapply.py 重打（DSH 升级后一键还原档位）
python reapply.py

# 方式二：直接对 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` 覆盖：

```yaml
- 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