前言¶
在 DeepSeek Harness (DSH) 的 Web GUI 環境中，開發者經常需要將本地文件的內容直接傳遞給智能體。如果通過 API 接口操作，通常需要搭建服務端來處理文件上傳；而直接複製粘貼文本又效率低下且容易出錯。dsh-paperclip 插件解決了這一痛點，它通過在 Web GUI 輸入框中增加文件處理能力，讓文件內容可以直接注入到對話上下文中。
插件介紹¶
該插件由用戶 zmm863-commits 維護，是一個開源的客戶端插件。其核心功能是在 DSH Web GUI 的文本輸入框右側添加一個回形針圖標按鈕。用戶可以通過點擊按鈕選擇文件，或者直接將文件拖拽至輸入框區域，文件內容會自動提取並插入到文本框中，方便後續發送給 agent 處理。
核心功能¶
- 操作方式：支持點擊輸入框右側的回形針按鈕打開文件選擇器，也支持直接將文件拖拽進輸入框。
- 文件格式：支持常見文本和代碼格式，包括 HTML、JS、TS、CSS、JSON、MD、Python 等 30+ 種擴展名。
- 批量上傳：支持多文件批量上傳，限制爲最多 10 個文件，單個文件大小不超過 5MB。
- 技術實現：完全在瀏覽器端運行，不依賴任何服務端，確保數據隱私安全。
安裝與啓用¶
安裝該插件需要使用 DSH 的命令行工具。請確保你的環境已配置好插件管理工具。
dsh plugin --profile web add dsh-paperclip
安裝完成後，刷新 DSH Web GUI 頁面即可生效。插件基於 MIT 許可證開源，建議在安裝前檢查源碼與許可證。
典型用法¶
- 刷新頁面：在安裝插件後，刷新 Web GUI 頁面，輸入框右側會出現回形針圖標。
- 選擇或拖拽：點擊回形針按鈕選擇文件，或者直接將文件拖拽到輸入框區域。
- 查看插入結果：文件內容會以代碼塊格式插入到輸入框中，通常顯示爲
📄 文件名 (大小)的格式。 - 發送消息：插入完成後，直接發送消息，agent 即可讀取文件內容進行後續操作。
適用場景¶
該插件適用於需要在 Web GUI 中快速分享代碼片段、配置文件或文本內容的場景。由於它是純前端實現，不需要額外的後端服務，適合對數據隱私有要求的開發環境。使用時需注意批量上傳的文件數量與大小限制。
