前言¶
DeepSeek Harness 的架构以插件为中心。在 Web Composer 的使用场景中，处理本地文件通常需要特定的工具支持。dsh-local-file-upload 插件解决了从 Web 界面直接将本地文件上传到当前 Session workspace 的需求，使 Agent 能够直接调用这些文件。
这是什么¶
这是一个客户端插件，由 zhangbo1201 维护。它通过在 Web Composer 工具栏添加上传按钮，实现本地文件到 DSH workspace 的流转。
安装与启用¶
在安装之前，请确保当前使用的是 Web profile。
dsh plugin --profile web add dsh-local-file-upload
安装完成后，必须重启当前活跃的 dsh web 进程，工具栏中的上传按钮才会出现。
核心功能¶
该插件提供了以下能力：
- 输入方式：支持在工具栏中一次选择多个文件，或直接在 composer 中使用
Cmd+V/Ctrl+V粘贴普通文件。图片格式（PNG/JPG/WebP/GIF）会走 DSH 原生的图片附件路径，其他文件则通过此插件处理。 - 存储路径：文件会被写入当前 Session workspace 下的
.dsh-uploads/目录。 - 文件命名：系统会自动分配无冲突的文件名，防止覆盖现有文件。存储的文件名会自动净化，移除路径分隔符、空格和
@符号。 - 安全限制：插件会拒绝上传符号链接目录，并在 Host 端验证解码后的字节计数。
使用与注意事项¶
上传成功后，composer 中会自动追加 @.dsh-uploads/<name> 标记，这可以直接被 dsh-at-file 和 agent 文件系统工具使用。
需要注意以下几点：
- 单文件限制：每个文件的传输限制为 10 MiB。
- 本地传输：文件传输仅通过本地 DSH loopback 连接进行，不会上传到任何云服务。
- 清理：上传的文件会保留在 workspace 的
.dsh-uploads/目录中，直到被手动移除。建议将此目录添加到项目的.gitignore中，以避免误提交敏感文件或大文件。
