Orca(ADE):圍繞 terminal AI coding agent 的工作空間——隔離 worktree、多 agent orchestration、瀏覽器標註

文字解析 · 1 支影片 · 產生於 2026-10-01 00:54

🎧 語音解析📝 筆記✍️ 練習

🎧 語音解析 44m53s · TTS 講解與作者原聲交錯;點章節可跳。
邊聽邊看逐句講稿,點任一句從那裡開始
章節(13)

1. Outline

  1. 起點 · My NEW AI Terminal and Code Editor // Orca Review
    Christian Lempa 用一個真實專案從零到 merge 的順序,逐一驗證 Orca 的四個賣點(隔離 worktree、瀏覽器標註、mobile companion、orchestration),並誠實列出毛邊。

2. YouTuber 的思維推導

My NEW AI Terminal and Code Editor // Orca Review

Christian Lempa · 26m03s · 字幕 en · vision=on (使用者指定 vision=true;影片幾乎全程是 Orca 介面 demo,作者多次指著畫面說「you can see」「here」,截圖對理解 worktree、agent 訊息、annotation 流程有直接幫助。) · YouTube

預估 vs 實際耗時
階段預估實際
fetch 6s 2s
segment 1m22s 7m00s
shot 45s 11s
analyze 9m45s 15m05s
render 5s –

作者的起點是他自己每天都在用的 terminal 型 AI coding agent(尤其是 Pi):這類 agent 已經很強,但 terminal 本身沒有為「同時跑好幾個 agent、給它們看畫面、從外面監控它們」而設計。於是他把 Orca 定位成 ADE(agent development environment)——不是又一個能跑 agent 的殼,而是圍繞 agent 建的一整套工作空間——並在開頭就把要驗證的問題說清楚:它能不能成為 terminal、coding、Git、瀏覽的 all-in-one 工具,還是只是花俏的玩具。接下來他不用功能清單,而是按「一個真實專案從零到 merge」的順序走:先看介面與必要設定(agents、用量、orchestration skill),再匯入 repo,然後用 Git worktree 把每個 feature 放進實體隔離的目錄,在其中啟動 agent live coding 一個 home lab 管理 app;用第二個 agent 透過 orchestration skill 跟第一個溝通,證明多 agent 協作不是口號;用 quick command 起 dev server、用內建瀏覽器看成品,再用 annotation 直接點 UI 元素把 context 送進 prompt 修改;中途穿插 mobile companion 的實際體感(有時卡住);用 GUI 的 source control 把 feature branch commit、開 merge request、刪 worktree、回 main pull,完成一個 worktree 的生命週期;最後用一個大任務讓單一 agent 指揮多個 sub agent,同時暴露它的缺點(誤啟 Codex、需要 Yolo 權限)。

每一步都同時回答兩件事:Orca 替 agent 多做了什麼、以及哪裡還粗糙。結論是:對於 coding 能力較弱、但會用 agent 的人,Orca 把「讓 agent 做、人只審閱」變成一條走得通的路,而且不只軟體開發,維運也能用同一套方式在遠端伺服器上讓 agent 檢查部署與健康狀態——所以它值得繼續探索,但 mobile companion 與 orchestration 的細節仍有 bug,離「無腦推薦」還有距離。

推理鏈:每段留給下一段的線索

每一列是一段,箭頭後的字是這段留給下一段的線索。點段落標題跳到該段。

  1. Orca 是什麼:ADE 與本片的問題 → 作者拋出了「all-in-one 還是花俏玩具」這個問題,並列了四個賣點作為檢核清單;下一步他得先讓觀眾看到這個工具長什麼樣、從哪裡拿到、介面上那四個賣點各自住在哪個位置,才能開始逐一驗證。
  2. 第一眼:官網與介面配置 → 版面看完了,但畫面上還沒有任何 agent 在跑——左下角的用量條從哪來、Pi 以外的 agent 怎麼加、agent 怎麼知道如何跟 Orca 溝通,這三件事都得先在設定裡處理好,作者說「接下來示範你需要先設定的第一件事」。
  3. 設定:agents、用量、orchestration skill → agent 與訂閱都設好了,但 Orca 剛裝好時左側 project 清單是空的——作者說要回主視窗示範「怎麼管理或加入你的專案」,也就是把現有的 repo 與資料夾放進去。
  4. 加入專案:掃描、匯入、分群 → 專案進來了,作者說「first of all」要開始示範怎麼實際用它——而他在第 2 段就預告「Git repo 才能在隔離 worktree 管不同 branch,稍後示範」,現在正是兌現的時候:worktree 究竟建在磁碟哪裡、怎麼建、和原本的目錄是什麼關係。
  5. Git worktree:實體隔離的 branch 目錄 → 作者說「我現在就來做這件事」——既然檔案該由 agent 寫,那就在這個剛建好的 feature test app worktree 裡開一個 terminal、叫 agent 從零生出一個 app;同時第 1 段「多個 agent 在隔離 worktree 並行」的主張也要在這裡開始驗證。
  6. 跑第一個 agent:live coding 一個 demo app → 第二個 agent 拿到的任務是「檢查另一個 agent 的進度並寫文件」,但它身處另一個 worktree、看不到對方的檔案——它要得靠第 3 段裝的 orchestration skill 去看到、甚至聯絡第一個 agent;作者說原本想晚點示範,但「現在做太好玩了」,所以 agent 之間怎麼真的溝通就是下一段。
  7. agent 互相溝通:orchestration skill 實戰 → app 的檔案與 Docker Compose 都有了、port 也改了,作者說「我們得想辦法把這個 app 跑起來」——他在第 2 段只當快捷鈕介紹的 quick command,此刻要派上用場,而且他提到「我加了一個新的」,看起來不只是普通的 shell 指令。
  8. Quick commands 與內建瀏覽器看成果 → 成品看得到了,但作者馬上說「這裡我可以示範另一個很酷的功能」:內建瀏覽器的控制列不只是看頁面——既然頁面就在 Orca 裡,那能不能直接指著某個 UI 元素叫 agent 改?這就是第 1 段四個賣點裡「點 UI 元素送進 prompt」的驗證。
  9. 瀏覽器標註:點 UI 元素直接送進 prompt → agent 已經開始改頁面,要等一下才能驗證結果;作者說趁它在跑的時候「再示範一件事:Orca mobile」——第 1 段四個賣點裡還沒驗證的手機 companion——然後再回到瀏覽器看 annotation 的修改有沒有成功。
  10. Mobile companion 與驗證修改結果 → feature 做好也驗證過了,但它還只存在於 feature test app 這個 worktree、所有檔案都是 untracked——作者停掉 agent,說「我想把這個應用部署出去」,下一步就是用 Orca 的 source control 把這條 branch commit、併回 main,完成第 7 段描述的「做完併回 main」那半段流程。
  11. Source control:commit 與 merge request → main 上有了完整的 app,作者說「也許我想加更多功能,可以開更多 branch」——這次他要試第 1 段最後一個、也最有野心的賣點:不是兩個 agent 互傳訊息(第 7 段),而是給一個 agent 一個大任務,讓它自己指揮多個 sub agent 並行。
  12. Orchestration:一個 agent 指揮多個 sub agent → 四個賣點全部驗證過了,各有亮點也各有毛邊(mobile 卡住、orchestration 誤啟 Codex、需要 Yolo);作者說「可以再玩一兩個小時」但要收尾——他得回答第 1 段自己拋出的問題:Orca 是 all-in-one 工具,還是花俏玩具?以及它適合誰。
  13. 結論:Orca 讓不會寫程式的人也能做專案

3. 逐段說明

My NEW AI Terminal and Code Editor // Orca Review

1. Orca 是什麼:ADE 與本片的問題 0:00–3:14

作者介紹 Orca 是一個 ADE(agent development environment):專為 terminal 型 AI coding agent 打造的工作空間,不限特定 agent,用你既有的 AI 訂閱。它的價值不在「能跑 agent」,而在圍繞 agent 建的東西:隔離 Git worktree 並行跑多個 agent、內建瀏覽器可點 UI 元素送進 prompt、手機 companion、多 agent orchestration。本片要回答:它會是 terminal/coding/Git/browsing 的 all-in-one 工具,還是只是又一個花俏的 AI 玩具?1:50–3:15 為贊助商 Morph(ModelCode.ai)的 legacy 專案現代化廣告。

承上 用上前情提要裡的兩個背景:一是作者日常已經在用 Pi 這類 terminal 型 AI coding agent,所以他關心的不是「AI 能不能寫程式」,而是「圍繞 agent 的工作環境」;二是他有 ChatGPT Pro 訂閱,任何新工具都必須能沿用既有訂閱而不是另外收費。

推理因為作者已經天天在 terminal 裡跑 agent,所以他先替 Orca 下一個跟 IDE 區隔開的定義——ADE(agent development environment)——再刻意強調「重點不是能跑 agent,而是圍繞 agent 建了什麼」,然後把四個賣點(隔離 Git worktree 並行、內建瀏覽器點元素送 prompt、mobile companion、多 agent orchestration)一口氣列出來當作後面要逐一驗證的清單,最後把整支影片濃縮成一個可被否證的問題:all-in-one 工具,還是花俏玩具?

AI 補充作者用「ADE」這個詞時沒有解釋它和 IDE 的差別在哪,但這個差別是整支影片的隱含前提:IDE 的使用者是人,工具幫人寫程式;ADE 的第一使用者是 agent,工具幫人「管理正在寫程式的 agent」。所以作者列的四個賣點其實都在解決「同時管好幾個 agent」會遇到的問題——它們會互相改到同一個檔(→ 隔離 worktree)、它們看不到瀏覽器裡的畫面(→ 點元素送 context)、你人不在電腦前(→ 手機 companion)、任務太大一個 agent 做不完(→ orchestration)。另外要注意 1:50–3:15 是贊助商 Morph(ModelCode.ai)的廣告,內容是 legacy 專案現代化,與 Orca 無關,可以直接跳過。字幕裡的「Py」其實是 Pi(pi.dev 的 Pi coding agent),不是 Python。

術語:ADE (agent development environment)CLI agent

ADE (agent development environment)

agent 開發環境

以 AI coding agent 為第一使用者的工作空間:重點是管理、隔離、觀察正在跑的 agent,而不是幫人手動寫程式。

這是 Orca 自己提出的定位,用來跟 IDE(integrated development environment)對照。IDE 的核心是編輯器、除錯器、外掛,服務的是人;ADE 假設程式碼主要由 agent 產出,人負責下任務與審閱,所以核心變成 terminal 分頁、worktree 隔離、agent session 清單、agent 之間的訊息傳遞。常見誤解是把 ADE 當成「內建 AI 的 IDE」(像 Cursor)——那類工具的 AI 嵌在編輯器裡;ADE 反過來,編輯器只是附屬,agent 才是主體。

相關術語: CLI agent (管理的對象)、Git worktree (隔離手段)、orchestration (進階用法)

出處:第 1 段「Orca 是什麼:ADE 與本片的問題」

CLI agent

