需求
應用程式日誌記錄
預設選項
為何需要
結構化的統一日誌讓 Codex 能篩選出特定流程的事件,逐次核對執行結果,也省去在程式碼中四處插入 print 陳述式的麻煩。
.md ,即可取得該頁面的 Markdown 版本。
Codex 應用案例
用 Codex 為一項 Mac 功能加入 Logger 事件記錄,再執行應用程式,從統一日誌確認操作是否如預期觸發。
用 Codex 和 Build macOS Apps 外掛程式,在視窗、側邊欄、指令或同步流程中,用 Logger 記錄幾個關鍵事件。接著執行應用程式,透過「主控台」或 log stream 確認預期的動作確實已觸發。
用 Codex 為一項 Mac 功能加入 Logger 事件記錄,再執行應用程式,從統一日誌確認操作是否如預期觸發。
用 Codex 和 Build macOS Apps 外掛程式,在視窗、側邊欄、指令或同步流程中,用 Logger 記錄幾個關鍵事件。接著執行應用程式,透過「主控台」或 log stream 確認預期的動作確實已觸發。
用 Codex 和 Build macOS Apps 外掛程式,在視窗、側邊欄、指令或同步流程中,用 Logger 記錄幾個關鍵事件。接著執行應用程式,透過「主控台」或 log stream 確認預期的動作確實已觸發。
| 技能 | 使用理由 |
|---|---|
| Build macOS Apps | 搭配使用 macOS 遙測技能與建置及執行技能,透過 `OSLog` 記錄結構化事件。啟動應用程式,走一遍介面操作流程,再用「主控台」或 `log stream` 核對實際記錄的事件。 |
有些 Mac 應用程式流程只看得出「有狀況」,光靠程式碼審查很難找出原因。這時可以請 Codex 針對一項行為,在統一日誌中記錄幾個關鍵事件,再執行應用程式、觸發該行為,並透過「主控台」或 log stream 確認預期的事件確實發生。
這套流程可以使用 Build macOS Apps 外掛程式。其中的 macOS 遙測技能刻意保持簡單:使用 Apple 的 Logger,選擇容易辨識的子系統與類別組合,記錄動作的起訖與狀態轉換,並避免記錄敏感的資料內容。在本機建置並執行應用程式後,實際確認事件是否出現,別只憑程式碼判斷記錄機制是否正常運作。
有了清楚的日誌,Codex 每次修改程式碼後,都能用相同的流程驗證結果。你不必手動檢查每個視窗、選單操作或同步狀態轉換。智慧體可以自行執行應用程式、操作相關流程、檢查篩選後的日誌,再根據記錄決定下一步要修改哪些程式碼。
遙測特別適合以下三種智慧體工作流程:
請 Codex 為每個功能區域設定一個日誌記錄器,避免為每次狀態變更都保留一行永久性的日誌。依功能劃分類別,例如 Windowing、Commands、MenuBar、Sidebar、Sync 或 Import,下次除錯時就能輕鬆篩選相關日誌。
import SwiftUI
struct SidebarItem { let id: String }
@MainActor private var selection: String?
import OSLog
private let logger = Logger(
subsystem: Bundle.main.bundleIdentifier ?? "SampleApp",
category: "Sidebar"
)
@MainActor
func selectItem(_ item: SidebarItem) {
logger.info("Selected sidebar item: \(item.id, privacy: .public)")
selection = item.id
}使用 info 簡要記錄值得長期保留的操作與生命週期事件。較繁瑣的本機狀態細節則使用 debug,這些記錄可以在任務完成前移除或調低層級。只有在需要測量某段操作的耗時時才加入 signpost,平時不必預設加入。
加入 Logger 呼叫後,還需要實際驗證。請 Codex 執行應用程式,觸發已加入記錄的流程,並提供它在「主控台」實際使用的篩選條件或 log stream 述詞,以及一兩行具代表性的日誌。
log stream --style compact --predicate 'subsystem == "com.example.app" && category == "Sidebar"'
如果預期的事件沒有出現,請 Codex 將記錄點移到更接近疑似出問題的控制路徑的位置,再次執行相同流程。反覆調整並驗證,直到日誌能說明實際發生了什麼事。如果接下來需要分析當機原因或呼叫堆疊,請改用外掛程式的建置與執行除錯流程,讓遙測繼續專注於記錄動作的起訖。
如果問題需要長時間追查,或只會偶爾發生,請 Codex 將篩選過的日誌串流儲存為小型本機追蹤檔,整理事件時間軸,並將檔案留在工作區。這樣下次執行 Codex 時,就能檢查同一份記錄,無須憑記憶重做整個工作階段的操作。若想讓智慧體在一次執行中收集追蹤記錄,再於另一次執行中比較修正前後的行為,這種做法能讓多輪除錯更容易。
如果工作階段中有些步驟需要你親自操作,也可以使用這個方法。請 Codex 在便於記錄日誌的除錯流程中啟動應用程式,開始擷取篩選後的日誌,等待你手動重現問題,再於你操作完畢後讀取儲存的追蹤檔。
先從一個側邊欄、一個視窗、一項指令或一條同步路徑著手,這樣比較容易依序檢查日誌。等該路徑能穩定運作後,Codex 就可以將相同做法套用到相關流程。
請 Codex 說明日誌中記錄的每個識別碼,並避免將機密資訊、個人資料或原始內容寫入統一日誌。本機除錯通常只需記錄少數幾種事件。
比起只寫「已加入遙測」,列出幾行具代表性的日誌更能讓人確認修改確實生效。請 Codex 附上篩選述詞和簡短的操作時間軸,方便智慧體下次執行時沿用同一套驗證流程。
需求
預設選項
為何需要
需求
應用程式日誌記錄
預設選項
為何需要
結構化的統一日誌讓 Codex 能篩選出特定流程的事件,逐次核對執行結果,也省去在程式碼中四處插入 print 陳述式的麻煩。
需求
智慧體工作流程
為何需要
外掛程式的遙測技能可搭配建置及執行技能使用。先為一個流程加入事件記錄,再啟動應用程式、檢查日誌,並精簡要記錄的事件。
需求
執行時驗證
預設選項
Console.app 和 log stream --predicate ...
為何需要
交接時附上實際使用的日誌篩選條件與輸出範例,智慧體就能在每次執行時用相同方式驗證新增的事件記錄。
| 需求 | 預設選項 | 為何需要 |
|---|---|---|
| 應用程式日誌記錄 | OSLog Logger | 結構化的統一日誌讓 Codex 能篩選出特定流程的事件,逐次核對執行結果,也省去在程式碼中四處插入 print 陳述式的麻煩。 |
| 智慧體工作流程 | Build macOS Apps 外掛程式 | 外掛程式的遙測技能可搭配建置及執行技能使用。先為一個流程加入事件記錄,再啟動應用程式、檢查日誌,並精簡要記錄的事件。 |
| 執行時驗證 | Console.app 和 log stream --predicate ... | 交接時附上實際使用的日誌篩選條件與輸出範例,智慧體就能在每次執行時用相同方式驗證新增的事件記錄。 |
使用 Codex 和 Build macOS Apps 外掛程式,以 `NavigationSplitView` 將你的構想做成 Mac...
使用 Codex 和 SwiftUI 開發 macOS 應用程式,建立以 shell 為主、可反覆建置與執行的流程。隨著應用程式逐步成熟,再加入原生桌面場景與視窗、整合...
使用 Codex Security 外掛程式,針對掃描結果中一項已檢閱的問題產生修補程式。在本機檢閱並套用變更,驗證修正結果,再準備 pull request 並附上佐證資料。