# 影片筆記：2026版AI+Codex零基础全套视频课程，Codex从入门到大神AI编程开发，涵盖安装配置、代码分析、Bug修复及完整项目实战 p06 5、Codex 斜杠指令体系与业务场景调度实战

## 一句話總結

本段影片詳細演示了 Codex 開發環境中的「斜杠指令（Slash Commands）」體系，涵蓋權限管理、模型切換、工作流模式（Plan/Go/RAW）、對話上下文處理（Side/Fork/Clean）、專案初始化（Init）、程式碼審查（Review）以及外部工具整合（MCP/Hooks）等核心功能，旨在透過指令化操作提升開發效率與靈活性。

## 核心重點

1.  **權限與環境控制**：Codex 預設處於受限的「沙箱模式」，需透過指令切換權限（如 Read Only、Auto Review、全權），並手動授權目錄訪問。
2.  **模型與風格設定**：支援切換不同模型版本（如 GBT5.3 與 5.5）以適應代碼生成或推理需求，並可調整 AI 性格（工程協作型 vs. 友好助理型）。
3.  **工作流模式**：
    *   **Plan（規劃模式）**：僅輸出計劃不執行，適合需求文檔生成。
    *   **Go（目標模式）**：後台自動執行目標，支援暫停/恢復，適合無需人工介入的開發。
    *   **RAW（簡潔模式）**：減少冗餘輸出，直接顯示關鍵結果，便於複製。
4.  **對話與上下文管理**：提供清空（clean）、壓縮（compress）、分支（fork）、側邊臨時對話（side）及恢復（resume）等功能，以精確控制對話狀態與 Token 消耗。
5.  **專案規範與審查**：
    *   **Init 指令**：自動生成 `agents.md` 規範文件，定義專案開發契約。
    *   **Review 指令**：支援分支、PR 或未提交檔案的程式碼審查，建議使用特定模型版本（如 5.3）以確保審查質量。
6.  **外部整合與擴展**：支援 MCP（Model Context Protocol）服務狀態檢查、外部應用揭露、插件（Plugins）安裝及生命週期鉤子（Hooks）自訂邏輯。

## 詳細大綱

### 一、 權限與環境控制 (Permissions & Environment)
1.  **權限切換 (`promission`)**
    *   預設為非管理員的「沙箱模式」，敏感操作需授權。
    *   模式選項：
        *   `Read Only`：僅適用於閱讀源代碼。
        *   `Auto Review`：自動審查，危險操作（如刪除）仍需人工授權。
        *   全權模式：Codex 接管，無需確認直接執行。
2.  **授權審批 (`approved`)**
    *   當 `Auto Review` 拒絕危險操作時，使用此命令進行人工確認與批准。
3.  **沙箱目錄授權 (`sandbox`)**
    *   預設僅能訪問當前目錄。
    *   需手動授權額外目錄路徑，否則無法讀取或分析其他目錄結構。
    *   授權後無需重複確認。

### 二、 模型、風格與界面設置 (Model, Personality & UI)
1.  **模型切換 (`GunModel`)**
    *   快速切換不同模型版本。
    *   範例：從 GBT5.3（適合生成代碼）切換至 5.5（適合推理論務）。
2.  **性格/風格切換 (`Personality`)**
    *   `Programmatic`：偏工程協作，嚴謹，負責任務執行。
    *   `Friendly`：溫暖、好奇的工程搭子，具備高情商，協助處理工作與讀代碼。
    *   也可透過提示詞強制調整角色。
3.  **界面與快捷鍵設置**
    *   `IDE`：切換至特定編輯器（如 VS Code, Cursor）。
    *   `keymap`：設置或修改快捷鍵，建議預設，除非有衝突或習慣差異。
    *   `Theme`：切換編輯器主題（如 BeatHub 風格、暗黑模式、亮色模式）。
    *   `status line`：配置底部狀態欄顯示內容（如模型、目錄等）。
    *   `title`：配置頂部標題欄顯示項目（如當前目錄、項目名稱）。

