前言¶

在 DeepSeek Harness（DSH）裏跑智能體時，任務、備忘和跟進項往往分散在聊天窗口、工作區備註或外部工具之間。工作區會隨項目切換或清空而變，側邊欄裏若有一套不聯網、本地落地的待辦與筆記，按分組管理且能備份恢復，會比「記在腦子裏」或臨時 Markdown 更可複用。下面介紹社區插件 dsh-todo（維護者 lizhanzhan89），它作爲客戶端插件掛在 Harness 側邊欄，把待辦和筆記放在同一面板裏，按「項目」分塊——此處的項目只是分組名稱，不是代碼工程。

這是什麼¶

dsh-todo 是 Harness 側邊欄中的事項面板：待辦與筆記合併展示，按項目分組，不聯網、不需要賬號。數據寫在用戶文稿目錄，與當前工作區解耦，便於在切換或清空工作區後仍保留記錄。插件包名爲 @local/dsh-todo，側邊欄入口 id 爲 todos；當前 package.json 中版本爲 1.2.0，許可爲 MIT（© 2026 lzz）。分類上屬於 DSH 生態裏的客戶端插件，通過 Harness 自帶的 webServer、connection（cookie 鑑權）與 Host 通信。

核心功能¶

資料中列出的能力如下，均以本地 JSON 爲唯一數據源。

待辦、筆記與截止日期¶

• 條目區分 todo 與 entry（筆記）；多行編輯時 Enter 換行，Ctrl/Cmd+Enter 保存，列表完整顯示，編輯框最多三行。
• 待辦可設 到期日（YYYY-MM-DD）：逾期標紅、當天標藍；另有「截止日期」視圖，跨項目按日期列出全部未完成項。

項目、歸檔與排序¶

• 新建項目即新建一個分組名；刪除項目時整組條目進入回收站。
• 歸檔：將導航裏的項目行拖到歸檔區，項目離開看板但條目保留，可隨時放回。
• 拖動排序：項目在導航行上拖；條目在行首握把上拖。數組順序即顯示順序。

搜索、回收站與已完成¶

• 搜索就地隱藏不匹配內容。
• 刪除先進回收站，可恢復原位。
• 支持「包含已完成」開關（對應數據裏的 includeDone）。

備份與恢復¶

• 自動備份：每天第一次寫入前，把上一份數據複製爲 dsh-todo-YYYY-MM-DD.json，只保留最新 7 份。
• 手動備份：頁面可「立即備份」，文件形如 manual-20261109-183000.json，永不自動清理，也可在頁面上刪除。
• 恢復：用所選備份完全覆蓋當前內容（與「導入合併」不同）；確認前會把當前狀態先存一份手動備份，恢復操作本身可撤銷。

安裝與啓用¶

插件以本地 bundle 方式安裝，命令須使用 README 原文形式（將 target 換成你機器上 dsh-todo 目錄的絕對路徑）：

plugin_manager: install_bundle  target=/絕對路徑/dsh-todo

安裝後通過側邊欄打開待辦面板即可使用。卸載時使用：

plugin_manager: remove_bundle  target=@local/dsh-todo

卸載不會刪除數據目錄；若要清空，需手動刪除 ~/Documents/dsh-todo/。

安全與權限：客戶端插件隨當前 DSH Host 進程運行，可讀寫你配置的數據路徑。安裝前建議在 GitHub 查看源碼與 MIT 許可證，確認路徑與備份策略符合你的環境。

數據存放與遷移¶

數據刻意放在文稿目錄而非工作區，避免工作區清空或切換導致待辦丟失。默認結構如下：

~/Documents/dsh-todo/
├── dsh-todo.json                      # 當前數據
└── backups/
    ├── manual-20261109-183000.json    # 手動備份
    └── dsh-todo-2026-11-09.json       # 自動備份（保留最新 7 份）

整個文件夾複製即可完整遷移。若需改用其他目錄，在 cordis.patch.yml 中爲插件配置 dataDir（相對路徑按用戶主目錄解析），例如：

- id: dsh-todo
  name: '@local/dsh-todo'
  config:
    dataDir: /Users/me/OneDrive/dsh-todo

備份爲純 JSON，可直接查看或手工編輯。頂層字段包括 projects、todos、trash、includeDone；每次改動由 Client 將完整狀態 POST 給 Host，寫入採用臨時文件再 rename，磁盤上始終是完整副本。

典型用法¶

1. 按分組管事項：在側邊欄 todos 中新建項目（分組），在同一項目下混合添加待辦與筆記條目。
2. 跟截止日期：爲待辦設置 due 日期，用顏色區分逾期與當天，並在「截止日期」頁查看跨項目待辦。
3. 暫不需要看板的項目：拖到歸檔區，需要時再拖回導航。
4. 換機或防誤刪：依賴自動 7 日快照或手動備份；出問題則從備份恢復（恢復前會自動留一份當前狀態的手動備份）。
5. 手工修數據：在 Host 未頻繁寫入時，可編輯 dsh-todo.json 或某份備份（須符合 README 中的 JSON 結構），理解 pickState() 白名單後避免新增未在白名單中的頂層字段被靜默丟棄——該細節主要面向改源碼的開發者。

適用場景與注意¶

適合：希望在 DSH 會話旁固定一塊本地待辦/筆記、不依賴雲服務或賬號的智能體開發者；需要按「分組」區分不同主題事項、又要與頻繁切換的工作區隔離的場景。

注意：

• 插件不聯網，多端同步需你自己複製數據目錄或使用同步盤（配合 dataDir）。
• 日期存 YYYY-MM-DD，不要用時間戳或誤用 toISOString() 以免跨時區滾日。
• 若自行修改 src/ 構建客戶端，需 node build.mjs 後重啓 Host 並刷新頁面；面板標題旁版本號（如 v2026-11-09.2）用於確認加載的構建產物。

社區插件目錄見 SkillHub 上的 dsh-todo 頁；源碼與完整說明以 GitHub 倉庫 爲準。DSH 生態強調「一切皆插件」，SkillHub 爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係。