背景

Hermes Agent 是 Nous Research 開發(fā)的 AI 智能體，可以在 WSL2 中運(yùn)行并提供 Web Dashboard 界面。但每次啟動(dòng)都需要打開 WSL2 終端，運(yùn)行命令，然后手動(dòng)打開瀏覽器訪問 http://127.0.0.1:9119，步驟繁瑣。

需求

我們希望在 Windows 桌面上雙擊一個(gè)圖標(biāo)，就能自動(dòng)完成：

1. 檢查 Dashboard 是否已在運(yùn)行
2. 如果已在運(yùn)行 → 直接打開瀏覽器
3. 如果沒運(yùn)行 → 自動(dòng)在后臺(tái)啟動(dòng)，等就緒后再打開瀏覽器

解決方案：.bat 啟動(dòng)腳本

創(chuàng)建一個(gè) .bat 批處理文件，利用 Windows 的 wsl 命令啟動(dòng) WSL2 中的 Hermes，并用 curl 檢測(cè)端口狀態(tài)。

實(shí)現(xiàn)要點(diǎn)

.bat 腳本編寫踩坑記錄

這部分是本文的核心價(jià)值，記錄了編寫這個(gè)不到30行 .bat 文件時(shí)踩的所有坑。

坑1：%errorlevel%在代碼塊里不實(shí)時(shí)更新

.bat 文件中，%errorlevel% 在 (...) 代碼塊里只會(huì)在進(jìn)入代碼塊時(shí)解析一次，后續(xù)變化不會(huì)反映到 %errorlevel% 里。

if condition (
    some_command          :: 這個(gè)命令改變了 errorlevel
    echo %errorlevel%    :: ? 這里永遠(yuǎn)是進(jìn)入代碼塊時(shí)的值，不是最新值！
)

解決方法：用 setlocal enabledelayedexpansion 開啟延遲環(huán)境變量擴(kuò)展，然后用 !errorlevel! 獲取實(shí)時(shí)值。

坑2：!errorlevel!必須開啟延遲擴(kuò)展才能用

如果直接用 !errorlevel! 而沒有在文件開頭加 setlocal enabledelayedexpansion，cmd.exe 會(huì)報(bào)錯(cuò)。

:: ? 錯(cuò)誤寫法（會(huì)報(bào)錯(cuò)）
@echo off
echo !errorlevel!
:: ? 正確寫法
@echo off
setlocal enabledelayedexpansion
echo !errorlevel!

坑3：if %errorlevel%==0在代碼塊里失效

同理，因?yàn)?%errorlevel% 只解析一次，判斷結(jié)果不準(zhǔn)確。

解決方法：用 if not errorlevel 1（經(jīng)典寫法，不需要延遲擴(kuò)展）。

if not errorlevel 1 的含義是：如果 errorlevel 不小于 1（即 errorlevel == 0）

這是 Windows .bat 腳本的經(jīng)典 idiom，推薦優(yōu)先使用。

坑4：%%在 .bat 文件中的特殊含義

在 .bat 文件中，%% 表示一個(gè) literal % 字符。所以當(dāng)我們要將 %{http_code} 傳遞給 curl 的 -w 參數(shù)時(shí)，必須寫成 %%{http_code}。

:: 在 .bat 文件里這樣寫：
curl -s -o nul -w "%%{http_code}" http://127.0.0.1:9119/

:: cmd.exe 執(zhí)行時(shí)，%%{http_code} → %{http_code}
:: 這正是 curl -w 參數(shù)期望的格式化字符串

如果在 .bat 文件里直接寫 %{http_code}，cmd.exe 會(huì)試圖將 {http_code} 當(dāng)作環(huán)境變量來展開，導(dǎo)致錯(cuò)誤。

坑5：start /min wsl ...的進(jìn)程生命周期

最開始我用了 wsl -d Ubuntu-22 -- ... 直接啟動(dòng)，但發(fā)現(xiàn) .bat 文件執(zhí)行完畢后，WSL 進(jìn)程也隨之退出（因?yàn)?.bat 是同步等待子進(jìn)程結(jié)束的）。

