GaryProbe for VS Code 0.2.0

在 VS Code 编译 STM32 / ESP32 工程，经本机 USB-C、BLE 或 SSH 现场主机连接 GaryProbe、提交烧录并查询结果。

安装与连接

1. 下载 https://www.garycli.com/garyprobe/vscode/garyprobe-vscode-0.2.0.vsix ，在扩展菜单“从 VSIX 安装”，重新加载窗口。
2. 安装 Python 3.10+（推荐 3.12），打开受信任工作区，点击“安装 / 检查执行端”。首次需要网络下载 Python 依赖。
3. CH585M 2.8.37 长按 PB16 约 1 秒开机。电脑连接探针 USB-C 数据线，不能只有 WCH-Link；USB-A 留给外部 ESP 目标。
4. 点击“连接探针”，选择 USB / BLE 条目。只有签名认证通过才显示连接，不把广播名或 USB VID/PID 当作身份凭据。
5. 远程操作时选择 SSH 主机，再为它安装执行端。密钥、主机指纹应已配置；现场主机必须实际能通过 USB 或蓝牙访问探针。

内置 GaryProbe-AF01（PCB1 CH585M）与 GaryProbe-9C7F 公钥。其他设备使用制造商提供的可信公开身份 JSON；不导入私钥，也不信任设备自报公钥。

USBHS 需要 libusb 和系统设备权限；macOS 可安装 libusb，Linux 配置对应 USB 权限，Windows 可能需要 WinUSB。BLE 需要系统蓝牙权限（Linux BlueZ）。扩展不会自动更换驱动。当前能力来自配套 Host 1.6.8；不同固件按认证后的能力判断。

设置

• garyprobe.python：创建隔离环境的 Python；Windows 可填 python。
• garyprobe.runtimePython：可选绝对路径，必须装有 Host 1.6.8；默认由扩展管理版本隔离环境。
• garyprobe.transport：auto（USB 与 BLE 扫描）、usb、ble。
• garyprobe.identityFile：其他设备的可信公钥 JSON。
• garyprobe.idfExport：macOS/Linux ESP-IDF export.sh 路径；Windows 使用已有编译任务。

VS Code 与 MCP 共用硬件锁及后台任务目录，不抢占活动烧录，也不删除锁文件。退出编辑器关闭空闲连接；后台任务可以继续，但电脑与设备须保持运行。

工程

点击“配置工程”，或写入 .vscode/garyprobe.json：

{"version":1,"kind":"stm32","part":"STM32F103C8T6","artifact":"build/firmware.elf","base":"0x08000000","build":{"type":"make"}}

ESP-IDF：

{"version":1,"kind":"esp32","manifest":"build/flasher_args.json","build":{"type":"esp-idf"}}

支持 Make、CMake、ESP-IDF、已有 VS Code Task；编译失败/取消不烧录。固件必须在工程内，总量不超过 16 MiB。STM32 需要准确型号及预先安装的官方 DFP：在执行端配套 CLI 运行 garyprobe-stm32 install-packs --family F1，按实际芯片选择家族。目录 F0/F1/F2/F3/F4/F7 不等于逐型号实测。

ESP 使用清单中的芯片、地址和 BIN，传输先验 SHA-256，再由 esptool 离线应用 flash_mode/freq/size，保存最终哈希与镜像，交给 Host 做一致的回读验证。日志含原始及最终哈希，不静默忽略清单参数。不操作加密、保护解锁或 eFuse。

审批与结果

提交前确认接线及目标。设备处于审批模式时，由实体按键 ① 跳过、② 批准、③ 拒绝；扩展不能代按批准或切换信任。缺少审批能力的旧固件不能执行新版受保护烧录，但仍可认证连接。

固定提交键防止重复任务。通过“最近烧录结果”查询待审批、执行、校验、失败；只有成功状态与非空回读证据才报告烧录成功。中断、拒绝、过期或未知结果不自动重刷；提交成功不等于烧录完成。

CH585M 外部 SWD：H2.4/PB15 SWCLK，H2.2/PB14 SWDIO，H2.10/PB6 NRST，H2.7/9 GND。WCH-Link 共用 SWD 引脚，外部烧录前须释放其驱动线。不同板型不能混用引脚。ESP 通过探针 USB-A 的 CH34x 桥接。

验证范围

纯软件连接/任务回归、JSON-lines 桥和 VS Code 扩展宿主验收见本站 validation.json。模拟测试不等于真板烧录验收；无在线设备时不宣称物理连接通过。

这里提供可直接安装的 VSIX，不宣称 Marketplace 已更新。扩展不升级固件、bootloader 或设备身份。

源码检查：npm test；配套 Host Python 运行 test/test_worker.py；npm run package 打包。只分发公开运行库，不含私钥或设备固件。