feat(rider): 添加配送员模块和订单图片保存功能

- 新增配送员首页界面，包含订单管理、工资明细、配送小区、仓库地址等功能入口
- 实现小程序码保存到相册功能，支持权限检查和错误处理
- 添加相册写入权限配置和图片下载临时路径处理
- 修复订单列表商品信息显示问题，优化支付流程
- 更新首页轮播图广告代码，调整用户中心网格布局
- 增加订单页面返回时的数据刷新机制，提升用户体验

src/dealer/qrcode/index.tsx

@@ -11,6 +11,7 @@ import {businessGradients} from '@/styles/gradients'
 const DealerQrcode: React.FC = () => {
   const [miniProgramCodeUrl, setMiniProgramCodeUrl] = useState<string>('')
   const [loading, setLoading] = useState<boolean>(false)
+  const [saving, setSaving] = useState<boolean>(false)
   // const [inviteStats, setInviteStats] = useState<InviteStats | null>(null)
   // const [statsLoading, setStatsLoading] = useState<boolean>(false)
   const {dealerUser} = useDealerUser()
@@ -67,6 +68,66 @@ const DealerQrcode: React.FC = () => {
     }
   }, [dealerUser?.userId])
 
+  const isAlbumAuthError = (errMsg?: string) => {
+    if (!errMsg) return false
+    // WeChat uses variants like: "saveImageToPhotosAlbum:fail auth deny",
+    // "saveImageToPhotosAlbum:fail auth denied", "authorize:fail auth deny"
+    return (
+      errMsg.includes('auth deny') ||
+      errMsg.includes('auth denied') ||
+      errMsg.includes('authorize') ||
+      errMsg.includes('scope.writePhotosAlbum')
+    )
+  }
+
+  const ensureWriteAlbumPermission = async (): Promise<boolean> => {
+    try {
+      const setting = await Taro.getSetting()
+      if (setting?.authSetting?.['scope.writePhotosAlbum']) return true
+
+      await Taro.authorize({scope: 'scope.writePhotosAlbum'})
+      return true
+    } catch (error: any) {
+      const modal = await Taro.showModal({
+        title: '提示',
+        content: '需要您授权保存图片到相册，请在设置中开启相册权限',
+        confirmText: '去设置'
+      })
+      if (modal.confirm) {
+        await Taro.openSetting()
+      }
+      return false
+    }
+  }
+
+  const downloadImageToLocalPath = async (url: string): Promise<string> => {
+    // saveImageToPhotosAlbum must receive a local temp path (e.g. `http://tmp/...` or `wxfile://...`).
+    // Some environments may return a non-existing temp path from getImageInfo, so we verify.
+    if (url.startsWith('http://tmp/') || url.startsWith('wxfile://')) {
+      return url
+    }
+
+    const token = Taro.getStorageSync('access_token')
+    const tenantId = Taro.getStorageSync('TenantId')
+    const header: Record<string, string> = {}
+    if (token) header.Authorization = token
+    if (tenantId) header.TenantId = tenantId
+
+    // 先下载到本地临时文件再保存到相册
+    const res = await Taro.downloadFile({url, header})
+    if (res.statusCode !== 200 || !res.tempFilePath) {
+      throw new Error(`图片下载失败(${res.statusCode || 'unknown'})`)
+    }
+
+    // Double-check file exists to avoid: saveImageToPhotosAlbum:fail no such file or directory
+    try {
+      await Taro.getFileInfo({filePath: res.tempFilePath})
+    } catch (_) {
+      throw new Error('图片临时文件不存在，请重试')
+    }
+    return res.tempFilePath
+  }
+
   // 保存小程序码到相册
   const saveMiniProgramCode = async () => {
     if (!miniProgramCodeUrl) {
@@ -78,39 +139,64 @@ const DealerQrcode: React.FC = () => {
     }
 
     try {
-      // 先下载图片到本地
-      const res = await Taro.downloadFile({
-        url: miniProgramCodeUrl
-      })
+      if (saving) return
+      setSaving(true)
+      Taro.showLoading({title: '保存中...'})
 
-      if (res.statusCode === 200) {
-        // 保存到相册
-        await Taro.saveImageToPhotosAlbum({
-          filePath: res.tempFilePath
-        })
+      const hasPermission = await ensureWriteAlbumPermission()
+      if (!hasPermission) return
 
-        Taro.showToast({
-          title: '保存成功',
-          icon: 'success'
-        })
+      let filePath = await downloadImageToLocalPath(miniProgramCodeUrl)
+      try {
+        await Taro.saveImageToPhotosAlbum({filePath})
+      } catch (e: any) {
+        const msg = e?.errMsg || e?.message || ''
+        // Fallback: some devices/clients may fail to save directly from a temp path.
+        if (
+          msg.includes('no such file or directory') &&
+          (filePath.startsWith('http://tmp/') || filePath.startsWith('wxfile://'))
+        ) {
+          const saved = (await Taro.saveFile({tempFilePath: filePath})) as unknown as { savedFilePath?: string }
+          if (saved?.savedFilePath) {
+            filePath = saved.savedFilePath
+          }
+          await Taro.saveImageToPhotosAlbum({filePath})
+        } else {
+          throw e
+        }
       }
+
+      Taro.showToast({
+        title: '保存成功',
+        icon: 'success'
+      })
     } catch (error: any) {
-      if (error.errMsg?.includes('auth deny')) {
-        Taro.showModal({
+      const errMsg = error?.errMsg || error?.message
+      if (errMsg?.includes('cancel')) {
+        Taro.showToast({title: '已取消', icon: 'none'})
+        return
+      }
+
+      if (isAlbumAuthError(errMsg)) {
+        const modal = await Taro.showModal({
           title: '提示',
           content: '需要您授权保存图片到相册',
-          success: (res) => {
-            if (res.confirm) {
-              Taro.openSetting()
-            }
-          }
+          confirmText: '去设置'
         })
+        if (modal.confirm) {
+          await Taro.openSetting()
+        }
       } else {
-        Taro.showToast({
+        // Prefer a modal so we can show the real reason (e.g. domain whitelist / network error).
+        await Taro.showModal({
           title: '保存失败',
-          icon: 'error'
+          content: errMsg || '保存失败，请稍后重试',
+          showCancel: false
         })
       }
+    } finally {
+      Taro.hideLoading()
+      setSaving(false)
     }
   }
 
@@ -258,7 +344,7 @@ const DealerQrcode: React.FC = () => {
               block
               icon={<Download/>}
               onClick={saveMiniProgramCode}
-              disabled={!miniProgramCodeUrl || loading}
+              disabled={!miniProgramCodeUrl || loading || saving}
             >
               保存小程序码到相册
             </Button>