vscode无法识别yarn命令，根本原因是其集成终端未继承系统path环境变量；需先在系统终端执行which yarn确认路径，再通过命令行启动vscode（macos用code .，windows配置终端默认配置），或手动在settings.json中补全path环境变量。
VSCode 本身不配置 Yarn，它只调用你系统里已装好的 yarn —— 配置失败的根源几乎全在环境变量、任务定义或 TypeScript 路径识别这三处。
终端里 yarn --version 报 command not found
这不是 VSCode 设置问题，而是它的内置终端没继承 shell 的 PATH。系统终端能跑，VSCode 终端跑不了，说明环境变量没加载进来。
- 先在系统终端（非 VSCode）执行
which yarn，记下路径，比如/Users/xxx/.yarn/bin/yarn或/opt/homebrew/bin/yarn - 打开 VSCode 终端，再跑一遍
which yarn—— 如果没输出，就是 PATH 没传进来 - macOS 用户别从 Dock 启动 VSCode，改用命令行
code .；Windows 用户若用 Git Bash，需在设置里把terminal.integrated.defaultProfile.windows设为Git Bash - 兜底方案：在 VSCode 设置中搜
terminal.integrated.env，手动补 PATH，例如："terminal.integrated.env.osx": {"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"}
Tasks: Run Task 仍执行 npm install
VSCode 不会自动猜你用了 yarn —— 它只认 tasks.json 里写的字面量，或者靠 package.json 的 packageManager 字段自动生成。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 确保项目根目录
package.json有"packageManager": "yarn@4.0.0"（Yarn 3.1+ 才支持该字段） - 删掉旧的
.vscode/tasks.json，避免硬编码了"command": "npm" - 按
Cmd/Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Create tasks from package.json - 生成的任务里必须是
"command": "yarn"和"args": ["install"]，而不是"npm run install"
TypeScript 报 “无法找到模块” 但项目能运行
这是 TS Server 没正确解析 yarn 的模块链接结构，尤其在启用 PnP（.pnp.cjs）后极常见 —— 和终端、任务都无关，纯路径识别问题。
- 必须用 VSCode 打开整个 workspace 根目录（即含
yarn.lock或.yarnrc.yml的文件夹），不能只开子包目录 - 看状态栏右下角：要是显示
TypeScript SDK: Project version，说明作用域错了，得改成Workspace version - 确认已运行
yarn set version stable生成.pnp.cjs，且.yarnrc.yml中有nodeLinker: pnp - 改完
tsconfig.json或切换包管理器后，务必手动执行Cmd/Ctrl+Shift+P→Restart TS server
最容易被忽略的是：三个环节（终端 PATH、tasks 自动生成逻辑、TS Server 的 workspace 识别）必须全部对齐，缺一不可。少一个，就会降级回 npm 或报错但不提示原因。
