dsh-drag-to-attachment

A dsh-plugin for the DeepSeek Harness web UI: drag or paste any local file or folder anywhere on the page — images keep the native thumbnail attachment experience and send as thumbnails; every other file and whole folders are located to their real filesystem path and referenced as chips (nothing is uploaded or copied), with the real path appended on send. One toggle also inserts the real paths directly into the draft.

English | 中文

Why

• Browsers never hand the real filesystem path of a dropped/pasted file to a web page — but DSH operates on real files and its tools read real local paths. This plugin closes that gap: it locates the dropped file back to its true location and references it as an attachment (no copies, no .drops/ uploads).
• Images keep the native DSH attachment experience (thumbnail card, preview, remove) and send as thumbnails — no conversion.
• Other files / folders: DSH cannot attach non-images natively, so they appear as chips in the attachment rail (hover shows the real path) and their real paths are appended as plain text on send — the agent reads them with dsh-vision-toolkit (vision_glance / vision_pixel_diff / long-screenshot OCR) or document tools.

Two modes (one toggle)

Composer tool-row button: 📎 附件 / 📄 路径 — choice persists in localStorage (dsh.dragToAttachment.mode).

	Attachment mode (default)	Path mode
Drop anywhere / paste (incl. folders)	✅	✅
Images	chip with thumbnail preview referencing the real path	real path inserted
Any other file (no extension whitelist)	chip referencing the real path (hover shows it)	real path inserted
Folders	📁 chip referencing the folder path	folder path inserted
Send	message shows attachment cards (image thumbnail / file icon + name, no raw path text); the agent still receives the real paths underneath	paths already in draft
Files copied/uploaded?	never (no .drops/ copies)	never
Send without typing	✅ (invisible draft filler enables the button)	n/a

Note: every attachment must be locatable to its real path (current workspace first, then registered workspaces, Desktop/Documents/Downloads, OS index, bounded recursive search); a visible toast explains when locating fails — nothing is silently dropped. Thumbnails in sent messages are rendered by a local read-only proxy and cost zero model tokens — only the real-path text ever reaches the model.

Install

dsh plugin --profile web add github:djt889/dsh-drag-to-attachment
# or a local checkout:
dsh plugin --profile web add /path/to/dsh-drag-to-attachment

Restart your web profile (dsh web) and hard-refresh the browser. No settings page.

Usage

1. Pick the mode in the composer tool row (📎 default).
2. Drag files/folders from your file manager anywhere on the page — a full-page dim + hint appears — or just Ctrl+V files (pasting folders works too).
3. Attachment mode:
   • Images → rail chips with a thumbnail preview (✕ remove, hover shows the full real path).
   • Other files / folders → removable chips (hover shows the full real path).
   • After send, the message shows attachment cards (thumbnail / file icon + name) — no raw path text; the agent receives the real paths underneath and reads them with dsh-vision-toolkit / document tools.
   • Press send without typing — works.
4. Path mode: located real paths are inserted into the draft line by line (a picker appears when several same-named candidates exist).
5. The agent reads the files with dsh-vision-toolkit / document tools.

Files are never copied or uploaded to .drops/ — the attachment references the original file location.

Structure

dsh-drag-to-attachment/
├─ package.json        bundle declaration (dsh.bundle.patch / dsh.client)
├─ cordis.patch.yml    mount row (insert drag-to-attachment)
├─ lib/
│  ├─ index.js         host: POST /_dsh/drag-to-attachment/locate (the only route — path locator)
│  └─ client.js        browser: global drag/paste + dual-mode dispatch + native image thumbnails + file/folder chips + send + toggle
├─ LICENSE             BSD-3-Clause
└─ README.md / README.zh.md

Path locating

Multi-phase protocol (ported from bill9109/dsh-drag-and-drop):

1. Current workspace → other registered workspaces → Desktop/Documents/Downloads shallow probe;
2. OS index (Windows: Everything CLI → PowerShell; macOS: Spotlight; Linux: plocate/locate);
3. Bounded recursive search (≤20,000 entries per root, depth ≤12);
4. Multiple same-named candidates → filter by name+size → sample fingerprint (head/middle/tail 64KB) → full SHA-256 if needed → a path picker when still ambiguous.

Compatibility

Tested on the current DeepSeek Harness (web profile, bundle model). It relies on a few unpublished internal interfaces (conversation service, sendSession/draftImages/createDraftImages, the _attachments rail class, webServer routes, the workspace registry) and may need adapting after DSH upgrades.

License

BSD-3-Clause — the path-locating code is ported from bill9109/dsh-drag-and-drop (BSD-3-Clause). See LICENSE.