AgentBridge Studio 0.6.1 (Apple Silicon · 多任務並行)

AgentBridge Studio 0.6.1 — 多任務並行執行

核心改動

現在可以同時開好幾個任務跑了。 之前整個 App 只有一個 working 全域狀態，第二個任務會把第一個搶掉。這版重構成多任務架構：

新增

• 多任務並行：每個對話向 TaskRuntimePool 租用獨立的 Runtime 進程，上限 8 個並行任務，任務結束自動歸還行程。
• Codex + Claude Code 混用：兩個 Agent 各自維護連線與任務池。你可以一邊讓 Codex 跑程式，一邊讓 Claude 寫文件，互不干擾。

重構

• 單一 working 狀態 → works Map（以 requestId 索引）。事件路由、停止按鈕、權限核准、TTS 全部用 requestId 定位到正確的對話。
• 工具結果索引改用 messageId:itemId 複合鍵，並行時工具截圖不會寫進別的對話。
• 側邊欄「執行中」圓點與刪除按鈕改為逐對話判斷。
• 切換 Agent、重新連線的阻擋條件改為只擋同一 Agent 的工作，不再誤擋另一邊。

修正

• 切換對話時不再需要先停止另一個 Agent 的工作。
• 打斷任務後插入新提示的競態條件（sendPending 改為 Set，按對話隔離）。

驗證

• Renderer + Main 進程序 TypeScript 型別檢查：0 錯誤
• 175 單元測試全過（含新增 task-runtime-pool 並行租用測試）
• DMG CRC32 驗證 VALID，SHA256 cb9faf658ed378c7d5ba1fee93ada5d589942398bc788461a5606bb490e87cf6
• 已安裝至 /Applications 並啟動確認

安裝

下載 DMG，拖到 Applications 取代舊版即可。ad-hoc 簽名，未公證，首次開啟需在系統設定允許。

---

Commit: 287639e · 上一版: v0.6.0

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

AgentBridge Studio 0.6.0 (Apple Silicon)

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

---

🆕 0.6.0 改動：ChatGPT App 功能對齊（A/B 兩批）

本版補齊與 ChatGPT 桌面 App 對標時缺少的 10 項功能。

A 批（核心互動）

功能	使用方式	說明
編輯訊息並重送	訊息列 ✏️ 按鈕	編輯已送出的使用者訊息，後續回覆移除後以新內容重送；原訊息附件會保留
在目前對話中尋找	⌘ F	比對訊息文字與工具標題，↑ ↓ 切換結果，點擊跳轉並高亮該則訊息
朗讀回覆	訊息列 🎤 按鈕	以 zh-TW 語音朗讀任一回覆，再點一次停止；可在「設定 → 一般」開啟回覆結束自動朗讀
從訊息建立分支	訊息列 ⑂ 按鈕	從任一訊息建立新對話，保留到該則為止的上下文
臨時對話	⌘ T	不進入歷史紀錄與側邊欄；對話選單可一鍵保留為一般對話

B 批（偏好與環境）

功能	使用方式	說明
自訂指令	設定 → 一般	以使用者訊息區塊注入每次對話；Codex 與 Claude 兩個後端都支援
提示範本	⇧ ⌘ U	新增／刪除／點擊插入輸入框，範本存在本機（上限 50 則）
多視窗	⌘ U	經由 IPC 建立第二個視窗；已有兩視窗時拒絕以保護歷史紀錄寫入
桌面通知	設定 → 一般	回覆結束且視窗無焦點時發出 macOS 通知
訊息書籤	訊息列 📌 按鈕	任一訊息可加入／移除書籤，標記訊息左側顯示標記色邊條

修正的 bug

• 執行中插入提示詞後永遠卡在「正在思考」（死鎖）：interruptAndSend 設了 sendPending 旗標才去呼叫 send()，但 send() 開頭的 guard 看到旗標就直接返回，新提示從未送出。已加 {interrupted:true} 旁路。
• 編輯訊息重送有時序競態：setChats 是非同步的，重送時 sendRuntime 可能讀到截斷前的完整訊息，把被刪除的後續回覆整包塞進上下文。新增 forcedMessages 旁路直接傳截斷後的訊息。
• 編輯訊息重送丟失附件：原訊息的圖片／檔案現在會跟著重送。
• 臨時對話仍寫進磁碟歷史：useChatHistory 的 flush 未過濾 temporary 旗標，關閉視窗後重開仍看得到。現在只有非臨時對話會寫入。
• 全域搜尋（⌘ K）列出臨時對話：filter 加上 !chat.temporary。
• 朗讀中切換對話不會停止：currentId 變更時自動 speechSynthesis.cancel()。
• 臨時對話在記憶體堆積（每次 ⌘ T 都新建而不清理舊的空臨時對話）。
• 提示範本無數量上限，可能撐爆 localStorage（現在上限 50 則）。

鍵盤快速鍵

動作	快速鍵
新對話	⇧ ⌘ N
臨時對話	⌘ T
提示範本	⇧ ⌘ U
搜尋對話	⌘ K
在目前對話中尋找	⌘ F
開啟新視窗	⌘ U
展開／收合側邊欄	⌘ B
開啟設定	⌘ ,
傳送訊息	Enter
訊息換行	Shift + Enter
關閉對話框	Esc

驗證

• tsc（renderer + main）零錯誤
• vite build 成功
• 171 項單元測試：170 pass / 1 skip / 0 fail
• DMG hdiutil verify CRC32 驗證通過

---

🚀 兩種使用方式 (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.6.0-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)

檔案名稱	SHA256 雜湊值
AgentBridge-Studio-0.6.0-arm64.dmg	b38d7ca4412490420a72099fd6b543834f341ed021f21d831c418a18cd6bc0a3

核對方式：

shasum -a 256 dist/AgentBridge-Studio-0.6.0-arm64.dmg
# 應輸出 b38d7ca4412490420a72099fd6b543834f341ed021f21d831c418a18cd6bc0a3

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

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