dsh-mcu-debug

在 STM32、PY32 等 Cortex-M 上调试和烧录，很多人习惯把 OpenOCD 当黑盒用：能连上、能下断点就算过关。真正麻烦的是两类「看不见」的事故——flash 上的软件断点若没在退出前清掉，读回再烧录会把断点指令写进固件，上电就停、日志却像一切正常；工作区或插件路径里一旦有中文，Jim-TCL 按窄字符读配置会直接炸。本插件不是简单包一层命令，而是把收尾流程、工作目录和会话记录焊进结构里，让 openocd 只在私有会话目录里跑，离开目标前固定清断点，并把每次 argv 与输出落盘，事后能复盘。

核心能力围绕一条完整链路：探针经 CMSIS-DAP / DAPLink，底层用插件自带的 OpenOCD 副本（与 IDE 原件只读隔离）；通过 mcu_* 工具组完成环境探测、多探针锁定、寄存器与内存、读闪存与烧录擦除、断点与会话级 openocd/gdb，以及串口长连接收发。多探针并存时要求用序列号明确指定，宁可报错也不猜错设备。工具参数在注册前会经 harness 子集清洗，避免一条非法 schema 拖垮整次对话。

适合正在用 DSH 做嵌入式开发的工程师：手头是 DAPLink 或同类探针、目标以 STM32 / PY32 为主，需要可审计的烧录与调试会话，又希望串口日志别因为反复开关口把板子 DTR 复位抖个不停。若你关心「断点会不会悄悄写进固件」和「插件会不会一装就全对话崩」，这个插件的设计就是冲着这两点去的。