前言¶
在 DSH web 的 todo 流程裏，官方 todo 面板通常只服務當前輪次的任務展示。如果還希望未完成任務跨輪次、跨會話和重啓後保留，同時對已完成項附一個證據路徑，就需要一個不改動官方面板的審閱層。dsh-todo-guard 是 DSH web 的社區插件：官方 todo 面板保持原樣，插件在官方面板下方掛載 review dock，用於保留未完成任務並標註完成證據。
它由 a903067276-rgb 維護，是 community project，不是 DeepSeek 產品，許可證爲 MIT。DSH 的生態理念是“一切皆插件”；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應把它當成官方應用商店。
這是什麼¶
dsh-todo-guard 是 DeepSeek Harness web 的 todo 審閱插件。它的定位是：官方 todo 面板不被修改或替換，插件通過額外 conversation.input.dock 在官方 todo 面板下方掛載 review dock。
它主要解決兩件事：
- 保留未完成任務：跨輪次、會話切換和 dsh 重啓仍然保留。
- 覈驗完成證據：對 todo 項中給出的路徑做存在性標註，並讓人確認 finalize。
整個邏輯是純本地邏輯：zero model calls、zero token cost。
核心功能¶
保留未完成任務¶
插件通過 checkpoint resume 保留未完成任務。官方面板重啓後渲染失敗時，review dock 可作爲 fallback。
證據狀態標註¶
strictMode 默認開啓。開啓後，todo 項會根據證據路徑標註三種狀態：
- 證據路徑存在：verified。
- 已寫路徑或錨點，但路徑缺失：evidence missing。
- 無可驗證軌跡：unverified。
證據路徑僅做存在性檢查，host 只做 stat，不讀取內容。因此“路徑存在”不等於“任務實際完成”。
strictMode 可以在 Settings → todo strict mode 關閉。關閉後，review dock 變成普通列表，不再有標註和確認，但 resume 仍可用。
非阻塞提示¶
證據缺失或僞造不會阻塞任務寫入，也不會報錯。插件只在工具結果文本中給 nudge 提示。
一次檢查 2 個及以上項目時，會觸發逐步檢查提示，也就是 incremental check nudge。
如果 host 支持 official tools/post-execute，插件會在成功寫入後追加非阻塞文本提示；舊 host 沒有該 hook 時，降級爲面板標註。
審閱與 finalize¶
review dock 默認摺疊。摺疊時顯示 pending 數量，並保留 finalize 按鈕。
如果所有項都 checked 且全部 auto-verified，review dock 會自動隱藏。仍有 pending 時，需要點擊 Confirm finalize；確認狀態按會話保存在瀏覽器。
安裝與啓用¶
先安裝插件，再重啓 dsh web：
dsh plugin --profile web add "github:a903067276-rgb/dsh-todo-guard#main"
# restart dsh web
版本兼容是 best-effort，不保證每個 DSH 版本都兼容。已覈實的兼容關係如下：
- DSH 0.1.1-rc.1+：使用
main。 - DSH 0.1.0-rc.7 / rc.8：review dock 數據不保證，建議使用 v0.1.6 fallback。
- DSH 0.1.0-rc.6：frozen rc6-compat，不再維護。
舊版本 fallback：
dsh plugin add github:a903067276-rgb/dsh-todo-guard#v0.1.6
package engines 要求 dsh >=0.0.1；peerDependencies 包括 @deepseek-ai/cordis ^4.0.1-rc.1 和 @deepseek-ai/schemastery ^3.18.1。
典型用法¶
在 todo 項內寫 （證據：path）。一個 todo 項可以寫多個證據路徑。
Fix the button（證據：lib/index.js）
Run tests（證據：test/run.log）（證據：docs/result.md）
相對路徑按 session working directory 解析；絕對路徑和 ~/ 原樣支持。
適用場景與注意¶
dsh-todo-guard 適合使用 DSH web 管理 todo、並且希望保留未完成任務和證據標註的場景。
使用前注意：
- 它是 community project，不是 DeepSeek 產品。
- 版本兼容是 best-effort，不保證每個 DSH 版本都兼容。
- 證據路徑僅做存在性檢查，host 只做 stat，不讀取內容；路徑存在不等於實際完成。
- strictMode 關閉後，dock 變爲普通列表，無標註和確認，但 resume 仍可用。
- 插件會以當前 dsh 進程權限運行，並會註冊 dock、檢查證據路徑、追加提示。安裝前建議檢查 GitHub 源碼、MIT 許可證和依賴聲明。
結尾¶
dsh-todo-guard 的價值在於：不動官方 todo 面板，給 DSH web 的 todo 流增加一層輕量審閱：保留未完成任務、標註證據狀態、讓人確認 finalize。它不替代實際完成驗證，但適合作爲本地 todo 審閱輔助。
GitHub：https://github.com/a903067276-rgb/dsh-todo-guard
目錄頁：https://www.skillhub.cn/plugins/a903067276-rgb/dsh-todo-guard
