根本原因是vscode默认powershell终端不兼容cmd特有的/d参数，该参数本为cmd合法开关，却被powershell误判为非法；解决方案是删除tasks.json中args里的/d等cmd专用参数，或切换默认终端为cmd/git bash。

npm run 脚本传参时提示“参数格式不正确 - /d”

根本原因不是脚本写错了，而是 VSCode 终端在 Windows 下解析命令行参数时把 /d 当作 PowerShell 的非法开关处理——它其实是 cmd 的合法参数（cmd /d 表示不执行 AutoRun 命令），但 PowerShell 会直接报错。

• 典型错误信息：正在执行任务: npm run start 参数格式不正确 - /d
• 这个 /d 通常来自 VSCode 任务配置中 args 字段或 shell 启动参数，而非 package.json 里的 script 内容
• VSCode 默认终端是 PowerShell，它不兼容 cmd 特有的开关语法，比如 /d、/c、/k
• 临时绕过：在 tasks.json 的 args 里删掉所有以 / 开头的非 npm 参数（如 /d、/c）
• 长期解法：改用 cmd 或 Git Bash 作为默认终端（Ctrl+Shift+P → Terminal: Select Default Profile），它们原生支持这些开关

VSCode 任务运行 npm 时参数被截断或乱码

本质是终端 shell 初始化不完整，导致环境变量（尤其是 PATH 和编码设置）缺失，进而影响参数解析和子进程调用。

• 常见现象：npm 脚本里用到 cross-env 或 node --max-old-space-size 时参数丢失、中文路径乱码、$npm_config_* 变量为空
• Windows 上：PowerShell 不自动加载用户环境变量，echo $env:PATH 输出可能缺 C:\Program Files\nodejs 或 %AppData%\npm
• macOS/Linux 上：VSCode 终端默认不是 login shell，~/.zshrc 或 ~/.bash_profile 里的 PATH 补充不会生效
• 修复方式：在 VSCode 设置中加 "terminal.integrated.shellArgs.osx": ["-l"]（macOS）或 "terminal.integrated.shellArgs.linux": ["-l"]，让 shell 加载完整配置
• Windows 用户更稳妥的做法：直接切换默认终端为 Command Prompt，避免 PowerShell 权限与参数解析双重干扰

npm run xxx 在 VSCode 里失败但命令行能跑

这不是 npm 本身的问题，而是 VSCode 终端没拿到和系统终端一致的执行上下文——特别是 PATH、shell 类型、当前工作目录初始化顺序。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 先验证：在 VSCode 终端运行 where npm（Windows）或 which npm（macOS/Linux），对比系统终端输出是否一致
• 如果 VSCode 里找不到 npm，说明 PATH 没继承全；如果能找到但脚本仍失败，大概率是 shell 类型不匹配（比如脚本依赖 bash 特性，但当前是 PowerShell）
• 检查 package.json 中的 script 是否含 shell 特有语法：如 "build": "sh ./build.sh" 在 PowerShell 下会失败，应改用 "build": "bash ./build.sh" 或统一用 npx shx
• VSCode 任务配置中若指定 "shell": true，要确保对应 shell 已安装且在 PATH 中（例如 Git Bash 路径未加入 PATH 时，bash 命令会报错）
• 最简排查路径：右键项目根目录 → 在集成终端中打开，比手动 cd 更可靠，能避免工作目录错位引发的参数解析异常

PowerShell 报 “xxx.ps1 cannot be loaded because running scripts is disabled”

这是 npm 全局安装的 CLI 工具（如 vercel、serve）生成的 .ps1 包装脚本被拦截，和传参无关，但会掩盖真实的参数错误。

• 错误本质：PowerShell 默认策略 Restricted 禁止所有脚本执行，包括 npm 自己生成的 npm.ps1
• 不要用管理员权限全局改策略（Set-ExecutionPolicy RemoteSigned -Scope LocalMachine），这会让普通用户终端无法覆盖
• 只对当前用户生效：在 VSCode 终端里运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，然后关掉终端重开
• 验证是否生效：Get-ExecutionPolicy -Scope CurrentUser 应返回 RemoteSigned
• 如果已设过但依然报错，检查是否误用了 -Scope Process——该作用域只在当前终端会话有效，关掉就失效

真正卡住人的地方往往不是 npm 语法本身，而是 VSCode 终端和系统 shell 之间那层看不见的上下文隔离。PATH 没继承、shell 类型不匹配、PowerShell 策略限制，三者常叠加出现，单独修一个可能暂时缓解，但问题会换个形式冒出来。