dsh-zoom-viewer
A zoomable image viewer for the DSH right sidebar. It registers its own image renderer with the host's
document-preview registry, so any image opened in the sidebar gets real navigation instead of a static <img>:
- Wheel zoom anchored at the pointer — Ctrl+wheel or a trackpad pinch uses a finer step; range 5%–1600%
- Drag to pan, with the viewport scrollbars kept in sync
- Double-click to reset to the fitted view
- Fullscreen overlay for the current image, closed with Esc or the 退出全屏 button
- Toolbar:
− / percentage / + / 适应 (fit) / 宽 (fit width) / 1:1 / 全屏
The viewer in the DSH sidebar: the tab, the active renderer label 缩放图片 and the viewed image
Install
# the DSH CLI — use --profile desktop for the desktop app
dsh plugin --profile web add dsh-zoom-viewer
# no dsh on PATH? run the CLI through npx
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-zoom-viewer
# or straight from this repository instead of npm
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:1378616343/dsh-zoom-viewer
The same thing from the DSH UI: 插件 / Plugins page → the arrow menu → 安装第三方插件 / Install third-party
plugin, then paste dsh-zoom-viewer, this repository's URL, or the local directory containing package.json.
Restart DSH afterwards — the plugin tree is only read at startup.
From a plugin-market index source
The Plugins page also accepts an 索引源 / index source. This repository ships one (format 1, validated against
DSH's own @deepseek-ai/dsh-plugin-market-index):
https://raw.githubusercontent.com/1378616343/dsh-zoom-viewer/main/market/index.json
The entry then appears under Discover and installs with one click. Regenerate and re-validate it with:
node tool/build-market-index.mjs --repo https://github.com/1378616343/dsh-zoom-viewer
Compatibility
- Targets the host document-preview registry (
documentPreviews plus the sidebar.right.tab.document slot) of
DSH desktop 0.2.1-rc.2, and registers above the built-in image renderer, so it becomes the default for
png jpg jpeg gif webp bmp ico svg. A file whose extension lies about its content is still matched, by
magic-number sniffing.
- No build step and no runtime dependencies:
lib/client.js is a prebuilt browser module, and react /
react-dom are taken from the host's module table.
- Declares no
engines.dsh range and no @deepseek-ai/dsh* peer dependency, so the plugin manager's
compatibility gate never refuses it. react is an optional peer only.
Permissions
Nothing of its own: no network requests, no filesystem access, no install scripts. The viewer renders the bytes
the host hands it and keeps to its own CSS class prefix.
Uninstall
Plugins page → remove the entry → restart DSH.
Layout
| File | Role |
|---|
lib/client.js | Browser half: the renderer definition and the zoom / pan implementation (single file, no build) |
lib/index.js | Host half: an empty plugin, existing so the bundle is manageable from the profile |
cordis.patch.yml | The bundle's load row |
locale/*.json | Renderer name and UI strings (en / zh) |
market/index.json | Plugin-market index, format 1 |
tool/build-market-index.mjs | Generates and validates that index |
docs/screenshot.png | The screenshot above |
NOTES.md | Design and evidence notes (which host extension point, and why the third-party viewer API cannot be used) |
DISTRIBUTION.md | Install and publish runbook |
License
MIT — see LICENSE.
中文说明
为 DSH 右侧栏里的图片加上真正的查看器：以光标为锚点的滚轮缩放（5%–1600%，Ctrl+滚轮 / 触控板双指更细）、
按住拖拽平移、双击复位，工具栏提供 − 百分比 + 适应 宽 1:1 全屏（Esc 退出）。它注册到宿主的图片预览注册表并排在内建
渲染器之前，所以 png jpg jpeg gif webp bmp ico svg 默认由它接管。
安装：dsh plugin --profile desktop add dsh-zoom-viewer（或插件页的「安装第三方插件」），装完要重启 DSH。
本插件不发网络请求、不读写文件、不带安装脚本，lib/client.js 是预构建产物，无需 npm install 之外的任何步骤。
