前言¶
在 DeepSeek Harness（DSH）裏做日常開發或運維時，任務往往分散在筆記、聊天和外部待辦工具之間；DSH 側若缺少與桌面同屏的提醒，循環事項（工作日例會、每月報表）更難靠記憶對齊。社區插件 dsh-todos-diy 把待辦、調度與提醒收進 DSH 側邊欄：數據落在本機 $DSH_HOME，提醒以頁面浮層爲主，可選系統通知，不接入 Agent 會話。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-todos-diy（包名與客戶端 bundle id 均爲 dsh-todos-diy）由維護者 huningsong 發佈，在 SkillHub 插件目錄 分類爲工作流。當前 README 標明版本 0.7.0（schemaVersion 4），許可 MIT。
一句話定位：面向 DSH 的工作待辦提醒插件——支持單次與循環（工作日 / 每週 / 每月 / 自定義 cron），主面板四階段視圖加循環、暫停獨立篩選；優先級與階段按當前時間實時派生；單次任務可選開始、必填結束時間；提醒經 shell.overlay 浮層展示，並可在設置中打開桌面系統通知。0.7.0 還包含自然語言快速添加（F10）、週報與月報（F11）等能力（見倉庫 CHANGELOG 與版本規劃文檔）。
宿主側不引入 @deepseek-ai/* 運行時依賴，僅使用 Node 內建模塊；客戶端只 require('react')。引擎要求 DSH ^0.2.1-rc.3（package.json 中 engines.dsh）。
核心功能¶
任務模型（0.2.0 起 D-25）¶
- 已刪除字段
dueDate。單次任務：startAt可省略（默認創建時刻、默認不產生開始提醒），endAt必填且爲唯一截止；endAt到達不會自動標記完成。 - 階段
stage讀時派生，不再依賴每日定點重算。主面板頁籤：未開始 / 進行中 / 已超期 / 已完成；循環與暫停單獨篩選，不混入上述階段頁籤（暫停 = 主動擱置，不算超期、不參與優先級）。 - 優先級只讀、不落盤：24 小時內到期或已超期爲高，3 天內爲中，7 天內爲低，更遠或無結束時間爲無；循環任務按
nextAt等規則參與計算（見 README「使用」表）。
循環與調度¶
- 循環類型：工作日、每週、每月、自定義 cron。
- 工作日跟隨中國法定節假日與調休（內置 2024–2027 靜態表）；月末不存在日期順延到當月最後一天。
- 自研輕量調度（P0 決策 D-01，不依賴內置
ctx.schedule）；錯過觸發 5 分鐘內補一次，超過則標missed不補發。 - 單次任務默認起止都提醒；
startAt省略時只提醒結束；會議類可關結束提醒（D-03）。
列表與交互¶
- 完成：行首圓圈；置頂 hover 行尾 📎（超期仍置頂，D-21）；暫停 hover ⏸。
- 本季度已完成留在「已完成」頁籤；更早季度在「歷史歸檔」；主文件只保留本季度已完成，跨季度寫入
$DSH_HOME/dsh-todos-diy/archive/completed-YYYY-Qn.json（D-24）。 - 快捷鍵：
N新建、/搜索、Esc關閉、↑/↓移動、Enter打開、Space完成。
提醒與統計¶
- 提醒以 DSH
shell.overlay頁面浮層呈現；0.7.0 支持桌面系統通知全局開關（見 0.7.0 版本規劃）。 - 統計提供六類互斥計數、
byKind與totalDone等（README 概述）。
明確不在 v1 範圍¶
多用戶/多設備同步、節假日表在線更新、任務模板、批量操作、日曆視圖、ICS 導出、未確認重複提醒、接入 Agent 會話等——README「不在本包範圍」一節有完整列表。
安裝與啓用¶
安裝命令須使用倉庫 README 原文，不要用未文檔化的 dsh plugin add github:... 拼接。
從 GitHub（SSH，避免 github: 簡寫走 HTTPS 預檢超時）：
plugin_manager install_bundle target=git@github.com:huningsong/dsh-todos-diy.git
從本地開發目錄：
plugin_manager install_bundle target=<本倉庫的絕對路徑>
安裝後重啓 DSH。側邊欄應出現「工作待辦」入口。健康檢查：
GET /api/dsh-todos-diy/health
期望載荷中 scheduler.running=true（README 安裝節說明）。
npm 發佈安裝路徑在 README 中僅描述維護者 npm publish 流程，未給出最終用戶一條式命令；若你從 npm 源安裝，以該源上的包說明爲準。
典型用法¶
- 打開側邊欄「工作待辦」，右上角「新建任務」。
- 選擇循環（工作日 / 每週 / 每月 / cron）或單次（開始可留空，結束必填）。
- 到點後在 DSH 內查看提醒浮層；若已在設置中開啓，可同時收到系統通知。
- 需要回顧時切換四階段頁籤，或用「循環 / 暫停」篩選；查更早完成記錄在「歷史歸檔」。
- 設置頁可配置時區、免打擾、提醒通道、導入導出等（具體字段以面板與
docs/requirements/需求-v1.md爲準）。
HTTP API 前綴爲 /api/dsh-todos-diy；持久化文件爲 $DSH_HOME/dsh-todos-diy/tasks.json（單 JSON 原子寫）。
適用場景與注意¶
適合：已在 DSH 桌面環境中工作、希望待辦與提醒同屏、且接受本機 JSON 存儲（無 v1 多設備同步）的個人或小團隊。
務必注意：
- 插件在 當前 DSH 進程權限下運行，可讀寫
$DSH_HOME下插件目錄並註冊 HTTP 路由；安裝前應閱讀 GitHub 源碼 與 MIT 許可證，自行評估是否滿足環境策略。 - SkillHub 目錄頁星標等社區指標可能與 GitHub 不同步；功能與版本以倉庫 README、
CHANGELOG.md爲準。 - DSH 社區目錄（SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；非官方應用商店。
結尾¶
dsh-todos-diy 把循環規則、派生優先級、四階段視圖與浮層提醒收進 DSH 工作流分類，適合作爲本機工作待辦底座。進一步需求與決策編號（D-01…D-25）見倉庫 docs/decisions/待討論-缺口清單.md 與 docs/requirements/需求-v1.md。
