dsh-thinking-levels-settings

给 DSH Web 的 设置 → 思考级别 新增一页：为自定义 llm-pi-ai 提供商的每个模型配置 thinking levels（推理档位） —— off / minimal / low / medium / high / xhigh / max，通过官方 Settings wire 持久化到 ~/.dsh/settings.yaml（llm-pi-ai.providers.*.models[*].reasoningEfforts）。

官方 client-plugin 形态（DeepSeek Harness 插件系统的自定义插件）。

✨ 功能

按模型配置：为每个模型单独设置推理档位。档位词表从 DSH settings schema 发现（off / minimal / low / medium / high / xhigh / max，DSH 未来新增档位会自动跟随），发现失败时回退内置七个
三种推理模式（对应 reasoningEfforts 的三种合法形态，非法组合无法写出）：
- 继承目录 —— 省略该字段，沿用内置目录对该模型的能力声明
- 非推理 —— 写入 reasoningEfforts: false，模型菜单不提供任何档位
- 启用档位 —— 逐档声明协议值；除 Off 外至少需要一个档位（DSH 硬校验）
输入能力：勾选 text / image。两个都不勾 = 省略该字段，沿用目录；这是对端点的断言而非检查，端点不接受的输入由提供方拒绝
预设档位：DeepSeek / OpenAI / Grok 三套协议的预置映射（按当前可用档位取子集）
双层折叠：提供方分组 + 模型行两级折叠，折叠行仍显示档位摘要与 文/图 徽章；折叠状态记入 localStorage
搜索与筛选：按模型名/ID/提供方搜索；快捷筛选片 全部 / 支持图片，其余筛选（已配置 / 未配置 / 非推理 / 未保存）与 JSON 导出导入一起收进「更多 ▾」菜单，选中后按钮上直接显示筛选名；筛选只展开命中分组，不会自动铺开模型卡片
保存与预览：工具栏一个「保存全部」按钮写入当前所有未保存改动；内部按提供方分组，每个提供方恰好一次整段数组写（set path:["providers",,"models"]），所以不会半成功；展开区实时预览「模型菜单将提供哪些档位」；写入带 expectedRevision，冲突时提示重读而非覆盖
导出 / 导入 JSON：导出当前草稿（含未保存改动）为 JSON，导入只填草稿供确认，导入永远不会直接写 settings.yaml
国际化：接入 DSH 自带 locale 服务（zh / en），跟随设置里的语言偏好； locale 服务缺席时回退内置中文文案，页面不会显示裸 key
持久化：写入 ~/.dsh/settings.yaml，重启后保留
组件化：作为 settings.section 槽位贡献注册，挂在设置页「思考级别」分节

写入策略（为什么是整段替换）

设置项的路径操作不支持数组下标：applyPathOp 会把数组当作非对象，于是 path: ["providers", id, "models", "0", "input"] 会把整个 models 列表降级成 {"0": {...}}，等于摧毁数据。因此本插件每次保存都是：克隆整个 models 数组 → 只改自己负责的条目 → 用一个 set 操作写回整段数组，并带上 expectedRevision。 DSH 在落盘前先校验，revision 不匹配则拒绝而非覆盖。

📦 安装

先安装 pnpm（方式 A / B 的前置要求）

先检查是否已有 pnpm：

pnpm --version

没有 pnpm 时，优先使用 Node.js 自带的 Corepack：

corepack enable
corepack prepare pnpm@latest --activate
pnpm --version

如果系统没有 corepack，可通过 npm 安装：

npm install --global pnpm
pnpm --version

确认 dsh 能在同一环境的 PATH 中找到 pnpm：

command -v pnpm

WSL 用户必须在 WSL 发行版内部执行上述命令；只在 Windows 主机安装 pnpm，不保证 WSL 中的 dsh plugin 能找到它。若无权限全局安装，使用 Corepack，或直接选择方式 C。

方式 A：#master 直装（推荐，最简；需要 dsh CLI + pnpm）

dsh plugin --profile web add -w github:blackteaYES/dsh-thinking-levels-settings#master

-w 要不要加，取决于你的 pnpm 版本——但加上永远没错，所以统一带上：

你的 pnpm	不加 `-w`	加 `-w`
1) {


新条件要求 workspace 里有**多于一条** pattern 才拦截。dsh 写的正好只有一条，所以新 pnpm 不再
报错。**加 `-w` 在两种版本上都是 rc=0**，因此文档统一带 `-w`，你不必先查版本。

注意别把 `-w` 写成 `--workspace`：`-w` / `--workspace-root` 才是"在 workspace 根上执行"，
`--workspace` 的含义是"仅当依赖已存在于 workspace 时才添加"。位置也要对：`add -w `。

`master` 分支由 CI（`.github/workflows/ci.yml`）自动维护为**预构建产物分支**——只含 `lib/`
与包元数据，不含源码、没有 `prepare` 脚本，安装即用：

- **无需本地构建**，pnpm ≥10 也**不再需要 `allowBuilds` 构建授权**
- 合并到 main 后自动更新；之后 `dsh plugin --profile web update` 即升级到最新构建
  （它会重新 `git ls-remote` 查询 `master`，不需要 `-w`）
- 安装过程需要联网访问 GitHub（可选走代理：`HTTPS_PROXY=… dsh plugin …`）

> `github:` 简写与显式 `git+https://github.com/….git` 地址是等价的（pnpm 会归一到同一形态），
> 用哪个都行。注意两者在 HTTPS 不可达时都会回退尝试 SSH（`git@github.com:`），所以网络受限的
> 环境请把代理配好。

> 想锁定确定版本、避免「最新即变」？用方式 B 的 Release tarball（不可变的版本锚点）。

### 方式 B：Release tarball 安装（稳定通道，版本可锁定；需要 dsh CLI + pnpm）

从 **[Releases](https://github.com/blackteaYES/dsh-thinking-levels-settings/releases)** 下载
`dsh-thinking-levels-settings-.tgz`，或直接用直链一步安装：

```sh
dsh plugin --profile web add -w https://github.com/blackteaYES/dsh-thinking-levels-settings/releases/download/v3.0.0/dsh-thinking-levels-settings-3.0.0.tgz

-w 同样统一带上（旧 pnpm ~/.dsh/profiles/web/packages/dsh-thinking-levels-settings/

2) profile package.json 添加依赖: