前言¶
在 DeepSeek Harness（DSH）里查看对话附件时，图片、PDF 或 Office 转 PDF 的预览往往要先放大，再通过滚动条在画面里找细节。原生侧栏支持缩放，但放大后出现滚动条时，用鼠标拖动画布并不顺手；双栏并排时，若只想清空某一栏，也可能要逐个关标签或触发「最后一栏关闭就整列收起」的行为。社区插件 dsh-image-drag（仓库 YuyuYuu-wyt/dsh-image-drag）只做两件事：在预览上增加 Ctrl + 左键拖动平移，以及在每个停靠分栏的标签栏注入本栏关闭按钮，不接管 DSH 原生 UI。
这是什么¶
dsh-image-drag 是纯浏览器侧的 DSH 客户端插件，维护者为 YuyuYuu-wyt，在「插件 → 已安装插件」中显示为 图片拖动（npm 包名 dsh-image-drag，当前版本 0.1.0，MIT 许可证）。Host 侧 lib/index.js 为空，逻辑集中在 lib/client.js，通过 bundle 注入；无网络请求、无额外权限、无持久化状态。要求 DSH >= 0.2.0-rc.2（README 注明在 0.2.1-rc.2 验证），并具备 dsh CLI。
核心功能¶
Ctrl + 左键拖动平移预览¶
在右侧边栏打开图片、PDF，或 Word/PPT 等转为 PDF 的预览后，用 Ctrl + 滚轮 或缩放控件放大到出现滚动条，按住 Ctrl 再按住鼠标左键拖动即可平移画面。
- 平移直接改预览滚动容器的
scrollLeft/scrollTop，与「适应宽度」、25%–400% 固定缩放、Ctrl + 滚轮缩放兼容；不替换图片 Blob URL，也不影响 PDF 矢量与文本层。 - 按住 Ctrl 悬停时光标为「抓手」，拖动中为「抓取」。
- 仅左键拖动仍为原生行为（PDF 选字不受影响）；一次拖动结束后会吞掉落在预览上的那次 click，减少误触 PDF 链接，其它区域点击不受影响。
每个分栏的小关闭按钮¶
右侧边栏每个停靠分栏的标签栏会多一个关闭按钮：
- 单栏：提示「关闭全部」——清空本栏内容，留在「开始」页，侧栏保持展开。
- 双栏：左右各一，提示「关闭本栏」——只清空该栏，另一栏与双栏布局不变。
- 若该栏原本没有「开始」页，关闭时会自动补上；两栏都清空后左右均为「开始」，再点无操作。
- 图标尺寸与风格沿用原生按钮，悬停约 0.4 秒显示提示。
README 中的已知边界：HTML 预览在沙箱 iframe 内，不在拖动范围；文本 / 代码 / Markdown 预览保持原样。触屏与触控板双指滚动仍走系统手势，本插件只处理 Ctrl + 左键 的鼠标手势。侧栏完全收起、只剩浮动窗口时，需先展开侧栏才能看到顶部关闭按钮；浮动窗口内仍用原生每个 tab 的关闭。
安装与启用¶
安装前请自行查看仓库源码与 MIT 许可证；插件在 DSH 桌面 profile 的 Web 客户端进程中运行，权限与当前 DSH 进程一致。
方式 A：从 npm 安装
dsh plugin --profile desktop add dsh-image-drag
方式 B：从 GitHub 安装
dsh plugin --profile desktop add "github:YuyuYuu-wyt/dsh-image-drag"
方式 C：克隆后本地 link（README 原文；需自行 clone 后执行）
dsh plugin --profile desktop add "link:$PWD"
或使用仓库内脚本（在克隆后的目录）：
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Profile desktop
安装后刷新 DSH 页面（Ctrl+R）；若插件未出现，完全退出 DeepSeek Harness 再打开。
卸载：
dsh plugin --profile desktop remove dsh-image-drag
典型用法¶
- 在 DSH 右侧边栏打开一张图片或 PDF 预览，放大至出现滚动条。
- 按住 Ctrl，鼠标左键在预览区域拖动，观察画面平移；松开后再试 PDF 选字，确认未按 Ctrl 时仍为原生行为。
- 开启双栏布局，分别在左右栏打开不同预览；点击某一栏标签栏上的小关闭按钮，确认仅该栏回到「开始」，另一栏内容保留。
适用场景与注意¶
适合经常在 DSH 侧栏里放大查看图片、PDF 或 Office 转 PDF 预览、并希望用 Ctrl + 拖动 平移，或在双栏下按栏清空而不收起整列侧栏的用户。不适合依赖 HTML 预览内平移、或主要用触屏拖动画布的场景（见上文边界）。
DSH 生态强调「一切皆插件」；社区目录页 skillhub.cn/plugins/YuyuYuu-wyt/dsh-image-drag 为独立站点收录，与 DeepSeek / 幻方无官方从属关系。README 提到独立验收 15/15 项 PASS（含无插件 baseline 对照），可作为行为预期的参考，非使用本插件的前置条件。
结尾¶
dsh-image-drag 用最小改动补全侧栏预览的平移与分栏关闭体验，与原生缩放、PDF 选字并存。进一步了解可访问目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/YuyuYuu-wyt/dsh-image-drag
- GitHub：https://github.com/YuyuYuu-wyt/dsh-image-drag
