Skip to main content

dsh-queue-plus

17Stars0Forks1Issues0Watchers

Enhances the message queue panel with editing, deletion, insertion, reordering, and batch removal capabilities for queued messages.

Categories▣ UI Enhancements
Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
starslittlestarslittle
·starslittle/dsh-queue-plus
Language
TypeScript
License
MIT
Branch
main
deepseekdeepseek-harnessdsh-pluginprompt-queue

Install

cmdweb profile
$ dsh plugin --profile web add dsh-queue-plus

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin starslittle/dsh-queue-plus for me: review the repository at https://github.com/starslittle/dsh-queue-plus first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

一句话定位

DSH 官方排队面板的增强替换：在不修改宿主行为的前提下，给排队中的消息加上编辑、删除、插话、拖拽排序和批量清理能力。

核心能力

  • 编辑或删除任意排队中的消息（未开始执行前）
  • 在 Agent 运行中把排队消息插话发送（steer）
  • 拖动消息或使用上下箭头调整排队执行顺序
  • 一键批量删除队列中所有消息，确认后逐条走官方接口
  • 新排队消息自动展开面板，并记住手动收起状态
  • 通过 DSH 官方插槽接管排队面板，禁用后官方面板自动恢复

技术实现

  • 语言: TypeScript + React 18
  • 关键依赖: @deepseek-ai/cordis、@deepseek-ai/dsh-agent、@deepseek-ai/dsh-client-runtime、react
  • 架构模式: 双端 Cordis 插件。Host 端在 src/index.ts 注册 POST /queue-plus HTTP 路由处理排序请求；Client 端在 src/client/index.ts 通过 conversation.input.dock 插槽以低优先级 id: 'queue' 接管官方 QueueDock，卸载后插槽自动让位。
  • 入口文件: src/index.ts（Host）/ src/client/index.ts（Client）/ cordis.patch.yml（bundle 注入）

适用场景

使用 DSH Web 客户端、希望在 Agent 还在跑的时候管理已排队但还没开始执行的消息的用户，比如临时调整顺序、修改措辞、撤掉不想发的提示，或者一次清掉误操作产生的一堆排队消息。

前置依赖与兼容性

依赖最低版本说明
DSH（@deepseek-ai/*）0.1.0-rc.6基于 RC 阶段的 Agent Inbox 与 Web 插件契约
Cordis^4.0.1插件运行时框架
Node>=22.19.0（含 24.x）package.json engines 声明
平台跨平台未限制 os/cpu
原生模块无无 node-gyp / 原生扩展依赖

安装方式

dsh plugin --profile web add github:starslittle/dsh-queue-plus

配置项

本插件无需额外配置。安装、重启 dsh web 后，连续排队两条消息即可在队列标题旁看到"排序"按钮，确认生效。

常见问题

Q: 安装后需要额外配置吗？

A: 不需要。安装、重启 dsh web 即可生效。连续排队两条消息后，队列标题旁会出现"排序"按钮作为生效标志。

Q: 卸载插件后官方排队面板还在吗？

A: 在。插件通过 DSH 官方插槽接管排队面板，并未隐藏或复制排队消息；禁用或卸载后官方 QueueDock 会自动恢复。

Q: 排序时其他人也在改队列会乱吗？

A: 不会。排序请求带浏览器侧订单快照，服务端做 compare-and-swap 校验；若队列已经被别人改动，本次排序会被拒绝并提示重试。

Q: 一键全部删除会误删后面新加的消息吗？

A: 不会。批量删除只处理确认时可见的消息列表；若中途有消息被 Agent 领走，会跳过并最终提示部分完成。

Q: 这个插件管理所有排队队列吗？

A: 不管。它只管理普通会话的"排队发送"队列；steering/context 队列和父 Agent 拥有的 subagent 队列不在管理范围内。

Q: 支持哪些平台和 Node 版本？

A: 跨平台，不挑操作系统。Node 需要 22.19.0 及以上或 24.0.0 及以上，DSH 客户端版本需 0.1.0-rc.6 及以上。

上手难度

入门 — 安装一行命令、无需配置、卸载即恢复官方面板，会用 DSH 排队发送就能直接用。

已知问题与限制

  • 不支持父 Agent 拥有的 subagent 队列（src/service.ts:80-84），操作会返回 SUBAGENT_UNSUPPORTED
  • 不管理 steering/context 队列，作用域仅限普通 next-turn 排队
  • 排序目标位置若超出当前队列长度，请求会被拒（INVALID_TARGET）
  • 批量删除基于"点击确认时"的快照；并发变化时只会部分完成，不会误删后续新加的消息
  • 若排队消息的 text 字段为 null（例如纯附件消息），编辑按钮会被禁用（QueuePlusDock.tsx:499-507）
  • 排序请求体超过 16 KB、expectedOrder 数组超过 200 项会被服务端拒绝（src/index.ts:43 / src/shared.ts:5）

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/starslittle/dsh-queue-plus)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory