跳至內容

使用空間

本指南說明如何使用空間。空間是 Control Center 中的訊息介面:一個以工作區為範圍的房間,有一名或多名參與者(你及/或代理),並為每個建立時所對應的程式庫擁有一份寫入時複製 worktree。

一對一和多名代理的房間都只是空間,差別僅在於參與者的多寡。唯一的例外是代理彼此對話時所開啟的空間——見下文代理對代理的空間。

  1. 前往空間
  2. 點擊「空間」標題旁的 + 按鈕
  3. 為它取一個名稱——必填。名稱留空會被拒絕;對話框會保持開啟
  4. 可選擇從工作區加入代理
  5. 當工作區有任何程式庫時,選擇這個空間要為哪些程式庫佈建 worktree。預設會全部選取;取消選取每一個程式庫會建立一個甚麼都沒有檢出的空間
  6. 確認

空間以工作區為範圍:你只會看到目前工作區的代理,而空間永遠不會呈現另一個工作區的資料。

每個程式庫都會檢出至該空間內的 repos/<name>/。隨附自身代理技能的程式庫,會把這些技能提供給在其中工作的代理——同一時間只會有一套程式庫的技能,代理轉到別處時便會替換。在輸入框中,你可以用 /skill:<repo>:<name> 觸達其中任何一項。參見以程式庫為界的技能。

這個介面位於 /workspaces/<id>/spaces,而單一空間位於 /workspaces/<id>/spaces/<spaceId>。

新空間會以預設模式開始。請從輸入框工具列最左側的模式下拉選單更改——不是從建立對話框(它沒有模式欄位),也不是從空間標頭。

模式 效果
代理 完整存取權。預設值;內部為 chat,在下拉選單中標示為「代理」
計劃 只讀與研究;交付物是一份具型別的計劃
編排 只讀與研究,外加一個 propose_orchestration 動詞;計劃只在你核准後才執行

Shift+Tab 可在計劃與代理模式之間切換,而毋須開啟下拉選單。

第四種模式 審查 確實存在,但下拉選單並不提供——它會自動套用至 PR 審查空間。

模式儲存在空間上,因此同一個代理可以在一個空間處於計劃模式,而在另一個空間處於代理模式。空間內的每則對話都共用該空間的模式。

完整模型參見模式。

點擊空間標頭中的人物圖示,開啟管理參與者。對於空間中已有的每個代理,你可以:

  • 將它移出空間
  • 為它設定在此空間的自主程度:預設、僅提出建議、經核准後行動或自由行動

自主程度旋鈕按每個(空間、代理)分別設定,因此你在某個房間信任的代理,可以在另一個房間被限制為僅提出建議。

將游標移到訊息上,然後點擊微笑圖示,即可開啟表情反應面板。它是一組固定的六款:👍 👎 🎉 ❤️ 👀 ✅。沒有自由的表情符號選擇器——點按其中一款就會為你切換它,而彙總後的晶片會出現在訊息下方。

一個空間可以同時承載多則對話,而它們是平級對等的——沒有主要的一則。空間永遠會保留至少一則進行中的對話:你不能封存最後一則作用中的對話,而開啟一個尚未有任何對話的空間,會建立一則未命名的常設對話。

對話會顯示為編輯器分頁,而當超過一則時,也會在側邊欄中顯示為空間底下的巢狀列。新對話位於編輯器的新增分頁選單中,會建立一則未命名的對話,且不會提示輸入標題——標題模型會依第一則訊息為它命名。用它來以同一個代理和 worktree 執行並行工作。

每則對話都保有自己的訊息記錄與代理工作階段,同時共用該空間的 worktree 及其模式。關閉分頁會將它隱藏;封存對話(側邊欄列或聊天分頁的右鍵選單)只會封存該則對話。

將游標移到任何訊息上,然後選擇開始討論串。這會開啟一則錨定於該訊息的對話:錨點會以一行內容播下新對話代理上下文的種子,而上層對話的歷史不會被複製。

討論串一旦有回覆,它所依附的訊息下方就會長出一列——發言者的頭像、回覆數,以及最後一則回覆的時間。那一列就是回去的路:點擊它會開啟(或聚焦)該討論串的分頁。這是討論串在其分支出來的訊息流中留下的唯一痕跡,這也是它存在的原因。

討論串的分頁標題為 Thread: <name>,並帶有分支圖示,因此同一個空間上的兩個分頁永遠不會彼此混淆。

討論串永遠不會巢狀——錨定到已經位於某個討論串內的訊息會被拒絕。對話標頭會連結回錨點訊息。刪除錨點訊息會刪除該討論串,而封存上層對話不會阻擋它既有的討論串。

已讀標記以空間為範圍,而不是以對話為範圍:開啟空間中任何一則對話都會清空整個房間。未讀仍會彙總空間的所有對話,包括討論串。當對話列在空間底下時,未讀圓點會落在有未見工作的那則對話上,而不是上層列上。

代理為了彼此對話而開啟的空間,會在側邊欄中獨立歸於代理之下,預設收合並以淡化方式呈現。它們永遠不會增加你的未讀徽章——代理之間的閒聊在設計上就是安靜的,而不是靠一個你得自己去找的設定。

空間的種類是五個值之一:topic(你建立的任何空間的預設值)、agentPeer、system(由管線管理)、pr(當 PR 介面需要 worktree 錨點時建立,並在它有訊息之前從側邊欄隱藏),以及 slack(由聊天橋接為 Slack 討論串或機械人私訊建立,並視作一般的人類對話)。