前言¶
在 DSH 的插件式工作流裏，臨時想法經常卡在“記下來”和“真正處理”之間。dsh-localnote 針對這個環節做了固定：先在瀏覽器浮窗裏隨手記錄，再設置到期時間；到點後，插件可以只提醒，也可以由一次性 agent 把靈感展開成結果並回寫。下面介紹它的定位、安裝和可用命令。
這是什麼¶
dsh-localnote 是一個 DSH host 端插件，維護者爲 253071608，許可證爲 MIT。它安裝在 web 配置檔中，提供瀏覽器浮窗記錄、本地持久化、REST 接口、定時掃描和一次性 agent 執行。適合需要把“以後再說”變成可追蹤任務的人。
核心功能¶
- 隨手記錄：右上角浮窗新建一條靈感，一條包含標題、詳情和截圖圖片；詳情支持粘貼。
- 定時回訪：給任意靈感設置到期時間和到點動作，到點由插件自動接管。
- 到點執行：AI 可把靈感展開爲理解、要點拆解、下一步可執行動作，並回寫結果。
- 僅提醒：到點只彈通知，不消耗模型。
- 雙通道提醒：頁面浮窗 toast 與後臺系統通知；localStorage 去重，避免刷新後重復提醒。
- 狀態可見：列表即時顯示倒計時、已執行、出錯狀態；詳情頁查看任務執行報告。
- host 端能力：提供 REST 路由、定時掃描、一次性 agent 執行和本地持久化。
安裝與啓用¶
先克隆代碼，再進入 DSH checkout 根目錄安裝。dsh 不是全局命令，必須在 DSH checkout 根目錄運行 pnpm dsh。
# 1. 克隆代碼（把 <倉庫地址> 換成實際倉庫地址）
git clone <倉庫地址> /path/to/dsh-localnote
# 2. 本地安裝（dsh 會把本地目錄作爲依賴裝進 ~/.dsh/profiles/web/ 並加進 bundles）
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/dsh-localnote
安裝後，插件會裝入 web 配置檔。如果改動了 host 端 index.js，需要重啓 DSH。
典型用法¶
經過上面的步驟並啓動 DSH 後，可以先查詢靈感列表：
curl http://127.0.0.1:3080/dsh-localnote/notes
新建一條靈感：
curl -X POST http://127.0.0.1:3080/dsh-localnote/notes \
-H 'content-type: application/json' \
-d '{"text":"你好"}'
查看統計：
curl http://127.0.0.1:3080/dsh-localnote/stats
設置或取消定時時，調用以下路由：
PATCH /dsh-localnote/notes/schedule
參數包括時間、動作和模型。執行到點任務時，任務執行需要 {{cwd}} 有效；插件已內置當前用戶家目錄。
卸載插件：
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web remove /path/to/dsh-localnote
卸載隻影響插件裝載，不會刪除數據。靈感保存在 ~/.localnote/state.json，圖片保存在 ~/.localnote/images/。如需徹底清除數據：
rm -rf ~/.localnote
適用場景與注意¶
適合這類場景：
- 在瀏覽器中產生臨時想法，希望先記錄再處理；
- 到點只提醒，不消耗模型；
- 到點由 AI 生成結構化結果，並回寫到靈感條目；
- 需要本地文件保存，並通過簡單 REST 接口查看或調試。
使用前注意：
- 插件以當前 dsh 進程權限運行，會寫入
~/.dsh/profiles/web/與~/.localnote；安裝前應檢查源碼與 MIT 許可證。 - 定時掃描每 30 秒檢查到期靈感，觸發一次後標記
fired，以避免重複。 - 到點執行會走一次性 agent；僅提醒模式不消耗模型。
- 目錄頁和 GitHub 鏈接屬於插件線索，倉庫地址在不同資料中可能有差異，使用前請覈對實際倉庫。
結尾¶
dsh-localnote 提供了一個本地、可追蹤的延後處理入口：記錄、定時、提醒或執行，最後回寫結果。適合放進 DSH 日常流程裏，處理那些“現在不展開，但後面必須想清楚”的靈感。
相關鏈接（均來自插件線索）：
