macos 更新后辅助功能权限常被重置或拒绝，导致鼠标侧键失灵、快捷键失效等静默故障；可用 log show 命令结合 subsystem、eventmessage 等谓词精准定位 denied 事件、axis/cgssetwindowlevel/tcc 报错及进程拦截日志。
辅助功能（accessibility）权限被重置或拒绝是 macos 更新后最常见却最隐蔽的问题之一，表现为鼠标侧键失灵、快捷键失效、自动化脚本卡住、录屏黑屏等“静默故障”。这类问题通常不会弹出错误提示，但会在系统日志中留下明确痕迹——log show 正是定位它们最直接、最底层的工具。
聚焦辅助功能相关子系统与进程
macOS 的辅助功能授权由 com.apple.accessibility 子系统统一管理，关键守护进程包括 accessibilityd 和第三方应用的 Helper 进程（如 Mac Mouse Fix.Helper）。直接筛选这些标识，能避开大量无关日志干扰：
- 查看最近一次启动以来所有辅助功能相关操作：
log show --predicate 'subsystem contains "com.apple.accessibility"' --last boot - 追踪权限拒绝事件（重点看 denied 类消息）：
log show --predicate 'eventMessage contains[c] "denied" AND subsystem contains "com.apple.accessibility"' --last 24h - 检查特定应用的 Helper 进程是否被拦截：
log show --predicate 'process == "YourApp.Helper"' --last 7d（将 YourApp 替换为实际进程名，如Raycast或Karabiner-Elements）
捕获权限请求失败的关键报错模式
当辅助功能开关已打开但功能仍无效时，日志里常出现以下典型语句，需重点识别：
-
AXIS: Failed to register accessibility client—— 表示进程未成功注册到辅助功能服务 -
CGSSetWindowLevel failed for pid+ 进程名 —— 常见于窗口层级控制类工具（如 BetterTouchTool），说明系统拒绝其提升窗口权限 -
TCC: Access request for <code>accessibilitydenied forxxx.app—— 明确指出 TCC（透明度、隐私与控制）模块拒绝了授权 -
Failed to connect to accessibility service—— 多见于 Electron 应用或未签名工具，常伴随 quarantine 属性残留
结合时间线与重启行为交叉验证
辅助功能异常往往紧随系统更新、重启或安全策略变更之后。用时间范围锚定可大幅提升排查效率：
- 查 macOS 更新后的首次重启日志：
log show --start "$(softwareupdate --history | head -n 2 | tail -n 1 | awk '{print $1, $2, $3}')" --predicate 'subsystem contains "com.apple.accessibility"' | head -n 50 - 对比重启前后权限状态变化：先执行
log show --last 1h | grep -i "accessibility\|tcc"，再重启一次，立即运行相同命令，观察输出差异 - 若怀疑是某次手动授权操作失败，可在“系统设置 > 隐私与安全性 > 辅助功能”中开启/关闭目标应用开关，立刻在终端运行：
log show --last 30s --predicate 'eventMessage contains[c] "accessibility" OR eventMessage contains[c] "tcc"'，实时捕获响应日志
导出结构化日志供深度分析
单条命令不足以覆盖全部上下文。建议导出完整辅助功能交互流，便于回溯或提交给开发者：
- 生成含时间戳、进程名、子系统、错误级别的结构化文本：
log show --predicate 'subsystem contains "com.apple.accessibility" OR process == "accessibilityd"' --last 7d --info --debug --style json --output /tmp/accessibility_log.json - 提取纯文本摘要（含错误和警告）：
log show --predicate 'level >= error AND (subsystem contains "com.apple.accessibility" OR eventMessage contains[c] "ax")' --last boot > ~/Desktop/accessibility_errors.txt - 过滤掉调试信息，只保留用户级可见异常：
log show --predicate 'level >= error AND subsystem contains "com.apple.accessibility" AND NOT eventMessage contains[c] "debug"' --last 24h
