Drag-and-drop or paste any local file — PDF, CSV, code, or document — into the DSH web composer. The plugin resolves the filesystem path and inserts an @workspace reference the agent opens with existing tools. No upload API, no extra model context.

Why do I need this?

Without this plugin, the DSH composer only accepts PNG, JPEG, WebP, and GIF. Any other file is rejected as an unsupported image format.

dsh-file-ref bridges that gap:

• Recover the original filesystem path when the browser or host can see it.
• Otherwise write a copy into the workspace inbox and @ that path.
• Mark @relative mentions before the model step so the agent can open the file with read, the shell, or other tools already in the session.

There is no new upload API and no extra model-facing file tool. The agent uses whatever access mode the session already provides.

Quick Start

Requires the dsh CLI and the web profile.

dsh plugin --profile web add https://github.com/auroralab-art/dsh-file-ref/releases/download/v0.1.0/dsh-file-ref-0.1.0.tgz

Restart dsh web and hard-refresh the browser. Done.

To remove:

dsh plugin --profile web remove dsh-file-ref

How does it work?

Before a step, the host confirms each @relative path still exists and injects:

<workspace-reference path="docs/spec.pdf" kind="file" />

Absolute paths stay as typed. The plugin does not open the file or send its bytes. The agent reads the path with the session's usual tools and access mode.

How are file paths resolved?

• Paste and drop of PNG, JPEG, WebP, and GIF stay on the first-party image rail.
• A path inside the workspace is inserted as @relative. A path outside the workspace is inserted as absolute text.
• When the browser hides the filesystem path, the host writes a copy under inboxDir and the draft @s that relative path.
• Reference markers are created only from @relative tokens that still exist inside the workspace.
• Absolute paths stay as typed. The plugin does not rewrite them into mentions.
• File format does not change this flow. A staged copy must be within maxStageBytes.
• DSH read opens UTF-8 text. Other formats use the session's shell or other tools.

Configuration

Optional keys go in ~/.dsh/profiles/web/cordis.patch.yml. A later layer replaces the whole config object, so restate every key you set.

- id: dsh-file-ref
  config:
    inboxDir: .dsh-inbox
    maxStageBytes: 20971520

FAQ

Compatibility

Aurora Lab

This plugin is published by Aurora Lab. We build plugins that extend what DeepSeek Harness can do.

Other plugins from Aurora Lab:

• dsh-access — Remote access gateway with role tokens and device binding
• dsh-msg-revise — Edit and resend messages after the agent stops

License

Not MIT. See LICENSE (中文).

You may download and install this software for personal, non-commercial use. Contact the owner through auroralab-art before any modification or derivative work. Commercial use requires the owner's written consent.

Develop

pnpm install
pnpm test
pnpm run build
dsh plugin --profile web add "$PWD"

add "$PWD" links this checkout into the profile. Keep the directory. That is the development path, not the install command for other machines.

The build expects a deepseek-harness checkout at ../../deepseek-harness, or DSH_CHECKOUT.