Node Inspect 调试器

要解决的问题

Node.js 本身自带 inspector，但日常调试经常停在两种尴尬状态：要么得打开浏览器里的 DevTools 界面，在远程机器、容器或 SSH 会话里根本没有 GUI；要么靠 console.log 和 --inspect-brk 手动拼参数，断点管理全靠自己写脚本。当问题出现在异步回调、Promise 链或长驻 worker 里时，栈帧和变量状态稍纵即逝，日志根本追不回来。

核心能力与工作流程

这个技能把 --inspect 与 Chrome DevTools Protocol（CDP）串成一条 CLI 可驱动的链路，具体分几步：

• 启动注入：为目标进程附加 --inspect 启动参数，让内置 inspector 暴露 CDP 调试端口。
• 协议接入：通过 CDP 命令行通道连接到目标运行时，不再依赖浏览器 UI。
• 断点控制：在源码位置设置、启用和移除断点，支持命中后暂停检查。
• 状态检视：在断点处查看调用栈、局部变量与表达式求值结果。
• 终端友好：面向 TUI/终端环境组织交互，适合在无图形界面的服务器上直接用。

适用边界与注意点

• 只覆盖 Node.js 运行时，Python、Go、JVM 等其他语言需配合各自的调试方案（例如同一体系下的 python-debugpy）。
• inspector 会监听本地端口，远程调试时需注意端口暴露与防火墙策略，避免调试通道被外部访问。
• 生产进程通常不应开启 --inspect，建议只在开发与排障环境使用。
• 异步代码、微任务与 worker 线程的暂停时机受事件循环影响，复杂时序下需要结合栈帧反复确认。