前言¶
在 dsh web 會話裏,若要把截圖或本地文件交給模型處理,手動保存、手動補路徑、再回頭下載歷史文件會比較零散。paste-to-workspace 用於處理這類操作:把粘貼或拖入聊天框的圖片與任意文件保存爲會話工作區文件,並在發送後讓模型側收到路徑文本。
這是什麼¶
paste-to-workspace 是一個 dsh web 插件,包名爲 @dsh-user/paste-to-workspace,倉庫安裝來源爲 github:LQ-1123/paste-to-workspace。已覈實資料未單獨給出維護者字段,因此這裏不把倉庫路徑直接表述爲官方維護者信息。
它解決的問題是:在 dsh web 中支持圖片粘貼和任意文件拖放,並把內容保存到會話工作區 .dsh-paste/。
核心功能¶
- 任意文件拖放:從 Finder / 微信 / QQ / 網頁把任意類型文件拖到窗口任意位置,即保存到工作區
.dsh-paste/,並進入待發預覽條。 - 圖片粘貼:使用
Cmd/ctrl+V粘貼截圖或圖片進入待發列表。 - 類型圖標渲染:圖片顯示縮略圖;其他文件顯示 RemixIcon line 圖標、原始文件名和大小;未知格式用代碼圖標兜底。
- 點擊即下載:點擊文件卡片喚起瀏覽器另存爲,並保留原始文件名。
- 純文件發送:不輸入文字也可發送;一次調用等於一個回合。
- 一回合雙氣泡:文字留在原氣泡,圖片/文件卡片移到獨立用戶行;模型側始終是一條消息。
- 主題適配:卡片底色、邊框、文字、圖標跟隨宿主設計 token,深淺主題自動切換。
- 提示文案改寫:拖放時把宿主的圖片拖動提示改寫爲文件拖動提示;該改寫僅作用於拖放進行時。
- 30 天自動清理:超期的插件粘貼文件自動清掃。
安裝與啓用¶
安裝前需要:已裝好 DSH,且 dsh web 可正常運行;dsh plugin 可用並依賴 pnpm。
執行安裝命令:
dsh plugin --profile web add "github:LQ-1123/paste-to-workspace"
安裝後重啓 dsh web 生效。
如需禁用,可在 Profile patch 或 overlay 中設置:
- id: paste-to-workspace
disabled: true
典型用法¶
1、拖入 .txt / .md / .pdf / .doc / .zip 等任意文件,或粘貼圖片;輸入框上方出現預覽條。
2、用 Enter 或發送按鈕發送,可以完全不輸入文字。
3、模型側收到 [Image: source: <絕對路徑>] 或 [File: source: <絕對路徑>] 文本。
4、文件保存在會話工作區 .dsh-paste/;歷史消息中的文件卡片可點擊重新下載。
適用場景與注意¶
適合需要在 dsh web 裏把截圖、文檔、壓縮包等文件交給模型處理的場景。使用前建議注意:
- 粘貼(
Cmd+V)只攔截聊天輸入框內的圖片;文件請使用拖放。 - 不支持拖入文件夾,需要打包成
zip後拖入。 - 單文件上限約
24 MB,base64 後爲32 MBJSON 體。 - 發送過的文件在
.dsh-paste/保留 30 天后自動清理,歷史卡片點擊下載可能 404。 - 待發文件是全局列表:未發送前切換會話,文件會跟着下一次發送走。
- 宿主側提供
POST /save、GET /file、DELETE /file路由;路徑校驗嚴格,跨站請求 403。 - 插件以當前
dsh進程權限運行;安裝前應檢查源碼與許可證。 - 許可證爲
MIT;文件圖標來自RemixIcon,許可證爲Apache-2.0。
參考鏈接¶
資料中給出的鏈接如下:
- 目錄頁:https://www.skillhub.cn/plugins/LQ-1123/paste-to-workspace
- GitHub:https://github.com/LQ-1123/paste-to-workspace