dsh-plugin-send-image

面向：使用者 · 状态：stable · 最近核对：2026-09-20

Lets the agent put a picture into the conversation. A screenshot, the clipboard, or a file — the host normalizes and persists the bytes, every DSH client renders it inline, and the user can open it full screen.

Why a plugin is needed at all: DSH's model adapters declare text-only output, so the agent cannot emit an image in its answer. The bytes reach the client through the Host's attachment service (ctx.attachments.saveImage, which normalizes and persists them) and the returned reference rides on this tool's result, as an image content block — so every client draws the picture inside the agent's own turn.

Submitting it as a prompt instead — which is what this plugin used to do — is wrong twice over: a prompt is a user message, so the picture looked like something the user had sent, and it started a turn, so the agent answered its own screenshot. send-image.mjs --via-prompt keeps that path for a client that cannot render tool-result images; nothing here uses it.

plugins/send-image/
├── package.json          # type: module, dsh.bundle.patch
├── cordis.patch.yml      # bundle patch: the loader row
├── lib/index.js          # cordis plugin: registers the send_image tool
└── test/                 # node --test, 19 tests (no DSH, no network)

The tool is a thin shell around skills/send-image/send-image.mjs, which owns the capture quirks (screencapture, pngpaste, the screen-recording permission message) and prints one JSON descriptor. Standalone it only prepares — the publishing half needs the Host context this plugin has:

node skills/send-image/send-image.mjs --screenshot        # prints the descriptor
node skills/send-image/send-image.mjs --file ./out/render.png
node skills/send-image/send-image.mjs --clipboard         # needs pngpaste

Install

dsh plugin --profile web add dsh-plugin-send-image

Then restart DSH (or reload the profile). From a checkout a relative spec works too — the leading ./ matters, because DSH anchors it against your current directory instead of resolving it inside the profile:

dsh plugin --profile web add ./plugins/send-image

Use

The agent calls send_image. Exactly one source per call:

Argument	Meaning
file	Path to an image (absolute, or relative to the working directory)
screenshot	true captures the whole screen — the picture contains everything on it
clipboard	true sends the image on the clipboard (needs pngpaste)
caption	Text shown with the picture

Passing none or several is a readable tool error rather than a schema failure: source exclusivity is a runtime rule here, so the model is told what to fix.

You can also take the screenshot yourself

Inside the DSH window, ⌥⌘S (or the button at the left of the composer) starts a drag-select; the selected rectangle is attached to the current conversation as a draft — you decide whether to send it. The shortcut only works while the DSH window has focus (no system-wide hotkey), and it can be rebound under Settings → Shortcuts. Esc cancels without leaving a file, and a missing Screen Recording grant prints where to enable it and which program to restart.

Both supported hosts (the official desktop app and the command-line web host) run the same client half, shipped in this package. The plugin is hot-pluggable: enabling or disabling it adds or removes the shortcut, the composer button and its styles in place — no host restart, no page reload.

Test

cd plugins/send-image && npm test    # 14 tests, zero dependencies

MIT.