English | 中文

dsh-better-api

增强版「模型设置」页插件（DSH Web GUI）：给自定义模型的每个模型提供推理强度（reasoningEfforts）编辑能力。

官方模型设置页不提供推理强度控件。本插件在官方页面的模型目录编辑器里补上了它：

• 每个模型行的高级区新增 推理强度 复选框组：off / minimal / low / medium / high / xhigh / max
• 勾选的档位写入该模型的 reasoningEfforts（档位按同名值发送；off 特殊处理为"不发送参数"）
• 全部取消勾选即移除声明，模型回退为"不支持推理"，界面不出现自相矛盾的控件
• 手工声明的自定义模型（OpenAI 兼容网关等）从此在聊天模型选择器中显示 Effort 菜单（提供方默认 + 各档位），选中后自动记住为会话默认

基于官方 @deepseek-ai/dsh-client-ui-settings-models（MIT）分支，仅增加上述编辑能力，其余行为与官方一致。

<p align="center"><img src="./assets/preview.png" alt="dsh-better-api 预览图"></p>

功能

• 设置 → 模型 → 任意提供方 → 模型目录 → 展开模型行 → 勾选推理强度
• 新建自定义提供方时同样可用
• 中英文界面文案齐备
• 配置即写即存：保存后写入 settings 文档（如 ~/.dsh/settings.yaml），无需重启

安装

cd ~/.dsh/profiles/web
npm i github:131CDA1/dsh-better-api
# 把仓库根目录的 cordis.patch.yml 合并进本 profile 的 cordis.patch.yml

或直接：

dsh plugin --profile web add github:131CDA1/dsh-better-api

为什么必须禁用官方模型设置页？

本插件与官方插件共用同一个 settings.section#models 槽位，二者同时启用会因重复注册直接报错。 本插件是官方「模型设置页」的增强版替代品，随包补丁会自动禁用官方行 （ui-settings-models / @deepseek-ai/dsh-client-ui-settings-models）； 若手动安装，请先在 GUI 插件管理中禁用该行。

与其他插件是否冲突？

不会与 API 代理/中转/用量类插件冲突。

使用

1. 打开 设置 → 模型，找到你的提供方（如自定义 gpt）并展开其编辑卡片。 2. 在 模型目录 中展开某个模型行（高级区），勾选需要的推理强度。 3. 点击 保存。 4. 回到会话，在模型选择器中选中该模型，即可看到 Effort 菜单并选择档位。

配置参考（settings.yaml）

reasoningEfforts 声明模型可选的思考档位：键是选择器提供的档位，值是该档位在协议中发送的拼写（low: low 原样透传，max: ultra 则为使用自有词汇的网关改名）。键取自档位集合 off / minimal / low / medium / high / xhigh / max；未声明的档位不会被提供。

llm-pi-ai:
  providers:
    gpt:
      apiKeyEnv: GPT_API_KEY
      api: openai-completions
      baseURL: https://api.example.com
      models:
        - id: gpt-5.6-sol
          name: GPT-5.6 Sol
          reasoningEfforts:
            low: low
            medium: medium
            high: high

• off 是唯一的三态键：声明且不给值（off:）时提供 Off，选中后不发送任何参数；给值（off: none）则按该值发送。
• 一旦声明，这份声明就是对外提供的全部档位；要保留的档位需要全部重述。
• 网关使用自有词汇时改值即可（如 max: ultra），界面无需改动。

License

MIT。本插件是 @deepseek-ai/dsh-client-ui-settings-models 的分支，保留上游版权声明。