Preface¶

The DSH web interface natively supports image attachments, but if you need to hand ordinary files or even entire folders to the model, you still need a plugin that preserves the directory structure, persists to the workspace, and keeps disruption to the original input area to a minimum.

Below we introduce dsh-attachment. It is maintained by WJZ-P, licensed under MIT, and the current version targets the web profile of DeepSeek Harness 0.1.0-rc.5.

What This Is¶

dsh-attachment is a DSH plugin package that adds file and folder attachment capabilities to the Web Client input area.

Its positioning is not to replace the native image pipeline, but to provide cards, history, and on-disk paths for ordinary file and folder scenarios. When there are no plugin attachments in the input area, the page layout remains identical to the original Harness.

Core Features¶

• Folder drag-and-drop: one folder corresponds to one attachment card, while the full internal directory tree is preserved.
• Ordinary files: supports drag-in, preview cards, persistent history, and streaming downloads.
• Native image coexistence: PNG, JPEG, WebP, and GIF continue to use Harness’s native image preview, gallery, and multimodal inspection.
• Model-readable: after submission, files are written to .deepseek-harness/attachments/ in the current workspace, providing explicit paths for the model.
• Low-intrusion integration: integrated through the public input attachment bar slot, session definitions, and Host routes.
• Layout preservation: when there are no plugin attachments in the input area, the page layout remains consistent with the original Harness.

Installation and Enablement¶

The current version can be installed directly from npm into the native DSH web profile. Start by running the installation:

dsh plugin --profile web add dsh-attachment

After installation, you can inspect the merged configuration before starting DSH:

dsh --profile web --dump-config
dsh --profile web

To remove the plugin, run:

dsh plugin --profile web remove dsh-attachment

Typical Usage¶

1. Install the plugin:

dsh plugin --profile web add dsh-attachment

2. Inspect the configuration after plugin integration:

dsh --profile web --dump-config

3. Start DSH’s web profile:

dsh --profile web

4. Drag files or folders into the input area; after submitting a message, attachments are persisted and copied to the workspace attachment directory.

5. The plugin writes attachments to .deepseek-harness/attachments/, allowing the model to read files or directory trees based on explicit paths.

Use Cases and Notes¶

This plugin is suitable for scenarios under the DSH web profile that require the following capabilities:

• Drag in ordinary files and retain history cards;
• Preserve the directory tree when dragging in folders;
• Retain attachment history within a session;
• Provide explicit file paths in the workspace for the model;
• Coexist with Harness’s native image attachments.

Before use, please note:

• The plugin itself does not set limits on the number of attachments or per-file byte size; the actual usable range is determined jointly by the browser, runtime environment, and target model.
• File names, MIME types, attachment IDs, and directory member paths are all validated as untrusted input.
• Windows drive letters, UNC paths, absolute paths, and directory traversal fragments are rejected before writing.
• The plugin runs with the permissions of the current dsh process; review the source code and license before installation.
• The current version targets the standard bundle, Web Client discovery, input attachment bar, session events, and Host route interfaces of DeepSeek Harness 0.1.0-rc.5.
• All official @deepseek-ai/* packages use peerDependencies.

Links¶

Plugin directory page:

https://www.skillhub.cn/plugins/WJZ-P/dsh-attachments

GitHub repository:

https://github.com/WJZ-P/dsh-attachments

The community directory is an independent site and should not be understood as an official app store. The value of dsh-attachment lies in bringing ordinary file and folder attachments into DSH’s web workflow while preserving the native image pipeline and the original input area layout.