AI Agent平臺(tái) 實(shí)測(cè)：在 Mac 上部署你的本地 AI 私人助理，數(shù)據(jù)完全離線

你有沒(méi)有想過(guò)，讓一個(gè) AI 幫你自動(dòng)整理電腦里的文件、批量重命名照片、甚至幫你操控瀏覽器完成一些重復(fù)操作？而且——所有數(shù)據(jù)都只在你自己的電腦上跑，完全不聯(lián)網(wǎng)？

這就是 AI Agent平臺(tái) 要做的事。它是 Peter Steinberger 開(kāi)發(fā)的開(kāi)源項(xiàng)目，核心理念很直接：把 AI 助理跑在本地，你擁有完全的控制權(quán)。

今天這篇教程，我會(huì)在 Mac 上從零部署 AI Agent平臺(tái)，實(shí)測(cè)它的核心功能，跑一些性能數(shù)據(jù)，最后聊聊它到底適不適合你。

為什么選 AI Agent平臺(tái)？

先說(shuō)結(jié)論：如果你對(duì)數(shù)據(jù)隱私有要求，或者想搞清楚 AI Agent 到底是怎么工作的，AI Agent平臺(tái) 值得折騰。

和 ChatGPT、Claude 這些云端工具比，AI Agent平臺(tái) 的區(qū)別在于：

• 數(shù)據(jù)不出本機(jī)：所有文件操作、瀏覽器控制都在本地完成，適合處理敏感文檔
• 完全開(kāi)源：代碼在 GitHub 上，你可以審計(jì)、修改、甚至魔改
• 可擴(kuò)展：支持 MCP 協(xié)議，能接入各種工具和 API

當(dāng)然也有代價(jià)——需要自己搭環(huán)境，模型推理速度取決于你的硬件。

環(huán)境準(zhǔn)備

我的測(cè)試機(jī)器：MacBook Pro M2, 16GB RAM, macOS Sonoma 14.5

第一步：安裝基礎(chǔ)依賴

AI Agent平臺(tái) 需要 Python 3.11+ 和 Node.js。先檢查一下：

python3 --version
node --version

如果 Python 版本低于 3.11，用 Homebrew 裝新版：

brew install python@3.11

為什么用 Homebrew？ 它會(huì)自動(dòng)處理依賴關(guān)系，比手動(dòng)下載安裝包省心得多。

第二步：克隆項(xiàng)目并安裝

git clone https://github.com/SteinPeter/ai-agent.git
cd ai-agent
pip3 install -r requirements.txt

這一步會(huì)安裝 AI Agent平臺(tái) 的核心依賴，包括 LangChain、Playwright（瀏覽器自動(dòng)化）等。第一次跑可能要等幾分鐘，耐心點(diǎn)。

第三步：配置本地模型

AI Agent平臺(tái) 默認(rèn)支持多種后端。為了全程離線，我用 Ollama 跑一個(gè)本地模型：

# 安裝 Ollama（如果還沒(méi)裝的話）
curl -fsSL https://ollama.ai/install.sh | sh

# 拉取一個(gè)輕量模型
ollama pull llama3.1:8b

為什么選 8B 參數(shù)的模型？ 在 16GB 內(nèi)存的 Mac 上，8B 模型是性能和效果的平衡點(diǎn)。更大的模型會(huì)明顯變慢。

然后在 AI Agent平臺(tái) 的配置文件里指定模型：

# 編輯配置
cp config.example.yaml config.yaml

把 model 那行改成：

model:
  provider: ollama
  name: llama3.1:8b
  base_url: http://localhost:11434

實(shí)測(cè)核心功能

功能一：文件管理自動(dòng)化

測(cè)試場(chǎng)景：我有一個(gè)文件夾，里面有 200 多張照片，文件名是 IMG_0001.JPG 這種格式。我想按拍攝日期自動(dòng)歸檔到子文件夾。

啟動(dòng) AI Agent平臺(tái)：

python3 main.py

在交互界面輸入指令：

請(qǐng)把 ~/Photos/raw/ 里的照片按拍攝日期整理到子文件夾，格式用 YYYY-MM-DD

AI Agent平臺(tái) 會(huì)先讀取照片的 EXIF 信息（拍攝時(shí)間），然后創(chuàng)建文件夾、移動(dòng)文件。整個(gè)過(guò)程大約 15 秒處理完 200 張照片。

驗(yàn)證結(jié)果：