命令列型 AI coding agent

在 terminal 裡執行、能自己讀寫檔案與跑指令的 AI coding agent,例如 Pi、Claude Code、Codex CLI。

和聊天視窗型 AI 的差別在於它有「工具」:能 ls、cat、寫檔、跑測試、git commit,並根據結果決定下一步,所以能獨立完成多步驟任務。作者說 Orca「不限於 Pi、任何 CLI agent 都行」,意思是 Orca 不自己實作模型呼叫,只是把這些既有的 CLI 程式當成子程序啟動,因此你用的是自己原本的訂閱(如 ChatGPT Pro),不必另外付費給 Orca。

相關術語: Pi (一種)、ADE (agent development environment) (被其管理)

出處:第 1 段「Orca 是什麼:ADE 與本片的問題」

Pi

Pi coding agent

作者最喜歡的 terminal 型 coding agent,特色是簡單直接,可透過 plugin 接不同模型供應商的訂閱。

字幕寫成「Py」,但作者指的是 Pi(pi.dev)這個 CLI agent,不是 Python。作者偏好它的原因在影片中反覆出現:介面極簡、不會一直跳權限確認、能接 ChatGPT Pro 與 Grok 等既有訂閱。Orca 對 Pi 沒有特殊依賴,只是作者的示範全用它。

相關術語: CLI agent (一種)

出處:第 1 段「Orca 是什麼:ADE 與本片的問題」

Git worktree

Git 工作樹

Git 讓同一個 repository 同時 checkout 多個 branch 到不同目錄的機制,每個目錄各自獨立、共用同一份 .git 歷史。

一般 clone 只有一個工作目錄,切 branch 會把整個目錄的檔案換掉;worktree 則是 `git worktree add <path> <branch>`,在另一個路徑多長出一個工作目錄,兩邊可以同時編輯、同時跑程式而不互相干擾。這正好解決多個 agent 並行時「互相改到同一個檔」的問題,所以是 Orca 的核心機制。這裡只需先知道「一個 branch 一個實體目錄」這個概念,實際操作稍後會看到。

相關術語: ADE (agent development environment) (被其用來隔離)

出處:第 1 段「Orca 是什麼:ADE 與本片的問題」

orchestration

多 agent 協調

由一個 agent(或工具)把大任務拆給多個 agent 並行執行、再收回結果的做法。

作者的比喻是「把 Pi 的 terminal 變成一整隊 coding 專家」。技術上需要三件事:能啟動子 agent、能在 agent 之間傳訊、能把子 agent 的結果回報給發起者。這一段只把它列為賣點,實際的機制(Orca 的 orchestration skill、sub agent tasks)之後才會示範。

相關術語: ADE (agent development environment) (進階功能)、CLI agent (協調對象)

出處:第 1 段「Orca 是什麼:ADE 與本片的問題」

留給下一段 作者拋出了「all-in-one 還是花俏玩具」這個問題,並列了四個賣點作為檢核清單;下一步他得先讓觀眾看到這個工具長什麼樣、從哪裡拿到、介面上那四個賣點各自住在哪個位置,才能開始逐一驗證。

2. 第一眼:官網與介面配置 3:14–5:54

orca.dev 官網可下載 Mac/Windows/Linux 版,原始碼在 GitHub;定位偏開發者,但能透過 SSH 連遠端伺服器,所以也適合維運。進入 app:左側是 tasks、automations、mobile companion 與 project 管理(可分群,可放一般資料夾或 Git repo,後者能在隔離 worktree 管不同 branch);中間是多 tab(terminal、browser、markdown、code editor、mobile emulator、各種 agent);右上是 quick commands;右側是 file explorer 與 Git source control。

作者導覽 Orca 主畫面的三欄配置:左側 project 樹、中間 tabs、右側 explorer,後面每個功能都在這個版面上發生。
4:22 · 作者導覽 Orca 主畫面的三欄配置:左側 project 樹、中間 tabs、右側 explorer,後面每個功能都在這個版面上發生。
承上 承接上一段留下的「先看工具長什麼樣、四個賣點各自住在介面哪裡」:作者從 orca.dev 官網(下載、原始碼)跳進 app,按左、中、右三欄把版面走一遍,並在走的過程中點名 mobile companion、隔離 worktree、瀏覽器 tab、agent 這幾個賣點的位置。

推理因為上一段只給了抽象的賣點清單,所以作者接著用空間來組織它們:左欄是「管理」(tasks、automations、Orca Mobile、project 群組),中欄是「工作」(多 tab:terminal、browser、markdown、code editor、mobile emulator、agent),右欄是「檢視」(file explorer、Git source control),右上是 quick commands。他順帶用官網文案「run a fleet of agents、review the AI output、Git integrations」加上「可透過 SSH 連遠端伺服器」來回應開頭的主張——雖然偏開發者,但維運也用得上。

AI 補充截圖(262 秒)能看出幾個作者沒細講但值得注意的細節。第一,左欄 Projects 底下有兩層:群組(Homelab、xcad、christianlempa、ObsidianChristianLempa)→ project(example-apps、tutorials、homelab、xcad)→ 展開後才是 workspace(xcad 底下那個帶綠點的 xcad),綠點代表這個 workspace 目前有東西在跑;這個「project → workspace」的兩層結構就是稍後隔離 worktree 的容器。第二,右側 explorer 此刻列的是作者家目錄的 dotfiles(.claude、.codex、.aider、.copilot、.continue…),因為這個 terminal 的 PWD 是 `~`——explorer 跟著目前 workspace 的路徑走,不是固定指向某個 repo。第三,左下角有兩條用量條「6% used 5h」「3% used wk」,就是他訂閱的 5 小時視窗與週視窗額度,下一段會解釋它從哪裡來。作者說 Orca 可跑在 Mac、「Intel Windows」與 Linux;「Intel Windows」是他的口語,實際是指 Windows 版(原始碼公開在 GitHub),不必糾結於 CPU 架構。另外,中欄的 mobile emulator 只是被點名而未示範,作者自己不是行動開發者,可以忽略。

術語:terminal emulatorquick commandpull request

SSH

安全外殼協定

在加密連線上遠端登入另一台機器的 terminal 的協定,是連遠端伺服器的標準方式。

作者提到 Orca 能透過 SSH 連到遠端伺服器,這是他主張「維運也用得上」的技術依據:既然 Orca 的核心是 terminal 分頁,那把分頁指向一台遠端機器,agent 就等於在那台機器上跑指令、看設定檔。實際上這需要你已經在那台伺服器上配好 SSH 金鑰與 agent 的執行環境,Orca 只是提供入口。

相關術語: terminal emulator (透過它連遠端)

出處:第 2 段「第一眼:官網與介面配置」

terminal emulator

終端機模擬器

提供 shell 輸入輸出視窗的桌面程式(如 iTerm、Windows Terminal),Orca 的中欄本質上是一個可分割、多分頁的終端機模擬器。

作者說「可以像任何 terminal emulator 一樣分割視窗」,意思是 Orca 沒有重新發明 terminal,而是在一個現代終端機模擬器之上加了 browser tab、markdown、code editor 等額外分頁類型。這也解釋了為什麼任何 CLI agent(見第 1 段)都能直接在裡面跑:對 agent 來說它只是另一個 terminal。

相關術語: CLI agent (在其中執行)、SSH (可承載)

出處:第 2 段「第一眼:官網與介面配置」

quick command

快速指令

Orca 右上角可一鍵執行、預先存好的指令,例如 docker compose up 或開發用腳本。

這一段作者只把它當「常用 shell 指令的快捷鈕」介紹。它的價值是把每個專案「怎麼啟動、怎麼測試」這種零碎知識固定在專案設定裡,不用每次翻 README。之後示範時會看到它還有第二種型態。

相關術語: terminal emulator (在其中執行)

出處:第 2 段「第一眼:官網與介面配置」

pull request

拉取請求(GitLab 稱 merge request)

請求把某個 branch 的變更合併進另一個 branch 的正式流程,通常附帶審查、討論與自動檢查。

GitHub 叫 pull request,GitLab 叫 merge request,指的是同一件事。作者提到右側欄在 Git repo 下能進入「pull requests、source control、verification checks」,代表 Orca 把「分支 → 審查 → 合併」這條路徑內建在 GUI 裡,而不是要你回到瀏覽器開 GitHub。這對 ADE 的定位很關鍵:agent 在隔離 branch 上產出,人用 pull request 審閱後才併進主線。

相關術語: Git worktree (隔離開發後的出口)

出處:第 2 段「第一眼:官網與介面配置」

留給下一段 版面看完了,但畫面上還沒有任何 agent 在跑——左下角的用量條從哪來、Pi 以外的 agent 怎麼加、agent 怎麼知道如何跟 Orca 溝通,這三件事都得先在設定裡處理好,作者說「接下來示範你需要先設定的第一件事」。

3. 設定:agents、用量、orchestration skill 5:54–7:48

開始前要設三件事。一、Agents:設預設 agent(或 auto),支援 Codex、Grok、Pi、Claude、OpenCode、Copilot、Gemini、Antigravity、Goose、Kilo Code 等十幾種,可安裝/啟用/停用。作者只把 Codex/Grok 的整合當成左下角「訂閱用量」顯示用(看 ChatGPT Pro 本週已用多少、可重設視窗、管理多帳號)。二、AI provider accounts:Claude、Codex、Gemini、OpenCode、MiniMax、Grok。三、安裝 orchestration skill:它把「如何跟 Orca orchestration 溝通」的指令注入 agent,要定期更新。

agent 設定頁的支援清單:Orca 「不綁特定 agent」這句話的具體證據,也是後面 orchestration 能混用不同 agent 的前提。
6:14 · agent 設定頁的支援清單:Orca 「不綁特定 agent」這句話的具體證據,也是後面 orchestration 能混用不同 agent 的前提。
承上 回應上一段留下的三個待辦:左下角用量條的來源、Pi 以外的 agent 怎麼加、agent 怎麼知道如何跟 Orca 溝通——作者進設定頁,依序用 Agents、AI Provider Accounts、Orchestration 三個項目一一回答。

推理因為版面已經看過、但沒有 agent 就什麼都示範不了,所以作者先處理 Agents 頁:設預設 agent 或 auto,並展示三十幾種可安裝的 CLI agent 清單,用它坐實第 1 段「不綁特定 agent」的主張。接著他把「安裝 agent」和「顯示用量」拆開:他不真的用 Codex/Grok agent,只是啟用整合以便左下角顯示 ChatGPT Pro 與 Grok 的額度;於是自然帶到 AI Provider Accounts 這一頁。最後他補上 orchestration skill——它是把「怎麼跟 Orca 的協調工具講話」的指令塞給 agent 的東西,而且要定期更新——為稍後的多 agent 示範鋪路。

