用途：针对 Apple Vision 框架的常见故障提供系统化排查流程，包括主体未检测、手部与人体姿态关键点缺失、置信度低、性能问题、坐标不匹配、文本识别失败、条码检测异常和文档扫描问题。
主要能力：给出根因概率分布（环境约40%、置信度阈值约30%、线程约15%、坐标约10%、API 可用性约5%），强调先查环境和置信度再调试代码；提供红旗症状对照表、强制首步诊断（验证检测、检查置信度、验证线程）、决策树，以及按模式编号的修复方案，如 API 可用性回退、边缘遮挡、手部/人体/人脸检测、主线程阻塞、性能调优、坐标转换、多人场景、VisionKit、文本识别、条码与文档扫描。
使用方式：在排查前先运行诊断代码，用 VNImageRequestHandler 执行请求并打印结果数量；对姿态请求打印各关键点置信度，低于0.3视为不可靠；打印当前线程判断是否在主线程。根据输出走决策树，再按对应模式修复，例如用 #available(iOS 17.0, *) 做回退、将请求移到 DispatchQueue.global()、对坐标做 Y 轴翻转并缩放、降低 maximumHandCount、跳帧或降分辨率。
适用场景：iOS/macOS 上使用 Vision、VisionKit 做图像分析、姿态识别、文本与条码识别、文档扫描的开发与调试。
限制：资料未提供具体版本兼容范围、性能基准、收费或平台支持细节；部分修复时间估计仅为参考，实际效果依赖设备与输入条件。