前言¶
在 DeepSeek Harness (DSH) 的开发流程中,消息队列的顺序直接决定了智能体的执行逻辑。当需要批量处理提示词或构建长文本时,手动逐条发送既耗时又容易打断思路。dsh-queue-director 插件直接在 Web 界面介入,允许在代理处理消息前对队列进行重新排序。
这是什么¶
dsh-queue-director 是一个 DSH Web 插件,由 loklamlok 维护,旨在解决队列消息顺序固定的问题。它不修改 DSH 源码,而是通过 dsh.profile.bundles 挂载,作为插件运行。
核心功能¶
- 排序控制:队列中的每条消息增加
↑/↓按钮;展开队列后,会出现“置顶”和“置底”标签。支持直接拖拽消息行或其⠿处理手柄进行重排。 - 批量操作:提供“立即发送全部”功能,将所有待处理消息同时推送给 AI;提供“清空队列”功能,并强制执行两步确认以防止误操作。
- 集成特性:插件保留了 DSH 内置的队列行为,包括预览、内联编辑、移除和立即发送(Steer)。
- 热更新:插件更新后无需重启 DSH 服务,客户端 HMR 会在推送新 bundle 后自动生效,刷新页面即可。
安装与启用¶
插件尚未发布至 npm,需从源码安装。在 DSH Web 配置目录中,通过 dsh.profile.bundles 挂载该插件。
# 1. 克隆仓库
git clone https://github.com/loklamlok/dsh-queue-director
# 2. 在 $DSH_HOME/profiles/web 的 package.json 中添加依赖
# "dependencies": { "dsh-queue-director": "link:<path-to-repo>" }
# 3. 在 package.json 中注册 bundle
# "dsh": { "profile": { "bundles": [..., "dsh-queue-director"] } }
# 4. 安装并重启
pnpm install
# 重启 `dsh web`,然后硬刷新页面 (Cmd/Ctrl+Shift+R)
典型用法¶
当你需要按照特定顺序运行一批提示词,或者在撰写长文章时调整段落发送顺序时,可以在代理处理前使用此插件调整队列顺序。
适用场景与注意¶
- 环境要求:需要 Node.js ≥ 20,配合 DeepSeek Harness Web Profile (
@deepseek-ai/dsh-web-app) 和dsh启动器使用。 - 权限安全:插件通过
dsh.profile.bundles挂载,未修改 DSH 源码。 - 生态背景:DSH 理念为“一切皆插件”。本插件由社区开发者维护,并非 DeepSeek 官方出品。
dsh-queue-director 通过界面化的操作简化了队列管理流程。更多细节与源码请参考 GitHub。