From 9927b97ee7774f64e0bf75edecf2cc8d889aec0a Mon Sep 17 00:00:00 2001
From: “wangming” <“wangming@antissoft.com”>
Date: Fri, 20 Mar 2026 20:54:36 +0800
Subject: [PATCH] Improve GP_R3 printing flow and printer onboarding Enhance TCP built-in fallback with port probing and update label/Bluetooth print templates.

---
 美国版/Food Labeling Management App UniApp/src/pages/labels/bluetooth.vue                     |  27 +++++++++++++++++++++++----
 美国版/Food Labeling Management App UniApp/src/pages/labels/labels.vue                        |   7 ++++---
 美国版/Food Labeling Management App UniApp/src/pages/labels/preview.vue                       |  25 ++++++++++++++++++-------
 美国版/Food Labeling Management App UniApp/src/pages/more/printers.vue                        |  66 ++++++++++++++++++++++++++++++++++++++++++++++++++++--------------
 美国版/Food Labeling Management App UniApp/src/utils/deviceInfo.ts                            |  63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/bluetoothTool.js                   | 143 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------------
 美国版/Food Labeling Management App UniApp/src/utils/print/drivers/d320fax.ts                 |   2 ++
 美国版/Food Labeling Management App UniApp/src/utils/print/drivers/genericTsc.ts              |   2 ++
 美国版/Food Labeling Management App UniApp/src/utils/print/drivers/gpR3.ts                    |   2 ++
 美国版/Food Labeling Management App UniApp/src/utils/print/imageRaster.ts                     | 174 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/manager/printerManager.ts          |  87 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++--
 美国版/Food Labeling Management App UniApp/src/utils/print/printerConnection.ts               | 109 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------------
 美国版/Food Labeling Management App UniApp/src/utils/print/protocols/escPosBuilder.ts         | 192 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++---------------
 美国版/Food Labeling Management App UniApp/src/utils/print/protocols/tscProtocol.ts           |  33 ++++++++++++++++++++++++++++++---
 美国版/Food Labeling Management App UniApp/src/utils/print/systemTemplateAdapter.ts           | 376 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/templateRenderer.ts                |  58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/templates/previewSystemTemplate.ts |  96 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/templates/test.json                |  94 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/templates/testPrintTemplate.ts     |  21 +++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/testPrintCanvas.ts                 | 118 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 美国版/Food Labeling Management App UniApp/src/utils/print/tscLabelBuilder.ts                 | 159 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++--------------------------
 美国版/Food Labeling Management App UniApp/src/utils/print/types/printer.ts                   | 175 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 22 files changed, 1931 insertions(+), 98 deletions(-)
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/deviceInfo.ts
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/print/imageRaster.ts
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/print/systemTemplateAdapter.ts
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/print/templateRenderer.ts
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/print/templates/previewSystemTemplate.ts
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/print/templates/test.json
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/print/templates/testPrintTemplate.ts
 create mode 100644 美国版/Food Labeling Management App UniApp/src/utils/print/testPrintCanvas.ts

diff --git a/美国版/Food Labeling Management App UniApp/src/pages/labels/bluetooth.vue b/美国版/Food Labeling Management App UniApp/src/pages/labels/bluetooth.vue
index ea39e5d..9812a8c 100644
--- a/美国版/Food Labeling Management App UniApp/src/pages/labels/bluetooth.vue
+++ b/美国版/Food Labeling Management App UniApp/src/pages/labels/bluetooth.vue
@@ -17,8 +17,9 @@
 
     <view class="content">
       <!-- Printer type: Bluetooth | Built-in -->
-      <view class="type-tabs">
+      <view v-if="availablePrinterTypes.length > 1" class="type-tabs">
         <view
+          v-if="isBluetoothModeAvailable"
           class="tab"
           :class="{ active: printerType === 'bluetooth' }"
           @click="switchType('bluetooth')"
@@ -27,6 +28,7 @@
           <text class="tab-text">Bluetooth</text>
         </view>
         <view
+          v-if="isBuiltinModeAvailable"
           class="tab"
           :class="{ active: printerType === 'builtin' }"
           @click="switchType('builtin')"
@@ -45,6 +47,10 @@
       <view class="debug-card">
         <text class="debug-title">Debug Status</text>
         <text class="debug-item">Current Mode: {{ debugInfo.currentMode }}</text>
+        <text class="debug-item">Available Mode: {{ availablePrinterTypesLabel }}</text>
+        <text class="debug-item">Device Model: {{ deviceIdentity.model || '-' }}</text>
+        <text class="debug-item">Device Brand: {{ deviceIdentity.brand || '-' }}</text>
+        <text class="debug-item">Device Product: {{ deviceIdentity.product || '-' }}</text>
         <text class="debug-item">Classic Module: {{ debugInfo.classicModuleReady ? 'Ready' : 'Not Ready' }}</text>
         <text class="debug-item">Paired Count: {{ debugInfo.pairedCount }}</text>
         <text class="debug-item">Virtual BT Printer: {{ debugInfo.foundVirtualPrinter ? 'Found' : 'Not Found' }}</text>
@@ -60,7 +66,7 @@
       <view v-if="connectedDevice" class="connected-card">
         <view class="connected-header">
           <view class="connected-icon">
-            <AppIcon name="bluetooth" size="md" color="white" />
+            <AppIcon :name="printerType === 'builtin' ? 'printer' : 'bluetooth'" size="md" color="white" />
           </view>
           <view class="connected-info">
             <text class="connected-name">{{ connectedDevice.name }}</text>
@@ -167,9 +173,11 @@ import AppIcon from '../../components/AppIcon.vue'
 import SideMenu from '../../components/SideMenu.vue'
 import LocationPicker from '../../components/LocationPicker.vue'
 import { getStatusBarHeight } from '../../utils/statusBar'
+import { getDeviceIdentity } from '../../utils/deviceInfo'
 import classicBluetooth from '../../utils/print/bluetoothTool.js'
 import {
   getPrinterType,
+  getAvailablePrinterTypes,
   clearPrinter,
   type PrinterType,
 } from '../../utils/print/printerConnection'
@@ -189,7 +197,14 @@ const isScanning = ref(false)
 const connectingId = ref('')
 const errorMsg = ref('')
 const btAdapterReady = ref(false)
