前言¶
DSH 的 Web 界面本身支持圖片附件，但如果你要把普通文件、甚至整個文件夾交給模型處理，還需要一個能保留目錄結構、持久化到工作區，並且儘量不打亂原有輸入區的插件。
下面介紹 dsh-attachment。它由 WJZ-P 維護，許可證爲 MIT，當前版本面向 DeepSeek Harness 0.1.0-rc.5 的 web profile 使用。
這是什麼¶
dsh-attachment 是一個 DSH 插件包，用於在 Web Client 輸入區增加文件和文件夾附件體驗。
它的定位不是替換原生圖片鏈路，而是在普通文件和文件夾場景上提供卡片、歷史與落盤路徑；當輸入區沒有插件附件時，頁面佈局和原版 Harness 保持一致。
核心功能¶
- 文件夾拖放：一個文件夾對應一張附件卡片，同時完整保留內部目錄樹。
- 普通文件：支持拖入、預覽卡片、持久化歷史與流式下載。
- 原生圖片共存：PNG、JPEG、WebP、GIF 繼續使用 Harness 原生圖片預覽、畫廊和多模態檢查。
- 模型可讀取：提交後寫入當前工作區的
.deepseek-harness/attachments/，爲模型提供明確路徑。 - 低侵入集成：通過公開的輸入附件欄 slot、會話定義與 Host 路由完成集成。
- 佈局保持：輸入區沒有插件附件時，頁面佈局和原版 Harness 保持一致。
安裝與啓用¶
當前版本可以直接從 npm 安裝到原生 DSH 的 web profile。先執行安裝：
dsh plugin --profile web add dsh-attachment
安裝後，可以檢查組合後的配置，再啓動 DSH：
dsh --profile web --dump-config
dsh --profile web
如果需要移除插件，執行：
dsh plugin --profile web remove dsh-attachment
典型用法¶
1、安裝插件：
dsh plugin --profile web add dsh-attachment
2、檢查插件接入後的配置：
dsh --profile web --dump-config
3、啓動 DSH 的 web profile：
dsh --profile web
4、在輸入區拖入文件或文件夾，提交消息後附件會持久化並複製到工作區附件目錄。
5、插件會把附件寫入 .deepseek-harness/attachments/，讓模型可以基於明確路徑讀取文件或目錄樹。
適用場景與注意¶
這個插件適合在 DSH web profile 下需要以下能力的場景：
- 拖入普通文件並保留歷史卡片；
- 拖入文件夾時保留目錄樹；
- 在會話中保留附件歷史；
- 爲模型提供工作區中的明確文件路徑；
- 與 Harness 原生圖片附件共存。
使用前需要注意：
- 插件自身不設置附件數量或單文件字節上限；實際可用範圍由瀏覽器、運行環境與目標模型共同決定。
- 文件名、MIME 類型、附件 ID 與目錄成員路徑均按不可信輸入校驗。
- Windows 盤符、UNC 路徑、絕對路徑及目錄穿越片段會在寫入前被拒絕。
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼與許可證。 - 當前版本面向 DeepSeek Harness
0.1.0-rc.5的標準 bundle、Web Client 發現、輸入附件欄、會話事件與 Host 路由接口。 - 官方
@deepseek-ai/*包全部使用peerDependencies。
鏈接¶
插件目錄頁：
https://www.skillhub.cn/plugins/WJZ-P/dsh-attachments
GitHub 倉庫：
https://github.com/WJZ-P/dsh-attachments
社區目錄是獨立站點，不應理解爲官方應用商店。dsh-attachment 的價值在於把普通文件和文件夾附件納入 DSH 的 Web 工作流，同時保持原生圖片鏈路與原有輸入區佈局。
