AI編程：OpenCode 入門 | Plan & Build 模式 | Agent,command,Skill|教學|廣東話|60fps

OpenCode 是專為 AI 時代設計的開源程式編輯夥伴，解決傳統 Coding Agent 的兩大問題：上下文爆炸和模型昂貴。它提供 Terminal 版（TUI）與 Desktop 版（GUI）兩個介面，功能基本相同，但 Terminal 版資訊展示更循序漸進、對初學者友善。安裝只需 npm install -g @opencode/cli，進入專案目錄執行 opencode 命令即可啟動。

配置系統分為全域層（~/.config/opencode）和專案層（.opencode/），這種分層設計讓團隊制定共同規範，個人客製化偏好。主配置檔 opencode.jsonc 儲存模型、Provider、LSP、MCP 伺服器設定；agents.md 是開發者為 AI 撰寫的指引文件，例如要求「務必加入代碼註釋」或「安全審查」，AI 生成程式時會參考。Commands、Skills、Agents 的安裝超簡單——只需將 markdown 檔案放入對應資料夾，OpenCode 自動掃描識別。例如建立 git-init 命令，在 ~/.config/opencode/commands 下放一個 git-init.md 檔案定義 git init 和 .gitignore 產生，執行時 OpenCode 會自動運行。Skills 特別值得關注，它們是可重複觸發的行為腳本，例如「Folder Chart from Source」能自動掃描程式碼產生結構圖成 HTML，社群市集（mpx 或類似平台）有現成 Skills 庫可安裝。

代理程式架構是 OpenCode 最精妙的設計，解決上下文爆炸難題。系統只有兩個 Primary Agents——Build（直接修改磁碟）和 Plan（生成計畫但不修改），各自有獨立上下文窗口。底層有四種 Sub-Agents：Journal（同時讀寫）、Explore（唯讀）、General（通用目的）、Skill（自動執行技能）。當 Primary Agent 需要大量讀寫操作時，會自動或手動委派 Sub-Agent 完成，返回摘要即可，這樣 Primary Agent 上下文保持精簡。開發者也可自訂 Sub-Agents，例如建立 security-advisor 審查程式碼網路安全，放在 .opencode/agents 自動識別。模型選擇透過 /connect 指令切換 Provider，演講者推薦免費的 DeepSeek V4 Flash Free，其他選項包括 Open Router（按用量計費）、Google、Anthropic 等。Variance 參數控制思考深度，Low 適合簡單、Max 適合複雜推理。監控上下文是重要習慣——OpenCode 實時顯示 Token 百分比，超過 50% 應執行 Compact 壓縮舊對話，或執行 New 開新 Section 清空該段。

LSP（Language Server Protocol）整合讓 AI 不再當純文本編輯器而是真正的語言感知系統。啟用方法是在 opencode.jsonc 加 "lsp": {"enabled": true}，重啟後 OpenCode 自動偵測安裝的語言延伸（例如 Python 用 Pyleft、JavaScript 用其他）。啟用後，AI 懸停變數時看到型別、函數簽名、型別檯誤等，大幅提升生成程式碼的準確性和安全性。Desktop 版額外支援主題選擇（深淺）、字型設定、語言切換（英文/中文），操作習慣與 Terminal 版一致，但傾向一次展示所有資訊，初學者先學 Terminal 版較易理解。

Debugging 進階技巧應對複雜 Bug：絕不能反覆叫 AI 嘗試修復，應先輸出 Debug Log 觀察資料流變化，準確定位問題根源。最重要的是使用 Plan Mode 尋找 Root Cause，再限制 AI 在特定位置修復。Build Mode 的即時修復常導致波及其他功能的迴圈式 Bug——修復 A Bug 導致 B 出現，修復 B 又讓 A 回來。Plan Mode 讓開發者預覽完整修復方案，確認根本原因找對了才動手，大幅減少迴圈 Bug。