前言¶
在使用 DeepSeek Harness (DSH) 時，長會話中的任務排隊、執行被打斷以及會話重啓是常見場景。指令發出後，如果 Agent 正在忙，或者用戶臨時插隊，原任務的上下文容易丟失。dsh-memo-notebook 插件旨在解決這一問題，它按工作區記錄未完成的任務，自動捕獲排隊或執行中的用戶指令，並將狀態持久化到磁盤，支持插隊打斷與一鍵按原狀態恢復。
核心功能¶
自動捕獲與狀態流轉
插件會自動捕獲發給助手的新指令並進入備忘錄。任務狀態會自動流轉：排隊 → 進行中 → 已完成（Agent 正常結束自動標記）。支持通過 SSE 實時推送狀態變化。
插隊與恢復機制
當有新消息插入隊列時，舊任務會被標記爲「打斷」，並記錄其 previousStatus（原狀態）。用戶可以通過「恢復」按鈕，將任務按原狀態（排隊或進行中）重新執行。
任務管理
支持劃線完成（保留記錄）與一鍵刪除。勾選多條目後，可進行批量完成、刪除或恢復操作。
面板交互
面板固定在側欄之上，支持拖動與位置記憶。提供狀態分類篩選（全部 / 排隊 / 正在進行 / 提問 / 失敗 / 打斷 / 已完成）。
數據持久化
數據以 UTF-8 編碼同步寫入磁盤。默認路徑爲 ~/.dsh/memo-notebook/state。停止或重啓 web 服務不會丟失數據。
安裝¶
安裝前需確保已安裝 DeepSeek Harness (dsh) 並能訪問 GitHub。
- 執行安裝命令：
dsh plugin add SeanWang114514/dsh-memo-notebook --profile web
- 重啓
dsh web以加載 Host 端邏輯。 - 刷新瀏覽器，右下角會出現 📝 圖標。
使用方法¶
UI 操作
點擊右下角 📝 圖標打開面板。在輸入框輸入任務並回車即可入隊。點擊條目左側圓圈可多選，隨後使用頂部工具欄進行批量操作。
API 調用
也可以通過 API 添加任務或恢復任務：
# 添加任務
curl -X POST http://127.0.0.1:3080/api/memo/add -H "Content-Type: application/json" -d '{"text": "幫我寫週報"}'
# 恢復任務
curl -X POST http://127.0.0.1:3080/api/memo/resume -H "Content-Type: application/json" -d '{"id": "task-id"}'
配置與存儲¶
默認持久化文件位於 ~/.dsh/memo-notebook/state。插件通過同步寫入確保數據安全。安裝後可通過 dsh --profile web --dump-config 檢查 memo-notebook 配置項。
總結¶
dsh-memo-notebook 通過持久化與狀態機管理，解決了 DSH Agent 工作流中上下文丟失的問題。開發者可以直接通過插件面板或 API 管理任務，適合需要長時間運行、頻繁交互的 Agent 場景。
- GitHub 倉庫：https://github.com/SeanWang114514/dsh-memo-notebook
- 維護者：SeanWang114514