AI 補充截圖(374 秒)比作者口頭說的更有資訊量。第一,頁首寫「Available to install: 31 agents」,而且每個 agent 底下都印出 Orca 實際用來啟動它的命令列:`claude --dangerously-skip-permissions`、`copilot --yolo`、`gemini --yolo`、`aider --yes-always`、`goose GOOSE_MODE=auto`、`amp --dangerously-allow-all`。這說明兩件事:Orca 對每個 agent 的「整合」本質上就是一條啟動命令(所以新 agent 很容易加進清單),而且這些命令預設都帶了跳過人工確認的旗標——原因是 agent 在 Orca 裡常是無人看管地跑,之後示範時會看到這個選項的重要性。第二,左側設定樹在 AI CAPABILITIES 下有 Agents、AI Provider Accounts(標 OPTIONAL)、Orchestration(標 Installed)、Computer Use 與 Voice(Not installed),所以作者講的「三件事」剛好就是這一區的前三項;Computer Use 和 Voice 是影片沒碰的功能。第三,關於用量:ChatGPT Pro 這類訂閱的限制是「滾動時間視窗」而不是月配額,畫面左下的「6% used 5h/3% used wk」就是 5 小時視窗與週視窗;作者說「可以 reset the window」其實只是重設 Orca 端的統計起點,不會真的重設 OpenAI 那邊的額度。字幕裡的 agent 名字有幾個是誤聽(Ada → 畫面上的 Ante;Rover Dev → Atlassian 的 Rovo Dev),不影響理解。

術語:AI provider accountusage window

orchestration skill

協調技能(給 agent 的指令包)

一份安裝進 agent 的指令文件,告訴 agent 如何呼叫 Orca 的協調工具來查看其他 agent、傳訊、產生 sub agent。

「skill」在這類 CLI agent 的世界裡指的是一段可載入的說明文字(通常是 markdown),agent 讀了之後就「學會」某個工具的用法;它不是程式外掛,而是 prompt 的一部分。因此作者提醒要定期更新:Orca 端的協調工具改了介面,agent 手上那份說明也得跟著換,否則 agent 會用舊指令呼叫工具。這也是第 1 段所說 orchestration 能跨不同 agent 的原因——只要某個 agent 能讀 skill、能跑 shell 指令,就能參與協調。

相關術語: orchestration (實作於)、CLI agent (安裝目標)

出處:第 3 段「設定:agents、用量、orchestration skill」

AI provider account

AI 供應商帳號

在 Orca 裡登入的模型供應商訂閱(Claude、Codex、Gemini、OpenCode、MiniMax、Grok),用來讀取並顯示額度用量。

作者刻意把它和「agent」分開:agent 是會跑的程式(Pi、Claude Code…),provider account 是背後付錢的訂閱。同一個訂閱可以被不同 agent 用,例如他的 ChatGPT Pro 同時餵 Pi(透過 plugin)和 Codex CLI。Orca 在這頁標 OPTIONAL,因為不登入也能跑 agent,只是左下角看不到用量。

相關術語: usage window (顯示的內容)、CLI agent (供其使用)

出處:第 3 段「設定:agents、用量、orchestration skill」

usage window

用量時間視窗

訂閱制 AI 服務計算額度的滾動時段(例如每 5 小時、每週),額度在視窗結束後自動回復。

畫面左下的「6% used 5h」「3% used wk」就是兩個視窗的已用比例。這種設計和「每月 N 個 token」不同:短視窗防止你在幾分鐘內燒光,週視窗限制總量。對於同時跑多個 agent 的人來說這條資訊很關鍵,因為 orchestration 會讓消耗速度倍增。作者說的「reset the window」是重設 Orca 的計數起點,不是向供應商要求重置。

相關術語: AI provider account (所屬)

出處:第 3 段「設定:agents、用量、orchestration skill」

留給下一段 agent 與訂閱都設好了,但 Orca 剛裝好時左側 project 清單是空的——作者說要回主視窗示範「怎麼管理或加入你的專案」,也就是把現有的 repo 與資料夾放進去。

4. 加入專案:掃描、匯入、分群 7:48–9:12

Orca 剛裝好是空的,要把現有 repo/資料夾加進左側 project manager。Add project → 選來源(本機、Docker context、遠端伺服器)、或 clone from URL、或建新專案。選一個父資料夾會自動掃描底下所有 repository,可勾選要匯入哪些並自動分群;分開匯入再手動分群很麻煩。作者依 Git 平台分群:self-hosted GitLab 的 home lab repo 一群、個人資料夾/GitHub repo/Obsidian vault 另一群。

承上 接上一段的「project 清單是空的,得把現有 repo 與資料夾放進去」:作者回到主視窗示範 Add project 的三種來源與批次掃描匯入,並解釋他自己怎麼分群。

推理因為設定好了 agent 卻沒有工作對象,所以作者先解決最現實的問題:你的專案大多已經在磁碟上,不是要新建。於是 Add project 的路徑是「瀏覽資料夾」為主,而不是 clone;他再往前推一步——選一個父資料夾讓 Orca 自動掃描底下所有 repository、勾選要匯入的並自動分群——因為一個一個匯入再手動分群「工作量太大」。分群的邏輯他用的是 Git 平台:自家 GitLab 上的 home lab repo 一群,GitHub、本機資料夾、Obsidian vault 另一群。

AI 補充作者沒說清楚「掃描」的判斷依據:Orca 是找子目錄裡有沒有 `.git`,有的就當 repository 列出來、可勾選;沒有的只能整個當一般資料夾加入。這解釋了為什麼第 2 段截圖裡 Projects 底下的 Obsidian vault 只是一個資料夾節點、沒有 workspace 子層——它不是 Git repo,所以之後所有和 branch、worktree 有關的功能對它都不適用。來源選項裡的「Docker context」與「remote servers」對應第 2 段提到的 SSH 遠端能力:專案不一定在本機,可以住在另一台伺服器或容器環境裡,Orca 的 terminal 分頁就會在那裡開。至於分群,本質只是側欄的視覺整理,不影響 Git 行為;作者按平台分是因為他的 home lab repo 全在自架的 GitLab 上,權限與 URL 一致,方便一起管。

Docker context

Docker 連線目標

Docker CLI 用來切換「指令送到哪台 Docker daemon」的設定,可指向本機或遠端主機。

`docker context use <name>` 之後,所有 docker 指令都會送到那個 context 指定的主機。Orca 把它列為 Add project 的來源之一,意思是可以把某個 Docker 環境當成專案所在地,agent 在那裡跑 `docker compose` 之類的指令。這和透過 SSH(見第 2 段)連遠端伺服器是兩種平行的遠端路徑:一個走 Docker API,一個走 shell。

相關術語: SSH (另一種遠端路徑)

出處:第 4 段「加入專案:掃描、匯入、分群」

self-hosted GitLab

自架 GitLab

安裝在自己伺服器上的 GitLab 實例,功能與 gitlab.com 相同但資料留在自己手上。

作者的 home lab repo 全放在自架 GitLab,所以他把這些 repo 分成一群。這對後面有實際影響:GitLab 的合併流程叫 merge request 而不是 pull request(見第 2 段),Orca 的 source control 面板得同時支援兩種平台的用語與 API。

相關術語: pull request (對應用語)

出處:第 4 段「加入專案:掃描、匯入、分群」

留給下一段 專案進來了,作者說「first of all」要開始示範怎麼實際用它——而他在第 2 段就預告「Git repo 才能在隔離 worktree 管不同 branch,稍後示範」,現在正是兌現的時候:worktree 究竟建在磁碟哪裡、怎麼建、和原本的目錄是什麼關係。

5. Git worktree:實體隔離的 branch 目錄 9:12–11:40

Orca 在 Git project 上才發揮全力。Project settings 可設 worktree 預設位置:Orca 會在 ~/orca workspaces 下建一個新目錄再連回 repo,所以磁碟上是實體分開的目錄、各自不同 Git checkout。匯入 repo 時第一個 workspace 對應當前 branch;按 + 可新建 worktree(如 feature test app),以 agent 或空白 terminal 啟動,PWD 顯示它真的住在另一個路徑,explorer 裡檔案和來源 branch 一樣。新建檔案會自動開 markdown editor,也能編程式碼,但作者認為不如 VS Code/Zed、沒有外掛——因為 Orca 是 ADE 不是 IDE:讓 agent 寫檔,人只負責審閱。

按 + 建立新 worktree 的對話框:命名、選 agent 或空白 terminal,是「隔離 worktree」這個核心概念的實際操作畫面。
10:18 · 按 + 建立新 worktree 的對話框:命名、選 agent 或空白 terminal,是「隔離 worktree」這個核心概念的實際操作畫面。
承上 兌現上一段留下的問題:worktree 建在磁碟哪裡、怎麼建、和原本目錄的關係——作者先講機制(Orca 在 ~/orca workspaces 下建新目錄再連回 repo),再按 + 實際建一個叫 feature test app 的 worktree,用 pwd 與 explorer 證明它是另一個路徑但檔案相同。

推理因為專案已經匯入、而 Orca 的價值要在 Git repo 上才顯現,所以作者先把 worktree 的物理事實講清楚:每個 worktree 是磁碟上實體分開的目錄、各自一個 Git checkout,匯入時的第一個 workspace 對應當下的 branch。接著他用最小示範驗證這個說法——建 worktree、跑 pwd 看路徑、看 explorer 檔案與來源 branch 一致、新增一個檔案。新增檔案時 markdown 編輯器自動打開,順勢把話題帶到「Orca 當編輯器好不好用」:不如 VS Code/Zed、沒有外掛;但他不把這當缺點,而是回到第 1 段的定位——這是 ADE 不是 IDE,檔案該由 agent 寫、人只審閱。

AI 補充截圖(618 秒)的 Create worktree 對話框補了作者沒講的細節。「Name or Create From」欄位有五個模式:Smart、GitHub、GitLab、Branch、Name,提示文字是「Type a name, #1234, branch, GitHub or GitLab URL」——也就是說你不只能給名字,還能貼一個 issue 編號或 PR/MR 的網址,Orca 會據此命名 branch 並帶入 context;這是「worktree 對應一個工作項目」的設計思路。「Agent」欄預選 Pi,代表建好 worktree 後就直接在裡面開一個 agent session;「Create more」開關則是連續建多個。背景終端的提示字元寫著 `~/example-apps via main`,右側面板顯示「No changes on this branch」,可見此刻是在第一個 workspace(main)上。Git 層面補一步:作者說「linking this back to the repository」,實際是 `git worktree add` 讓新目錄的 `.git` 只是一個指向原 repo 的檔案而非完整複本,所以兩邊共用歷史、commit 互相可見,但工作目錄的檔案各自獨立——這正是「同時跑多個 agent 不會互踩檔案」的技術基礎。關於編輯器的評語,作者說「不能加 plugin 或擴充套件 yet」,這是 2026 年 7 月當下的狀態,之後版本可能改變。

術語:workspace (Orca)

workspace (Orca)

Orca 的工作區(= 一個 worktree)

Orca 側欄裡 project 底下的一個節點,對應磁碟上一個 Git worktree 目錄與它的 tab、agent session。

