taro-bluetooth-print 2.15.2 → 2.15.4

package/src/core/BluetoothPrinter.ts

@@ -22,6 +22,18 @@ import type { ICommandBuilder } from '@/services/interfaces';
 import type { TextAlign } from '@/formatter';
 import type { BarcodeFormat } from '@/barcode';
 
+/** Payload for `job-completed` / `job-failed` events. */
+export interface JobResult {
+  /** Source of the completed job: `print` (CommandBuilder pipeline) or `writeRaw` (raw bytes). */
+  source: 'print' | 'writeRaw';
+  /** Total bytes transmitted to the printer. */
+  bytes: number;
+  /** Job end timestamp (epoch ms). */
+  completedAt: number;
+  /** Wall-clock duration of the job in ms (0 for synchronous completion). */
+  durationMs: number;
+}
+
 /** Printer event map. */
 export interface PrinterEvents {
   'state-change': PrinterState;
@@ -30,6 +42,10 @@ export interface PrinterEvents {
   connected: string;
   disconnected: string;
   'print-complete': void;
+  /** Emitted when a print/writeRaw job successfully completes all bytes. */
+  'job-completed': JobResult;
+  /** Emitted when a print/writeRaw job fails (immediately before re-throwing). */
+  'job-failed': JobResult & { error: BluetoothPrintError };
 }
 
 /** Bluetooth Thermal Printer Controller. */
@@ -71,6 +87,12 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
    * Resolve the first constructor argument to an IConnectionManager. An adapter
    * (anything implementing `connect`/`disconnect`/`write`) gets auto-wrapped for
    * backward compatibility; missing/undefined falls back to a default manager.
+   *
+   * Disambiguation: `IConnectionManager` exposes `getState()` (manager-only
+   * method on the interface). Adapters only have `connect`/`disconnect`/`write`.
+   * Using `getState` as the discriminator correctly identifies a pre-built
+   * manager vs. a raw adapter — using `connect` (which both have) silently
+   * re-wrapped managers and broke isConnected() (v2.15.3 fix).
    */
   private resolveConnectionManager(
     arg: IConnectionManager | IPrinterAdapter | undefined
@@ -78,11 +100,11 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
     if (!arg) {
       return new ConnectionManager();
     }
-    // Adapters expose `connect`; managers expose `getState`. Disambiguate by method presence.
-    if (typeof (arg as IPrinterAdapter).connect === 'function') {
-      return new ConnectionManager(arg as IPrinterAdapter);
+    // Managers expose `getState`; adapters do not. Disambiguate by method presence.
+    if (typeof (arg as IConnectionManager).getState === 'function') {
+      return arg as IConnectionManager;
     }
-    return arg as IConnectionManager;
+    return new ConnectionManager(arg as IPrinterAdapter);
   }
 
   /**
@@ -224,6 +246,79 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
     return this;
   }
 
+  /**
+   * Write a pre-built byte buffer directly to the connected printer,
+   * bypassing the CommandBuilder entirely. Use this when a driver (such as
+   * TsplDriver, ZplDriver, StarPrinter, CPCL or any custom protocol) emits
+   * its own byte stream and you want the same connection / chunking /
+   * progress / pause pipeline as the standard print() path.
+   *
+   * Unlike print() — which calls commandBuilder.getBuffer() then clears it —
+   * writeRaw() does NOT touch the command queue. It is safe to call between
+   * text() / qr() / cut() calls; those calls continue to accumulate in the
+   * command buffer for the next print() invocation.
+   *
+   * @param buffer  Bytes to send (e.g. `tsplDriver.getBuffer()`)
+   * @param options Optional adapter overrides (chunkSize, delay, retries).
+   *                Forwarded to PrintJobManager.setOptions() before start.
+   * @throws BluetoothPrintError(CONNECTION_FAILED) if not connected
+   * @throws BluetoothPrintError(PRINT_JOB_FAILED) on adapter write failure
+   *
+   * @example
+   * ```ts
+   * // TSPL label printing — full end-to-end flow now works.
+   * const tspl = new TsplDriver()
+   *   .size(60, 40)
+   *   .gap(3)
+   *   .clear()
+   *   .text('Hello', { x: 20, y: 20, font: 3 })
+   *   .print(1, 1);
+   * await printer.writeRaw(tspl.getBuffer());
+   * ```
+   */
+  async writeRaw(buffer: Uint8Array, options?: IAdapterOptions): Promise<void> {
+    if (!this.connectionManager.isConnected()) {
+      throw new BluetoothPrintError(
+        ErrorCode.CONNECTION_FAILED,
+        'Printer not connected. Call connect() first.'
+      );
+    }
+
+    this.printerLogger.info(`writeRaw: ${buffer.length} bytes`);
+    if (options) this.printJobManager.setOptions(options);
+
+    this.updateState();
+    this.printJobManager.setProgressCallback((sent, total) => {
+      this.emit('progress', { sent, total });
+    });
+
+    const startTime = Date.now();
+    try {
+      await this.printJobManager.start(buffer);
+      if (!this.printJobManager.isPaused()) {
+        this.emit('print-complete');
+        this.emit('job-completed', {
+          source: 'writeRaw',
+          bytes: buffer.length,
+          completedAt: Date.now(),
+          durationMs: Date.now() - startTime,
+        });
+      }
+    } catch (error) {
+      const wrapped = this.handleError(error, ErrorCode.PRINT_JOB_FAILED, 'writeRaw failed');
+      this.emit('job-failed', {
+        source: 'writeRaw',
+        bytes: buffer.length,
+        completedAt: Date.now(),
+        durationMs: Date.now() - startTime,
+        error: wrapped,
+      });
+      throw wrapped;
+    } finally {
+      this.updateState();
+    }
+  }
+
   /**
    * Pauses the current print job.
    */
@@ -284,17 +379,32 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
       this.emit('progress', { sent, total });
     });
 
