别让数字更新跳一下：用 AI + SwiftUI numericText 让变化更易读

数字变了，但用户不确定变了多少

先定规则：哪些数字值得动

用户完成一次任务后，积分从旧值过渡到新值；失败重试不重复播放；金额在最终计算完成前保持静态；页面开启「减少动态效果」后，数字仍然能直接读懂。

把现有代码交给 AI

请只改造当前页面中显示积分的 Text，不要改数据请求、文案、格式化规则、导航和其它卡片动画。

当前产品规则：任务成功后积分从旧值变化到新值；同一请求重试不能重复加分；用户打开系统「减少动态效果」后，数字仍需清楚可读。请先确认项目的 Deployment Target 和当前 SwiftUI SDK 是否支持 contentTransition 的 numericText，不支持时先说明版本差异，再给出兼容方案。

请判断积分是只会递增，还是可能递增和递减。如果只会递增，优先使用 Text 的 .contentTransition(.numericText())，并把动画绑定到积分值本身，不要给整个页面挂一个无差别的动画。如果会递减，请说明 countsDown 应该如何跟随实际变化方向，不要把方向写死。

保留现有的数字格式、VoiceOver 可读内容和加载状态。请给出最小改动代码，并列出连续两次更新、请求失败重试、减少动态效果、窄屏和大字号下的验收步骤。

看懂 AI 应该改成什么

struct ScoreCard: View {
    let score: Int

var body: some View {
        Text("\(score)")
            .contentTransition(.numericText())
            .animation(.easeInOut(duration: 0.25), value: score)
    }
}

1. Text 仍然显示真实的 score，没有用延迟计时器或假数字替代接口结果。
2. .contentTransition(.numericText()) 放在数字文本上，处理的是文本内容变化。
3. .animation(..., value: score) 只观察积分值，旁边的按钮、卡片阴影和列表布局不会因为积分变化一起晃动。
4. 原来的格式化方式没有被 AI 删掉。金额、百分比和带千位分隔符的数字，必须继续按产品规则显示。

用 Xcode 验收变化是否真的可读

1. 让积分从 128 变成 129，确认数字仍完整显示，用户能看出是递增。
2. 连续快速触发两次成功状态，确认每次业务变化只对应一次数字变化，没有重复加分或回弹到旧值。
3. 模拟请求失败后重试，确认失败本身不会播放成功动画，重试成功时只更新一次。
4. 如果业务允许扣分或撤销，测试从较大值变成较小值，确认下降方向没有被写成上升效果。
5. 把积分换成长数字、带小数的金额和百分比，检查小数位、千位分隔符和货币符号没有在过渡时消失。
6. 打开大字号和窄屏模拟器，确认数字不会被裁切，也不会因为过渡挤走标题或按钮。
7. 打开系统「设置 > 辅助功能 > 动态效果 > 减少动态效果」。SwiftUI 的 accessibilityReduceMotion 表示系统的「减少动态效果」偏好是否开启。4 如果项目已经读取这个环境值，确认数字在该设置下仍然直接、稳定地呈现。
8. 检查 VoiceOver 读到的是完整的新数字和必要的单位，而不是把过渡中的中间数字当成最终结果。动画改变的是视觉呈现，不能替代正确的可访问文本。
9. 在 iPhone 窄屏和 iPad 横屏各测一次，确认数字变化不会改变卡片的整体布局或让其它控件跟着移动。

这招的边界

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

• 找出一个用户确实需要关注变化的积分、数量或进度数字。
• 写下数字什么时候变化，失败重试是否允许再次变化。
• 记录项目的 Deployment Target，并交给 AI 核对 numericText 支持情况。
• 把真实 View、状态来源和格式化规则一起交给 AI。
• 要求 AI 只改数字 Text，不要给整个页面加动画。
• 递增、递减、连续更新和失败重试各测一次。
• 用长数字、金额、百分比、大字号和窄屏检查排版。
• 打开「减少动态效果」，确认最终数字仍然清楚可读。
• 用 VoiceOver 检查读出的内容是最终值，不是过渡中的视觉细节。