前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在開發智能體或調試代碼時，開發者經常需要將本地文件、代碼片段或日誌文件作爲上下文傳遞給模型。DSH Drop 插件通過在 Web 和桌面客戶端中增加拖放與預覽功能，解決了輸入框附件體驗有限的問題。
核心功能¶
DSH Drop 主要提供以下能力：
- 拖放與粘貼支持：支持將文件或文件夾直接拖入 DeepSeek Harness 的 Web 頁面或桌面應用，也支持粘貼剪貼板中的文件。
- 統一預覽欄：圖片和文件共享一個預覽欄，便於統一管理。
- 按需添加引用：文件路徑僅在發送消息時才被附加到輸入框，保持草稿整潔。
- 原生附件支持：支持 PNG、JPEG、WebP、GIF 等圖片作爲原生附件。
- 文件與文件夾引用：支持 PDF、視頻、音頻、文本文件引用，以及文件夾引用（格式爲
@path/to/folder/）。 - 互補 DSH Viewer：該插件補充了 DSH Viewer，後者負責將文件內容從模型端展示給用戶。
安裝與啓用¶
Web 環境¶
Web 環境下，該插件依賴系統 PATH 中的 pnpm，且 Node 版本需爲 22 或 24。安裝預編譯的 tarball 包後需重啓 Web 側：
dsh plugin --profile web add https://github.com/Crosery/dsh-drop/releases/latest/download/dsh-drop.tgz
桌面應用¶
在桌面應用中，無法使用命令行安裝，需通過圖形界面操作：
- 打開應用菜單，進入 Plugins → Add plugin。
- 粘貼發佈版下載 URL：
https://github.com/Crosery/dsh-drop/releases/latest/download/dsh-drop.tgz
- 重啓應用以加載插件。
典型用法¶
安裝完成後，可以按照以下步驟使用：
- 打開一個會話。
- 將文件或文件夾拖入頁面，或在頁面空白處粘貼。
- 在預覽欄中點擊卡片，可以預覽內容或移除該文件（拖放同一文件兩次只會添加一次）。
- 輸入請求文字，按下 Enter 或點擊發送按鈕。此時文件路徑會作爲引用（如
@path/to/file）被添加到消息中。
適用場景與注意¶
適用場景：適用於需要頻繁在對話中引用本地文件、日誌或代碼片段的開發者，以及希望保持輸入框整潔的用戶。
注意事項：
- Web 依賴：Web 環境必須安裝
pnpm且 Node 版本符合要求，否則無法安裝。 - 模型工具：該插件不會爲模型添加新的工具。非圖片文件會被轉換爲路徑引用（
@path），模型必須顯式調用工具才能讀取文件內容。 - 文件夾限制：文件夾引用受限於文件數量、總大小、單個文件大小上限以及嵌套深度。如果超出限制，上傳會被整體拒絕並提示。
- 重複安裝：如果本地已有對
@crosery/dsh-drop的補丁掛載，不要重複安裝。
總結¶
DSH Drop 通過提供統一的拖放體驗和預覽欄，簡化了文件在 DSH 中的輸入流程。它不改變模型的能力，而是優化了開發者與文件交互的交互方式。如需查看源碼或更多細節，可訪問 GitHub 倉庫。
