3.9 KiB

Raw Blame History

CompletionView Magic Card 版 — 审查报告（不应用）

审查日期：2025-01-29
范围：Magic Card Edition（粒子庆祝 + 按钮卡片一体化 + 极光光晕）
结论：仅审查、不修改仓库；逻辑继承正确，ParticleModifier 存在两处需修复的实现问题。

1. 需求落实情况

项目	要求	定稿实现	结论
按钮卡片一体化	按钮在卡片内，点击后「献祭」化作彩带和数据	IdleActionView 中按钮，切换后显示 ActiveDashboard + ConfettiExplosion	✅
粒子爆炸	蓝/紫/粉色粒子炸开	ConfettiExplosion：Circle + Capsule，confettiColors	✅
呼吸光晕	激活后卡片背景极淡极光渐变	AngularGradient + blur(20)，isSystemOn 时显示	✅
极简流程	点击上传 → 按钮消失 → 数据呈现，无「已同步」占位	符合	✅
色彩规范	按钮 System Blue	brandBlue = Color.blue	✅

2. 逻辑继承

项目	结论
持久化 Key	✅ `has_revealed_course_\(courseId)`
游客短路	✅ 0.5s 延迟，`performActivation(0, 0)`，不调网络
登录用户	✅ 0.8s 延迟 → fetchUserProfile → performActivation
checkSystemStatus	✅ 已激活时恢复最终值
数字滚动	✅ `withAnimation(.linear(1.5))` + RollingNumberText
ScaleButtonStyle	未使用，无重复定义风险

3. ⚠️ ParticleModifier 需修复项

3.1 角度单位错误（影响粒子方向）

问题：angle 为角度制 (0~360°)，但 cos(angle)、sin(angle) 在 Swift 中接收弧度制。未做转换会导致粒子方向错误。

修复：先转换为弧度再计算：

let rad = angle * .pi / 180
offset(x: time == 0 ? 0 : cos(rad) * distance,
       y: time == 0 ? 0 : sin(rad) * distance)

3.2 angle / distance 每次重算导致动画抖动

问题：var angle: Double { Double.random(in: 0...360) } 和 var distance: Double { ... } 为计算属性，body 每次求值都会得到新随机数，粒子目标位置不断变化，动画会抖动。

修复：在 init 中一次性随机，并用 @State 保存，例如：

let index: Int
@State private var time: Double = 0.0
private let angle: Double
private let distance: Double

init(index: Int) {
    self.index = index
    self.angle = Double.random(in: 0..<360)
    self.distance = Double.random(in: 80...150)
    // 如需在 init 中初始化 @State，可用 _time = State(initialValue: 0)
}

并在 body 中用 angle、distance 计算 offset（配合上述弧度转换）。

4. ConfettiExplosion 可选优化

confettiColors.randomElement()!：在 body 中每次重绘都会重新随机，粒子颜色可能闪变。可按 index 固定颜色，如 confettiColors[i % confettiColors.count]，以保持每个粒子颜色稳定。
ForEach(0..<15)：若 Swift 版本要求，可为 ForEach 增加 id: \.self。

5. 接口与影响范围

项目	结论
初始化参数	三参数不变
替换方式	整文件替换 `CompletionView.swift`
新增类型	`ParticleModifier` 仅在本文件使用，无符号冲突
RollingNumberText	同前，保留在本文件

6. 总结

维度	结论
需求落实	✅ 卡片一体化、粒子、光晕、流程、色彩均符合
逻辑继承	✅ Key、游客、登录用户、数字滚动正确
ParticleModifier	⚠️ 需修复：弧度转换 + angle/distance 稳定化
接口兼容	✅ 可直接替换

审查结论： Magic Card 版在设计与逻辑上正确，应用前需修复 ParticleModifier 的角度单位与随机值稳定性，否则粒子动画会出现方向错误和抖动。本次未对仓库做任何修改。

3.9 KiB Raw Blame History Unescape Escape