deepseekplugins

DeepSeek Harness plugin

dsh-image-preview

Local image hosting for DeepSeek Harness: serves images from a preview directory over the web profile's own HTTP server so chat messages can render them inline, plus a preview_image tool that stages

UI Enhancements
Jump to install

Source facts

Repository
ReiRui/dsh-image-preview
Latest update
Aug 17, 2026
Category
UI Enhancements
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/ReiRui/dsh-image-preview
Plugin: dsh-image-preview
Author: ReiRui

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-image-preview

本地图床插件：让会话里的聊天能内嵌显示图片。

功能

  • 在 web profile 自带的 HTTP 服务（ctx.webServer，同源 127.0.0.1:3080）上注册 /preview/* 路由，静态托管一个预览目录（默认 ~/.dsh/preview）里的图片。同源 URL（http://127.0.0.1:3080/preview/<name>）在聊天里可直接渲染，无混合内容/CORS 问题。
  • 注册模型工具 preview_image(file_path)：把已存在的本地图片复制进预览目录（已在目录内则直接引用），返回可内嵌的 URL。AI 截图/下载图片后，调它即可把图贴进会话。

安装

# 本地路径
dsh plugin --profile web add ./plugins/dsh-image-preview

# 或从 GitHub 安装
dsh plugin --profile web add "github:ReiRui/dsh-image-preview#main"

安装后重启 web profile 生效。

配置

在 $DSH_HOME/profiles/web/cordis.patch.yml 里覆盖该行的 config：

- id: image-preview
  config:
    root: !!js dshHomePath('preview')   # 预览目录，可改成项目目录
    prefix: /preview                    # URL 前缀

使用

1. 让 AI 生成/下载一张图（截图、渲染预览等）到本地； 2. AI 调用 preview_image 工具传入绝对路径； 3. 工具返回 http://127.0.0.1:3080/preview/<name>，AI 在回复里贴该链接； 4. 页面内联显示图片。

也可以直接访问 http://127.0.0.1:3080/preview/<name> 查看。

AI 使用提示（给 agent 的约定）

  • 必须调用 preview_image 工具，禁止手动把文件复制进 ~/.dsh/preview：新会话的文件沙箱默认是 workspace-write，AI 的文件工具写不进预览目录（会报"目录出错"）。工具内部不受该沙箱限制。
  • 工具返回的 url 字段是唯一有效的 URL，AI 应原样内嵌（![alt](url)），不要自行拼接或猜文件名。
  • 通过工具复制的文件名为 8位随机-原名（如 7faf2295-theme-gallery.png），这是与手动复制区分的特征。
  • 工具返回 ok:false 时，把 error 原样报告给用户（文件不存在 / 类型不支持等）。

安全（自审声明）

  • 零依赖、零安装期脚本：只依赖 node 内置模块和 ctx；不联网、不读凭据、不起子进程、无 eval。
  • 路径隔离：所有响应都经 realpath 校验必须位于配置根目录内；拒绝 ..、反斜杠、NUL。
  • 类型白名单：仅 png / jpg / jpeg / webp / gif / avif / bmp，其他扩展名返回 415。
  • 无目录列表；未知路径 404。
  • 工具只复制显式传入的文件，不会暴露预览目录以外的任意路径。

已知限制

  • URL 固定用 127.0.0.1；局域网访问需自行替换为本机 IP（并确保 web 服务绑定 0.0.0.0，如 dsh-lan-access 插件）。
  • 预览目录内的文件不设清理策略，长期使用请定期手动清理。
Back to searchOpen GitHub repository

More related plugins

View category