# dsh-reasoning-options

**GitHub**: [Scorp1o117/dsh-reasoning-options](https://github.com/Scorp1o117/dsh-reasoning-options) · **npm**: [dsh-reasoning-options](https://www.npmjs.com/package/dsh-reasoning-options) · [English](README.md)

给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 **pi-ai 自定义模型（第三方网关）** 自动补上「推理强度」选择器，并**自动注入必需的网关路由 Header**（如 OpenCode Go 的 `x-opencode-session`）。

## 为什么需要它

1. **推理强度选框缺失**：dsh 自带的 DeepSeek 模型在 Web UI 里有推理强度选项（off / low / high / max …），因为 DeepSeek 适配器为模型声明了 reasoning 能力。但通过 `llm-pi-ai` 配置的第三方网关模型（OpenCode Go、GOAT、火山方舟等）**默认没有这个选项**——pi-ai 只给「显式声明了 `reasoningEfforts`」的模型提供档位 UI，手工在 settings.yaml 里声明的模型都不会声明它。
2. **OpenCode Go 网关兼容**：OpenCode Go 网关（`opencode.ai/zen/go/v1`）强制要求请求携带 `x-opencode-session` HTTP Header 用于请求分发与 Prompt Cache。缺少时会直接报错 `400: {"type":"MissingSessionID", ...}`。

本插件一并解决上述问题：扫描 `llm-pi-ai` 命名空间，给**每个没有 `reasoningEfforts` 的模型**写入全七档声明（off / minimal / low / medium / high / xhigh / max），给没设默认档位的 provider 加上 `reasoning: high`，并为 OpenCode Go provider 自动注入缺失的 `x-opencode-session` Header。写入走 dsh 原生 settings 管线（schema 校验 → 落盘 settings.yaml → 热生效）——**用户完全不用手动改文件**。

> 只负责「给用户一个更方便的选择入口」并保证网关连通性。具体选哪档、模型支不支持，由用户自己决定，插件不判断模型适配度。

## 安装

```powershell
dsh plugin --profile web add dsh-reasoning-options
```

或手动在 profile patch 挂载：

```yaml
- insert:
    - id: reasoning-efforts
      name: 'dsh-reasoning-options'
      config:
        enabled: true
```

## 工作原理

1. 启动后读取 `llm-pi-ai` 命名空间的 resolved 配置（pi-ai 插件已注册它）。
2. 对每个 provider 的每个模型：若没有 `reasoningEfforts`，生成对应变更，在精确路径写入全七档声明。
3. 对没设 `reasoning` 默认档的 provider 路由，补 `reasoning: high`。
4. 对 OpenCode Go provider（`baseURL` 包含 `opencode.ai`），若缺少 session header 则自动注入 `headers: { x-opencode-session: 'dsh-session' }`。
5. 所有写入经 pi-ai 自己的 schema 校验后持久化并热提交，dsh 原生 UI/请求链路随即生效。
6. **幂等**：已有档位和已配置 Header 的项目不碰；补完后再扫描是空操作，不会反复写。监听 `settings/updated`，之后新加的模型或提供商也会自动覆盖。

## 配置

| 字段 | 默认 | 含义 |
|---|---|---|
| `enabled` | `true` | 设为 `false` 停止自动处理 |
| `autoSessionHeader` | `true` | 是否自动为 `opencode.ai` 网关注入 `x-opencode-session` |
| `sessionHeaderValue` | `'dsh-session'` | 自动注入的 `x-opencode-session` 默认值 |

> 想改默认档位或 wire 值？补丁写入后它们就在 `settings.yaml` 的 `llm-pi-ai` 段里，可随时手动调整，插件不会覆盖已有声明。

## 注意事项

- 插件**读取并改写 `llm-pi-ai` 命名空间**，但**不拥有**它（pi-ai 独占注册）。所有写入都走公开的 `settings.mutate` API，与在 Web UI 手改等效。
- 档位 wire 值为 OpenAI 兼容风格（`low`/`medium`/`high`/…）。绝大多数 OpenAI 兼容网关接受；个别网关若只认自己的写法，可在 settings.yaml 里把对应模型的档位值改成它的写法。