@aetheri-ai/dsh-show-image
English | 中文
A DeepSeek Harness plugin that adds the show_image tool: the model presents an existing local PNG, JPEG, WebP, or GIF file to the human viewer, rendered inline in the Web conversation transcript.
Install
Install the bundle on a profile whose base supplies the filesystem, tool runtime, and durable attachments (dsh-base covers all three). Choose the command that matches how dsh is installed:
# dsh installed globally
dsh plugin --profile web add @aetheri-ai/dsh-show-image
# Run dsh directly from npm
npx @deepseek-ai/dsh plugin --profile web add @aetheri-ai/dsh-show-image
# A deepseek-harness source checkout
pnpm dsh plugin --profile web add @aetheri-ai/dsh-show-image
Restart the Web profile, then start a new conversation. A recently published release may not have reached a configured registry mirror; append --registry=https://registry.npmjs.org to the install command when necessary.
Confirm that the bundle is composed:
dsh --profile web --dump-config
The output contains an @aetheri-ai/dsh-show-image section and a show-image row. Remove the bundle with:
dsh plugin --profile web remove @aetheri-ai/dsh-show-image
Use
In a new session, ask the model to display an existing supported image, for example Show docs/architecture.png in the conversation. The model calls show_image with:
{ "file_path": "docs/architecture.png" }
Relative paths resolve against the session workspace. The tool commits the picture to the durable attachment store and returns an image block that the Web client renders inline (with the existing load, retry, and lightbox behavior). The active model route still needs the normal dsh provider/API-key configuration to make a tool call.
Design
- Presentation-only: the tool exists for the human viewer. It does not require a vision-capable model route — use
read_image when a model must inspect pixels.
- Policy-respecting: paths resolve through the filesystem provider, so sandbox confinement and fs policy apply unchanged.
- Durable: images are stored as content-addressed attachments, never as temporary paths or inline base64 in the log.
- Conditional: the tool registers only while a durable attachment store is mounted.
Compatibility
Peer dependencies track the dsh npm release line (^0.1.1-rc.2, cordis ^4.0.1). dsh is in developer preview; this plugin updates with each breaking release.
Development
pnpm install
pnpm run test # unit + real-Loader composition tests
pnpm run build # tsdown bundle into lib/
pnpm run typecheck
License
MIT
