dsh-clipboard：零依賴寫入系統剪貼板

在開發智能體工作流時，Agent 生成的內容往往需要用戶手動複製粘貼。dsh-clipboard 解決了這個問題，允許 Agent 直接把結果寫入系統剪貼板，用戶無需選中，直接粘貼即可使用。

插件簡介¶

這是一個由 ZhijiangTang 維護的 DSH 插件。它註冊了一個名爲 clipboard_write 的工具，核心特點是零依賴、純 ESM JavaScript、無需構建。

核心功能¶

• 跨平臺支持：支持 macOS、Windows 和 Linux 系統。
• 規範返回：執行結果始終返回規範 JSON。包含 ok（布爾值）、bytes（寫入字節數）、tool（使用的系統工具名稱）和 error（僅在失敗時出現）字段。任何失敗都不會拋異常。
• 自動自檢：插件掛載時會自動寫入一次自檢文本，日誌前綴爲 [dsh-clipboard]。

安裝與啓用¶

通過 DSH 官方命令安裝：

dsh plugin --profile <profile-name> add dsh-clipboard

典型用法¶

Agent 生成一行命令、SQL、JSON 或代碼片段後，調用 clipboard_write。用戶無需手動選中，直接粘貼即可使用。

返回示例：

{ "ok": true,  "bytes": 42, "tool": "pbcopy" }
{ "ok": false, "bytes": 42, "tool": null, "error": "no clipboard tool available (install xclip or xsel): ..." }

適用場景與注意事項¶

• 適用場景：
  • 讓 Agent 把生成的命令、SQL、JSON、代碼片段直接放進剪貼板。
  • 複製臨時 token、URL 或文件路徑。
  • 作爲多步工作流裏的“交接輸出”步驟。
• 注意事項：
  • Linux 環境要求：需要可用的 X11 或 Wayland 會話（環境變量 DISPLAY 或 WAYLAND_DISPLAY）。在純 SSH 會話或 CI 容器中會寫入失敗。
  • 系統依賴：依賴系統自帶或安裝的 pbcopy（macOS）、clip（Windows）、xclip 或 xsel（Linux）。

總結¶

這個插件通過極簡的依賴和規範的數據返回，降低了智能體與外部系統的交互成本。安裝前建議檢查源碼與許可證。源碼與文檔可查看 GitHub。