前言¶
在 DeepSeek Harness (DSH) 的开发流程中,经常需要在智能体任务执行中途介入,提供新的指导或修正方向。直接在对话流中追加消息往往容易打断正在进行的工具调用,或者破坏上下文的连贯性。dsh-user-steer 插件旨在解决这一痛点,它允许在任务运行中给 agent 一句指导,消息在工具批次边界注入当前 turn,绝不打断正在执行的工具调用。
插件简介¶
这是一个 DeepSeek Harness 用户中途指导(mid-turn steering)插件,由开发者 wht567 维护,遵循 MIT 许可证。它为 DSH 提供了在智能体运行过程中进行安全、无干扰中途指导的能力。
核心功能¶
插件提供了多种指导注入方式,满足不同场景的需求:
-
/steer <指导>—— 醒目插话
输入该命令后,指导会以 steering 气泡的形态进入对话,视觉上非常醒目,适合需要立即引起注意的修正。 -
/inject <指导>—— 静默注入
指导会静默地被模型读取。在对话流中,它仅显示为一行紧凑的上下文提示,不打扰正常的对话阅读体验。 -
注入条
在 composer 输入框上方,始终可见一个与输入框等宽的注入条。支持一键静默注入,方便重复使用。 -
模型侧提示词
插件会在系统提示词中新增 mid-turn steering 章节,明确告诉模型“中途到达的消息是对当前任务的航向修正”,确保模型能正确理解指令意图。
安装与启用¶
通过命令行安装插件,安装后需重启 DSH 生效:
# 通过插件市场安装(推荐)
dsh plugin --profile web add github:wht567/dsh-user-steer
# 或使用本地路径安装
dsh plugin --profile web add file:/path/to/dsh-user-steer
工作机制¶
插件内部通过 Agent.steer() 方法将消息推入 inbox 的 next-step 队列。这确保了指令不会立即打断当前进程,而是在下一个 step 边界被认领为真实的 user/message 事件。这种设计保证了不杀工具、不破坏角色交替,同时保持 prompt 前缀缓存完好。
典型用法¶
在对话中直接使用以下命令:
/steer 把重点放在生成报告的格式上
/inject 请忽略之前的错误数据,重新计算
适用场景与注意¶
该插件适合需要在智能体执行过程中实时调整方向、进行中途纠偏的开发者。使用时需注意,插件以当前 DSH 进程的权限运行,建议在安装前检查源码与许可证。
总结¶
dsh-user-steer 让开发者能够在不中断任务流程的前提下,精准地对智能体进行中途指导。更多细节请查看 插件目录 或 GitHub 仓库。