前言¶
在 DeepSeek Harness（DSH）裏接模型做任務，常見做法是一次性列很多待辦，讓會話並行或批量執行。題目一多，容易出現每項只做一半、需要你逐個盯着收尾的情況。社區插件 dsh-todo-queue（維護者 This-is-XiaoDeng）把執行收成串行隊列：每個隊列同一時刻最多一個會話在跑，空閒自動派發下一條，本輪結束進入待驗收，你可在面板或會話浮窗裏驗收或寫修改建議退回。調度在 Host 端完成，不依賴瀏覽器標籤常開。下面介紹它的定位、能力、安裝與用法。
這是什麼¶
dsh-todo-queue 是 DSH 的串行 TODO 隊列板（npm 包名 dsh-todo-queue，當前資料中版本 0.1.1，許可證 MIT）。分類上屬於工作流類擴展；側欄顯示名爲「TODO 隊列板」。
一句話：全局隊列與每個工作區隊列各自最多運行一個會話，隊列空閒時自動派發；控制面板是獨立主頁面（PC / 移動端自適應），待驗收會話內帶快捷浮窗。
與「一次性塞十條給 AI」相比，它強調一條隊列一項在執行、做完再下一項，並在每輪結束後強制經過用戶驗收，而不是直接算完成。
核心功能¶
資料中確認的能力如下。
兩條隊列¶
| 綁定 | 隊列鍵 | 行爲 |
|---|---|---|
| 全局 | global |
綁到全局的待辦共用一條隊列，跨工作目錄串行 |
| 工作區 | workspace:<絕對路徑> |
每個工作目錄一條隊列；不同目錄可同時各跑一個會話 |
隊列狀態由待辦狀態推導：有 running 則忙；否則按板上順序取第一條 pending 派發。派發失敗則該條爲 failed，隊列繼續嘗試後續項，不會整條卡死。
待辦生命週期¶
pending ──派發──▶ running ──本輪結束 / AI 標記 done──▶ review
▲ │
│ 用戶寫修改建議並退回 │
└──────────────────────────────────────────────────────┘
│
用戶完成驗收 ▼
accepted
- pending：排隊，隊列空閒即自動開始。
- running：已創建或複用會話併發出提示詞。
- review：本輪結束，等驗收；打開對應會話可見浮窗。
- accepted：已驗收，可重新排隊或刪除。
- failed：派發或啓動失敗，卡片上有錯誤，可重試。
退回時（review → pending），建議寫入 feedback；下次派發儘量複用原會話做 followup，否則新開會話並在提示詞中帶歷史建議。
同目錄佔用與等待¶
同一工作目錄裏，若除隊列正在驅動的那一個會話外，還有其它 running 會話（你的聊天或其它插件），隊列會等待，卡片可顯示「等待 N 個其他會話空閒」；佔用結束後 Host 通過 agent/status 觸發調度，無需手動點繼續。這是等待而非報錯。
界面與 Host 調度¶
- 側欄「TODO 板」打開獨立主頁面：統計、左列全局隊列、右列工作區隊列（多工作區用標籤切換）。
- 打開
review狀態綁定的會話時，右下角浮窗支持：完成驗收、修改建議並退回待運行、打開面板。 - 調度器與隊列邏輯在 Host 半邊（
lib/index.js）；關瀏覽器標籤仍可繼續派發。瀏覽器通過/dsh-todo-queue/api讀寫快照。
模型工具 todo_queue¶
| action | 說明 | 審批 |
|---|---|---|
list |
查看全部隊列和狀態 | 否 |
add |
新增待辦（默認當前會話工作目錄） | 是 |
done |
把當前會話正在跑的待辦標爲待驗收 | 否 |
note |
追加/修改備註 | 是 |
寫操作在 tools/pre-execute 層走 DSH 原生審批框。
持久化路徑：${DSH_HOME}/todo-queue/board.json。
運行環境要求（來自 package.json）：Node >=22.19.0，DSH >=0.2.1-rc.5。
安裝與啓用¶
推薦從 npm 安裝（版本經發布校驗）：
dsh plugin --profile web add dsh-todo-queue
也可從 GitHub 跟蹤 main 最新提交：
dsh plugin --profile web add github:This-is-XiaoDeng/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，本插件不會覆蓋，可按需手工遷移標題與備註。
典型用法¶
README 建議的本地驗證順序可作爲上手路徑。
- 安裝插件（開發可用
dsh plugin --profile web add link:<repo>）。 - 在面板新建一條會很快結束的待辦，例如標題寫「只回復 OK」。
- 觀察自動派發 → 進入待驗收。
- 打開該會話，確認浮窗出現；試一次「修改建議 → 退回待運行」，再看下一輪是否帶着建議派發。
日常可在面板新建待辦時選擇「運行目錄」（當前會話目錄、已知工作區或手動輸入其它目錄）。模型側可用 todo_queue 的 list / add / done / note 與面板配合；add 與 note 會彈出審批。
適用場景與注意¶
適合誰：需要把 AI 任務排成隊列、一項接一項執行，且每輪要人工驗收或退回修改的 DSH 用戶；多工作區希望各目錄一條隊列、全局任務單獨串行的場景。
當前限制（README 明確列出）：暫無定時執行、圖片附件、拖動排序；工作區以絕對路徑爲準，目錄刪除後隊列可能停在錯誤上需改目錄或刪待辦；進程重啓後舊會話不可複用時開新會話，提示詞保留建議但不保留完整舊上下文；佔用判斷按目錄，父/子目錄裏的其它會話不算佔用。
安全與權限：插件以當前 dsh 進程權限運行，可讀寫 ${DSH_HOME}/todo-queue/board.json 並通過 Host 創建會話。安裝前應查看 源碼倉庫 與 MIT 許可證，確認符合你的環境策略。API 路由受與 DSH 相同的 Host/Origin 信任圍欄約束。
DSH 生態秉承「一切皆插件」；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-todo-queue 用串行隊列和待驗收步驟，把「多件待辦」收成可自動派發、可退回修改的一條流水線；全局與工作區雙隊列、Host 端調度與獨立面板是其主要結構。進一步瞭解可看社區目錄頁與 GitHub README：
- 目錄頁：https://www.skillhub.cn/plugins/This-is-XiaoDeng/dsh-todo-queue
- 倉庫：https://github.com/This-is-XiaoDeng/dsh-todo-queue
