前言¶
用 DeepSeek Harness（DSH）跑對話或開發任務時，臨時待辦往往散在筆記、終端或別的窗口裏，切出去記一筆再回來，容易打斷節奏。系統自帶的提醒類工具通常也不掛在 DSH 窗口上。下面介紹社區插件 dsh-todo-widget：在 DSH 界面右側提供可拖動的懸浮按鈕和待辦面板，數據只寫本機，不依賴外網同步。
這是什麼¶
dsh-todo-widget 由維護者 duoemma 發佈，歸類爲 DSH 客戶端插件（當前 package.json 版本爲 0.2.0，MIT 許可證）。它把待辦釘在 DSH 邊上：右側圓形懸浮按鈕 + 可調磨砂強度的面板，想記什麼點開即可，不必切換到其他應用。
插件目錄頁：https://www.skillhub.cn/plugins/duoemma/dsh-todo-widget
源碼與說明：https://github.com/duoemma/dsh-todo-widget
SkillHub 等社區目錄與 DeepSeek / 幻方無官方從屬關係；DSH 生態按「一切皆插件」擴展，安裝前請自行查看源碼與許可證。
核心功能¶
以下能力均來自項目 README，安裝後以實際界面爲準。
- 懸浮入口：圓形按鈕可拖到任意位置，位置會被記住；角標顯示未完成數量。
- 列表操作：回車添加；勾選完成；雙擊改名；拖動排序。
- 篩選與清理：全部 / 未完成 / 已完成三種篩選；支持一鍵清除已完成項。
- 外觀：磨砂玻璃面板，強度 0–100% 可調；深色、淺色主題自動適配。
- 本地數據：不聯網、不上傳；宿主端與瀏覽器側各有一份存儲，按寫入時間取較新的一份，宿主接口不可用時退化爲純本地模式。
面板寬 332px，高度不超過視口 60%，列表區可滾動。
安裝與啓用¶
從 GitHub 安裝（官方 README 命令，需使用 desktop profile）：
dsh plugin --profile desktop add github:duoemma/dsh-todo-widget
安裝後重啓一次 DSH。
本地開發或離線環境可用倉庫內的腳本：
powershell -NoProfile -ExecutionPolicy Bypass -File install-plugin.ps1
卸載：
powershell -NoProfile -ExecutionPolicy Bypass -File install-plugin.ps1 -Uninstall
插件在 DSH 進程權限下運行，安裝前建議通讀倉庫代碼與 MIT 許可證條款。
典型用法¶
- 點界面右側圓形按鈕展開待辦面板，按
Esc關閉。 - 在輸入框回車添加條目；勾選標記完成；雙擊條目改名；拖動調整順序。
- 使用面板內的篩選切換「全部 / 未完成 / 已完成」；需要時一鍵清除已完成。
- 點右上角
◐打開磨砂強度滑桿，拖動即時生效（默認 82，範圍 0–100）。
若需改存儲目錄，可設置環境變量 DSH_TODO_STORE_DIR（默認 ~/.dsh/todo-widget）。主數據文件爲 ~/.dsh/todo-widget/todos.json；瀏覽器側副本在 localStorage["dsh-todo-widget:state"]，供宿主接口不可用時的兜底。
適用場景與注意¶
適合：長時間開着 DSH desktop profile、希望在同一窗口內維護短待辦清單的開發者或智能體使用者；對數據出境、雲端同步無需求、只要本機持久化的場景。
注意：
- 安裝命令帶
--profile desktop，與 README 一致；其他 profile 是否支持需自行驗證。 - 數據僅存本機，換機器或清目錄前請自行備份
todos.json。 - 從 GitHub 安裝使用的是倉庫已提交的
client/構建產物；若 fork 後改src/，需本地執行node build.mjs並一併提交client/。 - 掛件支持自更新：服務端構建號變化後，頁面會在約 45 秒內切換到新版本。
結尾¶
dsh-todo-widget 把待辦收進 DSH 右側：懸浮按鈕、磨砂可調面板、本地 JSON 存儲，適合不想爲幾條任務另開應用的用戶。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
