本机环境备忘
WorkBuddy 沙箱内使用 Bash 工具的固定注意事项。
PATH 问题（最重要）
本机默认 PATH 只包含 WorkBuddy shim 目录，直接运行 node / npm / ls 会报 command not found。每条命令前需加：
bash
export PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; <你的命令>- 必须带
/usr/local/bin（Docker CLI 所在目录）； - 只读系统工具可用精简版：
export PATH=/usr/bin:/bin;。
工具版本基线
| 工具 | 版本 / 路径 |
|---|---|
| Node.js | v24.20.0（/opt/homebrew/bin/node） |
| npm | 11.19.0 |
| git | Apple Git 2.50.1 |
| Python | 3（openpyxl 3.1.5 全局可用） |
常见问题速查
npx卡死：_npx/*/concurrency.lock删不掉导致，直接用node_modules/.bin/<cmd>绕开；- 没有 ffmpeg：抽帧用 Swift + AVFoundation（见
local-bash-env-notes技能）； - agent-browser：
click用@eN语法；screenshot是位置参数； - 路径含空格/中文：务必加引号。
Docker 判活
bash
docker info --format '{{.ServerVersion}}'引擎未就绪时 open -a Docker，首次初始化等 1-2 分钟。