作者交替使用 worktree 和 workspace 兩個詞:worktree 是 Git 的概念(見第 1 段),workspace 是 Orca 對它的包裝,多了 tab 版面、正在跑的 agent、瀏覽器分頁等狀態。第 2 段截圖裡 xcad project 底下帶綠點的 xcad 節點就是一個 workspace。匯入 repo 時 Orca 自動建立第一個 workspace 指向當前 branch,之後按 + 才是真正另開目錄。

相關術語: Git worktree (包裝)、ADE (agent development environment) (組成單位)

出處:第 5 段「Git worktree:實體隔離的 branch 目錄」

checkout

簽出(把某 branch 的檔案放進工作目錄)

Git 把某個 branch 或 commit 的檔案內容展開到工作目錄的動作與結果。

作者說 worktree 是「physically separated directories with different Git checkouts」:一般 repo 一次只有一個 checkout,切 branch 就是把這個目錄的檔案整批換掉;worktree 讓多個 checkout 並存於不同目錄。理解這一點才能理解為什麼在新 worktree 裡建檔案,回到原 worktree 看不到。

相關術語: Git worktree (每個各一)

出處:第 5 段「Git worktree:實體隔離的 branch 目錄」

IDE

整合開發環境

以人為使用者、整合編輯器、除錯器、外掛生態的開發工具,如 VS Code、Zed。

作者拿 IDE 當對照組替 Orca 的編輯器辯護:Orca 的 markdown/code editor 基本、沒有外掛,若用 IDE 的標準看就是不合格;但在 ADE(見第 1 段)的前提下,編輯器只用來審閱 agent 寫的檔,所以不必追求 VS Code 的完整度。這是判斷 Orca 適不適合自己的關鍵:如果你還是主要靠自己手寫程式,Orca 不會取代 IDE。

相關術語: ADE (agent development environment) (對照組)

出處:第 5 段「Git worktree:實體隔離的 branch 目錄」

留給下一段 作者說「我現在就來做這件事」——既然檔案該由 agent 寫,那就在這個剛建好的 feature test app worktree 裡開一個 terminal、叫 agent 從零生出一個 app;同時第 1 段「多個 agent 在隔離 worktree 並行」的主張也要在這裡開始驗證。

6. 跑第一個 agent:live coding 一個 demo app 11:40–14:10

作者開新 terminal 選 Pi agent(預設走 Codex model),下 prompt:在 example app 目錄建一個管理 home lab 設備與 IP 的 SvelteKit 全端 app,附 Dockerfile 與開發用 Docker Compose。Orca 立刻辨識到 agent session,在側欄列出來。這時可以再開其他 agent(Claude Code、Codex)或 orchestrate 它們分工前後端;不同 feature 放不同 worktree 避免互改同一檔——若 feature 彼此依賴則要換流程。切回原 worktree 看不到這些檔、也沒有 agent session,證明隔離是真的。接著在第二個 agent 下指令「檢查另一個 agent 的進度並寫文件」。

承上 上一段留下「在 feature test app worktree 裡叫 agent 從零生出一個 app,並開始驗證多 agent 隔離並行」:作者開新 terminal 選 Pi(走預設的 Codex model),下 prompt 建一個 home lab 設備與 IP 管理的 SvelteKit app,Orca 立刻在側欄列出這個 agent session。

推理因為上一段確立了「檔案由 agent 寫」,所以作者沒有事先寫任何規格,直接用口語 prompt 開工:目標(home lab 設備與 IP 管理)、技術堆疊(SvelteKit 全端、Docker 容器、開發用 Docker Compose)——而且承認「我不知道該用什麼 stack」,先做再迭代。agent 一跑起來,Orca 就在側欄多了一個 Pi 的 session 條目,作者用這個現象推到第二層:這時可以再開 Claude Code 或 Codex,甚至分工前後端;再推到第三層:要避免 agent 互踩同一個檔,就把不同 feature 放不同 worktree——但若 feature 彼此依賴就不能這樣切。最後他切回原本的 main worktree,看見沒有那些檔、也沒有 agent session,用反證確認隔離是真的,然後在另一個 agent 下第二個任務:檢查第一個 agent 的進度並寫文件。

AI 補充有兩處作者沒說明但會影響理解。第一,「Pi agent with my default Codex model」不是指他用 Codex CLI 這個 agent,而是 Pi 透過 plugin 用他 ChatGPT Pro 訂閱底下的 GPT 模型(第 3 段他明確說不啟動 Codex agent)——所以整段只有一種 agent(Pi)、一種訂閱在跑。第二,「agent session」被 Orca 辨識並列在側欄,是因為 Orca 監看每個 terminal 分頁裡啟動的程序,認出是已註冊的 agent 命令(第 3 段截圖裡的那些啟動命令)就掛上條目;這是後面所有「看得到其他 agent 在做什麼」的基礎。關於分工的建議,作者說得對但跳了一步:把前端、後端放在不同 worktree 並行,前提是兩者的介面(API 路徑、資料格式)已經先講好,否則各自做完 merge 時會對不上——這就是他說「feature 彼此依賴要走不同流程」的具體意思。字幕中的「Cloud Code」是 Claude Code。另外注意第二個任務其實是下在 main worktree 的另一個 agent 裡,它看不到 feature test app 的檔案,所以它「檢查進度」只能靠問第一個 agent,這是下一段的關鍵。

agent session

agent 工作階段

一個正在 terminal 裡執行的 agent 程序,Orca 會自動偵測並在側欄以條目顯示、可從其他地方查看或傳訊。

session 的生命週期就是那個 CLI 程序從啟動到結束。Orca 能辨識它,是因為啟動命令是 Orca 已知的(第 3 段的 agent 清單);辨識之後 session 就有了身份,其他 agent 或手機端才能指名找它。切回別的 worktree 看不到 session,說明 session 是掛在 workspace 底下,不是全域的。

相關術語: workspace (Orca) (所屬)、CLI agent (執行中的實例)

出處:第 6 段「跑第一個 agent:live coding 一個 demo app」

SvelteKit

Svelte 的全端框架

以 Svelte 為前端、內建伺服器端路由與 API 端點的全端 web 框架。

作者選它是因為一個框架就能同時做出頁面與後端 API,讓 agent 用單一專案交付「伺服器 + 前端」。對這支影片而言技術選型不重要——他自己說「我不知道該用什麼 stack」——重點是示範 agent 能從一句話生出可跑的專案。

相關術語: Docker Compose (以其啟動開發環境)

出處:第 6 段「跑第一個 agent:live coding 一個 demo app」

Docker Compose

多容器編排設定

用一個 YAML 檔描述多個容器(服務、網路、掛載)並一鍵啟動的 Docker 工具。

作者要求 agent 同時產出 Dockerfile(怎麼把 app 打包成映像)和 Docker Compose(怎麼在本機跑起來做開發測試)。這符合他 home lab 的習慣:所有東西都容器化。第 2 段提到 quick command 的例子「Docker Compose up」,就是啟動這種設定。

相關術語: quick command (常被其呼叫)、Docker context (決定跑在哪台主機)

出處:第 6 段「跑第一個 agent:live coding 一個 demo app」

留給下一段 第二個 agent 拿到的任務是「檢查另一個 agent 的進度並寫文件」,但它身處另一個 worktree、看不到對方的檔案——它要得靠第 3 段裝的 orchestration skill 去看到、甚至聯絡第一個 agent;作者說原本想晚點示範,但「現在做太好玩了」,所以 agent 之間怎麼真的溝通就是下一段。

7. agent 互相溝通:orchestration skill 實戰 14:10–16:53

第二個 agent 讀了 orchestration skill(要在設定裡啟用),就能看到另一個 agent 在做什麼、能 spawn sub agent,並透過 Orca 傳訊給第一個 agent:「我在寫文件,請簡短回覆預定的功能範圍與尚未完成的檔案」;第一個 agent 回覆後,第二個就能寫出文件。一般流程是:merge 進 repo → 在隔離 worktree checkout → 做各自的 feature。畫面上檔案陸續生成(Dockerfile、compose、架構文件)。缺點:agent 工作時終端會不斷往上捲,難看到目前進度(可能與 agent 有關)。作者順手叫 agent 把 port 從 5173 改掉以免和另一個 demo 衝突。

兩個 agent 透過 Orca 傳的那則訊息:orchestration skill「agent 之間怎麼溝通」的實際內容,只看字幕想像不出格式。
14:26 · 兩個 agent 透過 Orca 傳的那則訊息:orchestration skill「agent 之間怎麼溝通」的實際內容,只看字幕想像不出格式。
承上 回答上一段留下的問題「身處另一個 worktree 的第二個 agent 要怎麼看到、聯絡第一個 agent」:它讀了第 3 段裝的 orchestration skill,透過 Orca 的指令把一則訊息送進第一個 agent 的對話,第一個 agent 回覆範圍與待完成檔案後,第二個就有材料寫文件。

推理因為第二個 agent 看不到對方的檔案,所以它唯一的路徑是「問」:orchestration skill 讓它知道可以用 Orca 的指令對另一個 session 送訊息。作者等第一個 agent 寫完當下的檔案,畫面上就出現那則訊息——「我在寫文件,請簡短回覆預定的功能範圍與尚未完成的檔案,然後繼續你的實作」——第一個 agent 回覆後,第二個 agent 開始產出文件。作者由此概括一般流程:先 merge 進 repo,再在隔離 worktree checkout 各做各的 feature;並坦白自己只是 vibe coding、不確定開發者是否真的這樣做。接著他觀察缺點(agent 工作時終端不斷上捲、看不到當前進度,可能和 agent 有關),順手叫 agent 改 port 避免和另一個 demo 衝突,最後把話題帶到「該怎麼啟動這個 app」。

AI 補充截圖(866 秒)是理解 agent 間通訊機制的關鍵。那則訊息出現在**第一個** agent 的終端裡,格式就像使用者親自打的一段話,接著第一個 agent 進入「Listing pending tasks for project files… Working…」——也就是說 Orca 的做法不是什麼特殊協定,而是把第二個 agent 產生的文字當成一則新的使用者輸入,塞進第一個 agent 的對話回合。這解釋了為什麼任何 CLI agent 都能參與:只要它會回應使用者輸入,就能被「傳訊」。訊息最後那句「continue your implementation afterward」也很重要:它是 skill 教第二個 agent 加上的禮貌指令,避免第一個 agent 被打斷後忘記回去做原本的事。底部狀態列有幾個作者沒提的細節:路徑 `~/orca/workspaces/feature-testapp` 證實第 5 段講的 worktree 位置;`(openai-codex) gpt-5.6-sol • medium` 證實第 6 段的推論——Pi 透過 Codex 供應商用 GPT 模型;`↑42k ↓8.3k … 4.2%/372k` 是這個 session 的 token 用量與 context 佔比。右側 explorer 裡 example-app 底下所有檔案都標 `U`(untracked),代表 agent 已經生出整個 SvelteKit 專案骨架但一個都還沒 commit,這是之後 source control 要處理的東西。關於作者「一般流程」的描述可以補一步:他其實描述的是 trunk-based 的 feature branch 流程——每個 feature 從 main 開 worktree、做完併回 main、再從新的 main 開下一個——這也是為什麼他說「現在這裡沒有可迭代的檔案」:main 上還是空的,要等這個 feature 併回去。

