前言¶
在 DeepSeek Harness (DSH) 的開發流程中，將本地文件傳遞給模型通常需要手動複製文件路徑。本插件解決了這一痛點，允許用戶通過粘貼、拖放或選擇的方式將文件保存到當前 workspace，並自動插入相對路徑到輸入框。
插件介紹¶
該插件由 lhh666-6 維護，是一個 MIT 許可的開源插件。它通過在 DSH 的 composer 界面增加交互入口，實現文件的上傳與路徑注入。
核心功能¶
插件在 Host 面和 Client 面各承擔職責：
- Client 面交互：註冊到
conversation.input.leftslot，在 composer 左側增加“粘貼文件”按鈕，支持多選文件。同時監聽輸入框的粘貼、拖放和選擇文件事件。 - Host 面處理：註冊
/_dsh-paste-files/upload路由。接收到上傳請求後，根據sessionId從 SessionStore 讀取當前會話的cwd，將文件保存到當前 workspace 的pasted-files目錄下。 - 路徑插入：文件保存成功後，將相對路徑以行內代碼形式插入到輸入框草稿中。
安裝與啓用¶
使用 DSH 的 CLI 安裝：
dsh plugin --profile web add dsh-paste-files
dsh plugin --profile desktop add dsh-paste-files
安裝後重啓 DSH 或切換一次 profile 即可生效。
典型用法¶
- 點擊 composer 左側的“粘貼文件”按鈕，選擇或粘貼文件。
- 在輸入框內直接粘貼文件或拖入文件。
- 插件會自動處理文件上傳，並在輸入框中插入類似
`pasted-files/1724320000000-report.pdf`的路徑代碼。
注意事項¶
- 瀏覽器限制：出於安全考慮，瀏覽器無法獲取文件的絕對路徑，因此插件採用“上傳到 workspace 再插入相對路徑”的方案。
- 文件大小限制：當前默認單文件上限爲 64 MiB。
- 圖片處理：若只包含圖片，保留 DSH 原生行爲；若包含非圖片文件，則攔截並上傳所有文件。
- 協議限制：該插件僅用於生成模型可讀的路徑，不新增通用的二進制附件協議。
結尾¶
經過上面的步驟，插件即可生效。該插件通過簡化的交互流程，將文件上傳與路徑注入自動化，適合需要頻繁引用本地文件與 DSH 交互的開發場景。
