前言¶
在 DSH 裏開發或日常使用智能體時，待辦往往散落在聊天窗口、記事本或瀏覽器標籤裏。要寫成「有時間、地點、事項和要求」的結構化條目，通常得自己拆句，或再開一個帶獨立 API key 的解析服務。 dsh-todo-note（倉庫 Ivan-unb/Ivan-nb）把一張貼在 Windows 桌面上的便籤卡片和 DSH 宿主側的模型解析接在一起：粘貼一整段文字、回車，由你已在 Harness 裏配置好的模型拆成多條待辦，數據落在本機 JSON，不依賴雲端賬號。下面介紹它是什麼、怎麼裝、怎麼用，以及和 DSH 進程之間的協作方式。
這是什麼¶
dsh-todo-note 是維護者 Ivan-unb 發佈的 DeepSeek Harness 插件（package.json 中版本 0.1.0，許可證 MIT）。定位是：Windows 上的便籤式待辦應用；解析步驟使用 DSH 中已配置的模型（README 說明只需 agentDefaultModel 能取到即可），無需額外 API key，也不會把文字發往插件作者以外的第三方服務（若你用的是完全本地模型，則拆句也不出本機）。
界面由獨立的 PowerShell + WPF 進程承載，與 DSH 主進程無父子關係；插件側在 DSH 宿主裏負責讀寫在數據目錄中的交接文件並調用模型，桌面卡片負責展示與編輯 todos.json。
社區目錄頁：skillhub.cn/plugins/Ivan-unb/Ivan-nb。DSH 生態強調「一切皆插件」；該目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
界面與核心能力¶
摺疊態爲寬約 300 像素的桌面卡片，無需點開系統菜單即可使用：
- 頂部輸入框：粘貼一整段文字，回車提交；
- 未完成項按時間排序展示，最多 6 條，超出顯示「還有 N 條」；
- 左側勾選表示完成（灰顯、劃線並沉底），右側
×刪除； - 「要求 · …」與「還有 N 條要求」可展開查看全部要求。
點右上角 ▦ 可展開大面板，提供「列表 / 月曆」兩種視圖；月曆中可按日查看或添加安排。提交後會先出現確認條，點保存才寫入數據庫，拆句有誤可在該步取消，避免污染列表。
其他已文檔化的能力包括：展開列表中點擊標題就地修改；拖標題欄記住位置；右鍵更換背景配色（carbon / ocean / forest / dusk / paper）；右鍵導出 JSON。
與 DSH 如何協作¶
卡片與 DSH 通過數據目錄中的文件交接，互不改寫對方文件，因此無需文件鎖：
卡片 ──寫 request.json──▶ 數據目錄 ◀──讀── DSH 宿主（調模型拆句）
卡片 ◀──讀 result.json─── 數據目錄 ◀──寫── DSH 宿主
DSH 未運行時仍可記錄待辦，但無法拆句：文字會排隊，待 DSH 啓動後自動補拆。待辦本體保存在 todos.json，爲普通 JSON，便於其他程序讀取。
環境與前提¶
- Windows 10 / 11；
- PowerShell 5.1（系統自帶）；
- 已安裝 DeepSeek Harness，並配置過可用模型。
插件以當前 dsh 進程權限 運行；安裝前建議通讀倉庫源碼並確認 MIT 許可證是否符合你的合規要求。
安裝與啓用¶
1. 安裝插件本體¶
在終端執行（命令來自倉庫 README）：
dsh plugin --profile <你的 profile> add git+https://github.com/Ivan-unb/Ivan-nb.git
安裝後需 重啓 DSH，宿主側不支持熱更新。
2. 安裝桌面卡片¶
在倉庫根目錄執行：
powershell -ExecutionPolicy Bypass -File install.ps1
腳本會註冊登錄時自動運行的計劃任務、在桌面創建快捷方式，並立即啓動卡片；重複執行是安全的。README 說明：從其他進程拉起的窗口可能被作業對象綁定，DSH 退出時窗口會被回收，故桌面端由任務計劃程序啓動，與 DSH 生命週期解耦。
典型用法¶
| 想做什麼 | 怎麼做 |
|---|---|
| 加一條 | 粘貼一整段，回車；在確認條中勾選要保留的項、改正文字，保存 |
| 做完 | 點左側勾選框 |
| 刪掉 | 點最右側 × |
| 改標題 | 展開列表後點標題就地編輯，回車或點別處保存 |
| 換位置 | 拖標題欄 |
| 換配色 | 右鍵 → 背景色 → 選擇主題 |
| 導出 | 右鍵 → 導出爲 JSON |
| 看月曆 | 展開面板，切換到「月曆」，點選日期查看或添加 |
數據目錄與隱私¶
默認路徑爲 %USERPROFILE%\.dsh\todo-note\；若設置了環境變量 DSH_HOME，則爲 %DSH_HOME%\todo-note\。
| 文件 | 內容 |
|---|---|
todos.json |
待辦本體 |
window.json |
窗口位置、配色 |
request.json / result.json |
卡片與 DSH 之間的交接 |
run.log / diag.log |
排障時優先查看 |
待辦僅存本機上述目錄；無賬號與雲端同步。僅用戶粘貼的那段文字會送入 DSH 內配置的模型進行拆句。
卸載¶
桌面端：
powershell -ExecutionPolicy Bypass -File uninstall.ps1
腳本會停止卡片、移除計劃任務與快捷方式，默認保留數據；腳本末尾會給出徹底刪除數據的命令說明。
插件本體：
dsh plugin --profile <profile> remove dsh-todo-note
適用場景與限制¶
適合需要在 Windows 桌面上常駐待辦、又希望複用 DSH 已有模型做中文拆句的用戶。README 記載的 已知限制 包括：僅支持 Windows（WPF）；主要保證中文識別，中英混排不承諾準確；無提醒/通知；無跨設備同步；DSH 未開啓時新粘貼內容需排隊等待拆句。
維護者還在 README 中提示修改腳本時的編碼問題：.ps1 須帶 UTF-8 BOM（PowerShell 5.1 無 BOM 時中文註釋可能導致語法錯誤）；.vbs 中不宜使用中文註釋。
結尾¶
dsh-todo-note 把桌面便籤與 DSH 模型拆句並用文件目錄解耦，在本機完成「一段話 → 多條結構化待辦」的閉環。進一步瞭解可從社區目錄 skillhub.cn/plugins/Ivan-unb/Ivan-nb 進入，源碼與完整說明見 github.com/Ivan-unb/Ivan-nb。