sub agent

子 agent

由一個 agent 啟動、負責某個子任務、完成後把結果回報給發起者的另一個 agent 程序。

orchestration skill(見第 3 段)給 agent 兩種能力:對既有 session 傳訊(這段示範的),以及自己 spawn 新的 sub agent。前者是平行的兩個同輩互相問答,後者是上下級:父 agent 拆任務、子 agent 執行、結果回流。這一段只用到前者,但作者順口提到後者也已經可用。

相關術語: orchestration (組成單位)、agent session (本身也是一個)

出處:第 7 段「agent 互相溝通:orchestration skill 實戰」

vibe coding

憑感覺的 AI 寫程式

不細看程式碼、用自然語言描述需求、看結果不對就再下指令修的開發方式。

作者用它自嘲:他不確定專業開發者是否真的按「merge → 隔離 worktree → 各做各的」流程做事,他只是這樣用覺得順。這個詞也界定了 Orca 的目標使用者——不是要取代資深工程師的 IDE,而是讓會描述需求、能審閱結果的人用 agent 產出可用的東西。它與 ADE(見第 1 段)互為表裡:ADE 是工具側,vibe coding 是使用者側。

相關術語: ADE (agent development environment) (對應的工作方式)

出處:第 7 段「agent 互相溝通:orchestration skill 實戰」

port

連接埠

一台機器上區分不同網路服務的號碼,同一時間一個 port 只能被一個程式佔用。

5173 是 Vite(SvelteKit 底層的開發伺服器)的預設 port。作者的電腦上另一個 demo 已經佔了它,所以要 agent 換一個,否則新 app 起不來。這是多 worktree 並行時常見的實際問題:每個 worktree 都是獨立的專案副本,會各自想用同一個預設 port,需要人或 agent 協調。

相關術語: SvelteKit (預設 5173)

出處:第 7 段「agent 互相溝通:orchestration skill 實戰」

留給下一段 app 的檔案與 Docker Compose 都有了、port 也改了,作者說「我們得想辦法把這個 app 跑起來」——他在第 2 段只當快捷鈕介紹的 quick command,此刻要派上用場,而且他提到「我加了一個新的」,看起來不只是普通的 shell 指令。

8. Quick commands 與內建瀏覽器看成果 16:53–18:25

Quick commands 可以是固定的 terminal 指令,也可以是 agent prompt(如「start the dev server」):後者會另起一個 agent 去搞清楚這個專案怎麼啟動。dev server 起來後 command+click 連結就在 Orca 內開瀏覽器 tab,且綁在這個 worktree。agent 建的 app 叫 Home Base:儀表板、總數、網路、實際抓到了作者真實的 Proxmox 節點(DNS 解析有誤),可新增 entry(Proxmox prod 2、IP、hostname、類型、狀態)。作者五分鐘做出 home lab 管理 app,強調只是 demo 不會上 production。

Quick command 設定畫面:「terminal command」與「agent prompt」兩種類型並列,是這段的關鍵區分。
16:54 · Quick command 設定畫面:「terminal command」與「agent prompt」兩種類型並列,是這段的關鍵區分。
agent 五分鐘做出的 Home Base 儀表板:看到成品才知道下一段要標註修改的是什麼。
17:42 · agent 五分鐘做出的 Home Base 儀表板:看到成品才知道下一段要標註修改的是什麼。
承上 接上一段的「該怎麼把 app 跑起來、作者加了一個不像普通 shell 指令的 quick command」:他揭曉 quick command 有兩種型態——固定 terminal 指令、或一句 agent prompt(「start the dev server」)——後者會再起一個 agent 自己搞清楚這個專案怎麼啟動;dev server 起來後 command+click 在 Orca 內開瀏覽器 tab 看成品。

推理因為每個 agent 生出的專案啟動方式都不一樣(npm run dev?docker compose up?哪個 port?),所以作者不把啟動指令寫死,而是用「agent prompt」型的 quick command,把「怎麼啟動」這個問題也丟給 agent。dev server 起來後,他用 command+click 讓 Orca 在同一個 worktree 裡開瀏覽器分頁——強調瀏覽器也是隔離在這個 worktree 的——然後第一次看到成品 Home Base:儀表板、統計、設備表,還能新增一筆 Proxmox prod 2。他用「五分鐘做出 home lab 管理 app」回應第 1 段的問題,同時劃清界線:只是 demo,不會部署到 production。

AI 補充兩張截圖補了幾個作者沒說的細節。第一張(1014 秒):quick command 選單裡「Start Devserver」底下小字寫「Pi: Start the dev server」,旁邊另有「Command」項——所以 agent prompt 型的 quick command 是綁定某個 agent 的,這裡是 Pi;同時終端裡是上一段改 port 的結果:agent 把 Vite 的開發 port 改成 5179、更新兩份 README,並註明「Docker Compose remains on port 3000」——也就是開發模式(npm run dev)與容器模式(compose)走不同 port,作者接下來看到的是開發模式。側欄 feature-testapp 底下顯示「2 agents」,到第二張截圖變成「3 agents」,多出來的就是「Start the dev server」那個 agent——每個 agent prompt 型 quick command 都會多一個 session,用完記得關。第二張(1062 秒):網址列 `http://localhost:5179/`,瀏覽器工具列有 Import 與幾個檢視按鈕;頁面資料表列了 Proxmox Node 01(10.20.0.11、pve01.home.arpa)、Core DNS、Container Sandbox 三筆。這裡要指出作者一個誤判:他說「它居然加了我真實的 Proxmox 節點、DNS 解析不對」,但這三筆的網域是 `home.arpa`(RFC 8375 保留給家用網路的範例網域)、IP 是 10.20.x 這種教科書式私有位址,而作者自己隨後輸入的真實主機名稱格式是 `prox-prod-2.home.<他的網域>.de`——所以這些幾乎可以肯定是 agent 生成的種子資料,不是從他機器上讀到的真實節點,「DNS 不對」只是因為它本來就是假資料。這個誤判提醒一件事:agent 為了讓 demo 好看會自行編造貌似真實的資料,審閱時要分清「它查到的」和「它編的」。

術語:agent prompt (quick command)

agent prompt (quick command)

agent 提示型快速指令

quick command 的第二種型態:存的不是 shell 指令而是一句給 agent 的任務,按下去會新開一個 agent session 去完成它。

第 2 段介紹的 quick command 是固定指令(適合你明確知道要跑什麼);agent prompt 型則把「這個專案怎麼啟動」交給 agent 現場判斷,代價是多一個 session、多花 token、多等幾十秒。適合的情境是跨很多專案、每個啟動方式都不同的人(正是作者的 home lab 狀況)。從側欄 agent 數量增加可以看出它確實是獨立 session。

相關術語: quick command (一種)、agent session (每次產生一個)

出處:第 8 段「Quick commands 與內建瀏覽器看成果」

dev server

開發伺服器

前端框架在開發階段提供的本機伺服器,改檔即時重載,不同於打包後的正式部署。

SvelteKit(見第 6 段)的 dev server 由 Vite 提供,預設 port 5173、這裡被改成 5179。它和 Docker Compose 跑出來的容器(port 3000)是兩條路:dev server 快、方便邊改邊看;容器是模擬正式部署。作者這段看的是 dev server,所以第 7 段那個「compose 應該能跑起 demo」的問題其實還沒被驗證。

相關術語: port (各佔一個)、SvelteKit (由其提供)

出處:第 8 段「Quick commands 與內建瀏覽器看成果」

Proxmox

Proxmox VE 虛擬化平台

開源的伺服器虛擬化平台,home lab 玩家常用它跑虛擬機與容器。

作者的 home lab 主要基礎設施就是 Proxmox 節點,所以他一眼認出表裡的「Proxmox Node 01」並以為是自己的機器。這個名字出現在 agent 生成的種子資料裡,是因為 prompt 說了「home lab infrastructure」,agent 就用最典型的 home lab 元件填充資料。

出處:第 8 段「Quick commands 與內建瀏覽器看成果」

見仁見智 17:49
「It actually added my real Proxmox node. So, this my real production server.」
畫面上這筆資料是 Proxmox Node 01、IP 10.20.0.11、主機名 pve01.home.arpa。`home.arpa` 是 RFC 8375 保留給家用網路的範例網域,加上作者自己隨後輸入的真實主機名格式完全不同(prox-prod-2.home.<他的網域>.de),這幾乎可以肯定是 agent 生成的種子資料,不是從作者環境讀到的真實節點;他說的「DNS 解析不正確」是因為資料本來就是虛構的。標 debatable 是因為無法百分之百排除作者剛好有一台叫 pve01 的節點。
依據: 截圖 frames/s08_1062.jpg 的資料表;RFC 8375(home.arpa)
留給下一段 成品看得到了,但作者馬上說「這裡我可以示範另一個很酷的功能」:內建瀏覽器的控制列不只是看頁面——既然頁面就在 Orca 裡,那能不能直接指著某個 UI 元素叫 agent 改?這就是第 1 段四個賣點裡「點 UI 元素送進 prompt」的驗證。

9. 瀏覽器標註:點 UI 元素直接送進 prompt 18:25–20:13

內建瀏覽器的控制列可以「抓」任何頁面元素:hover 複製 HTML、開 dev tools 看原始碼,但最好用的是 annotate page element——點一個元素,附一句話(解釋這些 class、或「刪掉這段太長的介紹改成一句話」),加進 annotation 清單;可繼續標其他元素(「這裡加 Lucide icon 管理」)。送出時可選任何正在跑的 agent,它會自動把 URL、瀏覽器 tab、元素本體與你的需求貼進 prompt,agent 立刻讀檔改碼。

annotate page element 的操作:作者點著儀表板上的介紹區塊寫需求,是這個功能最直觀的一幕。
18:52 · annotate page element 的操作:作者點著儀表板上的介紹區塊寫需求,是這個功能最直觀的一幕。
送給 agent 的 prompt 內容:自動貼上 URL、tab、元素 HTML 與需求文字,顯示「context 是怎麼被打包的」。
19:49 · 送給 agent 的 prompt 內容:自動貼上 URL、tab、元素 HTML 與需求文字,顯示「context 是怎麼被打包的」。
承上 驗證上一段末尾提出的「頁面就在 Orca 裡,能不能指著 UI 元素叫 agent 改」:內建瀏覽器的控制列可以抓任何元素——複製 HTML、開 dev tools——但作者說最好的是 annotate page element:點介紹段落寫「刪掉換成一句話」、點表格 icon 寫「用 Lucide icons 做 icon 管理」,累積成清單後一次送給 agent。

