Release Notes — Better Agent Terminal（gowerlin fork）

本 fork 各版的更版重點（內容取自 GitHub Releases，最新在上）。上游 tony1223/better-agent-terminal 的 v2.1.x 紀錄保留在檔案最下方。

v0.7.5-pre.1（2026-11-05）

版號 0.7.5-pre.1，接續 v0.7.4-pre.9。

本版重點：Windows 安裝版更新時，終端分頁不再被結束。持有終端的程式改由安裝目錄外的 PTY holder 執行，安裝程式只結束 BAT 主程式；分頁裡的 shell 與執行中的指令留在原地，新版開啟後自動接回。這項保護從本版開始生效：從 0.7.4-pre.9 或更早的版本更新到本版，終端仍會被結束（舊版沒有 holder）；從本版再更新到之後的版本，終端才會保留。

新增

Windows 更新不再結束終端分頁（PLAN-065）：用 .exe 安裝版更新、重新安裝同一版或降級到有 holder 的版本時，分頁裡的 shell 與執行中的長指令（例如建置、ping -t）在安裝期間持續執行；重開 BAT 不跳 Recovery 提示，直接接回，並顯示「升級期間 N 個終端持續執行並已接回」。
分頁裡從安裝目錄執行的程式（例如 BAT 內嵌的 claude）會在更新前由 BAT 先結束（安裝程式不用等），分頁本身與 shell 保留；這些分頁列進「被中斷的 agent 分頁」，可一鍵恢復對話（PLAN-065）。
Help ›「Check for Updates…」：隨時手動檢查新版；啟動時也會自動檢查一次。新增「包含預覽版」選項（預設開）；有新版時可直接開啟該版本的 Release 頁（BUG-212）。

修正

新版檢查永遠找不到新版：先前只查詢正式版（本 fork 全是預覽版，所以查不到），也不認得 -pre.N 版號；現在預覽版也會通知（BUG-212）。
從終端、IDE 或腳本帶 pipe 啟動 BAT 時，BAT 結束後呼叫端一直等不到結束：Terminal Server 啟動時不再繼承 BAT 從呼叫端拿到的 handle（BUG-213）。從檔案總管、開始功能表或捷徑啟動本來就不受影響。

更新

啟動時檢查新版預設開啟：以前存過任何設定的使用者，這個選項實際上是關的；更新到本版後會改成開一次，之後你在 Settings 關掉就照你的設定。
解除安裝時會結束 PTY holder 並刪除它的目錄（%LOCALAPPDATA%\BAT-PtyHolder 或 %ProgramFiles%\BAT-PtyHolder），使用者資料保留；holder 目錄有程式還在執行時保留不刪。
Terminal Server 的連線改為需要權杖驗證（只有本機 BAT 讀得到），不認得的請求一律拒絕。

待驗收（請更新到本版後協助確認）

下一次更新時終端是否保留：裝好本版後開幾個分頁（可以跑一個長指令），之後更新到下一版，確認分頁的 shell 與指令仍在、重開後顯示「已接回」。
新版檢查：Help ›「Check for Updates…」能找到 GitHub 上的最新預覽版；下一版發佈後啟動 BAT 會出現更新通知。
先前版本仍待確認的項目（Docker Desktop 精靈、同版重裝的說明與一鍵接回、遠端附件上傳的 SSH / Docker 實機、WSL「改用 Mirrored 並重試」、Linux 缺字型提示、Claude 面板排隊送出）照舊歡迎回報。

已知事項

只有 Windows 的 .exe 安裝版有這項保護；.zip 免安裝版、macOS、Linux 的行為不變。
從本版降級到 0.7.4-pre.9 或更早的版本，所有終端會被結束，而且重開後沒有說明。
「為所有使用者安裝」（per-machine）在一般權限下互動更新（會跳 UAC）的情況尚未在實機驗證；若終端沒有保留，重開時會照舊出現 Recovery 提示。
自動化驗收已在 GitHub Windows runner 用真的安裝程式跑過：per-user / per-machine 更新、同版重裝、降級、解除安裝、分頁裡有內嵌 agent。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.9...v0.7.5-pre.1

v0.7.4-pre.9（2026-11-04）

版號 0.7.4-pre.9，接續 v0.7.4-pre.8。

本版重點：Docker 遠端不用再自己建置映像。設定精靈會拉一個基底映像（預設有 git 的 buildpack-deps:bookworm-scm，也可以填自己的開發映像），把 BAT 伺服器套件裝進 volume 再建立容器；重跑精靈就能升級，也能從清單選要沿用哪個既有容器。

新增

Docker 精靈不必自己建置映像（PLAN-052）：「建立新容器」可以填基底映像，預設 buildpack-deps:bookworm-scm（容器裡有 git）。精靈會先拉映像並檢查相容性（需要 glibc 2.35 以上、/bin/sh、tar、gzip；Alpine 這類 musl 映像會在建立任何東西之前被擋下並說明原因），再把伺服器套件裝進 volume、建立容器。伺服器套件沿用 SSH / WSL 的下載與「匯入本機 tarball…」，離線環境也能用。
重跑精靈就是升級（PLAN-052）：對精靈建立的容器再跑一次精靈，版本相同就直接連線；版本不同會先詢問（升級會重啟容器，容器內執行中的終端與 agent 會結束），升級失敗或取消會換回原本的版本。容器、掛載、權杖與憑證都不變。
「沿用既有容器」可以選容器（PLAN-052）：清單列出每個容器的映像、狀態、發佈的連接埠、是否由 BAT 建立；不能用的容器（沒有發佈 9876、或連接埠與 BAT 本身衝突）會顯示原因但不能選；沒有可用容器時提供「改用建立新容器」。選定後會帶出容器原本的資料夾掛載讓你確認。

修正

重跑 Docker 精靈會多一筆設定（PLAN-052）：現在以容器名稱找到原本的設定並更新（名稱保留），不再新增。
沿用剛啟動的容器時拿不到權杖、錯誤看不出原因（PLAN-052）：現在等容器健康後才讀權杖；讀不到時直接說明可能原因（容器不是 BAT 伺服器、可以看 docker logs）。

更新

Docker 權杖不再出現在命令列：新建立的容器不再以 --token 帶入權杖（docker inspect 看不到），權杖只存在容器的資料 volume；以前建立的容器照樣可以沿用。
精靈查詢容器資訊時不再把容器的環境變數傳到畫面端；所有 docker 指令都有逾時。
網站「遠端 › Docker」與部署文件改成新的流程；原本的 bat-server:latest 映像保留為進階用法（精靈偵測到映像已內建伺服器時會略過安裝）。

待驗收（請更新到本版後協助確認）

Docker Desktop（Windows / macOS）：用精靈「建立新容器」（預設基底映像）→ 連線成功；再跑一次精靈確認設定清單仍只有一筆；「沿用既有容器」確認清單與帶出的資料夾掛載正確。本版已在 WSL 內的 Docker Engine 實測（建立、升級、還原、musl 擋下），Docker Desktop 尚未實機走過。
先前版本仍待確認的項目（同版重裝的說明與一鍵接回、遠端附件上傳的 SSH / Docker 實機、WSL「改用 Mirrored 並重試」、Linux 缺字型提示、Claude 面板排隊、macOS 的 claude OSC 7501 與語音輸入、Electron 45）照舊，見 v0.7.4-pre.8 與更早版本的說明。

已知事項

第一次建立容器要下載基底映像（約 130 MiB）與伺服器套件（約 190 MiB）。
arm64 的 Docker 主機尚未實測。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.8...v0.7.4-pre.9

v0.7.4-pre.8（2026-11-04）

版號 0.7.4-pre.8，接續 v0.7.4-pre.7。

本版重點：Windows 上在 BAT 執行中重新安裝同一版（或安裝時被取消），重開後也會說明「安裝程式結束了 N 個終端」，並列出可以接回對話的 agent 分頁。

修正

同版重裝時終端被結束卻沒有任何說明（PLAN-063）：BAT 開著時重新安裝同一版，安裝程式一樣會先請 BAT 結束、所有分頁的指令與 agent 跟著結束，但重開後原本什麼都不顯示（只有版本不同時才說明）。現在只要安裝程式確實結束過 BAT，重開後就會顯示「安裝程式結束了 BAT（v…）與 N 個終端…」，claude / codex 分頁照樣列在「被中斷的 agent 分頁」、可以按「恢復」接回對話。安裝到一半取消也一樣會說明。當機後重開仍然不會出現這個說明。

更新

「被中斷的 agent 分頁」的文字：對話框標題改為「安裝程式結束的 agent 分頁」，說明與縮圖 ⏸ 的提示改成升級、同版重裝、取消安裝都正確的說法（不再寫「安裝新版」「升級前的對話」）。升級到新版時的說明訊息不變。

待驗收（請更新到本版後協助確認）

同版重裝的說明與一鍵接回（Windows）：BAT 開著、留一兩個 claude 分頁，再執行一次本版安裝檔；重開後應看到「安裝程式結束了 BAT（v0.7.4-pre.8）與 N 個終端」，並在「安裝程式結束的 agent 分頁」按「恢復」，確認分頁接回原本的對話。
升級前正常結束（Windows，v0.7.4-pre.6 起）：從 v0.7.4-pre.6 / pre.7 升到本版時，安裝程式應先請 BAT 自己存檔並結束；重開後應看到「BAT 已升級（v… → v0.7.4-pre.8）。安裝新版時結束了 N 個終端…」的說明。（pre.6 → pre.7 已在本機實測通過。）
先前版本仍待確認的項目（遠端附件上傳的 SSH / Docker 實機、WSL「改用 Mirrored 並重試」的真機流程、Linux 缺字型提示的 AppImage 畫面、Claude 面板排隊、macOS 的 claude OSC 7501 與語音輸入、Electron 45）照舊，見 v0.7.4-pre.7 與 v0.7.4-pre.6 的說明。

已知事項

同版重裝與「安裝到一半取消」在紀錄上分不出來，兩種情況都會顯示同一段說明。
遠端附件上傳需要遠端 bat-server 也是 v0.7.4-pre.7 以上。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.7...v0.7.4-pre.8

v0.7.4-pre.7（2026-11-04）

版號 0.7.4-pre.7，接續 v0.7.4-pre.6。

本版重點：遠端視窗（SSH、Docker、WSL 其他發行版）可以直接附加本機檔案；WSL 設定精靈會自動檢查並修正環境（systemd、WSL 2、網路模式），每一步都能中止；Linux 缺中文字型時會提示安裝方法。

新增

遠端視窗可以附加本機檔案（PLAN-038）：在 SSH、Docker（掛載目錄以外）、WSL 其他發行版的視窗，Claude / Codex 面板附加或拖放的檔案，原本因為遠端讀不到而被拒絕；現在送出時會先上傳到該視窗連線的主機，再以主機上的路徑放進訊息。附件上會顯示上傳進度，上傳期間可以取消（訊息與附件都保留）。單檔上限 50 MiB、一次送出合計 100 MiB / 10 個檔；超過上限或上傳失敗時，提示會先說明原因（例：「未附加（超過單檔 50 MiB 上限）：a.zip」）。遠端主機上的暫存檔在關閉分頁後刪除，24 小時後也會自動清掉。
遠端視窗的終端分頁也能拖放本機檔案、貼上圖片（PLAN-038）：拖進 SSH / Docker / WSL 其他發行版視窗終端的檔案，會先上傳再貼上主機上的路徑（不按 Enter）；SSH 與 Docker 視窗按 Ctrl+V 貼剪貼簿圖片時，會上傳成 PNG 後貼上路徑（原本在這兩種視窗一定失敗）。本機與 WSL 視窗的貼圖方式不變。
WSL 設定精靈會檢查並修正環境（PLAN-043）：選完發行版後先檢查 WSL 環境，需要修正時列出一份清單讓你一次確認，再自動套用——systemd 沒開時替你開啟（只改 /etc/wsl.conf 那一行，先備份）；只有 WSL 1 發行版時可轉換成 WSL 2（預設不勾）。清單會標出影響範圍，會停止發行版時列出目前在執行的發行版。修正不會自動還原，完成或取消畫面會列出改了什麼與備份位置。環境正常時不會多出任何畫面。
WSL 連線測試失敗時可「改用 Mirrored 並重試」（PLAN-043）：WSL 在 NAT 模式下連線測試失敗時，錯誤畫面多這個選項；同意後 BAT 會備份並修改 .wslconfig 的網路模式、執行 wsl --shutdown（會關閉所有發行版，同意前會列出）、確認生效後重新測試。系統原則鎖定網路模式、或你已自行設定其他模式時不提供，只說明原因。
設定精靈每一步都可以中止（PLAN-043）：步驟執行中或等待選擇時可以按「中止設定」，BAT 會停止正在跑的動作（下載、安裝、啟動服務），再把已完成的步驟復原。
WSL profile 可以關閉 keep-alive（PLAN-043）：WSL profile 的詳細資料多「保持 WSL 執行」開關，預設開啟（行為不變）；關閉後 WSL 閒置時可能自動關機，下次連線會慢一點。
Linux：缺中文或 emoji 字型時提示安裝方法（PLAN-064）：在 WSL 或精簡安裝的 Linux 上，介面中文與圖示可能顯示成方框。BAT 啟動後會檢查一次，缺字型時跳出提示（英文在前，缺中文字型時中文也看不到），附上安裝指令 sudo apt install -y fonts-noto-cjk fonts-noto-color-emoji，可選「不再提示」。Windows / macOS 不受影響。

修正

遠端視窗一次附多張大圖片，整條遠端連線斷掉（BUG-211）：圖片合計超過約 24 MiB 時，遠端連線會被切斷，同一個遠端 profile 的所有分頁一起受影響，送出的訊息與圖片也無聲遺失。現在圖片合計超過 20 MiB 時會提示並保留輸入與附圖；送出失敗時會說明原因並把訊息放回輸入框，連線不會再因此斷開。

更新

文件：README、網站安裝頁與常見問題補上「Linux / WSL 介面中文或圖示變成方框」的原因與安裝字型的方法。
WSL 精靈：「檢查 systemd」改為真的驗證，systemd 沒開時會在這一步停下並說明，不再到最後才失敗；只有 WSL 1 發行版時不再直接失敗，改為提議轉換。

待驗收（請更新到本版後協助確認）

遠端附件上傳：已在本機以 SSH 伺服器與 Docker 容器自動化驗證（上傳內容、權限、清理、上限、取消都通過）。請 SSH / Docker 使用者實際拖一個檔案到 Claude 面板，確認 agent 讀得到；SSH 視窗的 claude CLI 貼截圖後是否被當成圖片，也請回報。遠端主機的 bat-server 需要一起更新到本版，舊版會照舊顯示「不在遠端主機上」。
WSL 環境修正：已在拋棄式發行版實測（開啟 systemd、WSL 1 轉 WSL 2、中止）。「改用 Mirrored 並重試」只做了自動化測試，尚未在真機執行 wsl --shutdown 的完整流程。
Linux 缺字型提示：已在 WSL 以模擬無字型的環境驗證檢查結果，尚未以 AppImage 在真人桌面看過提示畫面。
升級前正常結束（Windows，v0.7.4-pre.6 起）：從 v0.7.4-pre.6 升到本版時，安裝程式應先請 BAT 自己存檔並結束；重開後應看到「上次升級結束了 N 個終端」的說明。請 Windows 使用者留意並回報。
先前版本仍待確認的項目（Claude 面板排隊、macOS 的 claude OSC 7501 與語音輸入、Linux 桌面 AppImage、Electron 45）照舊，見 v0.7.4-pre.6 的說明。

已知事項

遠端附件上傳需要遠端 bat-server 也是本版；macOS Finder 複製的檔案貼進遠端終端不會上傳，照舊顯示「不在遠端主機上」。
WSL 精靈的修正不會自動還原；轉換成 WSL 2 開始後無法中途停止。
從 v0.7.4-pre.5 或更早的版本升級，仍會強制結束 BAT 與所有終端；即使 BAT 正常結束，終端分頁裡執行中的指令也會結束（PLAN-063 子項 4，目前不做）。
Linux 語音輸入需要 glibc 2.38 以上（Ubuntu 24.04 起），另需 libgomp1 與 libvulkan1（BUG-203）。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.6...v0.7.4-pre.7

v0.7.4-pre.6（2026-11-04）

版號 0.7.4-pre.6，接續 v0.7.4-pre.5。

本版重點：Windows 上安裝新版會結束所有終端分頁——現在安裝前會提醒、安裝時先請 BAT 自己存檔並正常結束、升級後重開會說明結束了哪些終端，claude / codex 分頁可一鍵接回。

新增

Windows：更新通知提醒「安裝新版會結束所有終端分頁」（PLAN-063，T0821）：BAT 有新版時的通知多一行說明——安裝新版會結束所有終端分頁（含執行中的指令與 agent），請先完成或保存工作。README 的 Windows 安裝說明也補上這段。macOS / Linux 不顯示。
升級後重開時說明上次升級結束了哪些終端（PLAN-063，T0821 / T0823）：BAT 版本變了、而且上次執行中的終端在升級時被結束，重開後會顯示一次「BAT 已升級（舊版 → 新版）。安裝新版時結束了 N 個終端…」。原本是 claude / codex 的分頁會列進「被中斷的 agent 分頁」清單，可一鍵接回對話（claude --resume / codex resume）；縮圖上的 ⏸ 也會寫「因安裝新版而中斷」（T0822）。不會自動接回或重跑任何指令。
Windows：安裝新版前先請 BAT 正常結束（PLAN-063，T0823）：安裝程式偵測到 BAT 在執行時，先請它自己存檔、停止 Terminal Server、正常結束（不跳 BAT 的離開確認），最多等 15 秒；BAT 沒有回應或發生任何錯誤，才照舊由安裝程式強制結束。版面與設定因此不會遺失最後的變更，下次啟動也不會留下需要清理的舊程序。互動安裝仍會先顯示「BetterAgentTerminal 正在執行，點擊 OK 關閉」。

修正

同時再開一次 BAT 時，第二個程序不再跑啟動流程（BUG-210，T0825）：BAT 已在執行時再點一次捷徑，第二個程序原本會在結束前跑一段啟動流程（系統匣、Terminal Server 偵測等），若剛好碰上主程式正在結束，可能多開一個 Terminal Server。現在它只把開啟要求交給執行中的 BAT 就立即結束。

待驗收（請更新到本版後協助確認）

升級提醒與說明（Windows）：已在 GitHub Actions 的 Windows runner 與隔離實例自動化驗證。請 Windows 使用者確認更新通知有那一行提醒；下次從本版升級到新版後，重開時應看到「結束了 N 個終端」的說明（從 v0.7.4-pre.5 升到本版這一次，因為舊版沒有記錄版本，不會顯示）。
安裝前正常結束（Windows）：已在 Windows runner 驗證「本版執行中再安裝本版」會正常結束、「v0.7.4-pre.5 執行中安裝本版」照舊強制結束。真正的效果要從本版升級到下一版時才看得到；屆時請留意 BAT 是否很快自己關閉、重開後版面是否完整。
Claude 面板排隊（所有平台）：已在安裝版以假 API 自動化驗證。請在 Claude 面板回覆途中再送一則訊息，確認會排隊、回覆完才處理、可以取消；按 Esc 後排隊的訊息會一起取消。
claude OSC 7501（macOS）：已在 WSL（Ubuntu 24.04）以交付版 AppImage 與真 claude 驗證權限對話框會顯示 ⚠️；macOS 尚未實機驗證。
PLAN-062 / BUG-209（Linux）：已在 GitHub Actions 的 Ubuntu 22.04 / 24.04 以交付版 AppImage 驗證，尚未在真人桌面實機驗證。
語音輸入可用性檢查（macOS）：macOS 尚未實機驗證。請 macOS 使用者確認麥克風按鈕照常可按、語音輸入正常。
BUG-202 / BUG-204（Linux）：請在 Ubuntu 24.04 桌面直接執行 AppImage，確認能開啟，並試用語音輸入（已在 GitHub Actions 驗收，尚未在真人桌面實機驗證）。
Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報。

已知事項

從 v0.7.4-pre.5（或更早）升到本版，仍會強制結束 BAT 與所有終端：「先請 BAT 正常結束」只對本版以後的安裝程式裝的 BAT 生效（舊版不認得這個要求）。
即使 BAT 正常結束，終端分頁裡執行中的指令仍會結束（它們由 Terminal Server 持有，而 Terminal Server 的程式就在安裝目錄裡）；讓終端撐過升級需要較大的架構調整，目前不做（PLAN-063 子項 4）。
以「所有使用者」安裝並經 UAC 提權時，安裝程式本身不檢查執行中的 BAT，改由舊版解除安裝程式強制結束（electron-builder 的既有行為）；以其他帳號提權或 BAT 以 --runtime=N 執行時，正常結束的要求送不到，會等 15 秒後照舊強制結束。
macOS / Linux 的升級行為未研究；升級說明的偵測在所有平台都會跑，但安裝前提醒只在 Windows 顯示。
Windows：選擇「離開但保留 Terminal Server」時，BAT 主程式的 stdout / stderr 會維持開啟到 Terminal Server 結束（需要原生程式碼才能修，暫不處理）。
Linux 的 fd 保護需要 /bin/bash（或 /usr/bin/bash）；沒有 bash 的系統維持修正前的行為，BAT 會在 debug log 記一行。
Linux 語音輸入需要 glibc 2.38 以上（Ubuntu 24.04 起）：較舊的發行版無法使用語音輸入，麥克風按鈕會停用並說明原因（BUG-203，列為已知限制）。另需系統提供 libgomp1 與 libvulkan1。
Ubuntu 24.04 自動關閉 sandbox 時，安全性比開啟 sandbox 時低；這是讓 AppImage 能在預設設定下開啟的取捨。
Windows 本機上關掉 claude hooks（disableAllHooks）的分頁，BAT 仍判斷不出是否在等你回答。
Claude 面板：權限或提問卡片顯示時輸入框會隱藏，要先回答卡片才能再輸入。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.5...v0.7.4-pre.6

v0.7.4-pre.5（2026-11-04）

版號 0.7.4-pre.5，接續 v0.7.4-pre.4。

本版重點：Claude 面板在回覆進行中送出訊息時改為排隊、不再中斷；Linux / macOS 上關掉 hooks 的 claude 分頁也能顯示「等你回答」；Linux 保留 Terminal Server 離開後的兩個問題一併修好。

新增

Claude 面板：回覆進行中送出的訊息改為排隊，不再中斷目前回覆（PLAN-058，T0814 / T0815）：之前在 Claude 回覆途中送出新訊息，會先中斷這一輪、再把兩則合併重送。現在新訊息排在同一個對話裡，這一輪回覆完才處理；面板顯示「目前回合結束後送出。」並可取消。按 Esc 停止目前回覆時，排隊中的訊息會一起取消。權限或提問卡片出現時，提示會改成「請先回答上方問題，回答後送出。」較舊、不支援排隊確認的 claude CLI 維持原本的中斷＋重送。
Linux / macOS：關掉 hooks 的 claude 分頁也能顯示「等你回答」（PLAN-061，T0811）：claude 會以終端序列（OSC 7501）回報自己的狀態，BAT 現在會回應它的探詢，所以使用者關掉 claude hooks（disableAllHooks）的分頁，在權限對話框或提問時也會顯示 ⚠️，--wait-started 也能確認啟動。有 hooks 的分頁、codex 分頁與 Windows 本機的行為不變（Windows 的系統終端會丟掉這個回應，無法支援）。

修正

Linux：保留 Terminal Server 離開後，以管線等待 BAT 輸出的啟動方式不再一直等（PLAN-062，T0816）：之前選「離開但保留 Terminal Server」後，out=$(./BAT.AppImage)、./BAT.AppImage | tee log 這類啟動方式會等到 Terminal Server 結束。現在 BAT 結束約 1 秒內就會返回。Terminal Server 也不再繼承 BAT 主程式的內部連線。
Linux：保留 Terminal Server 離開後，AppImage 不再被卸載（BUG-209，T0816）：之前直接執行 AppImage、保留 Terminal Server 離開後，AppImage 的掛載會被卸載，留下的 Terminal Server 之後可能因讀不到程式而當掉。現在掛載會保留到 Terminal Server 結束。
Claude 面板：關閉分頁時會結束背後的 claude 程序（T0814）：之前只停止、程序留在記憶體裡。也不再在執行期間把 ELECTRON_RUN_AS_NODE 寫進 BAT 主程式的全域環境變數。

待驗收（請更新到本版後協助確認）

Claude 面板排隊（所有平台）：已以假 API 與真實模型（Haiku 5.5）自動化驗證。請在 Claude 面板回覆途中再送一則訊息，確認會排隊、回覆完才處理、可以取消；按 Esc 後排隊的訊息會一起取消。
claude OSC 7501（Linux / macOS）：已在 WSL（Ubuntu 24.04）以真 claude 驗證啟動確認、以模擬程式驗證「等你回答」；真 claude 的權限對話框與 macOS 尚未實機驗證。請關掉 hooks 的 Linux / macOS 使用者確認 claude 跳出權限對話框時分頁會顯示 ⚠️。
PLAN-062 / BUG-209（Linux）：已在 GitHub Actions 的 Ubuntu 22.04 / 24.04 以打包後的 AppImage 驗證，尚未在真人桌面實機驗證。請 Linux 使用者照常使用「離開但保留 Terminal Server」，重開後選「還原」確認分頁正常。
語音輸入可用性檢查（macOS）：已在 Windows 實機與 GitHub Actions 的 Ubuntu 22.04 / 24.04 驗證，macOS 尚未實機驗證。請 macOS 使用者確認麥克風按鈕照常可按、語音輸入正常。
BUG-202 / BUG-204（Linux）：請在 Ubuntu 24.04 桌面直接執行 AppImage，確認能開啟，並試用語音輸入。這兩項已在 GitHub Actions 的 Ubuntu runner 驗收，尚未在真人桌面實機驗證。
Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報。

