Introduction¶
When processing images in the DSH web GUI, the common practice is to first send the image as an attachment to the session, or manually save it and then write the path into the message. For scenarios where the AI is expected to use the file tool to read local images and then recognize them visually, manual saving and path input increase operational steps.
dsh-quick-attach does the following: when an image is pasted into the session input box, it automatically saves the image to the configured directory and appends the absolute path to the message draft.
What is this¶
ximisi/dsh-quick-attach is a plugin for the DSH web GUI, maintained by ximisi, and licensed under MIT.
It solves the problem of “how to hand over a pasted image to the AI for recognition”: instead of relying solely on attachment data, it saves the image to disk and sends the absolute file path along with the message to the AI.
Core Features¶
- When an image is pasted into the DSH web GUI session input box, automatically save the image to the directory configured in the settings.
- Append the absolute path of the saved image to the message draft.
- When sending the message, send this absolute path to the AI for it to read and recognize the image via its file tool and vision capabilities.
- Provide a “Quick Attach” section in the settings bar for configuring the save directory and enabling the feature.
- Saved images can be previewed via
/quick-attach-files/<filename>.
From the implementation side, the host provides the following interfaces:
/api/quick-attach/save/api/quick-attach/config/quick-attach-files/*
The client intercepts the input box paste during the document capture phase and adds a “Quick Attach” section to the settings bar.
Installation and Enablement¶
Install from GitHub Release:
dsh plugin --profile web add https://github.com/ximisi/dsh-quick-attach/releases/download/v0.1.1/dsh-quick-attach-0.1.1.tgz
After installation, restart the web service and go to:
Settings → Quick Attach
Configure the save directory and enable it.
Configuration is saved in:
<DSH_HOME>/quick-attach.json
The default save directory is:
<DSH_HOME>/quick-attach
Typical Usage¶
- Open any session.
- Paste (Ctrl+V) one or more images into the input box.
- The image is automatically saved to the configured directory, and the absolute path is automatically appended to the input box.
- Type text normally and send; the path is sent to the AI along with the message.
Applicable Scenarios and Notes¶
Suitable for developers who frequently need to hand images over to the AI for recognition in the DSH web GUI: for example, after pasting a screenshot, they want the AI to read the file by path rather than just receiving one-time attachment data.
Several limitations before use:
- Only intercepts image pasting occurring within the session input box; other input boxes, settings, terminals, etc., are unaffected.
- The native “paste image as attachment” flow is replaced: image data is no longer sent as an attachment, but rather a path is sent.
- The plugin runs with the permissions of the current dsh process; check the source code and license before installing.
- The license is MIT.
Conclusion¶
The value of dsh-quick-attach does not lie in adding complex capabilities, but in condensing the process of “pasting an image, saving a file, typing a path, and sending it to the AI” into a single step. For scenarios of extending web GUI workflows via DSH plugins, it provides a ready-to-deploy quick-attach solution.
Project Address:
- GitHub: https://github.com/ximisi/dsh-quick-attach
- Community Directory Clues (subject to actual information on the directory page): https://www.skillhub.cn/plugins/ximisi/dsh-quick-attach