Hermes Agent 启动网关服务报错“端口被占用（Port already in use）”怎么办？

当你满怀期待地在服务器或本地电脑上执行启动网关（Gateway）或服务端 API 的命令时，终端直接甩出一大串红字，提示类似 `Error: Port 8000 is already in use`。这并不是 Hermes Agent 的代码写错了，而是你的电脑上恰好有其他的后台软件（比如其他的 Web 服务器、本地测试环境或者另一个早就忘了关的 AI 工具）正在死死霸占着这个默认的网络端口。解决这个问题的最快方法是不去跟旧软件硬碰硬，而是直接让 Hermes 换一条路走。你可以打开 `~/.hermes/config.yaml` 配置文件，找到关于网络监听或 Gateway 的端口配置字段，将其从默认的 8000 改为 8080、9090 或者任何大于 1024 且没人用的冷门端口。保存文件后，再次启动程序，它就会顺滑地在新的端口上建立监听。如果你是一个有极客洁癖的人，非要用默认端口，那你可以用 `lsof -i :8000`（Mac/Linux）或 `netstat -ano | findstr 8000`（Windows）命令揪出那个霸占端口的幕后黑手程序，强行杀死它的进程，再启动 Hermes Agent。