歡迎協助測試

本版調整了 BAT 讀取 codex 狀態序列的方式（共用 claude 的新解析，長度上限放寬）。如果你用 Codex CLI 當 Worker，歡迎跑一次 Tower / Worker 流程：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 role 與 agent。
由塔台派一張小工單給 Codex Worker。
確認 Worker 完成後通知回到塔台、分頁被回收；codex 等你核准時分頁會顯示 ⚠️。

結果請到 GitHub issue 回報，附上 BAT 與 codex 版本。

已知事項

Windows：選擇「離開但保留 Terminal Server」時，BAT 主程式的 stdout / stderr 會維持開啟到 Terminal Server 結束（成因與 Linux 不同，需要原生程式碼才能修，暫不處理）。macOS 推論只在擷取 stderr 時會發生，未實測。
Linux 的 fd 保護需要 /bin/bash（或 /usr/bin/bash）；沒有 bash 的系統（例如部分 NixOS 設定）維持修正前的行為，BAT 會在 debug log 記一行。
Linux 語音輸入需要 glibc 2.38 以上（Ubuntu 24.04 起）：Ubuntu 22.04 等較舊的發行版無法使用語音輸入；麥克風按鈕會停用並說明原因，BAT 其他功能不受影響（BUG-203，列為已知限制）。
Linux 語音輸入另需系統提供 libgomp1 與 libvulkan1（一般桌面版預設已安裝；精簡安裝的系統請先 sudo apt install libgomp1 libvulkan1，裝好後到 Settings › 語音輸入按「重新檢查」）。
語音可用性檢查在很慢的機器上可能逾時（上限 15 秒），這時按鈕維持可按，與之前的行為相同。
Ubuntu 24.04 自動關閉 sandbox 時，安全性比開啟 sandbox 時低；這是讓 AppImage 能在預設設定下開啟的取捨。
遠端 profile 視窗（WSL / SSH / Docker）看不到「📨 待送 N」徽章，但通知照樣會被保留。
Windows 本機上關掉 claude hooks（disableAllHooks）的分頁，BAT 仍判斷不出是否在等你回答，通知會照舊直接送出（Linux / macOS 主機已由本版的 OSC 7501 補上）。
Claude 面板：權限或提問卡片顯示時輸入框會隱藏，所以要先回答卡片才能再輸入。
很短的一輪工作偶爾會多顯示 ↻ 最多 60 秒才變回 ✓；這段時間 Worker 不會被算進批次關閉。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。
Linux：dock 圖示上的數字徽章不再顯示。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.4...v0.7.4-pre.5

v0.7.4-pre.4（2026-11-03）

版號 0.7.4-pre.4，接續 v0.7.4-pre.3。

本版是 Linux 的安全性修正：分頁裡執行的程式不再拿得到其他分頁的終端控制端與 BAT 內部的連線。建議 Linux 使用者更新。Windows 與 macOS 的行為不變。

修正

Linux：分頁裡的程式不再拿得到其他分頁的終端控制端（BUG-205，T0806）：之前每個分頁的 shell 會繼承比它早開的分頁的 pty master，以及 BAT 主程式的多個內部連線與檔案。分頁裡的程式因此可以不經 BAT 的權限檢查，直接對前面的分頁（包括塔台分頁）送出輸入或讀走輸出。現在每個分頁的 shell 只保留標準輸入 / 輸出 / 錯誤；分頁的 pid、參數、環境變數與工作目錄都不變。也一併修好：分頁留在背景的程式還活著時，關閉 BAT 後會留下一個 chrome_crashpad_handler 程序。
Linux：BAT 起的其他子程序也不再繼承這些連線（BUG-206 / BUG-207，T0807）：headless bat-server（遠端 WSL / SSH / Docker）與 Terminal Server 起不來時的 direct 模式下，Claude 面板的 claude CLI、codex、git（含 git hook）等子程序之前會拿到所有分頁的終端控制端；桌面版主程式起的子程序則會繼承約 49 個內部連線與檔案。現在這些子程序只保留標準輸入 / 輸出 / 錯誤（需要的通訊通道照常保留）；命令找不到時的錯誤與以前相同。遠端主機的 bat-server 要重新啟動後才會套用。
開發者：測試不再寫進使用者真實的 bat-scripts.log（BUG-208，T0808）。

待驗收（請更新到本版後協助確認）

BUG-205 / 206 / 207（Linux）：本版已在 WSL（Ubuntu 24.04）以打包後的 Linux 版實測，尚未在真人桌面與遠端 headless 實機驗證。請 Linux 使用者照常開多個分頁、使用 Claude 面板與 git，有分頁無法啟動、指令找不到或行為改變請回報。
語音輸入可用性檢查（macOS）：已在 Windows 實機與 GitHub Actions 的 Ubuntu 22.04 / 24.04 驗證，macOS 尚未實機驗證。請 macOS 使用者確認麥克風按鈕照常可按、語音輸入正常。
BUG-202 / BUG-204（Linux）：請在 Ubuntu 24.04 桌面直接執行 AppImage，確認能開啟，並試用語音輸入。這兩項已在 GitHub Actions 的 Ubuntu runner 驗收，尚未在真人桌面實機驗證。
Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報。

已知事項

Linux 的這項修正需要 /bin/bash（或 /usr/bin/bash）；沒有 bash 的系統（例如部分 NixOS 設定）維持修正前的行為，BAT 會在 debug log 記一行。
Linux：選擇「離開但保留 Terminal Server」時，BAT 主程式的 stdout / stderr 會維持開啟到 Terminal Server 結束；以管線等待 BAT 輸出結束的外部啟動方式（例如 out=$(./BAT.AppImage)）會一直等（PLAN-062）。
Linux 語音輸入需要 glibc 2.38 以上（Ubuntu 24.04 起）：Ubuntu 22.04 等較舊的發行版無法使用語音輸入；麥克風按鈕會停用並說明原因，BAT 其他功能不受影響（BUG-203，列為已知限制）。
Linux 語音輸入另需系統提供 libgomp1 與 libvulkan1（一般桌面版預設已安裝；精簡安裝的系統請先 sudo apt install libgomp1 libvulkan1，裝好後到 Settings › 語音輸入按「重新檢查」）。
語音可用性檢查在很慢的機器上可能逾時（上限 15 秒），這時按鈕維持可按，與之前的行為相同。
Ubuntu 24.04 自動關閉 sandbox 時，安全性比開啟 sandbox 時低；這是讓 AppImage 能在預設設定下開啟的取捨。
遠端 profile 視窗（WSL / SSH / Docker）看不到「📨 待送 N」徽章，但通知照樣會被保留。
使用者關掉 claude hooks 的分頁（disableAllHooks）BAT 判斷不出是否在等你回答，通知會照舊直接送出。
很短的一輪工作偶爾會多顯示 ↻ 最多 60 秒才變回 ✓；這段時間 Worker 不會被算進批次關閉。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。
Linux：dock 圖示上的數字徽章不再顯示。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.3...v0.7.4-pre.4

v0.7.4-pre.3（2026-11-03）

版號 0.7.4-pre.3，接續 v0.7.4-pre.2。

本版讓語音輸入在用不了時提前告訴你：BAT 啟動後會在背景檢查語音辨識模組能不能載入，用不了就停用麥克風按鈕並說明原因，不用再錄完音才看到「辨識失敗」。

新增

語音輸入用不了時，麥克風按鈕會先停用並說明原因（T0802）：BAT 啟動幾秒後，在背景以另一個短暫的程序試載語音辨識模組（不佔 BAT 主程式的記憶體、不拖慢啟動）。確定用不了時：
- 麥克風按鈕變灰，滑過去顯示原因與建議動作。例如 Linux 缺系統函式庫時顯示 sudo apt install libgomp1 libvulkan1（只列實際缺的；以 Debian / Ubuntu 為例），glibc 太舊時說明需要 glibc 2.38 以上（例如 Ubuntu 24.04）。
- Alt+M 等開始錄音的方式不會開始錄音，改顯示同樣的原因。
- Settings › 語音輸入最上方顯示「可用性」，可按「重新檢查」（例如裝好函式庫之後）。
- 檢查還沒跑完、或檢查本身失敗 / 逾時時，維持原本的行為（按鈕照常可按）。語音可用時畫面與之前完全相同。三個平台都會檢查。

更新

開發者：Windows 安裝檔重裝驗收腳本（e2e/manual/nsis-reinstall-acceptance.ps1）的 -Version 改為必填，沒帶或格式不對時直接結束、不下載也不安裝，避免驗到舊版（T0801）。

待驗收（請更新到本版後協助確認）

語音輸入可用性檢查（macOS）：本版已在 Windows 實機與 GitHub Actions 的 Ubuntu 22.04 / 24.04 驗證，macOS 尚未實機驗證。請 macOS 使用者確認麥克風按鈕照常可按、語音輸入正常。
BUG-202 / BUG-204（Linux）：請在 Ubuntu 24.04 桌面直接執行 AppImage，確認能開啟，並試用語音輸入。這兩項已在 GitHub Actions 的 Ubuntu runner 驗收，尚未在真人桌面實機驗證。
Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報。
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境。

已知事項

Linux 語音輸入需要 glibc 2.38 以上（Ubuntu 24.04 起）：Ubuntu 22.04 等較舊的發行版無法使用語音輸入；本版起麥克風按鈕會停用並說明原因，BAT 其他功能不受影響（BUG-203，列為已知限制）。
Linux 語音輸入另需系統提供 libgomp1 與 libvulkan1（一般桌面版預設已安裝；精簡安裝的系統請先 sudo apt install libgomp1 libvulkan1，裝好後到 Settings › 語音輸入按「重新檢查」）。
語音可用性檢查在很慢的機器上可能逾時（上限 15 秒），這時按鈕維持可按，與之前的行為相同。
Ubuntu 24.04 自動關閉 sandbox 時，安全性比開啟 sandbox 時低；這是讓 AppImage 能在預設設定下開啟的取捨。
遠端 profile 視窗（WSL / SSH / Docker）看不到「📨 待送 N」徽章，但通知照樣會被保留。
使用者關掉 claude hooks 的分頁（disableAllHooks）BAT 判斷不出是否在等你回答，通知會照舊直接送出。
很短的一輪工作偶爾會多顯示 ↻ 最多 60 秒才變回 ✓；這段時間 Worker 不會被算進批次關閉。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。
Linux：dock 圖示上的數字徽章不再顯示。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.2...v0.7.4-pre.3

v0.7.4-pre.2（2026-11-03）

版號 0.7.4-pre.2，接續 v0.7.4-pre.1。

本版主要修正 Linux AppImage：Ubuntu 24.04 直接執行會崩潰的問題，以及 Linux 版語音輸入無法使用的問題。Windows 與 macOS 的行為沒有改變。

修正

Ubuntu 24.04 直接執行 AppImage 不再崩潰（BUG-202，T0799）：Ubuntu 24.04 預設以 AppArmor 限制 user namespace，AppImage 內的 chrome-sandbox 又無法是 root setuid，直接執行時會立即結束。現在啟動器偵測到這種情況時，會自動以 --no-sandbox 啟動，並在終端機印出一行 [sandbox] … starting with --no-sandbox (BUG-202)、除錯日誌也記一行。其他情況（例如 Ubuntu 22.04、已安裝允許 user namespace 的 AppArmor profile、chrome-sandbox 已是 root setuid）照常開啟 sandbox。想在 24.04 保留 sandbox 的使用者，可自行評估安裝 AppArmor profile，說明見 docs/agent-guide/linux-appimage-sandbox.md。
Linux 版語音輸入可以載入了（BUG-204，T0800）：語音辨識模組的相依函式庫原本不會從模組自己的目錄載入，Linux 版語音輸入在任何發行版都無法使用。打包時已修正函式庫的搜尋路徑。

更新

新增 Linux AppImage 啟動驗收（T0797 / T0798）：可在 GitHub Actions 的 Ubuntu 22.04 與 24.04 上，對任一版本的 AppImage 實際啟動、開終端、輸入文字並檢查 sandbox 與語音辨識模組載入。

待驗收（請更新到本版後協助確認）

BUG-202 / BUG-204（Linux）：請在 Ubuntu 24.04 桌面直接執行 AppImage，確認能開啟，並試用語音輸入。這兩項已在 GitHub Actions 的 Ubuntu runner 驗收，尚未在真人桌面實機驗證。
Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報。
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境。

已知事項

Linux 語音輸入需要 glibc 2.38 以上（Ubuntu 24.04 起）：Ubuntu 22.04 等較舊的發行版無法使用語音輸入，錄音結束後會顯示「辨識失敗」，BAT 其他功能不受影響（BUG-203，列為已知限制）。
Linux 語音輸入另需系統提供 libgomp1 與 libvulkan1（一般桌面版預設已安裝；精簡安裝的系統請先 sudo apt install libgomp1 libvulkan1）。
Ubuntu 24.04 自動關閉 sandbox 時，安全性比開啟 sandbox 時低；這是讓 AppImage 能在預設設定下開啟的取捨。
遠端 profile 視窗（WSL / SSH / Docker）看不到「📨 待送 N」徽章，但通知照樣會被保留。
使用者關掉 claude hooks 的分頁（disableAllHooks）BAT 判斷不出是否在等你回答，通知會照舊直接送出。
很短的一輪工作偶爾會多顯示 ↻ 最多 60 秒才變回 ✓；這段時間 Worker 不會被算進批次關閉。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。
Linux：dock 圖示上的數字徽章不再顯示。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.4-pre.1...v0.7.4-pre.2

v0.7.4-pre.1（2026-11-03）

版號 0.7.4-pre.1，接續 v0.7.3-pre.9（0.7.3-pre.N 到 pre.9 為止，預覽版改走 0.7.4-pre.N）。

本版沒有改變 BAT 的使用行為，主要是讓測試在機器忙碌時也穩定通過，避免發版被偶發的測試失敗擋下。

更新

測試在高負載下更穩定（BUG-199，T0793；BUG-200，T0794）：幾支會實際開 shell、git 或 hook 程序的單元測試，在整套測試同時跑、機器很忙時偶爾超過 5 秒上限而失敗。先量測確認慢的是程序本身，再替它們設明確的時間上限。兩支檢查「hook 回報先後順序」的測試改成由測試自己控制先後，不再依賴時間差。
兩套測試同時跑不再互相干擾（BUG-201，T0795）：開發用部署腳本的測試原本都寫進同一個固定目錄，兩套測試同時跑會互相覆蓋。現在每次測試用自己的暫存目錄；npm run deploy:headless:dev 的行為不變。
移除 repo 裡一個沒有用到的外掛殘留設定檔（.kiro/steering/lean-ctx.md）。

已驗收

BUG-196 / BUG-197 / BUG-198（v0.7.3-pre.8 / pre.9 修正）已在安裝版 v0.7.3-pre.9 上驗收通過：塔台停在對話框時，Worker 的完成通知會先保留、你回答後才送進輸入框；Worker 分頁的 ↻ / ✓ 不再因回報晚到而錯亂。

待驗收（請更新到本版後協助確認）

Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報；Linux 特別請在 Ubuntu 22.04 上試啟動 AppImage。
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境。

已知事項

遠端 profile 視窗（WSL / SSH / Docker）看不到「📨 待送 N」徽章，但通知照樣會被保留。
使用者關掉 claude hooks 的分頁（disableAllHooks）BAT 判斷不出是否在等你回答，通知會照舊直接送出。
很短的一輪工作偶爾會多顯示 ↻ 最多 60 秒才變回 ✓；這段時間 Worker 不會被算進批次關閉。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。
Linux：dock 圖示上的數字徽章不再顯示。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.9...v0.7.4-pre.1

v0.7.3-pre.9（2026-11-02）

版號 0.7.3-pre.9，接續 v0.7.3-pre.8。

修正

Worker 分頁的 ↻ 不會再提早變回 ✓（BUG-198，T0791）：Worker 回報後又開始新的一輪工作時，分頁會顯示 ↻，做完才回到 ✓。舊版在上一輪的結束訊號晚到時，會把新的一輪當成已經結束，↻ 提早變回 ✓，批次關閉也可能把還在工作的 Worker 算進去。現在改依事件實際發生的先後判斷。

待驗收（請更新到本版後協助確認）

BUG-196 / BUG-197（v0.7.3-pre.8 起）：塔台停在權限對話框或選項卡時收到 Worker 完成通知，對話框應維持原樣、縮圖出現「📨 待送 1」；你回答之後，通知應出現在塔台輸入框。
BUG-198（本版）：Worker 回報後又開始工作時，分頁應顯示 ↻，直到那一輪做完才變回 ✓。
Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報；Linux 特別請在 Ubuntu 22.04 上試啟動 AppImage。
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境。

已知事項

遠端 profile 視窗（WSL / SSH / Docker）看不到「📨 待送 N」徽章，但通知照樣會被保留。
使用者關掉 claude hooks 的分頁（disableAllHooks）BAT 判斷不出是否在等你回答，通知會照舊直接送出。
很短的一輪工作偶爾會多顯示 ↻ 最多 60 秒才變回 ✓；這段時間 Worker 不會被算進批次關閉。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。
Linux：dock 圖示上的數字徽章不再顯示。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.8...v0.7.3-pre.9

v0.7.3-pre.8（2026-11-02）

版號 0.7.3-pre.8，接續 v0.7.3-pre.7。

修正

Worker 的完成通知不再替你回答塔台的對話框（BUG-196，T0788）：舊版在塔台停在權限對話框或「Claude 要你選一個選項」（AskUserQuestion）時，Worker 送來的完成通知或提問會同時按下 Enter，替你選了預設選項，像「1. Yes」就會讓指令直接執行。現在 BAT 會先把通知留著，等你自己回答、畫面安靜 1 秒後才送進塔台的輸入框。Codex 塔台停在審批提示時也一樣。
- 塔台分頁的縮圖會顯示「📨 待送 N」，點開可以看到是哪張工單送的，也可以逐筆或全部取消。取消只是不送進輸入框，通知提示和 Worker 的 ✓ 照常顯示。
- 每個塔台最多保留 8 則，保留期間不會逾時。塔台分頁關閉或重啟時，保留的通知會一起丟掉。
- Worker 端的指令、exit code 與輸出都沒有改變，Control Tower 不需要升級。
塔台的 ⚠️ 不會在對話框還開著時被錯清掉（BUG-197，T0790）：claude 的 hook 回報偶爾會晚到，舊版因此把「等你回答」的狀態清掉，⚠️ 消失，上面的通知保留也跟著失效。現在改依事件實際發生的先後判斷。
Worker 的完成通知不再被記成你在塔台的輸入，不會清掉塔台的 ⚠️，也不會取消用量限制的自動繼續等待（BUG-196）。

待驗收（請更新到本版後協助確認）

BUG-196 / BUG-197（本版）：塔台停在權限對話框或選項卡時收到 Worker 完成通知，對話框應維持原樣、縮圖出現「📨 待送 1」；你回答之後，通知應出現在塔台輸入框。
Electron 45（v0.7.3-pre.7 起）：請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報；Linux 特別請在 Ubuntu 22.04 上試啟動 AppImage。
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境。

歡迎協助測試

本版改了 Worker 通知送進塔台的方式，也涵蓋 Codex 塔台。歡迎 Codex 使用者用 Codex CLI 跑一次塔台 / Worker 流程：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 role 與 agent。
由塔台派一張小工單給 Codex Worker。
確認 Worker 完成後，通知回到塔台、Worker 分頁被回收。如果塔台當時停在審批提示，通知應在你核准或拒絕之後才出現。

結果請到 GitHub issue 回報，並附上 BAT 與 codex 的版本。

已知事項

遠端 profile 視窗（WSL / SSH / Docker）看不到「📨 待送 N」徽章，但通知照樣會被保留。
使用者關掉 claude hooks 的分頁（disableAllHooks）BAT 判斷不出是否在等你回答，通知會照舊直接送出。
Worker 回報後又開始新回合時，↻ 偶爾會提早變回 ✓（BUG-198，下一版處理）。
macOS 不會顯示 BAT 的系統通知：沒有 Apple 開發者簽章的 app 不能發系統通知（PLAN-060）。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。
Linux：dock 圖示上的數字徽章不再顯示。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.7...v0.7.3-pre.8

v0.7.3-pre.7（2026-11-02）

版號 0.7.3-pre.7，接續 v0.7.3-pre.6。

更新

Electron 升到 45.2.1（PLAN-053，T0784）：原本的 Electron 41 已停止更新。新版是 Chromium 156、Node 24.22.1，官方暫定支援到 2027 年 4 月。終端、Claude / Codex 面板、貼上檔案與圖片、遠端連線的使用方式都沒有改變
macOS 最低版本改為 13（Ventura）：Electron 44 起不再支援 macOS 12
遠端連線權杖的加密改用新的非同步介面（T0785）：已存的權杖照常可用，升級後已連線過的遠端 client 不需要重新配對
v0.7.3-pre.6 的 Electron 41.10.7 已在 GitHub Actions 的 macOS 環境對交付版實測通過（Finder 貼上檔案、貼上圖片）
內部：修正幾支在高負載下偶爾逾時的單元測試（BUG-195，T0786）；新增只打包、不發布的三平台建置流程，供升級試做驗證（T0783）

待驗收（請更新到本版後協助確認）

Electron 45（本版）：Windows 已跑完整測試、打包檢查與 e2e；macOS 交付版的貼上檔案與圖片已在 GitHub Actions 實測通過。請 macOS / Linux 使用者照常使用，有啟動、繪圖、終端顯示或貼上的異常請回報；Linux 特別請在 Ubuntu 22.04 上試啟動 AppImage
遠端連線（本版）：從舊版升級後，已設定的 WSL / SSH / Docker 遠端應能直接連上
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

已知事項

macOS 不會顯示 BAT 的系統通知：Electron 42 起，沒有 Apple 開發者簽章的 app 不能發系統通知，而 BAT 的 macOS 版目前沒有正式簽章。BAT 視窗內的提示、⚠️ 與分頁標示不受影響。正式簽章另案評估（PLAN-060）
Linux：dock 圖示上的數字徽章不再顯示（Electron 44 移除 Unity 支援）
遠端伺服器使用登入 shell PATH 在 macOS（launchd）上尚未實機驗證
中斷清單不涵蓋：BAT 重開時在 Recovery 提示選「重新開始」的情況；版本低於 0.163 的 codex 派工 Worker
Codex 面板（Codex Agent 面板）等待時尚未顯示 ⚠️

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.6...v0.7.3-pre.7

v0.7.3-pre.6（2026-11-02）

版號 0.7.3-pre.6，接續 v0.7.3-pre.5。

更新

Electron 升到 41.10.7（T0779，PLAN-053）：原本是 41.2.1，現在是 Electron 41 這條線的最後一版（Chromium 146.0.7680.216、Node 24.18.0）。大版本不變，原生模組與設定都沒有改，使用上不會有差別；修補版通常帶有 Chromium 的安全修正
v0.7.3-pre.5 的待驗收項目已確認通過：BUG-193（點別的分頁回到 BAT 時保留灰色 ⚠️）、BUG-194（自動跳出的對話框第一次 Esc 就關閉）以安裝版的自動化測試在 Windows 上確認；BUG-128 / BUG-130（macOS 貼上檔案與文字）以 GitHub Actions 的 macOS 環境對交付版實測通過
內部清理：移除沒有用到的 git 圖譜效能測試原型（T0780）；重新整理相依套件鎖定檔的中繼資料，套件版本都沒有變（T0782）

待驗收（請更新到本版後協助確認）

Electron 41.10.7（本版）：在 Windows 上已跑過完整測試與打包檢查；macOS / Linux 版請照常使用，有任何啟動、繪圖或終端顯示的異常請回報
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

已知事項

Electron 41 這條線已停止更新，升級到仍在維護的大版本正在評估中（PLAN-053）
遠端伺服器使用登入 shell PATH 在 macOS（launchd）上尚未實機驗證
中斷清單不涵蓋：BAT 重開時在 Recovery 提示選「重新開始」的情況；版本低於 0.163 的 codex 派工 Worker
Codex 面板（Codex Agent 面板）等待時尚未顯示 ⚠️

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.5...v0.7.3-pre.6

v0.7.3-pre.5（2026-11-02）

版號 0.7.3-pre.5，接續 v0.7.3-pre.4。

修正

點另一個分頁讓 BAT 回到前景時，淡化 ⚠️ 被提早清掉（BUG-193，T0774）：BAT 視窗不在前景時，目前的分頁等待結束會留下淡化 ⚠️，表示你還沒看過。以前直接點另一個分頁讓 BAT 回到前景，那個淡化 ⚠️ 會被當成「看過」而消失，其實你沒看到那個分頁。現在只有回到前景後仍停在那個分頁才算看過；用 Alt+Tab 切回來、不點別的分頁時照舊清除
自動跳出的對話框第一次按 Esc 關不掉（BUG-194，T0776）：Terminal Server 意外重啟後的「被中斷的分頁」對話框、從分離視窗開啟的設定等自己跳出的對話框，鍵盤焦點還留在終端裡，第一次按 Esc 會送進背景的終端、對話框也沒關。現在對話框跳出時會拿到焦點，第一次 Esc 就關閉、不會送進終端；關閉後焦點回到原本的地方（例如終端），可以直接繼續打字

