zhangzhenwen1/dsh-task-effort

DSH 插件：每次 LLM 调用前，根据当前任务自动决定模型的推理强度 reasoningEffort（DeepSeek 支持 off / high / max），不再全局固定一个档位。

工作原理

DSH 的 agent 循环在每次模型调用前会走 agent/request waterfall（dsh-agent-loop 的 buildRequest），插件在瀑布的最外层改写 reasoningEffort，因此最终生效， 优先级高于模型选择器/设置里的默认 effort。

判定时机：agent/pre-step（每步执行前）读取本轮最新用户消息并分类，判定结果 缓存到当轮结束；agent/request 时应用到请求配置。中途转向（steer / 追加消息） 会触发重新判定。

判定规则（优先级从高到低）

1. 显式标记：消息里带 [effort=off|high|max]（也支持 【effort:…】、 {effort:…}、effort=…；low→off，medium→high）→ 直接采用
2. 复杂任务关键词（maxKeywords：重构/架构/分析/refactor/design/debug…）→ max
3. 继续类指令（continuationKeywords：继续/接着/next/continue…）→ 沿用上一轮
4. 闲聊（offKeywords，先剥离 politenessPrefixes 如“好的/收到”）→ off
5. 长指令（≥ longThreshold 字符）→ max
6. 过短无信号（≤ shortThreshold 字符）→ 沿用上一轮
7. 默认（defaultEffort）→ high

额外机制：

• 轮内出错自动升级（escalateOnError）：本轮工具调用报错后，剩余步骤强制 max
• 子代理（subagents: "auto"）：子代理按自己的提示词（委托指令）判定， 通常较长 → max；可设 "off" 完全不干预
• 能力收敛：只会把 effort 设置到目标 provider+model 实际支持的档位 （查 ctx.llm.resolveModelInfo 并缓存），不会把 max 强加给不支持推理的模型 （如 qwen 视觉子代理）
• 变化通知（notify）：effort 相对上一轮变化时，向模型注入一行 <system-reminder> 说明，便于观察与调试

安装

方式一：npm / GitHub 包（推荐）

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 覆盖配置。

方式二：本地 patch（开发用）

在 ~/.dsh/profiles/web/cordis.patch.yml 的 insert 列表追加：

    - id: task-effort
      name: 'file:///home/zhang/文档/DSH/plugins/task-effort/index.js'
      config:
        providers:
          - deepseek-official
        defaultEffort: high

保存后 user patch 层热更新；若未生效，重启 dsh web。

配置项

键	默认	说明
enabled	true	总开关
providers	["deepseek-official"]	只调整这些 provider 的请求
defaultEffort	"high"	无信号时的默认档位
maxKeywords	见源码	复杂任务关键词（命中→max）
offKeywords	见源码	闲聊关键词（命中→off）
politenessPrefixes	见源码	判定前剥离的礼貌前缀
continuationKeywords	见源码	继续类指令（沿用上一轮）
longThreshold	200	消息长度超过即 max
shortThreshold	4	短于此且无信号则沿用上一轮
escalateOnError	true	轮内工具报错后升级到 max
costAware	true	时段感知：高峰时段（北京时间工作日 09-12/14-18）价格更高，自动压档省钱
peakCap	"high"	高峰时段的 effort 上限（max 被压到该档；可设 "low"/"off"，null 关闭限档）
periodOverride	null	测试用：强制时段 "peak" / "offpeak"（演示限档效果）
subagents	"auto"	子代理策略：auto / off
notify	true	effort 变化时注入说明（含时段与距下一时段倒计时）
log	true	打印判定日志（task-effort: agent=… effort=… reason=…）

手动控制

• GUI 模型选择器：你在界面里手动选过档位后，插件检测到选择偏离会自动尊重手动选择并暂停自动判定（界面显示的档位 = 实际请求档位，完全一致）。
• 恢复自动模式：手动选择记录在运行进程内（Web 的 selectModel 状态），新建会话或重启 dsh web 后自动恢复。注：DeepSeek 模型有默认档位（如 high），所以选择器菜单里没有 "Provider default" 选项。
• 单条消息指定档位：[effort=off]、[effort=max] 等（优先级最高，仅当轮生效；手动模式下同样生效）
• 临时关闭：把配置里 enabled 改为 false，或移除 patch 条目

界面可见性

• 每次 effort 切换，会话里会注入一行 <system-reminder> 说明（判定原因 + 档位 + 当前时段 + 距下一时段倒计时）
• 插件应用档位后会自动通知界面刷新（llm/adapters-updated → 模型选择器重新拉取）， 输入框旁的模型胶囊会显示实际生效的档位（Off / Low / High / Max）
• 会话轨迹（request/header 事件）记录每次实际档位变化

已知限制

• 判定是启发式的，误判时用 [effort=…] 标记兜底，并欢迎调整关键词表。