思考强度配置xiaohui5206/DSH-ReasoningEffort-Fix

针对DSH：添加第三方API时无法调节思考强度问题（DeepSeek Harness小完善计划其二）

DSH（DeepSeek Harness）第三方模型思考等级配置技能（Agent Skills 标准格式）。

An Agent Skill (standard Agent Skills format) for configuring reasoning effort on third-party models in DSH (DeepSeek Harness).

中文文档 · English

中文文档

技能标识：02-reasoning-efforts ｜ 系列：DeepSeek Harness 小完善计划（其一：上下文窗口 · 其三：视觉能力解禁）

这是什么

一个符合 Agent Skills 标准（SKILL.md + YAML frontmatter + references/ 渐进披露）的独立技能仓库。它告诉 AI：如何让手工接入 DSH 的第三方模型支持思考/推理——关键是 reasoningEfforts（声明档位）与 reasoning（路由默认档）两个字段缺一不可。

项目目的

DSH 0.1.0-rc.7 手工接入第三方模型（官方直连或中转站）时有两个缺陷：模型会话没有思考等级选择器，且思考被默认关闭（请求按非推理模型发送，不产生思考内容）。根因是手工模型条目缺少 reasoningEfforts 声明，在配置解析时被判为非推理模型。

本仓库是一个 Agent Skill——给 AI 看的“维修手册”，不是可执行软件。AI 加载 SKILL.md 后，即可按规程自行定位 settings.yaml、核实配置、补全 reasoningEfforts + reasoning 两个字段，并指导你验证修复效果。

症状速查

遇到以下任一现象，即命中本技能解决的问题：

- 给第三方模型发消息，回复里没有思考内容；
- UI 里没有思考等级选择器；
- 请求报错 UNSUPPORTED_REASONING_EFFORT；
- 想让第三方模型默认 high 档（或按需开放 low / medium / max 等档位）；
- 选 max 档发现和 high 没区别——那是预算式路径的收敛（xhigh/max→high）；真 max 需换目录自适应模型（如 kimi-coding 的 k3），手工路由开不了自适应。

仓库结构

02-reasoning-efforts/
├── SKILL.md                # 技能入口（AI 读这个）
├── README.md               # 仓库说明（人读这个）
├── AGENTS.md               # 维护守则（给维护本仓库的 AI 看）
└── references/
├── deep-dive.md        # 闸门源码、预算机制、协议差异、排障表
└── examples.yaml       # 完整配置示例（含 thinkingBudgets、多协议）

使用方法

1. 安装：把本目录整体放入所用 AI 的 skills 目录（各 AI 的技能目录位置不同，以其官方文档为准）。
2. 触发：对 AI 描述症状或贴报错即可，例如：
- “模型回复没有思考内容” / “界面上没有思考等级选择器”；
- “选思考档后请求报错 UNSUPPORTED_REASONING_EFFORT”；
- “想让这个模型默认用 high 档思考”。
3. AI 会做什么：定位 settings.yaml → 查证现有配置 → 补写 reasoningEfforts（档位声明）与 reasoning（路由默认档）→ 提示你如何验证（选择器出现、思考内容产生）。
4. 需要你配合：
- settings.yaml 在工作区外，AI 写入时会请求提升权限，请审批；
- 修改期间尽量关闭 DSH 界面——界面打开时配置可能被并发重写；
- 改完自行备份：通过界面修改供应商设置会重写整个配置段，手工字段（含这两个字段）可能被静默抹掉，丢了让 AI 按本技能补回。

版本基线

内容基于 DSH 0.1.0-rc.7 + @earendil-works/pi-ai 0.82.1（2026-08 实战验证）。DSH 升级后字段名可能变化，请按 references/deep-dive.md 的源码定位入口重新核实并更新 frontmatter 的 metadata.baseline。

许可

文档类内容。发布到 GitHub 前建议添加 LICENSE（如 CC BY 4.0）。

English

Skill ID: 02-reasoning-efforts | Series: DeepSeek Harness Improvement Plan (Part 1: Context Window · Part 3: Vision Input Unlock)

What This Is

A standalone skill repository in the standard Agent Skills layout (SKILL.md + YAML frontmatter + references/ for progressive disclosure). It tells the AI how to enable thinking/reasoning for third-party models hand-declared in DSH — the key is that reasoningEfforts (declares the levels) and reasoning (route-level default) must both be present.

Project Purpose
当第三方模型（直连 API 或中转网关）在 DSH 0.1.0-rc.7 中被手动声明时，会出现两个缺陷：对话没有推理强度选择器，并且思考默认关闭（请求以非推理模型发送，因此不会产生思考内容）。根本原因：在配置解析期间，一个没有 reasoningEfforts 的手动声明模型条目会被判定为非推理模型。

本仓库是一个 Agent Skill——一份给 AI 的“修复手册”，而非可执行软件。加载 SKILL.md 后，AI 可以按照流程定位 settings.yaml、检查配置、填写 reasoningEfforts + reasoning 这两个字段，并引导你验证修复。

症状

当你遇到以下任一情况时，本技能适用：

- 你向第三方模型发消息，回复中没有思考内容；
- UI 中没有推理强度选择器；
- 请求失败并报 UNSUPPORTED_REASONING_EFFORT；
- 你希望模型默认以高强度思考（或开启更多级别，如 low / medium / max）；
- max 的表现与 high 完全一样——这是基于预算的路径将 xhigh/max 钳制为 high；真正的 max 需要目录中的自适应模型（例如 kimi-coding 的 k3），而手动声明的路由无法选择启用自适应思考。

仓库结构

02-reasoning-efforts/
├── SKILL.md                # 技能入口点（AI 读取此文件）
├── README.md               # 仓库概览（面向人类）
├── AGENTS.md               # 维护规则（面向维护本仓库的 AI）
└── references/
├── deep-dive.md        # 门控源代码、预算机制、协议差异、故障排查
└── examples.yaml       # 完整配置示例（thinkingBudgets、多种协议）

用法

1. 安装：将整个目录放入你的 AI 的技能目录（位置因 AI 而异；请遵循其官方文档）。
2. 触发：只需描述症状或粘贴错误，例如：
- “模型的回复没有思考内容” / “UI 中没有推理强度选择器”；
- “我选择思考级别后，请求失败并报 UNSUPPORTED_REASONING_EFFORT”；
- “我希望这个模型默认以高强度思考”。
3. AI 会做什么：定位 settings.yaml → 检查当前配置 → 添加 reasoningEfforts（级别声明）和 reasoning（路由级默认值）→ 告诉你如何验证（选择器出现、思考内容显示）。
4. 你需要做什么：
- settings.yaml 位于工作区之外；当 AI 写入该文件时，请批准提权权限提示；
- 编辑时保持 DSH UI 关闭——打开的 UI 可能会并发重写配置；
- 修复后备份：通过 UI 更改提供商设置会重写整个配置段，并可能静默丢弃手动添加的字段（包括这两个字段）；如果丢失，请让 AI 重新应用本技能。

版本基线
内容已对照 DSH 0.1.0-rc.7 + @earendil-works/pi-ai 0.82.1 进行验证（现场验证于 2026-08）。字段名称可能随 DSH 的演进发生变化；请通过 references/deep-dive.md 中的源代码入口点重新验证，并更新 frontmatter 中的 metadata.baseline。

许可证

文档内容。建议在发布到 GitHub 之前添加 LICENSE（例如 CC BY 4.0）。