更新

v0.7.3-pre.4 的待驗收項目（PLAN-055 接回被中斷的 agent 分頁、BUG-188–192、已分離工作區與 Claude 面板的 ⚠️）已用安裝版的自動化測試確認，在 Windows 上通過，含真實模型與真的 claude / codex
所有對話框關閉後，焦點都會回到開啟前的位置（以前會落在空白處，要再點一下終端才能打字）

待驗收（請更新到本版後協助確認）

BUG-193（本版）：BAT 不在前景時讓分頁的等待結束（留下淡化 ⚠️），再直接點另一個分頁回到 BAT，原分頁的淡化 ⚠️ 應該還在；切回那個分頁才消失
BUG-194（本版）：自動跳出的對話框（例如 Terminal Server 意外結束後的「被中斷的分頁」）出現時直接按 Esc，對話框應立即關閉，背景終端不會收到 Esc
BUG-128 / BUG-130（macOS 貼上）：需要 macOS 實機
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

已知事項

本版的修正與 pre.4 的自動化驗收只在 Windows 上實測；macOS / Linux 的事件順序與行為未實機驗證
遠端伺服器使用登入 shell PATH 在 macOS（launchd）上尚未實機驗證
中斷清單不涵蓋：BAT 重開時在 Recovery 提示選「重新開始」的情況；版本低於 0.163 的 codex 派工 Worker
Codex 面板（Codex Agent 面板）等待時尚未顯示 ⚠️

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.4...v0.7.3-pre.5

v0.7.3-pre.4（2026-11-01）

版號 0.7.3-pre.4，接續 v0.7.3-pre.3。

新增

Terminal Server 意外重啟後，可以接回被中斷的 agent 分頁（PLAN-055，T0765 / T0766 / T0767）：以前 BAT 只會在同一個分頁重開一個 shell，畫面上只跳一個提示，原本跑的 claude / codex 對話就斷了
- 現在會跳出對話框，列出被中斷的 agent 分頁，分頁縮圖也標上 ⏸；提示訊息會寫「N 個 agent 分頁已中斷」
- claude 分頁（含塔台派工的 Worker）按「恢復」就以 --resume 接回原對話，BAT MCP、hooks、session 名稱照原樣帶上
- codex 分頁按「開啟 resume 選單」會開 codex 自己的 resume 選單，列出這個資料夾的 session 讓你挑
- 不會自動恢復；按 Esc 或「關閉」只關對話框。被中斷的清單只保留到 BAT 關閉為止
已分離（detached）的工作區也會提示等待使用者 ⚠️（D212，T0761）：工作區分離成獨立視窗後，裡面有分頁在等你時，主視窗列表會多出一列「↗ 名稱（已分離）」並帶 ⚠️，頁籤標題與收合窄列的總數也算進去；點那一列會把該視窗帶到前面並切到等最久的分頁
Claude Agent 面板等待權限或等你回答時也顯示 ⚠️（T0762）：和終端分頁一樣，縮圖與工作區列出現 ⚠️，回答、拒絕或停止後消失；你不在看時結束會留下淡化 ⚠️，看過才清除

修正

用滑鼠回答後 ⚠️ 不消失（BUG-188，T0757）：在 claude（fullscreen 畫面）用滑鼠點「No」拒絕權限時，回合直接中斷、⚠️ 一直留著。現在等待中的分頁按下滑鼠左鍵，就和按鍵盤一樣清除 ⚠️；滾輪、移動、右鍵不算。滑鼠點擊不會取消 Worker 分頁的自動回收
用 npm 安裝的 codex 讀不到版本（BUG-189，T0758）：Windows 上 PATH 第一個 codex 是 npm 產生的 codex.cmd 時，BAT 判斷不出版本，手動開的 Codex CLI 分頁沒有加 --no-daemon、派工的 codex Worker 也沒有狀態回報。現在 BAT 讀 npm 的啟動檔找到真正的 codex.exe 再判斷版本（不經 shell 執行）
Claude 面板的背景 Agent 不在執行中清單（BUG-190，T0759）：背景執行的 Agent 啟動後馬上從 active task bar 消失，結束也沒有標示。現在執行中會留在清單、可以停止，結束後移除並標上完成 / 失敗 / 已停止。另外修正從清單按「停止」時子代理其實沒有停下的問題
背景子代理執行中送出新訊息會把它結束（BUG-192，T0768 / T0769）：Claude 面板在背景子代理還在跑時送出新訊息，會中止整個對話、子代理一起被結束。現在主回合已回答完時，新訊息直接送進同一個對話、馬上回應，子代理繼續跑；少數送不進去的情況會在訊息下顯示「等背景子代理結束後送出」並可取消。Esc 只停目前的回合，不會停掉背景子代理
設了 CLAUDE_CODE_PLUGIN_CACHE_DIR 時找不到 Claude plugins（BUG-191，T0760）：BAT 現在和 claude CLI 一樣，到該目錄讀 plugins 清單，CT plugin 偵測與面板 plugins 都跟著改；沒設這個變數時行為不變

待驗收（請更新到本版後協助確認）

PLAN-055（本版）：Terminal Server 意外結束後（例如在工作管理員結束 BAT 的 Terminal Server 程序），出現中斷清單，claude 分頁按「恢復」接回原對話、codex 分頁開出 resume 選單
BUG-188（本版）：在 claude 的權限詢問用滑鼠點「No」，⚠️ 立刻消失
BUG-189（本版）：以 npm i -g @openai/codex 安裝 codex 的 Windows 環境，關閉 BAT MCP 後開 Codex CLI 分頁，命令列有 --no-daemon
BUG-190 / BUG-192（本版）：Claude 面板讓模型開一個背景 Agent，執行中出現在 active task bar；這時送出新訊息會馬上得到回應，背景 Agent 繼續跑，結束後標示完成
BUG-191（本版）：設 CLAUDE_CODE_PLUGIN_CACHE_DIR 並以 plugin 安裝 Control Tower，BAT 的 skill 清單認得 CT
detached 視窗 / Claude 面板 ⚠️（本版）：工作區分離後裡面的分頁等待時主視窗出現提示列；Claude 面板等待權限時縮圖出現 ⚠️
工作區提示（v0.7.2-pre.8 起）：BAT 視窗不在前景時等待結束，應留下淡化 ⚠️
BUG-128 / BUG-130（macOS 貼上）：需要 macOS 實機
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

歡迎協助測試

本版有 codex 相關變更（npm 安裝的 codex 版本判斷、被中斷的 codex 分頁恢復）。如果你用 Codex CLI，歡迎幫忙跑一次塔台 / Worker 流程：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 role 與 agent 顯示正確
由塔台派一張小工單給 Codex Worker（--agent codex）
確認 Worker 完成後通知回到塔台、分頁被自動回收
如果是用 npm i -g @openai/codex 安裝的 codex，也請一併確認上面「待驗收」的 BUG-189

結果請到 GitHub issue 回報，並附上 BAT 版本（本版 0.7.3-pre.4）與 codex --version。

已知事項

遠端伺服器使用登入 shell PATH 在 macOS（launchd）上尚未實機驗證
中斷清單不涵蓋：BAT 重開時在 Recovery 提示選「重新開始」的情況；版本低於 0.163 的 codex 派工 Worker
Codex 面板（Codex Agent 面板）等待時尚未顯示 ⚠️
工作區分離後，主視窗已關閉時沒有地方顯示提示列；提示只出現在原本的主視窗
用滑鼠點在 claude 不接受點擊的對話框上（例如 AskUserQuestion 的取消）也會清除 ⚠️，對話框仍開著，與按方向鍵等不回答的按鍵行為一致
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.3...v0.7.3-pre.4

v0.7.3-pre.3（2026-11-01）

版號 0.7.3-pre.3，接續 v0.7.3-pre.2。

新增

遠端 bat-server 使用登入 shell 的 PATH（PLAN-057，T0754 / T0755）：遠端伺服器（WSL、SSH、Docker）啟動時，會讀一次你的登入 shell 設定（~/.profile、~/.bashrc、~/.zshrc 等）取得 PATH。Claude Agent 面板在遠端執行的工具與 MCP（例如 npx、uvx），以及 Git 面板，現在找得到 ~/.local/bin、nvm、Homebrew 裡的程式，和終端分頁一致
- 預設開啟；不需要時到遠端視窗的「設定 › 進階 › BAT 伺服器 PATH」關閉，重新啟動 BAT 伺服器後生效
- 讀取設定逾時（3 秒）或失敗時保留原本的 PATH，伺服器照常啟動
- 遠端 bat-server 要用設定精靈升級到本版才會生效

修正

在 Linux 遠端安裝 / 更新 Node.js 後跑不起來（BUG-187，T0756）：Node.js 25 起的官方 Linux 版需要系統程式庫 libatomic.so.1，最小安裝的 Ubuntu / Debian / Fedora 等沒有，BAT 用 nvm 裝完的 Node.js 會無法執行
- 現在安裝 / 更新前會先檢查，缺少時一併安裝（apt libatomic1、dnf / yum libatomic），確認畫面的「先執行」會列出這一步；已經有的主機不會多跑套件管理器
- 帳號不能安裝系統套件時，照常安裝 Node.js，並在結果提示要請管理員執行的指令
- 安裝 / 更新最後會確認 node --version 能執行；失敗時顯示原因與修正方式，不再當成成功
- macOS 不受影響

待驗收（請更新到本版後協助確認）

PLAN-057 / BUG-187（本版）：遠端 bat-server 以設定精靈升級到本版後，遠端工具清單按「重新檢查」，裝在 ~/.local/bin、nvm 的工具應顯示「伺服器：可見」；在缺 libatomic1 的 Linux 主機以 BAT 安裝 Node.js 後應能執行
BUG-183 / BUG-184 / BUG-186（v0.7.3-pre.2）：關掉的設定檔視窗按「開啟」直接出現、刪除設定檔後系統匣不再列出它的視窗、遠端工具清單的「無法執行」原因與伺服器標記
工作區提示（v0.7.2-pre.8 起）：BAT 視窗不在前景時等待結束，應留下淡化 ⚠️；用滑鼠回答權限或問題後提示是否消失
BUG-128 / BUG-130（macOS 貼上）：需要 macOS 實機
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

已知事項

遠端伺服器使用登入 shell PATH 在 macOS（launchd）上尚未實機驗證
遠端伺服器開的終端分頁 PATH 裡 ~/.local/bin 可能多出一份（不影響使用）
遠端 bat-server 重啟後，分頁不會自動重建 shell，需要 ⏻ 重啟分頁
遠端工作區的 ⚠️ 只顯示在該遠端連線自己的視窗裡
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.2...v0.7.3-pre.3

v0.7.3-pre.2（2026-11-01）

版號 0.7.3-pre.2，接續 v0.7.3-pre.1。

修正

關掉的設定檔視窗按「開啟」叫不回來（BUG-183，T0750）：開啟「最小化到系統匣」時，關掉設定檔的視窗只是把它藏起來；之後在「配置」對該設定檔按「開啟」，只會跳出「此配置已在另一個視窗中開啟」，視窗不出現，只能從系統匣圖示叫回。現在按「開啟」會直接顯示並切到原本的視窗，不再跳提示（本機與遠端設定檔都適用）。真的叫不回來時，提示改為指引你從系統匣開啟
刪除設定檔後，它的視窗還留在系統匣選單（BUG-184，T0750）：在「配置」刪除設定檔時，那個設定檔已開啟的視窗沒有一起關掉，系統匣選單會多出一個同名項目。現在刪除設定檔會一併關閉它的視窗；如果那是最後的視窗，會先開啟預設設定檔，BAT 不會直接結束
遠端工具清單把已安裝的工具標成「無回應」或「伺服器：不可見」（BUG-186，T0753）：
- 工具在 PATH 上找得到、卻無法執行時（例如 Linux 上 Node.js 缺少共用程式庫 libatomic.so.1），說明改為「在 PATH 上找到，但無法執行：缺少共用程式庫 …」，讓你知道要補裝什麼；找不到原因時附上結束代碼
- 只有終端分頁找得到、遠端伺服器程序本身找不到的工具（例如裝在 ~/.local/bin 的 uv、nvm 的 Node.js），改標「伺服器程序：不可見（終端分頁找得到）」，滑過的說明寫清楚會影響哪些功能（Git / GitHub 面板、Claude Agent 面板的工具與 MCP）
- Git / GitHub CLI 的「伺服器：可見」判斷改為與 BAT 實際找 git / gh 的位置一致
- WSL、Docker、SSH 遠端都適用；遠端 bat-server 要用設定精靈升級到本版才有這些修正

更新

系統匣選單同名視窗可分辨（T0752）：兩個視窗標題相同時（例如兩個同名的設定檔），第二個起依序加上 (2)、 (3)

驗收與測試

BUG-182（v0.7.3-pre.1）：以 WSL 遠端工作區實機確認，遠端伺服器重啟後 ⚠️ 依你有沒有在看該分頁變成淡化或直接消失，已結案
BUG-175（v0.7.2-pre.3 起）：外部測試者在 macOS 實機確認 Worker 縮圖會更新到最新輸出，已結案（GitHub #22 已關閉）
設定精靈的介面測試補上升級 / 還原步驟用到的模擬（BUG-185，T0751，只影響測試）

待驗收（請更新到本版後協助確認）

BUG-183 / BUG-184（本版）：開啟「最小化到系統匣」時關掉設定檔視窗，再到「配置」按「開啟」，原視窗應直接出現、不跳提示；刪除設定檔後，系統匣選單不再列出它的視窗
BUG-186（本版）：遠端 bat-server 以設定精靈升級到本版後，在遠端工具清單按「重新檢查」，無法執行的工具顯示原因、只有終端分頁找得到的工具顯示「伺服器程序：不可見（終端分頁找得到）」
工作區提示（v0.7.2-pre.8 起）：BAT 視窗不在前景時等待結束，應留下淡化 ⚠️；用滑鼠回答權限或問題後提示是否消失
BUG-128 / BUG-130（macOS 貼上）：需要 macOS 實機
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

已知事項

遠端 bat-server 程序本身的 PATH 仍是服務的預設值（不含 ~/.local/bin、nvm）：Claude Agent 面板在遠端執行的工具與 MCP 找不到這些位置的程式；終端分頁不受影響
遠端 bat-server 重啟後，分頁不會自動重建 shell，需要 ⏻ 重啟分頁
遠端工作區的 ⚠️ 只顯示在該遠端連線自己的視窗裡
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.3-pre.1...v0.7.3-pre.2

v0.7.3-pre.1（2026-11-01）

版號 0.7.3-pre.1，接續 v0.7.2-pre.9（新的預覽版號線）。

修正

遠端伺服器重啟後，工作區的「等待你回應」提示一直留著（BUG-182，T0749）：遠端工作區（WSL / SSH / Docker）的分頁正在等你回應時，如果遠端 bat-server 重啟，視窗重新連上後 ⚠️ 會一直留著，看過、或分頁送出閒置都清不掉，工作區的總數也一直多算一個，只有 ⏻ 重啟分頁才會消失。現在重新連上時，BAT 會向遠端伺服器核對每個分頁的現況：
- 分頁在伺服器上已經不存在：當成等待已結束，你沒在看的話留下淡化 ⚠️，看過就清除，不再計入總數
- 分頁還在：改用伺服器上的狀態，斷線期間錯過的變化也一併補上

驗收與測試

Windows 安裝：以 v0.7.2-pre.9 安裝檔在實機完成同版本覆蓋安裝、靜默解除安裝、乾淨重裝，版本、內嵌 Claude CLI / Codex、捷徑都正確，使用者資料（設定、紀錄）全程沒有被改動
BUG-180（v0.7.2-pre.9）：實機確認連續開分頁後切回，畫面是正常寬度，已結案
BUG-181（v0.7.2-pre.9）：以真實模型確認 Cache History 每一列等於該回合的用量，合計與 Claude CLI 回報的花費一致（含換模型、重開後接續），已結案
工作區「等待你回應」提示（v0.7.2-pre.8）：
- 以真實模型確認 Claude CLI 分頁的權限確認、「以塔台開啟 Claude」分頁的提問都會出現 ⚠️，滑過的說明不含指令與問題內容
- 以 WSL 遠端工作區確認：遠端分頁等待時，遠端視窗的工作區列、總數與跳轉都正確
- 實機確認提示在藍底的目前工作區列上看得清楚，淡化 ⚠️ 可辨識，窄側欄排版正常

待驗收（請更新到本版後協助確認）

BUG-182（本版）：遠端工作區的分頁在等你回應時重啟遠端 bat-server，重新連上後 ⚠️ 會變淡化或消失，總數正確。遠端的 bat-server 也要用設定精靈升級到本版才有這個修正
工作區提示（v0.7.2-pre.8 起）：BAT 視窗不在前景時等待結束，應留下淡化 ⚠️；用滑鼠回答權限或問題後提示是否消失
BUG-175（v0.7.2-pre.3 起，macOS，GitHub #22）、BUG-128 / BUG-130（macOS 貼上）：需要 macOS 實機
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

已知事項

遠端工作區的 ⚠️ 只顯示在該遠端連線自己的視窗裡，本機視窗的工作區列表本來就不列出遠端工作區
遠端 bat-server 重啟後，分頁不會自動重建 shell，需要 ⏻ 重啟分頁
Claude CLI 2.1.316 預設為 auto mode：很多動作由 Claude 自己判斷放行、不會停下來問你，這時 BAT 也不會顯示 ⚠️
工作區提示還不涵蓋：分離（detached）視窗裡的工作區、Claude Agent 面板分頁、沒有注入 BAT hooks 的分頁、封存的工作區
Claude Agent 面板的背景子代理執行中不會出現在進行中任務列
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.9...v0.7.3-pre.1

v0.7.2-pre.9（2026-11-01）

版號 0.7.2-pre.9，接續 v0.7.2-pre.8。

修正

連續開分頁時，前一個分頁的畫面變成很窄（BUG-180，T0741）：從「+」連續開兩個分頁（例如 Claude CLI，接著「以塔台開啟 Claude」），前一個分頁的終端尺寸會被設成 9 欄 × 5 列，Claude CLI 在切回去之前都以極窄的寬度繪製。現在背景分頁不再被設成錯誤尺寸，切回時就是正常寬度
Claude Agent 面板的 Cache History 費用重複計算（BUG-181，T0744）：Claude CLI 每回合回報的用量與費用其實是整段對話的累計值，Cache History 卻把它當成單一回合，每一列越來越大、合計又把每列加起來（實測實際花費 US$0.14，合計顯示約 US$0.34）。現在：
- 每一列顯示該回合的用量與費用，合計等於狀態列的 session 花費
- 重開 BAT 接續對話後的第一個回合標示 R*，代表含先前的累計（BAT 重開後拿不到上一回合的數字）
- 狀態列的 session 花費與 cache: 數字定義沒變

驗收與測試

本版補了一輪自動化驗收，前幾版待驗收的修正大多已驗證並結案：

以真的 Claude CLI / Codex CLI（搭配本機假模型，不耗 token）驗證 v0.7.2-pre.8 的工作區「等待你回應」提示
v0.7.2-pre.7 的 BUG-177 / 178 / 179 從介面操作驗證；bat-scripts.log 輪替也在實機確認
以真實模型小額驗證 Claude Agent 面板：對話、權限確認、工作清單（模型會主動使用）、背景子代理、換模型、重開後接續
以 WSL 內的 Docker 驗證 Docker 遠端與設定精靈：容器埠只開在本機、取消設定不會動到你自己的容器、遠端路徑轉換與附件
早期的多項修正（工作區焦點、分離視窗、Recovery、終端伺服器存活判定等）在本版重跑測試全部通過

待驗收（請更新到本版後協助確認）

BUG-180（本版）：從「+」連續開 Claude CLI 與「以塔台開啟 Claude」，切回第一個分頁時畫面是正常寬度
BUG-181（本版）：在 Claude Agent 面板連續對話幾輪後打開 Cache History，每一列是該回合的數字，合計與狀態列的花費一致
工作區提示（v0.7.2-pre.8 起）：用你自己的帳號實際使用時提示是否出現；BAT 視窗不在前景時等待結束的行為；用滑鼠回答權限或問題後提示是否消失
Windows 安裝（v0.7.2-pre.6 起）：覆蓋安裝、解除安裝後重新安裝都能正常啟動
BUG-175（v0.7.2-pre.3 起，macOS，GitHub #22）、BUG-128 / BUG-130（macOS 貼上）：需要 macOS 實機
BUG-159：一般權限（非系統管理員）執行 BAT、關閉 BAT MCP 時，兩個 Codex CLI 分頁各自讀到自己的環境

已知事項

Claude CLI 2.1.316 預設為 auto mode：很多動作由 Claude 自己判斷放行、不會停下來問你，這時 BAT 也不會顯示 ⚠️
工作區提示還不涵蓋：分離（detached）視窗裡的工作區、Claude Agent 面板分頁、沒有注入 BAT hooks 的分頁、封存的工作區
Cache History 中標示 R* 的那一列，「估算費用」可能偏低（「實際費用」正確）
Claude Agent 面板的背景子代理執行中不會出現在進行中任務列
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

這是 0.7.2 預覽版線的最後一版，下一個預覽版會換新的版號線。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.8...v0.7.2-pre.9

v0.7.2-pre.8（2026-11-01）

版號 0.7.2-pre.8，接續 v0.7.2-pre.7。

新增

工作區列表的「等待你回應」提示（T0735）：任何 agent 分頁（Claude CLI、Codex CLI、塔台、Worker）停下來等你允許權限、回答問題或回應 MCP 詢問時，你不在那個工作區也看得到：
- 工作區列表那一列的狀態點左邊出現 ⚠️，有兩個以上分頁在等時附數字；滑過列出是哪些分頁、在等什麼（不顯示問題內容），點 ⚠️ 直接跳到等最久的那個分頁
- 側欄停在「塔台」頁籤時，「工作區」頁籤標題旁顯示 ⚠️ 與總數；側欄收合時，收合窄列上也看得到
- 縮圖的 ⚠️ 不再只限 Worker 分頁，手動開的 Claude CLI / Codex CLI 分頁與塔台分頁也會顯示
- 典型情境：Worker 問塔台、塔台再問你時，塔台分頁會出現 ⚠️
錯過的提示會留著（T0735）：等待在你看到之前就結束了（例如權限提示逾時、回合自己結束），⚠️ 改成灰色、滑過顯示「hh:mm 曾等待你回應，已結束」，直到你切到那個分頁（而且 BAT 視窗在前景）才消失。這個提醒只保留在本次執行，重開 BAT 後清除

Worker 分頁原本的 ?（等塔台回答）、✓（已回報）、↻（回報後又在執行）與「關閉已回報的 Worker 分頁」的計數都沒變；? 不會觸發工作區提示。這個功能不需要搭配特定的 Control Tower 版本。

待驗收（請更新到本版後協助確認）

工作區提示（本版）：在 A 工作區讓 Claude CLI 分頁問你問題（或請求權限），切到 B 工作區，A 那一列出現 ⚠️；點它跳回該分頁。切到側欄「塔台」頁籤、或收合側欄，也看得到提示。先別回答、讓它逾時或結束，再確認提示變灰、切回該分頁後消失
BUG-179（v0.7.2-pre.7 起）：重開 BAT 一次，日誌資料夾（Windows %APPDATA%\BetterAgentTerminal\Logs）裡超過 10 MiB 的 bat-scripts.log 變成 bat-scripts-<時間>.log
BUG-178（v0.7.2-pre.7 起，設定了 CLAUDE_CONFIG_DIR 的使用者）：在 Claude Agent 面板對話一輪後重開 BAT，接續的分頁仍看得到舊訊息
工作清單與真實模型（v0.7.2-pre.6 起）：真實模型是否會主動使用工作清單；背景執行的子代理在面板上的顯示
Windows 安裝（v0.7.2-pre.6 起）：覆蓋安裝、解除安裝後重新安裝都能正常啟動，安裝時間與前一版差不多
BUG-175（v0.7.2-pre.3 起，macOS，GitHub #22）、BUG-171（v0.7.1-pre.8 起）、BUG-156 / BUG-159：同上一版

歡迎協助測試

本版的工作區提示也涵蓋 Codex CLI 分頁（codex >= 0.163.0 停下來等你輸入時）。如果你用 Codex CLI，歡迎幫忙試一次：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 agent 是 codex
請 Codex 做一件需要你確認的事，等它停下來問你
切到另一個工作區，確認原工作區那一列出現 ⚠️，點它會跳回 Codex 分頁
由塔台派一張小工單給 Codex Worker，確認 Worker 完成後通知回到塔台、分頁被回收

結果請到 GitHub issues 回報，附上 BAT 版本與 codex --version。

已知事項

工作區提示還不涵蓋：分離（detached）視窗裡的工作區（主視窗列表本來就不列出它們；分離視窗自己的縮圖照常顯示 ⚠️）、Claude Agent 面板分頁、沒有注入 BAT hooks 的分頁（關閉 BAT MCP、啟動參數放了 --settings、Claude 設定關閉 hooks）、封存的工作區
Claude Agent 面板的「下一步建議」與子代理進度摘要會多送請求（說明與關閉方式見上一版）
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.7...v0.7.2-pre.8

