SuperAPI AI 工具集

axiom-xclog-ref

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:捕获和查看 iOS 模拟器控制台输出,用于诊断运行时崩溃、静默失败、查看 print/os_log 输出,以及获取结构化应用日志进行分析。

主要能力:launch 可启动应用并捕获全部输出(print()、debugPrint()、NSLog()、os_log()、Logger),但会重启应用;attach 连接正在运行的进程,仅限 os_log,不捕获 print()/debugPrint();show 用于历史日志搜索,支持模拟器和通过 --device-udid 连接的物理设备(需连接并解锁)。默认输出为 JSON 行,每条日志包含 time、source,os_log 还含 level、subsystem、category、process、pid 等字段,不适用字段会省略。支持 --filter(Go 正则)、--subsystem、--max-lines、--timeout、--last、--output、--human 等选项。

使用方式:二进制位于 ${CLAUDE_PLUGIN_ROOT}/bin/xclog。先检查 .axiom/preferences.yaml 是否保存了设备与 bundle ID,没有则运行 ${CLAUDE_PLUGIN_ROOT}/bin/xclog list 发现已安装应用。启动捕获示例:${CLAUDE_PLUGIN_ROOT}/bin/xclog launch com.example.MyApp --timeout 30s --max-lines 200;连接运行中进程:${CLAUDE_PLUGIN_ROOT}/bin/xclog attach MyApp --timeout 30s;历史搜索:${CLAUDE_PLUGIN_ROOT}/bin/xclog show MyApp --last 5m --max-lines 200。

适用场景:崩溃前的日志捕获、无 UI 反馈的网络或数据操作失败排查、print() 调试输出查看、按 subsystem 与级别过滤的 os_log 分析、自动化受限采集。限制:attach 仅限 os_log;launch 会终止现有应用实例再重启;物理设备仅 show 支持;按日志级别过滤需借助 jq,因 --filter 只匹配消息文本。错误输出到 stderr 并以退出码 1 结束。