拓冰网站定制 
1. 为什么要在 Debian 上手动复现 Hermes-Agent 调用 minimax 的链路Hermes-Agent 是一套面向多模型协作的智能体框架它本身不产出推理能力而是把任务拆解、工具调用、结果校验这些环节编排起来再交给底层大模型执行。minimax稀宇科技的 abab 系列模型是它支持的众多后端之一。问题在于很多人第一次在 Debian 上跑 Hermes-Agent 时会默认“装完 npm 包就能用”结果一执行任务就卡在环境探测环节Agent 声称本机没有 nodejs 和 npm于是拒绝继续。这个报错看起来像模型在胡说实际上往往是运行环境、PATH、Node 版本或 API 配置中的某一环断了。这篇内容聚焦一个具体场景在 Debian 12 上用 nodejs/npm 从零安装 Hermes-Agent配置 minimax 作为模型后端跑通一次完整的对话请求并把每一步可能遇到的报错和修复思路拆开讲。适合已经在用 Debian 做开发机、想本地复现 Agent 调用链、或者被“Agent 说没有 nodejs”这类问题卡住的读者。核心检索词就是 Hermes-Agent、minimax、nodejs、npm、Debian 这几个全文围绕它们展开不绕弯子。需要先明确一点Hermes-Agent 这类框架对 Node 版本有要求Debian 自带的 apt 源里 nodejs 版本通常偏旧直接apt install nodejs npm很可能装到 Node 18 以下导致后续依赖安装失败。所以第一步不是急着装 Hermes-Agent而是先把 Node 运行时理顺。另外minimax 的 API 调用需要 Base URL、API Key、Model ID 三件套缺一个都会在请求阶段报 401 或 model not found。下面按顺序走一遍。2. TaoToken 前置准备拿到 minimax 可用的 Base URL 与 Key在 Debian 上跑 Hermes-Agent 之前得先有一个能稳定调用的模型入口。minimax 官方 API 对国内开发者来说注册和计费流程有时会卡住尤其是需要快速验证链路的时候。我自己的做法是先用 TaoToken 这类聚合入口把 Base URL 和 Key 拿到再填进 Hermes-Agent 的配置里这样能先把“环境能不能跑通”和“模型能不能调通”两件事分开排查。TaoToken 的定位是模型 API 聚合与转发层它把 minimax、Claude、GPT 等模型的调用统一成 OpenAI 兼容格式。对 Hermes-Agent 来说这意味着你不需要为每个模型写不同的适配代码只要把 Base URL 指向 TaoToken 的 API 地址Key 用 TaoToken 生成的令牌Model ID 填 minimax 对应的模型名即可。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数直接用于代码里的 base_url。具体操作上你需要先注册并登录然后在控制台里创建一个 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进去之后找到 API Keys 页面新建一个 Key复制出来保存好。这个 Key 只会完整显示一次丢了就得重建。如果你只是想先验证模型能不能对话可以打开模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在里面选 minimax 的模型发一条消息确认返回正常再去配 Hermes-Agent。这样能避免把“Key 无效”和“Agent 配置错误”混在一起排查。拿到 Key 之后记下三个值Base URL 用https://taotoken.net/apiAPI Key 用你刚创建的那串Model ID 填 minimax 对应的模型标识比如minimax-abab6.5s-chat或你账号下可用的具体型号。这三个值后面会写进 Hermes-Agent 的环境变量或配置文件。如果你打算长期跑编码类 Agent 任务也可以了解下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频调用场景做了额度设计不过本篇先聚焦单次调用链复现不展开。3. Debian 上安装 nodejs/npm 并配置 Hermes-Agent 的可复制步骤这一节是全文的核心所有命令都可以直接复制到 Debian 终端里执行。先确认系统版本cat /etc/debian_version如果是 12 或 11 都行。然后处理 Node 运行时。Debian 自带的 apt 源里 nodejs 版本偏低推荐用 NodeSource 的源装 Node 20 LTS。命令如下sudo apt update sudo apt install -y curl ca-certificates gnupg curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs node -v npm -v执行完node -v应该输出v20.x.xnpm -v输出10.x.x左右。如果node -v还是旧版本检查一下 PATH 里是不是有别的 node 二进制用which -a node看一下把旧的删掉或调整 PATH 顺序。这一步很关键因为 Hermes-Agent 的依赖里有些包要求 Node 18 以上版本不够会在npm install阶段报engine not supported。接下来安装 Hermes-Agent。如果你的项目是从 Git 仓库拉的先git clone到本地然后进目录执行npm install。如果它是发布在 npm 上的包直接npm install -g hermes-agent或npm install hermes-agent。这里以本地项目为例cd ~/hermes-agent npm installnpm install过程中常见的报错是node-gyp编译失败通常是因为缺少build-essential和python3。补装sudo apt install -y build-essential python3然后重新npm install。如果卡在某个包下载慢可以换 npm 镜像源npm config set registry https://registry.npmmirror.com再重试。依赖装完后配置模型入口。Hermes-Agent 一般通过环境变量或.env文件读取模型配置。在项目根目录创建.env写入以下内容# .env OPENAI_API_KEY你的TaoTokenKey OPENAI_BASE_URLhttps://taotoken.net/api OPENAI_MODELminimax-abab6.5s-chat注意这里变量名可能是OPENAI_API_KEY这种通用写法因为 TaoToken 兼容 OpenAI 格式Hermes-Agent 内部如果用的是 OpenAI SDK就会读这几个变量。如果你的 Hermes-Agent 版本用的是自定义变量名比如HERMES_MODEL_BASE那就按它的文档改。关键是 Base URL 必须是https://taotoken.net/api不要多加/v1或斜杠除非文档明确要求。如果你用的是 JSON 配置文件比如config.json可以写成{ model: { provider: openai-compatible, baseURL: https://taotoken.net/api, apiKey: 你的TaoTokenKey, modelId: minimax-abab6.5s-chat } }把文件放到 Hermes-Agent 读取的路径下通常是项目根目录或~/.hermes/。配置完成后用node -e console.log(process.env.OPENAI_BASE_URL)确认环境变量能读到或者直接cat .env检查内容。这一步做完环境侧就准备好了。4. 验证请求跑一次真实调用并确认返回结果配置写好后不要直接跑复杂任务先用一个最小请求验证链路。Hermes-Agent 一般提供 CLI 入口比如npm run start或node index.js。先看package.json里的 scripts 字段找到启动命令。假设是npm run dev执行npm run dev如果它进入交互模式输入一句简单的话比如“你好请回复 ok”。观察终端输出。正常情况会看到 Agent 把请求发到https://taotoken.net/api然后返回 minimax 的回复。如果返回里有choices字段和内容说明链路通了。如果不想走 Agent 交互也可以直接用 curl 验证 TaoToken 的 minimax 入口是否可用curl -s https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的TaoTokenKey \ -d { model: minimax-abab6.5s-chat, messages: [{role: user, content: 回复 ok}] }返回 JSON 里如果有content: ok或类似内容说明 Key、Base URL、Model ID 三件套都正确。这一步能排除掉模型侧的问题把排查范围缩小到 Hermes-Agent 本身。当 Agent 跑起来后你可能会看到它先做环境探测比如检查 nodejs、npm 是否存在。如果它仍然说“本机没有 nodejs”那大概率是 Agent 执行 shell 命令时用的 PATH 和你终端里的 PATH 不一致。修复方法是把 node 的绝对路径写进 Agent 的工具配置或者在启动 Agent 前export PATH$PATH:$(dirname $(which node))。我试过在 systemd 服务里跑 Agent结果因为服务环境没有加载.bashrcPATH 里没有 nodeAgent 就误判了。后来在 service 文件里加EnvironmentPATH/usr/bin:/usr/local/bin:/usr/bin/node才解决。验证成功后你可以让 Agent 执行一个稍复杂的任务比如“列出当前目录文件并统计数量”观察它是否能正确调用工具并返回结果。如果这一步也通过说明整条链路从 Debian 环境到 nodejs/npm 到 Hermes-Agent 到 minimax 都打通了。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节把复现过程中最容易撞上的几个报错单独拎出来对照真实错误信息给修复方向。第一个是401 Unauthorized。返回体里通常有invalid api key或authentication failed。原因一般是 Key 复制时带了空格、Key 已失效、或者 Base URL 写成了https://taotoken.net/api/v1而实际应该用https://taotoken.net/api。修复重新在控制台生成 Key粘贴时确认没有换行和空格用 curl 单独测一次排除 Agent 配置干扰。第二个是local proxy failed或connect ECONNREFUSED。这通常出现在 Agent 试图走本地代理端口但代理没启动。检查环境变量里有没有HTTP_PROXY、HTTPS_PROXY被设成了127.0.0.1:某端口。如果有unset HTTP_PROXY HTTPS_PROXY再跑。另外确认 Debian 能正常解析taotoken.netnslookup taotoken.net看一下。第三个是Cannot read properties of undefined (reading choices)。这个报错说明代码在解析响应时响应体里没有choices字段。常见原因是 Base URL 配错请求打到了某个返回 HTML 的地址或者 Model ID 写错导致接口返回错误对象。修复先用 curl 确认返回结构再检查 Hermes-Agent 里模型配置的字段名是否和实际响应匹配。有时候 Agent 期望的是data.choices但实际返回被包了一层需要调整解析路径。第四个是OAuth相关报错比如OAuth token expired或invalid_grant。如果你用的是某些需要 OAuth 的模型入口而不是纯 API Key就会遇到。TaoToken 的 API Key 模式不走 OAuth所以如果你在 Hermes-Agent 里看到 OAuth 报错检查是不是误开了某个需要 OAuth 的 provider。把 provider 改成openai-compatible用 API Key 认证即可。另外如果你在配置里用到了 CC Switch、Cline MCP 或 Codex 的auth.json记得三件套要写全Base URL、Key、Model ID。缺任何一个都会在请求阶段失败。比如 Codex 的auth.json里如果只写了 Key 没写 Base URL它会默认走官方地址导致 401。补全后重启 Agent 再试。6. 把链路固定下来后续调用与入口选择链路跑通之后建议把配置固化避免每次重启终端都要重新 export。可以把.env文件保留在项目根目录启动脚本里用dotenv加载。如果是 systemd 服务把环境变量写进 service 文件的Environment行。这样 Agent 每次启动都能读到正确的 Base URL 和 Key。对于后续的调用入口如果你主要是排障和接入验证用 API Keys 页面管理 Key 就够了地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果只是想快速试模型回复模型对话页面更直接 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算把 Hermes-Agent 长期挂在 Debian 上跑编码或 Agent 任务Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有对应的额度方案。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到字段名不确定时翻一下。最后说一个实际踩过的坑Debian 上如果用nvm管理 NodeHermes-Agent 通过子进程调用node时可能找不到 nvm 里的版本因为 nvm 是 shell 函数不是全局二进制。解决办法是用系统级 Node或者把 nvm 的 node 路径软链到/usr/local/bin/node。这个坑不报错则已一报就是“node not found”和模型胡说八道混在一起很难分辨。把环境理顺Agent 的“智商”问题至少能少一半。 Hermes-Agent 纯炮轰 minimax：在 Debian 上用 nodejs/npm 复现一次完整调用链
1. 为什么要在 Debian 上手动复现 Hermes-Agent 调用 minimax 的链路Hermes-Agent 是一套面向多模型协作的智能体框架它本身不产出推理能力而是把任务拆解、工具调用、结果校验这些环节编排起来再交给底层大模型执行。minimax稀宇科技的 abab 系列模型是它支持的众多后端之一。问题在于很多人第一次在 Debian 上跑 Hermes-Agent 时会默认“装完 npm 包就能用”结果一执行任务就卡在环境探测环节Agent 声称本机没有 nodejs 和 npm于是拒绝继续。这个报错看起来像模型在胡说实际上往往是运行环境、PATH、Node 版本或 API 配置中的某一环断了。这篇内容聚焦一个具体场景在 Debian 12 上用 nodejs/npm 从零安装 Hermes-Agent配置 minimax 作为模型后端跑通一次完整的对话请求并把每一步可能遇到的报错和修复思路拆开讲。适合已经在用 Debian 做开发机、想本地复现 Agent 调用链、或者被“Agent 说没有 nodejs”这类问题卡住的读者。核心检索词就是 Hermes-Agent、minimax、nodejs、npm、Debian 这几个全文围绕它们展开不绕弯子。需要先明确一点Hermes-Agent 这类框架对 Node 版本有要求Debian 自带的 apt 源里 nodejs 版本通常偏旧直接apt install nodejs npm很可能装到 Node 18 以下导致后续依赖安装失败。所以第一步不是急着装 Hermes-Agent而是先把 Node 运行时理顺。另外minimax 的 API 调用需要 Base URL、API Key、Model ID 三件套缺一个都会在请求阶段报 401 或 model not found。下面按顺序走一遍。2. TaoToken 前置准备拿到 minimax 可用的 Base URL 与 Key在 Debian 上跑 Hermes-Agent 之前得先有一个能稳定调用的模型入口。minimax 官方 API 对国内开发者来说注册和计费流程有时会卡住尤其是需要快速验证链路的时候。我自己的做法是先用 TaoToken 这类聚合入口把 Base URL 和 Key 拿到再填进 Hermes-Agent 的配置里这样能先把“环境能不能跑通”和“模型能不能调通”两件事分开排查。TaoToken 的定位是模型 API 聚合与转发层它把 minimax、Claude、GPT 等模型的调用统一成 OpenAI 兼容格式。对 Hermes-Agent 来说这意味着你不需要为每个模型写不同的适配代码只要把 Base URL 指向 TaoToken 的 API 地址Key 用 TaoToken 生成的令牌Model ID 填 minimax 对应的模型名即可。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数直接用于代码里的 base_url。具体操作上你需要先注册并登录然后在控制台里创建一个 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进去之后找到 API Keys 页面新建一个 Key复制出来保存好。这个 Key 只会完整显示一次丢了就得重建。如果你只是想先验证模型能不能对话可以打开模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在里面选 minimax 的模型发一条消息确认返回正常再去配 Hermes-Agent。这样能避免把“Key 无效”和“Agent 配置错误”混在一起排查。拿到 Key 之后记下三个值Base URL 用https://taotoken.net/apiAPI Key 用你刚创建的那串Model ID 填 minimax 对应的模型标识比如minimax-abab6.5s-chat或你账号下可用的具体型号。这三个值后面会写进 Hermes-Agent 的环境变量或配置文件。如果你打算长期跑编码类 Agent 任务也可以了解下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频调用场景做了额度设计不过本篇先聚焦单次调用链复现不展开。3. Debian 上安装 nodejs/npm 并配置 Hermes-Agent 的可复制步骤这一节是全文的核心所有命令都可以直接复制到 Debian 终端里执行。先确认系统版本cat /etc/debian_version如果是 12 或 11 都行。然后处理 Node 运行时。Debian 自带的 apt 源里 nodejs 版本偏低推荐用 NodeSource 的源装 Node 20 LTS。命令如下sudo apt update sudo apt install -y curl ca-certificates gnupg curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs node -v npm -v执行完node -v应该输出v20.x.xnpm -v输出10.x.x左右。如果node -v还是旧版本检查一下 PATH 里是不是有别的 node 二进制用which -a node看一下把旧的删掉或调整 PATH 顺序。这一步很关键因为 Hermes-Agent 的依赖里有些包要求 Node 18 以上版本不够会在npm install阶段报engine not supported。接下来安装 Hermes-Agent。如果你的项目是从 Git 仓库拉的先git clone到本地然后进目录执行npm install。如果它是发布在 npm 上的包直接npm install -g hermes-agent或npm install hermes-agent。这里以本地项目为例cd ~/hermes-agent npm installnpm install过程中常见的报错是node-gyp编译失败通常是因为缺少build-essential和python3。补装sudo apt install -y build-essential python3然后重新npm install。如果卡在某个包下载慢可以换 npm 镜像源npm config set registry https://registry.npmmirror.com再重试。依赖装完后配置模型入口。Hermes-Agent 一般通过环境变量或.env文件读取模型配置。在项目根目录创建.env写入以下内容# .env OPENAI_API_KEY你的TaoTokenKey OPENAI_BASE_URLhttps://taotoken.net/api OPENAI_MODELminimax-abab6.5s-chat注意这里变量名可能是OPENAI_API_KEY这种通用写法因为 TaoToken 兼容 OpenAI 格式Hermes-Agent 内部如果用的是 OpenAI SDK就会读这几个变量。如果你的 Hermes-Agent 版本用的是自定义变量名比如HERMES_MODEL_BASE那就按它的文档改。关键是 Base URL 必须是https://taotoken.net/api不要多加/v1或斜杠除非文档明确要求。如果你用的是 JSON 配置文件比如config.json可以写成{ model: { provider: openai-compatible, baseURL: https://taotoken.net/api, apiKey: 你的TaoTokenKey, modelId: minimax-abab6.5s-chat } }把文件放到 Hermes-Agent 读取的路径下通常是项目根目录或~/.hermes/。配置完成后用node -e console.log(process.env.OPENAI_BASE_URL)确认环境变量能读到或者直接cat .env检查内容。这一步做完环境侧就准备好了。4. 验证请求跑一次真实调用并确认返回结果配置写好后不要直接跑复杂任务先用一个最小请求验证链路。Hermes-Agent 一般提供 CLI 入口比如npm run start或node index.js。先看package.json里的 scripts 字段找到启动命令。假设是npm run dev执行npm run dev如果它进入交互模式输入一句简单的话比如“你好请回复 ok”。观察终端输出。正常情况会看到 Agent 把请求发到https://taotoken.net/api然后返回 minimax 的回复。如果返回里有choices字段和内容说明链路通了。如果不想走 Agent 交互也可以直接用 curl 验证 TaoToken 的 minimax 入口是否可用curl -s https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的TaoTokenKey \ -d { model: minimax-abab6.5s-chat, messages: [{role: user, content: 回复 ok}] }返回 JSON 里如果有content: ok或类似内容说明 Key、Base URL、Model ID 三件套都正确。这一步能排除掉模型侧的问题把排查范围缩小到 Hermes-Agent 本身。当 Agent 跑起来后你可能会看到它先做环境探测比如检查 nodejs、npm 是否存在。如果它仍然说“本机没有 nodejs”那大概率是 Agent 执行 shell 命令时用的 PATH 和你终端里的 PATH 不一致。修复方法是把 node 的绝对路径写进 Agent 的工具配置或者在启动 Agent 前export PATH$PATH:$(dirname $(which node))。我试过在 systemd 服务里跑 Agent结果因为服务环境没有加载.bashrcPATH 里没有 nodeAgent 就误判了。后来在 service 文件里加EnvironmentPATH/usr/bin:/usr/local/bin:/usr/bin/node才解决。验证成功后你可以让 Agent 执行一个稍复杂的任务比如“列出当前目录文件并统计数量”观察它是否能正确调用工具并返回结果。如果这一步也通过说明整条链路从 Debian 环境到 nodejs/npm 到 Hermes-Agent 到 minimax 都打通了。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节把复现过程中最容易撞上的几个报错单独拎出来对照真实错误信息给修复方向。第一个是401 Unauthorized。返回体里通常有invalid api key或authentication failed。原因一般是 Key 复制时带了空格、Key 已失效、或者 Base URL 写成了https://taotoken.net/api/v1而实际应该用https://taotoken.net/api。修复重新在控制台生成 Key粘贴时确认没有换行和空格用 curl 单独测一次排除 Agent 配置干扰。第二个是local proxy failed或connect ECONNREFUSED。这通常出现在 Agent 试图走本地代理端口但代理没启动。检查环境变量里有没有HTTP_PROXY、HTTPS_PROXY被设成了127.0.0.1:某端口。如果有unset HTTP_PROXY HTTPS_PROXY再跑。另外确认 Debian 能正常解析taotoken.netnslookup taotoken.net看一下。第三个是Cannot read properties of undefined (reading choices)。这个报错说明代码在解析响应时响应体里没有choices字段。常见原因是 Base URL 配错请求打到了某个返回 HTML 的地址或者 Model ID 写错导致接口返回错误对象。修复先用 curl 确认返回结构再检查 Hermes-Agent 里模型配置的字段名是否和实际响应匹配。有时候 Agent 期望的是data.choices但实际返回被包了一层需要调整解析路径。第四个是OAuth相关报错比如OAuth token expired或invalid_grant。如果你用的是某些需要 OAuth 的模型入口而不是纯 API Key就会遇到。TaoToken 的 API Key 模式不走 OAuth所以如果你在 Hermes-Agent 里看到 OAuth 报错检查是不是误开了某个需要 OAuth 的 provider。把 provider 改成openai-compatible用 API Key 认证即可。另外如果你在配置里用到了 CC Switch、Cline MCP 或 Codex 的auth.json记得三件套要写全Base URL、Key、Model ID。缺任何一个都会在请求阶段失败。比如 Codex 的auth.json里如果只写了 Key 没写 Base URL它会默认走官方地址导致 401。补全后重启 Agent 再试。6. 把链路固定下来后续调用与入口选择链路跑通之后建议把配置固化避免每次重启终端都要重新 export。可以把.env文件保留在项目根目录启动脚本里用dotenv加载。如果是 systemd 服务把环境变量写进 service 文件的Environment行。这样 Agent 每次启动都能读到正确的 Base URL 和 Key。对于后续的调用入口如果你主要是排障和接入验证用 API Keys 页面管理 Key 就够了地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果只是想快速试模型回复模型对话页面更直接 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算把 Hermes-Agent 长期挂在 Debian 上跑编码或 Agent 任务Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有对应的额度方案。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到字段名不确定时翻一下。最后说一个实际踩过的坑Debian 上如果用nvm管理 NodeHermes-Agent 通过子进程调用node时可能找不到 nvm 里的版本因为 nvm 是 shell 函数不是全局二进制。解决办法是用系统级 Node或者把 nvm 的 node 路径软链到/usr/local/bin/node。这个坑不报错则已一报就是“node not found”和模型胡说八道混在一起很难分辨。把环境理顺Agent 的“智商”问题至少能少一半。