Introduction

DeepSeek Harness currently only transfers native attachments as raster images. If you wish to attach arbitrary local files as path references to the prompt and manage these uploaded files from Settings, you can use the dsh-file-uploads plugin. It targets DSH’s Web profile, uses storage files within the Harness host/container, and adds paths to the submission text via the built-in input-reference serializer.

What is this

l541402398/dsh-file-uploads is a DeepSeek Harness Web profile plugin maintained by l541402398, licensed under MIT, currently offering a v1.0.0 tagged release. It adds a Files button next to the existing composer control to upload arbitrary local files and attaches the file paths to the prompt when the message is submitted.

Core Capabilities

  • Accepts multiple arbitrary local files, not limited to images.
  • Displays pending files as cards similar to images above the composer.
  • Keeps the text editor clean, not inserting visible paths or generated descriptions into the draft.
  • Only serializes each hidden file reference into a model-readable absolute path when the message is submitted.
  • Clears the pending card after submission; restores the pending card if submission fails.
  • Stores each upload in the fixed directory $DSH_HOME/uploads by default.
  • Lists uploaded files in Settings → Uploaded files and provides download and delete operations.
  • Prevents overwriting by generating names like name (1).ext, name (2).ext, etc.
  • Enforces single-file and total directory quotas.

Compatibility and Requirements

This plugin is compatible with DeepSeek Harness 0.1.0-rc.6, Web profile, and Node.js 22 or later versions.

Installation and Usage

First, install the tagged release:

dsh plugin --profile web add "github:l541402398/dsh-file-uploads#v1.0.0"

After installing the tagged release, you need to restart the running Web profile, then refresh the browser page.

If you want to install the development branch:

dsh plugin --profile web add "github:l541402398/dsh-file-uploads#main"

Remove the plugin:

dsh plugin --profile web remove dsh-file-uploads

Typical Usage

  1. Open a session in the Harness Web GUI.
  2. Select Files from the composer toolbar.
  3. Select one or more local files.
  4. Review or delete the pending file cards displayed above the composer.
  5. Add normal prompt text or keep the editor empty.
  6. Submit the message.

After submission, the model might receive a line similar to:

Uploaded files: `/path/to/.dsh/uploads/report.pdf`

This content is not inserted into the editor draft before submission. The saved path is the file system path visible to the Harness host; in Docker deployments, this is the path inside the container.

Managing Uploaded Files

You can see the following in Settings → Uploaded files:

  • Fixed storage directory;
  • Single-file and total directory limits;
  • Current storage usage;
  • Filename, size, modification time, absolute path;
  • Download and delete operations.

Configuration

The plugin can run without configuration. The following environment variables can override default values:

  • DSH_UPLOAD_DIR, default $DSH_HOME/uploads, represents the absolute upload directory.
  • DSH_UPLOAD_MAX_BYTES, default 104857600, represents the maximum bytes per single file.
  • DSH_UPLOAD_TOTAL_MAX_BYTES, default 1073741824, represents the maximum bytes for the total directory.

Security and Notes

  • File listing, upload, download, and delete operations use the same loopback/trusted-host and Origin checks as the built-in Harness Web API and reject cross-site browser requests.
  • The plugin enforces restrictions on filenames, downloads, deletions, and uploaded temporary files.
  • This is not a user account authentication system. If exposing the Harness Web GUI to other users or the public internet, you should use an authenticated reverse proxy and correctly configure Harness trusted hosts.
  • The plugin runs with the permissions of the current dsh process; you should check the source code and license before installing.

Links