# ROUND 3 — ROUTE 每步的 Windows/macOS/Linux 命令等价速查表 > **【统一 header】截至 2026-09-21｜海外生态数字；国内分支见各附录相应声明。** > 本文件为最终交付物四附录之一（统一编号交叉引用）：**附录 A**＝生活场景玩法与红线（APPENDIX_scenarios.md）｜**附录 B**＝预算选型决策树与成本精算（APPENDIX_cost.md）｜**附录 C**＝安全护栏与事故响应（APPENDIX_security.md）｜**附录 D**＝三平台（Linux/macOS/Windows）命令等价速查（APPENDIX_platform.md）。主文档与配套：final/MASTER.md、final/ROUTE.md、final/CHECKLIST.md、final/APPENDIX_facts.md（事实核查账本）。 > 置信度标签沿用项目惯例：`一手`/`双源`/`单源`/`低置信`；所有带数字结论的验证日期、半衰期与重查时点见各附录"保鲜日历/时效性"节。 > 本附录定位（**附录 D**）：命令层——ROUTE 每步在 Linux/macOS/Windows 的等价写法与安装路径。沙箱/审计/kill switch 等安全命令的上下文见附录 C，订阅与 API 成本见附录 B，场景落地示例见附录 A。 - **输入**：`../round2/master_skeleton.md`（阶段 0–5 用到的所有命令）、`../round2/novice_test.md`（bash 实测结果）、`../round1/` 各报告的命令块。 - **验证日期**：2026-09-21（本会话检索，官方文档/仓库一手为主）。 - **置信度图例**：〔一手〕= 官方文档/官方仓库原文；〔单源〕= 仅一源未交叉；〔bash 实测〕= novice_test 在 Linux 上真实跑过（Windows/macOS 侧为文献转述，未实测）。 - **半衰期**：安装命令类 3 个月（包管理器与安装脚本会变，尤其 n8n 3.0 改版）；调度器语法类 24 个月（系统级 API，极稳）；URL 安装脚本类 6 个月。 - **中国大陆用户注意**：`winget`/`brew`/GitHub raw 直连可能超时，本表在「网络慢怎么办」节给了替代源；所有命令在 **Windows 用 PowerShell 7**（`winget install Microsoft.PowerShell`）或 **macOS/Linux 用默认 shell** 复制粘贴即可。 --- ## 0. 三平台总对照（先背这张小表） | 你想做什么 | Linux | macOS | Windows | |---|---|---|---| | 装包（CLI 工具） | `apt install `（Debian/Kali/Ubuntu）或 `sudo pacman -S`（Arch） | `brew install ` | `winget install -e --id ` | | 家目录 | `~/` 或 `$HOME` | `~/` 或 `$HOME` | PowerShell 里 `~/`、`$HOME`、`$env:USERPROFILE` 等价〔一手 learn.microsoft.com about_Parsing〕；**CMD 没有 `~`，必须用 `%USERPROFILE%`** | | 后台服务 | `systemctl start/stop/enable` | `launchctl load/unload` + `launchctl bootstrap gui/$(id -u) `（旧 `load/unload` 已被 Apple 社区标为 legacy）〔单源 stackoverflow 74820491〕 | `schtasks` / Task Scheduler，或 `sc.exe`（真服务） | | 定时任务 | `crontab -e` | launchd plist 的 `StartCalendarInterval` | `schtasks /create /sc daily /st 09:00 /tn 名 /tr 路径`〔一手 learn.microsoft.com schtasks-create〕 | | 查日志 | `journalctl -u <服务>`、`tail -f x.log` | `log show --predicate 'process == "X"' --last 1h` | 事件查看器 → 应用程序和服务日志 → Microsoft → Windows → TaskScheduler；或 `Get-WinEvent` | | 编辑器/终端 | nano / vim | nano / vim | `notepad`、VS Code | | 环境变量 | `export FOO=bar` | `export FOO=bar` | PowerShell：`$env:FOO = "bar"`（只当前会话）；`setx FOO bar`（持久） | | `curl \| sh` 一键装 | 原生支持 | 原生支持 | PowerShell：`irm \| iex` | > **shell 语法差异陷阱（Windows）**：bash 的 `cmd1 && cmd2`、`$(...)`、`$(date +%F)`、heredoc `<.AppImage && ./Obsidian-.AppImage --no-sandbox`；或 `flatpak install flathub md.obsidian.Obsidian`〔一手 obsidian.md/help/install〕 | `brew install --cask obsidian` | 官网 `obsidian.md/download` 下 Universal 安装包，双击〔一手 obsidian.md/help/install〕 | | 建 vault 目录 | `mkdir -p ~/memory-vault/{00-inbox,10-projects,20-areas,90-archive}` | 同左 | PowerShell：`mkdir ~\memory-vault, ~\memory-vault\00-inbox, ~\memory-vault\10-projects, ~\memory-vault\20-areas, ~\memory-vault\90-archive`（PowerShell 不支持 `{a,b,c}` 展开） | > Smart Connections / Copilot 都是 Obsidian 内的 GUI 插件，三平台安装路径相同（Settings → Community Plugins），novice_test 未实测（无 GUI），GUI 步骤三平台一致。 ### 1.3 Ollama（阶段 0/1/3，本地模型） | 操作 | Linux | macOS | Windows | |---|---|---|---| | 安装（官方最新路径） | `curl -fsSL https://ollama.com/install.sh \| sh`〔bash 实测〕 | `brew install ollama`（或官网 .dmg 拖入） | `winget install -e --id Ollama.Ollama`，或 PowerShell `irm https://ollama.com/install.ps1 \| iex`〔一手 ollama.com/download/windows〕 | | 装固定版本 | `OLLAMA_VERSION=0.34.2 curl -fsSL https://ollama.com/install.sh \| sh`〔bash 实测：会装到指定版本〕 | 同 Linux | **Windows 无 `OLLAMA_VERSION` 环境变量机制**——winget 会拉最新；要固定版本需去 GitHub Releases 下对应 `OllamaSetup.exe`（或用 `/DIR=` 自定义路径）〔一手 docs.ollama.com/windows〕 | | 升级 | 重跑 install.sh〔bash 实测平滑升级、模型保留〕 | `brew upgrade ollama` | `winget upgrade -e --id Ollama.Ollama` | | 拉模型 / 推理 | `ollama pull qwen2.5:0.5b`、`ollama run qwen2.5:0.5b "你好"`〔bash 实测〕 | 三平台命令完全相同 | 三平台命令完全相同 | | 装成后台服务 | 自动创建 systemd 单元（`OLLAMA_NO_START=1` 在 Linux 无效，novice_test 卡点 7）〔bash 实测〕 | 自动注册 launchd 服务（GUI App） | 自动注册 Windows 服务/开机自启（GUI App，装完即后台运行）〔一手 docs.ollama.com/windows〕 | | 查服务状态 | `systemctl status ollama`；API：`curl http://127.0.0.1:11434/` | `launchctl list \| grep ollama`；同 API | 服务控制面板看 Ollama；同 API | | 模型存放位置 | `~/.ollama` | `~/.ollama` | `%HOMEPATH%\.ollama`；日志在 `%LOCALAPPDATA%\Ollama`〔一手 docs.ollama.com/windows〕 | ### 1.4 promptfoo（阶段 0，评测仪表盘） | 操作 | Linux | macOS | Windows | |---|---|---|---| | 安装 | `npm i -g promptfoo`（novice_test 实测装到 v0.123.1、约 2.6G，小磁盘注意）〔bash 实测〕 | 同 Linux，或 `brew install promptfoo`〔一手 promptfoo.dev/docs/installation〕 | 同 npm 命令（PowerShell 一致） | | `pip install promptfoo` | 不推荐（PyPI 上只是 wrapper，novice_test 卡点 6：PEP 668 也会拒） | 同 | 同 | | 跑 eval | `promptfoo eval`（provider 写法 **`ollama:chat:`**，冒号不是点号——novice_test 卡点 1）〔bash 实测〕 | 同 | 同 | | Web 面板 | `promptfoo view`（无 GUI 服务器跳过） | 有 GUI，同命令 | 有 GUI，同命令 | ### 1.5 uv / venv / pip（Python 生态，LightRAG、browser-use、LoRA 微调） | 操作 | Linux | macOS | Windows | |---|---|---|---| | 建 venv | `python3 -m venv ~/lightrag-venv && source ~/lightrag-venv/bin/activate`〔bash 实测〕 | 同左 | `python -m venv ~\lightrag-venv`；激活用 `~\lightrag-venv\Scripts\Activate.ps1`（PowerShell）或 `~\lightrag-venv\Scripts\activate.bat`（CMD）〔一手 docs.browser-use.com 提及 Windows 激活路径〕 | | 用 uv 建 venv | `uv venv --python 3.12 && source .venv/bin/activate`〔一手 astral.sh〕 | 同左 | 同建法；激活 `.venv\Scripts\activate`〔一手 docs.browser-use.com/quickstart〕 | | 绕过 PEP 668 | novice_test 卡点 6：直装被拒（externally-managed-environment），必须 venv 或 `pipx`〔bash 实测〕 | macOS 自带 Python 同样受管，一样建议 venv | Windows 没有 PEP 668 拦截，裸 `pip install` 可用，但仍**强烈建议 venv**（防依赖打架） | | `uvx `（一次性跑工具，如 `uvx mcp-scan@latest`） | 三平台命令相同〔一手 astral.sh〕 | 同 | 同；Windows 若 `uvx` 不在 PATH，重启终端（installer 改了 profile） | ### 1.6 Docker（Qdrant、OpenMemory、n8n；沙箱化安全用法见附录 C §2.1） | 操作 | Linux | macOS | Windows | |---|---|---|---| | 安装 Docker | `sudo apt install docker.io && sudo usermod -aG docker $USER`（重新登录生效） | `brew install --cask docker`（或 OrbStack，更轻，Round1 computer_use 推荐） | `winget install Docker.DockerDesktop`（需要 WSL2 后端） | | Qdrant 单容器 | `docker run -d --name qdrant --rm -p 127.0.0.1:6333:6333 qdrant/qdrant`〔bash 实测〕 | **macOS 一样写 `127.0.0.1:6333:6333`**，防端口裸奔到公网的坑三平台同理（Docker Desktop 默认绑 loopback，但显式写更稳） | 同 Linux 写法；Docker Desktop 装完需在设置里启用 WSL2 集成 | | 查端口/杀容器 | `docker ps`、`docker rm -f qdrant`〔bash 实测〕 | 同 | 同（PowerShell/CMD 命令一致） | ### 1.7 n8n（阶段 2，管道 glue） | 操作 | Linux | macOS | Windows | |---|---|---|---| | **官方推荐路径** | Docker：`docker volume create n8n_data && docker run -it --rm --name n8n -p 5678:5678 -e GENERIC_TIMEZONE="Asia/Shanghai" -e TZ="Asia/Shanghai" -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -e N8N_RUNNERS_ENABLED=true -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n`〔一手 docs.n8n.io install-with-docker〕 | 同（Docker Desktop / OrbStack） | **同 Docker 命令**（PowerShell 里多行 `\` 改成 `` ` `` 或写一行） | | npm 方式 | `npm install n8n -g`〔一手 docs.n8n.io install-with-npm〕 | 同 | 同；官方提醒 Windows 出问题先确认 Node.js 装好 | | ⚠️ **重大时效** | n8n 3.0（2026-10 起发布）**只通过 Docker 分发**，npm 安装老版本还能用、新装不再支持〔一手 docs.n8n.io one-line-setup〕——**Windows/macOS 用户一律优先走 Docker** | | | | 一行式安装 | `curl -fsSL https://n8n.io/setup.sh \| sh`（需 Docker）〔一手 docs.n8n.io one-line-setup〕 | 同 | **不支持 PowerShell/CMD 直跑**，官方明确说要么 WSL、要么 Git Bash（未端到端验证）〔一手 docs.n8n.io one-line-setup〕 | | 访问 | 浏览器开 `http://localhost:5678` | 同 | 同 | ### 1.8 Claude Code（阶段 1/2，agent CLI；订阅与 API 成本对比见附录 B §3.3） | 操作 | Linux | macOS | Windows | |---|---|---|---| | 安装（原生安装器，官方推荐） | `curl -fsSL https://claude.ai/install.sh \| bash`〔一手 code.claude.com/docs/en/quickstart〕 | 同左 | PowerShell：`curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` 或 `winget install Anthropic.ClaudeCode`〔一手 code.claude.com/docs/en/quickstart〕 | | 原生 Windows 限制 | — | — | 不支持沙箱（sandboxing）；建议装 Git for Windows 并设 `CLAUDE_CODE_GIT_BASH_PATH` 指向 bash.exe〔一手 code.claude.com/docs/en/setup〕 | | 添加 Playwright MCP | `claude mcp add playwright -- npx @playwright/mcp@latest`（novice_test 未覆盖，按官方 README）〔一手 microsoft/playwright-mcp README〕 | 同 | 同；Windows PowerShell 里写 `claude mcp add playwright npx @playwright/mcp@latest`（不要加 `--` 前的空格歧义） | | MCP 配置文件位置 | `~/.claude.json`（或项目级 `.mcp.json`） | 同 | `%USERPROFILE%\.claude.json` | | Headless/定时用 | `claude -p "..."`（print 模式，cron 里用） | 同 | 同 | ### 1.9 browser-use（阶段 1，浏览器执行） | 操作 | Linux | macOS | Windows | |---|---|---|---| | 安装 | `uv venv --python 3.12 && source .venv/bin/activate && uv pip install browser-use && uvx browser-use install`〔一手 docs.browser-use.com/quickstart〕 | 同左 | 同命令；激活改 `.venv\Scripts\activate`〔一手 docs.browser-use.com〕 | | 安装浏览器内核 | `playwright install chromium --with-deps --no-shell`（首次会下载，首次跑慢是正常）〔一手 PyPI browser-use〕 | 同 | 同（Windows 无 `--with-deps` 必要性，写了也不报错） | | API key | `.env` 文件里 `BROWSER_USE_API_KEY=...` 或自带 ANTHROPIC/OPENAI key | 同 | 同（.env 三平台通用） | ### 1.10 cron（Linux）↔ launchd（macOS）↔ Task Scheduler（Windows） **同一个「每天 9:00 跑 `daily_brief.sh`」任务的三平台写法：** | 平台 | 命令 | 备注 | |---|---|---| | **Linux** | `(crontab -l 2>/dev/null; echo "0 9 * * * $HOME/agents/daily_brief.sh >> $HOME/agents/cron.log 2>&1") \| crontab -`〔bash 实测 19/19 成功〕 | novice_test 三铁律：①绝对路径 ②重定向日志 `>> x.log 2>&1` ③先手动跑通再加 cron | | **macOS** | launchd plist（`~/Library/LaunchAgents/com.me.daily-brief.plist`）里写 `ProgramArguments` + `StartCalendarInterval {Hour=9 Minute=0}`，然后 `launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.me.daily-brief.plist`〔单源 stackoverflow/社区 blog，未实测〕 | Apple 官方 man 页偏旧，社区建议弃用 `launchctl load/unload` 改用 `bootstrap/bootout`；plist 是 XML，新手直接照抄 SO 模板 | | **Windows** | `schtasks /create /tn "DailyBrief" /tr "C:\Users\<你>\agents\daily_brief.bat" /sc daily /st 09:00`〔一手 learn.microsoft.com schtasks-create〕 | 或 PowerShell：`New-ScheduledTaskAction -Execute "..."` + `New-ScheduledTaskTrigger -Daily -At 9am` + `Register-ScheduledTask`〔一手 learn.microsoft.com New-ScheduledTask〕 | | 立即触发一次 | `crontab` 无此原生功能（等下一分钟）；`systemd-run --on-active=5 ...` 可 | `launchctl start