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