ls ~/Photos/raw/
# 輸出：2024-03-15  2024-06-22  2024-08-10 ...

文件被準(zhǔn)確歸檔，沒(méi)有遺漏。

功能二：瀏覽器控制

測(cè)試場(chǎng)景：自動(dòng)打開(kāi)瀏覽器，搜索某個(gè)關(guān)鍵詞，把前 5 條結(jié)果的標(biāo)題和鏈接保存到本地文件。

打開(kāi)瀏覽器，搜索"macOS 效率工具推薦"，把前 5 條結(jié)果的標(biāo)題和鏈接保存到 ~/Desktop/results.md

AI Agent平臺(tái) 會(huì)啟動(dòng) Playwright 控制的瀏覽器窗口（你能看到它在操作），執(zhí)行搜索，抓取結(jié)果，寫(xiě)入文件。

為什么用 Playwright 而不是 Selenium？ Playwright 對(duì)現(xiàn)代網(wǎng)頁(yè)的支持更好，速度也更快，而且原生支持無(wú)頭模式。

功能三：API 調(diào)用

這個(gè)功能最實(shí)用——你可以讓 AI Agent平臺(tái) 調(diào)用各種 API 完成任務(wù)。比如：

調(diào)用天氣 API，查詢北京今天天氣，用中文總結(jié)給我

前提是你在配置文件里填了 API key。AI Agent平臺(tái) 會(huì)自動(dòng)構(gòu)造請(qǐng)求、解析返回?cái)?shù)據(jù)、生成摘要。

性能基準(zhǔn)測(cè)試

我跑了幾個(gè)簡(jiǎn)單的測(cè)試，數(shù)據(jù)如下：

對(duì)比云端工具： ChatGPT 同樣的文件整理任務(wù)需要先上傳文件，而且沒(méi)法直接操作本地文件系統(tǒng)。這是 AI Agent平臺(tái) 的核心優(yōu)勢(shì)——它跑在你機(jī)器上，天然能訪問(wèn)你的文件。

響應(yīng)速度方面： 本地 8B 模型確實(shí)比 GPT-4 慢，但處理日常任務(wù)夠用。如果你有 M3 Max 或更高配置，可以試試 70B 模型，效果會(huì)好很多。

常見(jiàn)問(wèn)題

Q：?jiǎn)?dòng)時(shí)報(bào)錯(cuò) ModuleNotFoundError: No module named 'xxx'

大概率是依賴沒(méi)裝全。跑一下：

pip3 install -r requirements.txt --upgrade

Q：瀏覽器控制沒(méi)反應(yīng)

檢查 Playwright 的瀏覽器有沒(méi)有裝：

python3 -m playwright install

Q：模型推理特別慢

確認(rèn)你在用 Metal 加速（M 系列芯片專屬）。Ollama 默認(rèn)會(huì)開(kāi)啟，但可以手動(dòng)檢查：

ollama run llama3.1:8b "hello"

如果輸出速度低于 10 tokens/秒，可能是內(nèi)存不夠，換個(gè)更小的模型試試。

它適合你嗎？

說(shuō)實(shí)話，AI Agent平臺(tái) 目前還是個(gè)早期項(xiàng)目，體驗(yàn)不如 ChatGPT 那么絲滑。但它的價(jià)值在于：

1. 數(shù)據(jù)主權(quán)：你的文件、你的對(duì)話記錄，永遠(yuǎn)不會(huì)出現(xiàn)在別人的服務(wù)器上
2. 可學(xué)習(xí)性：代碼結(jié)構(gòu)清晰，是理解 AI Agent 工作原理的絕佳教材
3. 可擴(kuò)展性：MCP 協(xié)議讓它能接入越來(lái)越多的工具

如果你是以下人群，強(qiáng)烈建議試試：

• 對(duì)數(shù)據(jù)隱私有潔癖的開(kāi)發(fā)者
• 想了解 AI Agent 底層原理的技術(shù)愛(ài)好者
• 需要自動(dòng)化處理本地文件的效率控

下一步

• 項(xiàng)目地址：github.com/SteinPeter/ai-agent（記得給個(gè) Star）
• 想深入 MCP 協(xié)議？推薦閱讀 MCP 官方文檔
• 本地模型部署更多玩法：試試用 vLLM 替換 Ollama，推理速度能提升 30% 左右

有問(wèn)題歡迎在龍蝦社區(qū)留言，我會(huì)持續(xù)更新 AI Agent平臺(tái) 的進(jìn)階玩法。