debug: add comprehensive ZIP path calculation logging

Added detailed logging to diagnose ZIP structure issues in SPM environments:
- Log directory and file paths before and after symlink resolution
- Show relative path calculation results
- Display all ZIP entries being created
- Force output regardless of DEBUG configuration

This will help identify why ZIP structures may still be incorrect in
certain environments.

🤖 Generated with [Claude Code](https://claude.ai/code)

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

Author: fatbobman

Sources/Objects2XLSX/Utils/SimpleZip.swift

@@ -294,6 +294,8 @@ public struct SimpleZip: Sendable {
     private static func collectEntries(from directoryURL: URL) throws -> [Entry] {
         let fileManager = FileManager.default
         var entries: [Entry] = []
+        
+        print("🔧 ZIP collectEntries started from: \(directoryURL.path)")
 
         let enumerator = fileManager.enumerator(
             at: directoryURL,
@@ -315,9 +317,21 @@ public struct SimpleZip: Sendable {
                 if resolvedFileURL.path.hasPrefix(resolvedDirectoryURL.path) {
                     let basePath = resolvedDirectoryURL.path.hasSuffix("/") ? resolvedDirectoryURL.path : resolvedDirectoryURL.path + "/"
                     relativePath = String(resolvedFileURL.path.dropFirst(basePath.count))
+                    // 强制输出调试信息（移除 DEBUG 条件）
+                    print("✅ ZIP Path calculation success:")
+                    print("   Directory: \(resolvedDirectoryURL.path)")
+                    print("   File: \(resolvedFileURL.path)")
+                    print("   Relative: \(relativePath)")
                 } else {
                     // Fallback to just filename if path calculation fails
                     relativePath = fileURL.lastPathComponent
+                    // 强制输出调试信息（移除 DEBUG 条件）
+                    print("❌ ZIP Path calculation failed:")
+                    print("   Directory original: \(directoryURL.path)")
+                    print("   Directory resolved: \(resolvedDirectoryURL.path)")
+                    print("   File original: \(fileURL.path)")
+                    print("   File resolved: \(resolvedFileURL.path)")
+                    print("   Fallback to: \(relativePath)")
                 }
                 let data = try Data(contentsOf: fileURL)
                 let modificationDate = resourceValues.contentModificationDate ?? Date()
@@ -327,7 +341,12 @@ public struct SimpleZip: Sendable {
         }
 
         // Sort entries by path for consistent output
-        return entries.sorted { $0.path < $1.path }
+        let sortedEntries = entries.sorted { $0.path < $1.path }
+        print("📦 ZIP collectEntries completed: \(sortedEntries.count) files")
+        for entry in sortedEntries {
+            print("   📄 \(entry.path)")
+        }
+        return sortedEntries
     }
 }
 

debug_paths.swift

@@ -0,0 +1,29 @@
+import Foundation
+
+// 添加这个调试代码到你的项目中测试
+func debugPathResolution() {
+    let tempURL = FileManager.default.temporaryDirectory.appendingPathComponent("test.xlsx")
+    let tempDir = FileManager.default.temporaryDirectory.appendingPathComponent("Objects2XLSX_DEBUG")
+    
+    print("🔍 路径调试信息：")
+    print("1. tempURL.path: \(tempURL.path)")
+    print("2. tempURL.resolvingSymlinksInPath().path: \(tempURL.resolvingSymlinksInPath().path)")
+    print("3. tempDir.path: \(tempDir.path)")
+    print("4. tempDir.resolvingSymlinksInPath().path: \(tempDir.resolvingSymlinksInPath().path)")
+    
+    // 创建一个测试文件来验证路径
+    try? FileManager.default.createDirectory(at: tempDir, withIntermediateDirectories: true)
+    let testFile = tempDir.appendingPathComponent("test.xml")
+    try? "test".write(to: testFile, atomically: true, encoding: .utf8)
+    
+    print("5. testFile.path: \(testFile.path)")
+    print("6. testFile.resolvingSymlinksInPath().path: \(testFile.resolvingSymlinksInPath().path)")
+    
+    // 检查前缀匹配
+    let resolved1 = tempDir.resolvingSymlinksInPath().path
+    let resolved2 = testFile.resolvingSymlinksInPath().path
+    print("7. hasPrefix check: \(resolved2.hasPrefix(resolved1))")
+    
+    // 清理
+    try? FileManager.default.removeItem(at: tempDir)
+}