fulander0301/dsh-tool-read-tiff ↗★ 0
dsh-tool-read-tiff
Model-facing read_tiff tool for the dsh web GUI: decodes TIFF/TIF images (classic and BigTIFF, multi-page, LZW / Deflate / PackBits / CCITT / JPEG compression, bilevel, 8/16-bit and float) into a viewable PNG plus full header metadata, and — when a vision endpoint is configured — returns a text-only model's description of the image. Hot-pluggable via ~/.dsh/cordis.patch.yml + a profile node_modules link, no dsh source changes.
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:fulander0301/dsh-tool-read-tiff说明文档
阅读完整 README ↗dsh-tool-read-tiff — TIFF 读取工具插件
English | 中文
模型侧 read_tiff 工具：为纯文本模型（DeepSeek V4 等）提供读取 TIFF/TIF 图片的能力——
这是普通视觉管线与浏览器都无法直接处理的格式。每次调用加载一个 TIFF（本地文件路径或
http(s) URL），把指定页解码成可预览的 PNG，并返回完整的头部元数据（尺寸、页数、压缩方式、
光度解释、各通道位深、字节序）。配置了视觉端点后，它还会把解码出的 PNG 交给 OpenAI 兼容的
视觉模型描述；只有文本与元数据进入对话，TIFF 与 PNG 的字节绝不进入会话记录。
解码由 sharp（libvips + libtiff）完成，常见的真实 TIFF 变体开箱即用：经典与 BigTIFF、多页、LZW / Deflate / PackBits / CCITT Group 3 & 4 / JPEG 压缩、二值（1-bit）、8/16 位与浮点采样。
能力
| 能力 | 说明 |
|---|---|
| 两种输入 | 本地绝对路径，或 http(s) URL（拒绝重定向） |
| 解码 + 转换 | 把指定页解码成 PNG，写到源文件旁（URL 输入则写到 outputDir / 系统临时目录）；路径经 convertedPath 返回，会话中可直接预览 |
| 完整头部元数据 | width / height / pages / page / channels / depth / space / density，外加 TIFF 特有信息：compression（lzw、deflate、ccitt-group4、jpeg、none…）、photometric（rgb、black-is-zero、cmyk…）、bitsPerSample、samplesPerPixel、byteOrder、variant（classic / bigtiff） |
| 多页 | page 是零基页索引；pages 报告总页数，模型可逐页遍历多页传真 / 扫描件 |
| 可选视觉 | 配置 baseURL + model 后，解码出的 PNG 发给 OpenAI 兼容端点（Chat Completions），答案以 text 返回；prompt 参数携带你的精确指令 |
| 无配置也能组合 | 未配置端点时，工具仍解码 + 转换 + 报告元数据，并返回 note 引导模型对 convertedPath 调用 describe_image |
| 实时配置卡 | 设置 → 插件配置 → 「TIFF reading」卡修改 baseURL / / API key / 各项上限，即时生效，无需重启 |