解決方法：用 start /min wsl ... 在獨(dú)立的最小化窗口中啟動(dòng) WSL，這樣：

• .bat 文件不會(huì)被阻塞（ start 是異步的）
• WSL 進(jìn)程不會(huì)隨 .bat 退出而丟失
• 窗口是最小化的，不會(huì)干擾用戶

坑6：timeout /t在等待循環(huán)里不能用/nobreak

timeout /t 1 /nobreak 在某些 Windows 版本里會(huì)等待用戶按鍵。在等待循環(huán)里應(yīng)該用 timeout /t 1 >nul 靜默等待。

完整代碼

將以下內(nèi)容保存為 Hermes Web.bat，放到桌面：

@echo off
chcp 65001 >nul 2>&1
setlocal EnableDelayedExpansion
title Hermes Web Dashboard

echo ============================================
echo    Hermes Agent - Web Dashboard Launcher
echo ============================================
echo.

:: Check if already running
curl -s -o nul -w "%%{http_code}" http://127.0.0.1:9119/ 2>nul | findstr "200" >nul
if not errorlevel 1 (
    echo [OK] Already running, opening browser...
    start http://127.0.0.1:9119
    exit /b 0
)

echo [INFO] Starting Hermes Dashboard in WSL2...
start /min wsl -d Ubuntu-22 --user sanlin -- bash -c "cd ~/.hermes/hermes-agent && source .venv/bin/activate && hermes dashboard --host 0.0.0.0 --insecure --tui --no-open"

echo [INFO] Waiting for dashboard to start...
timeout /t 5 >nul

:waitloop
curl -s -o nul -w "%%{http_code}" http://127.0.0.1:9119/ 2>nul | findstr "200" >nul
if not errorlevel 1 (
    echo [OK] Dashboard is ready!
    start http://127.0.0.1:9119
    exit /b 0
)
timeout /t 1 >nul
goto waitloop

代碼說明：

• chcp 65001：切換到 UTF-8 代碼頁，支持中文顯示
• setlocal EnableDelayedExpansion：開啟延遲環(huán)境變量擴(kuò)展（本腳本里用 if not errorlevel 1 代替了 !errorlevel!，所以其實(shí)可以不用，但加上是好習(xí)慣）
• start /min wsl ...：在最小化窗口啟動(dòng) WSL2，不阻塞 .bat 執(zhí)行
• :waitloop 循環(huán)：每秒檢測(cè)一次端口，最多等 30 秒（代碼里是無限循環(huán)，可以自行加上計(jì)數(shù)器限制）

使用方法

1. 打開記事本（Notepad）
2. 粘貼上面的代碼
3. 另存為 → 選擇桌面 → 文件名填 Hermes Web.bat → 編碼選 ANSI 或 UTF-8 均可 → 保存
4. 雙擊桌面上的 Hermes Web.bat 圖標(biāo)

效果

總結(jié)

通過 .bat 腳本 + wsl 命令，可以在 Windows 上優(yōu)雅地啟動(dòng) WSL2 中的 Hermes Agent，并自動(dòng)打開瀏覽器訪問 Web Dashboard。

核心知識(shí)點(diǎn)：

1. .bat 腳本中 %errorlevel% 在代碼塊里不實(shí)時(shí)更新 → 用 if not errorlevel 1 或 !errorlevel!
2. %% 在 .bat 中表示 literal % → 寫 %%{http_code} 才能讓 curl 收到 %{http_code}
3. start /min 可以讓子進(jìn)程在獨(dú)立窗口運(yùn)行，不隨父進(jìn)程退出而丟失

到此這篇關(guān)于在Windows上優(yōu)雅地啟動(dòng)Hermes Agent Web Dashboard的詳細(xì)步驟的文章就介紹到這了,更多相關(guān)Windows啟動(dòng)Hermes Agent Web Dashboard內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論