前言¶
在基于 DeepSeek Harness (DSH) 构建的多步智能体任务中，模型通常会在每次工具调用前进行“重新思考”。这种机制在复杂任务中能提升准确率，但也会显著增加时间成本（例如，一个包含 50 步的工具调用任务，可能因中间的推理过程而花费数分钟）。本插件旨在精细控制这一过程，在保证复杂任务性能的同时，避免在简单任务上浪费算力。
插件简介¶
该插件是 DeepSeek Harness (DSH) 的一个扩展，由开发者 drscrewdriver 维护。它主要用于控制模型请求中的 reasoning_effort 参数，支持根据历史记录自动调度推理强度，也允许手动固定某一强度等级。
核心功能¶
插件提供了以下主要能力：
- 每轮推理强度控制：可针对单轮对话调整模型的推理努力程度。
- 自动调度模式：在会话模型选择器中选择
Auto后，插件会根据最近的工具调用历史，自动调度low、high或max的推理强度。 - 手动锁定模式：支持手动固定推理强度，包括
off、on、minimal、low、medium、high、xhigh和max。 - 版本依赖：插件依赖于 DSH 环境版本
>= 0.1.7-rc.1 < 0.1.8。
使用方法¶
在 DSH 的会话模型选择器中，可以通过以下方式配置：
-
自动调度：
在模型选择器中选择Auto。此时插件会作为一个“掩码”介入，根据历史记录解析并决定每一步使用low、high还是max，避免简单任务变得昂贵，同时保证繁重任务不因资源不足而中断。 -
手动指定：
手动选择具体的等级。例如，选择high可以直接发送官方默认的推理努力值。
支持的推理等级说明：
* off：关闭思考（手动模式，不会被自动选中）。
* on：启用思考（仅适用于仅切换模型的场景，用于发送 enable_thinking 标志，不发送 reasoning_effort）。
* minimal：最低努力（适合轻量级任务）。
* low：低努力（适合简单聊天任务）。
* medium：中等努力。
* high：高努力（官方默认值）。
* xhigh：超高努力。
* max：最大努力（用于重负载工作）。
注意事项¶
- 依赖变更：自 v0.7.0-beta.1 (2026-09-06) 起，插件不再依赖
dsh-llm-openai-completions适配器，转而使用官方的llm-pi-ai兼容层。若使用旧版 DSH (0.1.2–0.1.6)，需使用插件 3.0.2 版本。 - 语言支持：日语 (
ja) 和韩语 (ko) 在标准 DSH 环境下不可用。这些语言需要使用自定义的 DSH Fork（更新locale-settings.ts和client/index.ts并重建），或者等待官方支持。 - 等级区分：
on仅用于启用思考开关，并非推理强度等级。对于具备推理能力的模型，不应选择on。
总结¶
该插件通过精细化管理 reasoning_effort，让 DSH 智能体的执行过程更加经济高效。适合需要在保证复杂任务推理质量的同时，优化资源消耗的开发者使用。
