前言¶

在 DSH（DeepSeek Harness）中发送截图时，通常需要先圈出重点。由于编辑器中的待定图片仅支持预览，圈画往往需要在其他应用中进行，处理完后再重新附加文件。这个插件将这一步骤直接移到了编辑器内部。

下面介绍 dsh-image-annotate 插件的功能、安装方式与使用方法。

简介¶

dsh-image-annotate 是一个 DSH web 插件，由 janewas 维护，采用 MIT 许可证。它的核心功能是：点击待定图片即可打开标注对话框，支持画笔、方框、箭头和可移动/调整大小的文字框工具，并将标注后的 PNG 作为新附件插入，原图片保持不变。

插件不重置 DSH 的 UI，最小化占用空间，且无依赖、无配置文件。

安装前请确保 DSH 版本为 0.1.5-rc.1 或兼容版本。

使用官方推荐的 GitHub 方式安装：

dsh plugin --profile web add github:janewas/dsh-image-annotate

安装命令会将插件添加到配置文件中，插件会通过自身的 cordis.patch.yml 进行挂载。由于配置列表在启动时读取，安装后请重启 dsh web。

该插件主要提供以下能力：

点击交互：点击待定图片的缩略图，打开标注对话框，而非原本的预览灯箱。
绘图工具：提供四种工具
- 画笔：自由绘制。
- 方框：拖拽绘制边框。
- 箭头：拖拽绘制箭头。
- 文字：拖拽创建文字框，点击创建默认大小框。
文字框特性：
- 移动与调整大小：使用文字工具时，拖拽框体移动，拖拽 8 个手柄调整大小。文字会根据框的大小自动重排（自动换行），框体不会缩小到文字无法显示的最小可读尺寸。
- 编辑与删除：双击框内文字可修改（清空文字即删除框），选中后按 Delete 键删除。支持 Ctrl/Cmd+Z 撤销移动、调整大小、修改文字或删除操作。
- 样式：支持矩形、圆角、椭圆三种形状，以及透明、底纹、实心三种填充方式，使用当前选定的颜色。
样式选项：提供 6 种颜色（红、黄、绿、蓝、白、黑）和 3 种线宽（细、中、粗）。
操作控制：支持撤销（按钮或 Ctrl/Cmd+Z）、清除和关闭（Esc 或点击背景）。
结果输出：点击「插入到输入框」后，标注后的 PNG 作为新附件插入，原图片保留。

操作流程如下：

进入设置 → 图片标注 页面进行配置。设置会保存在浏览器的 localStorage 中（键名为 dsh-image-annotate.settings.v1），仅对当前浏览器和源站有效。

主要配置项包括：

DeepSeek Harness 的理念是「一切皆插件」。社区目录（如 skillhub.cn）收录了各类插件，与 DeepSeek 或幻方官方无直接从属关系。本文仅介绍插件本身的功能与使用方式。