pixdebug —— VS Code 版 PixUI 模拟器

在 VS Code 里拉起 PixUI 原生渲染容器（UE），用自带调试器（元素 / 样式 / 控制台 / 网络 / 性能）调试活动页。

画面始终留在原生容器窗口里，不把渲染塞进 Webview —— 插件只负责命令与界面，容器窗口与页内探针交给独立的无壳宿主进程管理。

快速开始

调试界面在两处任选（前提是用户启动好了小应用活动）：

改了地址或分辨率，执行 pixdebug: 重启模拟器 生效。

命令面板（Ctrl+Shift+P）输入 pixdebug 可见全部：

设置 → 搜索 pixdebug：

设置	默认	说明
`pixdebug.url`	空	活动页地址；留空自动取 PixIDE 最近预览的活动页
`pixdebug.width` / `height`	`956` / `440`	设备视口宽高
`pixdebug.autoStart`	`false`	插件激活后自动拉起模拟器
`pixdebug.topCropAdjust`	`0`	顶部裁剪微调（物理 px）。页面顶栏被削 → 填负数（如 `-36`）；顶部露出引擎灰条 → 填正数
`pixdebug.hostPath`	空	自定义模拟器 exe 路径；留空用插件自带
`pixdebug.probeInject`	`false`	是否注入页内探针。关掉后元素树/样式/控制台/网络/性能全部不可用，只用来二分"容器崩溃是不是探针造成的"
`pixdebug.probeSwitches`	空	探针二分开关（逗号分隔，如 `csscan=0,mo=0`），容器异常崩溃时定位探针哪一步踩崩引擎
`pixdebug.netBudgetMB`	`20`	网络面板全量快照总字节预算，超了从最老记录开始丢 body
`pixdebug.netRecMax`	`400`	网络面板最多保留多少条记录
`pixdebug.netBodyMB`	`2`	单条响应捕获上限
`pixdebug.netReqKB`	`4`	单条 POST 请求体捕获上限（FaaS 的 `data` 在这里面，太小会看不到查询参数）
`pixdebug.netQueueMB`	`8`	探针未连上时消息队列的字节预算

改设置后重启模拟器生效。

容器启动异常或崩溃时，先看 pixdebug: 查看模拟器日志 —— 启动参数、摆位、崩溃退出码都在里面（退出码会翻成人话，例如 0xC0000374 = 堆损坏）。

架构细节、构建方式、历史排障记录见仓库根目录的 ARCHITECTURE.md（发布流程见 RELEASE.md）。