feat(image): 图片加载占位改为微光骨架

lib/core/widgets/image_placeholder_shimmer.dart

@@ -0,0 +1,86 @@
+// Author: fruit.com.cn
+// 职责：给默认图片加载占位叠加可暂停、局部重绘的轻量扫光。
+import 'package:flutter/material.dart';
+
+const _sweepDuration = Duration(milliseconds: 1400);
+const double _bandWidthRatio = 0.65;
+const _highlight = Color(0x12FFFFFF);
+const _clear = Color(0x00FFFFFF);
+
+/// 只用于等待真实图片的占位；减少动画或页面离屏时不运行扫光。
+class ImagePlaceholderShimmer extends StatefulWidget {
+  /// 在 [child] 上方绘制不影响布局与点击区域的扫光。
+  const ImagePlaceholderShimmer({super.key, required this.child});
+
+  final Widget child;
+
+  @override
+  State<ImagePlaceholderShimmer> createState() =>
+      _ImagePlaceholderShimmerState();
+}
+
+class _ImagePlaceholderShimmerState extends State<ImagePlaceholderShimmer>
+    with SingleTickerProviderStateMixin {
+  late final AnimationController _controller = AnimationController(
+    vsync: this,
+    duration: _sweepDuration,
+  );
+  bool _active = false;
+
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    _active =
+        TickerMode.valuesOf(context).enabled &&
+        !MediaQuery.disableAnimationsOf(context);
+    if (_active) {
+      _controller.repeat();
+    } else {
+      _controller.stop();
+    }
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    if (!_active) return widget.child;
+    return RepaintBoundary(
+      child: ClipRect(
+        child: CustomPaint(
+          foregroundPainter: _SweepPainter(_controller),
+          child: widget.child,
+        ),
+      ),
+    );
+  }
+}
+
+class _SweepPainter extends CustomPainter {
+  _SweepPainter(this.progress) : super(repaint: progress);
+
+  final Animation<double> progress;
+
+  @override
+  void paint(Canvas canvas, Size size) {
+    if (size.isEmpty) return;
+    final bandWidth = size.width * _bandWidthRatio;
+    final left = -bandWidth + (size.width + bandWidth) * progress.value;
+    final rect = Rect.fromLTWH(left, 0, bandWidth, size.height);
+    final paint = Paint()
+      ..shader = const LinearGradient(
+        begin: Alignment.topLeft,
+        end: Alignment.bottomRight,
+        colors: [_clear, _highlight, _clear],
+      ).createShader(rect);
+    canvas.drawRect(rect, paint);
+  }
+
+  @override
+  bool shouldRepaint(covariant _SweepPainter oldDelegate) =>
+      oldDelegate.progress != progress;
+}

lib/core/widgets/remote_image.dart

@@ -4,6 +4,7 @@ import 'package:flutter/material.dart';
 
 import '../config/app_config.dart';
 import '../theme/app_colors.dart';
+import 'image_placeholder_shimmer.dart';
 
 const int _minImageDecodePixels = 96;
 const int _maxImageDecodePixels = 2048;
@@ -102,13 +103,19 @@ class RemoteImage extends StatelessWidget {
           errorBuilder: (_, _, _) => _fallback(brand: showFallbackIcon),
           frameBuilder: (context, child, frame, wasSynchronouslyLoaded) {
             if (wasSynchronouslyLoaded || frame != null) return child;
-            return _fallback(brand: showFallbackIcon);
+            return _loadingFallback();
           },
         );
       },
     );
   }
 
+  Widget _loadingFallback() {
+    final custom = fallbackWidget;
+    if (custom != null) return custom;
+    return ImagePlaceholderShimmer(child: _fallback(brand: showFallbackIcon));
+  }
+
   Widget _fallback({required bool brand}) {
     final custom = fallbackWidget;
     if (custom != null) return custom;