-const printerType = ref<PrinterType | ''>(getPrinterType() || 'bluetooth')
+const availablePrinterTypes = getAvailablePrinterTypes()
+const availablePrinterTypesLabel = availablePrinterTypes.map(item => item === 'builtin' ? 'Built-in' : 'Bluetooth').join(' / ')
+const deviceIdentity = getDeviceIdentity()
+const storedPrinterType = getPrinterType()
+const preferredPrinterType = (storedPrinterType && availablePrinterTypes.includes(storedPrinterType as PrinterType))
+  ? storedPrinterType as PrinterType
+  : availablePrinterTypes[0]
+const printerType = ref<PrinterType | ''>(preferredPrinterType || 'bluetooth')
 const currentPrinter = ref(getCurrentPrinterSummary())
 const debugInfo = ref({
   currentMode: 'none',
@@ -211,6 +226,8 @@ interface BtDevice {
 
 const devices = ref<BtDevice[]>([])
 const discoveredIds = new Set<string>()
+const isBluetoothModeAvailable = availablePrinterTypes.includes('bluetooth')
+const isBuiltinModeAvailable = availablePrinterTypes.includes('builtin')
 
 function refreshCurrentPrinter () {
   currentPrinter.value = getCurrentPrinterSummary()
@@ -237,6 +254,7 @@ const connectedDevice = computed(() => {
 })
 
 function switchType (type: 'bluetooth' | 'builtin') {
+  if (!availablePrinterTypes.includes(type)) return
   printerType.value = type
   if (type === 'bluetooth' && getPrinterType() === 'builtin') {
     clearPrinter()
@@ -487,6 +505,7 @@ const handleTestPrint = async () => {
   if (testPrinting.value) return
   testPrinting.value = true
   try {
+    uni.showLoading({ title: 'Preparing test print...', mask: true })
     await testPrintCurrentPrinter((p) => {
       if (p < 100) uni.showLoading({ title: `Printing ${p}%`, mask: true })
     })
@@ -533,7 +552,7 @@ onMounted(() => {
       errorMsg.value = ''
     }
   })
-  printerType.value = getPrinterType() || 'bluetooth'
+  printerType.value = preferredPrinterType || 'bluetooth'
   refreshCurrentPrinter()
 })
 
diff --git a/美国版/Food Labeling Management App UniApp/src/pages/labels/labels.vue b/美国版/Food Labeling Management App UniApp/src/pages/labels/labels.vue
index 2fd3241..a430d78 100644
--- a/美国版/Food Labeling Management App UniApp/src/pages/labels/labels.vue
+++ b/美国版/Food Labeling Management App UniApp/src/pages/labels/labels.vue
@@ -146,6 +146,7 @@ import AppIcon from '../../components/AppIcon.vue'
 import SideMenu from '../../components/SideMenu.vue'
 import LocationPicker from '../../components/LocationPicker.vue'
 import { getStatusBarHeight } from '../../utils/statusBar'
+import { getCurrentPrinterSummary } from '../../utils/print/manager/printerManager'
 
 const statusBarHeight = getStatusBarHeight()
 const isMenuOpen = ref(false)
@@ -160,9 +161,9 @@ const btConnected = ref(false)
 const btDeviceName = ref('')
 
 onShow(() => {
-  const name = uni.getStorageSync('btDeviceName')
-  btConnected.value = !!name
-  btDeviceName.value = name || ''
+  const summary = getCurrentPrinterSummary()
+  btConnected.value = summary.type === 'bluetooth' || summary.type === 'builtin'
+  btDeviceName.value = summary.displayName || ''
 })
 
 const labelCategories = [
diff --git a/美国版/Food Labeling Management App UniApp/src/pages/labels/preview.vue b/美国版/Food Labeling Management App UniApp/src/pages/labels/preview.vue
index f6b9771..101e955 100644
--- a/美国版/Food Labeling Management App UniApp/src/pages/labels/preview.vue
+++ b/美国版/Food Labeling Management App UniApp/src/pages/labels/preview.vue
@@ -118,8 +118,11 @@ import SideMenu from '../../components/SideMenu.vue'
 import LocationPicker from '../../components/LocationPicker.vue'
 import { getStatusBarHeight } from '../../utils/statusBar'
 import { generateNextLabelId } from '../../utils/printLog'
-import { getCurrentPrinterSummary, printLabelForCurrentPrinter } from '../../utils/print/manager/printerManager'
+import { getCurrentPrinterSummary, printSystemTemplateForCurrentPrinter } from '../../utils/print/manager/printerManager'
+import { PREVIEW_SYSTEM_TEMPLATE } from '../../utils/print/templates/previewSystemTemplate'
 import chickenLabelImg from '../../static/chicken-lable.png'
+import label1Img from '../../static/lable1.png'
+import label2Img from '../../static/lable2.png'
 
 const statusBarHeight = getStatusBarHeight()
 const isPrinting = ref(false)
@@ -146,9 +149,9 @@ const labelImage = computed(() => {
   }
   const size = templateSize.value
   if (size.indexOf('2"x6"') >= 0 || size.indexOf('2"x4"') >= 0) {
-    return '/static/lable2.png'
+    return label2Img
   }
-  return '/static/lable1.png'
+  return label1Img
 })
 
 // 按详情规则与产品列表一致：chicken→Chicken，lable2→Cheese Burger Deluxe，lable1→Syrup
@@ -159,6 +162,15 @@ const displayProductName = computed(() => {
   return 'Syrup'
 })
 
+const printTemplateData = computed(() => ({
+  product: displayProductName.value,
+  productName: displayProductName.value,
+  category: productCategory.value,
+  labelId: labelId.value,
+  qrCode: labelId.value,
+  barcode: labelId.value,
+}))
+
 onShow(() => {
   const summary = getCurrentPrinterSummary()
   btConnected.value = summary.type === 'bluetooth' || summary.type === 'builtin'
@@ -237,11 +249,10 @@ const handlePrint = async () => {
   }
   isPrinting.value = true
   try {
-    await printLabelForCurrentPrinter({
-      productName: displayProductName.value,
-      labelId: labelId.value,
+    uni.showLoading({ title: 'Preparing print data...', mask: true })
+    await new Promise(resolve => setTimeout(resolve, 30))
+    await printSystemTemplateForCurrentPrinter(PREVIEW_SYSTEM_TEMPLATE, printTemplateData.value, {
       printQty: printQty.value,
-      extraLine: lastEdited.value,
     }, (percent) => {
       if (percent >= 100) return
       uni.showLoading({ title: `Printing ${percent}%`, mask: true })
diff --git a/美国版/Food Labeling Management App UniApp/src/pages/more/printers.vue b/美国版/Food Labeling Management App UniApp/src/pages/more/printers.vue
index c8aa460..d83ea4a 100644
--- a/美国版/Food Labeling Management App UniApp/src/pages/more/printers.vue
+++ b/美国版/Food Labeling Management App UniApp/src/pages/more/printers.vue
@@ -24,6 +24,10 @@
       <view class="debug-card">
         <text class="debug-title">Debug Status</text>
         <text class="debug-item">Current Mode: {{ debugInfo.currentMode }}</text>
+        <text class="debug-item">Available Mode: {{ availablePrinterTypesLabel }}</text>
+        <text class="debug-item">Device Model: {{ deviceIdentity.model || '-' }}</text>
+        <text class="debug-item">Device Brand: {{ deviceIdentity.brand || '-' }}</text>
+        <text class="debug-item">Device Product: {{ deviceIdentity.product || '-' }}</text>
         <text class="debug-item">Classic Module: {{ debugInfo.classicModuleReady ? 'Ready' : 'Not Ready' }}</text>
         <text class="debug-item">Paired Count: {{ debugInfo.pairedCount }}</text>
         <text class="debug-item">Virtual BT Printer: {{ debugInfo.foundVirtualPrinter ? 'Found' : 'Not Found' }}</text>
@@ -39,7 +43,7 @@
       <view v-if="currentType" class="printer-card connected">
         <view class="printer-icon"><AppIcon name="printer" size="md" color="white" /></view>
         <view class="printer-info">
-          <text class="printer-name">{{ currentType === 'builtin' ? t('printers.builtin') : (currentBt?.deviceName || 'Bluetooth Printer') }}</text>
+          <text class="printer-name">{{ currentDisplayName }}</text>
           <text class="printer-loc">{{ currentType === 'builtin' ? '127.0.0.1' : (currentBt?.deviceId || '') }}</text>
           <text class="printer-status">{{ t('printers.connected') }}</text>
         </view>
@@ -50,7 +54,7 @@
       </view>
 
       <!-- Built-in Printer (Show when not connected) -->
-      <view v-if="!currentType" class="printer-card" @click="connectBuiltin">
+      <view v-if="!currentType && isBuiltinModeAvailable" class="printer-card" @click="connectBuiltin">
         <view class="printer-icon"><AppIcon name="printer" size="md" color="blue" /></view>
         <view class="printer-info">
           <text class="printer-name">{{ t('printers.builtin') }}</text>
@@ -60,6 +64,7 @@
       </view>
 
       <!-- Paired Devices -->
+      <template v-if="isBluetoothModeAvailable">
       <!-- #ifdef APP-PLUS -->
       <view class="section-header">
         <text class="section-title">{{ t('printers.pairedDevices') }}</text>
@@ -108,33 +113,60 @@
       <view v-if="devices.length === 0 && !isScanning" class="empty-state">
         <text class="empty-text">{{ t('printers.noDevices') }}</text>
       </view>
+      </template>
     </view>
 
+    <canvas
+      canvas-id="test-print-canvas-printers"
+      id="test-print-canvas-printers"
+      :style="{
+        position: 'fixed',
+        left: '-9999px',
+        top: '-9999px',
+        width: testCanvasWidth + 'px',
+        height: testCanvasHeight + 'px',
+        opacity: 0,
+        pointerEvents: 'none',
+      }"
+      :width="testCanvasWidth"
+      :height="testCanvasHeight"
+    />
+
     <SideMenu v-model="isMenuOpen" />
   </view>
 </template>
 
 <script setup lang="ts">
-import { ref, onMounted, onUnmounted } from 'vue'
+import { ref, onMounted, onUnmounted, getCurrentInstance, nextTick } from 'vue'
 import { useI18n } from 'vue-i18n'
 import AppIcon from '../../components/AppIcon.vue'
 import SideMenu from '../../components/SideMenu.vue'
+import { getDeviceIdentity } from '../../utils/deviceInfo'
 import classicBluetooth from '../../utils/print/bluetoothTool.js'
 import { ensureBluetoothPermissions } from '../../utils/print/bluetoothPermissions'
+import { getAvailablePrinterTypes } from '../../utils/print/printerConnection'
 import {
   connectBluetoothPrinter,
   describeDiscoveredPrinter,
   disconnectCurrentPrinter,
+  getCurrentPrinterDriver,
   getCurrentPrinterSummary,
-  testPrintCurrentPrinter,
+  printImageDataForCurrentPrinter,
   useBuiltinPrinter,
 } from '../../utils/print/manager/printerManager'
+import { getTestPrintCanvasSize, renderTestPrintCanvasImageData } from '../../utils/print/testPrintCanvas'
 
 const { t } = useI18n()
 const isMenuOpen = ref(false)
+const availablePrinterTypes = getAvailablePrinterTypes()
+const availablePrinterTypesLabel = availablePrinterTypes.map(item => item === 'builtin' ? 'Built-in' : 'Bluetooth').join(' / ')
+const deviceIdentity = getDeviceIdentity()
+const isBluetoothModeAvailable = availablePrinterTypes.includes('bluetooth')
+const isBuiltinModeAvailable = availablePrinterTypes.includes('builtin')
 
 const currentType = ref<'' | 'bluetooth' | 'builtin'>('')
 const currentBt = ref<any>(null)
+const currentDisplayName = ref('')
 const isScanning = ref(false)
 const devices = ref<any[]>([])
 const pairedDevices = ref<any[]>([])
@@ -149,11 +181,15 @@ const debugInfo = ref({
   lastBleError: '',
   locationServiceRequired: false,
 })
+const testCanvasWidth = ref(384)
+const testCanvasHeight = ref(240)
+const pageInstance = getCurrentInstance()?.proxy
 let bleListenerRegistered = false
 
 const refreshStatus = () => {
   const summary = getCurrentPrinterSummary()
   currentType.value = summary.type
+  currentDisplayName.value = summary.displayName || ''
   debugInfo.value.currentMode = summary.type || 'none'
   currentBt.value = summary.type === 'bluetooth'
     ? {
@@ -378,16 +414,18 @@ const disconnect = async () => {
 
 const doTestPrint = async () => {
   try {
-    if (currentType.value === 'builtin') {
-      uni.showModal({
-        title: 'Current Mode is Built-in',
-        content: 'This handheld device is currently using Built-in mode. Please disconnect it, then connect "Virtual BT Printer" from the Paired Devices list and test print again.',
-        showCancel: false,
-      })
-      return
-    }
-    uni.showLoading({ title: t('labels.print.printing') })
-    await testPrintCurrentPrinter()
+    uni.showLoading({ title: 'Rendering canvas...', mask: true })
+    const driver = getCurrentPrinterDriver()
+    const size = getTestPrintCanvasSize(driver.imageMaxWidthDots || (driver.protocol === 'esc' ? 384 : 800))
+    testCanvasWidth.value = size.width
+    testCanvasHeight.value = size.height
+    await nextTick()
+    const imageData = await renderTestPrintCanvasImageData('test-print-canvas-printers', pageInstance, size)
+    await printImageDataForCurrentPrinter(imageData, { printQty: 1 }, (percent) => {
+      if (percent < 100) {
+        uni.showLoading({ title: `Printing ${percent}%`, mask: true })
+      }
+    })
     uni.hideLoading()
     uni.showToast({ title: t('printers.testPrintSuccess') })
   } catch (e: any) {
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/deviceInfo.ts b/美国版/Food Labeling Management App UniApp/src/utils/deviceInfo.ts
new file mode 100644
index 0000000..c79ac3e
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/deviceInfo.ts
@@ -0,0 +1,63 @@
+export interface DeviceIdentity {
+  model: string
+  brand: string
+  manufacturer: string
+  product: string
+  device: string
+  platform: string
+}
+
+let cachedDeviceIdentity: DeviceIdentity | null = null
+
+function safeText (value: unknown): string {
+  return String(value || '').trim()
+}
+
+export function getDeviceIdentity (): DeviceIdentity {
+  if (cachedDeviceIdentity) return cachedDeviceIdentity
+
+  const info = (() => {
+    try {
+      return uni.getSystemInfoSync()
+    } catch (_) {
+      return {} as UniApp.GetSystemInfoResult
+    }
+  })()
+
+  const identity: DeviceIdentity = {
+    model: safeText((info as any).model),
+    brand: safeText((info as any).brand),
+    manufacturer: '',
+    product: '',
+    device: '',
+    platform: safeText((info as any).platform),
+  }
+
+  // #ifdef APP-PLUS
+  try {
+    const Build = plus.android.importClass('android.os.Build')
+    identity.model = safeText((Build as any).MODEL) || identity.model
+    identity.brand = safeText((Build as any).BRAND) || identity.brand
+    identity.manufacturer = safeText((Build as any).MANUFACTURER)
+    identity.product = safeText((Build as any).PRODUCT)
+    identity.device = safeText((Build as any).DEVICE)
+  } catch (_) {}
+  // #endif
+
+  cachedDeviceIdentity = identity
+  return identity
+}
+
+export function getDeviceFingerprint (): string {
+  const identity = getDeviceIdentity()
+  return [
+    identity.brand,
+    identity.manufacturer,
+    identity.model,
+    identity.product,
+    identity.device,
+  ]
+    .filter(Boolean)
+    .join(' | ')
+    .toLowerCase()
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/bluetoothTool.js b/美国版/Food Labeling Management App UniApp/src/utils/print/bluetoothTool.js
index 6f0667e..c48ba0c 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/bluetoothTool.js
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/bluetoothTool.js
@@ -16,6 +16,7 @@ let IntentFilter = plus.android.importClass('android.content.IntentFilter')
 let BluetoothDevice = plus.android.importClass('android.bluetooth.BluetoothDevice')
 let UUID = plus.android.importClass('java.util.UUID')
 let Toast = plus.android.importClass('android.widget.Toast')
+let Thread = plus.android.importClass('java.lang.Thread')
 let MY_UUID = UUID.fromString('00001101-0000-1000-8000-00805F9B34FB')
 
 let invoke = plus.android.invoke
@@ -62,19 +63,78 @@ function normalizeWriteByte (value) {
   return byte & 0xff
 }
 
+function toSignedWriteByte (value) {
+  const byte = normalizeWriteByte(value)
+  return byte >= 128 ? byte - 256 : byte
+}
+
 function normalizeWriteChunk (byteData, start, end) {
   const out = []
   for (let i = start; i < end; i++) {
-    const value = normalizeWriteByte(byteData[i])
-    if (value >= 128) {
-      out.push(value - 256)
-    } else {
-      out.push(value)
-    }
+    out.push(toSignedWriteByte(byteData[i]))
   }
   return out
 }
 
+function isConnectionStateConnected (state) {
+  return String(state || '').trim().toLowerCase() === 'connected'
+}
+
+function runOnUiThread (fn) {
+  // #ifdef APP-PLUS
+  try {
+    if (activity && typeof activity.runOnUiThread === 'function') {
+      const runnable = plus.android.implements('java.lang.Runnable', {
+        run: function () {
+          try {
+            fn && fn()
+          } catch (e) {
+            console.error('runOnUiThread callback failed:', e)
+          }
+        },
+      })
+      activity.runOnUiThread(runnable)
+      return
+    }
+  } catch (e) {
+    console.error('runOnUiThread failed:', e)
+  }
+  // #endif
+  try {
+    setTimeout(() => {
+      try {
+        fn && fn()
+      } catch (e) {
+        console.error('setTimeout callback failed:', e)
+      }
+    }, 0)
+  } catch (e) {
+    console.error('async callback fallback failed:', e)
+  }
+}
+
+function startBackgroundTask (task) {
+  // #ifdef APP-PLUS
+  const runnable = plus.android.implements('java.lang.Runnable', {
+    run: function () {
+      try {
+        task && task()
+      } catch (e) {
+        console.error('Background task failed:', e)
+      }
+    },
+  })
+  const thread = new Thread(runnable)
+  thread.start()
+  return
+  // #endif
+  try {
+    task && task()
+  } catch (e) {
+    console.error('Fallback task failed:', e)
+  }
+}
+
 function createSocketCandidates (device) {
   return [
     {
@@ -109,6 +169,7 @@ var blueToothTool = {
     lastSendError: '',
     outputReady: false,
     lastSendMode: 'idle',
+    isSending: false,
   },
   options: {
     listenBTStatusCallback: function (state) {},
@@ -489,26 +550,37 @@ var blueToothTool = {
   },
   sendByteData (byteData) {
     // #ifdef APP-PLUS
-    if (!this.ensureConnection(this.state.lastAddress)) {
+    if (!btOutStream) {
+      this.state.outputReady = false
+      this.state.connectionState = 'error'
+      this.setErrorState('Classic Bluetooth output stream not ready', 'send')
+      this.shortToast('Not connected')
+      return false
+    }
+    const socketConnected = this.isSocketConnected()
+    const connectionUsable = socketConnected || isConnectionStateConnected(this.state.connectionState)
+    if (!connectionUsable) {
+      this.state.connectionState = 'error'
+      this.setErrorState('Classic Bluetooth connection is not ready', 'send')
       this.shortToast('Not connected')
       return false
     }
     try {
-      const CHUNK_SIZE = 512
+      const CHUNK_SIZE = 4096
       this.state.lastSendMode = 'chunk-write'
       this.state.lastSendError = ''
       for (let i = 0; i < byteData.length; i += CHUNK_SIZE) {
-        const chunk = normalizeWriteChunk(byteData, i, Math.min(i + CHUNK_SIZE, byteData.length))
+        const chunk = byteData.slice(i, Math.min(i + CHUNK_SIZE, byteData.length))
         try {
           btOutStream.write(chunk)
         } catch (writeChunkError) {
           this.state.lastSendMode = 'byte-write-fallback'
+          const signedChunk = normalizeWriteChunk(byteData, i, Math.min(i + CHUNK_SIZE, byteData.length))
           for (let j = 0; j < chunk.length; j++) {
-            invoke(btOutStream, 'write', normalizeWriteByte(chunk[j]))
+            invoke(btOutStream, 'write', normalizeWriteByte(signedChunk[j]))
           }
         }
       }
-      invoke(btOutStream, 'flush')
       return true
     } catch (e) {
       const message = getErrorMessage(e)
@@ -520,6 +592,53 @@ var blueToothTool = {
     // #endif
     return false
   },
+  sendByteDataAsync (byteData, callback) {
+    // #ifdef APP-PLUS
+    if (!btOutStream) {
+      this.state.outputReady = false
+      this.state.connectionState = 'error'
+      this.setErrorState('Classic Bluetooth output stream not ready', 'send')
+      runOnUiThread(() => {
+        callback && callback(false, this.getLastError())
+      })
+      return false
+    }
+    const socketConnected = this.isSocketConnected()
+    const connectionUsable = socketConnected || isConnectionStateConnected(this.state.connectionState)
+    if (!connectionUsable) {
+      this.state.connectionState = 'error'
+      this.setErrorState('Classic Bluetooth connection is not ready', 'send')
+      runOnUiThread(() => {
+        callback && callback(false, this.getLastError())
+      })
+      return false
+    }
+    this.state.isSending = true
+    this.state.lastSendError = ''
+    startBackgroundTask(() => {
+      let ok = false
+      let errorMessage = ''
+      try {
+        ok = this.sendByteData(byteData)
+        if (!ok) {
+          errorMessage = this.getLastError() || 'Classic Bluetooth send failed'
+        }
+      } catch (e) {
+        errorMessage = getErrorMessage(e)
+        this.setErrorState(errorMessage, 'send')
+        this.state.connectionState = 'error'
+      } finally {
+        this.state.isSending = false
+      }
+      runOnUiThread(() => {
+        callback && callback(ok, errorMessage)
+      })
+    })
+    return true
+    // #endif
+    callback && callback(false, 'Classic Bluetooth is only available in the app.')
+    return false
+  },
   isSocketConnected () {
     // #ifdef APP-PLUS
     if (!btSocket) return false
@@ -537,7 +656,7 @@ var blueToothTool = {
     if (targetAddress) {
       this.state.lastAddress = targetAddress
     }
-    if (btOutStream && this.isSocketConnected()) {
+    if (btOutStream && (this.isSocketConnected() || isConnectionStateConnected(this.state.connectionState))) {
       this.state.outputReady = true
       return true
     }
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/d320fax.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/d320fax.ts
index f44dfce..793fd4c 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/d320fax.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/d320fax.ts
@@ -25,6 +25,8 @@ export const d320faxDriver: PrinterDriver = {
   protocol: 'tsc',
   preferredConnection: 'classic',
   preferredBleMtu: 20,
+  imageMaxWidthDots: 800,
+  imageDpi: 203,
   keywords: KEYWORDS,
   matches (device) {
     return score(device)
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/genericTsc.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/genericTsc.ts
index ef4c427..352599c 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/genericTsc.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/genericTsc.ts
@@ -22,6 +22,8 @@ export const genericTscDriver: PrinterDriver = {
   displayName: 'Generic TSC Printer',
   protocol: 'tsc',
   preferredBleMtu: 20,
+  imageMaxWidthDots: 800,
+  imageDpi: 203,
   keywords: GENERIC_TSC_KEYWORDS,
   matches (device) {
     return scoreByKeywords(device, GENERIC_TSC_KEYWORDS)
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/gpR3.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/gpR3.ts
index 870804b..df2ed92 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/gpR3.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/drivers/gpR3.ts
@@ -25,6 +25,8 @@ export const gpR3Driver: PrinterDriver = {
   protocol: 'esc',
   preferredConnection: 'classic',
   preferredBleMtu: 20,
+  imageMaxWidthDots: 384,
+  imageDpi: 203,
   keywords: KEYWORDS,
   matches (device) {
     return score(device)
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/imageRaster.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/imageRaster.ts
new file mode 100644
index 0000000..a2c9d37
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/imageRaster.ts
@@ -0,0 +1,174 @@
+import type { MonochromeImageData, PrintImageOptions, PrinterDriver, RawImageDataSource } from './types/printer'
+
+const DEFAULT_IMAGE_THRESHOLD = 180
+
+function yieldToUi (): Promise<void> {
+  return new Promise((resolve) => {
+    setTimeout(resolve, 0)
+  })
+}
+
+function ensureMultipleOf8 (value: number, maxValue?: number): number {
+  const safeMax = maxValue && maxValue > 0 ? Math.max(8, Math.floor(maxValue)) : 0
+  let width = Math.max(8, Math.round(value || 0))
+  if (safeMax && width > safeMax) width = safeMax
+  if (width % 8 !== 0) {
+    width += 8 - (width % 8)
+    if (safeMax && width > safeMax) {
+      width = safeMax - (safeMax % 8)
+      if (width <= 0) width = 8
+    }
+  }
+  return width
+}
+
+function normalizeBase64Payload (source: string): string {
+  const value = String(source || '').trim()
+  if (!value) return ''
+  if (value.startsWith('data:image/')) {
+    const index = value.indexOf(',')
+    return index >= 0 ? value.slice(index + 1) : ''
+  }
+  if (/^[A-Za-z0-9+/=\r\n]+$/.test(value) && value.length > 128) {
+    return value.replace(/\s+/g, '')
+  }
+  return ''
+}
+
+function resolveLocalImagePath (source: string): string {
+  let path = String(source || '').trim()
+  if (!path) return ''
+  if (path.startsWith('file://')) {
+    path = path.replace(/^file:\/\//, '')
+  }
+  // #ifdef APP-PLUS
+  try {
+    const converted = plus.io.convertLocalFileSystemURL(path)
+    if (converted) path = converted
+  } catch (_) {}
+  // #endif
+  try {
+    path = decodeURIComponent(path)
+  } catch (_) {}
+  return path
+}
+
+function getDefaultMaxWidthDots (driver: PrinterDriver): number {
+  if (driver.imageMaxWidthDots && driver.imageMaxWidthDots > 0) return driver.imageMaxWidthDots
+  return driver.protocol === 'esc' ? 384 : 800
+}
+
+export function rasterizeImageData (
+  source: RawImageDataSource,
+  options: PrintImageOptions = {}
+): MonochromeImageData {
+  const sourceWidth = Math.max(1, Math.round(source.width || 0))
+  const sourceHeight = Math.max(1, Math.round(source.height || 0))
+  const targetWidth = ensureMultipleOf8(sourceWidth)
+  const threshold = options.threshold != null ? Number(options.threshold) : DEFAULT_IMAGE_THRESHOLD
+  const pixels: number[] = new Array(targetWidth * sourceHeight).fill(0)
+
+  for (let y = 0; y < sourceHeight; y++) {
+    for (let x = 0; x < sourceWidth; x++) {
+      const index = (y * sourceWidth + x) * 4
+      const alpha = Number(source.data[index + 3] ?? 255)
+      const red = Number(source.data[index] ?? 255)
+      const green = Number(source.data[index + 1] ?? 255)
+      const blue = Number(source.data[index + 2] ?? 255)
+      const gray = red * 0.299 + green * 0.587 + blue * 0.114
+      pixels[y * targetWidth + x] = alpha <= 10 || gray > threshold ? 0 : 1
+    }
+  }
+
+  return {
+    width: targetWidth,
+    height: sourceHeight,
+    pixels,
+  }
+}
+
+export async function rasterizeImageForPrinter (
+  source: string,
+  driver: PrinterDriver,
+  options: PrintImageOptions = {}
+): Promise<MonochromeImageData> {
+  // #ifdef APP-PLUS
+  const rawSource = String(source || '').trim()
+  if (!rawSource) {
+    throw new Error('IMAGE_SOURCE_EMPTY')
+  }
+
+  const BitmapFactory = plus.android.importClass('android.graphics.BitmapFactory')
+  const Bitmap = plus.android.importClass('android.graphics.Bitmap')
+  const Base64 = plus.android.importClass('android.util.Base64')
+
+  const base64Payload = normalizeBase64Payload(rawSource)
+  let sourceBitmap: any = null
+
+  if (base64Payload) {
+    const bytes = Base64.decode(base64Payload, 0)
+    sourceBitmap = BitmapFactory.decodeByteArray(bytes, 0, bytes.length)
+  } else {
+    const localPath = resolveLocalImagePath(rawSource)
+    sourceBitmap = BitmapFactory.decodeFile(localPath)
+  }
+
+  if (!sourceBitmap) {
+    throw new Error('IMAGE_DECODE_FAILED')
+  }
+
+  const sourceWidth = Number(sourceBitmap.getWidth ? sourceBitmap.getWidth() : 0)
+  const sourceHeight = Number(sourceBitmap.getHeight ? sourceBitmap.getHeight() : 0)
+  if (!sourceWidth || !sourceHeight) {
+    try {
+      sourceBitmap.recycle && sourceBitmap.recycle()
+    } catch (_) {}
+    throw new Error('IMAGE_SIZE_INVALID')
+  }
+
+  const protocolMaxWidth = getDefaultMaxWidthDots(driver)
+  const maxWidthDots = options.maxWidthDots && options.maxWidthDots > 0 ? options.maxWidthDots : protocolMaxWidth
+  const targetWidth = ensureMultipleOf8(options.targetWidthDots || sourceWidth, maxWidthDots)
+  const aspectRatio = sourceHeight / sourceWidth
+  const targetHeight = Math.max(
+    1,
+    Math.round(options.targetHeightDots || (targetWidth * aspectRatio))
+  )
+  const threshold = options.threshold != null ? Number(options.threshold) : DEFAULT_IMAGE_THRESHOLD
+
+  const scaledBitmap = Bitmap.createScaledBitmap(sourceBitmap, targetWidth, targetHeight, true)
+  const rasterPixels: number[] = new Array(targetWidth * targetHeight)
+
+  for (let y = 0; y < targetHeight; y++) {
+    if (y > 0 && y % 16 === 0) {
+      await yieldToUi()
+    }
+    for (let x = 0; x < targetWidth; x++) {
+      const color = Number(scaledBitmap.getPixel(x, y))
+      const alpha = (color >>> 24) & 0xff
+      const red = (color >>> 16) & 0xff
+      const green = (color >>> 8) & 0xff
+      const blue = color & 0xff
+      const gray = red * 0.299 + green * 0.587 + blue * 0.114
+      rasterPixels[y * targetWidth + x] = alpha <= 10 || gray > threshold ? 0 : 1
+    }
+  }
+
+  try {
+    if (scaledBitmap !== sourceBitmap && sourceBitmap?.recycle) sourceBitmap.recycle()
+  } catch (_) {}
+  try {
+    scaledBitmap?.recycle && scaledBitmap.recycle()
+  } catch (_) {}
+
+  return {
+    width: targetWidth,
+    height: targetHeight,
+    pixels: rasterPixels,
+  }
+  // #endif
+
+  // #ifndef APP-PLUS
+  throw new Error('IMAGE_PRINT_APP_ONLY')
+  // #endif
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/manager/printerManager.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/manager/printerManager.ts
index 359ed2b..5b11457 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/manager/printerManager.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/manager/printerManager.ts
@@ -8,14 +8,29 @@ import {
   setBuiltinPrinter,
 } from '../printerConnection'
 import classicBluetooth from '../bluetoothTool.js'
+import { rasterizeImageData, rasterizeImageForPrinter } from '../imageRaster'
+import { buildEscPosImageData, buildEscPosTemplateData } from '../protocols/escPosBuilder'
+import { buildTscImageData, buildTscTemplateData } from '../protocols/tscProtocol'
+import { adaptSystemLabelTemplate } from '../systemTemplateAdapter'
 import { describePrinterCandidate, getPrinterDriverByKey, resolvePrinterDriver } from './driverRegistry'
 import type {
   CurrentPrinterSummary,
   LabelPrintPayload,
+  LabelTemplateData,
+  RawImageDataSource,
+  PrintImageOptions,
   PrinterCandidate,
   PrinterDriver,
+  StructuredLabelTemplate,
+  SystemLabelTemplate,
 } from '../types/printer'
 
+function getPrinterTypeDisplayName (type: '' | 'bluetooth' | 'builtin'): string {
+  if (type === 'bluetooth') return 'Bluetooth'
+  if (type === 'builtin') return 'Built-in'
+  return ''
+}
+
 function connectClassicBluetooth (device: PrinterCandidate, driver: PrinterDriver): Promise<void> {
   return new Promise((resolve, reject) => {
     // #ifdef APP-PLUS
@@ -159,7 +174,7 @@ export function getCurrentPrinterSummary (): CurrentPrinterSummary {
   if (type === 'builtin') {
     return {
       type,
-      displayName: 'Built-in Printer',
+      displayName: getPrinterTypeDisplayName(type),
       deviceId: 'builtin',
       driverKey: driver.key,
       driverName: driver.displayName,
@@ -172,7 +187,7 @@ export function getCurrentPrinterSummary (): CurrentPrinterSummary {
     if (connection) {
       return {
         type,
-        displayName: connection.deviceName || driver.displayName,
+        displayName: getPrinterTypeDisplayName(type),
         deviceId: connection.deviceId,
         driverKey: driver.key,
         driverName: driver.displayName,
@@ -207,6 +222,74 @@ export async function printLabelForCurrentPrinter (
   return driver
 }
 
+export async function printImageForCurrentPrinter (
+  imageSource: string,
+  options: PrintImageOptions = {},
+  onProgress?: (percent: number) => void
+): Promise<PrinterDriver> {
+  const driver = getCurrentPrinterDriver()
+  const raster = await rasterizeImageForPrinter(imageSource, driver, options)
+  if (onProgress) onProgress(5)
+  let data: number[] = []
+
+  if (driver.protocol === 'esc') {
+    data = buildEscPosImageData(raster, options)
+  } else {
+    data = buildTscImageData(raster, options, driver.imageDpi || 203)
+  }
+
+  await sendToPrinter(data, onProgress)
+  return driver
+}
+
+export async function printImageDataForCurrentPrinter (
+  imageData: RawImageDataSource,
+  options: PrintImageOptions = {},
+  onProgress?: (percent: number) => void
+): Promise<PrinterDriver> {
+  const driver = getCurrentPrinterDriver()
+  const raster = rasterizeImageData(imageData, options)
+  if (onProgress) onProgress(5)
+  const data = driver.protocol === 'esc'
+    ? buildEscPosImageData(raster, options)
+    : buildTscImageData(raster, options, driver.imageDpi || 203)
+  await sendToPrinter(data, onProgress)
+  return driver
+}
+
+export async function printTemplateForCurrentPrinter (
+  template: StructuredLabelTemplate,
+  data: LabelTemplateData = {},
+  onProgress?: (percent: number) => void
+): Promise<PrinterDriver> {
+  const driver = getCurrentPrinterDriver()
+  const bytes = driver.protocol === 'esc'
+    ? buildEscPosTemplateData(template, data)
+    : buildTscTemplateData(template, data)
+  await sendToPrinter(bytes, onProgress)
+  return driver
+}
+
+export async function printSystemTemplateForCurrentPrinter (
+  template: SystemLabelTemplate,
+  data: LabelTemplateData = {},
+  options: {
+    printQty?: number
+  } = {},
+  onProgress?: (percent: number) => void
+): Promise<PrinterDriver> {
+  const driver = getCurrentPrinterDriver()
+  const structuredTemplate = adaptSystemLabelTemplate(template, data, {
+    dpi: driver.imageDpi || 203,
+    printQty: options.printQty || 1,
+  })
+  const bytes = driver.protocol === 'esc'
+    ? buildEscPosTemplateData(structuredTemplate)
+    : buildTscTemplateData(structuredTemplate)
+  await sendToPrinter(bytes, onProgress)
+  return driver
+}
+
 export function describeDiscoveredPrinter (device: PrinterCandidate) {
   return describePrinterCandidate(device)
 }
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/printerConnection.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/printerConnection.ts
index b14ca66..8937397 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/printerConnection.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/printerConnection.ts
@@ -3,6 +3,7 @@
  */
 import type { ActiveBtDeviceType, PrinterType } from './types/printer'
 import classicBluetooth from './bluetoothTool.js'
+import { getDeviceFingerprint } from '../deviceInfo'
 
 const STORAGE_PRINTER_TYPE = 'printerType'
 const STORAGE_BT_DEVICE_ID = 'btDeviceId'
@@ -15,6 +16,10 @@ const STORAGE_BUILTIN_PORT = 'builtinPort'
 const STORAGE_PRINTER_DRIVER_KEY = 'printerDriverKey'
 
 const BUILTIN_PROBE_PORTS = [9100, 4000, 9000, 6000]
+const BUILTIN_PRINTER_DEVICE_KEYWORDS: string[] = [
+  // 在这里补充需要走 Built-in 的设备型号关键字（小写匹配）
+  // 例如：'desktop-aio', 'pos-terminal-x1'
+]
 export type BtDeviceType = ActiveBtDeviceType
 
 export const PrinterStorageKeys = {
@@ -71,7 +76,11 @@ export function clearPrinter () {
 const BLE_MTU_DEFAULT = 20
 
 export function getPrinterType (): PrinterType | '' {
-  return (uni.getStorageSync(STORAGE_PRINTER_TYPE) as PrinterType) || ''
+  const type = (uni.getStorageSync(STORAGE_PRINTER_TYPE) as PrinterType) || ''
+  if (!type) return ''
+  if (getAvailablePrinterTypes().includes(type)) return type
+  clearPrinter()
+  return ''
 }
 
 export function getCurrentPrinterDriverKey (): string {
@@ -116,6 +125,58 @@ export function isBuiltinConnected (): boolean {
   return getPrinterType() === 'builtin'
 }
 
+export function isBuiltinPrinterAvailable (): boolean {
+  // #ifdef APP-PLUS
+  try {
+    const plugin = (uni as any)?.requireNativePlugin
+      ? (uni as any).requireNativePlugin('moe-tcp-client')
+      : null
+    return !!plugin
+  } catch (_) {
+    return false
+  }
+  // #endif
+  // #ifndef APP-PLUS
+  return false
+  // #endif
+}
+
+export function isBuiltinPrinterEnabledByDeviceModel (): boolean {
+  const fingerprint = getDeviceFingerprint()
+  if (!fingerprint) return false
+  return BUILTIN_PRINTER_DEVICE_KEYWORDS.some(keyword => fingerprint.includes(String(keyword || '').toLowerCase()))
+}
+
+export function getAvailablePrinterTypes (): PrinterType[] {
+  if (isBuiltinPrinterAvailable() && isBuiltinPrinterEnabledByDeviceModel()) {
+    return ['builtin']
+  }
+  return ['bluetooth']
+}
+
+function buildClassicBluetoothError (message: string, deviceId?: string): Error {
+  const baseMessage = String(message || 'Classic Bluetooth error')
+  if (!classicBluetooth || typeof classicBluetooth.getDebugState !== 'function') {
+    return new Error(baseMessage)
+  }
+  try {
+    const debugState = classicBluetooth.getDebugState() || {}
+    const details: string[] = []
+    if (deviceId) details.push(`device=${deviceId}`)
+    if (debugState.lastSocketStrategy) details.push(`socket=${debugState.lastSocketStrategy}`)
+    if (debugState.connectionState) details.push(`state=${debugState.connectionState}`)
+    if (typeof debugState.socketConnected === 'boolean') details.push(`connected=${debugState.socketConnected}`)
+    if (typeof debugState.outputReady === 'boolean') details.push(`outputReady=${debugState.outputReady}`)
+    if (debugState.lastSendMode) details.push(`sendMode=${debugState.lastSendMode}`)
+    if (debugState.lastSendError) details.push(`sendError=${debugState.lastSendError}`)
+    else if (debugState.lastError) details.push(`lastError=${debugState.lastError}`)
+    if (details.length === 0) return new Error(baseMessage)
+    return new Error(`${baseMessage}\n${details.join('\n')}`)
+  } catch (_) {
+    return new Error(baseMessage)
+  }
+}
+
 /**
  * 发送打印数据到当前已选打印机
  * @param data 字节数组（TSC 指令）
@@ -200,29 +261,53 @@ function sendViaClassic (
         reject(new Error('Classic Bluetooth not available'))
         return
       }
-      const ready = typeof classicBluetooth.ensureConnection === 'function'
-        ? classicBluetooth.ensureConnection(conn.deviceId)
+      const debugState = typeof classicBluetooth.getDebugState === 'function'
+        ? classicBluetooth.getDebugState()
+        : null
+      const connectionState = String(debugState?.connectionState || '').trim().toLowerCase()
+      const ready = debugState
+        ? (!!debugState.outputReady && (!!debugState.socketConnected || connectionState === 'connected'))
         : true
       if (!ready) {
         const errorMessage = typeof classicBluetooth.getLastError === 'function'
           ? classicBluetooth.getLastError()
           : ''
-        reject(new Error(errorMessage || 'Classic Bluetooth connection is not ready'))
+        reject(buildClassicBluetoothError(errorMessage || 'Classic Bluetooth connection is not ready', conn.deviceId))
+        return
+      }
+
+      const sendData = data.map((byte) => {
+        const value = byte & 0xff
+        return value >= 128 ? value - 256 : value
+      })
+
+      if (typeof classicBluetooth.sendByteDataAsync === 'function') {
+        classicBluetooth.sendByteDataAsync(sendData, (ok: boolean, errorMessage?: string) => {
+          if (onProgress) onProgress(100)
+          if (ok) {
+            resolve()
+            return
+          }
+          reject(buildClassicBluetoothError(
+            errorMessage || classicBluetooth.getLastError?.() || 'Classic Bluetooth send failed',
+            conn.deviceId
+          ))
+        })
         return
       }
 
-      const sendData = data.map((byte) => byte & 0xff)
       const ok = classicBluetooth.sendByteData(sendData)
       if (onProgress) onProgress(100)
-      if (ok) resolve()
-      else {
-        const errorMessage = typeof classicBluetooth.getLastError === 'function'
-          ? classicBluetooth.getLastError()
-          : ''
-        reject(new Error(errorMessage || 'Classic Bluetooth send failed'))
+      if (ok) {
+        resolve()
+        return
       }
+      const errorMessage = typeof classicBluetooth.getLastError === 'function'
+        ? classicBluetooth.getLastError()
+        : ''
+      reject(buildClassicBluetoothError(errorMessage || 'Classic Bluetooth send failed', conn.deviceId))
     } catch (e: any) {
-      reject(e)
+      reject(buildClassicBluetoothError(e?.message || String(e || 'Classic Bluetooth send exception'), conn.deviceId))
     }
   })
   // #endif
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/escPosBuilder.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/escPosBuilder.ts
index 348056b..3deb609 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/escPosBuilder.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/escPosBuilder.ts
@@ -1,4 +1,12 @@
-import type { LabelPrintPayload } from '../types/printer'
+import type {
+  LabelPrintPayload,
+  LabelTemplateData,
+  MonochromeImageData,
+  PrintImageOptions,
+  StructuredLabelTemplate,
+} from '../types/printer'
+import { resolveEscTemplate } from '../templateRenderer'
+import { createTestPrintTemplate } from '../templates/testPrintTemplate'
 
 function stringToBytes (str: string): number[] {
   const out: number[] = []
@@ -35,6 +43,10 @@ function appendLine (out: number[], text = '') {
   out.push(0x0a)
 }
 
+function appendBytes (out: number[], bytes: number[]) {
+  for (let i = 0; i < bytes.length; i++) out.push(bytes[i])
+}
+
 function appendAlign (out: number[], align: 0 | 1 | 2) {
   out.push(0x1b, 0x61, align)
 }
@@ -48,6 +60,47 @@ function appendSize (out: number[], width = 0, height = 0) {
   out.push(0x1d, 0x21, value)
 }
 
+function clamp (value: number, min: number, max: number): number {
+  return Math.max(min, Math.min(max, Math.round(value)))
+}
+
+function normalizeEscBarcodeType (value?: string): number {
+  const key = String(value || 'CODE128').trim().toUpperCase()
+  const map: Record<string, number> = {
+    UPCA: 65,
+    UPCE: 66,
+    EAN13: 67,
+    EAN8: 68,
+    CODE39: 69,
+    ITF: 70,
+    CODABAR: 71,
+    CODE93: 72,
+    CODE128: 73,
+  }
+  return map[key] || 73
+}
+
+function normalizeEscQrLevel (value?: string): number {
+  const key = String(value || 'M').trim().toUpperCase()
+  const map: Record<string, number> = {
+    L: 48,
+    M: 49,
+    Q: 50,
+    H: 51,
+  }
+  return map[key] || 49
+}
+
+function appendHorizontalRule (out: number[], width = 32) {
+  appendLine(out, '+' + '-'.repeat(Math.max(width - 2, 0)) + '+')
+}
+
+function appendBoxLine (out: number[], text = '', width = 32) {
+  const innerWidth = Math.max(width - 4, 0)
+  const value = text.length > innerWidth ? text.slice(0, innerWidth) : text.padEnd(innerWidth, ' ')
+  appendLine(out, `| ${value} |`)
+}
+
 function createEscDocument (builder: (out: number[]) => void): number[] {
   const out: number[] = []
   out.push(0x1b, 0x40)
@@ -56,21 +109,80 @@ function createEscDocument (builder: (out: number[]) => void): number[] {
   return out
 }
 
+function appendRasterImage (out: number[], image: MonochromeImageData) {
+  const bytesPerRow = image.width / 8
+  const xL = bytesPerRow & 0xff
+  const xH = (bytesPerRow >> 8) & 0xff
+  const yL = image.height & 0xff
+  const yH = (image.height >> 8) & 0xff
+  out.push(0x1d, 0x76, 0x30, 0x00, xL, xH, yL, yH)
+  for (let y = 0; y < image.height; y++) {
+    for (let byteIndex = 0; byteIndex < bytesPerRow; byteIndex++) {
+      let value = 0
+      for (let bit = 0; bit < 8; bit++) {
+        const x = byteIndex * 8 + bit
+        const pixel = image.pixels[y * image.width + x]
+        if (pixel) value |= 1 << (7 - bit)
+      }
+      out.push(value & 0xff)
+    }
+  }
+}
+
+function appendBarcode (out: number[], item: {
+  value: string
+  align?: 0 | 1 | 2
+  symbology?: string
+  height?: number
+  width?: number
+  showText?: boolean
+}) {
+  const value = String(item.value || '')
+  if (!value) return
+  appendAlign(out, item.align ?? 1)
+  out.push(0x1d, 0x48, item.showText === false ? 0 : 2)
+  out.push(0x1d, 0x68, clamp(item.height || 96, 1, 255))
+  out.push(0x1d, 0x77, clamp(item.width || 3, 2, 6))
+
+  const type = normalizeEscBarcodeType(item.symbology)
+  const bytes = stringToBytes(value)
+
+  if (type >= 73) {
+    out.push(0x1d, 0x6b, type, clamp(bytes.length, 0, 255))
+    appendBytes(out, bytes)
+  } else {
+    out.push(0x1d, 0x6b, type)
+    appendBytes(out, bytes)
+    out.push(0x00)
+  }
+  out.push(0x0a)
+}
+
+function appendQrCode (out: number[], item: {
+  value: string
+  align?: 0 | 1 | 2
+  size?: number
+  level?: 'L' | 'M' | 'Q' | 'H'
+}) {
+  const value = String(item.value || '')
+  if (!value) return
+  const bytes = stringToBytes(value)
+  const storeLength = bytes.length + 3
+  const pL = storeLength & 0xff
+  const pH = (storeLength >> 8) & 0xff
+
+  appendAlign(out, item.align ?? 1)
+  out.push(0x1d, 0x28, 0x6b, 0x04, 0x00, 0x31, 0x41, 0x32, 0x00)
+  out.push(0x1d, 0x28, 0x6b, 0x03, 0x00, 0x31, 0x43, clamp(item.size || 5, 1, 16))
+  out.push(0x1d, 0x28, 0x6b, 0x03, 0x00, 0x31, 0x45, normalizeEscQrLevel(item.level))
+  out.push(0x1d, 0x28, 0x6b, pL, pH, 0x31, 0x50, 0x30)
+  appendBytes(out, bytes)
+  out.push(0x1d, 0x28, 0x6b, 0x03, 0x00, 0x31, 0x51, 0x30)
+  out.push(0x0a)
+}
+
 export function buildEscPosTestPrintData (): number[] {
-  return createEscDocument((out) => {
-    appendAlign(out, 1)
-    appendBold(out, true)
-    appendSize(out, 1, 1)
-    appendLine(out, 'TEST PRINT')
-    appendBold(out, false)
-    appendSize(out, 0, 0)
-    appendLine(out, 'GP-R3 / ESC-POS')
-    appendLine(out, 'Food Label System')
-    appendLine(out, '-----------------------------')
-    appendLine(out, 'Connection OK')
-    appendLine(out, 'Protocol OK')
-    appendLine(out, '-----------------------------')
-  })
+  return buildEscPosTemplateData(createTestPrintTemplate())
 }
 
 export function buildEscPosLabelData (payload: LabelPrintPayload): number[] {
@@ -98,3 +210,53 @@ export function buildEscPosLabelData (payload: LabelPrintPayload): number[] {
     appendLine(out, '-----------------------------')
   })
 }
+
+export function buildEscPosImageData (
+  image: MonochromeImageData,
+  options: PrintImageOptions = {}
+): number[] {
+  const printQty = Math.max(1, Math.round(options.printQty || 1))
+  return createEscDocument((out) => {
+    for (let i = 0; i < printQty; i++) {
+      appendAlign(out, 1)
+      appendRasterImage(out, image)
+      appendLine(out)
+      appendLine(out)
+    }
+  })
+}
+
+export function buildEscPosTemplateData (
+  template: StructuredLabelTemplate,
+  data: LabelTemplateData = {}
+): number[] {
+  const resolved = resolveEscTemplate(template, data)
+  const printQty = Math.max(1, Math.round(resolved.printQty || 1))
+  const feedLines = Math.max(1, Math.round(resolved.feedLines || 4))
+
+  return createEscDocument((out) => {
+    for (let i = 0; i < printQty; i++) {
+      resolved.items.forEach((item) => {
+        if (item.type === 'rule') {
+          appendHorizontalRule(out, item.width || 32)
+          return
+        }
+        if (item.type === 'qrcode') {
+          appendQrCode(out, item)
+          return
+        }
+        if (item.type === 'barcode') {
+          appendBarcode(out, item)
+          return
+        }
+        appendAlign(out, item.align ?? 0)
+        appendBold(out, !!item.bold)
+        appendSize(out, item.widthScale || 0, item.heightScale || 0)
+        appendLine(out, item.text)
+        appendBold(out, false)
+        appendSize(out, 0, 0)
+      })
+      out.push(0x1b, 0x64, feedLines)
+    }
+  })
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/tscProtocol.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/tscProtocol.ts
index 0d90e9f..4c1262e 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/tscProtocol.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/protocols/tscProtocol.ts
@@ -1,10 +1,37 @@
-import type { LabelPrintPayload } from '../types/printer'
-import { buildTestTscLabel, buildTscLabel } from '../tscLabelBuilder'
+import type {
+  LabelPrintPayload,
+  LabelTemplateData,
+  MonochromeImageData,
+  PrintImageOptions,
+  StructuredLabelTemplate,
+} from '../types/printer'
+import { resolveTscTemplate } from '../templateRenderer'
+import { createTestPrintTemplate } from '../templates/testPrintTemplate'
+import { buildTestTscLabel, buildTscImageLabel, buildTscLabel, buildTscTemplateLabel } from '../tscLabelBuilder'
 
 export function buildTscTestPrintData (): number[] {
-  return buildTestTscLabel()
+  const template = createTestPrintTemplate(203, 1)
+  if (!template.tsc) {
+    throw new Error('Test template does not support TSC printers')
+  }
+  return buildTscTemplateLabel(template.tsc)
 }
 
 export function buildTscLabelData (payload: LabelPrintPayload): number[] {
   return buildTscLabel(payload)
 }
+
+export function buildTscImageData (
+  image: MonochromeImageData,
+  options: PrintImageOptions = {},
+  dpi = 203
+): number[] {
+  return buildTscImageLabel(image, options, dpi)
+}
+
+export function buildTscTemplateData (
+  template: StructuredLabelTemplate,
+  data: LabelTemplateData = {}
+): number[] {
+  return buildTscTemplateLabel(resolveTscTemplate(template, data))
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/systemTemplateAdapter.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/systemTemplateAdapter.ts
new file mode 100644
index 0000000..51cbda0
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/systemTemplateAdapter.ts
@@ -0,0 +1,376 @@
+import { applyTemplateData } from './templateRenderer'
+import type {
+  EscTemplateItem,
+  LabelTemplateData,
+  PrinterTemplateUnit,
+  StructuredLabelTemplate,
+  TscTemplateItem,
+  StructuredTscTemplate,
+  StructuredEscTemplate,
+  SystemLabelTemplate,
+  SystemTemplateElementBase,
+  SystemTemplateTextAlign,
+} from './types/printer'
+
+const DESIGN_DPI = 96
+
+function roundNumber (value: number, digits = 1): number {
+  const factor = Math.pow(10, digits)
+  return Math.round(value * factor) / factor
+}
+
+function toMillimeter (value: number, unit: PrinterTemplateUnit = 'inch'): number {
+  if (unit === 'mm') return value
+  if (unit === 'cm') return value * 10
+  if (unit === 'px') return value / DESIGN_DPI * 25.4
+  return value * 25.4
+}
+
+function templateWidthPx (template: SystemLabelTemplate): number {
+  return toMillimeter(template.width, template.unit || 'inch') / 25.4 * DESIGN_DPI
+}
+
+function pxToDots (value: number, dpi: number): number {
+  return Math.max(0, Math.round((Number(value) || 0) * dpi / DESIGN_DPI))
+}
+
+function clamp (value: number, min: number, max: number): number {
+  return Math.max(min, Math.min(max, Math.round(value)))
+}
+
+function sortElements (elements: SystemTemplateElementBase[]): SystemTemplateElementBase[] {
+  return [...elements].sort((a, b) => {
+    if (a.y !== b.y) return a.y - b.y
+    return a.x - b.x
+  })
+}
+
+function getConfigString (
+  config: Record<string, any>,
+  keys: string[],
+  fallback = ''
+): string {
+  for (let i = 0; i < keys.length; i++) {
+    const value = config?.[keys[i]]
+    if (value != null && value !== '') return String(value)
+  }
+  return fallback
+}
+
+function getConfigNumber (
+  config: Record<string, any>,
+  keys: string[],
+  fallback = 0
+): number {
+  for (let i = 0; i < keys.length; i++) {
+    const value = Number(config?.[keys[i]])
+    if (!Number.isNaN(value) && Number.isFinite(value)) return value
+  }
+  return fallback
+}
+
+function toCamelCaseKey (value: string): string {
+  return value
+    .toLowerCase()
+    .split(/[_\s-]+/)
+    .map((segment, index) => index === 0
+      ? segment
+      : segment.charAt(0).toUpperCase() + segment.slice(1))
+    .join('')
+}
+
+function resolveBindingKey (element: SystemTemplateElementBase): string {
+  const config = element.config || {}
+  const explicit = getConfigString(config, ['dataKey', 'field', 'bindField', 'key', 'valueKey'])
+  if (explicit) return explicit
+
+  const type = String(element.type || '').toUpperCase()
+  const map: Record<string, string> = {
+    TEXT_PRODUCT: 'productName',
+    TEXT_LABEL_ID: 'labelId',
+    TEXT_CATEGORY: 'category',
+    TEXT_PRICE: 'price',
+    TEXT_DATE: 'date',
+    TEXT_TIME: 'time',
+    QRCODE: 'qrCode',
+    BARCODE: 'barcode',
+  }
+  if (map[type]) return map[type]
+
+  const pureType = type
+    .replace(/^TEXT_/, '')
+    .replace(/^FIELD_/, '')
+    .replace(/^VALUE_/, '')
+  return pureType ? toCamelCaseKey(pureType) : ''
+}
+
+function resolveTemplateFieldValue (data: LabelTemplateData, key: string): string {
+  if (!key) return ''
+  const candidates = [key]
+  if (key === 'productName') candidates.push('product')
+  if (key === 'product') candidates.push('productName')
+  if (key === 'qrCode') candidates.push('labelId', 'barcode')
+  if (key === 'barcode') candidates.push('labelId', 'qrCode')
+
+  for (let i = 0; i < candidates.length; i++) {
+    const value = data[candidates[i]]
+    if (value != null) return String(value)
+  }
+  return ''
+}
+
+function resolveElementText (
+  element: SystemTemplateElementBase,
+  data: LabelTemplateData
+): string {
+  const config = element.config || {}
+  const hasText = config.text != null && config.text !== ''
+  if (hasText && String(element.type || '').toUpperCase() === 'TEXT_STATIC') {
+    return applyTemplateData(String(config.text), data)
+  }
+  if (hasText && String(config.text).includes('{{')) {
+    return applyTemplateData(String(config.text), data)
+  }
+  const bindingKey = resolveBindingKey(element)
+  const boundValue = resolveTemplateFieldValue(data, bindingKey)
+  if (boundValue) return boundValue
+  if (hasText) return applyTemplateData(String(config.text), data)
+  return ''
+}
+
+function resolveElementDataValue (
+  element: SystemTemplateElementBase,
+  data: LabelTemplateData
+): string {
+  const config = element.config || {}
+  const raw = getConfigString(config, ['data', 'value'])
+  if (raw) return applyTemplateData(raw, data)
+  return resolveTemplateFieldValue(data, resolveBindingKey(element))
+}
+
+function resolveElementAlign (
+  element: SystemTemplateElementBase,
+  pageWidthPx: number
+): SystemTemplateTextAlign {
+  const config = element.config || {}
+  const align = String(config.textAlign || '').toLowerCase()
+  if (align === 'left' || align === 'center' || align === 'right') return align as SystemTemplateTextAlign
+  const centerX = (Number(element.x) || 0) + (Number(element.width) || 0) / 2
+  if (centerX <= pageWidthPx * 0.33) return 'left'
+  if (centerX >= pageWidthPx * 0.67) return 'right'
+  return 'center'
+}
+
+function toEscAlign (align: SystemTemplateTextAlign): 0 | 1 | 2 {
+  if (align === 'center') return 1
+  if (align === 'right') return 2
+  return 0
+}
+
+function resolveRotation (value?: string): number {
+  return value === 'vertical' ? 90 : 0
+}
+
+function normalizeQrLevel (value?: string): 'L' | 'M' | 'Q' | 'H' {
+  const key = String(value || 'M').trim().toUpperCase()
+  if (key === 'L' || key === 'M' || key === 'Q' || key === 'H') return key
+  return 'M'
+}
+
+function estimateTextWidthDots (text: string, fontDots: number): number {
+  let total = 0
+  for (let i = 0; i < text.length; i++) {
+    const code = text.charCodeAt(i)
+    total += code > 255 ? fontDots : fontDots * 0.6
+  }
+  return Math.round(total)
+}
+
+function resolveTextScale (fontSizePx: number, dpi: number): number {
+  const targetDots = Math.max(12, Math.round(fontSizePx * dpi / DESIGN_DPI))
+  return clamp(targetDots / 24, 1, 7)
+}
+
+function resolveTextX (params: {
+  align: SystemTemplateTextAlign
+  xPx: number
+  widthPx: number
+  dpi: number
+  text: string
+  scale: number
+}): number {
+  const left = pxToDots(params.xPx, params.dpi)
+  if (params.align === 'left') return left
+
+  const boxWidth = pxToDots(params.widthPx, params.dpi)
+  const fontDots = Math.max(24, params.scale * 24)
+  const textWidth = estimateTextWidthDots(params.text, fontDots)
+  if (params.align === 'center') {
+    return Math.max(0, left + Math.round(Math.max(0, boxWidth - textWidth) / 2))
+  }
+  return Math.max(0, left + Math.max(0, boxWidth - textWidth))
+}
+
+function buildTscTemplate (
+  template: SystemLabelTemplate,
+  data: LabelTemplateData,
+  dpi: number,
+  printQty: number
+): StructuredTscTemplate {
+  const widthMm = roundNumber(toMillimeter(template.width, template.unit || 'inch'))
+  const heightMm = roundNumber(toMillimeter(template.height, template.unit || 'inch'))
+  const items: TscTemplateItem[] = []
+
+  sortElements(template.elements).forEach((element) => {
+    const config = element.config || {}
+    const type = String(element.type || '').toUpperCase()
+
+    if (type.startsWith('TEXT_')) {
+      const text = resolveElementText(element, data)
+      if (!text) return
+      const scale = resolveTextScale(getConfigNumber(config, ['fontSize'], 14), dpi)
+      const align = resolveElementAlign(element, templateWidthPx(template))
+      items.push({
+        type: 'text',
+        x: resolveTextX({
+          align,
+          xPx: element.x,
+          widthPx: element.width,
+          dpi,
+          text,
+          scale,
+        }),
+        y: pxToDots(element.y, dpi),
+        text,
+        font: 'TSS24.BF2',
+        rotation: resolveRotation(element.rotation),
+        xScale: scale,
+        yScale: scale,
+      })
+      return
+    }
+
+    if (type === 'QRCODE') {
+      const value = resolveElementDataValue(element, data)
+      if (!value) return
+      items.push({
+        type: 'qrcode',
+        x: pxToDots(element.x, dpi),
+        y: pxToDots(element.y, dpi),
+        value,
+        level: normalizeQrLevel(getConfigString(config, ['errorLevel'], 'M')),
+        cellWidth: clamp(Math.min(element.width, element.height) / 20, 2, 10),
+        mode: 'A',
+      })
+      return
+    }
+
+    if (type === 'BARCODE') {
+      const value = resolveElementDataValue(element, data)
+      if (!value) return
+      items.push({
+        type: 'barcode',
+        x: pxToDots(element.x, dpi),
+        y: pxToDots(element.y, dpi),
+        value,
+        symbology: getConfigString(config, ['barcodeType'], 'CODE128'),
+        height: Math.max(20, pxToDots(element.height, dpi)),
+        readable: config.showText !== false,
+        rotation: resolveRotation(getConfigString(config, ['orientation'], element.rotation || 'horizontal')),
+        narrow: clamp(element.width / Math.max(40, value.length * 6), 1, 4),
+        wide: clamp(element.width / Math.max(24, value.length * 3), 2, 6),
+      })
+    }
+  })
+
+  return {
+    widthMm,
+    heightMm,
+    gapMm: 0,
+    density: 14,
+    speed: 5,
+    printQty,
+    items,
+  }
+}
+
+function buildEscTemplate (
+  template: SystemLabelTemplate,
+  data: LabelTemplateData,
+  printQty: number
+): StructuredEscTemplate {
+  const pageWidth = templateWidthPx(template)
+  const items: EscTemplateItem[] = []
+
+  sortElements(template.elements).forEach((element) => {
+    const config = element.config || {}
+    const type = String(element.type || '').toUpperCase()
+    const align = toEscAlign(resolveElementAlign(element, pageWidth))
+
+    if (type.startsWith('TEXT_')) {
+      const text = resolveElementText(element, data)
+      if (!text) return
+      const fontSize = getConfigNumber(config, ['fontSize'], 14)
+      const scale = fontSize >= 28 ? 2 : 1
+      items.push({
+        type: 'text',
+        text,
+        align,
+        bold: String(config.fontWeight || '').toLowerCase() === 'bold',
+        widthScale: scale,
+        heightScale: scale,
+      })
+      return
+    }
+
+    if (type === 'QRCODE') {
+      const value = resolveElementDataValue(element, data)
+      if (!value) return
+      items.push({
+        type: 'qrcode',
+        value,
+        align,
+        size: clamp(Math.min(element.width, element.height) / 24, 3, 10),
+        level: normalizeQrLevel(getConfigString(config, ['errorLevel'], 'M')),
+      })
+      return
+    }
+
+    if (type === 'BARCODE') {
+      const value = resolveElementDataValue(element, data)
+      if (!value) return
+      items.push({
+        type: 'barcode',
+        value,
+        align,
+        symbology: getConfigString(config, ['barcodeType'], 'CODE128'),
+        height: clamp(element.height * 2, 48, 180),
+        width: clamp(element.width / Math.max(48, value.length * 4), 2, 6),
+        showText: config.showText !== false,
+      })
+    }
+  })
+
+  return {
+    printQty,
+    feedLines: 3,
+    items,
+  }
+}
+
+export function adaptSystemLabelTemplate (
+  template: SystemLabelTemplate,
+  data: LabelTemplateData = {},
+  options: {
+    dpi?: number
+    printQty?: number
+  } = {}
+): StructuredLabelTemplate {
+  const dpi = options.dpi || 203
+  const printQty = Math.max(1, Math.round(options.printQty || 1))
+  return {
+    key: template.id || template.name || 'system-label-template',
+    tsc: buildTscTemplate(template, data, dpi, printQty),
+    esc: buildEscTemplate(template, data, printQty),
+  }
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/templateRenderer.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/templateRenderer.ts
new file mode 100644
index 0000000..8ed4c20
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/templateRenderer.ts
@@ -0,0 +1,58 @@
+import type {
+  LabelTemplateData,
+  StructuredEscTemplate,
+  StructuredLabelTemplate,
+  StructuredTscTemplate,
+} from './types/printer'
+
+function resolveTemplateValue (key: string, data: LabelTemplateData): string {
+  const value = data[key]
+  if (value == null) return ''
+  return String(value)
+}
+
+export function applyTemplateData (content: string, data: LabelTemplateData = {}): string {
+  return String(content || '').replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (_, key: string) => resolveTemplateValue(key, data))
+}
+
+export function resolveTscTemplate (
+  template: StructuredLabelTemplate,
+  data: LabelTemplateData = {}
+): StructuredTscTemplate {
+  if (!template.tsc) {
+    throw new Error(`Template "${template.key}" does not support TSC printers`)
+  }
+  return {
+    ...template.tsc,
+    items: template.tsc.items.map((item) => {
+      if (item.type === 'text') {
+        return { ...item, text: applyTemplateData(item.text, data) }
+      }
+      if (item.type === 'qrcode' || item.type === 'barcode') {
+        return { ...item, value: applyTemplateData(item.value, data) }
+      }
+      return { ...item }
+    }),
+  }
+}
+
+export function resolveEscTemplate (
+  template: StructuredLabelTemplate,
+  data: LabelTemplateData = {}
+): StructuredEscTemplate {
+  if (!template.esc) {
+    throw new Error(`Template "${template.key}" does not support ESC printers`)
+  }
+  return {
+    ...template.esc,
+    items: template.esc.items.map((item) => {
+      if (item.type === 'text') {
+        return { ...item, text: applyTemplateData(item.text, data) }
+      }
+      if (item.type === 'qrcode' || item.type === 'barcode') {
+        return { ...item, value: applyTemplateData(item.value, data) }
+      }
+      return { ...item }
+    }),
+  }
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/templates/previewSystemTemplate.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/templates/previewSystemTemplate.ts
new file mode 100644
index 0000000..7ab3f5f
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/templates/previewSystemTemplate.ts
@@ -0,0 +1,96 @@
+import type { SystemLabelTemplate } from '../types/printer'
+
+export const PREVIEW_SYSTEM_TEMPLATE: SystemLabelTemplate = {
+  id: 'template-preview-json-print',
+  name: 'Preview JSON Template',
+  labelType: 'PRICE',
+  unit: 'inch',
+  width: 4,
+  height: 2,
+  appliedLocation: 'ALL',
+  showRuler: true,
+  showGrid: true,
+  elements: [
+    {
+      id: 'el-title',
+      type: 'TEXT_STATIC',
+      x: 104,
+      y: 16,
+      width: 160,
+      height: 24,
+      rotation: 'horizontal',
+      border: 'none',
+      config: {
+        text: 'FOOD LABEL',
+        fontFamily: 'Arial',
+        fontSize: 14,
+        fontWeight: 'bold',
+        textAlign: 'center',
+      },
+    },
+    {
+      id: 'el-product-name',
+      type: 'TEXT_PRODUCT',
+      x: 96,
+      y: 128,
+      width: 120,
+      height: 24,
+      rotation: 'horizontal',
+      border: 'none',
+      config: {
+        text: 'Product',
+        fontFamily: 'Arial',
+        fontSize: 14,
+        fontWeight: 'normal',
+        textAlign: 'left',
+      },
+    },
+    {
+      id: 'el-category',
+      type: 'TEXT_STATIC',
+      x: 88,
+      y: 152,
+      width: 140,
+      height: 24,
+      rotation: 'horizontal',
+      border: 'none',
+      config: {
+        text: '{{category}}',
+        fontFamily: 'Arial',
+        fontSize: 14,
+        fontWeight: 'normal',
+        textAlign: 'left',
+      },
+    },
+    {
+      id: 'el-qrcode',
+      type: 'QRCODE',
+      x: 128,
+      y: 40,
+      width: 80,
+      height: 80,
+      rotation: 'horizontal',
+      border: 'none',
+      config: {
+        data: '{{qrCode}}',
+        errorLevel: 'M',
+      },
+    },
+    {
+      id: 'el-barcode',
+      type: 'BARCODE',
+      x: 208,
+      y: 128,
+      width: 160,
+      height: 48,
+      rotation: 'horizontal',
+      border: 'none',
+      config: {
+        barcodeType: 'CODE128',
+        data: '{{barcode}}',
+        showText: true,
+        orientation: 'horizontal',
+      },
+    },
+  ],
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/templates/test.json b/美国版/Food Labeling Management App UniApp/src/utils/print/templates/test.json
new file mode 100644
index 0000000..3692484
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/templates/test.json
@@ -0,0 +1,94 @@
+{
+  "id": "template-1773998862063",
+  "name": "未命名模板",
+  "labelType": "PRICE",
+  "unit": "inch",
+  "width": 4,
+  "height": 2,
+  "appliedLocation": "ALL",
+  "showRuler": true,
+  "showGrid": true,
+  "elements": [
+    {
+      "id": "el-1773998886036-34sylni",
+      "type": "TEXT_STATIC",
+      "x": 104,
+      "y": 16,
+      "width": 120,
+      "height": 24,
+      "rotation": "horizontal",
+      "border": "none",
+      "config": {
+        "text": "文本",
+        "fontFamily": "Arial",
+        "fontSize": 14,
+        "fontWeight": "normal",
+        "textAlign": "center"
+      }
+    },
+    {
+      "id": "el-1773998909568-4jjwdx7",
+      "type": "TEXT_PRODUCT",
+      "x": 96,
+      "y": 128,
+      "width": 120,
+      "height": 24,
+      "rotation": "horizontal",
+      "border": "none",
+      "config": {
+        "text": "商品名",
+        "fontFamily": "Arial",
+        "fontSize": 14,
+        "fontWeight": "normal",
+        "textAlign": "left"
+      }
+    },
+    {
+      "id": "el-1773998913096-cgabpx1",
+      "type": "TEXT_STATIC",
+      "x": 88,
+      "y": 152,
+      "width": 120,
+      "height": 24,
+      "rotation": "horizontal",
+      "border": "none",
+      "config": {
+        "text": "文本",
+        "fontFamily": "Arial",
+        "fontSize": 14,
+        "fontWeight": "normal",
+        "textAlign": "left"
+      }
+    },
+    {
+      "id": "el-1773999052674-uzocw1j",
+      "type": "QRCODE",
+      "x": 128,
+      "y": 40,
+      "width": 80,
+      "height": 80,
+      "rotation": "horizontal",
+      "border": "none",
+      "config": {
+        "data": "12341千问请问抛弃我",
+        "errorLevel": "M"
+      }
+    },
+    {
+      "id": "el-1773999078958-5tgoru7",
+      "type": "BARCODE",
+      "x": 208,
+      "y": 128,
+      "width": 160,
+      "height": 48,
+      "rotation": "horizontal",
+      "border": "none",
+      "config": {
+        "barcodeType": "CODE128",
+        "data": "14124151231",
+        "showText": true,
+        "orientation": "horizontal"
+      }
+    }
+  ]
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/templates/testPrintTemplate.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/templates/testPrintTemplate.ts
new file mode 100644
index 0000000..154fc1d
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/templates/testPrintTemplate.ts
@@ -0,0 +1,21 @@
+import testTemplateJson from './test.json'
+import { adaptSystemLabelTemplate } from '../systemTemplateAdapter'
+import type { LabelTemplateData, StructuredLabelTemplate, SystemLabelTemplate } from '../types/printer'
+
+export const TEST_PRINT_SYSTEM_TEMPLATE = testTemplateJson as SystemLabelTemplate
+
+export const TEST_PRINT_TEMPLATE_DATA: LabelTemplateData = {
+  productName: '商品名',
+  product: '商品名',
+}
+
+export function createTestPrintTemplate (
+  dpi = 203,
+  printQty = 1,
+  data: LabelTemplateData = TEST_PRINT_TEMPLATE_DATA
+): StructuredLabelTemplate {
+  return adaptSystemLabelTemplate(TEST_PRINT_SYSTEM_TEMPLATE, data, {
+    dpi,
+    printQty,
+  })
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/testPrintCanvas.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/testPrintCanvas.ts
new file mode 100644
index 0000000..ed951af
--- /dev/null
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/testPrintCanvas.ts
@@ -0,0 +1,118 @@
+import type { RawImageDataSource } from './types/printer'
+
+export function getTestPrintCanvasSize (maxWidthDots = 384): { width: number, height: number } {
+  const width = Math.max(256, Math.round(maxWidthDots || 384) - (Math.round(maxWidthDots || 384) % 8))
+  const height = Math.max(220, Math.round(width * 0.62))
+  return { width, height }
+}
+
+function drawRoundedRect (
+  ctx: UniNamespace.CanvasContext,
+  x: number,
+  y: number,
+  width: number,
+  height: number,
+  radius: number
+) {
+  const r = Math.max(0, Math.min(radius, Math.min(width, height) / 2))
+  ctx.beginPath()
+  ctx.moveTo(x + r, y)
+  ctx.lineTo(x + width - r, y)
+  ctx.arcTo(x + width, y, x + width, y + r, r)
+  ctx.lineTo(x + width, y + height - r)
+  ctx.arcTo(x + width, y + height, x + width - r, y + height, r)
+  ctx.lineTo(x + r, y + height)
+  ctx.arcTo(x, y + height, x, y + height - r, r)
+  ctx.lineTo(x, y + r)
+  ctx.arcTo(x, y, x + r, y, r)
+  ctx.closePath()
+}
+
+export async function renderTestPrintCanvasImageData (
+  canvasId: string,
+  componentInstance: any,
+  size: { width: number, height: number }
+): Promise<RawImageDataSource> {
+  const width = Math.max(8, size.width - (size.width % 8))
+  const height = Math.max(1, size.height)
+  const scale = width / 800
+  const ctx = uni.createCanvasContext(canvasId, componentInstance)
+
+  ctx.setFillStyle('#ffffff')
+  ctx.fillRect(0, 0, width, height)
+
+  drawRoundedRect(ctx, 10 * scale, 10 * scale, width - 20 * scale, height - 20 * scale, 18 * scale)
+  ctx.setLineWidth(Math.max(2, 3 * scale))
+  ctx.setStrokeStyle('#111111')
+  ctx.stroke()
+
+  ctx.setFillStyle('#111111')
+  ctx.setFontSize(Math.max(22, Math.round(width * 0.045)))
+  ctx.fillText('IN USE FOOD LABEL', 26 * scale, 44 * scale)
+
+  ctx.setLineWidth(Math.max(1, 2 * scale))
+  ctx.beginPath()
+  ctx.moveTo(24 * scale, 62 * scale)
+  ctx.lineTo(width - 24 * scale, 62 * scale)
+  ctx.stroke()
+
+  ctx.setFontSize(Math.max(18, Math.round(width * 0.036)))
+  ctx.fillText('Product', 26 * scale, 96 * scale)
+  ctx.setFontSize(Math.max(20, Math.round(width * 0.04)))
+  ctx.fillText('Grilled Chicken Breast', 26 * scale, 128 * scale)
+
+  ctx.setFontSize(Math.max(17, Math.round(width * 0.034)))
+  ctx.fillText('Prepared Protein / Hot Prep', 26 * scale, 162 * scale)
+  ctx.fillText('Prepared: 03/20/2026 10:30 AM', 26 * scale, 220 * scale)
+  ctx.fillText('Use By : 03/23/2026 10:30 AM', 26 * scale, 268 * scale)
+  ctx.fillText('Shelf Life: 72 Hours', 26 * scale, 316 * scale)
+
+  const rightX = 540 * scale
+  ctx.setFontSize(Math.max(18, Math.round(width * 0.035)))
+  ctx.fillText('Label ID', rightX, 96 * scale)
+  ctx.setFontSize(Math.max(16, Math.round(width * 0.03)))
+  ctx.fillText('TEST-260320-001', rightX, 128 * scale)
+  ctx.fillText('Status: ACTIVE', rightX, 238 * scale)
+  ctx.fillText('Station: LINE 1', rightX, 286 * scale)
+  ctx.fillText('User: TEST USER', rightX, 334 * scale)
+
+  const qrX = rightX
+  const qrY = 148 * scale
+  const qrSize = Math.round(120 * scale)
+  ctx.setLineWidth(Math.max(2, 3 * scale))
+  ctx.strokeRect(qrX, qrY, qrSize, qrSize)
+  ctx.strokeRect(qrX + 10 * scale, qrY + 10 * scale, 20 * scale, 20 * scale)
+  ctx.strokeRect(qrX + qrSize - 30 * scale, qrY + 10 * scale, 20 * scale, 20 * scale)
+  ctx.strokeRect(qrX + 10 * scale, qrY + qrSize - 30 * scale, 20 * scale, 20 * scale)
+  ctx.fillRect(qrX + 42 * scale, qrY + 18 * scale, 12 * scale, 12 * scale)
+  ctx.fillRect(qrX + 58 * scale, qrY + 34 * scale, 8 * scale, 8 * scale)
+  ctx.fillRect(qrX + 46 * scale, qrY + 54 * scale, 10 * scale, 10 * scale)
+  ctx.fillRect(qrX + 68 * scale, qrY + 68 * scale, 12 * scale, 12 * scale)
+  ctx.fillRect(qrX + 50 * scale, qrY + 84 * scale, 8 * scale, 8 * scale)
+
+  await new Promise<void>((resolve) => {
+    ctx.draw(false, () => resolve())
+  })
+
+  await new Promise<void>((resolve) => setTimeout(resolve, 30))
+
+  return new Promise((resolve, reject) => {
+    uni.canvasGetImageData({
+      canvasId,
+      x: 0,
+      y: 0,
+      width,
+      height,
+      success: (res: any) => {
+        resolve({
+          width,
+          height,
+          data: res.data,
+        })
+      },
+      fail: (err: any) => {
+        reject(new Error(err?.errMsg || 'CANVAS_GET_IMAGE_DATA_FAILED'))
+      },
+    }, componentInstance)
+  })
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/tscLabelBuilder.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/tscLabelBuilder.ts
index 2efc7d1..de821f1 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/tscLabelBuilder.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/tscLabelBuilder.ts
@@ -3,6 +3,7 @@
  * 使用 UTF-8 编码。对于纯英文/ASCII 内容，UTF-8 与 GB18030 字节一致，佳博打印机可正常打印。
  * 若需中文等非 ASCII，可考虑运行时动态加载 tsc.js（仅 APP 端）。
  */
+import type { MonochromeImageData, PrintImageOptions, StructuredTscTemplate } from './types/printer'
 
 /** 将字符串转为 UTF-8 字节数组（不依赖 TextEncoder） */
 function stringToUtf8Bytes (str: string): number[] {
@@ -35,10 +36,30 @@ function addCommandBytes (out: number[], str: string) {
   for (let i = 0; i < bytes.length; i++) out.push(bytes[i])
 }
 
+function addTscLine (out: number[], str: string) {
+  addCommandBytes(out, str + '\r\n')
+}
+
 function escapeTscString (s: string): string {
   return String(s).replace(/\\/g, '\\\\').replace(/"/g, '\\"')
 }
 
+function normalizeTscBarcodeType (value?: string): string {
+  const key = String(value || 'CODE128').trim().toUpperCase()
+  const map: Record<string, string> = {
+    CODE128: '128',
+    CODE39: '39',
+    EAN13: 'EAN13',
+    EAN8: 'EAN8',
+    UPCA: 'UPCA',
+    UPCE: 'UPCE',
+    CODABAR: 'CODA',
+    ITF14: 'ITF14',
+    ITF: 'ITF',
+  }
+  return map[key] || '128'
+}
+
 /**
  * 构建标签打印指令字节数组（TSC）
  * 与官方 Demo createLabel 格式一致（SIZE 100x30, GAP 0）
@@ -93,38 +114,124 @@ export function buildTscLabel (options: {
  */
 export function buildTestTscLabel (): number[] {
   const out: number[] = []
-  const add = (s: string) => addCommandBytes(out, s + '\r\n')
-  let y = 10
+  const add = (s: string) => addTscLine(out, s)
 
-  add('SIZE 100 mm,70 mm')
+  add('SIZE 100 mm,65 mm')
   add('GAP 0 mm,0 mm')
   add('CLS')
+  add('BOX 20,20,780,500,3')
+  add('BAR 20,90,760,3')
+  add('BAR 20,215,760,2')
+  add('BAR 20,335,760,2')
+  add('BAR 520,90,2,410')
+
+  add('TEXT 180,42,"TSS24.BF2",0,1,1,"IN USE FOOD LABEL"')
+
+  add('TEXT 45,115,"TSS24.BF2",0,1,1,"Product"')
+  add('TEXT 45,150,"TSS24.BF2",0,1,1,"Grilled Chicken Breast"')
+  add('TEXT 45,182,"TSS24.BF2",0,1,1,"Prepared Protein / Hot Prep"')
+
+  add('TEXT 45,240,"TSS24.BF2",0,1,1,"Prepared"')
+  add('TEXT 45,275,"TSS24.BF2",0,1,1,"03/20/2026 10:30 AM"')
+  add('TEXT 45,360,"TSS24.BF2",0,1,1,"Use By"')
+  add('TEXT 45,395,"TSS24.BF2",0,1,1,"03/23/2026 10:30 AM"')
+  add('TEXT 45,430,"TSS24.BF2",0,1,1,"Shelf Life 72 Hours"')
+
+  add('TEXT 545,118,"TSS24.BF2",0,1,1,"Label ID"')
+  add('TEXT 545,152,"TSS24.BF2",0,1,1,"TEST-260320-001"')
+  add('TEXT 545,330,"TSS24.BF2",0,1,1,"Status: ACTIVE"')
+  add('TEXT 545,365,"TSS24.BF2",0,1,1,"Station: LINE 1"')
+  add('TEXT 545,400,"TSS24.BF2",0,1,1,"User: TEST USER"')
+  add('QRCODE 555,190,L,4,A,0,"TEST-260320-001"')
 
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"NUTRITION FACTS"`)
-  y += 28
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Grilled Chicken Breast"`)
-  y += 28
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Serving Size 1 piece (100g)"`)
-  y += 32
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Calories 165"`)
-  y += 28
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Total Fat 4g"`)
-  y += 24
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Saturated Fat 1g"`)
-  y += 24
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Cholesterol 85mg"`)
-  y += 24
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Sodium 75mg"`)
-  y += 24
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Total Carb 0g"`)
-  y += 24
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Protein 31g"`)
-  y += 28
-  add(`TEXT 50,${y},"TSS24.BF2",0,1,1,"Exp: 01/17/25  ID: TEST-251227"`)
-  y += 35
-  add(`QRCODE 50,${y},L,4,A,0,"TEST-251227-001"`)
   add('PRINT 1,1')
   add('FEED 1')
 
   return out
 }
+
+export function buildTscTemplateLabel (template: StructuredTscTemplate): number[] {
+  const out: number[] = []
+  const add = (s: string) => addTscLine(out, s)
+
+  add(`SIZE ${template.widthMm} mm,${template.heightMm} mm`)
+  add(`GAP ${template.gapMm || 0} mm,0 mm`)
+  if (template.density != null) add(`DENSITY ${template.density}`)
+  if (template.speed != null) add(`SPEED ${template.speed}`)
+  add('CLS')
+
+  template.items.forEach((item) => {
+    if (item.type === 'box') {
+      const right = item.x + item.width
+      const bottom = item.y + item.height
+      add(`BOX ${item.x},${item.y},${right},${bottom},${item.lineWidth || 1}`)
+      return
+    }
+    if (item.type === 'bar') {
+      add(`BAR ${item.x},${item.y},${item.width},${item.height}`)
+      return
+    }
+    if (item.type === 'qrcode') {
+      add(`QRCODE ${item.x},${item.y},${item.level || 'L'},${item.cellWidth || 4},${item.mode || 'A'},0,"${escapeTscString(item.value)}"`)
+      return
+    }
+    if (item.type === 'barcode') {
+      add(`BARCODE ${item.x},${item.y},"${normalizeTscBarcodeType(item.symbology)}",${Math.max(20, Math.round(item.height || 80))},${item.readable === false ? 0 : 1},${item.rotation || 0},${Math.max(1, Math.round(item.narrow || 2))},${Math.max(2, Math.round(item.wide || 2))},"${escapeTscString(item.value)}"`)
+      return
+    }
+    add(`TEXT ${item.x},${item.y},"${item.font || 'TSS24.BF2'}",${item.rotation || 0},${item.xScale || 1},${item.yScale || 1},"${escapeTscString(item.text)}"`)
+  })
+
+  add(`PRINT 1,${Math.max(1, Math.round(template.printQty || 1))}`)
+  return out
+}
+
+function roundMm (value: number): string {
+  return (Math.round(value * 10) / 10).toFixed(1)
+}
+
+function pixelsToTscBitmapBytes (image: MonochromeImageData): number[] {
+  const bytes: number[] = []
+  const bytesPerRow = image.width / 8
+  for (let y = 0; y < image.height; y++) {
+    for (let byteIndex = 0; byteIndex < bytesPerRow; byteIndex++) {
+      let value = 0
+      for (let bit = 0; bit < 8; bit++) {
+        const x = byteIndex * 8 + bit
+        const pixel = image.pixels[y * image.width + x]
+        const isWhite = pixel ? 0 : 1
+        value |= isWhite << (7 - bit)
+      }
+      bytes.push(value & 0xff)
+    }
+  }
+  return bytes
+}
+
+export function buildTscImageLabel (
+  image: MonochromeImageData,
+  options: PrintImageOptions = {},
+  dpi = 203
+): number[] {
+  const out: number[] = []
+  const add = (s: string) => addCommandBytes(out, s + '\r\n')
+  const widthMm = options.widthMm || (image.width * 25.4 / dpi)
+  const heightMm = options.heightMm || (image.height * 25.4 / dpi)
+  const x = Math.max(0, Math.round(options.x || 0))
+  const y = Math.max(0, Math.round(options.y || 0))
+  const printQty = Math.max(1, Math.round(options.printQty || 1))
+  const bytesPerRow = image.width / 8
+  const bitmapBytes = pixelsToTscBitmapBytes(image)
+
+  add(`SIZE ${roundMm(widthMm)} mm,${roundMm(heightMm)} mm`)
+  add('GAP 0 mm,0 mm')
+  add('DENSITY 14')
+  add('SPEED 5')
+  add('CLS')
+  add(`BITMAP ${x},${y},${bytesPerRow},${image.height},0,`)
+  for (let i = 0; i < bitmapBytes.length; i++) out.push(bitmapBytes[i])
+  out.push(0x0d, 0x0a)
+  add(`PRINT 1,${printQty}`)
+
+  return out
+}
diff --git a/美国版/Food Labeling Management App UniApp/src/utils/print/types/printer.ts b/美国版/Food Labeling Management App UniApp/src/utils/print/types/printer.ts
index 34d7e9b..caf2632 100644
--- a/美国版/Food Labeling Management App UniApp/src/utils/print/types/printer.ts
+++ b/美国版/Food Labeling Management App UniApp/src/utils/print/types/printer.ts
@@ -20,6 +20,179 @@ export interface LabelPrintPayload {
   extraLine?: string
 }
 
+export interface PrintImageOptions {
+  printQty?: number
+  threshold?: number
+  maxWidthDots?: number
+  targetWidthDots?: number
+  targetHeightDots?: number
+  widthMm?: number
+  heightMm?: number
+  x?: number
+  y?: number
+}
+
+export interface MonochromeImageData {
+  width: number
+  height: number
+  pixels: number[] // 1 = black, 0 = white
+}
+
+export interface RawImageDataSource {
+  width: number
+  height: number
+  data: ArrayLike<number>
+}
+
+export type LabelTemplateValue = string | number
+export type LabelTemplateData = Record<string, LabelTemplateValue>
+export type PrinterTemplateUnit = 'inch' | 'mm' | 'cm' | 'px'
+export type SystemTemplateRotation = 'horizontal' | 'vertical'
+export type SystemTemplateTextAlign = 'left' | 'center' | 'right'
+
+export interface SystemTemplateElementBase {
+  id: string
+  type: string
+  x: number
+  y: number
+  width: number
+  height: number
+  rotation?: SystemTemplateRotation
+  border?: string
+  config: Record<string, any>
+}
+
+export interface SystemLabelTemplate {
+  id: string
+  name: string
+  labelType?: string
+  unit?: PrinterTemplateUnit
+  width: number
+  height: number
+  appliedLocation?: string
+  showRuler?: boolean
+  showGrid?: boolean
+  elements: SystemTemplateElementBase[]
+}
+
+export interface TscTemplateTextItem {
+  type: 'text'
+  x: number
+  y: number
+  text: string
+  font?: string
+  rotation?: number
+  xScale?: number
+  yScale?: number
+}
+
+export interface TscTemplateBoxItem {
+  type: 'box'
+  x: number
+  y: number
+  width: number
+  height: number
+  lineWidth?: number
+}
+
+export interface TscTemplateBarItem {
+  type: 'bar'
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
+export interface TscTemplateQrCodeItem {
+  type: 'qrcode'
+  x: number
+  y: number
+  value: string
+  level?: 'L' | 'M' | 'Q' | 'H'
+  cellWidth?: number
+  mode?: 'A' | 'M'
+}
+
+export interface TscTemplateBarcodeItem {
+  type: 'barcode'
+  x: number
+  y: number
+  value: string
+  symbology?: string
+  height?: number
+  readable?: boolean
+  rotation?: number
+  narrow?: number
+  wide?: number
+}
+
+export type TscTemplateItem =
+  | TscTemplateTextItem
+  | TscTemplateBoxItem
+  | TscTemplateBarItem
+  | TscTemplateQrCodeItem
+  | TscTemplateBarcodeItem
+
+export interface StructuredTscTemplate {
+  widthMm: number
+  heightMm: number
+  gapMm?: number
+  density?: number
+  speed?: number
+  printQty?: number
+  items: TscTemplateItem[]
+}
+
+export interface EscTemplateTextItem {
+  type: 'text'
+  text: string
+  align?: 0 | 1 | 2
+  bold?: boolean
+  widthScale?: number
+  heightScale?: number
+}
+
+export interface EscTemplateRuleItem {
+  type: 'rule'
+  width?: number
+}
+
+export interface EscTemplateQrCodeItem {
+  type: 'qrcode'
+  value: string
+  align?: 0 | 1 | 2
+  size?: number
+  level?: 'L' | 'M' | 'Q' | 'H'
+}
+
+export interface EscTemplateBarcodeItem {
+  type: 'barcode'
+  value: string
+  align?: 0 | 1 | 2
+  symbology?: string
+  height?: number
+  width?: number
+  showText?: boolean
+}
+
+export type EscTemplateItem =
+  | EscTemplateTextItem
+  | EscTemplateRuleItem
+  | EscTemplateQrCodeItem
+  | EscTemplateBarcodeItem
+
+export interface StructuredEscTemplate {
+  printQty?: number
+  feedLines?: number
+  items: EscTemplateItem[]
+}
+
+export interface StructuredLabelTemplate {
+  key: string
+  tsc?: StructuredTscTemplate
+  esc?: StructuredEscTemplate
+}
+
 export interface PrinterDriver {
   key: string
   brand: string
@@ -28,6 +201,8 @@ export interface PrinterDriver {
   protocol: PrinterProtocol
   preferredConnection?: ActiveBtDeviceType
   preferredBleMtu?: number
+  imageMaxWidthDots?: number
+  imageDpi?: number
   keywords: string[]
   matches: (device: PrinterCandidate) => number
   resolveConnectionType: (device: PrinterCandidate) => ActiveBtDeviceType
--
libgit2 0.21.4