DeepSeek Harness 插件

img-preview

Inline image preview for DeepSeek Harness: display local image files (PNG/JPG/WebP/GIF/AVIF/BMP/SVG/ICO/TGA) directly inside the chat — fence language `img` + `img_serve` tool. Double-click opens a(英文原文)

跳到安装方式

来源信息

GitHub 仓库
dhb861832993-star/img-preview
最近更新
2026年8月18日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/dhb861832993-star/img-preview
插件名:img-preview
作者:dhb861832993-star

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

img-preview

在 DeepSeek Harness 对话框内直接内联展示本地图片的插件:不用再给文件路径让用户手动打开。

> 🔌 生态:仓库已挂 #dsh · #dsh-plugin · #deepseek-harness · #image-preview topic,欢迎社区收录。

  • 宿主端:注册 img_serve 工具(校验图片路径、签发可访问 URL)与 /plugins/img-preview/files 回环文件路由(仅服务工作区内的 png/jpg/jpeg/webp/gif/avif/bmp/svg/ico/tga;TGA 自动转码为 PNG,浏览器原生不显示 TGA)。
  • 客户端:检测 `img 栅栏,渲染为内联图片(支持标题、双击独立查看 + 自由缩放、多图网格);解析容错反斜杠路径(H:\dir\img.png 自动归一化为正斜杠,避免非法 JSON 转义)。
  • 系统提示:自动注入使用说明,图片生成/出现后主动触发展示;img_serve 返回的提示直接给出正斜杠路径,保证 fence 是合法 JSON。

图片交互

  • 双击缩略图 → 打开独立查看器(全屏遮罩)。
  • 独立查看器内:滚轮缩放(5%–2000%,以光标为中心)、拖拽平移双击切换 100% ↔ 2.5 倍。
  • 工具栏: / 百分比 / / 适应(适应窗口)/ 100%(原始大小)/ 原图(新标签页打开)/ (关闭)。
  • ESC 或点击遮罩空白处关闭。

用法(对 Agent 生效)

# 工具
img_serve(path: "H:/工作-deepseek/dm_output/xxx.png")

成功后回复中输出:

{"path":"H:/工作-deepseek/dm_output/xxx.png","label":"可选标题"}

多图:

{"images":[{"path":"a.png"},{"path":"b.png","label":"B"}]}

安装

# GitHub 仓库安装(社区推荐方式)
dsh plugin --profile web add github:dhb861832993-star/img-preview

# 或本地开发(link 方式)
dsh plugin --profile web add link:H:/工作-deepseek/img-preview

重启 dsh web 服务,新会话生效。安装后模型会自动获得 img_serve 工具并在回复中直接内联展示图片。

安全模型

  • 浏览器无法直接读本地磁盘,由宿主通过回环文件路由提供图片。
  • 仅允许工作区根目录内的路径(规范化 + 前缀校验,防目录穿越)。
  • 仅允许图片扩展名(png/jpg/jpeg/webp/gif/avif/bmp/svg/ico/tga),超 128 MiB 拒绝。
  • TGA 在宿主端解码(支持 1/2/3/9/10/11 类型、8/16/24/32 位深、RLE 压缩、双原点约定)并用 node:zlib 编码为 PNG 输出,插件保持零依赖。
  • SVG 经 <img> 渲染时不执行脚本(浏览器图片上下文屏蔽脚本),点击看原图走新标签页。