feat: 国际出港板箱过磅挂签支持多选批量打印

多选时逐张串行发送，张间节流留出出纸时间，写入失败即中止
并提示已打印张数与失败的 ULD 号；单选与详情页打印路径不变。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

module_base/src/main/java/com/lukouguoji/module_base/util/PrinterUtils.kt

@@ -27,7 +27,12 @@ import com.lukouguoji.module_base.ktx.permission
 import com.lukouguoji.module_base.ktx.showToast
 import com.lukouguoji.module_base.model.LoadingModel
 import dev.DevUtils
+import dev.utils.app.HandlerUtils
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.withContext
 import okio.internal.commonToUtf8String
+import java.io.IOException
 
 
 object PrinterUtils {
@@ -315,6 +320,50 @@ object PrinterUtils {
      * 打印国际出港板箱过磅挂签（2列布局，支持合并单元格）
      */
     fun printGjcBoxWeighing(bean: GjcUldUseBean) {
+        printMergedGrid(buildGjcBoxWeighingRows(bean))
+    }
+
+    /**
+     * 批量打印国际出港板箱过磅挂签
+     * 逐张串行发送，张间节流，任一张发送失败即中止并提示已完成张数
+     */
+    suspend fun printGjcBoxWeighingBatch(beans: List<GjcUldUseBean>) = withContext(Dispatchers.IO) {
+        var printed = 0
+        loading.showLoading()
+        try {
+            for ((index, bean) in beans.withIndex()) {
+                // 连接断开（含上一张写入异常后 SDK 置为断开）则不再继续发送
+                if (portManager?.connectStatus != true) break
+                HandlerUtils.postRunnable {
+                    loading.setMessage("正在打印 ${index + 1}/${beans.size}")
+                }
+                val bytes = buildMergedGridBytes(buildGjcBoxWeighingRows(bean))
+                val ok = try {
+                    portManager?.writeDataImmediately(bytes) == true
+                } catch (e: IOException) {
+                    showLog("批量打印第 ${index + 1} 张写入异常 : ${e.message}")
+                    false
+                }
+                if (!ok) break
+                printed++
+                // 张间留出出纸时间，避免连续灌入导致打印机缓冲溢出
+                if (index < beans.lastIndex) delay(800)
+            }
+        } finally {
+            loading.dismissLoading()
+        }
+        if (printed == beans.size) {
+            showToast("${beans.size} 张挂签打印完成")
+        } else {
+            val failBean = beans[printed]
+            showToast("已打印 $printed 张，第 ${printed + 1} 张（ULD ${failBean.uld}）发送失败，请检查打印机后重试")
+        }
+    }
+
+    /**
+     * 组装板箱过磅挂签的表格行数据
+     */
+    private fun buildGjcBoxWeighingRows(bean: GjcUldUseBean): ArrayList<GridRow> {
         val rows = arrayListOf<GridRow>()
 
         // 第1行：日期 | 航班号
@@ -345,7 +394,7 @@ object PrinterUtils {
             merged = CellData("备注:", "NOTES:", bean.remark)
         ))
 
-        printMergedGrid(rows)
+        return rows
     }
 
     private fun printCommonGrid(rowItem: ArrayList<List<String>>) {
@@ -456,6 +505,13 @@ object PrinterUtils {
      * 打印支持合并单元格的表格
      */
     private fun printMergedGrid(rows: ArrayList<GridRow>) {
+        portManager?.writeDataImmediately(buildMergedGridBytes(rows))
+    }
+
+    /**
+     * 生成支持合并单元格的表格标签字节流（自包含一张完整标签的 TSPL 指令）
+     */
+    private fun buildMergedGridBytes(rows: ArrayList<GridRow>): ByteArray {
         val gridStartX = 30
         val titleTopMargin = 50      // 标题顶部间距
         val titleFontSize = 130      // 标题字体大小
@@ -536,7 +592,7 @@ object PrinterUtils {
             addPrint(1)
         }.bytes
 
-        portManager?.writeDataImmediately(bytes)
+        return bytes
     }
 
     /**