Skip to content

AgentBridge Studio 0.4.7 (Apple Silicon · ad-hoc signed, not notarized)

Choose a tag to compare

View all tags
@iancheng64-cmd iancheng64-cmd released this 06 Oct 07:48
· 14 commits to main since this release
v0.4.7
26dd816

AgentBridge Studio 0.4.7 (Apple Silicon)

注意： 此版本為 ad-hoc 簽章、尚未 Apple 公證（Apple Silicon · ad-hoc signed, not notarized）。首次從網路下載開啟時，請參閱下方的 Gatekeeper 排除教學。

🚀 兩種使用方式 (Getting Started)

方式一：Git Clone 一鍵從原始碼執行（推薦開發者）

只需在終端機複製專案並執行啟動腳本，系統會自動檢查環境、安裝套件、編譯程式並準備瀏覽器環境：

git clone https://github.com/iancheng64-cmd/AgentBridgeStudio.git
cd AgentBridgeStudio
./start.sh

或使用 npm：

git clone https://github.com/iancheng64-cmd/AgentBridgeStudio.git
cd AgentBridgeStudio
npm install
npm start

若需啟用原生 Computer Use（畫面點擊/辨識），系統需已安裝 Xcode Command Line Tools（xcode-select --install）。

方式二：下載打包好的 DMG 安裝檔（免編譯）

  1. 下載下方 Release 附件中的 AgentBridge-Studio-0.4.7-arm64.dmg。
  2. 點擊開啟 DMG，將 AgentBridge Studio 拖移至 Applications (應用程式) 目錄。
  3. 重要：請務必從「應用程式」目錄啟動，切勿直接在掛載的 DMG 中執行。

解決 macOS 安全性攔截 (Gatekeeper Bypass)

由於本版本為社群 ad-hoc 簽名，macOS 下載後可能會提示「無法打開」或「已損毀，您應該將它丟到垃圾桶」：

  • 方法一（終端機一鍵解除隔離，最推薦）：
    打開終端機 (Terminal) 執行以下指令即可正常開啟： 
    xattr -cr "/Applications/AgentBridge Studio.app"
  • 方法二（系統設定允許）：
    前往 系統設定 > 隱私權與安全性，捲動至安全性區塊，在被阻擋提示旁點擊「仍要打開 (Open Anyway)」。

⚙️ macOS 本機權限設定 (Computer Use)

若需讓 AI 檢視螢幕、點擊滑鼠或鍵盤輸入：

  1. 開啟 App 後前往「電腦與工具 > macOS 系統權限」。
  2. 依提示前往 系統設定 > 隱私權與安全性，授權以下兩項：
    • 輔助使用 (Accessibility)：勾選 AgentBridge Studio
    • 螢幕錄製 (Screen Recording)：勾選 AgentBridge Studio
      (若系統提示需重新啟動 App，請重啟後重新檢查)

🖥️ 遠端 Runtime 連線條件

AgentBridge 採用本機工具執行 + 遠端模型運行的架構，請確保遠端主機符合以下條件：

  • SSH 服務：可由 Mac 透過區網或 Tailscale 存取的 SSH 連線。
  • Codex 主機：
    • 需安裝並登入 @openai/codex@0.160.0（與本機執行器配對）： 
      npm install -g @openai/codex@0.160.0
codex login
  • Claude 主機：
    • 需安裝可執行的原生 Claude Code CLI： 
      npm install -g @anthropic-ai/claude-code
claude login
  • 首次連線時請於 App 中確認並接受 SSH 主機指紋。

🔒 檔案驗證 (Integrity Checksums)

請使用 SHA256SUMS.txt 核對下載檔案完整性：

shasum -a 256 -c SHA256SUMS.txt
檔案名稱 SHA256 雜湊值
AgentBridge-Studio-0.4.7-arm64.dmg cdc295b8d6115d5eea89e5e43d7c09b3ade3d4c874ab9f1a0a68206ef6778224
AgentBridgeStudio-0.4.7-source.zip 3460a591507bc43f2b0565adb6f873a04bc8d34025f87f37b881d89b56efa183
Assets 7
Loading