v0.7.2-pre.7（2026-11-01）

版號 0.7.2-pre.7，接續 v0.7.2-pre.6。

修正

Claude Agent 面板查模型清單不再耗 token（BUG-177）：面板開啟後查詢可用模型時，Claude CLI 原本會在背景多跑一次對話，送出一個完整的模型請求，並在 Claude 的 session 清單留下一筆空白 session（位置是磁碟根目錄）。現在改成只問清單、不開始對話：不送模型請求，也不留 session 檔
設定了 CLAUDE_CONFIG_DIR 時，Claude Agent 面板的歷史與 plugins（BUG-178）：面板原本固定讀 ~/.claude，設了 CLAUDE_CONFIG_DIR 的使用者接續對話或重開 BAT 後看不到舊訊息，plugins 也從錯的位置載入。現在跟 Claude CLI 一樣優先使用 CLAUDE_CONFIG_DIR；沒有設定的使用者行為不變
bat-scripts.log 不再無限制變大（BUG-179）：BAT（含遠端 bat-server）啟動時，這個 helper 診斷日誌超過 10 MiB 就改名成帶時間戳的舊檔，只保留最近 3 份。檔案被其他程式占用時略過，下次啟動再試

更新

自動化驗收測試：新增以本機假 API 驅動 Claude Agent 面板的 e2e（工作清單、接續對話、權限詢問、子代理、Claude Agent V2 分頁遷移），以及終端 file:/// / OSC 8 連結與 Codex Worker「↻ → ✓」狀態的 e2e。這些測試不連線、不耗 token

已驗收

BUG-174（終端 file:/// 連結，GitHub #20）：以本版程式碼的 e2e 確認全形字路徑整段可點、換行的路徑兩列都能開、OSC 8 連結顯示並開啟目標、非 http / https / file 的連結不開；已結案
BUG-169（安裝版 helper 版號）：Windows 安裝版三個 helper 的 --version 都顯示正確版號；已結案
Claude Agent 面板（v0.7.2-pre.5 起）：以假 API 的 e2e 確認串流、權限詢問（允許 / 拒絕）、前景子代理、接續對話正常；原本的 Claude Agent V2 分頁遷移後能接上原對話
Codex 0.166 Worker（v0.7.2-pre.5 起）：回報後再執行顯示 ↻、回合結束回到 ✓

待驗收（請更新到本版後協助確認）

BUG-179（本版）：更新後重開 BAT 一次，日誌資料夾（Windows %APPDATA%\BetterAgentTerminal\Logs）裡原本很大的 bat-scripts.log 變成 bat-scripts-<時間>.log，新的 bat-scripts.log 從小檔開始
BUG-178（本版，設定了 CLAUDE_CONFIG_DIR 的使用者）：在 Claude Agent 面板對話一輪後重開 BAT，接續的分頁仍看得到舊訊息
工作清單與真實模型（v0.7.2-pre.6 起）：真實模型是否會主動使用工作清單；背景執行的子代理在面板上的顯示
Windows 安裝（v0.7.2-pre.6 起）：覆蓋安裝、解除安裝後重新安裝都能正常啟動，安裝時間與前一版差不多
BUG-175（v0.7.2-pre.3 起，macOS，GitHub #22）：縮圖列的縮圖跟著分頁內容更新，不再停在啟動畫面，也沒有 >0q>4m 之類的字
BUG-171（v0.7.1-pre.8 起）：系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-156（需 Docker Desktop）／BUG-159（需一般權限執行 BAT + codex）：同上一版

已知事項

Claude Agent 面板開啟了「下一步建議」（輸入框旁的建議）：從第 2 個回合起，每個回合結束後會多送一個請求，大部分是讀取快取。不需要的話，在 ~/.claude/settings.json 加 "promptSuggestionEnabled": false 即可關閉
Claude Agent 面板的子代理（sub-agent）執行時，約每 30 秒會多送一個請求，產生 Agent 卡片上的進度描述；目前沒有關閉選項
工作清單只顯示主對話的項目；子代理自己建立的項目不併入
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.6...v0.7.2-pre.7

v0.7.2-pre.6（2026-11-01）

版號 0.7.2-pre.6，接續 v0.7.2-pre.5。

新增

Claude Agent 面板的工作清單（T0725）：Claude 用 TaskCreate / TaskUpdate / TaskList 管理待辦時，面板把它們累積成一份清單，畫在最近一張「工作清單」卡片上，附「已完成 n/m」；每張卡片顯示這次的動作（新增哪一項、哪一項改成進行中 / 已完成）。接續對話或重開 BAT 後，清單會從歷史紀錄重建
Claude 5 模型也會使用工作清單（T0725）：Claude CLI 預設不讓 Claude 5 模型使用工作清單工具，Claude Agent 面板現在替它開啟（CLAUDE_CODE_ENABLE_TODO_TOOLS=1）。只影響 Claude Agent 面板，不影響 Claude CLI 分頁；如果你已經自己設定 CLAUDE_CODE_ENABLE_TODO_TOOLS 或 CLAUDE_CODE_ENABLE_TASKS，以你的設定為準

更新

「Claude Agent V1」改名「Claude Agent」（T0722）：Claude Agent V2 下架後已不分版本。「+」選單、縮圖與新分頁標題都改成「Claude Agent」（worktree 版為「Claude Agent (Worktree)」）；原本預設標題是「Claude Agent V1」或「Claude Agent V2」的分頁，開啟時自動更新，自己改過的標題不動
Windows 安裝檔變小（T0726）：安裝檔改用整包壓縮，exe 從約 333 MiB 降到約 293 MiB。安裝、覆蓋安裝與解除安裝的流程不變；可攜版 zip 不受影響

修正

Claude CLI 單行「Press enter to continue」通知（T0724）：確認這行通知會留在對話紀錄裡，BAT 不以它自動送 Enter，避免用量限制早已解除後誤送；用量限制重置時仍依原本的提示自動繼續。本項只補測試與說明，行為與上一版相同

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

工作清單（本版）：Claude Agent 面板選 Claude 5 模型（例如 Opus 5.5）與 4.x 模型（例如 Sonnet 4.6），請它把幾件事列成工作清單並逐項完成，確認清單出現、勾選與「已完成 n/m」跟著變；接續該對話後清單仍在
Windows 安裝（本版）：在已安裝前一版的電腦上直接覆蓋安裝、解除安裝後重新安裝，都能正常啟動；安裝時間與前一版差不多
Claude Agent 面板（v0.7.2-pre.5 起）：送訊息、串流、權限詢問、接續對話、子代理（sub-agent）、換模型都正常；原本的 Claude Agent V2 分頁更新後變成 Claude Agent，能接續或重新開始對話
BUG-175（v0.7.2-pre.3 起，macOS，GitHub #22）：派幾個 Claude CLI Worker 或開 Claude CLI / Codex CLI 分頁，看縮圖列的縮圖是否跟著分頁內容更新，不再停在啟動畫面，也沒有 >0q>4m 之類的字
BUG-174（v0.7.2-pre.2 起，GitHub #20）：在終端印出含全形字的 file:/// 路徑，滑過時底線涵蓋整段、點尾端也能開檔；縮窄視窗讓路徑換行再試；Claude CLI 的 Markdown 連結點得開、滑過顯示實際路徑
BUG-171（v0.7.1-pre.8 起）：系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

工作清單只顯示主對話的項目；子代理（sub-agent）自己建立的項目不併入，載入較早的封存訊息時舊卡片只顯示動作摘要
新版 SDK 可能以 Bash 的 find / grep 搜尋檔案，面板上的 Grep / Glob 卡片可能變少（尚未實機確認）
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.5...v0.7.2-pre.6

v0.7.2-pre.5（2026-11-01）

版號 0.7.2-pre.5，接續 v0.7.2-pre.4。

更新

內嵌 Claude CLI 升到 2.1.316（原 2.1.306，T0717）：Claude CLI 分頁、Claude Agent 面板與塔台派出的 Claude Worker 都使用新版
內嵌 Codex 升到 0.166.0（原 0.163.0，T0717）：Codex Agent 面板使用新版；Codex CLI 分頁與 Codex Worker 仍使用你系統上安裝的 codex
內嵌 Claude Agent SDK 升到 0.3.316（原 0.2.113，T0718）：Claude Agent 面板改用新版 SDK。新版的工作清單工具（TaskCreate / TaskUpdate 等）以一般工具卡片顯示；設定檔裡的 MCP server 改在背景連線，比較慢的 server 在對話剛開始時可能還沒有工具

移除

「Claude Agent V2」分頁類型下架（T0718）：它使用的 SDK 介面在 SDK 0.3 已移除。「+」選單不再有 Claude Agent V2，Claude Agent 分頁的「升級至 V2 / 降級至 V1」按鈕一併移除
既有的 Claude Agent V2 分頁、工作區或設定裡的預設 Agent、為它設定的自訂啟動參數，開啟時自動改成 Claude Agent（V1）：分頁不會消失，會嘗試接續原本的對話（接不上時顯示提示並開新對話）；預設標題「Claude Agent V2」改成「Claude Agent V1」，自己改過的標題不動。塔台派工 --agent claude-code-v2 照舊啟動 Claude CLI Worker

修正

Codex 0.166 的分頁回合結束後一直顯示執行中（T0717）：codex 0.166 起回合結束改送新的狀態，BAT 原本不認得，分頁標籤停在 ↻、狀態查詢一直回 working。現在回合結束即回到閒置。系統 codex 升到 0.166 的使用者都會遇到，請更新到本版
Claude 新版的用量限制訊息（T0717）：Claude CLI 2.1.312 起把「session limit」改稱「5-hour limit」、限額重置通知改了大小寫，BAT 原本認不得，少了對應提示。新舊說法現在都認得

歡迎協助測試

本版更新了內嵌 Codex，也修正了 Codex 0.166 分頁的狀態。如果你用 Codex，歡迎幫忙跑一次塔台 / Worker 流程：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 role 與 agent
由塔台派一張小工單給 Codex Worker（--agent codex）
確認 Worker 每個回合結束後分頁標籤回到 ✓（不再停在 ↻），完成後通知回到塔台、分頁被回收

結果請到 https://github.com/gowerlin/better-agent-terminal/issues 回報，附上 BAT 版本（v0.7.2-pre.5）與 codex --version。

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

Claude Agent 面板（本版）：送訊息、串流、權限詢問、接續對話、子代理（sub-agent）、換模型都正常；原本的 Claude Agent V2 分頁更新後變成 Claude Agent V1，能接續或重新開始對話
BUG-175（v0.7.2-pre.3 起，macOS，GitHub #22）：派幾個 Claude CLI Worker 或開 Claude CLI / Codex CLI 分頁，看縮圖列的縮圖是否跟著分頁內容更新，不再停在啟動畫面，也沒有 >0q>4m 之類的字
BUG-174（v0.7.2-pre.2 起，GitHub #20）：在終端印出含全形字的 file:/// 路徑，滑過時底線涵蓋整段、點尾端也能開檔；縮窄視窗讓路徑換行再試；Claude CLI 的 Markdown 連結點得開、滑過顯示實際路徑
BUG-171（v0.7.1-pre.8 起）：系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

新版 SDK 的 Claude 5 等模型預設不提供工作清單工具，Claude Agent 面板的待辦清單通常不會出現；新的工作清單畫面尚未製作
新版 SDK 可能以 Bash 的 find / grep 搜尋檔案，面板上的 Grep / Glob 卡片可能變少（尚未實機確認）
Claude CLI 2.1.316 新增的單行通知 Usage limit has reset · Press enter to continue 不會讓 BAT 自動送 Enter（BAT 認得的是原本的兩行寫法）
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.4...v0.7.2-pre.5

v0.7.2-pre.4（2026-11-01）

版號 0.7.2-pre.4，接續 v0.7.2-pre.3。

更新

Worker 一次問塔台多題時，塔台只被叫醒一次（T0715 / T0716）：bat-notify.mjs --ask --no-pty-write 正式列為 BAT 的支援組合，只登記題目、跳通知，不會在塔台輸入框預填文字或按 Enter。Control Tower v5.15.0 起，Worker 一批多題時前面幾題用這個方式，只有最後一題叫醒塔台，可省下重複叫醒塔台的花費。已寫進說明文件，並加了自動測試把關
提問通知失敗時的訊息更清楚（T0716）：Worker 提問時，如果預填文字已寫進塔台輸入框、但 Enter 沒送出，錯誤訊息改說「預填已寫入、Enter 沒送出」，不再誤說塔台沒收到通知；另外多輸出一行 ask: NOTIFY_STEP <notify|pty-write|keypress> 標出失敗在哪一步。既有的輸出與結束代碼不變

修正

Worker 提問時，BAT 拒收通知的情況現在會當成失敗並取消題目，不會誤報成功（T0716；一般情況下不會發生）

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-175（v0.7.2-pre.3 起，macOS，GitHub #22）：派幾個 Claude CLI Worker 或開 Claude CLI / Codex CLI 分頁，看縮圖列的縮圖是否跟著分頁內容更新，不再停在啟動畫面，也沒有 >0q>4m 之類的字。如果縮圖出現 38;5;246m 這類殘骸，請截圖回報
BUG-174（v0.7.2-pre.2 起，GitHub #20）：在終端印出含全形字的路徑，例如 echo 'file:///Users/demo/專案/待處理/範例_v1.0.md'（換成你機器上存在的檔案），滑過時底線涵蓋整段、點尾端也能開檔；把視窗縮窄讓路徑換行再試一次；在 Claude CLI 分頁請 Claude 用 Markdown 連結回覆某個檔案，點連結能開檔，滑過時顯示實際路徑
BUG-171（v0.7.1-pre.8 起）：日常使用時，遇到系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

多題提問只叫醒一次需要搭配 Control Tower v5.15.0 以上；舊版 Control Tower 照舊每題叫醒一次，不受影響
縮圖顯示的是「最近寫出的幾列」，不一定是畫面最下面幾列；縮圖修正尚未在 macOS 實機確認
跨行的超連結（OSC 8）每一列都能點，但底線只畫在滑鼠所在的那一列（終端元件 xterm.js 本身的行為）
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.3...v0.7.2-pre.4

v0.7.2-pre.3（2026-10-30）

版號 0.7.2-pre.3，接續 v0.7.2-pre.2。

修正

終端縮圖不更新（BUG-175）：Claude CLI、Codex CLI 這類全螢幕介面在 macOS / Linux 上重畫畫面時不送換行，縮圖會一直停在啟動畫面，還會出現 >0q>4m 之類的亂碼。現在縮圖會跟著畫面最新寫出的內容更新，倒數、計時器這類只改幾個字的更新不會塞滿縮圖，清畫面後縮圖也重新開始；亂碼不再出現
- Windows 上原本會黏成一行的兩列（例如 PowerShell 啟動訊息與提示列），現在會分成兩行，比較接近實際畫面

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-175（本版，macOS）：派幾個 Claude CLI Worker 或開 Claude CLI / Codex CLI 分頁，看縮圖列的縮圖是否跟著分頁內容更新，不再停在啟動畫面，也沒有 >0q>4m 之類的字。如果縮圖出現 38;5;246m 這類殘骸，請截圖回報
BUG-174（v0.7.2-pre.2 起）：在終端印出含全形字的路徑，例如 echo 'file:///Users/demo/專案/待處理/範例_v1.0.md'（換成你機器上存在的檔案），滑過時底線涵蓋整段、點尾端也能開檔；把視窗縮窄讓路徑換行再試一次；在 Claude CLI 分頁請 Claude 用 Markdown 連結回覆某個檔案，點連結能開檔，滑過時顯示實際路徑
BUG-171（v0.7.1-pre.8 起）：日常使用時，遇到系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

BUG-165（macOS 觸控板 Codex 分頁捲動）與 BUG-166（滑鼠回報殘留）已由測試者確認，感謝協助。

已知事項

縮圖顯示的是「最近寫出的幾列」，不一定是畫面最下面幾列（全螢幕介面最下面通常是輸入框與狀態列）
縮圖修正只有自動測試與 Linux / Windows 的實錄對照，尚未在 macOS 實機確認
跨行的超連結（OSC 8）每一列都能點，但底線只畫在滑鼠所在的那一列（終端元件 xterm.js 本身的行為）
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.2...v0.7.2-pre.3

v0.7.2-pre.2（2026-10-30）

版號 0.7.2-pre.2，接續 v0.7.2-pre.1。

修正

