dsh-image-picker: DeepSeek Harness Web GUI 附件選擇插件

在 DeepSeek Harness Web GUI 的使用中，直接通過瀏覽器交互添加非圖片文件較爲困難，且存在路徑獲取限制。dsh-image-picker 插件在輸入框左側增加了一個文件選擇入口，通過系統文件選擇器規範了附件的注入流程。

插件介紹¶

該插件由 liujia-io 維護，旨在解決純前端環境下無法獲取文件絕對路徑的問題，並提供統一的附件處理能力。它通過在會話輸入框左側添加一個按鈕，允許用戶通過系統文件選擇器添加圖片或文本類附件。

核心功能¶

1. 圖片處理：圖片通過合成 drop 注入官方附件管線，支持縮略圖展示、數量與大小校驗。
2. 文本處理：文本文件（.txt, .md, .docx）由瀏覽器讀取後 POST 到本地服務端暫存，消息中僅插入包含路徑和預覽的回執。
3. 文件解析：支持 .docx 文件的解析，通過瀏覽器內的 ZIP 解析提取正文內容。
4. 安全護欄：單文件容量限制爲 25MB，超出返回 413 錯誤；自動清洗文件名並加時間戳前綴。
5. 容錯機制：若暫存接口不可用，自動回退爲全文內聯（單文件 3 萬字符截斷）。

安裝與啓用¶

使用官方安裝命令添加插件：

dsh plugin --profile web add github:liujia-io/dsh-image-picker

安裝後需重啓 DSH Web 進程以生效。

使用方法¶

1. 點擊輸入框左側的按鈕，調用系統文件選擇器。
2. 選中文件後，文件會被自動處理：
   - 圖片：自動注入官方 ComposerAttachments 接口，隨消息上傳。
   - 文本：落盤至 ~/.dsh/picker-attachments/ 目錄，輸入框插入回執信息（包含保存路徑、字符數和預覽）。
3. Agent 可以通過讀取工具按需訪問本地暫存的文本文件。

注意事項¶

• 瀏覽器安全策略限制無法直接獲取文件絕對路徑，因此文本文件採用服務端暫存方式。
• 單文件容量上限爲 25MB，超出會返回 413 錯誤。
• 文本類附件的正文內容不進入會話上下文，Agent 需使用工具讀取。
• 插件依賴官方 ComposerAttachments 接口和 host 殼環境。
• 暫存目錄固定爲 ~/.dsh/picker-attachments/。

結尾¶

該插件通過本地暫存和官方管線複用，解決了 DSH Web 環境下的文件輸入限制問題，提升了附件交互的穩定性。更多信息請參考插件目錄或源碼倉庫。