DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-todo-queue

T

dsh-todo-queue

Manifest valid

DeepSeek Harness's Serial TODO Queue Board: Global/Workspace Queues Each Support at Most One Session, Automatic Dispatch When Idle, Independent Responsive Panel + Pending-Acceptation Pop-up

UI (client)hasBundlePatchMachine translated

dsh-todo-queue

DeepSeek Harness 的串行 TODO 队列板:一次只让一个会话跑一条队列,跑完自动进入待验收,队列空闲后自己派下一条。

A serial TODO queue for DeepSeek Harness: one session per queue, automatic dispatch when idle, and a review step the user can send back with change requests.

license: MIT node dsh

TODO 队列板


它解决什么 / Why

普通待办板容易变成「一次性把十件事塞给 AI」:结果每件都做一半,你还得逐个盯着。 这个插件把「执行」变成一条串行队列:

  • 每个队列同时只有一个会话在运行。 全局队列跨工作目录串行;工作区队列按目录各一条,互不阻塞。
  • 队列空闲时自动派发下一条。 不用你点「继续」,也不用打开网页。
  • 会话结束就进入待验收。 打开这个会话时,右下角会出现快捷浮窗:完成验收,或写修改建议退回待运行。
  • 退回时建议会进下一轮提示词。 同一条待办会尽量复用原来的会话,保留上下文。
  • 控制面板是一个独立主页面。 侧栏「TODO 板」进入,PC / 移动端自适应;它只负责看和改,调度在 Host 上跑。

功能一览 / What you get

能力一句话
串行队列全局 1 条 + 每个工作目录各 1 条;每条队列最多一个运行中的会话
自动派发队列空闲时自动开新会话(或复用该待办的旧会话)执行下一条
待验收会话本轮结束后自动进入「待验收」,不会直接算完成
修改建议在面板或浮窗里写建议 → 退回待运行 → 下次派发带着建议一起发
独立页面侧栏入口 + 占满主区域的响应式页面,不是浮窗
移动端390px 宽度下可滚动、表单不溢出、从侧栏进入时自动收起抽屉
会话浮窗打开待验收会话时显示快捷操作:完成验收 / 修改建议 / 打开面板
不依赖网页Host 端调度器持有队列;关掉浏览器标签也继续派发
模型工具todo_queue:list / add / done / note,写操作走 DSH 原生审批框
极简界面白底、细线、一个状态点;深色主题跟随 DSH

安装 / Install

从 GitHub 安装:

dsh plugin --profile web add github:This-is-XiaoDeng/dsh-todo-queue

本地开发(link 模式,改代码后由 profile 的 HMR 重载):

dsh plugin --profile web add link:/home/dsh/workspace/dsh-todo-queue

安装后如果 profile 没有启用 live 重载,重启一次 dsh web。卸载:

dsh plugin --profile web remove dsh-todo-queue

从旧版 dsh-todo-board 迁移? 两者是不同包,同一份 profile 里请只保留一个: dsh plugin --profile web remove dsh-todo-board 再装本插件。旧板的数据仍留在 ${DSH_HOME}/todo-board/board.json,本插件不会覆盖它;需要的话可以手工把标题 / 备注搬过来。

工作原理 / How it works

两条队列 / Two queue families

绑定队列键行为
全局global所有绑到全局的待办共用一条队列,跨工作目录串行
工作区workspace:<绝对路径>每个工作目录一条队列;不同目录可以同时各跑一个会话

每条队列的状态是推导出来的,不是另存一份:

  • 队列里有 running 的待办 → 忙;
  • 没有 → 取下一条 pending,按板子从上到下的顺序派发;
  • 派发失败 → 该条变 failed,队列继续尝试后面的(不会整条队列卡死)。

一条待办的生命周期 / Row lifecycle

pending ──派发──▶ running ──本轮结束 / AI 标记 done──▶ review
   ▲                                                      │
   │                      用户写修改建议并退回             │
   └──────────────────────────────────────────────────────┘
                                                          │
                                             用户完成验收 ▼
                                                       accepted
  • pending:在队列里排队,队列空闲就自动开始。
  • running:已创建/复用会话并发出提示词。
  • review:本轮已结束,等用户验收。打开对应会话会看到浮窗。
  • accepted:用户已验收,留在「已验收」区,可重新排队或删除。
  • failed:派发或启动失败,错误写在卡片上,可重试。

为什么关掉网页也能跑 / Host-side scheduling

调度器、队列状态和派发逻辑都在 lib/index.js(Host 半边)。浏览器只通过 /dsh-todo-queue/api 读写快照,不参与派发。Host 用 agent/turn-stopping 和 agent/status 判断一轮是否结束,然后释放队列、派发下一条。

提交建议后会发生什么 / Send-back semantics

review → pending 时会把建议追加到 feedback。下一次派发:

  1. 如果该待办原来的会话仍然活着、且工作目录没变,就把新提示词 followup 进去,保留上下文;
  2. 否则新开一个会话,提示词里带上全部历史建议。

