前言¶

在 DeepSeek Harness (DSH) 环境中开发智能体时，对输入流的控制直接影响工作流的效率。默认的输入行为（例如在会话繁忙时按 Enter）往往无法满足精细化编排的需求。dsh-steer-button 插件通过覆盖运行会话的输入行为，提供更直观的队列管理方式。

这是什么¶

dsh-steer-button 是一个 DeepSeek Harness 插件，由开发者 lyuwen 维护。它解决了在智能体运行期间，Composer 输入框缺乏明确队列控制的问题。插件通过三种交付模式，让开发者能够清晰地管理消息的发送时机和上下文关系。

核心功能¶

插件主要提供以下功能：

1. 三种交付模式

   • Queue 模式：按下 Enter 键，消息进入队列。该消息将在当前步骤完成并提交观察结果后，与观察结果一同在下一轮 LLM 请求中发送。当前步骤不会被中断。
   • Steer 模式：按下 Cmd/Ctrl + Enter，中止当前正在进行的 LLM 流式输出，保留部分输出作为中断的消息，随后用新请求继续对话。
   • Backlog 模式：按下 Cmd/Ctrl + Shift + Enter，使用 DSH 原生的整轮队列模式。消息会等待当前整轮对话结束后，作为独立的下一轮运行。

2. 队列可视化与交互

   • 队列条带：所有待处理的消息会显示在文本框上方的队列条带中。
   • 编辑与撤销：编辑按钮将文本移回文本框进行自由编辑；向上箭头 (↑) 可将最近一条已排队消息拉回文本框。
   • 停止操作：按下 Esc 键，停止当前运行的智能体，并取消待处理队列，将已提取的消息作为转向提示重新提交。

3. 状态控制

   • 按钮在智能体空闲、空白会话或已删除会话时自动隐藏。
   • Esc 仅对当前可见会话生效，且仅在该会话运行时响应。

安装与启用¶

插件依赖特定的 DSH 版本和 React 环境。

依赖要求：
* DeepSeek Harness 版本：0.1.5-rc.1 或 0.1.5-rc.2
* React：18.2.0 或更高版本
* @deepseek-ai/cordis：^4.0.1

注意事项：
* 安装或更新包后，必须重启配置文件（Profile），页面刷新无法生效。
* 插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证（MIT）。

典型用法¶

1. 排队发送：在智能体思考过程中，输入文本并按 Enter，文本会进入队列，等待当前步骤结束。
2. 中途转向：输入指令并按 Cmd/Ctrl + Enter，强制中断当前思考，立即应用新指令。
3. 整轮发送：输入文本并按 Cmd/Ctrl + Shift + Enter，将消息放入原生回溯队列。
4. 停止并处理：按 Esc 停止运行，将待处理队列中的消息提取出来作为新的转向提示。
5. 修改草稿：在文本框按 ↑，将最近一条排队消息拉回编辑。

适用场景¶

适合需要在智能体运行期间动态调整输入流、需要精细控制上下文注入时机（例如在观察结果之后注入）的开发者。对于习惯使用原生回溯队列但希望拥有更直观编辑界面的场景也适用。

短结尾¶

dsh-steer-button 通过重写输入行为，将 Queue、Steer 和 Backlog 三种模式标准化。对于需要精细管理智能体输入流的开发者，这是一个实用的工具。

• GitHub: https://github.com/lyuwen/dsh-steer-button
• 目录: https://www.skillhub.cn/plugins/lyuwen/dsh-steer-button