dsh-download-button

dsh-download-button

English | 中文

A Download button for delivered-file cards in DeepSeek Harness (dsh) web.

The problem

When an agent produces a file, dsh renders a card with two actions:

Action	What it does	Why it is not enough
Open	Asks the host machine to open the file with its default application	A headless server has no desktop, so this always fails
Open in sidebar	Text preview	Non-text files (docx / xlsx / pdf / zip …) answer "non-text file, cannot preview"

So a docx the agent just wrote has no way out of the browser.

What this plugin does

It appends a Download link to every delivered-file card. Clicking it saves the file straight from the server to your disk.

[ Download ] [ Open ▾ ]

On a headless host it also hides the "this host has no available desktop, cannot open file or folder" notice. That notice exists because dsh ships a desktop-integration surface (open the file with a host application / reveal it in Finder·Explorer) for installations running on someone's own computer. A server has no such desktop, so the notice is only noise — the download link is the way out. Detection uses the same rule dsh itself uses on Linux (DISPLAY or WAYLAND_DISPLAY present); on macOS/Windows desktop mode nothing is hidden and the notice never appears.

Design (why it survives upgrades)

• No vendor patching. Nothing under node_modules is modified. The plugin only taps the server-rendered index page and injects a small script.
• No server route of its own. It reuses the built-in authenticated raw-bytes route GET /api/file?path= (correct Content-Type, cookie-authenticated), with the HTML download attribute supplying the filename.
• No bundled-class-name assumptions. The button copies its className from the sibling action button already present in that card, so it follows theme/style changes.
• The absolute path is read from the card's own title attribute (which dsh already sets to the resolved workspace path).

Install

dsh plugin --profile web add github:maxesisnclaw/dsh-download-button

Manual install:

1. Copy this directory to /plugins/dsh-download-button/.

2. Add to $DSH_HOME/cordis.patch.yml:

   - insert:
       - id: download-button
         name: /absolute/path/to/dsh-download-button/index.js
   

3. Restart the service: systemctl restart dsh (or restart your dsh web process).

When the package is listed in a profile's dsh.profile.bundles instead, the bundled cordis.patch.yml applies the same insert automatically.

Verify

• Open the web UI, have the agent produce any non-text file (docx, xlsx, pdf), and look for the Download button on the file card; clicking it should save the file.

• Server-side check that the underlying route works:

  curl -b "" \
    "http://127.0.0.1:3080/api/file?path=/absolute/path/to/file.docx" -o out.docx
  # out.docx must be byte-identical to the source file
  

• Unit test: npm test (checks the index-page injection is applied once, and is idempotent).

Limitations

• The card must expose the file's absolute path in a title attribute (that is how the current dsh renders delivered files). If a future version changes the card markup, update the selector in the injected script.
• Only delivered-file cards get the button; other surfaces (e.g. a sidebar preview of a text file) are untouched.

License

MIT