### 三、 工作流與任務模式 (Workflow & Task Modes)
1.  **規劃模式 (`Plan`)**
    *   僅進行規劃，不執行具體任務。
    *   輸出計劃細節，可選擇「實現計劃」自動切換至編碼模式，或「清理上下文」後實現。
    *   適用場景：生成需求文檔、大綱，尚不需生成文件時。
2.  **目標模式 (`Go`)**
    *   設定目標後，Codex 自動圍繞目標執行，無需人工介入。
    *   後台任務，類似「一步現成」，用戶可處理其他事務。
    *   支援操作：`clean`（暫停）、`resume`（恢復）、`remove`（移除）。
    *   適用場景：全程無需人工介入的需求開發。
3.  **簡潔模式 (`RAW`)**
    *   預設模式輸出詳細執行過程與命令。
    *   `RAW` 模式：忽略冗餘過程，直接輸出關鍵結果與代碼，便於複製與選中。
    *   缺點：反饋較慢，需等待關鍵步驟。

### 四、 對話管理與上下文處理 (Conversation & Context)
1.  **基礎對話操作**
    *   `clean`：清空上下文，發起新 Session。
    *   `new`：全新對話。
    *   `resume`：恢復之前的對話。
    *   `copy`：複製最新回覆（快捷鍵 `Ctrl + O` 效果相同）。
2.  **對話壓縮 (`compress`)**
    *   針對長對話，總結關鍵內容，替換舊上下文，降低 Token 消耗比例。
3.  **分支與側邊對話**
    *   `fork`：複製當前對話作為基礎，開啟新對話路線（適用於根據同一需求開發不同分支，如測試用例）。
    *   `side`：從當前對話啟動臨時分岔，不離開主任務。
        *   特性：僅帶入主對話記錄，但子對話內容**不會**保存回主對話。
        *   適用：臨時查詢或輔助討論，結束後不影響主線。
    *   `miss`：類似 `side`，單獨開頻道，聊完後記錄不匯入主對話。

### 五、 進階功能與疑難排解 (Advanced & Troubleshooting)
1.  **後台進程查看 (`ps`)**
    *   用於查看後台執行的目標或任務。
    *   **限制**：僅在 Codex 內部託管的後台任務或定時任務執行時可見；系統級後台命令（如 `sleep`）可能無法被 `ps` 識別，需具體驗證。
2.  **代碼差異查看 (`dif` / `getdiff`)**
    *   `dif`：查看代碼修改差異。
    *   **兼容性問題**：在 Windows 沙箱環境下，`dif` 命令可能因兼容性问题報錯。
    *   **解決方案**：使用 `getdiff` 命令，效果相同且兼容沙箱環境。
3.  **文件引用 (`mention`)**
    *   將特定文件加入對話並高亮，便於後續直接引用分析（如需求文檔）。
4.  **實驗性功能 (`experimental`)**
    *   開啟 Beta 版高級功能，如 `memorize`、`network proxy`、`mentionVR` 等。
5.  **記憶功能 (`memories`)**
    *   配置是否啟用記憶功能。關閉後，每次聊天視為全新 Session，不記錄歷史對話信息。
6.  **中斷任務 (`stop`)**
    *   中斷所有後台終端任務。

### 六、 專案初始化與規範生成 (Init)
1.  **Init 指令功能**
    *   主要用途：生成 `agents.md` 檔案。
    *   運作邏輯：根據當前專案的情況分析，自動生成適合的規範文件。
    *   差異性：不同專案生成的 `agents.md` 內容會有所不同。
2.  **agents.md 的內容與目的**
    *   定義：專案開發規範、模組說明、編碼風格約定。
    *   核心概念：作為一種「約定」或「契約」，以規範驅動開發邏輯。
    *   語言支援：預設可能為英文，可透過指令要求轉換為中文版。
    *   後續：將在專門章節詳細講解其架構與撰寫方式。

