需求
应用日志记录
默认选项
为什么需要
使用结构化统一日志,Codex 可以筛选出与当前流程相关的事件,核对运行结果,无需在代码中到处添加 print 语句。
.md 即可查看该页面的 Markdown 版本。
Codex 使用场景
让 Codex 使用 Logger 为 Mac 应用的一项功能添加日志,再运行应用,通过统一日志确认相关操作已执行。
使用 Codex 和 Build macOS Apps 插件,为窗口、侧边栏、命令或同步流程添加少量 Logger 事件,记录关键操作。然后运行应用,通过“控制台”或 log stream 确认实际触发的操作符合预期。
让 Codex 使用 Logger 为 Mac 应用的一项功能添加日志,再运行应用,通过统一日志确认相关操作已执行。
使用 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 验证预期事件是否发生。
使用构建 macOS 应用插件完成这一轮调试。插件的 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 记录,并可在任务完成前移除这些日志或降低其级别。仅在需要测量某段操作的耗时时添加性能标记。
添加 Logger 调用只是第一步。让 Codex 运行应用,触发已添加日志的流程,并提供实际使用的“控制台”筛选条件或 log stream 谓词,以及一两条有代表性的日志。
log stream --style compact --predicate 'subsystem == "com.example.app" && category == "Sidebar"'
如果预期事件没有出现,让 Codex 把日志记录点移到更接近可疑执行路径的位置,再次执行同一流程,并持续调整,直到日志能说明实际发生了什么。如果任务转为分析崩溃或调用栈,请改用插件的构建与运行调试流程,遥测仍只关注操作的起止点。
如果排查问题需要较长时间,或问题只是偶尔出现,让 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 ... | 交接时提供具体的日志筛选条件和输出样例,智能体就能在后续运行中重复相同的检查,验证新增的日志记录点。 |