# 智慧體中心

智慧體中心會把你所有連線中的 Claude Code 與 Codex 工作階段 —— tmux 視窗、
窗格和原始工作階段 —— 收攏到同一個頁面上，讓你不必到處找對的窗格就能回覆它們
的提示。它是 **實驗性功能**，預設關閉：請在
**設定 → 實驗性功能 → 智慧體中心** 啟用。之後關閉並不會解除安裝主機掛鉤。

從側邊欄的 **智慧體** 項目開啟它（在 iPhone 上是在工作階段標籤的選擇器後面 ——
當有智慧體需要你時，該標籤會出現標記），也可以用 **⌘⇧A**，或是在有智慧體等待
時出現在頂欄的關注按鈕。當某個智慧體正在聚焦的窗格中等待時，
[滑動板](https://bambouville.com/docs/zh-hant/swipe-pad/#即時智慧體選項)也會把它的選項以花瓣形式呈現出來。

## 智慧體頁面

卡片會依狀態分組 —— **等待輸入**、**剛剛完成**、**工作中**、**閒置**、
**狀態無法使用** —— 上方是一行摘要
（「N 個智慧體 · N 個工作階段 · N 台主機」）以及
「有智慧體需要處理／全部已處理」橫幅。

每張卡片會顯示該智慧體目前的提示。從卡片上你可以：

- 按 **⇥** 在卡片之間移動，按 **1**–**9** 選擇編號選項，
- **⌘↩ 打開** —— 直接跳到那個窗格，
- 在訊息欄位中輸入 —— 「傳訊息給 \<名稱\>…」會排入佇列，
  「向 \<名稱\> 提問…」則立即送出，
- 中斷該智慧體。

回覆在送出前會重新檢查即時提示，送出時也會驗證是否確實提交 —— 所以你永遠不會
回答一個智慧體早就跳過的問題。當某個智慧體正在終端機裡串流輸出時，捲動會被
短暫鎖住，免得一個誤觸的滑動在執行途中把你拖上去 —— 如果你寧可自由捲動，
**設定 → 終端機 → 智慧體捲動鎖定** 可以逐個提供者關閉這個凍結
（**claude code** 和 **codex**，兩者預設都開啟）。偵測、卡片和通知都不受影響。

![智慧體頁面，卡片分組在等待輸入、剛剛完成、工作中和閒置之下，每張卡片顯示提供者、工作階段、主機、視窗與窗格，還有內嵌的回答按鈕和一個提示欄位。](https://bambouville.com/docs/assets/img/agent-center.png)

*卡片依「誰最需要你」分組。被阻擋的智慧體會把選項做成內嵌按鈕。*


## 辨識如何運作

基礎偵測是啟發式的，從終端機文字讀取，使用與
[滑動板設定檔](https://bambouville.com/docs/zh-hant/swipe-pad/#設定檔)相同的文法（內建的 Claude Code 和 Codex
文法，加上你自訂的任何設定檔）。

若要取得**精確狀態**，Tessera 提供一個選擇加入、逐台主機的
**智慧體狀態掛鉤**：終端機只能暴露行程與像素，無法說明智慧體正在運算、閒置
還是被阻擋 —— 智慧體自己的生命週期掛鉤才是權威訊號。沒有它，卡片會顯示
*狀態無法使用*，而中心只會發現智慧體；它絕不猜測它們的狀態。

安裝掛鉤時（從一張狀態無法使用的卡片，或頂欄的琥珀色警告進入），一定會先明確
顯示它將改動什麼：它會把 Tessera 自有的檔案放在伺服器的 `~/.config/tessera`
之下，只把 Tessera 的處理常式合併進 Claude Code 和 Codex 的使用者設定 ——
絕不改寫你既有的別名、函式或無關的掛鉤 —— 並在 `.zshrc` / `.bashrc` 中加入
一行帶保護條件的載入語句（以 `# TESSERA-AGENT-LIFECYCLE` 標記）。它回傳的
只有狀態中繼資料 —— 提供者、生命週期事件、狀態、原因、工作階段／回合識別碼、
通知類型、權限模式、時間戳記，以及本機行程 ID ——
**絕不包含提示、回應、原始碼或憑證**。

安裝之後值得知道的事：

- 必須有一個 shell 去載入它 —— 請開啟新的 shell 或 tmux 視窗（Tessera 會在空
  的提示符下提議這麼做，而且只在那裡提議）。
- Codex 有自己的掛鉤信任邊界：第一次整合啟動時，可能會請你透過 `/hooks` 檢視
  該掛鉤。
- 這個頁面會逐台主機追蹤掛鉤的狀態 —— 尚未安裝、已啟用、此處未啟用，或已過時
  —— 會自動修復壞掉的整合，並在有新版本推出時提供 **更新狀態掛鉤**。在純 mosh
  上，檢查可能需要解鎖金鑰，所以 Tessera 會等你輕點 **立即檢查**，而不是持續
  輪詢。

## 關注通知

啟用 **智慧體需要關注時的通知** 後，當畫面外的智慧體在 Tessera 位於背景時完成
或需要你時，Tessera 會發出一則 iOS 橫幅 —— 「\<主機\> · \<視窗\>」、
「Claude Code 等待輸入」、「… 剛剛完成」。輕點橫幅會直接把你帶到對的窗格。

- 啟用這個功能會一次性關閉終端機響鈴的背景[通知](https://bambouville.com/docs/zh-hant/notifications/)；
  智慧體這條管道比較精確。
- iOS 可能會把較長的工作階段在背景中暫停，所以在執行很久的工作階段上，
  送達是盡力而為。