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

遇到的問題

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

解決方案

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

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

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

具體操作步驟

第一步：下載部署包

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

文件大約 1.2GB，因?yàn)槔锩娲虬四Ｐ瓦\(yùn)行所需的所有組件。

第二步：校驗(yàn)文件完整性

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

Get-FileHash .\AI Agent平臺(tái)-Win11-Portable-v2.4.0.zip -Algorithm SHA256

把輸出的哈希值和 GitHub Releases 頁面公布的校驗(yàn)碼對(duì)比：

預(yù)期 SHA256: a3f8c2e1d9b74f6a8c3e2d1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b

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

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

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

D:\AI Agent平臺(tái)

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

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

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

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

雙擊 start.bat，會(huì)彈出一個(gè)命令行窗口。第一次啟動(dòng)會(huì)初始化環(huán)境，大概需要 1-2 分鐘?？吹筋愃七@樣的輸出說明啟動(dòng)成功：

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

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

第五步：瀏覽器訪問

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

試著輸入一個(gè)問題測(cè)試：

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

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

驗(yàn)證部署是否正常

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

curl http://localhost:8080/health

正常返回：

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

常見問題

Q：啟動(dòng)時(shí)報(bào)錯(cuò) Port 8080 already in use

端口被占了。兩種解法：

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

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

Q：啟動(dòng)后瀏覽器打不開頁面

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

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

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

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

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

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

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

實(shí)際使用場(chǎng)景

我自己用 AI Agent平臺(tái) 主要是這幾個(gè)場(chǎng)景：

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

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

下一步

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

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

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