推理因為上一段看成品時已經有想改的地方(介紹太長、想要 icon),所以作者用這些真實需求示範 annotation 的工作流:先展示低階能力(hover 複製 HTML、inspect source)當對照,再示範高階的 annotate——它不只是複製 HTML,而是把「哪個元素 + 你想怎麼改」配成一組,可以連續標多個元素累積成 annotation 清單,最後送出時 Orca 自動把 URL、瀏覽器 tab、元素本體與你的需求組成 prompt。作者的推論是:這消除了「用文字向 agent 描述我在說頁面上哪個東西」這個最麻煩的溝通成本,所以是「真正最好的功能」。

AI 補充第二張截圖(1189 秒)揭露了 Orca 替每個標註元素打包了多少 context,遠比作者說的「URL、tab、元素」多:Intent(change)、CSS Selector、Location、Bounds(座標與尺寸)、Classes、元素文字、Nearby text、Nearby elements、Computed styles(display、寬高、margin、padding、顏色、字型…)、Full DOM path、原始 HTML,最後才是你的 Feedback;第二個元素(那個 `span "PR"`)也用同樣格式列出,還附上 Nearby text「Proxmox Node 01 Primary virtualization host」讓 agent 知道它在表格哪一列。這解釋了為什麼 agent 能「立刻讀檔改碼」而不用先問你指的是哪裡:selector 與 class 名(`s-y_bCXRrkrYfP` 是 Svelte 編譯時加的 scoped class hash)足以讓它 grep 到對應的 `.svelte` 檔。這也是第 1 段賣點「把 context 直接送進 prompt」的具體內容。一個作者沒明說的細節:側欄 feature-testapp 底下從 3 agents 變成 4 agents,多了一個「## Design Feedback」session 標「now」——他嘴上說「送給任何正在跑的 agent」,但這次實際上是新開了一個 agent 來處理;兩種都可以,差別是新 agent 沒有前面的對話脈絡、但也不會打斷正在做事的 agent。第一張截圖(1132 秒)還順帶證實了第 8 段的判斷:表格第四列是作者剛加的 Proxmox Prod 2,主機名 `prx-prod-2.home.clcreative.de`,和前三筆的 `home.arpa` 明顯是兩個世界。

術語:Lucide icons

annotate page element

標註頁面元素

在 Orca 內建瀏覽器裡點選一個 UI 元素並附上一句需求,Orca 會把該元素的完整 context 與需求打包成 prompt 送給 agent。

和單純「複製 HTML 貼進對話」的差別在三點:一、自動附上 selector、DOM 路徑、computed styles 等 agent 定位與修改所需的資訊;二、可以連續標多個元素累積成清單,一次送出;三、送出目標可以是任何 session 或新開一個。它解決的是人機溝通裡最耗時的「我說的是哪裡」問題,因此作者把它評為 Orca 最好的功能。前提是被測的東西是 web 應用。

相關術語: CSS selector (打包內容之一)、agent session (送達目標)

出處:第 9 段「瀏覽器標註:點 UI 元素直接送進 prompt」

CSS selector

CSS 選擇器

用標籤、class、id 與層級關係描述「頁面上哪個元素」的字串,例如 `section.hero > div.intro`。

在 annotation 的 prompt 裡 selector 是 agent 定位程式碼的主要線索:它會拿 class 名去原始碼裡搜。這裡的 class 帶一串亂碼(`s-y_bCXRrkrYfP`)是 Svelte(見第 6 段)編譯時為了樣式隔離自動加的 scoped hash,原始碼裡看不到這串字,但 `hero`、`intro`、`entity-icon` 這些人寫的 class 名會保留,agent 靠它們就能找到檔案。

相關術語: DOM path (另一種定位方式)

出處:第 9 段「瀏覽器標註:點 UI 元素直接送進 prompt」

DOM path

DOM 路徑

從 `body` 一路到目標元素的祖先鏈,例如 `body > div > main > section.hero > div`。

DOM(document object model)是瀏覽器把 HTML 解析成的樹狀結構;DOM path 就是這棵樹上從根到葉的路徑。Orca 在 annotation 裡同時給 selector 與 full DOM path,前者精簡、後者唯一,兩者互補,確保 agent 不會改錯同名的元素。

相關術語: CSS selector (互補)

出處:第 9 段「瀏覽器標註:點 UI 元素直接送進 prompt」

Lucide icons

Lucide 圖示庫

開源的 SVG 圖示庫,有各主流前端框架的套件(如 lucide-svelte),常被 AI 生成的 UI 使用。

作者要求「用 Lucide icons 做 icon 管理」是很典型的 vibe coding 指令:指定一個 agent 熟悉的現成庫,而不是自己畫圖示。選 Lucide 的原因是它與 Tailwind/shadcn 生態相容、名稱一致,agent 幾乎不會用錯;這也提示一個技巧——給 agent 明確的庫名比描述「好看的 icon」有效得多。

相關術語: SvelteKit (有對應套件)

出處:第 9 段「瀏覽器標註:點 UI 元素直接送進 prompt」

留給下一段 agent 已經開始改頁面,要等一下才能驗證結果;作者說趁它在跑的時候「再示範一件事:Orca mobile」——第 1 段四個賣點裡還沒驗證的手機 companion——然後再回到瀏覽器看 annotation 的修改有沒有成功。

10. Mobile companion 與驗證修改結果 20:13–21:45

Orca mobile 已配對作者的 iPhone:能連上裝置、看到所有 tab、帳號用量、跳進任何 worktree 與 session、輸入指令、讀終端輸出。缺點:需要重排 tab 版面,有時卡在 loading,「有時好用有時不行」。回到瀏覽器 tab:agent 改完後頁面報錯,作者請 agent 測試修正或重啟 dev server;重啟後就好了——標題已移除、有了 icon,點 icon 還能開 icon 切換器。作者停掉 agent 準備把成果部署出去。

手機端 Orca mobile 畫面:看到手機上列出所有 tab 與 session,才理解「從手機操作 agent」是什麼樣子。
20:16 · 手機端 Orca mobile 畫面:看到手機上列出所有 tab 與 session,才理解「從手機操作 agent」是什麼樣子。
承上 照上一段的安排:趁 agent 改頁面時示範第 1 段四個賣點裡最後一個還沒驗證的 Orca Mobile(已配對 iPhone、能看所有 tab、用量、跳進任何 worktree 與 session、下指令、讀輸出),再回瀏覽器驗證 annotation 的修改。

推理因為 agent 要跑一陣子,所以作者用這段空檔補上 mobile companion,而且不迴避缺點:它得改 tab 的解析度與版面,有時卡在 loading,「有時能用有時不行」,他不確定是自己的問題還是新版已修。回到瀏覽器時頁面報錯,他給了兩條路——叫 agent 測試修正、或只是重啟 dev server——先試便宜的那條,重啟後就正常了:介紹段落沒了、表格有了 icon、點 icon 能開切換器。這一輪「改 → 錯 → 重啟 → 好」讓他確認 annotation 的修改確實落地,接著停掉 agent,準備把成果併回 repo。

AI 補充截圖(1216 秒)有個容易誤讀的地方:左邊「Your phone is paired.」與「Mobile 7/4/2026」是作者真實的配對狀態,但右邊那個手機介面是 Orca 內建的示意畫面而不是他的 iPhone 即時畫面——上面列的 `feat/mobile-page #2491`、`runtime/web-pairing #2487`、`infra/notifier` 等是 Orca 自家 repo 的 branch 名與 PR 編號。不過這個示意圖恰好說明了手機端的資訊架構:以 worktree(branch)為單位列出 Pinned/Active,每項顯示所屬 repo、最後一則 agent 訊息或指令,其中 `infra/notifier` 顯示「awaiting permission · sudo apt install」——代表手機端可以看到、也可以回應 agent 的權限確認,這是「從手機控制 agent」最實用的場景(agent 卡在確認等你,你在外面按一下)。作者實際上沒有把手機畫面錄進影片,所以他對「有時卡住」的評價是使用者回饋而非可重現的示範。關於頁面報錯又重啟就好,作者沒解釋原因,可以補一步:agent 為了做 icon 管理裝了新套件(lucide 的 Svelte 版),而 Vite dev server 在啟動時就決定好要預先打包哪些依賴,執行中新裝的套件會讓它的模組解析對不上,這種錯誤本來就要重啟才會消失——所以「大部分時候重啟就好」不是玄學,而是「新增依賴後要重啟 dev server」這條規則。若是程式邏輯錯,重啟不會有用,那時才需要叫 agent 修。

術語:device pairinghot module replacement

Orca Mobile

Orca 手機端

配對到桌面 Orca 的手機 app,可查看所有 worktree 與 agent session、讀終端輸出、輸入指令、回應權限確認。

它不是獨立跑 agent 的 app,而是桌面 Orca 的遠端遙控:所有運算仍在你的電腦上,手機透過網路連回去,所以第 2 段作者才說「要有辦法連到你的電腦,例如 VPN」。它最有價值的場景是「agent 在跑長任務、中途卡在確認或出錯,而你不在電腦前」。作者的實測是有時卡在 loading,需要自己試。

相關術語: agent session (遠端查看)、workspace (Orca) (以其為單位列出)

出處:第 10 段「Mobile companion 與驗證修改結果」

device pairing

裝置配對

讓手機與桌面 Orca 互相認證、建立信任關係的一次性設定,之後手機才能連回這台電腦。

配對只解決「誰可以連我」,不解決「怎麼連到我」:後者要靠兩者在同一網路或 VPN。畫面上「Mobile 7/4/2026 · Paired」就是一筆信任記錄,可刪除或再配對另一台。這和 SSH 金鑰(見第 2 段)的邏輯相同——身分驗證與網路可達性是兩件事。

相關術語: Orca Mobile (前置步驟)、SSH (類比)

出處:第 10 段「Mobile companion 與驗證修改結果」

hot module replacement

模組熱替換(HMR)

dev server 在你改檔後只替換變動的模組、不整頁重載的機制,是 Vite 開發體驗快的原因。

HMR 對「改既有檔案」很靈,但對「新增第三方依賴」無能為力:Vite 啟動時會先掃描並預打包 node_modules 裡用到的套件,中途新裝的套件不在那份清單裡,於是頁面報錯。這正是作者遇到的狀況,也是為什麼重啟 dev server(見第 8 段)就好。判斷準則:agent 改完後頁面壞掉,先看它有沒有 `npm install` 過什麼;有就重啟,沒有才是真的 bug。

相關術語: dev server (提供)

出處:第 10 段「Mobile companion 與驗證修改結果」

留給下一段 feature 做好也驗證過了,但它還只存在於 feature test app 這個 worktree、所有檔案都是 untracked——作者停掉 agent,說「我想把這個應用部署出去」,下一步就是用 Orca 的 source control 把這條 branch commit、併回 main,完成第 7 段描述的「做完併回 main」那半段流程。

11. Source control:commit 與 merge request 21:45–22:35

目前在 feature test app branch。用右側 GitOps source control:stage all changes → commit(「app initially created」)→ publish branch → 建 merge request 併回主 branch → 刪掉整個 workspace(feature 完成)。回到主 worktree 跑 pull,檔案就出現在磁碟上的 main branch,可以繼續在上面開新 branch、新 worktree 做更多功能。

