dsh-task-effort: 根据任务自动调整模型推理强度

前言¶

在 DeepSeek Harness (DSH) 的智能体开发中，模型的 reasoningEffort 参数决定了推理的深度与成本。固定设置一个档位往往不合适：闲聊使用 high 档位会浪费 Token，而复杂任务使用 off 档位则可能导致质量不足。此外，高峰时段的定价策略也需要在成本与质量之间做平衡。

插件定位¶

这是一个 DSH 插件，用于在每次 LLM 调用前，根据当前任务内容自动决定模型的 reasoningEffort（off/low/high/max），并结合高峰时段定价策略进行限档。它由 zhangzhenwen1 维护，定位在「模型推理」分类。

核心功能¶

自动分类与调整：根据任务内容（关键词、消息长度）自动选择 off/low/high/max 档位。
价格感知限档：识别工作日高峰时段（北京时间 09-12/14-18），自动压低 effort 档位以节省成本。
错误自动升级：若本轮工具调用报错，剩余步骤自动强制升级到 max 档位。
手动兜底机制：支持通过 [effort=...] 标记或 GUI 手动控制，优先级高于自动判定。
子代理支持：子代理默认按 max 档位处理，也可设置为 off。

安装与启用¶

使用官方命令安装：

dsh plugin --profile web add dsh-task-effort
# 或从 GitHub 安装
dsh plugin --profile web add github:zhangzhenwen1/dsh-task-effort

安装后重启 dsh web。配置项可通过 profile 的 cordis.patch.yml 覆盖。

判定规则¶

插件在 agent/pre-step 读取消息并分类，在 agent/request 应用配置。判定优先级从高到低：

显式标记：消息包含 [effort=off|high|max]（支持 low/medium 别名，low 映射为 off）。
复杂任务：命中 maxKeywords（如 refactor/design/debug/分析/重构）。
继续指令：命中 continuationKeywords（如 continue/接着/next），沿用上一轮。
闲聊：剥离礼貌前缀（politenessPrefixes）后命中 offKeywords。
长指令：消息长度超过 longThreshold（默认 200）。
短指令：消息长度短于 shortThreshold（默认 4）且无信号，沿用上一轮。
默认：使用 defaultEffort（默认 high）。

配置项¶

以下是主要的配置项说明：

键	默认值	说明
`enabled`	`true`	总开关
`providers`	`["deepseek-official"]`	仅调整这些 provider 的请求
`defaultEffort`	`"high"`	无信号时的默认档位
`maxKeywords`	见源码	复杂任务关键词
`offKeywords`	见源码	闲聊关键词
`politenessPrefixes`	见源码	判定前剥离的礼貌前缀
`continuationKeywords`	见源码	继续类指令
`longThreshold`	`200`	消息长度超过即 max
`shortThreshold`	`4`	短于此且无信号则沿用上一轮
`escalateOnError`	`true`	轮内工具报错后升级到 max
`costAware`	`true`	时段感知：高峰时段自动压档
`peakCap`	`"high"`	高峰时段的 effort 上限
`subagents`	`"auto"`	子代理策略：auto/off
`notify`	`true`	effort 变化时注入说明
`log`	`true`	打印判定日志

手动控制¶

GUI 模型选择器：在界面手动选择模型档位后，插件会暂停自动判定，尊重手动选择。新建会话或重启 dsh web 后自动恢复。
消息标记：在消息中输入 [effort=off] 或 [effort=max]，优先级最高，仅当轮生效。
临时关闭：修改配置 enabled: false 或移除 patch 条目。

界面可见性¶

插件会在会话中注入 <system-reminder> 说明当前 effort 变化原因（包含判定原因、档位、当前时段及倒计时）。
模型选择器旁的胶囊会显示实际生效的档位（Off / Low / High / Max）。
Request/header 事件中会记录实际档位变化。

已知限制¶

判定逻辑基于启发式关键词匹配，可能发生误判。遇到问题时，使用 [effort=...] 标记进行兜底。

总结¶

该插件通过自动适配任务强度和高峰限档，帮助 DSH 用户在控制成本的同时保证推理质量。
完整目录与源码：Catalog URL | GitHub URL