出海助手-Node调试
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9c953624/yimubiao-node-debug。
技能介绍
什么时候需要它
线上 Node 服务「偶发卡死」、测试在 CI 里时好时坏、子进程或启动竞态很难用 console.log 复现——这类问题往往要看到隐藏作用域里的局部变量、异步挂起点,或确认某行到底有没有被执行。本技能面向需要 Node.js inspector 接入的调试场景,默认走 node inspect 与调试 REPL,在需要脚本化断点、堆快照或 CPU profile 时再考虑 Chrome DevTools Protocol。
技能如何帮你排错
技能会按场景引导你:从入口暂停(node inspect / --inspect-brk)、附着已有 PID(SIGUSR1 后 node inspect -p),到用 sb 设断点、bt 看调用栈、watch 监视表达式、在 REPL 里直接查看当前作用域。原文还覆盖 TypeScript(如 tsx)、Vitest 单 worker 单文件调试、子进程通过 NODE_OPTIONS 传播 inspector、以及用 /json/list 确认附着目标等实操要点;性能侧可采集 CPU profile 与 heap snapshot 到本地再用 Chrome DevTools 打开。
边界与注意点
--inspect 不会自动停在第一行,若要在跑代码前完成断点配置应使用 --inspect-brk;并行调试需注意默认 9229 端口冲突。断点未命中时要核对文件路径、source map 与执行是否已过该行。脱离调试器后进程若像「冻住」,可能是仍停在断点处。本仓库技能为 openclaw/node-inspect-debugger 的中文本地化说明,核心行为与原技能一致;涉及外部服务或凭证时需先完成授权再使用。
使用场景
- 线上 Node 网关进程间歇无响应,需要用 inspector 附着 PID 并在挂起点查看局部变量
- Vitest 用例本地偶发失败,需单 worker、`--inspect-brk` 逐步跟异步与竞态逻辑
- 子进程或启动脚本存在竞态,要用断点确认某行是否在预期时机执行
- 内存持续增长或 CPU 热点不明,需采集 heap snapshot 或 CPU profile 后在 DevTools 分析
适合人员
- 维护长期运行 Node 服务、需要在不重启前提下 SIGUSR1 附着调试的后端工程师
- 负责 CI 里不稳定测试,要用单文件 Vitest + inspector 定位异步时序的工程师
- 排查 TypeScript 编译后路径与 source map 导致断点失准的全栈开发者
- 做性能治理、需要把 inspector 侧 CPU/堆数据导出到 DevTools 的 Node 性能维护者