Orca 內建的 source control 面板:stage/commit/publish/merge request 都在 GUI 裡完成,說明它取代了多少 Git CLI 操作。
21:59 · Orca 內建的 source control 面板:stage/commit/publish/merge request 都在 GUI 裡完成,說明它取代了多少 Git CLI 操作。
承上 執行上一段留下的任務——把只存在於 feature test app worktree、全是 untracked 的成果併回 main:作者用右側 source control 面板 stage all → commit(「app initially created」)→ publish branch → 建 merge request → 刪掉整個 workspace,再回 main worktree 跑 pull,檔案就出現在磁碟上的 main。

推理因為 worktree 的隔離是靠 branch 實現的,所以要讓成果變成「專案的一部分」就得走一遍 Git 的合併流程;作者刻意全程用 Orca 的 GUI 面板而不打 git 指令,證明第 2 段介面導覽時提到的 source control 能力足以取代終端裡的 Git 操作。順序是:stage 所有變更、寫 commit 訊息、commit 到 feature branch、publish(推到遠端)、開 merge request 併回 main、然後刪掉這個 workspace——因為 feature 做完了,worktree 就沒有存在的理由。最後回到 main worktree pull,驗證檔案真的到了 main,並宣告可以在這個基礎上繼續開更多 branch、更多 worktree。

AI 補充截圖(1319 秒)證實幾件事。終端提示字元 `~/feature-testapp via feature-testapp` 顯示目前在該 worktree 與同名 branch 上;右側面板頂端的按鈕是「Create MR」、比較基準寫 `vs refs/remotes/origin/main`——MR 是 GitLab 的用語(見第 2 段 pull request),可見這個 example-apps repo 放在作者自架的 GitLab(第 4 段),Orca 會依平台切換用語與 API。STAGED CHANGES 有 19 個檔案,全部標 `A`(新增),其中 `package-lock.json +1845` 行、`+page.svelte +300` 行、另有 `routes/health/+server.ts`(agent 自己加的健康檢查端點)與 `lib/entity-icons.ts`(上一段 icon 功能的產物)——這就是「五分鐘」內 agent 產出的實際規模,也是人審閱時該逐一看過的清單。側欄還多了「restart the dev server」與「Can oyu test and fix the…」兩個 session,說明作者上一段其實兩條路都試了。作者的流程漏講了一步:建了 merge request 之後,必須有人在 GitLab 上**接受**它(或設定自動合併),main 才會有這些 commit;影片直接跳到「pull 後檔案出現在 main」,中間的合併動作被剪掉了。另一個要注意的順序:他先刪 workspace 再 pull——這在這裡安全,因為 branch 已經 publish 到遠端、commit 不會隨 worktree 消失;若還沒 push 就刪 worktree,本機的 commit 仍在 `.git` 裡但 branch 若被一併刪除就要靠 reflog 找回。至於 commit 訊息「app initially created」與口誤「merge into the main feature branch」都不影響結果。

術語:git pull

stage

暫存(git add)

把工作目錄裡的變更標記為「下次 commit 要包含」的動作,讓你能挑選要提交哪些檔案。

第 7 段截圖裡所有檔案標 `U`(untracked),stage 之後在面板裡變成 `A`(added)。作者用「stage all」一次全選,這在 demo 裡沒問題,但正式專案審閱 agent 產出時,stage 其實是最好的過濾點——只挑你看過、認可的檔案,沒看的先不 commit。

相關術語: commit (前置步驟)

出處:第 11 段「Source control:commit 與 merge request」

commit

提交

把已 stage 的變更連同一則訊息永久記進 Git 歷史,形成一個可回溯的節點。

commit 之後變更就屬於 branch 而不再只是工作目錄裡的檔案,這是為什麼作者能安心刪掉 worktree:目錄消失,commit 不會。commit 訊息(這裡是「app initially created」)是給未來的自己與審閱者看的,agent 產出的專案尤其該在訊息裡註明「由 agent 生成、已審閱哪些部分」。

相關術語: stage (之後)、publish branch (之前)

出處:第 11 段「Source control:commit 與 merge request」

publish branch

發佈分支(git push -u)

把本機 branch 第一次推到遠端 repo 並建立追蹤關係,讓遠端平台(GitLab/GitHub)看得到它。

在 Orca 面板裡是一顆按鈕,對應 `git push -u origin feature-testapp`。它是開 merge request 的前提:MR 是遠端平台上的物件,branch 不在遠端就沒有東西可比較。也因為 branch 已在遠端,之後刪本機 worktree 才不會丟資料。

相關術語: commit (之後)、pull request (前提)

出處:第 11 段「Source control:commit 與 merge request」

git pull

拉取更新

把遠端 branch 的新 commit 抓下來並合併進目前 worktree 的 branch,讓本機檔案同步。

作者在 main worktree 上 pull,是因為 merge request 被接受後新 commit 只存在於遠端的 main,本機那個 main worktree 的目錄還是舊的。pull 之後檔案出現在磁碟上,這一刻才完成第 7 段所說的「merge 進 repo」,接下來新的 worktree 從這個 main 開出去就會帶著 app。

相關術語: Git worktree (各自需要)、checkout (更新其內容)

出處:第 11 段「Source control:commit 與 merge request」

留給下一段 main 上有了完整的 app,作者說「也許我想加更多功能,可以開更多 branch」——這次他要試第 1 段最後一個、也最有野心的賣點:不是兩個 agent 互傳訊息(第 7 段),而是給一個 agent 一個大任務,讓它自己指揮多個 sub agent 並行。

12. Orchestration:一個 agent 指揮多個 sub agent 22:35–25:05

新建 worktree「add documentation」,給 Pi agent 一個大任務:實作 markdown 式 home lab 簡報系統,並「orchestrate 多個 sub agent 並行、用較低 thinking mode 省 token」。這個 agent 就變成協調者,側欄出現多個 sub agent tasks。但它誤啟了 Codex——作者得手動停掉,打算在 Pi 的 prompt 加 guardrail「orchestration 一律用 Pi 不用 Codex CLI」;反過來你也可以指定「前端用 Claude、API 用 Pi + MiniMax」。重要設定:agent permissions 設成 Yolo(Orca 以全權限啟動 agent、不做人工確認),否則 Claude/Codex CLI 當 sub agent 時會一直問「真的要做嗎」;Pi 預設就不會問。sub agent 完成後把結果回報給控制 agent,它驗證、分析、再 spawn 新 sub agent 修問題。

側欄裡協調 agent 底下長出多個 sub agent tasks 的樹狀結構:orchestration 在 Orca 裡的具象化。
23:04 · 側欄裡協調 agent 底下長出多個 sub agent tasks 的樹狀結構:orchestration 在 Orca 裡的具象化。
agent permissions 設成 Yolo 的設定項:這是 sub agent 不被權限確認卡住的關鍵開關。
24:08 · agent permissions 設成 Yolo 的設定項:這是 sub agent 不被權限確認卡住的關鍵開關。
承上 承接上一段的「在 main 之上開新 branch,試最有野心的賣點:一個 agent 自己指揮多個 sub agent 並行」:作者建 add documentation worktree,給 Pi 一個大任務——做 markdown 式 home lab 簡報系統、orchestrate 多個 sub agent 並行、用較低 thinking mode 省 token——這個 agent 就變成協調者,側欄長出多個 sub agent tasks。

推理因為第 7 段只證明了兩個同輩 agent 能互傳訊息,所以作者這次把 spawn sub agent(第 7 段提到但沒用的那個能力)推到極限:不指定怎麼拆,只在 prompt 裡要求「並行」與「低 thinking mode」,看協調 agent 自己怎麼分工。結果同時暴露成功與失敗:成功的是側欄與分頁真的長出多個 sub agent,完成後把結果回報給控制 agent,它驗證、分析、再 spawn 新 sub agent 修問題;失敗的是它誤啟了作者沒設定好的 Codex,得手動停掉——作者的對策不是改 Orca,而是在 Pi 的 prompt 加一條 guardrail「orchestration 一律用 Pi 不用 Codex CLI」,並反過來指出你也可以刻意混用(前端給 Claude、簡單的 API 給 Pi + MiniMax)。由 Codex 會一直要權限這件事,他帶出 agent permissions 的 Yolo 設定:Orca 以全權限啟動 agent、不做人工確認——若把 Claude/Codex CLI 當 sub agent 沒開這個,它們會不停問「真的要做嗎」把流程卡死;Pi 預設不問,這正是他選 Pi 的原因之一。

AI 補充第一張截圖(1384 秒)讓 orchestration 從抽象變具體:協調 agent 的終端裡反覆執行 `orca terminal wait --terminal term_<id> --for tui-idle --timeout-ms 60000 --json`——也就是第 3 段那個 orchestration skill 教它的指令:`orca` 是一支命令列工具,`terminal wait … --for tui-idle` 意思是「等某個終端裡的 agent 進入閒置(做完)再回來」,每個 sub agent 對應一個 `term_` 開頭的 id。畫面上三次都「exited with code 1」,最可能是 60 秒 timeout 到了 sub agent 還沒做完,協調 agent 於是再等一輪;這是輪詢式的等待,不是事件推送,所以協調 agent 本身也在持續消耗 token(狀態列 `↑39k ↓1.9k … 9.0%/372k`)。上方分頁列有 docs-templates、docs-validator、docs-architecture 三個分頁,就是它拆出的三個 sub agent,而 Orca 依 prompt 自動幫分頁取了名(第二張截圖裡有「Auto-generate tab titles」設定)。第二張截圖(1448 秒)補足 Yolo 的實作:Agent Permissions 的說明是「Choose whether Orca launches agents with fewer permission prompts or with manual checks」,選項 Yolo/Manual;下方 Installed 區列出實際啟動命令——Codex 是 `codex --dangerously-bypass-approvals-and-sandbox`、Grok 是 `grok --permission-mode bypassPermissions`、Pi 就是 `pi`——這和第 3 段截圖裡每個 agent 都帶跳過確認旗標的現象對上了:Yolo 不是 Orca 攔截確認,而是換一組啟動旗標;Pi 沒有旗標,因為它本來就不問。同一頁還有「Keep computer awake while agents are working」與「Prompt Cache Timer」(Claude 的 prompt cache 閒置太久會失效、下一則訊息要重送整份 context,所以顯示倒數)——後者提醒 orchestration 的隱性成本:多個 agent 各自持有一份 context。作者說「低 thinking mode 省 token」是對的:sub agent 做的是拆好的小任務,不需要高推理強度。至於誤啟 Codex,根本原因是協調 agent 看到第 3 段清單裡 Codex 是可用的就選了,作者的 guardrail 是治標;治本是在 Orca 設定裡把不想用的 agent 停用,讓 orchestration 根本看不到它。

術語:Yolo modeorca CLI

thinking mode

推理強度

模型在回答前花多少內部推理(reasoning)的等級設定,越高越準也越慢越貴。

