在 DeepSeek Harness（DSH）的 Web 交互場景中，附件上傳通常依賴拖拽文件或粘貼剪貼板。這種方式在桌面端尚可，但在移動端或特定交互場景下不夠直觀。dsh-attach-picker 插件通過在輸入欄工具欄中增加一個圖片按鈕，允許用戶直接通過系統原生的文件對話框選擇圖片，繞過拖拽或粘貼的操作限制。
插件介紹¶
該插件由開發者 qwerty-k-de 維護。它是一個零依賴的瀏覽器端插件，主要作用是在 DSH Web 的對話輸入工具欄中增加一個圖片按鈕。點擊後調用操作系統原生的文件選擇器，支持多選，並自動過濾出支持的圖片格式。
核心功能¶
- 工具欄集成：在輸入欄工具欄中增加一個圖片圖標按鈕（插槽
conversation.input.left），點擊即可觸發文件選擇。 - 原生文件選擇：使用操作系統原生的文件對話框，支持多選，僅顯示支持的圖片格式。
- 限制校驗：嚴格遵守主機的
imageLimits配置（支持的格式、單條消息最大圖片數、單張圖片最大字節），超出時會通過內聯提示報錯（例如提示單張圖片不能超過 X MB）。 - 統一管道：複用 DSH 現有的草稿-附件管道，與拖拽和粘貼的行爲一致，無需額外處理。
- 兼容性：支持 DSH 0.1.x 和 0.2.x，根據運行時的管道版本自動適配。
- 輕量化：純瀏覽器端實現，零運行時依賴。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add dsh-attach-picker
安裝後，重啓 dsh web 或刷新頁面即可生效。
典型用法¶
- 在 DSH Web 中打開一個對話窗口。
- 在輸入欄工具欄中找到圖片按鈕並點擊。
- 操作系統彈出文件選擇對話框，選中一張或多張圖片。
- 圖片將出現在下方的草稿附件欄中，發送消息時一同上傳。
適用場景與注意¶
- 適用場景：當用戶習慣通過點擊選擇文件而非拖拽，或在移動設備上操作時，該插件能顯著提升體驗。
- 注意：該插件僅運行在瀏覽器端。使用前需確保 DSH Web 進程已啓動，且加載了標準的會話/插槽客戶端服務。當有請求正在處理時，按鈕會自動禁用以防止狀態衝突。請查閱源碼確認許可證符合項目需求。
總結¶
dsh-attach-picker 通過複用現有的附件管道，提供了一個更符合用戶直覺的圖片上傳入口，減少了不必要的操作步驟。更多細節及源碼可查閱其 GitHub 倉庫。
