别让状态变化只靠文字：用 AI + SwiftUI symbolEffect 给图标加明确反馈

状态图标为什么需要动一下

先写一张状态表

把现有按钮交给 AI

• 当前图标由哪个状态决定。
• 点击后哪个状态会变化，变化是否来自异步请求。
• 现有按钮文案、辅助功能名称和失败处理在哪里。

请只为当前 SwiftUI 图标按钮增加状态反馈，不要重写数据模型、网络请求和页面导航。先列出当前状态、触发事件、成功和失败路径。

对一次性成功事件使用离散的 symbolEffect，只播放一次或少量次数；对持续中的状态使用 isActive 绑定，并在请求成功、失败、取消和离开页面时停止。图标状态变化要保留现有的 accessibilityLabel 或辅助功能文本，不要只靠颜色和动效传达结果。

请检查项目的最低系统版本是否支持你准备使用的 API。若不支持，给出静态图标或现有兼容过渡方案，不要擅自修改部署版本。最后列出改动文件、状态变化路径和 Xcode 验收步骤。

两种最常用的接法

一次事件：用 value 触发一次效果

@State private var favoriteEffect = 0

Button {
    isFavorite = true
    favoriteEffect += 1
} label: {
    Image(systemName: isFavorite ? "heart.fill" : "heart")
}
.symbolEffect(.bounce, options: .repeat(1), value: favoriteEffect)

持续状态：用 isActive 表示正在进行

Image(systemName: "wifi.router")
    .symbolEffect(
        .variableColor.iterative.reversing,
        isActive: isConnecting
    )

用 Xcode 验收反馈是否说得清楚

1. 操作成功时，确认图标只反馈一次，动效结束后仍保留正确的成功状态。
2. 让请求延迟几秒，确认持续动效只在等待期间出现，成功、失败、取消和超时后都会停止。
3. 让请求失败，确认没有出现成功图标或成功动效；错误文案和重试入口仍然可见。
4. 连续快速点击，确认不会因为重复触发而叠加一串动效，也不会绕过原有的请求去重规则。
5. 离开页面再回来，确认上一个页面的持续动效没有继续占用状态；若请求仍在后台进行，按产品规则决定是否继续显示同步状态。
6. 开启减少动态效果，确认页面仍能靠图标形态、文字和状态颜色表达结果。动效应该是增强，不是唯一线索。
7. 开启 VoiceOver，确认读屏会读出「已收藏」「正在同步」或等价的状态。图标会不会动，不等于辅助功能焦点有没有变化。
8. 在大字号、深色模式和窄屏下检查按钮尺寸、图标和文字是否仍然完整，避免动效改造顺便挤坏布局。

这招解决不了什么

PM 今天可以独立完成的清单

• 选一个已有的收藏、同步、复制或播放按钮，记录它现在的成功、失败和等待状态。
• 写出「什么事件触发、动几次、什么时候停止、结束后保留什么」四个答案。
• 找到图标 View、状态变量、异步请求和现有辅助功能文本。
• 把这四处上下文一起交给 AI，要求只改状态反馈，不改网络层和导航。
• 一次性成功提示优先检查 value 触发，持续等待优先检查 isActive 绑定。
• 检查成功、失败、取消和超时是否都能停止持续动效。
• 在连续点击、慢请求、失败重试、离开页面和重新进入场景下测试。
• 开启减少动态效果和 VoiceOver，确认不看动效也能理解状态。
• 对最低系统版本和兼容方案做一次确认，不要让 AI 自己提高部署门槛。