### 七、 程式碼審查 (Review)
1.  **Review 指令功能**
    *   用途：執行程式碼審查 (Code Review)。
    *   支援情境：
        *   基於當前分支 (Branch)。
        *   Pull Request (PR) 風格。
        *   針對特定分支 (如 master)。
        *   審查未提交的變更 (Changes) 或檔案。
2.  **工作流程**
    *   檢查程式碼是否已提交。
    *   檢查當前程式碼是否有問題。
3.  **技術細節與建議**
    *   **DIF 指令問題**：在刷專案時執行 `DIF` 可能會報錯，建議直接執行 `Git.dif` 進行處理。
    *   **模型配置**：可在 `config.tom` 中配置審查使用的模型。
    *   **版本建議**：
        *   預設可能使用當前對話模型 (如 5.5)。
        *   **強烈建議**：使用 **Codex 5.3** 版本進行審查，因為涉及程式碼相關工作，該版本表現較佳。

### 八、 外部工具與服務整合 (MCP & Apps)
1.  **MCP (Model Context Protocol)**
    *   功能：查看已安裝的 MCP 配置與實例。
    *   狀態檢查：可檢視 MCP 程式的當前狀態。
    *   後續：將在細節章節專門講解 MCP 服務。
2.  **Apps (應用揭露)**
    *   功能：Codex 可揭露外部應用。
    *   版本差異：新版本 (Beta) 可能已取消此功能 (如提及的 `app ppp`)，老版本可能仍有。
    *   狀態：若升級後消失，屬正常現象，可透過 `mentition` 功能確認是否關閉。

### 九、 插件與生命週期管理 (Plugins & Hooks)
1.  **Plugins (插件)**
    *   功能：系統內置或使用者安裝的各種插件。
    *   擴展性：後續將講解如何搭建與開發自訂插件。
2.  **Hooks (鉤子/生命週期管理)**
    *   功能：管理對話各個階段的觸發點。
    *   適用階段：
        *   準備壓縮上下文。
        *   管理對話停止。
        *   對話開始。
        *   調用工具時。
    *   應用場景：在特定階段加入自訂邏輯，例如：
        *   發送郵件或簡訊通知。
        *   生成訊息後發送通知。
    *   目的：讓使用者能在整個使用過程中，於對話各階段執行自訂的小邏輯或任務。

### 十、 介面選擇建議
*   **命令行 (CLI)**：
    *   優點：Codex 最初為命令行版本，效率不錯，適合習慣命令行的使用者，能快速提升效率。
    *   缺點：若不習慣命令，可能較難上手。
*   **圖形化介面 (GUI)**：
    *   優點：直觀，可安裝插件 (如提及的 `Coser`)。
    *   缺點：對於不頻繁使用的命令，點擊操作可能效率較低，有時反而比命令行慢。
*   **結論**：根據個人使用習慣選擇。若習慣命令行則用命令行提高效率；若不習慣則使用 GUI。建議掌握常見指令的功能，以實際情況決定是否使用以提升效率。

## 工具 / 模型 / 名詞整理

*   **Codex**：影片討論的核心 AI 開發助手/IDE 插件。
*   **GBT5.3**：Codex 的一個模型版本，適合生成代碼。
*   **5.5**：Codex 的另一個模型版本，適合推理論務。
*   **VS Code**：提及的編輯器之一。
*   **Cursor**：提及的編輯器之一。
*   **Linux**：提及的操作系統環境，Vim 模式在此環境下效率較高。
*   **Windows**：提及的操作系統環境，沙箱環境下的命令兼容性問題在此環境被提及。
*   **Vim**：提及的編輯模式，Codex 支援切換至 Vim 編輯方式。
*   **Git**：提及的代碼版本控制工具，`dif` 命令與 Git 差異相關。
*   **agents.md**：自動生成的專案規範文件，定義開發規範與編碼風格。
*   **config.tom**：用於配置審查模型的設定檔。
*   **MCP (Model Context Protocol)**：模型上下文協議，用於整合外部服務。
*   **Coser**：提及可在 GUI 中安裝的插件名稱 (需查證確切名稱)。
*   **BeatHub**：提及編輯器風格時出現，疑點：是否為 `GitHub` 或 `JetBrains` 相關主題的聽寫錯誤？