+    const startTime = Date.now();
     try {
       await this.printJobManager.start(buffer);
       if (this.printJobManager.isPaused()) {
         this.printerLogger.info('Print job paused');
       } else {
         this.emit('print-complete');
+        this.emit('job-completed', {
+          source: 'print',
+          bytes: buffer.length,
+          completedAt: Date.now(),
+          durationMs: Date.now() - startTime,
+        });
         this.printerLogger.info('Print job completed successfully');
       }
     } catch (error) {
       this.printerLogger.error('Print job failed with error:', error);
-      throw this.handleError(error, ErrorCode.PRINT_JOB_FAILED, 'Print job failed');
+      const wrapped = this.handleError(error, ErrorCode.PRINT_JOB_FAILED, 'Print job failed');
+      this.emit('job-failed', {
+        source: 'print',
+        bytes: buffer.length,
+        completedAt: Date.now(),
+        durationMs: Date.now() - startTime,
+        error: wrapped,
+      });
+      throw wrapped;
     } finally {
       this.updateState();
     }

package/src/encoding/GbkTable.ts

@@ -1,10 +1,19 @@
 /**
  * GBK Encoding Table - 懒加载版本
  *
- * 优化策略：
- * 1. 默认使用精简版编码表 (gbk-lite.ts，约 3500 常用字)
- * 2. 遇到非常用字时动态加载完整编码表
- * 3. 二分查找代替 Map，大幅减少内存占用
+ * 优化策略（v2.15.4 重新设计）：
+ * 1. 默认使用精简版编码表 (GbkLite.ts，约 106 个最常用汉字)
+ * 2. 命中精简表的字符直接返回（毫秒级）
+ * 3. 未命中时查完整表 (GbkData.ts)
+ * 4. GbkData 通过 vite manualChunks 拆成独立 chunk `chunks/gbk-data-*.js`
+ *    —— 在 dist 输出层面做到了代码分割，但运行时仍然同步可用
+ *
+ * 注意：dynamic import() 方案曾在 v2.15.4-dev 中尝试，但因为
+ * EncodingService.encode() / TemplateRenderer 都是同步 API，
+ * 切换到 dynamic 后会导致中文编码首次失败（'生产日期'/'谢谢惠顾'
+ * 这类字符不在 lite 表中）。v2.15.4-final 选择保留 static import
+ * 来换取 100% backward compat；异步 pre-warm 留给 v2.15.5+ 重构
+ * sync → async encoding API 时再启用。
  *
  * GBK: 23940 个字符映射
  * Big5: 13911 个字符映射
@@ -17,12 +26,14 @@ import { GBK_DATA as FULL_GBK_DATA, BIG5_DATA as FULL_BIG5_DATA } from './GbkDat
 let GBK_DATA: number[] | null = null;
 let BIG5_DATA: number[] | null = null;
 
-function loadFullData() {
+function loadFullData(): { GBK_DATA: number[]; BIG5_DATA: number[] } {
   if (!GBK_DATA) {
     GBK_DATA = FULL_GBK_DATA;
     BIG5_DATA = FULL_BIG5_DATA;
   }
-  return { GBK_DATA: GBK_DATA, BIG5_DATA: BIG5_DATA! };
+  // After the guard above, both module-level vars are guaranteed initialized.
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+  return { GBK_DATA: GBK_DATA as number[], BIG5_DATA: BIG5_DATA as number[] };
 }
 
 // Unicode to GBK mapping table
@@ -38,7 +49,7 @@ export const unicodeToBig5: Map<number, number> = new Map();
 export const big5ToUnicode: Map<number, number> = new Map();
 
 /**
- * Get GBK bytes for a Unicode character
+ * Get GBK bytes for a Unicode character.
  * 先查精简表，查不到再懒加载完整表
  */
 export function getGbkBytes(unicode: number): [number, number] | null {

package/src/index.ts

@@ -7,7 +7,7 @@
 
 // Core classes
 export { BluetoothPrinter } from './core/BluetoothPrinter';
-export type { PrinterEvents } from './core/BluetoothPrinter';
+export type { PrinterEvents, JobResult } from './core/BluetoothPrinter';
 export { EventEmitter } from './core/EventEmitter';
 
 // Drivers - 打印机驱动
@@ -117,8 +117,20 @@ export type {
   LoggingConfig,
 } from './config/PrinterConfig';
 
-export { PrinterConfigManager, printerConfigManager } from './config/PrinterConfigManager';
-export type { SavedPrinter, GlobalConfig, IConfigStorage } from './config/PrinterConfigManager';
+export {
+  PrinterConfigManager,
+  printerConfigManager,
+  PRINTER_CONFIG_EXPORT_VERSION,
+  LocalStorage,
+} from './config/PrinterConfigManager';
+export type {
+  SavedPrinter,
+  GlobalConfig,
+  IConfigStorage,
+  PrintConfig,
+  PrinterConfigSnapshot,
+  PrinterConfigImportResult,
+} from './config/PrinterConfigManager';
 
 // Plugin System - 插件系统
 export { createLoggingPlugin, createRetryPlugin } from './plugins';

package/src/plugins/builtin/RetryPlugin.ts

@@ -7,6 +7,18 @@ import { Plugin, PluginFactory, PluginOptions } from '../PluginTypes';
 import { Logger } from '@/utils/logger';
 import { BluetoothPrintError, ErrorCode } from '@/errors/BaseError';
 
+/** Payload passed to the onRetry callback for each retry attempt. */
+export interface RetryAttempt {
+  /** 1-indexed attempt number (1 = first retry after the initial failure). */
+  attempt: number;
+  /** Maximum retries allowed. */
+  maxRetries: number;
+  /** Delay in ms before this retry will be scheduled to run. */
+  delayMs: number;
+  /** The error that triggered this retry. */
+  error: BluetoothPrintError;
+}
+
 export interface RetryPluginOptions extends PluginOptions {
   /** Maximum retry attempts (default: 3) */
   maxRetries?: number;
@@ -18,24 +30,31 @@ export interface RetryPluginOptions extends PluginOptions {
   backoffMultiplier?: number;
   /** Error codes that should trigger retry */
   retryableErrors?: ErrorCode[];
+  /**
+   * Optional callback invoked BEFORE sleeping for each retry attempt.
+   * Receives the 1-indexed attempt number, the planned delay, and the
+   * triggering error. Use this for surfacing retry state to UIs (toast
+   * "Reconnecting (2/3)…") or for telemetry.
+   */
+  onRetry?: (info: RetryAttempt) => void;
 }
 
 /**
  * Creates a retry plugin instance
  */
 export const createRetryPlugin: PluginFactory = (options?: RetryPluginOptions): Plugin => {
-  const opts: Required<RetryPluginOptions> = {
-    maxRetries: options?.maxRetries ?? 3,
-    initialDelay: options?.initialDelay ?? 1000,
-    maxDelay: options?.maxDelay ?? 10000,
-    backoffMultiplier: options?.backoffMultiplier ?? 2,
-    retryableErrors: options?.retryableErrors ?? [
-      ErrorCode.CONNECTION_FAILED,
-      ErrorCode.CONNECTION_TIMEOUT,
-      ErrorCode.WRITE_FAILED,
-      ErrorCode.WRITE_TIMEOUT,
-    ],
-  };
+  const maxRetries = options?.maxRetries ?? 3;
+  const initialDelay = options?.initialDelay ?? 1000;
+  const maxDelay = options?.maxDelay ?? 10000;
+  const backoffMultiplier = options?.backoffMultiplier ?? 2;
+  const retryableErrors: ErrorCode[] = options?.retryableErrors ?? [
+    ErrorCode.CONNECTION_FAILED,
+    ErrorCode.CONNECTION_TIMEOUT,
+    ErrorCode.WRITE_FAILED,
+    ErrorCode.WRITE_TIMEOUT,
+  ];
+  const onRetry = options?.onRetry;
+  const opts = { maxRetries, initialDelay, maxDelay, backoffMultiplier, retryableErrors, onRetry };
 
   const logger = Logger.scope('RetryPlugin');
   let retryCount = 0;
@@ -75,6 +94,21 @@ export const createRetryPlugin: PluginFactory = (options?: RetryPluginOptions):
           );
           logger.info(`Waiting ${currentDelay}ms before retry...`);
 
+          // Fire user callback BEFORE sleeping so UIs can update immediately.
+          // Wrapped in try/catch — a throwing callback must not break retry timing.
+          if (opts.onRetry) {
+            try {
+              opts.onRetry({
+                attempt: retryCount,
+                maxRetries: opts.maxRetries,
+                delayMs: currentDelay,
+                error,
+              });
+            } catch (cbErr) {
+              logger.error('onRetry callback threw — ignoring:', cbErr);
+            }
+          }
+
           await sleep(currentDelay);
 
           // Exponential backoff

package/src/plugins/index.ts

@@ -8,3 +8,4 @@ export type { Plugin, PluginHooks, PluginOptions, PluginFactory } from './Plugin
 // Built-in plugins
 export { createLoggingPlugin } from './builtin/LoggingPlugin';
 export { createRetryPlugin } from './builtin/RetryPlugin';
+export type { RetryPluginOptions, RetryAttempt } from './builtin/RetryPlugin';

package/src/services/BatchPrintManager.ts

@@ -93,6 +93,23 @@ export interface BatchEvents {
   'job-rejected': { reason: string };
   'auto-flush': { jobCount: number; bytes: number };
   'jobs-merged': { fromCount: number; toCount: number; savedBytes: number };
+  /** Per-job progress while the batch processor is running. */
+  'batch-progress': {
+    /** Number of bytes the processor has accepted so far (caller-reported). */
+    sent: number;
+    /** Total bytes the processor was asked to handle for this batch. */
+    total: number;
+    /** Job IDs in the current batch. */
+    jobIds: string[];
+  };
+  /** Emitted when the batch processor throws — the entire batch is marked failed. */
+  'batch-failed': {
+    jobIds: string[];
+    bytes: number;
+    error: BluetoothPrintError;
+  };
+  /** Emitted when a previously-failed job is re-queued via retryJob(). */
+  'job-retried': BatchJob;
 }
 
 /**
@@ -156,6 +173,9 @@ export class BatchPrintManager extends EventEmitter<BatchEvents> {
     unifiedCutsApplied: 0,
   };
 
+  /** Jobs from the most recent failed batch. Cleared on next successful processBatch(). */
+  private failedJobs: BatchJob[] = [];
+
   /**
    * Last job timestamp for interval timeout tracking
    */
@@ -300,10 +320,12 @@ export class BatchPrintManager extends EventEmitter<BatchEvents> {
   /**
    * Process the current batch
    *
-   * @param processor - Function to send batch data to printer
+   * @param processor - Function to send batch data to printer. May return a
+   *                    promise that resolves with the number of bytes sent, or
+   *                    void if the byte count is unknown.
    * @returns Number of jobs processed
    */
-  async processBatch(processor: (data: Uint8Array) => Promise<void>): Promise<number> {
+  async processBatch(processor: (data: Uint8Array) => Promise<void | number>): Promise<number> {
     if (this.isProcessing) {
       throw new BluetoothPrintError(
         ErrorCode.PRINT_JOB_IN_PROGRESS,
@@ -319,11 +341,12 @@ export class BatchPrintManager extends EventEmitter<BatchEvents> {
     this.isProcessing = true;
     this.clearWatchTimer();
 
-    try {
-      // Get jobs for this batch
-      const batchJobs = this.prepareBatch();
-      const { mergedData, fromCount, toCount } = this.mergeJobs(batchJobs);
+    // Snapshot the batch up-front so we can mark them failed if processor throws.
+    const batchJobs = this.prepareBatch();
+    const { mergedData, fromCount, toCount } = this.mergeJobs(batchJobs);
+    const batchJobIds = batchJobs.map(j => j.id);
 
+    try {
       // Report merge stats if jobs were merged
       if (fromCount !== toCount) {
         const savedBytes =
@@ -338,8 +361,37 @@ export class BatchPrintManager extends EventEmitter<BatchEvents> {
       // Emit batch ready event
       this.emit('batch-ready', batchJobs);
 
-      // Process the merged data
-      await processor(mergedData);
+      // Process the merged data. A throwing processor marks the whole batch
+      // as failed (kept in failedJobs for retryJob()) and emits batch-failed.
+      try {
+        const result = await processor(mergedData);
+        if (typeof result === 'number') {
+          this.emit('batch-progress', {
+            sent: result,
+            total: mergedData.length,
+            jobIds: batchJobIds,
+          });
+        }
+      } catch (procErr) {
+        const error =
+          procErr instanceof BluetoothPrintError
+            ? procErr
+            : new BluetoothPrintError(
+                ErrorCode.PRINT_JOB_FAILED,
+                (procErr as Error)?.message ?? 'Batch processor failed'
+              );
+        // Preserve failed jobs for retryJob() — DO NOT splice them from jobs[].
+        this.failedJobs = [...batchJobs];
+        this.emit('batch-failed', {
+          jobIds: batchJobIds,
+          bytes: mergedData.length,
+          error,
+        });
+        this.logger.error(
+          `Batch failed: ${batchJobs.length} jobs, ${mergedData.length} bytes — ${error.code}: ${error.message}`
+        );
+        throw error;
+      }
 
       // Update stats
       this.stats.totalBytes += mergedData.length;
@@ -355,6 +407,8 @@ export class BatchPrintManager extends EventEmitter<BatchEvents> {
       }
       this.pendingBytes -= removedBytes;
       this.jobs.splice(0, batchJobs.length);
+      // Successful batch clears the failed-jobs buffer.
+      this.failedJobs = [];
 
       this.emit('batch-processed', { jobCount: batchJobs.length, bytes: mergedData.length });
       this.logger.info(`Batch processed: ${batchJobs.length} jobs`);
@@ -365,6 +419,70 @@ export class BatchPrintManager extends EventEmitter<BatchEvents> {
     }
   }
 
+  /**
+   * Re-queue a previously-failed job.
+   *
+   * Searches `failedJobs` for the given id; if found, re-inserts the job at the
+   * front of the queue with bumped priority (current max + 1) so it is processed
+   * before other pending jobs. Returns false if no failed job matches.
+   *
+   * Does NOT auto-trigger processBatch — caller decides when to retry.
+   *
+   * @param id - Job ID returned from a prior addJob() call.
+   * @returns true if re-queued, false if no matching failed job.
+   */
+  retryJob(id: string): boolean {
+    const idx = this.failedJobs.findIndex(j => j.id === id);
+    if (idx === -1) {
+      this.logger.warn(`retryJob: no failed job with id ${id}`);
+      return false;
+    }
+    const job = this.failedJobs[idx]!;
+    this.failedJobs.splice(idx, 1);
+
+    // Bump priority above the current queue head so it runs first.
+    const maxPriority = this.jobs.reduce((m, j) => Math.max(m, j.priority), 0);
+    job.priority = maxPriority + 1;
+
+    this.jobs.unshift(job);
+    this.pendingBytes += job.data.length;
+    this.waitFired = false;
+    this.flushFired = false;
+    this.lastJobAt = Date.now();
+    this.restartWatchTimer();
+
+    this.emit('job-retried', job);
+    this.logger.info(`Re-queued failed job ${id} at priority ${job.priority}`);
+    return true;
+  }
+
+  /**
+   * Re-queue ALL currently-failed jobs in one call. Returns the count re-queued.
+   */
+  retryAllFailedJobs(): number {
+    let count = 0;
+    // Iterate in reverse so retryJob()'s unshift() doesn't shift our index.
+    for (let i = this.failedJobs.length - 1; i >= 0; i--) {
+      if (this.retryJob(this.failedJobs[i]!.id)) count++;
+    }
+    return count;
+  }
+
+  /**
+   * Snapshot of the most recent failed batch (empty if last batch succeeded
+   * or no batch has run yet).
+   */
+  getFailedJobs(): BatchJob[] {
+    return [...this.failedJobs];
+  }
+
+  /** Discard the failed-jobs buffer without re-queueing. */
+  clearFailedJobs(): void {
+    const count = this.failedJobs.length;
+    this.failedJobs = [];
+    this.logger.info(`Cleared ${count} failed jobs`);
+  }
+
   /**
    * Prepare batch from pending jobs
    */

package/dist/hero-illustration.svg

@@ -1,44 +0,0 @@
-<svg width="400" height="300" viewBox="0 0 400 300" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <!-- 背景圆 -->
-  <circle cx="200" cy="150" r="120" fill="#ecfeff" opacity="0.5"/>
-  <circle cx="200" cy="150" r="80" fill="#cffafe" opacity="0.5"/>
-  
-  <!-- 手机轮廓 -->
-  <rect x="140" y="60" width="120" height="180" rx="16" fill="#fff" stroke="#0891b2" stroke-width="3"/>
-  <rect x="150" y="80" width="100" height="140" rx="4" fill="#f0fdfa"/>
-  
-  <!-- 屏幕上的打印图标 -->
-  <rect x="165" y="95" width="70" height="50" rx="4" fill="#0891b2" opacity="0.1"/>
-  <text x="200" y="125" font-family="Arial" font-size="24" fill="#0891b2" text-anchor="middle">🖨️</text>
-  
-  <!-- 小票 -->
-  <rect x="170" y="155" width="60" height="45" rx="2" fill="#fff" stroke="#06b6d4" stroke-width="2"/>
-  <line x1="178" y1="165" x2="222" y2="165" stroke="#94a3b8" stroke-width="2"/>
-  <line x1="178" y1="175" x2="215" y2="175" stroke="#94a3b8" stroke-width="2"/>
-  <line x1="178" y1="185" x2="220" y2="185" stroke="#94a3b8" stroke-width="2"/>
-  
-  <!-- 蓝牙符号 -->
-  <path d="M220 120 L235 105 L235 135 L220 150 L235 165 L235 195 L220 180" stroke="#0891b2" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
-  
-  <!-- 打印机轮廓 -->
-  <rect x="260" y="170" width="80" height="60" rx="6" fill="#fff" stroke="#06b6d4" stroke-width="3"/>
-  <rect x="270" y="180" width="60" height="20" rx="2" fill="#cffafe"/>
-  <rect x="275" y="205" width="50" height="15" rx="2" fill="#0891b2" opacity="0.2"/>
-  
-  <!-- 出纸 -->
-  <rect x="275" y="235" width="50" height="25" rx="2" fill="#fff" stroke="#06b6d4" stroke-width="2"/>
-  <line x1="283" y1="243" x2="317" y2="243" stroke="#94a3b8" stroke-width="1.5"/>
-  <line x1="283" y1="250" x2="310" y2="250" stroke="#94a3b8" stroke-width="1.5"/>
-  
-  <!-- 连接线 -->
-  <path d="M250 200 Q280 200 280 200" stroke="#0891b2" stroke-width="2" stroke-dasharray="4 4" fill="none"/>
-  
-  <!-- 装饰 - 代码符号 -->
-  <text x="80" y="100" font-family="monospace" font-size="14" fill="#0891b2" opacity="0.6">&lt;/&gt;</text>
-  <text x="320" y="90" font-family="monospace" font-size="14" fill="#06b6d4" opacity="0.6">{ }</text>
-  <text x="100" y="220" font-family="monospace" font-size="12" fill="#0891b2" opacity="0.4">print()</text>
-  
-  <!-- 底部装饰 -->
-  <circle cx="60" cy="260" r="20" fill="#cffafe" opacity="0.4"/>
-  <circle cx="340" cy="270" r="25" fill="#ecfeff" opacity="0.4"/>
-</svg>