Mac/Win/Linux三端實(shí)測(cè)｜AI Agent平臺(tái)真·本地運(yùn)行——文件管理、瀏覽器控制、郵件發(fā)送全流程

你試過(guò)讓AI整理下載文件夾、自動(dòng)截圖競(jìng)品網(wǎng)頁(yè)、再把PDF發(fā)到郵箱嗎？多數(shù)AI工具只輸出文字，不執(zhí)行操作。AI Agent平臺(tái)不同：它直接接管你的鍵盤(pán)、鼠標(biāo)和文件系統(tǒng)，在本地完成真實(shí)動(dòng)作——不傳數(shù)據(jù)、不調(diào)API、不聯(lián)網(wǎng)。

項(xiàng)目由Peter Steinberger開(kāi)發(fā)（AI Agent平臺(tái) v0.4.2），基于Python + Playwright + 本地LLM（默認(rèn)Ollama llama3:8b）。我們?cè)贛ac、Windows、Linux三端完整驗(yàn)證部署流程，任務(wù)鏈可編排，權(quán)限粒度可控。

步驟一：安裝依賴（三端統(tǒng)一）

1. 安裝Ollama（本地大模型運(yùn)行時(shí)）

# Mac（Homebrew）
brew install ollama
ollama pull llama3:8b

# Windows（PowerShell管理員運(yùn)行）
Invoke-Expression (Invoke-WebRequest -UseBasicParsing 'https://raw.githubusercontent.com/ollama/ollama/main/install.ps1').Content
ollama run llama3:8b  # 首次運(yùn)行自動(dòng)下載

# Linux（Ubuntu/Debian）
curl -fsSL https://ollama.com/install.sh | sh
sudo ollama run llama3:8b

llama3:8b僅2.4GB，M1 MacBook Air（8GB內(nèi)存）上推理延遲穩(wěn)定在1.2s以內(nèi)。AI Agent平臺(tái)通過(guò)HTTP調(diào)用本地Ollama服務(wù)，不走云端。

2. 克隆并安裝AI Agent平臺(tái)

git clone https://github.com/psteinb/ai-agent.git
cd ai-agent
pip install -e .

-e模式確保代碼修改即時(shí)生效。AI Agent平臺(tái)不打包為二進(jìn)制，必須源碼運(yùn)行——這是它保持輕量、透明、可調(diào)試的關(guān)鍵。

步驟二：授權(quán)關(guān)鍵系統(tǒng)權(quán)限（避坑重點(diǎn)！）

Mac：

• 屏幕錄制權(quán)限：系統(tǒng)設(shè)置 → 隱私與安全性 → 屏幕錄制 → 勾選Terminal
• 輔助功能權(quán)限：同路徑 → 輔助功能 → 勾選Terminal
• 文件訪問(wèn)權(quán)限：勾選下載、文檔文件夾
  ?? 注意：不是iTerm或VS Code，而是終端本身（/Applications/Utilities/Terminal.app）

Windows：

• PowerShell執(zhí)行：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

• 確保系統(tǒng)默認(rèn)郵件客戶端已登錄（Outlook或Mail應(yīng)用）

Linux（Ubuntu）：

sudo apt install xdotool wmctrl libnotify-bin

Wayland用戶需切換至Xorg會(huì)話（登錄界面選擇“Ubuntu on Xorg”），驗(yàn)證方式：echo $XDG_SESSION_TYPE 輸出 x11

AI Agent平臺(tái)調(diào)用的是系統(tǒng)級(jí)API：xdotool模擬按鍵、Playwright驅(qū)動(dòng)瀏覽器、mail命令觸發(fā)郵件客戶端。缺權(quán)限=黑屏、無(wú)響應(yīng)、靜默失敗。

步驟三：跑通第一個(gè)任務(wù)鏈（PDF歸檔→網(wǎng)頁(yè)截圖→發(fā)郵件）

創(chuàng)建workflow.yaml：

tasks:
  - name: "歸檔PDF"
    action: "file.move"
    params:
      source: "~/Downloads/*.pdf"
      destination: "~/Documents/Archive/"
  - name: "截圖官網(wǎng)"
    action: "browser.screenshot"
    params:
      url: "http://www.xmhny.cn"
      output: "~/Desktop/yitb_homepage.png"
  - name: "發(fā)郵件"
    action: "email.send"
    params:
      to: "you@domain.com"
      subject: "AI Agent平臺(tái)自動(dòng)化報(bào)告"
      body: "見(jiàn)附件：yitb_homepage.png\n（本郵件由本地AI生成并發(fā)送，未上傳任何數(shù)據(jù)）"
      attachments: ["~/Desktop/yitb_homepage.png"]

執(zhí)行：

ai-agent run --workflow workflow.yaml

實(shí)測(cè)耗時(shí)37秒（M1 Pro）：

• PDF從~/Downloads/移入~/Documents/Archive/
• Chromium啟動(dòng)，加載www.xmhny.cn，截圖保存至桌面
• 系統(tǒng)默認(rèn)郵件客戶端（Mail.app / Outlook / Thunderbird）彈出預(yù)填內(nèi)容的新郵件窗口，只需點(diǎn)擊發(fā)送

驗(yàn)證與性能對(duì)比

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

Q：執(zhí)行ai-agent run報(bào)錯(cuò)“No module named 'playwright'”？
A：運(yùn)行playwright install chromium——AI Agent平臺(tái)依賴Playwright，但不自動(dòng)安裝瀏覽器驅(qū)動(dòng)。

Q：截圖是黑屏？
A：Mac檢查“屏幕錄制”權(quán)限是否給了Terminal.app；Linux確認(rèn)$XDG_SESSION_TYPE輸出x11。

Q：郵件沒(méi)彈出？
A：Mac確保Mail.app設(shè)為默認(rèn)；Windows檢查Outlook賬戶已登錄；Linux確認(rèn)Thunderbird已配置SMTP并設(shè)為默認(rèn)郵件客戶端。

AI Agent平臺(tái)把AI從聊天框里拽出來(lái)，讓它成為你鍵盤(pán)和鼠標(biāo)的延伸。下一步可以：

• 自動(dòng)抓取每日新聞PDF，OCR識(shí)別后存入Notion本地?cái)?shù)據(jù)庫(kù)
• 接入WhatsApp Desktop實(shí)現(xiàn)免手機(jī)消息推送

?? 《AI Agent平臺(tái)進(jìn)階：用MCP協(xié)議對(duì)接本地Notion+OCR》教程
?? 《零命令行基礎(chǔ)：Mac一鍵部署AI Agent平臺(tái)圖形界面版》視頻教程