用途：针对 Apple Vision 框架使用中出现的检测失败等问题提供系统化排错指引，覆盖主体未检测、关键点缺失、置信度低、性能问题、坐标不匹配、文本识别、条码检测和文档扫描等场景。
主要能力：给出问题现象与可能原因的对照（如主体在画面边缘、光照差、未丢弃低置信度数据、阻塞主线程、左下与左上坐标原点混用、在旧设备上使用 iOS 17+ API 等）；提供强制先行诊断步骤，包括用 VNImageRequestHandler.perform 验证请求是否成功、打印实例数量、检查关键点 confidence、确认 Thread.isMainThread；提供决策树，按无结果、关键点低置信、UI 卡顿、叠加层错位、拥挤场景、VisionKit、文本识别、条码、DataScannerViewController、文档扫描分支定位；并按模式给出诊断代码片段与修复方向，如 API 可用性用 #available 检查并回退、主线程改到 DispatchQueue.global、实时处理跳帧或降分辨率、手部 maximumHandCount 调整、坐标转换做 Y 轴翻转与归一化还原。
使用方式：按资料中的先行诊断流程逐步执行，再依据决策树进入对应模式排查。资料未提供安装命令、包名或外部依赖。
适用场景：从事 Apple 平台视觉识别开发的工程师，在调试检测、姿态、分割、文本与条码相关功能时参照。
限制：资料以诊断方法为主，未提供完整可运行项目、收费与价格、平台版本支持矩阵之外的信息；部分修复示例为片段，需结合自身代码调整。