前言¶
智能体正在生成或执行动作时,用户如果还有新输入,常见选择往往只有两个:打断当前轮次,或者排队到最后。
drscrewdriver/dsh-input-traffic 把这一段做成三档规划:红色 now 打断、黄色 next 下一轮插入、绿色 later 排队,并允许在排队过程中继续编辑、排序、打回、取消清空和冻结会话。
它是 DeepSeek Harness(DSH)Web GUI 的客户端插件,由 drscrewdriver 维护,MIT 许可,当前版本 0.2.9,状态为 public beta。资料说明它作为 cordis 客户端插件装配,无需修改 dsh 源码、无需提 PR。
插件定位¶
下面先交代这个插件的基本信息。
- 名称:
drscrewdriver/dsh-input-traffic - 一句话定位:DSH Web GUI 的忙碌时输入队列插件
- 核心能力:三档
now/next/later规划、队列编辑与拖拽排序、插话/打断、确认清空、会话冻结 - 维护者:
drscrewdriver - 类别:客户端
- 版本:
0.2.9 - 许可:MIT
- 状态:
public beta - 目录页:
https://dshfind.com/zh/plugins/drscrewdriver/dsh-input-traffic?ref=badge - GitHub:
https://github.com/drscrewdriver/dsh-input-traffic
核心功能¶
三档输入规划¶
智能体忙碌时,输入不再只有“打断”或“排队”二选一。插件提供三档规划:
1、红色 now:打断当前轮次并立即输入。
2、黄色 next:在当前动作结束后插入。
3、绿色 later:等待整轮完成后处理,属于排队状态。
如果某条消息已经使用黄色插话,点击绿色可以撤销插入,并收回排队状态。
队列编辑与排序¶
排队消息不是只能等待。资料列出的队列操作包括:
1、上移。
2、下移。
3、拖拽排序。
4、删除。
5、直接编辑。
6、打回输入框再编辑。
7、队列级取消并清空。
其中,“取消并清空”需要两步确认,用于停止当前执行并清空全部排队消息。
排序过程有并发保护:如果某条消息已经被 agent 认领,本次排序会中止且不重发,提示为「队列已变化,本次排序已取消」。
会话冻结与恢复¶
插件提供会话冻结和恢复按钮。
冻结时,当前轮次自然完成后暂停,不会打断当前执行。恢复时,会按修改后的队列顺序和每条消息预定的档位继续执行。
冻结期间队列仍然可见,并且可以排序、编辑、删除、设定档位。
冻结状态与队列按 sessionId 隔离,多会话并行时互不影响。
插件通过 sessionGuard 桥实现会话级锁定;如果未安装 session-guard,该桥会静默。资料中还区分了作用域:本插件冻结按钮是会话级,session-guard 自动高峰门是全局。
设置行为与界面适配¶
插件生效时,会接管官方设置面板中的「繁忙时 Enter 键行为」。此时该设置行不再显示,Enter 行为固定为绿色排队。
界面会跟随系统深色模式或 dsh 暗色主题自动适配。
安装与装配¶
当前资料没有给出完整官方安装命令,因此这里不拼接安装命令。
已核实的资料只说明:该插件通过 dsh plugin 命令组装,并通过 bundle patch 装配;它作为 cordis 客户端插件使用,无需修改 dsh 源码、无需提 PR。
安装前建议先检查仓库、源代码和许可证。插件会以当前 dsh 进程权限运行,执行前确认来源和依赖是必要的。
已核实的 package.json 中 dsh 配置如下:
{
"bundle": {
"patch": "./cordis.patch.yml"
},
"client": {
"inject": [
"@deepseek-ai/dsh-client-locale",
"@deepseek-ai/dsh-client-ui-conversation"
],
"platform": "web"
}
}
上述配置说明插件依赖 ./cordis.patch.yml 的 bundle patch,并向 @deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-conversation 注入客户端能力,平台为 web。
package.json 还声明 Node >=20,并包含 @deepseek-ai/cordis ^4.0.1 等 peerDependencies。部分 peerDependencies 因资料截断不完整,安装时应以仓库完整清单为准。
典型用法¶
下面按资料中的示例整理。
1、智能体忙碌时选择档位:红色 now 打断当前轮次并立即输入;黄色 next 在当前动作结束后插入;绿色 later 等待整轮完成后处理。
2、已用黄色插话的消息,点击绿色可撤销插入并收回排队状态。
3、在排队等待区使用上移/下移或拖拽调整顺序;点击「打回」将消息回填到输入框重新编辑;也可编辑或删除。
4、点击「取消并清空」并二次确认,停止当前执行并清空全部排队消息。
5、进入 DeepSeek 高峰收费时段前点击「冻结会话」,当前轮次自然完成后暂停;退峰后点击「恢复会话」按队列档位继续。
6、多会话并行时,冻结一个会话不影响其他会话。
7、排序期间若消息被 agent 认领,会提示「队列已变化,本次排序已取消」且不重发。
8、含图片等非文本内容的排队消息在冻结释放后无法重发,会随队列释放。
9、建议配合 dsh-notify 提醒冻结/恢复,并用 dsh-deepseek-usage、dsh-cost-tracker 或 dsh-billing-balance 核对花费。这些属于建议搭配,不是本插件内置能力。
适用场景与注意¶
适合以下使用场景:
- 需要在智能体忙碌时管理新输入顺序。
- 需要把多条待发送消息排队、编辑、排序或打回重新编辑。
- 需要区分立即打断、下一轮插入和整轮后排队。
- 需要多会话并行,并单独冻结某个会话。
- 希望在 DeepSeek 高峰收费时段前暂停当前会话,退峰后再恢复。
使用前需要注意:
- 当前版本为
public beta,版本0.2.9。 - 当前官方 DSH 的
LocaleRuntime只注册zh/en;插件v0.2.9包含ja/ko字典,但在原版 DSH 中选择ja/ko会提示 locale 未注册。 - 如需使用
ja/ko,需要官方 DSH 增加对应 locale ID,或维护 DSH fork 更新LOCALE_IDS、LOCALES、核心字典和测试。 - 含非文本内容,例如图片的排队消息无法重发,冻结时会随队列释放且不会恢复。
sessionGuard桥未安装时会静默。- 插件生效时,官方设置面板的「繁忙时 Enter 键行为」设置行不再显示,Enter 行为固定为绿色排队。
- 提醒与计费统计插件只是建议搭配,不是本插件内置能力。
- 插件以当前
dsh进程权限运行,安装前应检查源码与许可证。
相关链接¶
- GitHub:
https://github.com/drscrewdriver/dsh-input-traffic - 目录页:
https://dshfind.com/zh/plugins/drscrewdriver/dsh-input-traffic?ref=badge