直接写“npm run build”在tasks.json中报command not found，是因为vscode任务不继承shell的path、不加载.env、也不自动使用node_modules/.bin；应改用npx --no-install调用本地包，并显式指定shell路径和env字段。
tasks.json 里写 npm run build 为什么总报 command not found
VSCode 的任务系统不继承你终端里的 shell 环境，PATH、.env 文件、node_modules/.bin 路径全都不自动加载。所以你在终端能跑的命令，在 tasks 里大概率失败。
-
npm: command not found：尤其在 macOS/Linux 的 zsh 下，VSCode 启动时没读~/.zshrc -
cross-env is not recognized：Windows PowerShell 默认禁用脚本执行，且不从node_modules/.bin查找 -
Cannot find module 'dotenv'：.env 没被注入，环境变量全为空
解决方案不是重装 Node 或改全局 PATH，而是绕过 npm 本身：
- 用
npx --no-install直接调本地包，比如"command": "npx --no-install vite build" - 显式指定 shell 可执行路径：
"shell": { "executable": "/bin/zsh", "args": ["-c"] }（macOS/Linux）或"shell": { "executable": "cmd.exe", "args": ["/c"] }（Windows） - 手动补
env字段，哪怕项目用了dotenv："env": { "NODE_ENV": "production", "API_URL": "https://api.example.com" }
task 定义写了但 Ctrl+Shift+P 找不到？检查这三处硬性要求
VSCode 对 tasks.json 的位置、命名、结构有严格校验，错一个就当普通 JSON 忽略。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 文件必须放在工作区根目录下的
.vscode/tasks.json，不能是task.json、Tasks.json或嵌套在子文件夹里 -
"version": "2.0.0"是固定字符串，不是语义版本；写成"2.0"或"2"都无效 - 每个 task 至少含
"label"和"type": "shell"；漏掉"group": "build"或"problemMatcher"，它就不会出现在「运行构建任务」菜单里
想让 deploy 等 build 完再执行？dependsOn 不够，还得加这两项
"dependsOn": ["build"] 只控制启动顺序，默认并发执行。如果 build 是 vite build 这类异步命令，deploy 很可能在 dist/ 还没生成时就开始读取。
- 加上
"dependsOrder": "sequence"，强制等待上一个任务退出才启动下一个 - 显式写
"isBackground": false（即使默认值是 false，不写 VSCode 有时会误判） - 确保
build任务本身有明确结束信号：不要用带--watch的命令，也不要漏掉problemMatcher或退出码判断逻辑
presentation 字段怎么设才不影响开发流？
任务输出面板默认会弹出并抢占焦点，打断编码节奏。合理配置 presentation 能让它“干活不吭声”。
-
"reveal": "silent"：不自动跳到终端面板，只在后台运行 -
"echo": true：把命令本身也打印出来，方便排查是否真执行了 -
"panel": "shared"：复用同一个终端面板，避免每次新开一个 -
"clear": false：不清空历史输出，方便回溯上次构建日志
真正麻烦的从来不是写几行 JSON，而是 VSCode 任务系统对环境隔离和生命周期信号的隐式依赖——它不像终端那样“所见即所得”，得主动补全那些 shell 默认做的事。