## 操作流程整理

### 1. 權限與環境設置流程
1.  檢查當前權限狀態（預設為沙箱模式）。
2.  若需訪問非當前目錄，執行 `sandbox` 指令並授權目錄路徑。
3.  根據需求切換權限模式：
    *   僅閱讀：執行 `promission Read Only`。
    *   自動審查：執行 `promission Auto Review`。
    *   全權接管：執行全權模式指令。
4.  若遇危險操作被拒絕，執行 `approved` 進行人工審批。

### 2. 模型與風格切換流程
1.  執行 `GunModel` 指令切換至所需模型版本（如 GBT5.3 用於代碼，5.5 用於推理）。
2.  執行 `Personality` 指令調整 AI 性格（Programmatic 或 Friendly）。
3.  （可選）透過提示詞強制調整角色。

### 3. 工作流模式選擇流程
1.  **規劃階段**：執行 `Plan` 指令，僅生成計劃細節。選擇「實現計劃」進入編碼，或「清理上下文」。
2.  **後台執行階段**：執行 `Go` 指令設定目標，Codex 自動後台執行。用戶可隨時執行 `clean`（暫停）、`resume`（恢復）或 `remove`（移除）。
3.  **簡潔輸出階段**：執行 `RAW` 指令，忽略冗餘過程，直接獲取關鍵代碼結果。

### 4. 對話管理流程
1.  **新建/恢復**：使用 `clean` 清空上下文，或 `resume` 恢復歷史對話。
2.  **複製回覆**：使用 `copy` 或快捷鍵 `Ctrl + O` 複製最新回覆。
3.  **壓縮上下文**：針對長對話，使用 `compress` 總結關鍵內容以節省 Token。
4.  **分支對話**：
    *   使用 `fork` 複製當前對話開啟新路線。
    *   使用 `side` 啟動臨時分岔，查詢結束後不影響主線。

### 5. 專案初始化與審查流程
1.  **初始化**：執行 `Init` 指令，根據專案情況自動生成 `agents.md` 規範文件。
2.  **審查準備**：確保程式碼已提交或針對特定分支/PR。
3.  **執行審查**：執行 `Review` 指令。
    *   若遇 `DIF` 報錯，改用 `Git.dif`。
    *   建議在 `config.tom` 中配置使用 Codex 5.3 模型進行審查。

### 6. 外部工具與擴展配置流程
1.  **MCP 服務**：執行 MCP 相關指令查看已安裝配置與實例狀態。
2.  **應用揭露**：檢查 Apps 狀態，確認新版本是否已取消特定功能。
3.  **插件管理**：安裝或管理 Plugins。
4.  **鉤子配置**：在 Hooks 中設定對話生命週期各階段（開始、停止、調用工具等）的自訂邏輯（如發送通知）。

## 值得注意的限制或風險

1.  **權限限制**：預設沙箱模式下，敏感操作（如刪除文件）需人工授權，無法直接執行。
2.  **目錄訪問限制**：預設僅能訪問當前目錄，需手動授權其他目錄路徑才能讀取或分析。
3.  **命令兼容性**：
    *   在 Windows 沙箱環境下，`dif` 命令可能因兼容性問題報錯，需改用 `getdiff` 或 `Git.dif`。
    *   系統級後台命令（如 `sleep`）可能無法被 `ps` 識別。
4.  **Side 對話數據隔離**：`side` 啟動的臨時分岔對話，其內容**不會**保存回主對話，需注意上下文丟失風險。
5.  **模型版本差異**：不同模型版本（如 5.3 vs