DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在会话区进行开发时，通常需要切换工具来处理调试、上位机或监控任务。dsh-vision-bench 插件为 DSH 的会话视图提供了「Vision 模式」，将 Keil 调试、Modbus HMI 操作和实时监控整合在一个工作台中。
插件定位¶
dsh-vision-bench 是一个客户端插件，由开发者 xingyingyuzhui 维护。它解决了在 Session 视图中同时进行嵌入式调试、上位机点表管理和实时监控的需求。同一份现场状态同时供给界面和当前 Session 的 Agent 使用。
核心功能¶
该插件主要提供以下工作区能力：
- 会话区工作台：在会话区标签页提供「调试」、「上位机」、「监控」三个视图，内容互不干扰。
- Keil 编译与烧录：支持
.uvprojx工程（暂不支持.uvmpw）。提供编译日志查看（支持搜索）、产物哈希校验、OpenOCD 烧录确认卡，支持 GDB/MI 协议。 - Modbus RTU 读写与监控：支持 Modbus RTU 主机读写与从机监听。功能码 01/03 可写（FC05/06 单点，FC15/16 批量），02/04 只读。写入后显示写前值、目标值与回读值。
- 串口报文订阅与筛选：订阅串口原始流（RTU 记 ADU，TCP 显示归一化报文），提供筛选与查看功能。
- 可视化图表与告警：提供实时可视化图表、告警管理与操作记录，支持 CSV 导入导出点位表。
- Agent 集成与受控写点：Agent 可以调用
vision_bench工具进行操作。真实写点（线圈/寄存器）、烧录等敏感操作需界面批准。
安装与启用¶
安装前请确保 DSH 版本为 0.1.5-rc.1 或更高。
Web 环境安装¶
使用官方插件命令安装：
dsh plugin --profile web add github:xingyingyuzhui/dsh-vision-bench
开发环境建议先打包本地包再安装，避免将源码树中的 node_modules 链接进来：
npm pack
dsh plugin --profile web add ./dsh-vision-bench-*.tgz
安装完成后重启 dsh web，打开「调试」、「上位机」或「监控」标签，或在设置中进入 Vision 页面。新建 Session 时可选择「Vision 模式」。
Desktop 环境说明¶
官方 Desktop 版本的完整安装包尚未发布到 npmjs.org。Desktop 版的 Modbus RTU 功能因 serialport 不在允许的构建列表中，暂不完整支持。Windows 10/11 与 Keil 真机的集成处于验收暂缓（DEFERRED）状态。
典型用法¶
- 调试：在「调试」标签页选择 Keil 工程，配置 Target，点击编译。编译失败时可在应用内查看日志。确认无误后，通过烧录确认卡批准固件写入。
- 上位机：在「上位机」标签页配置串口或 TCP 连接，添加设备与点位。开启采集后，可查看点位数值变化。
- 监控：在「监控」标签页配置可视化组件（曲线、柱状图等），订阅串口报文。
- Agent 协作：Agent 在会话中调用
write工具时，界面会弹出确认卡片，批准后执行。
注意事项¶
- 版本依赖：需要 DSH
0.1.5-rc.1及以上版本。 - 权限：插件以当前 DSH 进程权限运行，请确保安装源可信。
- 功能边界：Windows 下 COM 端口独占，占用时会返回
PORT_IN_USE。CAN 监视功能尚未实现。 - License：MIT 许可证。
总结¶
dsh-vision-bench 将嵌入式开发中的调试工具与上位机监控能力下沉到了 DSH 的会话视图中。对于需要频繁在代码、串口调试和 Modbus 交互之间切换的开发者，这能减少工具切换的时间，提供更连贯的工作流。
- GitHub 仓库：https://github.com/xingyingyuzhui/dsh-vision-bench
- 插件目录：https://www.skillhub.cn/plugins/xingyingyuzhui/dsh-vision-bench