終端裡的 file:/// 連結（BUG-174，GitHub #20）：
- 路徑含中文等全形字時，底線比網址短、尾端點了沒反應；網址前面有全形字時起點也會偏。現在底線涵蓋整段網址，任一處都能點開
- 路徑太長換到下一行時，整段仍是同一個連結（最多往上下串 20 列）
- Claude Code 等程式輸出的超連結（OSC 8，例如 Markdown 連結 [說明](file:///...)）以前點了沒反應，現在可以點開 http、https、file 連結；其他類型（例如 javascript:）不會開啟。滑鼠移上去會顯示實際要開的目標，連結文字與目標不同時也看得出來

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-174（本版）：在終端印出含全形字的路徑，例如 echo 'file:///Users/demo/專案/待處理/範例_v1.0.md'（換成你機器上存在的檔案），滑過時底線涵蓋整段、點尾端也能開檔；把視窗縮窄讓路徑換行再試一次；在 Claude CLI 分頁請 Claude 用 Markdown 連結回覆某個檔案，點連結能開檔，滑過時顯示實際路徑
BUG-171（v0.7.1-pre.8 起）：日常使用時，遇到系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-165（macOS 觸控板，Codex 分頁捲動，v0.7.1-pre.6 起）：開 Codex CLI 分頁，在 Codex 畫面內快速、慢速捲動，看是否跟手、會不會捲過頭。如果之前照建議在 ~/.codex/config.toml 的 [tui] 段加了 mouse_scroll_speed = 3，建議先移除那一行再試
BUG-166（v0.7.1-pre.4 起）：在 macOS 的分頁執行 printf '\e[?1003h\e[?1006h' 後移動滑鼠，命令列最多冒出幾筆亂碼就停；Shift + 右鍵選單有「重設滑鼠模式」
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

跨行的超連結（OSC 8）每一列都能點，但底線只畫在滑鼠所在的那一列（終端元件 xterm.js 本身的行為）
遠端視窗（WSL / SSH / Docker）裡的 file:/// 路徑指的是遠端主機的檔案，點擊時仍以本機開啟，與之前相同
file:/// 連結修正只有自動測試涵蓋，尚未在 BAT 視窗實機點擊確認
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.2-pre.1...v0.7.2-pre.2

v0.7.2-pre.1（2026-10-30）

版號 0.7.2-pre.1，接續 v0.7.1-pre.9。0.7.1 線的預覽版到 pre.9 為止，之後改走 0.7.2 線。

新增

支援以 plugin 安裝的 Control Tower：Control Tower 5.14.0 起除了 zip 手動安裝，也可以用 plugin 安裝（ct@control-tower）。Codex 只裝 plugin 時，skill 名稱是 $ct:ct-exec，原本的 $ct-exec 不會載入 skill，而且不會報錯。現在：
- 塔台派工給 Codex Worker、以及指揮塔的一鍵派工，會依 Codex 實際的安裝方式送 $ct-exec 或 $ct:ct-exec：有手動安裝（含兩種都裝）用 $ct-exec，只有啟用中的 plugin 用 $ct:ct-exec，判斷不了時照舊送 $ct-exec。判斷依分頁的 CODEX_HOME；遠端視窗由遠端主機判斷
- 指揮塔總覽 *config 的「預設」層，只裝 plugin 時也讀得到 Control Tower 的預設設定
- Claude CLI 面板的 skill 清單與 * 指令補全，只裝 plugin 時也列出 Control Tower 的 skill（手動與 plugin 同名只列一次）
- Claude CLI 的派工字串不變（/ct-exec 三種安裝都能用）
Control Tower 同時以 zip 與 plugin 安裝時提示：指揮塔總覽 *config 區塊會說明 /ct-exec、$ct-exec 實際使用的是 zip 那份；兩份版本不同時以警示顯示。只裝一種時不顯示

修正

指揮塔一鍵派工給 Codex 時，$ct-exec 被 shell 吃掉：以前一鍵派工的命令在 PowerShell 與 bash 會把 $ct 當成變數展開，Codex 實際收到的是 -exec T####。現在由 BAT 依分頁的 shell 加上正確的引號

更新

helper bat-notify.mjs --help 補充：--source 要和派工時的 --workorder 用同一個工單編號
開發者：單元測試在 Node 25 以上（例如 Node 26）也能直接執行，不需另設 NODE_OPTIONS

歡迎協助測試

本版改了 Codex Worker 的派工字串。如果你用 Codex，歡迎幫忙跑一次塔台 / Worker 流程（用 zip 或 plugin 安裝 Control Tower 都可以，兩種都試更好）：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 role 與 agent
由塔台派一張小工單給 Codex Worker（--agent codex），看 Worker 分頁送出的是 $ct-exec 還是 $ct:ct-exec，以及 Worker 有沒有照工單執行
確認 Worker 完成後通知回到塔台，分頁被回收

結果請到 https://github.com/gowerlin/better-agent-terminal/issues 回報，附上 BAT 版本（v0.7.2-pre.1）、codex --version，以及 Control Tower 的安裝方式（zip / plugin / 兩種都裝）。

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-171（v0.7.1-pre.8 起）：日常使用時，遇到系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-165（macOS 觸控板，Codex 分頁捲動，v0.7.1-pre.6 起）：開 Codex CLI 分頁，在 Codex 畫面內快速、慢速捲動，看是否跟手、會不會捲過頭。如果之前照建議在 ~/.codex/config.toml 的 [tui] 段加了 mouse_scroll_speed = 3，建議先移除那一行再試
BUG-166（v0.7.1-pre.4 起）：在 macOS 的分頁執行 printf '\e[?1003h\e[?1006h' 後移動滑鼠，命令列最多冒出幾筆亂碼就停；Shift + 右鍵選單有「重設滑鼠模式」
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

Control Tower 需 5.14.1 以上才會把「BAT >= 0.7.2-pre.1 支援 plugin 安裝」寫進文件；在那之前 Control Tower 文件仍建議 Codex 搭配 BAT 時用 zip 手動安裝
plugin 判斷已用隔離環境實測 Codex（codex-cli 0.164.0）四種安裝狀態；Claude 的 plugin 安裝只有自動測試涵蓋
遠端視窗需把遠端的 BAT 伺服器升級到本版（重跑設定精靈）才會依安裝方式判斷；舊伺服器照舊送 $ct-exec
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回（PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.9...v0.7.2-pre.1

v0.7.1-pre.9（2026-10-29）

版號 0.7.1-pre.9，接續 v0.7.1-pre.8。

修正

指揮塔的檔案太大時，頁面變成空白、工單從清單消失（BUG-172）：Control Tower 的檔案超過 512 KB 時，以前只有「總覽」會說檔案太大，「臭蟲」、「待辦」、「決策」三頁卻顯示成空清單，超過大小的工單也直接從清單消失，看起來像是沒有資料。現在：
- 「臭蟲」、「待辦」、「決策」、Epics、Sprint 讀不到檔案時，顯示「無法讀取 <檔名>」與原因（檔案太大時附大小與 512 KB 上限）
- 讀不到的工單仍列在清單中，歸在沒有狀態（no status）的一類，標題位置顯示讀取錯誤
- 勾選「包含封存」時，讀不到的封存 BUG／PLAN 列在該頁的錯誤訊息中
- 專案本來就沒有該檔案（例如沒有 _backlog.md）時，照舊顯示空清單，不顯示錯誤
優先級／嚴重度寫成 critical 時顯示為未知（BUG-173）：指揮塔的待辦與臭蟲頁，索引或 PLAN 檔把優先級寫成 critical（例如 🔴 Critical、priority: critical）時，以前顯示為未知；現在與 High 相同。

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-172（本版）：在專案的 _ct-workorders/ 放一份超過 512 KB 的 _decision-log.md（或 _bug-tracker.md），開指揮塔的對應頁，應顯示「無法讀取」與檔案大小，而不是空白
BUG-173（本版）：待辦或臭蟲索引中優先級／嚴重度寫 critical 的項目，指揮塔顯示為 High
BUG-171（v0.7.1-pre.8 起）：日常使用時，遇到系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-165（macOS 觸控板，Codex 分頁捲動，v0.7.1-pre.6 起）：開 Codex CLI 分頁，在 Codex 畫面內快速、慢速捲動，看是否跟手、會不會捲過頭。如果之前照建議在 ~/.codex/config.toml 的 [tui] 段加了 mouse_scroll_speed = 3，建議先移除那一行再試
BUG-166（v0.7.1-pre.4 起）：在 macOS 的分頁執行 printf '\e[?1003h\e[?1006h' 後移動滑鼠，命令列最多冒出幾筆亂碼就停；Shift + 右鍵選單有「重設滑鼠模式」
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

本版兩項修正只有自動測試涵蓋，尚未在實際的大檔案專案中確認
終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回；Claude CLI 可在原專案目錄執行 claude --resume 接回對話（之後的版本規劃改善，PLAN-055）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.8...v0.7.1-pre.9

v0.7.1-pre.8（2026-10-25）

版號 0.7.1-pre.8，接續 v0.7.1-pre.7。

修正

系統校時後，執行中的分頁被結束、只剩 [Process exited with code 1]（BUG-171）：Windows 自動校時讓系統時鐘往前跳幾秒時，BAT 會誤以為背景的終端伺服器已經停止，跳出「終端已恢復（歷史輸出已重置）」並重建所有分頁。分頁裡的 Claude CLI、Codex CLI 等程式因此被結束，畫面只剩新的 shell 提示字元，接著顯示 [Process exited with code 1]。現在：
- 系統時鐘跳動不再影響判斷；伺服器要連續多次沒回應，而且程序或連線確實已經不在，才會重建
- 伺服器只是一時沒回應、程序與連線都還在時，不重建
- 真的需要重建時，先結束舊的伺服器，舊伺服器晚到的訊息不再影響重建後的分頁，也不會留下沒人管的背景程序
- 這個問題從很早的版本就存在，不是近期改版造成的
背景終端伺服器的設定出現在每個分頁的環境變數：分頁裡不再看得到 BAT_IDLE_TIMEOUT_MS、BAT_SCROLL_BUFFER_LINES（這兩個只給伺服器自己用）

更新

終端伺服器的恢復提示與 BAT 重開時的「恢復終端」對話框支援多語系：英文與簡體中文介面下改顯示對應語言（以前一律是繁體中文），繁體中文的文字不變

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-171（本版）：日常使用時，遇到系統自動校時、睡眠喚醒後，不再出現「終端已恢復」提示，閒置的 Claude CLI 分頁也不會變成 [Process exited with code 1]
BUG-165（macOS 觸控板，Codex 分頁捲動，v0.7.1-pre.6 起）：開 Codex CLI 分頁，在 Codex 畫面內快速、慢速捲動，看是否跟手、會不會捲過頭。如果之前照建議在 ~/.codex/config.toml 的 [tui] 段加了 mouse_scroll_speed = 3，建議先移除那一行再試
BUG-166（v0.7.1-pre.4 起）：在 macOS 的分頁執行 printf '\e[?1003h\e[?1006h' 後移動滑鼠，命令列最多冒出幾筆亂碼就停；Shift + 右鍵選單有「重設滑鼠模式」
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

終端伺服器真的停止時，BAT 仍只重建 shell，分頁裡原本執行的 Claude CLI / Codex CLI 不會自動接回；Claude CLI 可在原專案目錄執行 claude --resume 接回對話（之後的版本規劃改善，PLAN-055）
本版修正在 Windows 上以隔離實例實測（時鐘前跳、伺服器暫停、伺服器結束）；macOS / Linux 只有自動測試涵蓋
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.7...v0.7.1-pre.8

v0.7.1-pre.7（2026-10-25）

版號 0.7.1-pre.7，接續 v0.7.1-pre.6。

新增

指揮塔「總覽」改成顯示塔台狀態與設定：「塔台 › 指揮塔 › 總覽」以前只看 sprint-status.yaml，沒有這個檔的專案只會看到「未找到 sprint-status.yaml」。現在依序顯示：
- 塔台狀態：最後更新時間、進行中的工單；Control Tower 在塔台狀態檔寫了摘要時，另外顯示下一個工單 / 決策編號與最近的待辦（最多 5 則）
- Control Tower 設定：每個設定的生效值與來源（專案 / 使用者 / 預設），可展開被覆蓋的值；不含塔台本次對話裡的臨時設定
- Sprint：只在專案有 sprint-status.yaml 時顯示，內容和以前一樣
總覽自動更新：塔台狀態檔、專案設定檔、工單檔改了，總覽會自己更新，不用重新進入專案；使用者層設定與 Control Tower 預設值在切到總覽或按 ↻ 時重新讀取

修正

工單計數把報告檔算成「pending」：沒有狀態欄位的報告或筆記檔，以前被當成待派工單。現在另列為「no status」，不算 pending；同編號的工單與報告並存時，也不會再讓報告蓋掉工單
舊格式工單讀不到寫在引用區塊裡的狀態（例如 > 狀態:✅ DONE）：現在讀得到
Control Tower 的 PAUSED 狀態：工單被緊急任務中斷暫停時顯示 ⏸ Paused，列在總覽的進行中工單；工單狀態寫成 TODO 時視同 PENDING，不再標成無效

更新

專案網站與 README：Control Tower 已公開（MIT 授權），「Control Tower 去哪取得」改為連到 Control Tower 安裝頁；網站導覽列與 Control Tower 相關頁面連到 Control Tower 站

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-165（macOS 觸控板，Codex 分頁捲動，v0.7.1-pre.6 起）：開 Codex CLI 分頁，在 Codex 畫面內快速、慢速捲動，看是否跟手、會不會捲過頭。如果之前照建議在 ~/.codex/config.toml 的 [tui] 段加了 mouse_scroll_speed = 3，建議先移除那一行再試
BUG-166（v0.7.1-pre.4 起）：在 macOS 的分頁執行 printf '\e[?1003h\e[?1006h' 後移動滑鼠，命令列最多冒出幾筆亂碼就停；Shift + 右鍵選單有「重設滑鼠模式」
BUG-169（v0.7.1-pre.6 起）：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

已知事項

總覽的「下一個編號」與「待辦」需要 Control Tower 在塔台狀態檔寫入摘要（Control Tower v6.0.0-pre.1 預覽版起）；較舊的 Control Tower 只顯示最後更新時間、進行中工單，並提示開檔查看
遠端視窗（WSL / SSH / Docker）要讀遠端主機上的 Control Tower 使用者設定與預設值，需把遠端的 BAT 伺服器升級到本版（重跑設定精靈）；未升級時總覽會標示無法讀取，專案設定照常顯示
遠端視窗的總覽、有 sprint-status.yaml 的 BMAD 專案的 Sprint 區塊，以自動測試確認，尚未實機確認
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.6...v0.7.1-pre.7

v0.7.1-pre.6（2026-10-22）

版號 0.7.1-pre.6，接續 v0.7.1-pre.5。

修正

Codex 分頁內用觸控板捲動不夠順：Codex 在全螢幕畫面會自己處理滑鼠，以前快速滑動時每個滾輪事件只會傳給 Codex 一次，多捲的距離被丟掉，所以捲動跟不上手指。現在 BAT 會依實際滑動的距離換算行數，一次傳多個（每個事件最多 8 個），捲動手感接近 Claude CLI 分頁與 iTerm2。只影響你自己開的 Codex CLI 分頁在 Codex 畫面內的捲動；一般 shell、Claude CLI 分頁不變（BUG-165）
安裝版的 helper 版號顯示 v0.0.0：bat-terminal、bat-notify 用 --version 查詢，以及 BAT MCP 回報的版本，現在會顯示安裝的版號（BUG-169）
用量限制重置、CLI 已自動繼續後，分頁上的「將於 … 自動繼續」提示沒有消失：Claude CLI 重置後顯示 Usage limit reset · continuing automatically 時，BAT 現在會認得這行，把分頁狀態改成已繼續

新增

Worker 回報後又開始工作時，分頁標籤顯示 ↻：塔台 Renew 工單、Worker 繼續執行時，分頁不再停在 ✓ 看起來像已完成；這段期間不會被「批次關閉已回報的 Worker」關掉，回合結束後回到 ✓。批次關閉的確認框也會標出最近 5 秒還在輸出的分頁

更新

內嵌 Codex 升級到 0.163.0（原 0.160.0）：給 Codex 面板使用。BAT MCP、Worker 啟動確認與狀態偵測、用量限制提示的辨識都已對新版確認；Codex CLI 分頁使用你自己安裝的 codex，不受影響

待驗收（請更新到本版後協助確認）

以下修正已包含在本版，仍在等實機確認：

BUG-165（macOS 觸控板，Codex 分頁捲動）：開 Codex CLI 分頁，在 Codex 畫面內快速、慢速捲動，看是否跟手、會不會捲過頭。如果之前照建議在 ~/.codex/config.toml 的 [tui] 段加了 mouse_scroll_speed = 3，本版後可能捲得太快，建議先移除那一行再試
BUG-166（v0.7.1-pre.4 起）：在 macOS 的分頁執行 printf '\e[?1003h\e[?1006h' 後移動滑鼠，命令列最多冒出幾筆亂碼就停；Shift + 右鍵選單有「重設滑鼠模式」
BUG-169：執行 node "<安裝目錄>/resources/scripts/bat-terminal.mjs" --version，應顯示本版版號而不是 v0.0.0
BUG-156（需 Docker Desktop）：Docker 設定精靈建立容器時，不再與 BAT 本機伺服器搶用 9876 埠
BUG-159（需一般權限執行 BAT + codex）：Codex CLI 分頁內執行的 helper 讀到的是自己分頁的 BAT_*，不是其他分頁的

歡迎協助測試

本版更新了內嵌 Codex，也改了 Codex 分頁的捲動。如果你用 Codex，歡迎幫忙跑一次塔台 / Worker 流程：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 role 與 agent
由塔台派一張小工單給 Codex Worker（--agent codex）
確認 Worker 完成後通知回到塔台，分頁被回收

結果請到 https://github.com/gowerlin/better-agent-terminal/issues 回報，附上 BAT 版本（v0.7.1-pre.6）與 codex --version。

已知事項

Codex 分頁的捲動修正只涵蓋你自己開的 Codex CLI 分頁；塔台派工建立的 Codex Worker 分頁維持原本的捲動方式
Windows / Linux 用滑鼠滾輪在 Codex 畫面內捲動，一格捲的行數會比以前多（大約與 Claude CLI 分頁相同），尚未實機確認是否太快
新版內嵌 Codex 已用自動測試與不呼叫模型的方式確認，Codex 面板實際對話尚未在本版實機確認
遠端視窗需把遠端的 BAT 伺服器升級到本版（重跑設定精靈）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.5...v0.7.1-pre.6

v0.7.1-pre.5（2026-10-21）

版號 0.7.1-pre.5，接續 v0.7.1-pre.4。

修正

SSH 設定精靈：啟動遠端伺服器失敗時，錯誤訊息開頭與錯誤類型不一致：服務已註冊、但啟動後無法執行時，錯誤類型是「啟動失敗」，詳細訊息開頭卻寫 enable-failed:，容易誤以為是註冊服務出錯。現在開頭會跟錯誤類型一致（start-failed: / enable-failed:）

更新

內嵌 Claude CLI 升級到 2.1.306（原 2.1.300）：模型清單、價格、effort 等級皆無變動；BAT MCP、hooks、分頁名稱與用量限制提示的辨識都已對新版確認
安裝檔不再附帶開發用腳本：安裝目錄的 resources/scripts 現在只放 BAT 執行時用到的 6 個 helper（bat-terminal、bat-notify、bat-mcp、bat-hook 與它們共用的兩個模組），建置與測試用的腳本不再打包。打包前與打包後都會檢查這份清單，避免漏放 helper
發版前先跑完整自動測試：預覽版與正式版在打包前會先跑全部單元測試與舊版測試，任何一項失敗就不打包、不發佈（BUG-168）
BAT MCP 權限政策：BAT MCP 目前 8 個 tool 全部唯讀；文件明訂日後若新增會寫入的 tool，不會開放給 workflow 子 agent 使用（PLAN-054）
官網新增「把腦力留給判斷」頁：說明 BAT 與 Control Tower 的設計初衷，怎麼把需要記在腦中的狀態交給工具

已知事項

安裝版的 helper 用 --version 查詢時會顯示 v0.0.0，BAT MCP 回報的版本也是 0.0.0。只影響顯示，功能不受影響，修正排在後續版本（BUG-169）
新版內嵌 Claude CLI 已用自動測試與不呼叫模型的方式確認，Agent 面板實際對話尚未在本版實機確認。Claude Code 2.1.302 起，Agent SDK 預設以 fork 方式執行 subagent，若 Agent 面板的進行中任務列顯示異常請回報
程式異常結束後的滑鼠追蹤自動重設（v0.7.1-pre.4，BUG-166）以自動測試驗證，尚未在 macOS 實機確認
v0.7.1-pre.3 在 macOS 停用 Graphite 後，已有使用者實機確認長時間使用不再出現 GPU 崩潰（BUG-164）；根本修正仍需升級 Electron 42 以上，已列入後續計畫
Codex 分頁內用觸控板快速捲動時跟不上手指，修正排在後續版本。想先改善，可以在 ~/.codex/config.toml 的 [tui] 段加 mouse_scroll_speed = 3（BUG-165）
遠端視窗需把遠端的 BAT 伺服器升級到本版（重跑設定精靈）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.4...v0.7.1-pre.5

v0.7.1-pre.4（2026-10-19）

版號 0.7.1-pre.4，接續 v0.7.1-pre.3。

修正

程式異常結束後，滑鼠一動就在命令列冒出 35;52;69M… 這類亂碼：Codex 這類全螢幕程式會開啟滑鼠追蹤。如果它不是正常離開，而是被系統結束或崩潰，就沒機會把滑鼠追蹤關掉。回到 shell 後，滑鼠的移動和滾輪會被當成文字插進命令列。現在 BAT 發現滑鼠回報被 shell 原樣印出來時，會自動關閉該分頁的滑鼠追蹤。最前面幾筆亂碼仍會留在命令列，按 Ctrl+U 清掉即可。macOS、Linux 與 WSL / SSH / Docker 分頁會發生，Windows 原生分頁不會（BUG-166）
終端右鍵選單新增「重設滑鼠模式」與「離開替代畫面（alt screen）」：滑鼠被程式追蹤時，用 Shift + 右鍵開選單即可手動重設。分頁停在全螢幕程式的畫面時，「離開替代畫面」可回到原本的終端畫面與捲動紀錄（BUG-166）

已知事項

v0.7.1-pre.3 修正的 macOS 打字延遲（BUG-136），已有使用者在 macOS 實機確認解決
滑鼠追蹤的自動重設以自動測試驗證，尚未在 macOS 實機確認
Codex 分頁內用觸控板快速捲動時跟不上手指，原因已查明，修正排在後續版本。想先改善，可以在 ~/.codex/config.toml 的 [tui] 段加 mouse_scroll_speed = 3（BUG-165）
macOS 停用 Graphite（v0.7.1-pre.3）後是否不再出現 GPU 崩潰，仍待實機確認；根本修正需要升級 Electron 42 以上，已列入後續計畫
遠端視窗需把遠端的 BAT 伺服器升級到本版（重跑設定精靈）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.3...v0.7.1-pre.4

v0.7.1-pre.3（2026-10-19）

版號 0.7.1-pre.3，接續 v0.7.1-pre.2。

修正

macOS 上長時間使用的分頁打字越來越卡：Codex 這類全螢幕程式在 macOS / Linux 的輸出幾乎沒有換行。縮圖列的預覽文字因此一直累積，對話越長越大，使用者量到的單一分頁預覽有 70 萬到 100 萬字以上。每次更新縮圖都要重新排版整段文字，BAT 介面持續吃滿約一顆核心，打字明顯延遲。現在縮圖預覽有長度上限（約 2 KB），一般 shell 的縮圖照舊顯示最後 8 行。Windows 原本就不會累積，不受影響（BUG-136）
macOS 上 GPU 程序偶爾在建立或切換分頁時崩潰：Chromium 146（Electron 41）的 Skia Graphite 繪圖後端遇到繪圖指令順序錯亂時，會直接讓 GPU 程序崩潰，5 分鐘內崩 3 次還會退回軟體繪圖，直到重開 BAT。現在 macOS 版預設停用 Graphite，改用另一個繪圖後端。如果停用後畫面或效能變差，可以用環境變數 BAT_SKIA_GRAPHITE=1 啟動 BAT 恢復原狀（BUG-164）
GPU 程序崩潰後終端畫面空白或殘影：GPU 程序重新啟動後，當下看得到的終端會自動重畫，不必再切換分頁或手動重繪（BUG-164）

更新

專案網站：各頁補上搜尋與分享用的說明文字，404 頁改為中文；故事插圖改用 Control Tower 實際的工單目錄名稱，SSH 頁補充範例主機名稱的說明。https://gowerlin.github.io/better-agent-terminal/

已知事項

這一版的兩項 macOS 修正以自動測試驗證，尚未在 macOS 實機確認：打字延遲是否消失、停用 Graphite 後是否不再出現 GPU 崩潰
停用 Graphite 只在 macOS 生效。GPU 崩潰的根本修正需要升級 Electron 42 以上，已列入後續計畫
遠端視窗需把遠端的 BAT 伺服器升級到本版（重跑設定精靈）
Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.1-pre.2...v0.7.1-pre.3

v0.7.1-pre.2（2026-10-18）

版號 0.7.1-pre.2，接續 v0.7.1-pre.1。

修正

Docker 設定精靈在預設設定下建立不了容器：精靈原本固定把容器公開在 127.0.0.1:9876，正好是 BAT 自己的遠端存取伺服器預設使用的埠，「建立新容器」會失敗。現在精靈會挑一個沒被占用的埠（從 9877 起，避開 BAT 自己的伺服器埠）；「沿用既有容器」改用容器實際公開的埠，不再一律連 9876。埠真的不能用時，精靈會移除這次建立的容器，按「重試」換一個埠（BUG-156）
重新釘選的憑證指紋被「儲存」蓋回舊值：在「編輯連線」按「重新釘選指紋」後再按「儲存」，會把舊指紋寫回去；釘選失敗也沒有任何提示。現在釘選後對話框會顯示並保存新指紋，失敗時顯示原因（BUG-157）
SSH 設定的「重新釘選指紋」連到錯的對象：SSH 設定按這個按鈕時，BAT 不經 SSH 通道、直接連本機的同號埠；若本機剛好有別的 BAT 伺服器，會把它的指紋釘進 SSH 設定，並把 SSH 設定的權杖送給它。現在 SSH 設定的這個按鈕停用，請改用重跑設定精靈更新指紋（BUG-160）
Worker 已經不在等你，縮圖仍顯示 ⚠️：Claude Worker 的權限對話框（例如 Claude 自己的「危險刪除」安全檢查，即使用 --dangerously-skip-permissions 也會出現）被自動拒絕或沒經過鍵盤就結束後，分頁一直停在「等使用者」，直到這一輪結束。現在權限請求一結束就恢復，背景子 Agent 的權限對話框也分開計算（BUG-162）
手動開的 Codex 分頁可能讀到別的分頁的身分：Codex 的多個 session 共用背景程序時，分頁裡執行的命令拿到的是背景程序的環境變數。BAT MCP 沒有注入（例如在設定中關閉）的手動 Codex 分頁，現在會加 --no-daemon（需要 codex 0.156.0 以上，確認不了版本就不加）；派工的 Worker 與一般情況本來就不受影響（BUG-159）
設定精靈的按鈕是白底原生按鈕：WSL / SSH / Docker 精靈的選項按鈕、輸入框與進度條沒有套用 App 的樣式（進度條原本根本看不到）。現在與 App 其他畫面一致；三個精靈的步驟說明也改寫成看得懂的說法，拿掉內部用語（BUG-163）
遠端設定畫面與精靈的英文字樣：配置面板、編輯連線對話框、WSL / SSH / Docker 精靈的提示、警告與錯誤訊息改為介面語言（繁中 / 簡中 / 英文）；SSH 認證失敗的訊息改成提示檢查金鑰與 ssh-agent（BAT 不能用密碼登入）；縮圖列的「建議」、縮圖右鍵的「設為監督者」也已翻譯，各對話框的 × 關閉鈕補上無障礙標籤（BUG-158、BUG-161）

更新

專案網站：新增「遠端開發」四頁（總覽、WSL、SSH、Docker 的設定步驟與常見狀況）；功能頁與遠端頁換上真實截圖，「與 Control Tower 協作」頁加了一段派工短片；分享連結時會顯示預覽卡片。https://gowerlin.github.io/better-agent-terminal/
README：換上目前版本的截圖
repo 內的遠端部署指南（docs/ 的 WSL / SSH / Docker 與總覽）更新為目前的行為

歡迎協助測試

如果你平常使用 Codex CLI，歡迎幫忙確認這一版的 Codex 修正：

到「設定」關閉 BAT MCP，開一個 Codex CLI 分頁，請 Codex 執行 node -e "console.log(process.env.BAT_TERMINAL_ID)"，確認印出的是這個分頁自己的 ID（可與另一個 Codex 分頁比較）。以系統管理員身分執行 BAT 時看不出差異，請用一般權限
如果你也在用 Control Tower：由塔台派一張小工單給 Codex Worker，確認 Worker 完成後通知回到塔台、分頁被回收

不論成功或失敗，都歡迎到 GitHub Issues 回報，請附上 BAT 版本、Codex 版本（codex --version）、作業系統與安裝方式。

已知事項

這一版的修正以自動測試驗證，以下尚未實機驗證：Docker 精靈挑埠（需要 Docker Desktop）、指紋重新釘選、⚠️ 在權限請求結束後消失、非系統管理員下的 Codex --no-daemon
「沿用既有容器」仍會自動選最近建立的容器，不能自己挑
遠端視窗需把遠端的 BAT 伺服器升級到本版（重跑設定精靈）
macOS / Linux 版本未實機驗證

v0.7.1-pre.1（2026-10-18）

版號 0.7.1-pre.1，接續 v0.7.0-pre.9。

新增

在 Claude Code 的跨 session 清單裡認得出 BAT 的分頁：BAT 開的 Claude CLI 分頁啟動時會自動帶上 session 名稱，顯示在 Claude Code 的跨 session 清單（ListAgents）、/resume 選單與輸入框上。塔台派出的 Worker 是「工作區 · Worker · T####」，其他 Claude CLI 分頁是「工作區 · 短 ID」。你自己在啟動參數裡加了 --name 時，以你的為準；系統安裝的 claude 低於 2.1.76 或判斷不到版本時，不會加名稱，避免 claude 啟動失敗（PLAN-050）
以塔台開啟 Claude：分頁縮圖列的「+」選單，在「Claude CLI」下方多了「以塔台開啟 Claude」。開出的分頁名稱是「工作區 · Tower」，按 ⏻ 重啟或 BAT 重開還原後都不變。這個入口只負責命名，塔台角色仍由 Control Tower 啟動時宣告（PLAN-050）
查得到分頁對應哪個 Claude session：BAT MCP 的 bat_whoami、bat_list_terminals、bat_get_state 多了 claudeSessionName 與 claudeSessionId 兩個欄位。已宣告的塔台可以用 bat_list_terminals 的 scope: towers 列出這台 BAT 上所有工作區的塔台與它們的 session 名稱，其他分頁的內容仍然看不到（PLAN-050）
專案網站新增「實戰案例」頁：https://gowerlin.github.io/better-agent-terminal/cases，3 個情境案例與 3 個 BAT 自己的開發紀錄（PLAN-049）

修正

塔台派出的 Worker 查不到自己是哪個 agent：由 bat-terminal.mjs 派出的 Worker（Claude 與 Codex 皆是），bat_whoami 沒有 agent 欄位；派出的 Claude Worker 也少了「不讓內嵌 claude 被手動更新」的防護。現在都與從 BAT 介面開的分頁相同（BUG-155）

歡迎協助測試

如果你平常使用 Codex CLI，歡迎幫忙確認一件事：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認有 agent 欄位，值是 Codex
如果你也在用 Control Tower：由塔台派一張小工單給 Codex Worker，在 Worker 分頁呼叫 bat_whoami，確認 agent 是 Codex；Worker 完成後，確認通知回到塔台、分頁被回收

不論成功或失敗，都歡迎到 GitHub Issues 回報，請附上 BAT 版本、Codex 版本（codex --version）、作業系統與安裝方式。

已知事項

session 名稱只用在 Claude CLI 分頁；Codex 分頁不會出現在 Claude Code 的跨 session 清單，兩個欄位一律是空值
名稱在 BAT 啟動 claude 時決定：在分頁裡 /rename，或之後改了工作區名稱，BAT 記錄的名稱不會跟著變；同一個工作區開兩個「以塔台開啟」分頁時名稱相同
側欄塔台面板的「執行工單 / 補結案」按鈕開出的分頁沒有 session 名稱
WSL / SSH / Docker 遠端視窗派出的 Worker，名稱是「BAT · Worker · T####」（遠端沒有工作區名稱）；需把遠端 server 升級到本版
Control Tower 依這些欄位找塔台的規則尚待 CT 新版；在那之前，名稱已經會出現在跨 session 清單上
macOS / Linux 版本未實機驗證

v0.7.0-pre.9（2026-10-18）

版號 0.7.0-pre.9，接續 v0.7.0-pre.8。

新增

Codex CLI 分頁也看得出「在等你」與「已啟動」：Codex CLI 0.163.0 以上會自己回報狀態，BAT 據此判斷 Codex 分頁是否停在核准提示或提問等你回答，Worker 縮圖顯示 ⚠️（不算進「關閉已回報的 Worker 分頁」），bat_get_state 回報 blocked / input（blockedDetection: osc）。塔台派工時帶 --wait-started，也能確認 Codex Worker 真的啟動了。BAT 重開時，Codex 分頁最後的狀態會從保留的輸出補回（PLAN-047）
專案網站上線：https://gowerlin.github.io/better-agent-terminal/——用一個早上的故事說明 BAT 與 Control Tower 一起用能解決哪些卡關時刻，另有功能介紹、Control Tower 功能導覽、安裝、常見問題與回報方式（PLAN-049）

修正

Claude CLI 分頁回答 MCP 表單後，「等人回答」狀態沒有清除：MCP 伺服器跳出的表單在你回答、取消或請求逾時後，現在會立即清除 blocked（elicitation），不再停留到該回合結束（PLAN-047）

更新

BAT 派出的 Codex Worker 啟動時不再跳出更新提示，避免 Worker 卡在提示畫面（只對塔台派出的 Worker、只影響該次啟動；你的自訂參數已設定這一項時以你的為準）
Control Tower v5.8.0 已支援 Codex 的「在等你」告知與 Worker 啟動確認；需要 BAT 0.7.0-pre.9 以上

歡迎協助測試

如果你平常使用 Codex CLI 0.163.0 以上，歡迎幫忙跑一次：

開一個 Codex CLI 分頁，呼叫 MCP tool bat_whoami，確認 agent 是 Codex；再呼叫 bat_get_state，看 blockedDetection 是否變成 osc
讓 Codex 停在需要你核准的提示，確認縮圖顯示 ⚠️、bat_get_state 回報 blocked / input；核准後 ⚠️ 消失
如果你也在用 Control Tower（v5.8.0）：由塔台派一張小工單給 Codex Worker（--agent codex --wait-started 30000），確認塔台收到 started: <時間>；Worker 完成後，確認通知回到塔台、分頁被回收

不論成功或失敗，都歡迎到 GitHub Issues 回報，請附上 BAT 版本、Codex 版本（codex --version）、作業系統與安裝方式（npm / 官方 installer）。

已知事項

Codex 的狀態判斷需要 Codex CLI 0.163.0 以上。BAT 以自己的 PATH 判斷版本：Windows 上若 PATH 裡第一個 codex 是 npm 安裝的 codex.cmd，判斷不到版本，派工的啟動確認回報 unknown，行為與先前相同；若分頁實際執行的 codex 比 BAT 判斷的舊，啟動確認可能回報 unconfirmed（分頁不會被關閉）
Codex 的「在等你」不分種類（核准、提問都顯示為 input）；你在 Codex 分頁打字不會清除 ⚠️，要等 Codex 自己回報狀態改變
未信任的 git repo 會讓 Codex 停在「Trust this folder?」畫面，啟動確認回報 unconfirmed；先在該目錄手動開一次 Codex 並信任即可
需搭配本版內附的 helper；WSL / SSH / Docker 遠端視窗需把遠端 server 升級到本版
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.8...v0.7.0-pre.9

v0.7.0-pre.8（2026-10-18）

版號 0.7.0-pre.8，接續 v0.7.0-pre.7。

修正

Worker 問完塔台後，縮圖標示沒有恢復：Worker 用 bat-notify.mjs --ask 提問、塔台答覆後，Worker 其實還在工作，縮圖卻停在 ?（訊息以「提問」結尾時），或變成 ✓ 並被算進塔台分頁右鍵「關閉已回報的 Worker 分頁（N）」（其他訊息時）。現在答覆後縮圖回到「執行中」（沒有標示、不算進批次關閉），等 Worker 下一次回報（例如完成）才顯示 ✓；先回報過再提問的 Worker 也一樣（BUG-154）

更新

Control Tower v5.7.0 已支援「Worker 問塔台」：yolo Worker 改用 --ask 提問、塔台以 bat_list_questions / bat-terminal.mjs --answer 答覆，BAT 不支援或問題遺失時仍回到工單裡往返。需要 BAT 0.7.0-pre.7 以上；本版另修正上面的縮圖問題

歡迎協助測試

如果你平常使用 Codex CLI，且 Control Tower 已是 v5.7.0，歡迎幫忙跑一次「Codex Worker 問塔台」：

在塔台派一張小工單給 Codex Worker（--agent codex），內容請它向塔台提問一次
確認塔台分頁收到通知、Worker 縮圖顯示 ?，bat_get_state 回報 blocked / tower
塔台答覆後，確認 Worker 繼續工作、縮圖沒有標示；Worker 完成回報後縮圖顯示 ✓、分頁被回收

不論成功或失敗，都歡迎到 GitHub Issues 回報，請附上 BAT 版本、Codex 版本（codex --version）、作業系統與安裝方式（npm / 官方 installer）。

已知事項

提問的通知要搭配本版 BAT 內附的 helper 才會正確恢復縮圖；WSL / SSH / Docker 遠端視窗需把遠端 server 升級到本版
舊版 Control Tower（v5.6.x 以前）以「T#### 提問」在工單裡往返時，塔台答覆後縮圖的 ? 仍會保留到 Worker 下一次通知
Claude hook 的 blocked（權限確認 / 提問）偵測仍只支援 Claude CLI 分頁
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.7...v0.7.0-pre.8

v0.7.0-pre.7（2026-10-18）

版號 0.7.0-pre.7，接續 v0.7.0-pre.6。

新增

Worker 可以直接問塔台、等塔台答覆：塔台派出的 Worker 遇到需要決定的事，可以用 bat-notify.mjs --ask 把問題（可附選項）送給派它的塔台，BAT 會同時通知塔台分頁；Worker 再用 BAT MCP 的 bat_wait_question 等答覆（每次最多 45 秒，沒等到就再呼叫）。塔台用 bat_list_questions 看題目、用 bat-terminal.mjs --answer 回答。問題與答案只放在 BAT 執行中的記憶體，不寫入任何檔案，日誌也不記內容；BAT 重開後尚未回答的問題會回報「已遺失」，Control Tower 會改回原本「寫在工單裡往返」的做法（PLAN-048）
狀態查詢看得出 Worker 在等塔台：Worker 有待答問題時，bat_get_state / bat_wait / bat_list_terminals 回報 blocked，原因為 tower，並多一個 pendingQuestions（待答題數）欄位。Codex 分頁也適用。你在 Worker 分頁打字不會取消問題
BAT MCP 新增兩個唯讀 tool：bat_list_questions、bat_wait_question（共 8 個，全部唯讀）

修正

Worker 向塔台提問時，縮圖就顯示 ✓：Worker 送出「T#### 提問」後，縮圖立刻顯示和「已回報」一樣的 ✓，塔台分頁右鍵「關閉已回報的 Worker 分頁（N）」也會把它算進去，有誤關仍在工作的 Worker 的風險。現在縮圖分三種：等你處理（權限確認、Claude 提問等）顯示 ⚠️、等塔台答覆顯示 ?、已回報才顯示 ✓，滑鼠移上去會說明原因與時間；只有 ✓ 會算進批次關閉（BUG-153）

更新

blockedDetection: "none" 的意思改為「這個分頁不會回報 Claude hook 的三種原因（permission / question / elicitation）」；等塔台答覆的 tower 由 BAT 自己判斷，任何分頁都可能出現

歡迎協助測試

如果你平常使用 Codex CLI，歡迎幫忙確認新的 MCP tool 在 Codex 分頁可以用：

在塔台派出的 Codex Worker 分頁（或任何 Codex CLI 分頁），請它呼叫 MCP tool bat_list_questions（不帶參數），應回傳 0 pending questions
請它呼叫 bat_whoami，確認 agent 為 codex-cli
如果你的 Control Tower 已支援「Worker 問塔台」（v5.7.0 起），讓 Codex Worker 提問一次，確認塔台收到通知、bat_get_state 回報 blocked / tower、答覆後 Worker 繼續工作

不論成功或失敗，都歡迎到 GitHub Issues 回報，請附上 BAT 版本、Codex 版本（codex --version）、作業系統與安裝方式（npm / 官方 installer）。

已知事項

Control Tower 使用「Worker 問塔台」需要 v5.7.0（準備中）；在那之前 Control Tower 照舊在工單裡往返
問題與答案不寫入 BAT 的檔案或日誌，但 Claude / Codex 自己的對話紀錄仍會包含它們
縮圖的 ⚠️ / ? 只存在視窗記憶體：重新載入視窗或遠端重新連線後，要等該分頁下一次狀態變化才會再出現
舊版 Control Tower 以「T#### 提問」通知時，塔台答覆後縮圖的 ? 會保留到 Worker 下一次通知
Claude hook 的 blocked（權限確認 / 提問）偵測仍只支援 Claude CLI 分頁
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.6...v0.7.0-pre.7

v0.7.0-pre.6（2026-10-18）

版號 0.7.0-pre.6，接續 v0.7.0-pre.5。

新增

確認塔台派出的 Worker 真的啟動了：Claude CLI 分頁啟動時，BAT 會記下「已啟動」。BAT MCP 的 bat_get_state / bat_wait / bat_list_terminals 多一個 agentStarted 欄位（true 已啟動 / false 還沒 / null 無法判定），bat_wait 也可以等到啟動為止（until: 'agent-started'）。塔台派工時可以加 --wait-started <毫秒>，helper 會等到 Worker 啟動才回傳：已啟動回 started: <時間>；等不到時回 exit 8（分頁保留，不要重派）；無法判定（例如 Codex）回 started: unknown，不算失敗。不加這個參數時，派工行為和以前完全一樣（D154）

修正

塔台派工時，Worker 分頁搶走鍵盤焦點：塔台派出的 Worker 分頁會切到前景並取得焦點，你正在塔台分頁打的字會跑進 Worker 分頁。現在 Worker 分頁照常出現在分頁列與縮圖，但畫面和焦點都留在你正在用的分頁；手動開的分頁、Control Tower 面板按鈕開的分頁仍會切過去（BUG-152）
Claude 設定關閉 hooks 時，blocked 偵測誤以為有在偵測：使用者或系統管理設定以 disableAllHooks 關閉 hooks 時，分頁現在回報 blockedDetection: "none"（原本是 hook 但永遠不會有事件）

歡迎協助測試

如果你平常使用 Codex CLI，歡迎幫忙跑一次塔台 / Worker 流程（需要 BMad Control Tower）：

新開一個 Codex CLI 分頁，請它呼叫 MCP tool bat_whoami（不帶參數），確認回傳的 role 與 agent（應為 codex-cli）
在塔台分頁派一張小工單給 Codex Worker（--agent codex）；如果你的塔台會帶 --wait-started，Codex Worker 應回 started: unknown（Codex 目前沒有啟動信號，這是預期結果）
確認 Worker 完成後通知有回到塔台分頁，Worker 分頁也有被自動回收

不論成功或失敗，都歡迎到 GitHub Issues 回報，請附上 BAT 版本、Codex 版本（codex --version）、作業系統與安裝方式（npm / 官方 installer）。

已知事項

啟動確認只支援 Claude CLI 分頁；Codex、自訂 CLI 一律為無法判定
Claude 的 hooks 若是在專案層設定（.claude/settings.json）或公司政策中關閉，BAT 偵測不到：--wait-started 會等到期限後回 exit 8
以 server token 呼叫 helper（例如遠端 profile、測試程式）派出的分頁仍會取得焦點
Worker 分頁在你第一次切過去之前，終端尺寸維持 120x30
Control Tower 尚未使用 --wait-started（需 CT 後續版本）
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.5...v0.7.0-pre.6

v0.7.0-pre.5（2026-10-18）

版號 0.7.0-pre.5，接續 v0.7.0-pre.4。

修正

塔台派工時正在打字，Worker 會起不來：塔台派出的 Worker 分頁會取得鍵盤焦點，而 BAT 要等分頁的 shell 準備好才送出啟動指令。這段時間打進來的字會接在指令前面，Worker 啟動失敗（例如 bash: ,: command not found），塔台卻收到派工成功。現在這段時間的輸入會在啟動指令之後才送出，不會丟失（BUG-151）
Claude 用 AskUserQuestion 提問時，blocked 的原因誤報為權限確認：Claude 對提問也會送出權限請求，BAT 因此把原因從 question 改成 permission；用滑鼠回答後，blocked 也要等到該回合結束才清除。現在提問一律回報 question，用滑鼠或鍵盤回答後都會立即清除（BUG-150）

已知事項

塔台派出的 Worker 分頁仍會搶走鍵盤焦點；派工後接著打的字會進到 Worker 分頁（不再破壞啟動指令）
塔台派工時，helper 回傳成功只代表分頁已建立，不代表 Worker 已經啟動；請以 bat_get_state 確認 Worker 有沒有開始工作
blocked 偵測目前只支援 Claude CLI 分頁；Codex 分頁回 blockedDetection: "none"（後續版本）。在權限確認上用滑鼠按允許 / 拒絕時，blocked 會維持到該回合結束或你下一次鍵盤輸入
Control Tower v5.4.0 起支援 Worker 分頁關閉後查 worktree 狀態（source）；斷點 D（使用 blocked）在 Control Tower 後續版本
用量限制自動繼續（0.6.1-pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.4...v0.7.0-pre.5

v0.7.0-pre.4（2026-10-18）

版號 0.7.0-pre.4，接續 v0.7.0-pre.3。

新增

偵測 Claude 分頁卡在等人回答：Claude CLI 分頁停在權限確認、AskUserQuestion 提問或 MCP 表單（elicitation）時，BAT MCP 的 bat_get_state / bat_list_terminals / bat_wait 會回 blocked，並附原因（permission / question / elicitation）。塔台可以藉此知道 Worker 是在等人，而不是還在工作。BAT 以 Claude 的 hooks 回報，hook 不影響 Claude 的任何判斷、不送出工具參數或對話內容；與「BAT MCP」用同一個 Settings 開關（預設開）。每個分頁另回 blockedDetection（hook / none），表示這個分頁有沒有在偵測（PLAN-047）
Worker 分頁關掉之後仍可查 worktree 狀態：以 --worktree keep 回收 Worker 分頁、甚至 --worktree remove 刪掉 worktree 之後，--worktree-status T#### / bat_worktree_status 仍會回答（source 為 exited 或 git），塔台合併時不必再自己用 git 重算（PLAN-047）

修正

全新安裝的 Windows 上，塔台派出的 Claude / Codex Worker 起不來：從未在 Settings 存過任何設定時，BAT 派工以 bash 的方式替參數加引號，但分頁實際是 PowerShell，命令被拆壞，Worker 啟動即失敗。現在依分頁實際啟動的 shell 加引號（BUG-149）

更新

新增 Codex CLI 擔任塔台 / Worker 的自動化整合測試（用真的 Codex 連 BAT，不呼叫模型）；BUG-149 就是這組測試找到的

歡迎協助測試

如果你平常使用 Codex CLI，歡迎幫忙跑一次塔台 / Worker 流程（需要 BMad Control Tower）：

新開一個 Codex CLI 分頁，請它呼叫 MCP tool bat_whoami（不帶參數），確認回傳的 role 與 agent（應為 codex-cli）
在塔台分頁派一張小工單給 Codex Worker（--agent codex）
確認 Worker 完成後通知有回到塔台分頁，Worker 分頁也有被自動回收

不論成功或失敗，都歡迎到 GitHub Issues 回報，請附上 BAT 版本、Codex 版本（codex --version）、作業系統與安裝方式（npm / 官方 installer）。如果你在 ~/.codex/config.toml 改過 shell_environment_policy，也請一併註明（可能讓 Codex 執行的指令拿不到 BAT 的連線資訊）。

已知事項

blocked 偵測目前只支援 Claude CLI 分頁；Codex 分頁回 blockedDetection: "none"（後續版本）。以 --dangerously-skip-permissions 執行時不會出現權限確認；在權限確認上用滑鼠按允許 / 拒絕時，blocked 會維持到該回合結束或你下一次鍵盤輸入
blocked 的權限確認、AskUserQuestion、MCP 表單三種情況尚未在真實 Claude 互動中觸發驗證，遇到時歡迎回報
Claude 設定了 disableAllHooks 時 BAT 的 hooks 也會停用，blocked 不會出現
Control Tower 尚未使用 blocked（需 CT 後續版本）；本版其他功能沿用 Control Tower v5.3.x
用量限制自動繼續（0.6.1-pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.3...v0.7.0-pre.4

v0.7.0-pre.3（2026-10-18）

版號 0.7.0-pre.3，接續 v0.7.0-pre.2。

修正

Codex 分頁的 BAT MCP 無法連線：0.7.0-pre.2 的 Codex CLI 分頁呼叫 mcp__bat__* 一律回 CONNECT_FAILED: not running inside a BAT terminal。原因是 Codex 啟動 MCP 程式時只傳少數系統環境變數，分頁的連線資訊沒有傳下去。現在 BAT 會告訴 Codex 要轉送哪些變數（只給變數名稱，權杖不會出現在命令列或設定裡）。需要新開的 Codex 分頁才會套用（BUG-148）

更新

README「與 BMad Control Tower 協作」的版本對照表補上「唯讀查詢（MCP）」：BAT >= 0.7.0-pre.2，不需要特定 CT 版本

已知事項

Control Tower v5.3.0 已在 0.7.0-pre.2 上完成實機驗收（worktree 隔離派工、合併工單），本版沿用
Codex 分頁的 BAT MCP 修正已用 Codex 0.160.0 / 0.163.0 驗證轉送機制，實際分頁連線待本版安裝後驗證；以 npm 安裝的 codex.cmd、遠端（WSL / SSH / Docker）的 Codex 分頁未實測
Claude / Codex 面板（非終端分頁）不掛 BAT MCP；BAT MCP 開關只影響之後啟動的分頁
「偵測 Worker 停下來等回答」尚未提供（後續版本）
用量限制自動繼續（0.6.1-pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.2...v0.7.0-pre.3

v0.7.0-pre.2（2026-10-17）

版號 0.7.0-pre.2，接續 v0.7.0-pre.1。

新增

分頁內的 agent 可以直接查詢 BAT（BAT MCP）：BAT 啟動的 Claude CLI / Codex 分頁會自動掛上一組唯讀 MCP 工具（mcp__bat__*），可以查自己是誰、列出分頁、查分頁狀態（執行中 / 閒置 / 已結束）、讀取分頁輸出、等待分頁狀態改變、查 worktree 狀態。範圍依分頁權杖限制：塔台只能看自己與自己派出的 Worker，Worker 只能看自己。讀出的輸出會先遮蔽權杖、API key、私鑰等字串。設定檔不含任何權杖，也不會覆蓋你自己的 MCP 設定。可在 Settings → Advanced「BAT MCP」關閉（預設開啟）（PLAN-047）
Worker 可以在獨立的 git worktree 執行：派工加 --isolation worktree，BAT 會在 repo 外建立 .bat-worktrees/<repo>/<工單號> 與分支 ct/<工單號>，Worker 在裡面工作，主 checkout 不受影響；回收 Worker 時可選擇保留、移除或封存 worktree（--close-worker … --worktree keep|remove|archive，預設保留）。依賴套件由 Worker 自行安裝。預設不隔離，不加參數時行為與先前相同（PLAN-047）
查詢 Worker 分支的合併狀態：bat-terminal.mjs --worktree-status T#### 回報分支相對 main 的領先 / 落後、未提交的檔案、實際改動、超出工單範圍的檔案、預測的合併衝突，只讀不改（PLAN-047）

已知事項

Control Tower 要使用 worktree 隔離派工與合併工單，需等對應的 CT 版本（CT-T015 / CT-T016 進行中）；目前的 CT v5.2.4 不受影響
Codex 分頁的 BAT MCP 只驗證到設定解析，尚未實際連線驗證；以 npm 安裝的 codex.cmd 在 PowerShell 下的參數引號未實測
Claude / Codex 面板（非終端分頁）不掛 BAT MCP；BAT MCP 開關只影響之後啟動的分頁
「偵測 Worker 停下來等回答」尚未提供（後續版本）
用量限制自動繼續（0.6.1-pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.7.0-pre.1...v0.7.0-pre.2

v0.7.0-pre.1（2026-10-17）

版號 0.7.0-pre.1，接續 v0.6.1-pre.9。這版更動了終端分頁裡 helper 腳本的權限，所以升到 0.7.0。

更新

每個終端分頁改用自己專屬的權杖：本機分頁裡的 BAT_REMOTE_TOKEN 不再是可以操作整個 BAT 的全權 token，而是只屬於該分頁的 batcap. 權杖（遠端 WSL / SSH / Docker 分頁早已如此）。分頁裡的程式能透過 BAT 做的事，依分頁角色限制（PLAN-047）：
- 一般分頁與塔台分頁：可以派工（agent 模式與 raw command 模式）、回收自己派出的 Worker 分頁、設定自己的塔台角色
- 塔台派出的 Worker 分頁：只能通知 / 預填 / 送出給派出它的那個塔台
- 其他操作（讀寫檔案、改設定、寫入別的分頁等）一律拒絕
權杖在 BAT 重開後仍有效：退出 BAT 時選「不停止 Terminal Server」、重開後選「保留」，存活分頁裡的塔台與 Worker 照常可以派工、回報、回收（權杖紀錄只存雜湊，不存權杖本身）
遠端 Tower 也能用 raw command 派工（bat-terminal.mjs claude "/ct-exec T####"），規則與本機相同；建議仍以 agent 模式（--skill / --workorder）為主

修正

BAT 重開時，回答 Recovery 提示之前不再多開一個 shell：之前還原的分頁會在背景另起一個本機 shell，選「保留」後它仍在執行，輸出也混進同一個分頁。現在分頁會等你回答後才接回或建立；在提示開著時派工，BAT 最多等 2 秒，仍未回答就回報失敗（RECOVERY_PENDING），不會建立分頁（BUG-146）
Recovery 選「重新開始」後，新的 Terminal Server 不會再被當成不存在：之前舊 server 結束時會刪掉新 server 剛寫好的紀錄檔，下次啟動又另開一個（BUG-147）

已知事項

行為改變：Worker 分頁裡不能再派工、回收或設定塔台角色；也不能在一般分頁手動用 bat-notify --target 通知任意分頁。Control Tower 的正常流程不受影響，請在一般分頁（不是 Worker 分頁）啟動塔台
升級當下仍開著的舊分頁沿用舊的權杖，重開分頁後才會換成新的
Control Tower 建議搭配 v5.2.4（文件與失敗提示對齊本版；舊版 CT 仍可正常使用）
遠端 raw command 用的是遠端使用者 PATH 上的 claude，不是 BAT 內建的版本
還沒切換過去的背景分頁，裡面的程式在第一次顯示前仍以 120 欄排版；Terminal Server 意外結束後重建的分頁要等下一次調整視窗大小或重繪才會同步寬度
用量限制自動繼續（0.6.1-pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.9...v0.7.0-pre.1

v0.6.1-pre.9（2026-10-17）

版號 0.6.1-pre.9，接續 v0.6.1-pre.8。

修正

claude CLI 分頁的 Shift + 右鍵「複製」：pre.8 的修正在真實的 claude CLI 裡沒有作用，這版補上。以下兩種情況，原本 Shift + 右鍵選單只有「貼上」：
- 從別的視窗或分頁切回來的那一下就用 Shift + 拖曳選取
- 同一段文字選了第二次
現在 Shift + 拖曳選取 → Shift + 右鍵，選單都會出現「複製」，複製到的就是反白的文字。claude CLI 自己的選取是藍底反白（不按 Shift 直接拖曳時出現，放開滑鼠時 claude 已經複製到剪貼簿）；BAT 的選取是另一種顏色（BUG-144）
BAT 日誌會在每次開啟終端右鍵選單時記一行 [terminal-context-menu]，方便回報問題時判讀

已知事項

終端分頁裡的程式追蹤滑鼠時，Alt + Shift 拖曳的欄選取仍會在滑鼠移動時被清掉
還沒切換過去的背景分頁，裡面的程式在第一次顯示前仍以 120 欄排版（顯示後會自動調整）；Terminal Server 意外結束後重建的分頁也要等下一次調整視窗大小或重繪才會同步寬度
macOS 上 Shift + 右鍵時，程式仍會收到右鍵（xterm 在 macOS 以 Option 繞過滑鼠追蹤）
用量限制自動繼續（pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.8...v0.6.1-pre.9

v0.6.1-pre.8（2026-10-16）

版號 0.6.1-pre.8，接續 v0.6.1-pre.7。

修正

Shift + 右鍵可以複製選取的文字：在 claude CLI 等會追蹤滑鼠的程式分頁裡，按住 Shift 拖曳選取後再按 Shift + 右鍵，選單現在會出現「複製」，複製到的就是反白的文字。之前滑鼠一移動，選取就被清掉，選單只剩「貼上」。不按 Shift 直接拖曳時，反白是 claude CLI 自己的選取，放開滑鼠時 claude 已經複製到剪貼簿（BUG-144）
新分頁與重啟的分頁畫面寬度正確：新開、還原或按 ⏻ 重啟的分頁，分頁裡的程式有時會以 120 欄排版，比實際視窗窄，要按重繪才恢復（重啟的分頁每次都會發生）。現在分頁一建立就會同步實際寬度（BUG-145）

更新

repo 的 CHANGELOG.md / release-note.md 補齊 v0.4.3 起的各版內容
伺服器套件說明文件更正 GitHub 下載限流時的行為（遇到限流直接失敗、不重試，可改用「匯入本機 tarball…」）

已知事項

終端分頁裡的程式追蹤滑鼠時，Alt + Shift 拖曳的欄選取仍會在滑鼠移動時被清掉
還沒切換過去的背景分頁，裡面的程式在第一次顯示前仍以 120 欄排版（顯示後會自動調整）；Terminal Server 意外結束後重建的分頁也要等下一次調整視窗大小或重繪才會同步寬度
macOS 上 Shift + 右鍵時，程式仍會收到右鍵（xterm 在 macOS 以 Option 繞過滑鼠追蹤）
用量限制自動繼續（pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.7...v0.6.1-pre.8

v0.6.1-pre.7（2026-10-16）

版號 0.6.1-pre.7，接續 v0.6.1-pre.6。

修正

終端右鍵不再「貼上又跳選單」：claude CLI 等會自己處理滑鼠的程式（例如 claude CLI 右鍵直接貼上），在分頁裡按右鍵時，BAT 不再同時跳出「複製 / 貼上」選單。一般 shell 分頁照舊顯示選單。需要 BAT 選單時按 Shift + 右鍵（例如在 claude CLI 分頁以 Shift + 拖曳選取後複製）（BUG-142）
終端右鍵選單可用 Esc 關閉：選單開著、終端仍有焦點時，按 Esc 會關閉選單，這次的 Esc 不會送進分頁裡的程式（不會中斷 claude CLI）。選單沒開時 Esc 照常送出（BUG-143）

已知事項

macOS 上 Shift + 右鍵時，程式仍會收到右鍵（xterm 在 macOS 以 Option 繞過滑鼠追蹤）；claude CLI 在 macOS 不以右鍵貼上，所以不會重複動作
用量限制自動繼續（pre.6 新增）尚未在真實撞到限制時驗證，遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.6...v0.6.1-pre.7

v0.6.1-pre.6（2026-10-16）

版號 0.6.1-pre.6，接續 v0.6.1-pre.5。

新增

塔台分頁標題：分頁內執行 bat-terminal.mjs --set-role tower 後，該分頁標題會改為 <Agent 顯示名> · Tower（例 Claude CLI · Tower），與 Worker 分頁（Claude CLI · Worker · T####）一致。自己改過名的分頁會保留原名。本機與遠端（WSL / SSH）都適用。搭配 Control Tower v5.2.0 以上，/control-tower 啟動時會自動設定（PLAN-045）
塔台模式宣告：--set-role tower --mode yolo|ask|off|on，讓 BAT 知道塔台分頁目前的 auto-session 模式（PLAN-044 使用）
用量限制自動繼續（Settings → Advanced，預設關閉）：yolo 分頁（--mode yolo 派出的 Worker，以及宣告為 yolo 的塔台）撞到 5 小時用量限制時：
- Codex：在解鎖時間再加上設定的延遲（預設 2 分鐘）後，確認畫面仍停在限制訊息，就自動輸入設定的文字（預設「繼續」）並按 Enter
- Claude：Claude Code CLI 2.1.234 起會自己在解鎖後繼續，BAT 不另外輸入，只在縮圖上標示；電腦休眠跨過解鎖時間、CLI 停在「Press enter to continue」時，BAT 只補一個 Enter
- 週限制、非時間型限制（額度、預算）只標示，不自動輸入；等待期間在該分頁打字會取消；同一分頁連續自動送出最多 2 次
- 縮圖顯示 ⏳ 與預計時間，或「限制」標示（PLAN-044）

更新

Dialog 不再因點擊外部而關閉：設定、配置、工作區設定、各種確認框、About、Snippet、設定精靈、Claude / Codex 面板的視窗等，只能用 [×]、[取消] / [確認] 或 Esc 關閉，避免誤觸遮罩讓輸入到一半的內容消失。右鍵選單、下拉選單與小型 popover 照舊點外面就關（PLAN-046）
Dialog 統一支援 Esc：Esc 等同 [×] 或取消，只關最上層的 Dialog；確認框按 Esc 是取消。輸入法組字中、或 Dialog 內的選單開著時，Esc 只處理該操作。只有一個「OK」按鈕的通知視窗補上 [×]（PLAN-046）
設定精靈開著時 Esc 不作用：以前按 Esc 會連同配置面板一起關掉，精靈也被取消並還原已安裝的 server；現在只能用精靈自己的 [×] / 取消
修正：在配置面板上點刪除確認、遠端 profile 編輯或設定精靈的遮罩時，會連外層配置面板一起關掉

已知事項

塔台分頁標題需要 Control Tower v5.2.0 以上才會在 /control-tower 啟動時自動設定；舊版 Control Tower 不受影響
Dialog 開著時，Esc 不會再傳到後面的 Claude / Codex 面板（例如中斷串流），需先關閉 Dialog
用量限制的訊息格式取自 Claude Code 2.1.300 / Codex 0.160–0.162 的程式字串，尚未在真實撞到限制時驗證；Codex 的自動輸入尚未在真實 Codex 上驗證。遇到時請留意 BAT 日誌中的 [usage-limit] 紀錄
兩台 BAT 互相作為遠端時，用量限制不會自動輸入（headless bat-server 正常）
BAT 重開但 Terminal Server 仍在執行時，分頁的 yolo 記錄會遺失，需重新啟動塔台或重新派工
macOS / Linux 版本未實機驗證

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.5...v0.6.1-pre.6

v0.6.1-pre.5（2026-10-16）

版號 0.6.1-pre.5，接續 v0.6.1-pre.4。

新增

Worker 分頁標題看得出是哪張單：塔台派出的 Worker 分頁標題改為「Agent · Worker · 工單號」，例如 Claude CLI · Worker · T0553；Worker 回報後小標籤顯示 ✓。其他由外部建立的分頁改顯示 agent 名稱或命令名稱，不再是 Remote: <完整路徑>；真正由遠端 server 建立的分頁另有「遠端」小標籤。你改過名字的分頁不受影響，舊分頁重開 BAT 後也會套用新格式
遠端工具可以一鍵安裝 Node.js（透過 nvm）：遠端（WSL / SSH）工具清單中的 Node.js 改為可安裝，使用 nvm（裝在 ~/.nvm，不需 sudo）安裝最新 LTS，並可用「更新」升到新的 LTS。卡片會顯示 nvm 版本。安裝時除了 nvm 原本會改的 ~/.bashrc，也會在 bash 登入設定檔（~/.bash_profile、~/.bash_login 或 ~/.profile，取第一個存在的）加一段有標記的載入設定，讓 agent 以非互動方式執行的指令也找得到 node。已有系統 node 時保留不動。Alpine（musl）沒有官方 binary，維持安裝說明連結

修正

重跑 WSL 設定精靈升級 server 時會換 port，原本的連線設定失效（BUG-138）：現在會沿用原本的 port，並更新既有的連線設定，不再另建一個。SSH 精靈也不再重複建立連線設定
覆蓋安裝時沒有清掉舊版檔案（BUG-139）：WSL / SSH 安裝改為先解到暫存目錄再整批換入，舊版移除的套件不再殘留（實測 WSL 安裝目錄 708 → 390 MiB）
升級到一半取消，原本能用的 server 也一起被刪掉（BUG-141）：升級後若後面的步驟失敗並取消，現在會換回升級前的版本與服務設定，並重新啟動原本的 server；第一次安裝取消仍會整個移除
塔台回收 Worker 分頁時，只是切換工作區或分頁焦點就讓回收被取消（BUG-140）：終端機自動送出的訊號（焦點通知、游標位置回報等）不再被當成你在打字；在該分頁真正打字或貼上仍會取消回收

已知事項

SSH 精靈的升級與取消還原只有自動化測試，尚未在真的 SSH 主機上實測
透過 nvm 安裝的 Node.js：zsh 非互動登入（zsh -lc）仍看不到；已有 ~/.bash_profile 的環境，sh -lc 看不到（bash -lc 可以）
Worker 分頁自動回收需搭配 Control Tower v5.1.0 並開啟 worker_auto_close
安裝檔不含遠端 server bundle（自 pre.4 起）：第一次設定 WSL / SSH 遠端需要連上 GitHub，或使用「匯入本機 tarball」
包含 pre.2 的 GPU 狀態日誌（BUG-136 仍在診斷）

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.4...v0.6.1-pre.5

v0.6.1-pre.4（2026-10-16）

版號 0.6.1-pre.4，接續 v0.6.1-pre.3。

新增

安裝檔大幅縮小
- 安裝檔不再內建遠端 server bundle。第一次設定 WSL / SSH 遠端時，BAT 會從 GitHub Release（server-bundle-v<版號>）下載，下載後留在快取，之後離線也能用
- 移除重複或用不到的內容：Windows 重複的一份 Claude 執行檔、Agent SDK 內建但不會執行的 Claude 執行檔、介面已打包好的套件、其他平台的語音辨識檔案，以及 Linux 多帶的一份 arm64 server bundle
- 遠端 server bundle 本身也變小（linux-x64 約 229 → 159 MiB）
- AppImage 與 dmg 改用較高壓縮；Windows 維持一般壓縮（實測更高壓縮對 Windows 安裝檔沒有效果）
設定遠端時可以匯入本機的 server bundle：下載失敗（離線、內網）時，WSL / SSH 設定精靈會出現「匯入本機 tarball」，選 bat-server-<平台>-v<版號>.tar.gz（同目錄要有 .sha256），驗證通過後繼續安裝。也可以設定 BAT_SERVER_BUNDLE_BASE_URL 指向內部鏡像

修正

塔台回收 Worker 分頁時，Worker 剛回報完常被判定「仍在輸出」而不回收（PLAN-041 實機驗收發現）：現在 Worker 還在輸出時也會照常排程，等分頁安靜 5 秒後再關，最多再等 60 秒；延遲期間你在該分頁打字仍會取消回收
下載 server bundle 遇到暫時性連線錯誤時，判斷是否重試更準確

已知事項

本版起安裝檔不含遠端 server bundle：第一次設定 WSL / SSH 遠端需要連上 GitHub（約 160–230 MiB），或使用「匯入本機 tarball」
dmg / AppImage 改用較高壓縮後的實際大小、掛載與啟動速度，以本版 CI 產物為準，尚未在 Mac / Linux 實機確認
Worker 分頁自動回收需搭配 Control Tower v5.1.0 並開啟 worker_auto_close；Codex Worker 完成工作後的收尾時間尚未實測
包含 pre.2 的 GPU 狀態日誌（BUG-136 仍在診斷）

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.3...v0.6.1-pre.4

v0.6.1-pre.3（2026-10-15）

版號 0.6.1-pre.3，接續 v0.6.1-pre.2。

新增

塔台可以回收自己派出的 Worker 分頁（PLAN-041）
- BAT 新增 bat-terminal.mjs --close-worker T#### --notify-id <塔台分頁 id> [--delay-ms N]
- 只能關「這個塔台為這張工單派出的」Worker 分頁，關不到你自己開的分頁，也關不到別的塔台派的
- Worker 最近 5 秒內仍有輸出時不關；延遲期間 Worker 有新輸出，或你在該分頁打字，會取消這次回收
- 關閉方式與按 ✕ 相同（不清 worktree），BAT 重開後依然有效
- 遠端視窗（WSL / SSH / Docker）同樣支援
- 自動回收需搭配 Control Tower v5.1.0，並以 *config worker_auto_close done 開啟（預設關閉）。延遲由 worker_close_delay 設定，預設 10 秒。只有工單 DONE 且不 Renew 時才會回收
Worker 分頁標示與批次關閉
- Worker 分頁的標題後面會顯示工單編號；Worker 回報後變成綠色的 ✓ T####，滑鼠移上去可看到回報內容與派工的塔台
- 塔台分頁按右鍵：「關閉已回報的 Worker 分頁（N）」，關閉前會列出清單讓你確認
- Worker 分頁按右鍵：「關閉此 Worker」（等同按 ✕）
- 「已回報」包含「部分完成」與「需要協助」，批次關閉前請確認清單

修正

程序已結束的分頁按 ⏻ 重啟沒有反應（BUG-137）：現在會在同一個分頁重新開一個 shell，沿用工作區環境變數；agent 分頁會重新執行啟動命令。
Windows：關閉分頁後，agent 以背景方式啟動的子程序殘留：使用 Terminal Server（預設）時，關閉分頁、重啟分頁、退出 BAT 並停止 Terminal Server，現在都會結束整個程序樹。退出時選擇保留終端的行為不變。
塔台派工日誌的 sourceTerminalId 改為記錄派工的塔台（原本永遠是空的）。

更新

內嵌 Claude CLI：2.1.296 → 2.1.300（模型清單、價格、effort 等級皆無變動）。

已知事項

尚未在真實的 Claude / Codex Worker 上確認：Worker 閒置時如果畫面會定時重繪（例如 spinner），回收可能一直被判定為「仍在輸出」而不執行。遇到請回報。
macOS / Linux 的程序樹處理只經程式碼確認，未實機驗證。本版以單元測試與 Windows 隔離實例 e2e 驗證。
包含 pre.2 的 GPU 狀態日誌（BUG-136 仍在診斷）。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.2...v0.6.1-pre.3

v0.6.1-pre.2（2026-10-15）

版號 0.6.1-pre.2，接續 v0.6.1-pre.1。

新增

GPU 狀態日誌（協助診斷 BUG-136：macOS 上使用已久的分頁打字嚴重延遲）：debug-*.log 新增 [gpu] 開頭的紀錄。
- 啟動時記錄 GPU 型號、驅動版本，以及各項繪圖功能目前是硬體還是軟體繪圖
- GPU 行程崩潰時，記錄這是本次第幾次崩潰、崩潰當下的狀態，以及和上次紀錄相比有哪些變化
- 之後狀態有變化（例如退回軟體繪圖）也會記錄
- 只記錄，不改變任何繪圖行為

已知事項

BUG-136 的根因尚未確定，這版只是協助判斷。遇到卡頓時，請回傳：
- 最新的 debug-*.log（macOS 位於 ~/Library/Application Support/BetterAgentTerminal/Logs/）
- ~/Library/Logs/DiagnosticReports/ 裡最新的 BetterAgentTerminal Helper-*.ips
內嵌 Claude CLI 仍為 2.1.296。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.1-pre.1...v0.6.1-pre.2

v0.6.1-pre.1（2026-10-15）

版號改為 0.6.1 線，接續 v0.6.0-pre.11（內容含 pre.11 之後的修正）。

修正

終端焦點不再跳到其他工作區（BUG-135）：以下情況原本可能讓焦點指向其他工作區的終端，使 snippet 貼上、Skills / Agents 面板作用到錯的終端，現在都限定在目前的工作區：
- 獨立視窗（detached）關閉、終端交回主視窗時
- 刪除或封存目前的工作區時
- 重新載入工作區資料時
塔台派工的 Worker 分頁開在你沒在看的工作區時，不再搶走目前的焦點。Worker 分頁開在目前工作區時與先前相同。
新工作區第一次開啟時，不再短暫閃出「沒有終端」的空狀態：預設終端建立期間改顯示不透明底色，建立完成後直接顯示終端，避免剛好點到「新增終端」多開一個。遠端視窗等待重新連線期間同樣不顯示該按鈕。關閉工作區的最後一個終端時，空狀態仍會立即出現（pre.11 的修正不變）。

已知事項

本版以單元測試與 Windows 隔離實例 e2e 驗證；macOS 尚未實機驗收。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.11...v0.6.1-pre.1

v0.6.0-pre.11（2026-10-15）

修正

關閉工作區的全部終端後，畫面看起來像當機的問題已修正（BUG-134）：原本主畫面會透出其他工作區的終端畫面，點擊、輸入都沒有反應，要新增終端才會恢復。現在沒有終端的工作區會顯示空狀態與「新增終端」按鈕，切到其他工作區再切回來也一樣。
- 根因：切換走的工作區只是被隱藏，它目前所在分頁的面板仍會繪製在畫面底層；目前工作區沒有終端時，空的容器是透明的，底層畫面就透了出來，滑鼠與鍵盤則落在上層的空容器。
關閉目前焦點所在的終端後，焦點只會移到同一個工作區的其他終端；工作區已沒有終端時不再指向其他工作區的終端（影響 snippet 貼上等以焦點終端為對象的功能）。

已知事項

新工作區第一次開啟、預設終端建立完成前，可能短暫看到空狀態。
本版以單元測試與 Windows 隔離實例 e2e 驗證；macOS 尚未實機驗收。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.10...v0.6.0-pre.11

v0.6.0-pre.10（2026-10-14）

重點

工作區設定：每個工作區可各自設定預設 Agent 與啟動參數（PLAN-040）
- 工作區右鍵選單的「環境變數」改為「工作區設定…」，環境變數成為其中一區
- 預設 Agent：可選「跟隨全域設定」或任一 Agent。查找順序不變：工作區 → Settings 預設 Agent → claude-code
- 啟動參數：每個 Agent 一列，勾「覆寫」後填入此工作區專用的參數，整串取代 Settings 的全域參數（不串接）；覆寫為空白代表此工作區不帶任何參數。未勾選時沿用全域值
- 對話框會顯示目前生效的 Agent 與參數，以及來源（此工作區 / 全域設定 / 內建預設）
- 套用範圍：派工按鈕、新建 Agent 終端、塔台用 bat-terminal.mjs --agent … 派工（以 Worker 落點的工作區為準）。以完整指令派工（例如 bat-terminal.mjs codex --model …）時不另外加參數
獨立視窗（detached）按「開啟設定」改為在主視窗開啟 Settings（BUG-133）：原本按了沒有反應。主視窗被最小化或縮到系統匣時會一併叫回；找不到主視窗時顯示提示。

已知事項

獨立視窗中的工作區設定只能查看，請在主視窗修改。
工作區設定與 Settings 的 Agent 下拉選單都不會列出自訂 CLI。
遠端（WSL / SSH / Docker）profile 的塔台經遠端伺服器派工時，沒有工作區層級設定，仍使用遠端伺服器的全域設定。
本版以單元測試與 Windows 隔離實例 e2e 驗證；新的工作區設定對話框尚未實機驗收，macOS 尚未實機驗收。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.9...v0.6.0-pre.10

v0.6.0-pre.9（2026-10-14）

重點

塔台派工的 cwd 檢查（BUG-132）：bat-terminal.mjs 派工時，會比對派工目錄（--cwd）與 Worker 分頁落點工作區的資料夾：
- 派工目錄不屬於任何工作區（例如跨專案派工）→ 照常建立，印出警告
- 派工目錄屬於另一個工作區 → 照常建立並警告；若帶 --mode yolo 則拒絕派工（exit 1，錯誤碼 DISPATCH_CWD_OTHER_WORKSPACE），訊息列出兩個工作區
- 背景：某些 agent CLI（目前觀察到 Codex）會沿用另一個分頁保存下來的環境，$BAT_TERMINAL_ID / $BAT_WORKSPACE_ID 指向別的工作區，導致 Worker 開在別的工作區、完成通知送進別的專案塔台。這個檢查讓這種情況被看見，yolo 下直接擋下
- 路徑比對在 Windows / macOS 不分大小寫，也會比對 symlink 解開後的實際路徑（iCloud / 雲端硬碟資料夾）
--agent 簡寫：--agent codex / --agent claude 會對應到 codex-cli / claude-cli；不認得的 agent id 會列出可用的 id（原本只顯示 terminal-not-created）。

已知事項

遠端（WSL / SSH / Docker）profile 的派工尚未做 cwd 檢查。
若刻意以 --mode yolo 把 Worker 派到另一個工作區的資料夾，會被擋下；不帶 --mode yolo 即可建立（附警告）。
工作區層級的預設 Agent 設定入口仍未提供（PLAN-040）；要讓 --agent default 開 Codex，請在 Settings 把預設 Agent 設為 Codex，或派工時帶 --agent codex。

macOS 仍只提供 Apple Silicon（arm64）版。本版改動以單元測試與 Windows 隔離實例 e2e 驗證，macOS 尚未實機驗收。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.8...v0.6.0-pre.9

v0.6.0-pre.8（2026-10-14）

重點

終端貼上統一規則（Windows / macOS / Linux）：Ctrl+V、macOS 的 Command+V、右鍵選單「貼上」都依剪貼簿內容決定（BUG-128 / BUG-130）：
- 檔案（Finder / 檔案總管拷貝）→ 貼上完整路徑，有空白或特殊字元時自動加引號，與拖放檔案相同；macOS 支援多檔
- 圖片 → 送 claude CLI 的貼圖鍵（Windows 為 Alt+V，macOS / Linux 為 Ctrl+V），在終端執行的 claude 可直接貼圖
- 文字 → 一般貼上
- 剪貼簿同時有圖片與文字時（例如從 Excel 複製儲存格）視為圖片；要貼文字請用 Ctrl+Shift+V
- 每次判斷都寫入 debug log（搜尋 [terminal-paste]），貼圖偶發失效時可據此回報
macOS：Finder 拷貝後 Command+V 貼不出東西的問題已修正（BUG-128）。Claude / Codex 面板也能用 Command+V 把 Finder 拷貝的檔案加為附件。
塔台派工落點（BUG-129）：bat-terminal.mjs 派工時，Worker 分頁改開在「下指令的塔台分頁目前所在的工作區」，--agent default 也依該工作區解析；與 --workspace 不一致時寫入警告。派工成功後會多印 workspace: / agent: 兩行實際落點，方便核對。

修正

指揮塔面板：切換工作區時不再把既有工單當成「新工單」或「已完成」跳出整排提示；同一工作區內的新增與狀態變更照常通知。提示框改為不透明底色，不再與底下面板文字重疊（BUG-127）。
分頁按 ↺ 重新啟動、或 Terminal Server 當掉後自動重建時，保留原本的環境變數（工作區 / 全域環境變數、Worker 回報塔台所需的變數），連線資訊取當下的值（BUG-131）。

已知事項

--agent default 的查找順序：工作區預設 → Settings 預設 Agent → claude-code。目前還沒有工作區層級的設定入口（預計下一批補上，PLAN-040），要讓派工開 Codex，請在 Settings 把預設 Agent 設為 Codex，或派工時帶 --agent codex。
Windows 終端貼圖偶發失效的原因尚未重現，本版改由主程序判斷剪貼簿並加上 log。
macOS 的修正以單元測試驗證，實機驗收進行中。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.7...v0.6.0-pre.8

v0.6.0-pre.7（2026-10-14）

重點

配置（Profile）對話框的遠端狀態燈改為反映本機實際連線。之前 WSL / SSH / Docker profile 的燈號永遠是紅燈「Disconnected」，即使該 profile 的視窗開著、連線正常（BUG-123）。現在分為：
- 🟢 已連線：本機持有此 profile 的連線
- 🟡 連線中 / 重新連線中
- 🔴 連線中斷或連線失敗，滑鼠移上去會顯示原因
- ⚪ 未開視窗
- 提示文字三語；對話框開著時，連線 / 斷線會即時更新。
- 指向另一台完整 BAT 的舊式 remote profile：綠燈改為「本機已連上」才亮；遠端機器上該 profile 使用中但本機未連線時顯示 ⚪ 並註明。
SSH 設定精靈：目標主機的 sshd 不允許 port forwarding（AllowTcpForwarding no）時，改為直接說明這個原因並建議修改 sshd 設定，不再顯示成「伺服器埠上的程式沒有提供 TLS 憑證」（BUG-124）。

修正

Claude 面板的指令清單：.claude/commands/*.md 帶 YAML frontmatter 時，描述改讀 description:，不再顯示成 ---（BUG-125）。
skill 的 frontmatter 沒有 description: 時，描述改為 frontmatter 之後的第一行，不再是空白（BUG-126）。

已驗收（pre.6 自動化實機驗收）

以已安裝的 pre.6 搭配容器化的 SSH 主機與遠端 server，自動化驗收並結案 18 張既有修正，包括：SSH 精靈安裝 / 啟動 / 指紋 / 停止與移除 / 取消時 rollback、ProxyJump alias，遠端視窗斷線時不改在本機執行、detach 視窗、遠端重連帶指紋、/snippet、本機 snapshot 打包、Linux AppImage 內嵌 claude。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.6...v0.6.0-pre.7

v0.6.0-pre.6（2026-10-14）

重點

SSH 設定精靈終於能在 Linux 主機上裝好並啟動 server。自 v0.4.1 起，SSH 精靈的「安裝 server bundle」與「啟動 server」兩步都有缺陷，任何版本都無法在 Linux 目標完成（macOS 目標推定相同）。pre.5 release notes 所說的 alias 支援本身是對的，但被這兩個缺陷擋住，本版一併修正：
- 上傳的 bundle 多解了一層 staging/，服務找不到執行檔（BUG-120）。
- 服務以錯誤的設定名稱傳 port，server 改聽 54321，精靈的啟動檢查因此失敗（BUG-121）。
- 若 pre.5 曾在某台主機留下 ~/.local/bat-server/staging/，用 pre.6 重跑精靈即會自動清除並裝成正確佈局；重跑時也會重新啟動已在跑的舊服務。
配置（Profile）對話框加寬：remote 卡片展開後不再只用右半邊；「遠端 AI 工具」改為卡片排列，寬視窗可並排多欄，窄視窗自動縮回（BUG-122）。

修正

SSH 精靈認證失敗（permission-denied）時，現在會顯示「修改 SSH 設定」並回到主機設定步驟。

已驗收（pre.5 實機）

本機派工 helper 遺失分頁（BUG-114）與設定 / 日誌目錄統一（BUG-119）已在 pre.5 實機驗收後結案；升版後既有遠端 client 不需重新配對。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.5...v0.6.0-pre.6

v0.6.0-pre.5（2026-10-14）

重點

SSH 設定精靈：選 ~/.ssh/config 的 alias 現在可以完整走完（使用者 / Port / IdentityFile / ProxyJump 由 ssh config 決定）；也可以手動輸入 user@host:port。
內嵌 Claude Code CLI 升級到 2.1.296，新增 Haiku 5.5 模型。
Cache History 成本修正：總計不再重複加總（先前可能高估 45%–77%），Haiku 5.5 依每次呼叫的 prompt 長度分段計價，Sonnet 5.5 cache read 改為官方 0.05x。

修正

自訂 CLI Agents（Settings → Custom CLI Agents）的新增 / 移除先前從未寫入磁碟，重啟後會消失 —— 已修正。
本機派工 helper（bat-terminal）偶爾把其他分頁的輸出誤判為「分頁已建立」，造成派工遺失（BUG-114）；連線被拒時改為立即顯示原因，不再等到逾時。
detached workspace 視窗內新增 / 關閉 / 改名的終端，會正確存回原視窗；關閉視窗前會先存檔。
設定精靈：跳回前面步驟時會回收本次建立的資源，且可以真的重新修改設定；「Use existing」但沒有容器時重試不再卡住；錯誤畫面改為依介面語言顯示。
remote profile 連線失敗對話框改為依介面語言顯示（英 / 繁中 / 簡中）。
同時建立多個 remote profile 時可能出錯或遺失資料 —— 改為依序寫入。
remote server 自簽憑證的有效期改為實際 10 年（先前誤為 365 天；用戶端以指紋驗證，既有連線不受影響）。
啟動早期就崩潰的情況現在也會寫入日誌，方便回報問題。
本機以 snapshot 版號打包時下載 server bundle baseline 會失敗（BUG-115）。

打包與相依

移除未使用的 better-sqlite3，sharp / @img 不再打包進安裝檔與 server bundle（安裝檔與 server bundle 變小）。
server bundle 不再含指向建置機路徑的 symlink；macOS server bundle 最低需求 macOS 13.5。
CI：新增型別檢查關卡；GitHub Actions 升級到原生 Node 24 版本；Linux runner 固定 ubuntu-24.04，server bundle 的 macOS runner 改為 macos-15。

macOS 仍只提供 Apple Silicon（arm64）版。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.4...v0.6.0-pre.5

v0.6.0-pre.4（2026-10-13）

⚠️ 資料目錄統一（升級前請先關閉舊版）

先前版本的資料分散在兩個目錄：設定在 BetterAgentTerminal/，日誌、Crashes、snippets 在 better-agent-terminal/（BUG-119）。自本版起統一為：

平台	資料目錄
Windows	`%APPDATA%\BetterAgentTerminal\`
macOS	`~/Library/Application Support/BetterAgentTerminal/`
Linux	`~/.config/BetterAgentTerminal/`

日誌改寫到 <資料目錄>/Logs/。

首次啟動時自動搬移（只執行一次，一律複製、不刪除舊目錄）：

Local State（遠端存取權杖的加密金鑰），讓既有的遠端配對繼續有效
snippets.json：新目錄沒有就複製，兩邊都有就合併，合併前會先備份
message-archives/
--runtime=<N> 實例：整個 better-agent-terminal-runtime-<N> 目錄改名為 BetterAgentTerminal-runtime-<N>

請注意：

舊的 better-agent-terminal/ 會保留、不會自動清除，以前的日誌仍在那裡
--runtime=<N> 實例的 snippets 改為各自一份，不再共用預設實例的 snippets
不要同時執行新舊兩個版本：兩者的單一實例鎖在不同目錄，會同時寫入設定
降回舊版時，設定與遠端權杖可沿用；在新版建立的 snippets 舊版看不到
若升級後遠端 client 需要重新配對，或日誌開頭出現 [userdata-migration] 的錯誤，請回報（附 Logs/ 內最新的日誌）

修正

啟動時忽略 Settings 中的日誌開關與等級（同 BUG-119 根因），已修正
終端分頁內的 helper（bat-terminal / bat-notify）在 --runtime=<N> 實例中會找錯憑證，改為依實際資料目錄解析

其他

macOS 仍只提供 Apple Silicon（arm64）版，不支援 Intel Mac（自 v0.6.0-pre.3 起）
README 更新：版本 badge、技術堆疊、發行流程、資料與日誌路徑

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.3...v0.6.0-pre.4

v0.6.0-pre.3（2026-10-13）

⚠️ 不再支援 Intel Mac

自 v0.6.0-pre.3 起，macOS 只提供 Apple Silicon（arm64） 版：BetterAgentTerminal-0.6.0-pre.3-arm64.dmg。先前的 Intel（x64）dmg 內含的內嵌 claude / codex / node-pty / 語音元件實際上都是 arm64，在 Intel Mac 上無法使用，因此停發（BUG-117 / D136）。

修正

macOS 啟動即崩潰（BUG-116）：語音模組 @kutalia/whisper-node-addon 的 binary 目錄命名與套件內部尋找的路徑不一致，載入失敗導致 app 無法開啟。改為延遲載入並相容兩種目錄名；語音模組不可用時只影響語音輸入，不再拖垮整個 app。
macOS / Linux 打包版缺內嵌 claude（BUG-118）：打包時非 Windows 平台會排除 .exe，內嵌 claude 指向的檔案不存在。改用隨套件打包的平台專用 binary；找不到時顯示列出搜尋路徑的明確錯誤。
簡繁轉換（opencc）改為使用時才載入，縮短啟動時間。

打包與建置

CI 在 macOS / Linux 打包後檢查產物：所有原生 binary 的架構、內嵌 claude 是否存在且架構正確、語音模組 binary 是否存在。
package.json 新增 allowScripts，支援 npm 12 預設阻擋相依套件 install scripts 的行為；postinstall 改以 @electron/rebuild 建置 Electron ABI 的 better-sqlite3。

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.2...v0.6.0-pre.3

v0.6.0-pre.2（2026-10-05）

（依 commit 整理；GitHub Release 只有自動產生的內容）

新增

可同時連線多個遠端 profile（PLAN-039）：每個 profile 各自持有連線，最多 8 個；最後一個視窗關閉 15 秒後才斷線（T0462–T0466）
遠端塔台派工與 Worker 回報（PLAN-036）：遠端視窗的塔台可用 bat-terminal.mjs 派工、Worker 可用 bat-notify.mjs 回報；遠端 server 為每個 PTY 簽發範圍權杖，helper 隨 server bundle 安裝（T0431–T0434、T0447–T0451、T0456）
遠端視窗新增「複製遠端路徑」（T0438）
拖放檔案到終端時插入加引號的路徑（T0439）
在遠端視窗的 prompt 輸入本機路徑時提示（T0440）
遠端 PTY 達上限時顯示提示，不再是空白終端（T0424）

修正

開啟外部連結 / 檔案的安全限制：只開 http(s)、執行檔需確認、每個視窗都有導覽保護（BUG-105，T0457 / T0458 / T0460 / T0461）
遠端連線：重連沿用已釘選的 client 與指紋、連線成功才替換、載入失敗時釋放（BUG-096，T0419 / T0430 / T0442）
Docker：主機埠只綁 127.0.0.1，偵測舊版對外開放的容器（BUG-097，T0418 / T0427 / T0428）
設定精靈：取消時回收失敗的步驟、只回收本次建立的資源、Docker 重試重新啟動本次建立的容器（BUG-099 / BUG-100 / BUG-111，T0426 / T0444 / T0452）
拖放檔案路徑、Claude 面板圖片附件、/snippet 提示（BUG-107 / BUG-108 / BUG-109，T0435 / T0436 / T0441）
遠端視窗未連線時不改在本機執行（BUG-110，T0443）
detached 工作區視窗綁定父視窗的 profile、讀取父視窗的工作區資料（BUG-112 / BUG-113，T0446 / T0453）
client 心跳檢查 pong、SSH tunnel 本機埠衝突時重試一次（T0455 / T0465）

更新

SSH 設定精靈只保留 tunnel 模式（BUG-098，T0425）
移除未使用的 worktree:merge 通道（BUG-106，T0417）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.6.0-pre.1...v0.6.0-pre.2

v0.6.0-pre.1（2026-10-05）

（依 commit 整理；GitHub Release 只有自動產生的內容）

新增

遠端視窗功能補齊（PLAN-036）：WSL / SSH / Docker 遠端視窗的終端、Claude 面板、Git / GitHub / worktree、檔案與圖片功能改由遠端 server 處理（T0388–T0406）
遠端 AI 工具偵測與安裝（PLAN-037）：遠端工具面板列出 claude / codex 等工具的安裝狀態，可在遠端視窗內一鍵安裝，設定精靈完成頁與配置卡片都有入口（T0408–T0415）
Claude 面板未登入時顯示登入引導（T0402）
終端重新連上時重播先前的輸出，不重新啟動 agent（T0403）
遠端視窗的 shell 清單依遠端作業系統列出，WSL 工作區預設資料夾（T0393）
遠端 server 回收無人使用的 PTY 並設上限（BUG-103，T0404）

修正

WSL 設定精靈：沒有 distro 被誤判為沒裝 WSL、linger 使用者與 unit 路徑、重試時不再 rollback、網路模式偵測、server port 避開本機 RemoteServer、TLS 指紋擷取逾時、每個 distro 保持一條 wsl.exe 連線（BUG-086 / 087 / 089 / 090 / 091 / 092，T0378–T0384）
SSH 設定精靈：服務設定檔與 bundle 上傳改用絕對路徑、經 tunnel 驗證遠端 server（BUG-088 / BUG-093，T0379 / T0387）
遠端 server 缺少 profile / settings 處理、連線失敗原因分類（BUG-094，T0385）
Claude 面板的中斷在遠端視窗無效（BUG-095，T0392）
Terminal Server 重啟後舊 PTY 的結束事件誤關新分頁（BUG-101，T0394）
Linux 不再強制使用 en_US.UTF-8 locale（BUG-102，T0398）
遠端安裝 codex 不再卡在互動提示（BUG-104，T0415）
遠端視窗的路徑參數改依遠端主機解析（BUG-105，T0416）
以系統管理員身分執行 BAT 時不自動啟動 codex daemon（BUG-085，T0377）
本機打包的版號改以 package.json 為準（T0376）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.9-pre.4...v0.6.0-pre.1

v0.5.9-pre.4（2026-10-04）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

內嵌 Claude Code CLI 升級到 2.1.289，支援 Claude 5 模型（claude-opus-5-5、claude-fable-5-1、claude-sonnet-5-5）；舊版內嵌 CLI 會被服務端拒絕（BUG-084，T0371）
Claude 面板遇到「CLI 版本太舊」的模型錯誤時附上說明與解法；內嵌 runtime 禁止 claude update；system runtime 的健康門檻提高到 2.1.280（BUG-084，T0372）
Cache History 成本可計算 Claude 5 模型，並使用各模型的 cache read 費率（BUG-084，T0374）
Codex 面板不再把設定檔警告與連線重試顯示為錯誤；設定檔版本不符、模型需要較新 Codex 時附上說明（BUG-083，T0367 / T0370）

更新

內嵌 Codex SDK 升級到 0.160，相容新的 binary 目錄佈局（BUG-083，T0369）
Codex 模型清單改讀 Codex CLI 的 models_cache.json，新增 max / ultra effort，只列出所選模型支援的等級（BUG-083，T0370）
BAT 改用找得到的最新版 Codex CLI（內嵌、官方安裝、Codex Desktop App、PATH），每個 session 顯示使用的版本；切換模型時自動修正不支援的 effort（BUG-083，T0373）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.9-pre.3...v0.5.9-pre.4

v0.5.9-pre.3（2026-10-04）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

設定精靈的 server bundle 下載來源改為本 fork（gowerlin），desktop 發佈時同時發佈 server-bundle-v<版號>，先前安裝檔未內建的架構一律下載失敗（BUG-071，T0365，D120）

更新

移除 PTY 寫入路徑上的除錯輸出（T0363）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.9-pre.2...v0.5.9-pre.3

v0.5.9-pre.2（2026-09-02）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

派工 prompt 依目標 shell（POSIX / PowerShell / cmd）加引號，prompt 含 ' 時在 PowerShell 不再出錯（T0362，PR #19）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.9-pre.1...v0.5.9-pre.2

v0.5.9-pre.1（2026-09-01）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

工單編號規則統一為 ^(?:[A-Z]{2,4}-)?T\d+$：跨專案 / 委派工單（例 CP-T0113、CT-T001）可以用 --skill + --workorder 派工，指揮塔面板也不再忽略 CT-T#### 工單（BUG-082，T0360）
工單 frontmatter 遷移腳本使用同一套編號規則（T0361）

更新

bat-terminal.mjs 沒帶 --workspace 時提示改用 --workspace "$BAT_WORKSPACE_ID"（T0360）
外部建立的終端找不到指定工作區時寫入日誌，方便追查落點（T0361）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.8...v0.5.9-pre.1

v0.5.8（2026-05-24）

（依 commit 整理；GitHub Release 只有自動產生的內容）

這段期間 tag 為 v0.5.x，package.json 版號仍為 0.4.1 / 0.4.2（安裝檔版號由 CI 依 tag 決定）；CHANGELOG 的 [0.4.2] 段所列內容實際分散在 v0.5.0-pre.2–v0.5.8 發佈。

修正

指揮塔可解析首字大寫的 bug tracker 區段標題

更新

package.json 版號同步為 0.4.2

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.7...v0.5.8

v0.5.7（2026-05-23）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

指揮塔支援 ABANDONED 工單狀態，視為已結束（T0359，CP-T1148）

更新

以 Claude 塔台實測 yolo 模式的 --submit（BUG-081，T0358）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.6...v0.5.7

v0.5.6（2026-05-17）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

bat-notify --submit 在預填文字之後延遲送出 Enter，避免 yolo 模式送出時文字還沒寫完（BUG-081，T0357）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.5...v0.5.6

v0.5.5（2026-05-17）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

bat-notify --submit 的 Enter 改經視窗內的鍵盤事件送出

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.4...v0.5.5

v0.5.4（2026-05-17）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

bat-notify --submit 改以按鍵（keypress）方式送出 Enter

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.3...v0.5.4

v0.5.3（2026-05-15）

（依 commit 整理；GitHub Release 自動產生的內容只列出 PR #18）

修正

遠端 claude-cli 派工會套用 Settings 的 claudeRuntime.customPath（PR #18，@RicoChen727）
claudeRuntime.customPath 含 shell 特殊字元時拒絕使用（T0355，BUG-080）
claude-cli 啟動命令依目標 shell 加引號（T0356，BUG-080）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.2...v0.5.3

v0.5.2（2026-05-15）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

GitHub 面板找不到 gh CLI 的問題：改為解析 gh 的實際路徑（BUG-079，T0352 / T0353）

更新

GitHub 面板補齊簡體中文翻譯

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.1...v0.5.2

v0.5.1（2026-05-07）

（依 commit 整理；GitHub Release 只有自動產生的內容）

修正

bat-terminal.mjs 以 --skill --workorder 派工時，「Terminal created」訊息不再印出 null（T0110，BUG-020）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.5.0-pre.2...v0.5.1

v0.5.0-pre.2（2026-04-28）

（依 commit 整理；GitHub Release 只有自動產生的內容）

這段期間 tag 為 v0.5.x，package.json 版號仍為 0.4.1 / 0.4.2（安裝檔版號由 CI 依 tag 決定）；CHANGELOG 的 [0.4.2] 段所列內容實際分散在 v0.5.0-pre.2–v0.5.8 發佈。

新增

設定精靈錯誤處理全面整修（PLAN-032）：等待輸入的步驟改為中性的「等待輸入」狀態、錯誤改顯示有標題與說明的面板並提供對應的恢復動作、步驟前置檢查（T0330–T0341；細節見 CHANGELOG [0.4.2] 段）
指揮塔面板改為優先讀取工單 / BUG / PLAN 的 YAML frontmatter（PLAN-034，T0344–T0346）；狀態無法辨識時標示為無效，不再誤顯示為 PENDING（BUG-077）

修正

設定精靈：WSL linger / systemd 失敗、Docker daemon 未啟動、SSH 主機設定步驟一開始就顯示失敗、錯誤碼在畫面上遺失（BUG-072 / BUG-073 / BUG-074 / BUG-076，T0335–T0339）
指揮塔 drift 紀錄移到主程序寫入（BUG-078，T0348）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.4.3...v0.5.0-pre.2

v0.4.3（2026-04-27）

（依 commit 整理；GitHub Release 只有自動產生的內容）

新增

設定精靈改版（PLAN-030）：WSL / Docker / SSH 設定精靈改為垂直步驟列（stepper），步驟與說明左右兩欄並排、各自捲動，對話框加寬（T0307、T0309、T0311、T0312）
配置（Profile）進階類型改為分類下拉選單（BUG-070，T0306）
遠端 server bundle 發佈機制（PLAN-031）：安裝檔依平台內建 server bundle baseline，缺少的架構改從 GitHub Release 下載並以 SHA-256 manifest 驗證；精靈自動偵測遠端架構，WSL / SSH / Docker 的「安裝 server bundle」步驟改用同一套分發流程（T0313–T0327）

修正

塔台派工的 shell 偏好與 MSYS 路徑改寫回歸（BUG-075）：Worker prompt 帶 MSYS_NO_PATHCONV，避免 Git Bash 把參數中的路徑改寫；派工流程不再綁定特定 agent（T0329 研究，修正 T0341 / T0343）

更新

前端單元測試改用 vitest + jsdom + React Testing Library（T0307b）
server bundle 建置 workflow 支援多平台並產生 manifest（T0315）

Full Changelog: https://github.com/gowerlin/better-agent-terminal/compare/v0.4.2...v0.4.3

上游歷史（tony1223/better-agent-terminal v2.1.x）

v2.1.6

New Features

Keyboard Shortcuts (#68)

Ctrl+`` / `Cmd+ ` ``: Toggle between Agent terminal and first regular terminal (press again to switch back)
Ctrl+←/→ / Cmd+←/→: Cycle workspace tabs (Terminal → Files → Git)
Ctrl+↑/↓ / Cmd+↑/↓: Switch to previous / next workspace (wraps around)

v2.1.5

Bug Fixes

Model selector: No longer shows "No models available" — models are now fetched on-demand when the selector opens, without requiring an active session
Model switching: Switching models no longer clears the message input box (#65)

v2.1.4

New Features

Cross-Window Workspace Drag-and-Drop

Drag workspaces between different windows in the sidebar
Drop position is respected — inserts at the exact target slot
No session rebuild needed — pure registry re-index

Firefox Session Key Support

Usage polling now supports Firefox cookies as a session key source (Chrome → Firefox → OAuth fallback chain)
Cross-platform: macOS, Windows (%APPDATA%), Linux (standard + Snap + Flatpak)
Reads profiles.ini to resolve the correct default profile
EBUSY handling: if Firefox is running and DB is locked, returns stale cache for 10 min

Usage Polling Improvements

Cumulative backoff: 60s × 2^streak (streak capped at 3 → max 480s) for consecutive rate limits
refreshUsageNow() is blocked during rate-limit backoff to prevent hammering
localStorage cache: usage data persists across app restarts; expired windows are cleared on load
Stale indicator: 10 min without fresh data marks the 5h usage as stale (dimmed)

5h Pacing Indicator

usage5h statusline item now shows ▼ (on pace) or ▲ (over pace) based on utilization vs time elapsed
Tooltip shows time elapsed % and estimated minutes to limit

Context % Dynamic Color

ctx X% statusline item now colors dynamically: green (≤50%) / yellow (≥50%) / red (≥80%)
User-configured statusline color for contextPct is ignored — dynamic color always wins

PDF Preview

Click .pdf file paths in Agent chat to open preview in right sidebar using Chromium's built-in viewer (#60, @handpower)

Simplified Chinese Locale

Added 简体中文 (Simplified Chinese) language support

Multi-Window Enhancements

Window index shown in profile badge (e.g. Default:1, Default:2)
Closing an empty-workspace window skips confirmation dialog — removed silently
Single instance lock with workspace save-to-snapshot on second launch attempt

Bug Fixes

Fixed stale/wrong-account Chrome session key returning 0% usage after account switch
Fixed getSupportedModels failing when no active session exists
Fixed image resize error (sharp module not found in packaged app) — native binaries now unpacked from asar
Fixed sharp platform-specific deps causing EBADPLATFORM on ARM64 CI runners
Fixed markdown loose list item extra spacing
Fixed cross-window workspace drop inserting at wrong position

v2.1.3

New Features

Profile Workspace Isolation

New profile opened in a new window now starts with empty workspace list (previously showed old profile's workspaces)

Drag-and-Drop Workspace

Drag folders from Finder/Explorer directly onto the sidebar workspace list to add them
Supports multiple folders at once
Visual feedback with dashed blue outline during drag

Native Create Folder in Add Workspace

Folder picker now natively supports creating new folders (macOS "New Folder" button / Windows native support)
Simplified from split button back to single "Add Workspace" button

Bug Fixes

Fixed extra line breaks in markdown preview (breaks: false for GFM standard behavior)
Fixed fs.readFile error handling in MarkdownPreviewPanel (#51, @Owen0857)

v2.1.2

New Features

Skills Panel

Right sidebar new "Skills" tab (alongside Snippets) showing available slash commands
Split into Custom (user-defined .claude/commands/) and Built-in (system) sections with separator
Click any skill to insert /command into Agent chat input
Auto-loads from SDK supportedCommands() with 3s retry for fresh sessions
Only visible for Claude Code terminals
Filesystem scan reads project-level and global .claude/commands/*.md

Markdown Preview Panel

Click .md file paths in Agent chat to open live preview in right sidebar
Auto-updates on file changes via fs.watch
Header with filename, copy path, open file, and close buttons
Reuses existing markdown pipeline (marked + DOMPurify + highlight.js + mermaid)

Added "Copy Path" option to right-click workspace menu

Community Contributions

@Owen0857: Collapse output for read-only tools (Read, Glob, Grep, LS) (#42)
@Owen0857: Usage polling rate-limit backoff fix (#44)
@Owen0857: SDK plugin loading support (#40)
@handpower: File URL parsing fix (#41)
@handpower: Markdown rendering in Agent chat panel (#39)

v2.1.1

New Features

Default Model & Effort Settings

New settings: Default Model (text input) and Default Effort Level (dropdown)
Applied to new Agent sessions automatically
Default effort changed from high to medium
Removed max effort from UI (SDK still accepts it for Opus 4.6)

Enable 1M Context Toggle

New checkbox in Settings to enable/disable 1M token context window
Default: enabled (1M is GA for Opus 4.6 / Sonnet 4.6)

Improvements

Statusline

ctx% now uses per-turn usage.input_tokens (actual context size) instead of cumulative total
- Previously showed misleading values like "ctx 184%" after many turns
- Tooltip shows both current context and total consumption
maxOut statusline item shows max output tokens (e.g. maxOut:64k)
- Default hidden, enable in statusline settings
last_tool_name shown in active tasks bar (e.g. Searching codebase [Grep])

Input

Agent input textarea auto-grows up to ~8 lines as you type
Shrinks back to 1 line on clear/send

SDK & Token Counting

Updated claude-agent-sdk to 0.2.81 and claude-code to 2.1.81
Fixed token counting to include cache tokens (cacheRead + cacheCreate)
Removed blink animation from task elapsed time display

Bug Fixes

Fixed usage polling rate-limit backoff (use retryAfterSec directly)
Support file:// URLs in LinkedText
Restored original 2min usage polling (SDK rate_limits lacks 7d data)

Release Notes — Better Agent Terminal（gowerlin fork） ​

v0.7.5-pre.1（2026-11-05） ​

新增 ​

修正 ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.9（2026-11-04） ​

新增 ​

修正 ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.8（2026-11-04） ​

修正 ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.7（2026-11-04） ​

新增 ​

修正 ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.6（2026-11-04） ​

新增 ​

修正 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.5（2026-11-04） ​

新增 ​

修正 ​

待驗收（請更新到本版後協助確認） ​

歡迎協助測試 ​

已知事項 ​

v0.7.4-pre.4（2026-11-03） ​

修正 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.3（2026-11-03） ​

新增 ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.2（2026-11-03） ​

修正 ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.4-pre.1（2026-11-03） ​

更新 ​

已驗收 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.3-pre.9（2026-11-02） ​

修正 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.3-pre.8（2026-11-02） ​

修正 ​

待驗收（請更新到本版後協助確認） ​

歡迎協助測試 ​

已知事項 ​

v0.7.3-pre.7（2026-11-02） ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.3-pre.6（2026-11-02） ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.3-pre.5（2026-11-02） ​

修正 ​

更新 ​

待驗收（請更新到本版後協助確認） ​

已知事項 ​

v0.7.3-pre.4（2026-11-01） ​

新增 ​

修正 ​

待驗收（請更新到本版後協助確認） ​

Release Notes — Better Agent Terminal（gowerlin fork）

v0.7.5-pre.1（2026-11-05）

新增

修正

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.9（2026-11-04）

新增

修正

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.8（2026-11-04）

修正

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.7（2026-11-04）

新增

修正

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.6（2026-11-04）

新增

修正

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.5（2026-11-04）

新增

修正

待驗收（請更新到本版後協助確認）

歡迎協助測試

已知事項

v0.7.4-pre.4（2026-11-03）

修正

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.3（2026-11-03）

新增

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.2（2026-11-03）

修正

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.4-pre.1（2026-11-03）

更新

已驗收

待驗收（請更新到本版後協助確認）

已知事項

v0.7.3-pre.9（2026-11-02）

修正

待驗收（請更新到本版後協助確認）

已知事項

v0.7.3-pre.8（2026-11-02）

修正

待驗收（請更新到本版後協助確認）

歡迎協助測試

已知事項

v0.7.3-pre.7（2026-11-02）

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.3-pre.6（2026-11-02）

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.3-pre.5（2026-11-02）

修正

更新

待驗收（請更新到本版後協助確認）

已知事項

v0.7.3-pre.4（2026-11-01）

新增

修正

待驗收（請更新到本版後協助確認）