提示词里会明确写:只做这一条、不要向用户确认、完成后直接结束本轮(插件会自动标待验收)。

界面 / UI

独立主页面

工作区队列

  • 左侧「TODO 板」→ 主区域打开独立页面。
  • 顶部是统计(运行中 / 待验收 / 待运行 / 已验收),不是弹窗。
  • 左列全局队列,右列工作区队列;工作区有多个时用标签切换。
  • 卡片按状态分区:运行中 / 待验收 / 排队中 / 异常 / 已验收。
  • 移动端会把两列堆叠,页面自身成为滚动容器;从抽屉进入时自动收起侧栏。

待验收浮窗

待验收浮窗

打开一条 review 会话时,右下角出现浮窗:

  • 完成验收:直接 accepted,浮窗消失;
  • 修改建议:展开输入框 → 退回待运行;
  • 打开面板:跳到 TODO 板页面。

浮窗只在该会话确实绑定了一条待验收待办时出现;打开其他会话或面板时不会出现。

模型工具 / Model tool

todo_queue:

action说明审批
list查看全部队列和状态否
add新增待办(默认当前会话工作目录)是
done把当前会话正在跑的待办标为待验收否
note追加/修改备注是

写操作在 tools/pre-execute 层拦截,走 DSH 原生审批框;被拒绝就停手。 done 不审批:它是执行中的会话自己的完成信号,插件本来也会在本轮结束时自动标待验收。

数据与接口 / Data & API

  • 板文件:${DSH_HOME}/todo-queue/board.json(原子写入,损坏时备份为 .corrupt-<ts> 后空板启动)。
  • 路由:GET /dsh-todo-queue/api 返回快照;GET ?session=<id> 额外返回该会话绑定的待办(浮窗用)。
  • POST 动作:create / patch / remove / accept / sendBack / run / move / clearAccepted。
  • 路由经过与 DSH 相同的 Host/Origin 信任围栏;没有浏览器凭据的本机进程不能写板。

开发 / Development

npm test            # node tools/smoke.mjs:队列、串行、两条队列、退回、持久化、工具、审批
npm run check       # node --check 两半

本地验证顺序建议:

  1. dsh plugin --profile web add link:<repo>(或改 profile package.json 后热重载);
  2. 在面板建一条会很快结束的待办,例如「只回复 OK」;
  3. 观察它自动派发 → 待验收;
  4. 打开该会话,确认浮窗出现,试一次「修改建议 → 退回待运行」。

限制 / Current limits

  • 还没有定时执行、图片附件、拖动排序;需要这些时先看旧板 dsh-todo-board 的实现再决定是否加回来。
  • 「工作区」以绝对路径为准;目录被删后,该队列会停在错误上,需要改目录或删除待办。
  • 会话是否「复用」取决于它是否还在 Host 的 live agent 表里;进程重启后旧会话不存在,会开新会话并在提示词里保留建议,但不保留旧会话的完整上下文。
  • 队列派发一个待办时,如果用户恰好也在同一会话里发消息,插件会等该会话空闲;期间该条保持 pending,不会插队。

License

MIT

Comments

Loading…

Similar plugins

dsh-work-progress

by ardesp0630

工作进度面板:在输入框下方的带区常驻显示当前会话的任务清单完成度与运行状态,展开可见任务明细、轮次步骤、模型/工具耗时与上下文占用。

UI & ExperienceTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 21, 2026

dsh plugin --profile web add dsh-work-progress

by shuxidemosheng

Enhanced todo_write plugin for DeepSeek Harness: floating task panel with capsule mode, priority tags, full checklist rendering. Fork of @deepseek-ai/dsh-tool-todo.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 105

↓ 583/wk

NOASSERTION

JavaScript

Nov 5, 2026

dsh plugin --profile web add dsh-tool-todo-plus

by Natte

DeepSeek Harness 待办插件:侧栏入口行 + 主面板页,宿主侧持久化,agent 可读写

Workflow & AutomationTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 27, 2026

dsh plugin --profile web add dsh-sidebar-todo

by TobiichiOrigamii

Cross-session messaging, persistent session team, approval gates and a per-session task board for DeepSeek Harness (DSH).

Manifest valid

★ 0

MIT

JavaScript

Oct 22, 2026

dsh plugin --profile web add dsh-crosssession

by FiretrUCK666

DSH Web GUI 的任务看板插件:侧边栏入口 + 五列看板,任务经 DSH 会话真实执行,host 端持久化并跨设备实时同步。Task board plugin for the DeepSeek Harness web GUI.

Sessions & MessagesManifest valid

★ 3

↓ 1.5k/wk

MIT

TypeScript

Nov 11, 2026

dsh plugin --profile web add @firetruck666/dsh-task-board

by SkuraSshly

DeepSeek Harness (DSH) task completion badge: native Windows taskbar counter (ITaskbarList3) while the window is away, auto-clears on return. Subagent sessions excluded.

Tools & CapabilitiesNotifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

Aug 24, 2026

dsh plugin --profile web add dsh-done-badge