Electrobun Debugging 是一份针对 Electrobun 桌面应用的调试与故障排查指南，适用于使用该框架开发桌面应用的场景。
主要能力与用法：
- 开发环境：可用 bun run dev 启动热重载；用 DEBUG=* bun run dev 或 DEBUG=electrobun:* bun run dev 输出调试日志；可通过 .env.development 配置 NODE_ENV、DEBUG、ELECTRON_ENABLE_DEVTOOLS 等。
- 主进程调试：主进程日志输出到终端，可自定义结构化 logger；用 bun --inspect run dev 或 bun --inspect-brk run dev 启动 Bun 调试器，再通过 chrome://inspect 在 Chrome DevTools 中连接。可注册 uncaughtException、unhandledRejection 等全局错误处理，并在 RPC handler 中捕获和记录错误。
- Webview 调试：可用 openDevTools、openDevTools({ mode: "detach" })、toggleDevTools、closeDevTools 控制 DevTools；在 Webview 控制台输出日志，并通过 window 的 error 与 unhandledrejection 事件捕获错误后经 RPC 上报主进程。
- RPC 排查：可包装 RPC handler 记录调用名、耗时与错误；在 Webview DevTools 中直接调用 electroview.rpc 方法测试，配合 try-catch 与 console.time 验证可用性和性能。
- 性能与内存：主进程可用 perf_hooks 的 PerformanceObserver 做 CPU 测量，用 process.memoryUsage() 监控内存；Webview 可用 DevTools 的 Performance / Memory 面板，或用 performance.now()、performance.memory 粗略测量。
- 常见问题：涵盖依赖未安装、原生模块编译失败、WebView2 缺失、窗口不显示、RPC 不可用、内存占用高等排查清单，以及 macOS 签名与权限、Windows SmartScreen、Linux WebKit 依赖等平台问题。
限制：资料以调试流程与代码片段为主，未提供该技能的安装或引入方式、版本要求与支持范围等信息，暂未提供。