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 a vision plugin (e.g. dsh-vision-toolkit) or document tools.

Two modes (one toggle)

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

> 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: - Dropped items appear instantly as chips (images show their thumbnail right away). - Pending chips show a real-time ring progress (fast-index → full-disk, percentage climbs live). - 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 a vision plugin / document tools. - Press send without typing — the send button activates once every queued path is resolved. 4. Path mode: each dropped/pasted entry shows a real-time ring progress chip (parallel, per-entry percentage), and 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 a vision plugin / document tools.

Attachment dedupe: an attachment with the same name AND path as an existing chip is compared by MD5 — identical content is reported as "already uploaded" and not added; same name with a different path is a different file and is always added (no MD5 needed). Pasted screenshots are saved content-addressed, so pasting the same screenshot again never piles up new .drops/ copies — it is reported as already uploaded.

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: /locate (progressive tiers) · /save (fallback) · /md5 (dedupe) · /file (thumbnail proxy)
│  └─ client.js        browser: global drag/paste + dual modes + live ring progress + attachment cards + send
├─ vendor/everything/  bundled Everything for Windows (voidtools freeware, zero install)
├─ LICENSE             BSD-3-Clause
└─ README.md (中文) / README.en.md (English)

Path locating (real-time, progressive)

Progress is shown immediately after drop/paste; the search runs in two tiers, each completing before the next starts:

1. Fast tier (tier-fast, ms): shallow probes (workspace / Desktop / Documents / Downloads) → OS index; 2. Full tier (tier-full): bounded recursive search (≤100,000 entries per root, depth ≤24) + broad mounts; 3. 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.

Per-platform index — zero install on all three:

> Pasted screenshots are copied straight into <workspace>/.drops/ (no index search, instant); unlocatable files are also saved there as a fallback. Clean .drops/ whenever you like.

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). The bundled Everything is freeware by voidtools. See [LICENSE](LICENSE).