前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在擴展功能。內置的 todo_write 工具主要用於記錄智能體在當前會話中的執行步驟，生命週期僅限於單次對話。當需要在跨會話之間管理個人待辦事項，並保留交接說明時，dsh-followup-todo 插件提供瞭解決方案。
插件概覽¶
本插件爲用戶提供一個跨會話的待辦清單，而非智能體的任務清單。
* 核心價值：每條待辦附帶結構化的交接說明（context + inject），新會話可直接讀取並開工。
* 維護者：Tiaoma123
* 分類：記憶
* 協議：MIT
核心設計：Context + Inject¶
每條待辦包含兩個自由文本字段，用於構建新會話的上下文：
* Context（背景）：記錄已確定的事實、結論、文件路徑或硬約束，不包含過程流水賬。
* Inject（注入內容）：明確下一步動作、目標、驗收標準，歧義處標記「待確認」。
點擊面板中的「繼續」或輸入框上方的待辦條，生成的交接 prompt 會自動填入輸入框，使新會話開局即具備完整上下文。
安裝與啓用¶
本插件未發佈至 npm，需通過 GitHub 直裝。安裝命令如下：
dsh plugin --profile <profile> add github:Tiaoma123/dsh-followup-todo
注意事項：
* 本包通過 cordis.patch.yml 自掛載，安裝後即用，無需手動編輯配置文件。
* 不可重複掛載：重複掛載會導致路由衝突，啓動時報錯。若之前手動掛載過，請先刪除舊配置。
模型工具¶
插件註冊了 4 個模型工具，支持優先級管理（P0-P3）及歸檔功能。
- todo_add
- 新增待辦。
- 參數：
title（必填）、priority（默認 P2）、context、inject、workspace（可選）。
- todo_list
- 查看清單。
- 參數：
filter（支持 open/done/all/archived）。
- todo_done
- 標記完成（條目保留在清單中）。
- todo_archive
- 標記完成並歸檔（移出活動視圖，可通過 filter=archived 回查）。
瀏覽器端界面¶
僅在 Web 端生效，Headless Profile 無 UI。
* 會話頭部按鈕：顯示未完成數量角標，點擊展開懸浮面板。
* 懸浮面板：支持新增、勾選、歸檔、刪除，可按優先級 P0-P3 選擇，並切換過濾頁籤。
* 輸入框待辦條：顯示待辦數量與提示，展開後列出條目。點擊條目將交接內容注入輸入框。
數據存儲¶
數據以 JSON 文件形式存儲在用戶目錄下，按工作區分片：
* 路徑格式：~/.dsh/followup-todos-<base64url(工作區絕對路徑)>.json
* 用戶可直接備份該文件。
與內置 todo_write 的區別¶
- 清單歸屬：內置工具屬於 Agent，此插件屬於用戶。
- 生命週期：內置工具僅限當前會話，此插件支持跨會話、歸檔與回查。
- 存儲位置：內置工具存儲在會話上下文，此插件存儲爲獨立 JSON 文件。
已知限制與安全說明¶
- HTTP 鑑權：新版本通過鑑權攔截未授權請求。老版本 DSH 退化爲無鑑權，若將 Web 服務暴露至非迴環地址，需自行增加訪問控制。
- 數據同步：列表依靠 3 秒全局輪詢刷新，非實時推送，多窗口可能存在短暫延遲。
- UI 限制：僅實現了 Web 界面，Headless Profile 無法使用可視化功能。
維護狀態¶
個人自用項目，不承諾維護。使用 MIT 協議，可自由 Fork。
