img-preview

Readme

# 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 生效）

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

成功后回复中输出：

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

多图：

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

## 安装

```sh
# 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>` 渲染时不执行脚本（浏览器图片上下文屏蔽脚本），点击看原图走新标签页。