前言¶

DeepSeek Harness（DSH）原生的附件處理功能在交互上較爲侷限。對於需要頻繁進行文件交互的智能體開發者，缺乏拖拽、粘貼以及直觀的文件卡片管理會顯著降低使用效率。dsh-files-native 針對這一痛點，在官方輸入框基礎上增加了接近原生的附件上傳體驗。

核心功能¶

該插件通過擴展官方輸入框的附件軌，支持多種文件輸入方式：
1. 拖入、粘貼（Ctrl+V）及回形針多文件選擇。
2. 圖片縮略圖與文件卡片混排在官方輸入框同一條軌。
3. 採用 Loopback 上傳機制，產物卡交由 DSH 官方處理。
4. 文件卡渲染在用戶氣泡上方，與圖片同列右對齊。

安裝與啓用¶

執行以下命令進行全局安裝和配置：

npm i -g dsh-files-native
dsh plugin --profile web add dsh-files-native

安裝完成後需要徹底重啓 dsh web 進程。

典型用法¶

1. 拖進窗口任意位置鬆開以添加文件。
2. 使用 Ctrl+V 粘貼文件。
3. 使用輸入框回形針進行多文件選擇。
4. 按 Esc 取消本次拖入。

限制與約束¶

• 文件限制：單文件限制 50MB，單批限制 20 個。
• 上傳路由：僅支持 loopback 路由。
• 刷新行爲：刷新頁面會丟失“已上傳未發送”的文件卡（但磁盤文件保留在 .dsh-uploads/ 目錄中）。
• 插件互斥：不與 dsh-file-fix / dsh-file-upload / dsh-paste-to-path 疊裝。
• 開發約束：禁止在渲染路徑調用 useSession / useInput；禁止對聊天時間線掛 MutationObserver。
• 兼容版本：兼容 DSH 0.1.5-rc.1 / 0.1.5-rc.2 及之後版本。

生態背景¶

DSH 插件生態遵循「一切皆插件」的理念。dsh-files-native 由社區開發者 meyaomiao 維護，遵循 MIT 許可證。