HIG Doctor 苹果界面审计

先说清楚它解决什么问题

每次改完 UI 提 PR，争论最多的往往不是「按钮该放哪」，而是「这样符合规范吗」。Apple 的 Human Interface Guidelines（HIG）分散在 iOS、iPadOS、macOS、watchOS、visionOS 多个平台上，文档很长。靠人肉对着设计稿和代码逐条核对，既慢又容易漏，尤其是那些不太显眼的点：点击区域过小、标签被截断、深色模式下的对比度、动态字体导致的文本溢出。

这类问题的共性是——它不会导致 app 崩溃，测试用例也覆盖不到，但用户能感觉到。等到审核意见回来或者发布之后再补，成本要高得多。

这个技能怎么工作

它把 HIG 合规性审计做成一段可重复的流程，在你发布 UI 更改之前先跑一遍：

• 跑一次审计：对本地项目目录执行 HIG Doctor，拿到结构化的审计结果，而不是靠人翻文档。
• 按结果整改：审计条目直接当整改清单用，一条一条处理。
• 跨平台对齐：覆盖 Apple 各平台的界面约定，避免「只在 iOS 上验过」留下的漏网。

可重复性是这里的关键价值。同一份代码改动可以反复跑、结果一致，因此它可以放进 CI 或者提交前的本地检查里，变成一个默认动作，而不是额外负担。

适用边界与注意点

• 它不是自动修复工具：审计结果给的是问题清单和整改方向，改代码这一步仍要你或者 agent 完成。
• 需要 Bun 和项目目录：前提是本地装了 Bun，并且手头有可审计的项目代码。没有项目，就没有对象可跑。
• 规则来自上游：审计依据是 HIG Doctor 上游的文档与规则。Apple 更新 HIG 之后，你需要等上游同步才能拿到新的检查点。
• 合规不等于好用：它能挡住「违反指南」的问题，但导航结构合不合理、流程顺不顺畅，仍然是你自己的判断。