前言¶

在 DeepSeek Harness（DSH）裏做日常開發或跑 agent 時，任務往往分散在對話、筆記和外部工具之間：側欄沒有統一入口，agent 也很難穩定讀寫同一份待辦。宿主自帶能力通常不負責「個人清單 + 日曆 + 隨手便籤」這一整套 UI，也不保證對話裏說的「明天交週報」能落到可勾選、可排期的數據上。

下面介紹社區插件 dsh-sidebar-todo（維護者 Natte，分類：客戶端）。它在側欄增加「待辦」入口與主面板頁，數據保存在本機 JSON，宿主側持久化；同時註冊 personal_todo 與 personal_note 工具，讓 agent 與用戶共用一份數據。

這是什麼¶

倉庫、npm 包與插件標識統一爲 dsh-sidebar-todo，側欄顯示名稱爲「待辦」。簡介與 README 一致：DeepSeek Harness 的側欄待辦插件，提供清單、循環任務、月視圖日曆與便利貼；數據在本機一個 JSON 文件中，agent 通過工具讀寫同一份。

已發佈 npm：https://www.npmjs.com/package/dsh-sidebar-todo
目錄頁：https://www.skillhub.cn/plugins/Natte/dsh-sidebar-todo
源碼：https://github.com/Natte/dsh-sidebar-todo

當前 package 版本爲 0.3.1（README 正文仍以 0.3.0 功能說明爲主，含編輯彈窗、循環任務、月視圖日曆、分類，以及 0.3.0 新增的便籤、篩選與已結束循環組）。許可證 MIT。

核心功能¶

清單與分組¶

列表按狀態分爲八組：逾期 → 今天 → 明天 → 本週 → 以後 → 積壓 → 未排期 → 已完成。已完成記錄可按「今天 / 本週 / 本月」篩選。窗口較寬時，右側詳情列吸收餘量（寬度約 320–520px）。

新建、編輯與一句話填寫¶

「+ 新建」或詳情列「編輯」打開同一彈窗：標題、備註、日期、時間、優先級、分類、重複規則。彈窗頂部「一句話填寫」支持例如「明天下午3點 交週報 #工作」，自動解析字段後再手動微調。日期與時間爲自繪選擇器，不依賴系統控件樣式。

循環任務¶

重複方式：每天 / 每週（可多選周幾）/ 每月（指定幾號），可設結束日期。列表只顯示本週期待完成的一次，勾選完成後該行消失，下一週期再出現。循環任務不進「已完成」、不參與「積壓」判定；結束日期已過的系列收進「已結束」摺疊組（默認收起），延長 until 可回到正常分組。

日曆與分類¶

頁頭可切到「日曆」月視圖：每格最多兩條，超出顯示 +N；點某天在右側查看安排、勾選或「在這一天新建」。分類不預設，來自待辦中的分類名；頁頭「分類」可改名（已有待辦批量跟隨）或刪除（退回無分類）。

便籤與篩選¶

詳情列下方有便利貼塢：無日期、無完成狀態，不參與分組統計；單條上限 500 字，可轉待辦或刪除。頁頭「篩選」按分類與優先級過濾，與搜索詞疊加；篩選不持久化，刷新復位。

agent 工具¶

• personal_todo：list / add / update / complete / confirm / delete；支持 repeat、循環完成指定 date，以及 list 的 category、priority、view（含 ended 查已結束循環組）。
• personal_note：add / list / delete；用於無排期、無提醒的隨手記。需要日期或完成態時用 personal_todo，用戶只說「記一下」且不要求時間時用 personal_note。

安裝與啓用¶

推薦從 npm 安裝（命令來自 README）：

dsh plugin --profile web add dsh-sidebar-todo

裝完後側欄「自動化任務」下方出現「待辦」。也可在宿主「插件 → 發現」中搜索 dsh-sidebar-todo 或「待辦」一鍵安裝。

若需跟蹤 GitHub 最新提交或 npm 尚未發版，可使用：

dsh plugin --profile web add github:Natte/dsh-sidebar-todo

宿主版本由 engines.dsh 聲明爲 >=0.2.1-rc.2 <0.3.0-0；落在區間外會安裝失敗。README 記錄與 0.2.1-rc.5 的兼容性走查見倉庫 docs/notes/testing.md。

可選配置寫在 cordis.patch.yml 對應插件行的 config 下：

- id: dsh-sidebar-todo
  config:
    staleDays: 7   # 超過多少天還沒定日期算「積壓」
    dataPath: ''   # 可選，覆蓋默認數據文件路徑

數據文件與典型用法¶

默認路徑爲 %DSH_PROFILE_DIR%/data/dsh-todolist/todos.json，結構示例：

{
  "version": 1,
  "todos": [ { "id": "t_...", "title": "交週報", "dueDate": "2026-10-22", "done": false } ],
  "notes": [ { "id": "n_...", "text": "週五帶門禁卡" } ]
}

文件損壞時會備份爲 todos.corrupt-<時間戳>.json 並以空清單啓動。注意：notes 爲 0.3.x 頂層字段；若回退到 0.2.x 再改待辦，舊版本寫盤可能丟失便籤，回退前應複製 todos.json。

典型交互包括：在面板中分組瀏覽與勾選；在日曆格點選某天排期；對話中說「每週一到週五 18 點交日報」，由 agent 通過 personal_todo 的 repeat 創建循環任務；便籤用 personal_note add 寫入同文件中的 notes。

適用場景與注意¶

適合需要在 DSH Web 側欄固定入口、又不想把待辦綁死在單一 SaaS 的用戶：數據在 profile 目錄，便於備份與 diff。agent 開發者可在同一 JSON 上實現「對話建任務、面板確認」的閉環。

安裝前建議自行查看 GitHub 源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，讀寫 profile 下數據文件；不 import @deepseek-ai/* 包，依賴宿主運行時契約（側欄槽位、HTTP 路由、工具註冊等）。升級宿主後 README 建議順序：重載插件（關再開）→ 側欄打開「待辦」→ 讓 agent 調用一次 personal_todo list。

DSH 生態理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文介紹的是社區維護的客戶端插件，而非官方應用商店條目。

結尾¶

dsh-sidebar-todo 把側欄入口、主面板（清單、日曆、分類、便籤、篩選）與本機 todos.json 綁在一起，並通過 personal_todo / personal_note 暴露給 agent。若要安裝或看變更記錄，可訪問目錄頁 https://www.skillhub.cn/plugins/Natte/dsh-sidebar-todo 與倉庫 https://github.com/Natte/dsh-sidebar-todo（含 CHANGELOG 與測試說明）。