前言¶
在開發基於 DeepSeek Harness (DSH) 的智能體應用時，頻繁的複製粘貼操作容易導致歷史內容丟失，或需要回溯之前的文本片段。dsh-clipboard-history 插件解決了這一痛點。它持續監控系統的剪貼板，將複製過的內容按時間順序存入持久化文件，並提供 Web 面板與 Agent 工具供調用。
插件定位¶
該插件屬於 DSH 生態的「記憶」分類，由開發者 qqyumidi 維護。它是一個功能等價的動態與靜態插件，核心價值在於將系統剪貼板轉化爲可檢索、可管理的結構化歷史記錄。
核心功能¶
- 系統剪貼板監控
支持 macOS (pbpaste/pbcopy)、Linux (xclip/wl-paste) 以及 Windows PowerShell。 - 持久化存儲
歷史記錄上限爲 500 條，超出後自動丟棄最舊的記錄。數據存儲在~/.dsh/clipboard-history。 - Web 面板操作
通過會話標題欄的「📋 剪貼板」按鈕打開。支持搜索過濾、單條複製回系統、刪除單條、暫停/恢復監聽以及清空歷史。 - Agent 工具註冊
爲模型註冊了四個工具接口：
-clipboard_get：讀取當前剪貼板內容
-clipboard_history_search：搜索歷史記錄
-clipboard_copy：將內容寫入剪貼板
-clipboard_history_delete：按 ID 刪除歷史記錄
安裝與啓用¶
通過官方命令安裝，並重啓 Web 服務以使配置生效。
dsh plugin --profile web add github:qqyumidi/dsh-clipboard-history
dsh web
典型用法¶
- Web 端操作：點擊會話標題欄右側的「📋 剪貼板」按鈕打開面板，在搜索框輸入關鍵詞過濾，點擊條目即可複製，或點擊「🗑 刪除」移除單條。
- Agent 端操作：直接調用
clipboard_get工具獲取當前剪貼板內容，或使用clipboard_history_search查詢歷史記錄。
技術細節¶
- 通信機制：Host 與 Client 通過 HTTP 端點
/clipboard-api/*進行通信。 - 輪詢間隔：插件以 1.5 秒爲間隔輪詢系統剪貼板變化。
- 文件結構：靜態版與動態版功能等價，歷史文件路徑爲
~/.dsh/clipboard-history。
注意事項¶
- 本插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證（MIT）。
- 歷史記錄上限爲 500 條，舊記錄會被自動覆蓋。
結語¶
該插件通過將系統剪貼板本地化與結構化，降低了智能體開發中管理文本歷史的門檻。更多細節可參考 GitHub 倉庫。