第 7 段狀態列的 `gpt-5.6-sol • medium` 裡的 medium 就是這個設定。作者要求 sub agent 用較低的 thinking mode,邏輯是:協調 agent 已經把任務拆小、講清楚了,執行端不需要再花大量推理,把 token 省下來給協調與驗證。這是 orchestration 能省錢的關鍵之一——若每個 sub agent 都開最高推理,並行只會讓帳單倍增。

相關術語: sub agent (對其設定)、usage window (影響消耗速度)

出處:第 12 段「Orchestration:一個 agent 指揮多個 sub agent」

Yolo mode

全權限模式(不做人工確認)

Orca 的 agent permissions 選項:以跳過所有權限確認的旗標啟動 agent,讓它不停下來問人。

實作上就是換啟動命令:Claude 加 `--dangerously-skip-permissions`、Codex 加 `--dangerously-bypass-approvals-and-sandbox`、Gemini/Copilot 加 `--yolo`。它是 orchestration 的必要條件——sub agent 沒有人盯著,一問就永遠卡住——但也是最大風險:agent 可以不經確認刪檔、跑任何指令。隔離 worktree(見第 1 段)與容器化因此更重要:把 Yolo 的 agent 關在可丟棄的目錄裡。Pi 預設就不確認,所以對它而言 Yolo 與 Manual 沒有差別。

相關術語: sub agent (前提)、Git worktree (搭配以控風險)

出處:第 12 段「Orchestration:一個 agent 指揮多個 sub agent」

guardrail

護欄(給 agent 的硬性規則)

寫在 agent 系統 prompt 或設定檔裡、要求它在任何情況下都遵守的限制句,例如「orchestration 只能用 Pi」。

作者遇到協調 agent 誤啟 Codex,第一反應是加 guardrail 而不是改工具,這是 vibe coding(見第 7 段)的典型修法:用自然語言限制行為。它便宜但不保證生效——模型可能忽略。更可靠的做法是從工具層面移除選項(在 Orca 停用 Codex),兩者搭配最穩。

相關術語: orchestration (約束)、Pi (寫在其 prompt)

出處:第 12 段「Orchestration:一個 agent 指揮多個 sub agent」

orca CLI

Orca 命令列工具

Orca 提供給 agent 使用的命令列介面,例如 `orca terminal wait --for tui-idle`,讓 agent 能查詢、等待、對其他終端傳訊。

第 3 段的 orchestration skill 內容就是這支 CLI 的使用說明。agent 之所以能「看到其他 agent、spawn sub agent、等它做完」,全靠在 shell 裡呼叫 `orca …` 子指令並讀回 JSON。這也解釋了第 7 段的傳訊機制——訊息是 CLI 寫進另一個終端的輸入。設計上它是輪詢式(等待有 timeout、超時回 exit code 1 再重試),簡單但會讓協調 agent 持續耗 token。

相關術語: orchestration skill (被其描述)、sub agent (用以等待與傳訊)

出處:第 12 段「Orchestration:一個 agent 指揮多個 sub agent」

留給下一段 四個賣點全部驗證過了,各有亮點也各有毛邊(mobile 卡住、orchestration 誤啟 Codex、需要 Yolo);作者說「可以再玩一兩個小時」但要收尾——他得回答第 1 段自己拋出的問題:Orca 是 all-in-one 工具,還是花俏玩具?以及它適合誰。

13. 結論:Orca 讓不會寫程式的人也能做專案 25:05–26:03

作者認為 Orca 非常棒,甚至讓 coding 能力較弱的人也能開始做專案,考慮做一個 vibe coding 系列。它不只用於軟體開發:維運也能在遠端伺服器上開 project 叫 agent 檢查 compose 部署、伺服器健康狀態,甚至跑 automations。這是值得繼續探索的專案。

承上 回答上一段留下的兩個問題——Orca 是 all-in-one 還是花俏玩具、它適合誰:作者的答案是「非常棒」,而且特別點名它讓「coding 能力較弱的我們」也能做出專案,甚至想開一個 vibe coding 系列;並把適用範圍從軟體開發推到維運。

推理因為整支影片的示範都是他這個自稱不太會寫程式的人,在半小時內從零做出一個能跑、有 icon、有健康檢查端點、已 merge 進 main 的 app,所以作者對開頭問題的回答不是逐項比較功能,而是用結果說話:它確實降低了做專案的門檻。接著他回頭兌現第 1 段的另一個承諾(「不只對 AI 開發者有趣,對任何 IT 人都有趣」):維運可以在遠端伺服器上開 project(第 2、4 段的 SSH/remote 來源),叫 agent 檢查 compose 部署、伺服器健康狀態,甚至跑 automations。最後他把評價收在「值得繼續探索」而不是「必裝」,與前面誠實列出的毛邊一致。

AI 補充把整支影片對照第 1 段的四個賣點,可以整理出一份比作者結論更細的成績單:隔離 worktree(第 5、6、11 段)與瀏覽器 annotation(第 9 段)是最成熟的兩項,示範一次到位、沒出狀況;agent 間溝通與 orchestration(第 7、12 段)機制真的能動,但有誤啟錯誤 agent、需要 Yolo 全權限、輪詢耗 token 三個代價;mobile companion(第 10 段)作者自己都說有時卡住,且影片沒有實際手機畫面。所以「all-in-one 還是玩具」的答案更準確地說是:對「讓 agent 寫、人審閱」這種工作方式,Orca 目前是最完整的殼;對仍以手寫程式為主的人,它取代不了 IDE(第 5 段)。作者對維運場景的推論是合理的延伸但沒有示範:讓 agent 在遠端伺服器上「檢查 compose 部署與健康狀態」屬於唯讀操作,風險低、很適合 Yolo 模式;但若讓 automations 定時執行會改動系統的指令,就要記得第 12 段的提醒——Yolo 的 agent 沒有任何確認關卡,隔離手段(worktree、容器)在遠端伺服器上並不天然存在。最後一個實務提醒:整支影片的 demo 只用了一種 agent(Pi)與一個訂閱,作者對「不綁特定 agent」的驗證其實只到第 3 段的清單與第 12 段的 Yolo 旗標,多 agent 混用(前端 Claude、後端 Pi)是他建議的用法而非示範過的結果。

術語:Automations (Orca)

Automations (Orca)

Orca 自動化任務

Orca 側欄的一個功能區,可設定在排程或事件觸發時自動執行 agent 任務或指令,不需人手動啟動。

第 2 段介面導覽時它就在左欄(Tasks 下面),但作者直到結尾才說明用途:例如定期叫 agent 檢查伺服器健康、compose 部署狀態。它把 Orca 從「人開著才有用的工作台」推向「無人值守的執行器」,也因此和 Yolo 模式(見第 12 段)綁在一起——自動化執行時沒有人可以回答權限確認。影片沒有實際示範,細節要自己試。

相關術語: Yolo mode (前提)、agent prompt (quick command) (排程版)

出處:第 13 段「結論:Orca 讓不會寫程式的人也能做專案」

operations (ops)

維運

部署、監控、維護正在運行的系統的工作,相對於開發新功能。

作者的頻道主軸是 home lab 與維運,所以他特別強調 Orca 不只給開發者:把 project 指向遠端伺服器(第 2 段 SSH、第 4 段 remote 來源),agent 就能在那台機器上讀設定、跑 docker compose ps、看日誌。維運場景的特色是「大多是唯讀檢查、偶爾要改」,和 agent 的長處(讀很多東西、整理、回報)非常合;但要改動時,遠端伺服器沒有 worktree 那種可丟棄的沙盒,Yolo 模式要更小心。

相關術語: SSH (連線手段)、Docker Compose (常見檢查對象)

出處:第 13 段「結論:Orca 讓不會寫程式的人也能做專案」

留給下一段 總結收束

4. 總結

作者先把 Orca 定位成 ADE(不是 IDE):重點不是能跑 agent,而是圍繞 agent 建了什麼,並拋出「all-in-one 還是花俏玩具」的問題 → 介面三欄與三個必要設定(agents、provider 帳號、orchestration skill)→ 匯入 repo 後,用 Git worktree 把每個 feature 放進磁碟上實體隔離的目錄 → 在 worktree 裡讓 Pi agent live coding 一個 home lab 管理 app,第二個 agent 透過 orchestration skill 傳訊給第一個 agent 寫文件 → quick command 用「agent prompt」起 dev server、內建瀏覽器看成品 → annotate page element 把「哪個元素+想怎麼改」直接組成 prompt 送 agent → mobile companion 可用但偶爾卡住 → GUI source control 走完 commit、merge request、刪 worktree、pull 回 main 的生命週期 → 一個 agent 指揮多個 sub agent,成功分工回報但誤啟 Codex、需要 Yolo 權限 → 結論:它讓不太會寫程式的人也能做出專案,維運場景也適用,值得繼續探索但仍有 bug。

勘誤總整理

確定錯誤/已過時見仁見智(取決於版本或情境)

段落原話(transcript 逐字)說明
8. Quick commands 與內建瀏覽器看成果
17:49
「It actually added my real Proxmox node. So, this my real production server.」畫面上這筆資料是 Proxmox Node 01、IP 10.20.0.11、主機名 pve01.home.arpa。`home.arpa` 是 RFC 8375 保留給家用網路的範例網域,加上作者自己隨後輸入的真實主機名格式完全不同(prox-prod-2.home.<他的網域>.de),這幾乎可以肯定是 agent 生成的種子資料,不是從作者環境讀到的真實節點;他說的「DNS 解析不正確」是因為資料本來就是虛構的。標 debatable 是因為無法百分之百排除作者剛好有一台叫 pve01 的節點。
依據: 截圖 frames/s08_1062.jpg 的資料表;RFC 8375(home.arpa)

5. 推薦三個下一步

1. 往下挖深:Git worktree 本體

影片把 worktree 當黑盒子用(Orca 幫你建目錄、連回 repo);懂 git worktree 指令與限制(同一 branch 不能 checkout 兩次、如何清理)才知道 Orca 幫你省了什麼、何時會出錯。

YouTube 搜尋:git worktree tutorial git worktree parallel AI agents git worktree vs branch

2. 往旁邊對照:其他 ADE/多 agent 工作台

作者只用 Orca 驗證了 ADE 的概念;把它和 Conductor、Claude Squad、Warp 等同類工具對照,才能判斷「隔離 worktree+多 agent+瀏覽器」哪些是 Orca 獨有、哪些是這類工具的共同做法。

YouTube 搜尋:Orca vs Conductor AI agents Claude Squad tmux worktree agent development environment comparison

3. 往上應用:agent orchestration 的 prompt 與 guardrail

第 12 段的失敗(協調 agent 誤啟 Codex、被權限確認卡住)顯示 orchestration 的品質取決於你給協調 agent 的規則;學怎麼寫 orchestrator prompt、拆任務、設 guardrail,才能把 sub agent 真的用起來。

YouTube 搜尋:multi-agent orchestration prompt engineering Claude Code subagents workflow AI agent guardrails orchestration

📄 全部影片 · 主題區: 工程職涯與架構角色