前言¶
在 DSH web 會話中，把本地圖片、文檔或目錄交給模型讀取時，常見做法是先複製路徑，再手動粘貼到輸入框。dsh-file-upload 針對這類操作做了簡化：它在 DSH web 客戶端中增加一個上傳按鈕，並支持把文件或文件夾拖進窗口。
經過上面的方式，文件會被歸檔到 DSH 附件庫；符合條件的圖片還可以走官方附件 rail，其他文件和圖片路徑會插入爲草稿文本。它屬於 DSH 插件生態，README 明確說明這是社區成員獨立開發和維護的非官方項目，不是 DeepSeek 官方產品。
這是什麼¶
dsh-file-upload 是一個 DSH web 客戶端插件，核心定位是：在 DSH 會話中提供「上傳按鈕 + 拖拽文件」入口，並把文件轉換爲模型可讀的本地路徑或官方附件。
已覈實的倉庫信息如下：
- 名稱：
dsh-file-upload - 許可證：MIT
- 倉庫 owner：
a903067276-rgb - GitHub：
https://github.com/a903067276-rgb/dsh-file-upload
核心功能¶
下面介紹已覈實的功能點。
- 在 DSH web 會話中增加一個上傳按鈕，並支持拖拽文件。
- 點擊上傳圖標會打開系統文件選擇器，支持多選，並按規則路由到官方附件 rail 和/或路徑文本。
- 拖入文件時，圖片與任意文件類型都會被接管，不出現「不支持」提示。
- 拖入文件夾時，插件會遞歸讀取文件夾，並在附件庫下按原有目錄結構重建。
- 支持 PNG/JPEG/WebP/GIF 圖片：可歸檔到按日期劃分的附件目錄，並加入官方草稿附件 rail。
- 圖片發送時會複用 DeepSeek Files API 的
file_id；7 天過期後自動重新上傳。 - 其他文件會歸檔到
files/下，並在草稿中插入帶前綴的路徑文本。 - 噹噹前模型不支持圖片時，圖片會回退爲歸檔路徑文本，而不是作爲圖片塊發送。
- 提供設置卡片，包含附件目錄、路徑前綴、官方附件路由、圖片歸檔、公共上傳、剪貼板監聽等選項。
安裝與啓用¶
安裝前先確認環境滿足：DSH web >= 0.1.0-rc.7，並且 PATH 中有 pnpm。dsh plugin 需要藉助 pnpm 完成安裝。
使用一行安裝命令：
dsh plugin --profile web add "github:a903067276-rgb/dsh-file-upload#main"
這條命令把插件安裝到 web profile。安裝完成後，重啓 DSH web：
dsh web
經過上面的步驟，插件會在 DSH web 重啓後生效。
如果 DSH 版本較舊，已覈實資料給出的版本選擇是：
0.1.1-rc.1及更新版本：使用main（v0.1.5+）。0.1.0-rc.7到0.1.0-rc.8：可使用main（v0.1.5+），也可以把v0.1.4作爲保守回退。0.1.0-rc.6及更早版本：使用v0.1.2。
若採用 manual mount，需要在 ~/.dsh/cordis.patch.yml 中保持單個條目，避免重複註冊路由導致崩潰；完成後重啓 dsh web。
典型用法¶
1、點擊上傳圖標，選擇多個文件；或者把文件、文件夾拖進窗口任意位置。
2、若當前模型支持圖片，插件會把支持的圖片歸檔到附件目錄，並顯示在官方附件 rail 中；發送後模型可以看到圖片。
3、若當前模型不支持圖片，或者關閉官方附件路徑，插件會把圖片歸檔到 images/，並在草稿中插入帶前綴的絕對路徑行。
4、對其他文件，插件會歸檔到 files/，並在草稿中插入路徑文本；發送後模型可以按路徑讀取文件。
5、對文件夾，拖入後插件會在附件庫下按原有結構重建；草稿中只加入一行文件夾路徑。
設置與限制¶
設置卡片提供以下控制項：
- 附件目錄：用於圖片歸檔。
- 路徑前綴：拼接到草稿中的路徑文本前。
- 官方附件路由：開啓時圖片走官方附件 rail；關閉時圖片走路徑文本邏輯。
- 圖片歸檔：控制是否把圖片歸檔到附件目錄。
- 公共上傳：默認關閉；關閉時 same-origin 檢查仍允許 localhost；開啓後任意 origin 可上傳。
- 剪貼板監聽：默認關閉；可選
off、images only、all files。
文件限制方面，DeepSeek Files API 的單文件硬限制爲 64 MB；DSH 本地附件存儲默認是 20 MB。20 MB 以上且不超過 64 MB 的圖片，默認會歸檔並通過路徑文本引用；如需走官方附件路徑，需要在 ~/.dsh/profiles/web/cordis.patch.yml 中調整 maxImageBytes，然後重啓 dsh web。
適用場景與注意¶
這個插件適合希望在 DSH web 會話中快速引入本地圖片、文檔或目錄的用戶。它把文件操作收斂爲上傳按鈕、拖拽、路徑文本和官方附件 rail，減少手工粘貼路徑的步驟。
需要注意：DSH 插件會在當前 dsh 運行環境中執行，並且可能讀寫 DSH 附件庫、調用 DeepSeek Files API 或影響草稿輸入。安裝前應檢查源碼、依賴和許可證。該插件許可證爲 MIT，且明確爲非官方社區項目。
平臺支持方面：macOS 已完整測試；Linux 和 Windows 預期可以工作，但尚未測試。
鏈接¶
- GitHub 倉庫：
https://github.com/a903067276-rgb/dsh-file-upload - 目錄頁：請在 DSH 插件目錄中搜索
dsh-file-upload；本篇已覈實資料未給出可直接引用的目錄頁 URL。
