Hermes Agent 启动脚本 3 处改造60 秒跑通依赖检查【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent执行./setup-hermes.sh卡在第 3 步打出uv: command not found后再无输出这是 Hermes Agent 启动脚本依赖检查的典型翻车现场脚本停了你却不知道缺的是哪个依赖。先花 30 秒定位再改 3 处就能跑通。 先定位三步自检清单改代码之前先判断你的问题属于哪一层。按顺序跑下面 3 条命令看哪一步先失败工具缺没缺uv、git、rg在不在系统里Python 版本适不适配有没有可用的 3.10 以上版本配置填没填.env里的必需变量是否为空值把这三行放进启动脚本前 10 行哪一层死掉都能先拿到结论不用再翻整屏日志。type -p uv git rg uv python list 2/dev/null | head -3 grep -cE ^[A-Z_]. .env 2/dev/null || echo 0 # .env 缺失或无有效值跑完你会看到三段输出第 1 步出现not found是缺工具第 2 步为空是 Python 版本不对第 3 步为 0 是配置问题。三类各对应下一节的 1 处改造。 三处关键改造改造 1用hash重写依赖探测原脚本用command -v探测依赖并把输出丢进 /dev/null失败时你连缺了哪个都看不到。改用hash做探测、type -p打印真实路径缺什么直接暴露probe() { local bin$1 if hash $bin 2/dev/null; then printf [OK] %-4s - %s\n $bin $(type -p $bin) else printf [MISS] %-4s 缺失待安装\n $bin fi } for b in uv git rg; do probe $b; done跑完终端会打印 3 行装好的显示[OK] uv - /usr/local/bin/uv缺失的显示[MISS]你要装什么一目了然。改造 2安装失败用一个退出码收口安装失败时原逻辑继续往下走真正的报错拖到后面步骤才冒出来你已经分不清是哪个安装步骤坏的。兜底规则失败就打印错误并立刻以固定退出码 127 退出环境没确认前不重试install_dep() { local pkg$1 if ! pip install --user $pkg /dev/null 21; then echo ERROR: $pkg 安装失败请检查网络或 pip 源配置 2 exit 127 fi export PATH$HOME/.local/bin:$PATH hash $pkg /dev/null 21 || echo WARN: $pkg 不在 PATH请重开终端 echo [OK] $pkg 安装完成 }这步最容易翻车。安装失败时终端只出现一行 ERROR脚本停在退出码 127成功时只留一行[OK] uv 安装完成不会被几百行 pip 日志刷屏。改造 3.env逐键校验.env文件存在但值全空报错要等到 Agent 第一次调 API 才出现。改法不只看文件是否存在逐个检查必需变量有没有非空值[ -f .env ] || { echo ERROR: 缺少 .env请先从 .env.example 复制一份; exit 1; } for k in ANTHROPIC_API_KEY OPENAI_API_KEY; do grep -qE ^[[:space:]]*${k}. .env \ || echo WARN: ${k} 为空启动前请填入 done echo [OK] .env 校验完成跑完你看到的是变量齐全时输出一行[OK] .env 校验完成有空值时每个空变量各打一行 WARN填哪一行直接看输出。避坑速查表新环境报错时先对这张表表里没覆盖的再回头看自检清单坑现象一行解法探测输出被吞缺工具时脚本静默继续换hash bin 2/dev/null失败就打印工具名安装脚本吞退出码pip 输出一大屏uv 其实没装上装完立刻hash uv复验一次新终端 PATH 没更新当前会话有 uv新终端not found把export PATH$HOME/.local/bin:$PATH写进 shell 配置.env存在但值为空Agent 首次调 API 才报鉴权错误逐 key 检查是否非空值Python 版本过旧3.9 上报SyntaxErroruv python list挑一个 3.10 以上的版本脚本死了没有上下文只有退出码不知道原因开头加trap echo line $LINENO 失败 ERR✅ 跑一遍验证最后别靠猜整条流程跑一遍用脚本自己说话没装 shellcheck 就跳过第 2 行bash -n setup-hermes.sh shellcheck -S warning setup-hermes.sh ./setup-hermes.sh3 条都退出码为 0且最后停在 Hermes Agent 桌面端的欢迎界面说明改造生效自检清单负责秒级判断问题在哪一层三处改造分别堵住缺工具、装失败、配置空三个出口速查表留给下次新环境再出状况时对照验证通过后用这一条命令启动git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent ./setup-hermes.sh【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考