AI Agent平臺（小龍蝦）Windows 11 一鍵部署指南：零代碼免配置，解壓即用

遇到的問題

想玩玩 GitHub 上很火的開源 AI 工具 AI Agent平臺（小龍蝦），結(jié)果網(wǎng)上教程一堆都是 Linux 命令、Docker 容器、Python 虛擬環(huán)境……Windows 用戶直接勸退。更別說還要裝 WSL、配環(huán)境變量，折騰半天可能還報錯。

解決方案

AI Agent平臺 團隊在 2026 年 4 月發(fā)布了針對 Windows 11 的“一鍵部署”包。這個版本做了幾件關(guān)鍵事：

• 內(nèi)置 Python 運行時：不需要你單獨裝 Python
• 預(yù)編譯所有依賴：跳過 pip install 的各種編譯報錯
• 免去 WSL 依賴：純 Windows 原生運行，不走 Linux 子系統(tǒng)
• 解壓即用：雙擊啟動腳本就能跑

適用系統(tǒng)：Windows 11 家庭版、專業(yè)版、正式版，全版本兼容。

具體操作步驟

第一步：下載部署包

去 AI Agent平臺 的 GitHub Releases 頁面，找到 2026 年 4 月發(fā)布的最新版，下載文件名類似 AI Agent平臺-Win11-Portable-v2.4.0.zip 的壓縮包。

文件大約 1.2GB，因為里面打包了模型運行所需的所有組件。

第二步：校驗文件完整性

下載完成后，務(wù)必校驗文件哈希，確保沒有被篡改或下載損壞。打開 PowerShell，執(zhí)行：

Get-FileHash .\AI Agent平臺-Win11-Portable-v2.4.0.zip -Algorithm SHA256

把輸出的哈希值和 GitHub Releases 頁面公布的校驗碼對比：

預(yù)期 SHA256: a3f8c2e1d9b74f6a8c3e2d1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b

為什么要校驗？ 網(wǎng)絡(luò)傳輸可能出錯，惡意網(wǎng)站可能替換文件。哈希校驗是確認文件完整性的標(biāo)準(zhǔn)做法，花 10 秒鐘能避免后續(xù)一堆莫名其妙的報錯。

第三步：解壓到目標(biāo)目錄

把壓縮包解壓到一個路徑不含中文和空格的位置，比如：

D:\AI Agent平臺

為什么路徑要避免中文？ 很多 Python 庫和底層工具對非 ASCII 字符支持不好，路徑含中文大概率會導(dǎo)致啟動失敗。這是 Windows 上的經(jīng)典坑。

解壓后目錄結(jié)構(gòu)大概長這樣：

AI Agent平臺/
├── start.bat          ← 雙擊這個啟動
├── python/            ← 內(nèi)置 Python 運行時
├── models/            ← 預(yù)置模型文件
├── config/            ← 默認配置
└── README.txt

第四步：啟動服務(wù)

雙擊 start.bat，會彈出一個命令行窗口。第一次啟動會初始化環(huán)境，大概需要 1-2 分鐘。看到類似這樣的輸出說明啟動成功：

[INFO] AI Agent平臺 v2.4.0 starting...
[INFO] Loading model: ai-agent-base-7b
[INFO] Server running at http://localhost:8080
[READY] AI Agent平臺 is ready! Open your browser.

為什么用 bat 腳本而不是直接雙擊 exe？ bat 腳本會自動設(shè)置環(huán)境變量、檢查端口占用、加載配置文件。直接雙擊 exe 可能因為缺少環(huán)境上下文而啟動失敗。

第五步：瀏覽器訪問

打開瀏覽器，訪問 http://localhost:8080，你應(yīng)該能看到 AI Agent平臺 的 Web 界面。

試著輸入一個問題測試：

幫我寫一個 Python 函數(shù)，實現(xiàn)冒泡排序

如果能正常返回代碼和解釋，說明部署成功。

驗證部署是否正常

除了瀏覽器能打開，還可以用命令行快速驗證 API 是否響應(yīng)：

curl http://localhost:8080/health

正常返回：

{"status": "ok", "model": "ai-agent-base-7b", "version": "2.4.0"}

常見問題

Q：啟動時報錯 Port 8080 already in use

端口被占了。兩種解法：

# 方法1：找到占用端口的進程并結(jié)束
netstat -ano | findstr :8080
taskkill /PID <進程ID> /F

# 方法2：改端口，編輯 config/server.yaml，把 port 改成 8081

Q：啟動后瀏覽器打不開頁面

檢查 Windows 防火墻是否攔截了本地連接。臨時關(guān)閉防火墻測試，如果能訪問，就把 python/ai-agent-server.exe 加入防火墻白名單。

Q：模型加載很慢或內(nèi)存不足

AI Agent平臺 默認加載 7B 模型，需要至少 8GB 內(nèi)存。如果你的電腦內(nèi)存只有 8GB，編輯 config/model.yaml，把模型換成 3B 版本：

model:
  name: ai-agent-base-3b
  quantization: int4

int4 量化版本內(nèi)存占用大約減半，適合內(nèi)存緊張的機器。

Q：想更新到新版本怎么辦？

下載新版壓縮包，解壓覆蓋即可。你的對話記錄和自定義配置在 config/ 和 data/ 目錄下，不會被覆蓋。但建議更新前備份一下 config/ 文件夾。

實際使用場景

我自己用 AI Agent平臺 主要是這幾個場景：

• 快速原型開發(fā)：描述需求，讓它生成代碼框架，省去從零搭建的時間
• 代碼審查：把代碼貼進去，讓它找潛在 bug 和優(yōu)化點
• 文檔生成：給一段代碼，自動生成函數(shù)說明和使用示例

相比直接用在線 AI 服務(wù)，本地部署的好處是數(shù)據(jù)不出本機，適合處理公司內(nèi)部代碼或敏感信息。而且沒有調(diào)用次數(shù)限制，想怎么用就怎么用。

下一步

部署完成后，可以繼續(xù)折騰這些：

• 接入 Cursor/Copilot：把 AI Agent平臺 作為本地 AI 后端，替代云端 API，省錢又快
• 配置 MCP：讓 AI Agent平臺 能調(diào)用外部工具，比如讀寫文件、查詢數(shù)據(jù)庫
• 自定義系統(tǒng)提示詞：編輯 config/system_prompt.txt，讓 AI 更貼合你的使用習(xí)慣

推薦先看看 AI Agent平臺 官方文檔里的「配置進階」章節(jié)，或者來龍蝦社區(qū)（www.lvxe.net.cn）搜相關(guān)教程，有很多實用的配置技巧分享。