前言¶

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 许可证。