DSH 官方 todo_write 的強化 fork:優先權標籤、完整 markdown 清單結果,加上一張跟著當前會話跑、可拖曳的浮動任務面板(README 標示 MIT)。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-20
授權條款
NOASSERTION
01它能幫你完成什麼?
在 DSH 會話裡維護一份帶優先權、看得到全貌的任務清單,而不是官方那行計數
一個 `todo_write_plus` 工具:結果帶 high / medium / low 優先權標籤,並把完整 markdown 清單回給模型
想把多步驟任務的計畫寫下來、讓模型和使用者都看得到的 DSH 使用者
模型在跑的時候順手看進度,不必切到側邊欄或另一個視窗
會話內自繪的浮窗:展開態/膠囊態、當前動作列、子代理列,發新訊息時保留上一輪清單並淡顯
在 dsh 桌面端跑長會話、希望計畫一直貼在對話旁邊的使用者
在已經使用官方 todo_write 的桌面環境加上面板,又不弄壞既有會話
並存做法:外掛註冊為 `todo_write_plus`,重用官方 `todo/write` 事件型別,雙方寫出的日誌互相可讀
桌面端 agent preset 已內建官方任務工具、無法直接替換的團隊
02如何將外掛接入 DeepSeek Harness?
先決條件
- 一個 `dsh` CLI profile,或 dsh 桌面端(桌面端的安裝指令 README 另給了走 `ELECTRON_RUN_AS_NODE` 的寫法)
- Node.js ≥ 24 —— README 只在從原始碼建置的路徑上聲明這個要求
安裝步驟
- 01
CLI profile:`dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist`,用套件名安裝不需 git 位址,也可指定版本
$ dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist
- 02
也可以用 git 通道:`dsh plugin --profile <你的profile名> add https://github.com/shuxidemosheng/dsh-todolist.git`,一律抓 main 最新
$ dsh plugin --profile <你的profile名> add https://github.com/shuxidemosheng/dsh-todolist.git
- 03
桌面端:側邊欄「外掛」→ 新增外掛 → 貼上儲存庫位址或套件名;安裝失敗會自動回復(動手前先完全結束應用程式,含系統匣)
- 04
安裝或升級完成後重新啟動用戶端
驗證整合成功
- 核對安裝版本:`grep '"version"' ~/.dsh/profiles/desktop/node_modules/@shuxidemosheng/dsh-todolist/package.json`
03DSH 整合程度與能力邊界
以 `dsh plugin add` 安裝的原生 DSH 外掛:主機端註冊強化版任務清單工具,用戶端在會話裡畫出浮動任務面板
強化工具 `todo_write_plus`
任務項目,可帶 `high` / `medium` / `low` 的 `priority`→回給模型的完整 markdown 清單,以及會話日誌裡的一筆 `todo/write` 事件
0.7.3 起參數改為正規化而非拒絕:空白 `content` 丟棄、重複內容加後綴、多餘的 in_progress 降級為 pending調整結果會在工具結果裡告知模型浮動任務面板
會話的 `todos` 投影→展開態(狀態點/刪除線/優先權徽章/進度計數/進行中標記),點一下切成同一份清單的膠囊態優先鏈
把拖曳後的面板座標寫進 localStorage 的 `dsh-todo-plus.panelPos`,內容只有 `{x, y}`當前動作與子代理狀態
會話節點流裡已送出但還沒回傳結果的工具呼叫,`subagentCatalog` / `subagentTiming` 投影→兩次清單寫入之間即時顯示的工具列;以及可收合的子代理列,展開看名稱、狀態與已執行時間
輪次之間不斷線
上一輪留下的清單→舊清單繼續顯示、淡顯並標註「上一輪」,直到新清單寫入才替換
可設定的紀律與工具名稱
`cordis.patch.yml` bundle 列裡的 `allowParallelInProgress` 與 `toolName`→預設單一活躍紀律;CLI profile 上停用官方 `tool-todo` 列後,也能把工具名稱改回 `todo_write`
04適合誰?何時不該用?
適合
- 想把多步驟任務的計畫寫下來、讓模型和使用者都看得到的 DSH 使用者
- 在 dsh 桌面端跑長會話、希望計畫一直貼在對話旁邊的使用者
- 桌面端 agent preset 已內建官方任務工具、無法直接替換的團隊
不適合
- dsh 0.2.1-rc.2 起會在啟動時檢查外掛的相容性宣告:0.7.3 及更早把 peer 鎖死在 `0.2.0-rc.2`,在這些版本上會被判為不相容而拒絕載入;0.7.4 起改用 `engines.dsh: ">=0.2.0-rc.2 <0.3.0"` 宣告範圍才恢復載入。
- dsh 0.2.2-rc.1 起,共用同一個投影 key 的註冊方必須宣告相同的 `stateVersion` 與 `summary`。官方 `tool-todo` 明確寫 `summary: false`,而 0.7.4 及更早的本外掛沒宣告該欄位,兩者在桌面端 agent preset 並存時後註冊的一方 `register()` 拋錯,連帶讓會話建立失敗;0.7.5 已對齊官方定義。
- 用套件名安裝會走 npm registry,而 dsh 內建的 `minimumReleaseAge` 供應鏈策略會把剛發佈的版本壓進數天冷卻期,這段時間裸套件名解析到的是上一個「夠老」的版本,外掛頁卡片卻還顯示 registry 最新版號。要立刻用新版就帶版本號安裝。
05相容性、維護與安全提醒
- dsh 0.2.1-rc.2 起會在啟動時檢查外掛的相容性宣告:0.7.3 及更早把 peer 鎖死在 `0.2.0-rc.2`,在這些版本上會被判為不相容而拒絕載入;0.7.4 起改用 `engines.dsh: ">=0.2.0-rc.2 <0.3.0"` 宣告範圍才恢復載入。
- dsh 0.2.2-rc.1 起,共用同一個投影 key 的註冊方必須宣告相同的 `stateVersion` 與 `summary`。官方 `tool-todo` 明確寫 `summary: false`,而 0.7.4 及更早的本外掛沒宣告該欄位,兩者在桌面端 agent preset 並存時後註冊的一方 `register()` 拋錯,連帶讓會話建立失敗;0.7.5 已對齊官方定義。
- 用套件名安裝會走 npm registry,而 dsh 內建的 `minimumReleaseAge` 供應鏈策略會把剛發佈的版本壓進數天冷卻期,這段時間裸套件名解析到的是上一個「夠老」的版本,外掛頁卡片卻還顯示 registry 最新版號。要立刻用新版就帶版本號安裝。
- 面板只是 `todos` 投影的鏡像:模型若只在正文裡回報進度、沒呼叫工具,面板就停在舊狀態,外掛不會替它編進度。浮窗也只在會話介面出現,這是設計行為。
README 寫 MIT,GitHub 判定為 NOASSERTION · 活躍維護(最新 release v0.8.0,2026-11-18)
06常見問題
要怎麼裝進 DeepSeek Harness?
在 CLI profile 執行 `dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist`;README 另給了 git 直裝與桌面端外掛頁兩條路,自己從原始碼打包出 tgz 也能裝。裝完重新啟動用戶端。要注意 dsh 的 `minimumReleaseAge` 冷卻期內,裸套件名會解析到舊版,要最新版就帶版本號,例如 `@shuxidemosheng/dsh-todolist@0.8.0`。
會不會和官方 todo_write 衝突?
不會。桌面端註冊的是 `todo_write_plus`,與官方 `todo_write` 並存;會話日誌重用官方 `todo/write` 事件型別,雙方寫出的日誌互相可讀。工具名稱若真被佔用(例如裝了兩份),本外掛記錄日誌後優雅讓位,entry 仍正常啟用,不會讓 agent preset 稽核失敗。桌面端 agent preset 無法停用官方 `tool-todo` 列,所以那邊只能是並存而非替換。
面板停在已經做完的那一步不動,是什麼原因?
浮窗和官方內嵌任務列讀的是同一個 `todos` 投影,兩邊都停在同一處,就代表之後沒有任何清單寫入被接受。先確認版本(冷卻期可能裝到舊版),再到「軌跡」分頁看 `todo_write_plus` 的呼叫紀錄:最後一次是紅色錯誤代表寫入被拒(0.7.2 及更早對同時標多個 in_progress 是硬性拒絕),最後一次成功但之後沒有呼叫,代表模型只在正文回報進度。0.7.3 起改為正規化處理,不會再「一被拒就永久停擺」。
它會連網或動我的檔案嗎?
不會。主機端與用戶端都是自包含產物,零執行時 npm 相依;用戶端沒有任何網路請求、不用 `eval` / `innerHTML`,唯一的本機寫入是 localStorage 裡的面板座標 `{x, y}`(key `dsh-todo-plus.panelPos`)。主機端只註冊工具與投影、往會話日誌追加事件,不碰檔案系統與網路。
支援哪些 dsh 版本?
0.7.4 起以 `engines.dsh: ">=0.2.0-rc.2 <0.3.0"` 宣告相容範圍,0.2.x 的 rc 升級不再被卡;0.7.5 又把投影註冊對齊到 dsh 0.2.2-rc.1 要求的官方 `summary: false`。0.7.3 及更早把 peer 鎖死在 `0.2.0-rc.2`,在 0.2.1-rc.2 以上會被拒絕載入。
07相關的 DSH 工作流程
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 外掛,高效能低佔用,可愛畫素鯨魚,流暢滑鼠互動,npm 一鍵安裝
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座,支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/側邊對話/Git/子代理頁面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒體工作臺外掛:一句話記靈感,一鍵生成指令碼、封面、配圖和分鏡
dsh-drawai
作者 fourzkw
DSH 右側欄裡的可編輯畫布 —— 加上讓模型直接改圖的兩個工具
08資料與來源
**DeepSeek Harness 任务清单插件 —— 官方 [`todo_write`](https://github.com/deepseek-ai/deepseek-harness) 的增强 fork**
- **模型侧**:注册增强版任务清单工具。是否建清单由模型根据任务复杂度自主判断(多步骤任务通常会建)
- 本插件在桌面端注册为 **`todo_write_plus`**,与官方 `todo_write` 并存,零冲突
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
