dsh-clipfile: Mounting Files and Folders in DSH Composer

In the DeepSeek Harness (DSH) web editor, directly passing files or folder structures often requires manual uploading or writing complex path references. The dsh-clipfile plugin adds native file mounting capabilities to DSH Composer, supporting clipboard pasting, native file selection, and fuzzy path search, addressing the interaction bottleneck of file transfer.

This is a client-side plugin maintained by whyzsm, designed to simplify file interaction in the DSH web editor.

Core Features¶

The plugin provides the following four file interaction methods:

1. Clipboard pasting: Copy a file or folder in macOS Finder, then paste directly in the editor by pressing ⌘V. The plugin detects clipboard content via osascript furl, without uploading the file.
2. Native file selector: Click the ＋ button next to the editor to invoke the macOS native file selector (NSOpenPanel), supporting multi-selection of files or folders.
3. @ mention path completion: Enter @ followed by a keyword in the editor, using mdfind for fuzzy path search to automatically complete the file path.
4. Paginated Markdown conversion: A pasted folder is converted into INDEX.md (index page) and pages/*.md (paginated content), allowing the agent to read page by page and avoiding loading too much data at once.
5. Removable tags: Each attachment is displayed as a tag; click ✕ to remove it. Tags are only valid for the current session; when switching conversations, the attachments for that conversation are displayed, and they are automatically cleared after sending a message.

Installation and Enablement¶

To install the plugin, simply run the following command:

dsh plugin --profile web add whyzsm/dsh-clipfile

Typical Usage¶

1. Select a file or folder in Finder, then press ⌘V in the DSH editor to paste.
2. Click the ＋ button next to the editor to open the system file selector for multi-selection.
3. Enter @ followed by a keyword from the file path; the system will automatically complete the path.

Notes¶

• Platform limitation: The plugin only supports macOS and depends on osascript, NSOpenPanel, and /opt/homebrew/bin/python3.
• Zero-copy mechanism: Attachment processing uses a zero-copy mechanism: the plugin reads read-only content from the original paths and packages the converted paginated Markdown into the .dsh-clipfiles/md/ directory.
• Session scope: Attachment tags are visible only in the current session; when switching conversations, the attachments for that conversation are displayed, and they are automatically cleared after sending a message.

Summary¶

dsh-clipfile improves the efficiency of handling local files and folders in the DSH web editor through native file interaction methods. For more details, view the plugin directory or source code.