前言¶
在基于 DeepSeek Harness（DSH）开发智能体时，图像审查和标注是一个高频场景。现有做法通常需要截图、标注、复制文字，再分多次发送，流程割裂且容易丢失上下文。图片反馈插件通过原生侧栏界面，将图像选择、标注和反馈合并为一次操作，减少切换窗口和重复粘贴。
插件定位¶
这是 yyyzl 维护的 DSH 客户端插件，包标识为 @yyyzl/dsh-image-feedback，当前版本 0.2.0。它为 Harness 提供 Native 右侧栏插件：框选后直接写意见，拖动选区调整位置，再将原图、编号参考图与反馈独立发送到当前会话。
核心能力¶
- 框选与标注：在图上拖出矩形后，意见框自动获得焦点，可直接输入文字，不必再点“添加意见”。
- 拖动调整：拖动矩形可调整布局，移动时才拆为图块；不移动则保留位置批注。
- 独立发送：发送反馈时，独立提交真实原图、红色编号参考图和结构化意见，不发送或清空聊天输入框原有草稿。
- 常用操作：标记为红色编号（白字红底）；点击编号或意见行继续编辑；Esc 取消当前文字事务，Ctrl/Cmd+Enter 完成；Ctrl/Cmd+Z 撤销、Ctrl/Cmd+Shift+Z 重做；点批注：点击编辑，拖动编号改变位置，不移动图像像素。
安装与启用¶
安装前在 v0.2.0 Release 核对预构建包和 SHA256SUMS.txt，使用下方固定版本地址。
请当前 Harness 会话中的 Agent 使用正式 plugin_manager 工具。先查询：
{"action":"list_bundles"}
确认没有冲突的旧版处于启用状态后，再安装：
{"action":"install_bundle","target":"https://github.com/yyyzl/dsh-image-feedback/releases/download/v0.2.0/yyyzl-dsh-image-feedback-0.2.0.tgz"}
安装影响当前 profile 的所有会话。遵循管理工具返回的版本限制、警告和后续操作；需要刷新或重启时按提示执行。不要手动编辑 profile、替换宿主文件或绕过版本限制。
停用前再次核对 bundle 名称，然后使用：
{"action":"set_bundle","target":"@yyyzl/dsh-image-feedback","enabled":false}
重新启用将 enabled 改为 true；卸载使用 remove_bundle。
典型用法¶
- 点击聊天输入框工具行的 图片反馈，打开侧栏。
- 粘贴、拖入或选择图片，也可打开 会话图片。路径和 Base64 导入位于更多菜单；意见框内的粘贴仍按文字处理。
- 保持默认 选择，在图上拖出矩形。松手后意见框自动获得焦点，可直接输入。
- 拖动矩形调整布局：真正移动时才拆为图块；不移动则保留位置批注。直接拖动已有图块即可继续移动。
- 点击 发送反馈，独立提交真实原图、红色编号参考图和结构化意见。填入文字 只插入反馈文本，不携带图片，也不自动发送。
只移动图块、不写文字也可以发送。“已排队”表示宿主接收请求，不代表模型已生成修改结果。
注意事项¶
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 从本地旧版迁移时，不能同时启用旧版和公开版，它们共享存储域、命令和界面标识。
- 坐标使用宿主正规化后的原图像素；原图不改写，图块只平移，不缩放。
- 不提供 OCR、语义抠图、补背景、旋转、视频或多图批处理。
生态背景¶
DSH 理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
