窗外正下著細雨，咖啡館裡放著輕柔的爵士樂，蒸氣從你手邊的馬克杯上方緩緩升起。坐對面的我，看著你凝視螢幕上那個一閃一閃的黑小窗游標、眼神裡透出的一絲不安，忍不住笑了笑。
老朋友，別緊張。今天找你來這間安靜的咖啡館，不是要給你考前壓迫，而是想把你當成最知心的夥伴，好好跟你掏心掏肺，聊聊我這幾年踩過無數坑之後，摸索出來的這個秘密武器——Antigravity CLI（大家親切稱為 agy 的智慧大副）。
把你的美式咖啡喝一口，放鬆肩頸。今晚，我們不講高深的學術教條，我會像在桌邊遞給你一張手繪藍圖一樣，把安裝、授權登入到安全退場的所有眉角，一次為你全部解密。
我懂你在怕什麼。幾乎每一個剛接觸 CMD 或 PowerShell 的新手，看到那個黑漆漆、沒有任何圖像按鈕的視窗時，心裡都會懸著一顆石頭。
你心裡是不是在想：「萬一我不小心打錯一個字，電腦會不會立刻跳出紅字、硬碟裡的照片被清空、甚至整台機器直接當機冒煙？」
老朋友，我以我多年在開發第一線摸爬滾打的經驗向你保證：命令列介面（Command Line Interface）是全世界最老實、最不可能被你弄壞的對話框！
電腦其實是個非常呆板的機器，它完全沒有人類那種複雜的內心戲。當你在終端機裡打錯指令時，它不會偷偷報復你，它只會像個困惑的小孩一樣，老老實實地在畫面上印出一行「找不到這個命令」，然後乖乖地坐在那裡，閃爍著游標，等待你輸入下一次正確的文字。它完全沒有你想像中那麼危險！
這就像是我們去看魔術表演。台上魔術師把助理關進箱子裡鋸成兩半再黏回來，台下觀眾驚呼連連；但如果魔術師把背後的物理機關、視覺盲點拆開給你看，你會發現那根本不是什麼超自然現象，只是巧妙設計的結構。今天我們坐在這裡，就是要一起把黑小窗背後的機關拆開，讓恐懼在咖啡香中徹底消散。
特別是對於我們身邊使用螢幕閱讀器（像是 NVDA 或 JAWS 朗讀軟體）的視障同學來說，大家常以為視覺看不到就更難操作命令列，但真相剛好完全相反！
想想看，現在的圖形介面（GUI）網頁變成了什麼樣子？滿畫面的動態橫幅廣告、亂七八糟的自動彈窗、嵌套了三四層的複雜表格，還有無數個必須把滑鼠游標移上去才會顯現的隱藏按鈕。這些對明眼人來說也許只是視覺雜訊，但對螢幕閱讀器來說，簡直是極度殘酷的障礙迷宮！朗讀軟體的語音會不斷被廣告攔截、被無意義的標籤打斷。
但在這個黑小窗裡，世界瞬間安靜了下來。
命令列沒有任何多餘的視覺包裝，沒有廣告，沒有遮擋畫面的彈窗。它是一個 100% 純粹的文字流（Pure Text Stream）。你輸入一行指令，系統就回傳最乾淨的文字結果。對螢幕閱讀器來說，這是一條零干擾、最聽話、朗讀體驗極度優雅的綠色高速通道！
這時候你可能會抿一口咖啡，好奇地問我：「老兄，既然要用 AI，為什麼我們不直接在自己電腦裡裝一個本地模型（例如用 Ollama 跑 Llama 3），而要大費周章安裝 agy 去連線雲端呢？」
這問到了最核心的技術選擇！我們來做個極度貼切的比喻：
agy 連接 Google Gemini）：這就像是你手裡握著一台「天界對講機」。你的筆電本身不需要做任何繁重的數學矩陣運算，當你按下 Enter 時，agy 只負責把你的文字打包，透過網路瞬間傳送到雲端的超級電腦基地。基地裡成千上萬張頂級顯卡算好答案後，再把結果傳回對講機，列印在你的螢幕上。哪怕你用的是十年前的老舊筆電，只要能連上網路，透過這台天界對講機，你就能直接調用兆級參數規模的全球頂尖智慧！
這就像是動漫裡常出現的決鬥場景：以前我們辛辛苦苦自己寫代碼、訓練小模型，就像是拔出鋼劍一招一式苦練；而現在直接呼叫雲端 API，就像是對方還在擺架勢練劍，你已經默默從外套口袋掏出一把手槍，瞬間解決問題。
如果用《葬送的芙莉蓮》來比喻，我們今天要安裝的 agy，就是你在黑小窗畫出的「召喚法陣」。
當你在終端機中敲下安裝指令，就是在你的魔法書上寫下契約，將一位名為「大副」的自律型使魔綁定在身邊。每當你呼叫它，它會透過雲端通道，向天界借用源源不絕的龐大魔力幫你幹活，而你本身的魔力（電腦硬體資源）幾乎毫無消耗。
這就像八十年前被世人視為逆天神技、需要極高天賦才能施展的「殺人魔法」，在普及防禦術後的今天，只被當成最基礎的「普通攻擊」一樣。有了大副，寫程式與自動化處理不再是少數工程師的特權，而是每個人隨手就能揮出的基礎魔法！
irm | iex 逐字密碼解碼好啦，掏心話說完了，讓我們把手放在鍵盤上，正式把這位智慧大副召喚出來！
請跟著我的步驟，慢慢來，不要急：
powershell，然後按下 Enter 鍵。此時畫面上會跳出一個藍色或黑色的視窗，這就是我們的魔法發射台。irm https://antigravity.google/cli/install.ps1 | iex
我們坐在咖啡館裡，把這行咒語拆開來逐字剖析，你會發現它有多麼精妙：
irm：這是 Invoke-RestMethod 的縮寫指令。它的職責就像是一個快遞員，負責透過網路連線到 Google 的官方伺服器，把寫好的 install.ps1 安裝腳本完整抓回你的電腦。|（管道符號 Pipe）：這是鍵盤上 Shift 加上反斜線的直槓符號。你可以把它想像成一根透明的水管，把左邊 irm 抓下來的安裝腳本，不落接地直接串流輸送給右邊。iex：這是 Invoke-Expression 的縮寫指令。它接住水管另一端流過來的腳本，直接在你的本地系統中啟動執行。整條指令就像是一條自動化裝配水管，你不需要像以前安裝軟體那樣狂按十幾次「下一步」，它自己就會在背景把環境全部佈置好！
不過，老朋友，既然是實戰，我們就不能只講順利的情況。在安裝過程中，你可能會遇到以下三個常見的阻礙，別怕，解決方案我都幫你準備好了：
這是 Windows 系統的安全警報響了。系統預設害怕你隨便執行網路上的不明腳本。請在 PowerShell 中輸入這行解除封鎖指令：
Set-ExecutionPolicy Bypass -Scope Process
這行指令的意思是告訴 Windows：「我是這台電腦的管理員，我現在以臨時行程（Scope Process）的權限放行這段安全腳本。」放行後，再次重新貼上 irm ... | iex 指令，就能順利通過！
如果你是在嚴格管控的企業或校園網域內，安裝可能會卡在連線超時。請在執行安裝前，先在 PowerShell 中設定以下兩行環境變數打通網域通道：
$env:HTTP_PROXY="http://你的代理伺服器位址:連接埠"
$env:HTTPS_PROXY="http://你的代理伺服器位址:連接埠"
當安裝程式顯示「Success」後，請務必手動關閉目前的 PowerShell 視窗，並重新開啟一個全新的 PowerShell 視窗！
這是因為 Windows 系統的環境變數（PATH）只會在視窗開啟的瞬間讀取一次。如果你不關掉重開，系統的記憶體還不認識剛安裝進來的 agy 指令，你打 agy 它只會回報找不到命令。重開視窗後，打入以下指令驗證：
agy --version
只要畫面上跳出版本號碼，就代表我們的使魔大副已經成功站在門外，等待你下達第一道命令了！
settings.json 五大核心鍵值拆解第一次啟動大副時，請在終端機中輸入 agy 並按下 Enter。
此時系統會自動啟動你的預設瀏覽器，跳出 Google 帳號的 OAuth 授權視窗。點擊允許授權後，網頁會顯示出一串安全的授權碼（Authorization Code）。將這串程式碼複製並貼回你的終端機視窗中，登入手續就大功告成了！
授權完成的瞬間，大副會在你的個人使用者主目錄下，悄悄建立一個隱藏的設定資料夾，並寫入配置文件：
C:\Users\你的用戶名\.gemini\antigravity-cli\settings.json
這個 settings.json 檔案是大副的心臟控制台，裡面有五個非常關鍵的設定鍵值，你可以隨時用記事本打開修改它：
colorScheme：預設為 "terminal"。如果你喜歡沉浸感，可以修改為 "dark"（深色）或 "light"（淺色），為大副的黑小窗換上不同風格的衣服。verbosity：預設為 "high"。這代表大副在思考問題時，會把所有的推理步驟、工具調用細節完整列印出來。如果你希望畫面乾淨一點，可以將其調成 "low"。historySize：預設為 2000。代表大副最多會在磁碟中為你保存兩千條歷史指令。如果你希望紀錄永久保留，可以將其改為 -1。allowNonWorkspaceAccess：預設為 false。這是一個非常嚴格的安全防護罩！它限制大副只能在目前開啟的專案資料夾內活動，絕對不能跨區讀寫你硬碟裡的其他私密文件。trustedWorkspaces：這是一個陣列清單 [ "C:\\ai pro\\agy" ]，用來記錄你明示信任的專案目錄。只有在這個清單中的資料夾，大副才被允許全速運作、執行命令。上下左右，可以移動，要注意：在哪個位置，大於符號在哪裡，焦點就在哪裡。選擇選項要特別注意，尤其選擇 done 你要往右移動一些才能選到，不只是上下選擇。
/logout 與 /quit 的安全密碼夜深了，咖啡也喝得差不多了。在我們離開咖啡館前，最後這一步安全退場機制，你一定要牢記在心：
如果你是在學校電腦教室、圖書館或公司的公用電腦上使用大副，離開前請務必在對話框中輸入：
/logout
這個指令會立刻清空本機硬碟中留存的所有 OAuth 登入 Token 與對話快取，確保下一位使用者絕對無法冒用你的身分與雲端資源，徹底保護個人隱私與帳號安全！
而如果你是在自己的個人筆電上作業，忙完後只需要輸入 /quit（或直接輸入 exit），就能優雅地關閉大副，讓它在背景安心休息。
好了，老朋友！魔法手槍已經裝填完畢，使魔契約也已經簽署完成。把杯中最後一口咖啡喝掉，下一堂課，我們要一起走進黑小窗的世界，看看怎麼用最酷的姿勢操控它！
準備叫 阿吉 來幹活兒了嗎? 自己可以先試試，等玩夠了再來看下一章也不遲。
👉 下一堂課：Lecture 01.2 盲杖、地城與黑小窗冒險：CMD / PowerShell 十大地城術語與 NVDA 報讀快速鍵 👉 回課程大綱：學習地圖
以下題目專為尋求真正硬核觀念與專家級實戰能力的學員設計。題目無法從講義表面抄寫解答，請嘗試獨立思考後再點擊展開解析。
【實戰情境問題】：在企業專案中，當團隊考慮使用本地開源模型（如 Ollama + Llama 3 8B）代替雲端 API（如 Gemini 1.5 Pro）時，除了資料隱私考量外，在「高併發吞吐量 (High Concurrency Rate)」與「長上下文 KV Cache 顯存佔用」架構上，會面臨什麼致命的硬體與延遲瓶頸？
【鑑別點說明】：本題測試學員是否真正理解大模型推論（Inference）時顯存（VRAM）頻寬對序列產生的物理限制，而非僅停留在「本地不用錢、雲端要收費」的表面印象。
【專家級解答與深度剖析】： 雲端 API（如 Gemini）後台擁有數千張 H100/TPU 組成的巨型叢集，支援 PagedAttention 與分散式 Context Caching，能在多使用者同時發問時進行動態 Batching。而本地開源模型在單張消費級顯示卡（如 RTX 4090 24GB）上運行時，KV Cache 的顯存佔用會隨上下文長度與 Concurrent 使用者數量呈線性甚至二次方暴增。一旦超過顯存上限，系統會強制退回系統主記憶體（RAM），導致推論速度從每秒 50 Token 暴跌至每秒 1~2 Token，產生嚴重的 Head-of-Line Blocking 阻塞。
【實戰情境問題】：在 CLI 命令列環境中，為什麼即便使用者在本地電腦執行 `agy` 指令，API Key 的安全管理仍然絕對不能直接硬編碼 (Hardcode) 在腳本或環境變數（`.env`）中？在多使用者共用系統（如 Linux/Windows Server）上會造成什麼權限洩漏風險？
【鑑別點說明】：測試學員是否具備資安與作業系統進程隔離（Process Isolation）的實戰防護意識。
【專家級解答與深度剖析】： 在 Windows/Linux 等多使用者或共用環境中，一般使用者透過 `ps`（Linux）或工作管理員/PowerShell `Get-Process`，可以讀取其他使用者正在執行的命令列參數與環境變數快照。若將 API Key 寫在環境變數或腳本文字中，同機的其他低權限帳號或惡意腳本就能輕鬆竊取 Key。權威的作法是利用作業系統原生的安全金鑰庫（如 Windows Credential Manager 或 macOS Keychain）進行受加密保護的硬體級儲存。