pindo 5.13.7 → 5.13.10

data/lib/pindo/module/task/pindo_task.rb

@@ -32,20 +32,23 @@ module Pindo
     # PindoTask 基类（简化版，所有任务在主线程中执行）
     class PindoTask
       attr_accessor :id, :name, :status, :error, :result
-      attr_reader :type, :priority, :dependencies
+      attr_reader :type, :task_key, :priority, :dependencies, :data_dependencies
       attr_accessor :context, :metadata
       attr_reader :created_at, :started_at, :finished_at
       attr_accessor :retry_count  # 剩余重试次数
       attr_reader :retry_mode, :retry_delay, :max_retry_count  # max_retry_count: 初始最大重试次数
       attr_accessor :callbacks_setup  # 标记回调是否已经设置
+      attr_accessor :task_manager  # TaskManager 实例（依赖注入）
 
       def initialize(name, options = {})
         @id = SecureRandom.uuid
         @name = name
         @type = self.class.task_type
+        @task_key = self.class.task_key
         @priority = options[:priority] || TaskPriority::HIGH
         @status = TaskStatus::PENDING
         @dependencies = options[:dependencies] || []
+        @data_dependencies = options[:data_dependencies] || []
         @context = options[:context] || {}
         @metadata = options[:metadata] || {}
         @error = nil
@@ -73,6 +76,10 @@ module Pindo
         raise NotImplementedError, "Subclass must define task_type"
       end
 
+      def self.task_key
+        raise NotImplementedError, "Subclass must define task_key"
+      end
+
       # 默认重试配置
       def self.default_retry_mode
         RetryMode::IMMEDIATE
@@ -135,6 +142,93 @@ module Pindo
         @status == TaskStatus::CANCELLED
       end
 
+      # ========== 依赖任务数据获取 ==========
+
+      # 获取指定依赖任务
+      # @param dep_task_id [String] 依赖任务的 ID
+      # @return [PindoTask, nil] 依赖任务对象，如果不存在返回 nil
+      def get_dependency_task(dep_task_id)
+        return nil unless @task_manager
+        @task_manager.find_task(dep_task_id)
+      end
+
+      # 获取指定依赖任务的结果
+      # @param dep_task_id [String] 依赖任务的 ID
+      # @return [Hash, nil] 依赖任务的 result，如果任务不存在或未完成返回 nil
+      def get_dependency_result(dep_task_id)
+        dep_task = get_dependency_task(dep_task_id)
+        return nil unless dep_task
+        return nil unless dep_task.finished?
+        dep_task.result
+      end
+
+      # 获取所有依赖任务的结果（按依赖顺序）
+      # @return [Hash] key 为任务 ID，value 为任务结果
+      def get_all_dependencies_results
+        results = {}
+        @dependencies.each do |dep_id|
+          results[dep_id] = get_dependency_result(dep_id)
+        end
+        results
+      end
+
+      # ========== 任务数据参数传递 ==========
+
+      # 获取任务的数据参数（用于传递给其他任务）
+      # @return [Hash] 包含任务标识和参数的哈希
+      def data_param
+        {
+          task_id: @id,
+          task_type: @type,
+          task_key: @task_key,
+          task_name: @name,
+          task_param: build_task_param
+        }
+      end
+
+      # 获取指定数据依赖任务的数据参数
+      # @param task_id [String] 任务 ID
+      # @return [Hash, nil] 任务的数据参数，如果任务不存在或未完成返回 nil
+      def get_data_param(task_id)
+        dep_task = get_dependency_task(task_id)
+        return nil unless dep_task
+        return nil unless dep_task.finished? && dep_task.status == TaskStatus::SUCCESS
+        dep_task.data_param
+      end
+
+      # 获取所有数据依赖任务的数据参数
+      # @return [Array<Hash>] 数据参数数组
+      def get_all_data_params
+        @data_dependencies.map { |task_id| get_data_param(task_id) }.compact
+      end
+
+      # 根据 task_key 获取数据依赖任务的数据参数
+      # @param task_key [Symbol] 任务键
+      # @return [Hash, nil] 第一个匹配的任务数据参数
+      def get_data_param_by_key(task_key)
+        @data_dependencies.each do |task_id|
+          param = get_data_param(task_id)
+          return param if param && param[:task_key] == task_key
+        end
+        nil
+      end
+
+      # 获取所有指定 task_key 的数据参数
+      # @param task_key [Symbol] 任务键
+      # @return [Array<Hash>] 匹配的任务数据参数数组
+      def get_all_data_params_by_key(task_key)
+        get_all_data_params.select { |param| param[:task_key] == task_key }
+      end
+
+      # 获取主数据参数（第一个数据依赖任务的参数）
+      # @return [Hash, nil] 主数据参数
+      def primary_data_param
+        return nil if @data_dependencies.empty?
+        get_data_param(@data_dependencies.first)
+      end
+
+      # ========== 回调方法 ==========
+
       # 添加回调
       def on(event, &block)
         @callbacks[event] << block if @callbacks[event]
@@ -167,6 +261,12 @@ module Pindo
         raise NotImplementedError, "Subclass must implement do_work method"
       end
 
+      # 构建任务参数（子类重写以提供自定义参数）
+      # @return [Hash] 任务参数
+      def build_task_param
+        {}  # 默认返回空哈希
+      end
+
       private
 
       # 内部执行逻辑

data/lib/pindo/module/task/task_manager.rb

@@ -108,6 +108,15 @@ module Pindo
         task&.cancel
       end
 
+      # 查找任务（公共方法，供 PindoTask 获取依赖任务使用）
+      # @param task_id [String] 任务 ID
+      # @return [PindoTask, nil] 任务对象
+      def find_task(task_id)
+        all_tasks = @pending_queue + @completed_tasks
+        all_tasks << @current_task if @current_task
+        all_tasks.find { |t| t.id == task_id }
+      end
+
       private
 
       # 获取下一个可执行的任务
@@ -168,6 +177,9 @@ module Pindo
       def execute_task(task)
         @current_task = task
 
+        # 注入 TaskManager 实例（依赖注入）
+        task.task_manager = self
+
         # 设置任务进度回调
         setup_task_callbacks(task)
 
@@ -224,13 +236,6 @@ module Pindo
         Funlog.warning("任务 #{task.name} 因#{reason}而被取消")
       end
 
-      # 查找任务
-      def find_task(task_id)
-        all_tasks = @pending_queue + @completed_tasks
-        all_tasks << @current_task if @current_task
-        all_tasks.find { |t| t.id == task_id }
-      end
-
       # 输出任务执行计划
       def print_execution_plan
         # 按类型分组统计
@@ -242,29 +247,21 @@ module Pindo
         puts "=" * 60
 
         tasks_by_type.each do |type, tasks|
-          type_name = get_type_display_name(type)
-          puts "  #{type_name}: #{tasks.count} 个任务"
+          # 直接从任务类获取显示名称
+          type_name = tasks.first&.class&.task_type_name || type.to_s.capitalize
+          puts "\n  #{type_name}: #{tasks.count} 个任务"
+
+          # 显示该类型下的每个任务名称
+          tasks.each do |task|
+            puts "    - #{task.name}"
+          end
         end
 
-        puts "  总计: #{@pending_queue.count} 个任务"
+        puts "\n  总计: #{@pending_queue.count} 个任务"
         puts "=" * 60 + "\e[0m"
         puts "\n"
       end
 
-      # 获取任务类型的显示名称
-      def get_type_display_name(type)
-        case type
-        when :unity_export
-          "Unity 导出"
-        when :build
-          "编译构建"
-        when :upload
-          "上传发布"
-        else
-          type.to_s.capitalize
-        end
-      end
-
       # 输出任务执行头部
       def print_task_header(task)
         puts "\n"
@@ -285,6 +282,14 @@ module Pindo
         puts "\n"
         Funlog.error("任务失败: #{task.name}")
         Funlog.error("错误信息: #{error.message}")
+
+        # 打印堆栈信息用于调试（仅在 PINDO_DEBUG 模式下）
+        if ENV['PINDO_DEBUG'] && error.backtrace && !error.backtrace.empty?
+          puts "\n堆栈信息:"
+          error.backtrace.first(10).each do |line|
+            puts "  #{line}"
+          end
+        end
       end
 
       # 输出任务底部分隔线

data/lib/pindo/module/unity/nuget_helper.rb

@@ -2,11 +2,11 @@ require 'fileutils'
 require 'json'
 require 'nokogiri'
 require 'open3'
+require 'pindo/base/git_handler'
 
 module Pindo
   module Unity
     class NugetHelper
-      extend Pindo::Githelper
 
       # ============================================
       # ID 格式转换
@@ -535,11 +535,11 @@ module Pindo
         default_message = "feat: 更新版本到 #{nuspec_version}"
 
         # 如果不是 Git 仓库，返回默认消息
-        unless is_git_directory?(local_repo_dir: package_dir)
+        unless Pindo::GitHandler.is_git_directory?(local_repo_dir: package_dir)
           return default_message
         end
 
-        git_root = git_root_directory(local_repo_dir: package_dir)
+        git_root = Pindo::GitHandler.git_root_directory(local_repo_dir: package_dir)
         unless git_root
           return default_message
         end
@@ -551,7 +551,7 @@ module Pindo
           Dir.chdir(git_root)
 
           # 获取所有 tags
-          all_tags = git!(%W(-C #{git_root} tag -l)).split("\n")
+          all_tags = Pindo::GitHandler.git!(%W(-C #{git_root} tag -l)).split("\n")
 
           # 查找匹配当前版本的 tag（不区分大小写，支持 v 前缀）
           matching_tag = all_tags.find do |tag|
@@ -570,7 +570,7 @@ module Pindo
             Dir.chdir(git_root)
 
             # 获取所有 tags 并按版本号排序
-            all_tags = git!(%W(-C #{git_root} tag -l)).split("\n")
+            all_tags = Pindo::GitHandler.git!(%W(-C #{git_root} tag -l)).split("\n")
             sorted_tags = all_tags.sort_by do |tag|
               version_str = tag.gsub(/^(v|V|release[\s_-]*)/i, '')
               version_str.split('.').map(&:to_i)
@@ -598,7 +598,7 @@ module Pindo
             # 获取最新 tag
             latest_tag = nil
             ["v", "V", "release", ""].each do |prefix|
-              latest_tag = get_latest_version_tag(project_dir: git_root, tag_prefix: prefix)
+              latest_tag = Pindo::GitHandler.get_latest_version_tag(project_dir: git_root, tag_prefix: prefix)
               break if latest_tag
             end
 
@@ -615,7 +615,7 @@ module Pindo
 
           # 使用特殊分隔符来区分不同的 commits
           separator = "---COMMIT-SEPARATOR---"
-          commits_raw = git!(%W(-C #{git_root} log #{git_range} --pretty=format:%B#{separator}))
+          commits_raw = Pindo::GitHandler.git!(%W(-C #{git_root} log #{git_range} --pretty=format:%B#{separator}))
 
           # 按分隔符拆分成单个 commits
           commits = commits_raw.split(separator).map(&:strip).reject(&:empty?)

data/lib/pindo/module/unity/unity_command_helper.rb

@@ -0,0 +1,188 @@
+require 'open3'
+require 'pindo/base/funlog'
+require 'pindo/config/pindoconfig'
+require 'pindo/module/unity/unity_env_helper'
+require 'pindo/module/unity/unity_proc_helper'
+
+
+module Pindo
+  module Unity
+    # Unity 命令执行助手
+    # 负责执行 Unity 命令行操作
+    # 所有方法均为类方法，无需实例化
+    class UnityCommandHelper
+
+      # 执行 Unity 命令
+      # @param unity_exe_full_path [String] Unity 可执行文件路径
+      # @param project_path [String] Unity 项目路径
+      # @param method [String] Unity 方法名（默认: GoodUnityBuild.BuildManager.BatchBuild）
+      # @param additional_args [Hash] 额外参数
+      # @return [Hash] 执行结果 { success:, stdout:, stderr:, exit_status:, unity_version: }
+      def self.execute_unity_command(unity_exe_full_path, project_path, method: 'GoodUnityBuild.BuildManager.BatchBuild', additional_args: {})
+        if unity_exe_full_path.nil?
+          raise Informative, "Unity path not found!"
+        end
+
+        # 调试级别：通过环境变量或参数控制
+        debug_level = ENV['UNITY_BUILD_DEBUG'] || additional_args[:debug_level] || 'normal'
+        # debug_level: 'quiet' - 只显示错误
+        #              'normal' - 显示错误、警告和关键进度
+        #              'verbose' - 显示所有输出
+
+        # 检查项目路径是否存在
+        unless File.directory?(project_path)
+          raise Informative, "Unity项目路径不存在: #{project_path}"
+        end
+
+        # 检查项目是否是Unity项目
+        project_settings = File.join(project_path, "ProjectSettings")
+        unless File.directory?(project_settings)
+          raise Informative, "项目路径不是Unity项目: #{project_path}"
+        end
+
+        cmd_args = [
+          unity_exe_full_path,
+          "-batchmode",
+          "-quit",
+          "-projectPath",
+          project_path.to_s,
+          "-executeMethod",
+          method
+        ]
+
+        # Add any additional arguments
+        additional_args.each do |key, value|
+          cmd_args << "-#{key}"
+          cmd_args << value.to_s if value
+        end
+
+        puts "Unity command: #{cmd_args.join(' ')}"
+        puts ""
+
+        # 使用更智能的进度检测机制
+        progress_thread = nil
+        start_time = Time.now
+        last_output_time = Time.now
+
+        begin
+          # 使用 Open3.popen3 来实时监控输出
+          Open3.popen3(*cmd_args) do |stdin, stdout, stderr, wait_thr|
+            stdin.close
+
+            # 启动进度显示线程
+            progress_thread = Thread.new do
+              dots = 0
+              while wait_thr.alive?
+                sleep(2)
+                dots = (dots + 1) % 4
+                elapsed = (Time.now - start_time).to_i
+                print "\r\e[33mUnity 构建中#{'.' * dots}#{' ' * (3 - dots)} (已用时: #{elapsed}秒)\e[0m"
+                $stdout.flush
+              end
+            end
+
+            # 实时读取输出
+            stdout_buffer = ""
+            stderr_buffer = ""
+
+            # 定义错误关键词模式（优化正则，避免重复）
+            error_pattern = /error|exception|failed|Build completed with a result of 'Failed'/i
+            warning_pattern = /warning|warn/i
+            success_pattern = /Build completed successfully|Exiting batchmode successfully/i
+
+            # 使用非阻塞方式读取输出
+            while wait_thr.alive?
+              # 检查是否有输出可读
+              ready_streams = IO.select([stdout, stderr], nil, nil, 1)
+
+              if ready_streams
+                ready_streams[0].each do |stream|
+                  if line = stream.gets
+                    # 记录输出
+                    if stream == stdout
+                      stdout_buffer += line
+                    else
+                      stderr_buffer += line
+                    end
+                    last_output_time = Time.now
+
+                    # 根据调试级别和内容类型显示输出
+                    case debug_level
+                    when 'verbose'
+                      # 详细模式：显示所有输出
+                      puts line
+                    when 'quiet'
+                      # 安静模式：只显示错误
+                      if line.match?(error_pattern)
+                        puts "\e[31m[错误] #{line.strip}\e[0m"
+                      end
+                    else # 'normal'
+                      # 正常模式：显示错误、警告和关键进度
+                      if line.match?(error_pattern)
+                        puts "\n\e[31m[错误] #{line.strip}\e[0m"
+                      elsif line.match?(warning_pattern)
+                        puts "\n\e[33m[警告] #{line.strip}\e[0m"
+                      elsif line.match?(success_pattern)
+                        puts "\n\e[32m[成功] #{line.strip}\e[0m"
+                      elsif line.match?(/\d+%/) || line.match?(/Building|Compiling|Processing/i)
+                        # 显示进度相关信息
+                        print "\r\e[36m[进度] #{line.strip}\e[0m"
+                        $stdout.flush
+                      end
+                    end
+                  end
+                end
+              end
+
+            end
+
+            # 读取剩余输出
+            stdout_buffer += stdout.read
+            stderr_buffer += stderr.read
+
+            # 停止进度显示线程
+            progress_thread.kill if progress_thread
+
+            # 检查构建是否真的成功
+            build_success = wait_thr.value.success?
+
+            # 检查是否有构建错误的关键词
+            if stdout_buffer.match?(/Build completed with a result of 'Failed'|Build completed with a result of 'Cancelled'|BuildPlayerWindow\+BuildMethod\+Invoke|error|Error|ERROR|exception|Exception|EXCEPTION|failed|Failed|FAILED/)
+              build_success = false
+              # puts "\n\e[31m检测到构建错误信息，构建可能失败\e[0m"
+            end
+
+            if build_success
+              print "\r\e[32mUnity 构建完成！\e[0m\n"
+              # 构建完成后检查并清理可能的 Unity 进程残留
+              UnityProcHelper.cleanup_unity_processes_after_build(unity_exe_full_path: unity_exe_full_path, project_path: project_path)
+            else
+              print "\r\e[31mUnity 构建失败！\e[0m\n"
+              puts "\e[31m构建输出:\e[0m"
+              puts stdout_buffer if !stdout_buffer.empty?
+              puts "\e[31m错误输出:\e[0m"
+              puts stderr_buffer if !stderr_buffer.empty?
+              # 构建失败时也清理可能的进程残留
+              UnityProcHelper.cleanup_unity_processes_after_build(unity_exe_full_path: unity_exe_full_path, project_path: project_path)
+            end
+
+            # 返回结果
+            {
+              success: build_success,
+              stdout: stdout_buffer,
+              stderr: stderr_buffer,
+              exit_status: wait_thr.value.exitstatus,
+              unity_version: UnityEnvHelper.extract_version_from_path(unity_exe_full_path)
+            }
+          end
+        rescue => e
+          # 停止进度显示线程
+          progress_thread.kill if progress_thread
+          print "\r\e[31mUnity 构建失败！\e[0m\n"
+          raise e
+        end
+      end
+
+    end
+  end
+end

data/lib/pindo/module/unity/unity_env_helper.rb

@@ -0,0 +1,208 @@
+module Pindo
+  module Unity
+    # Unity 环境管理助手
+    # 负责 Unity 版本查找、路径管理等环境相关功能
+    # 所有方法均为类方法，无需实例化
+    class UnityEnvHelper
+      # macOS Unity 安装路径
+      UNITY_MAC_PATHS = [
+        "/Applications/Unity/Unity.app/Contents/MacOS/Unity",
+        "/Applications/Unity/Hub/Editor/*/Unity.app/Contents/MacOS/Unity",
+        "/Applications/Unity/*/Unity.app/Contents/MacOS/Unity"
+      ]
+
+      # Windows Unity 安装路径
+      UNITY_WINDOWS_PATHS = [
+        "C:/Program Files/Unity/Editor/Unity.exe",
+        "C:/Program Files/Unity/Hub/Editor/*/Unity.exe",
+        "C:/Program Files/Unity/*/Editor/Unity.exe"
+      ]
+
+      # 查找 Unity 路径
+      # @param project_unity_version [String] 项目所需的 Unity 版本
+      # @param force_change_version [Boolean] 是否强制使用最新版本
+      # @return [String] Unity 可执行文件的完整路径
+      def self.find_unity_path(project_unity_version: nil, force_change_version: false)
+        if project_unity_version.nil? || project_unity_version.empty?
+          raise "Project Unity version is nil or empty"
+        end
+
+        unity_major_version = project_unity_version.split('.')[0..1].join('.')
+        paths = case RUBY_PLATFORM
+                when /darwin/
+                  UNITY_MAC_PATHS
+                when /mswin|mingw|windows/
+                  UNITY_WINDOWS_PATHS
+                else
+                  raise "Unsupported platform: #{RUBY_PLATFORM}"
+                end
+
+        unity_versions = []
+
+        paths.each do |path|
+          if path.include?("*")
+            Dir.glob(path).each do |expanded_path|
+              version = extract_version_from_path(expanded_path)
+              if version
+                major_version = version.split('.')[0..1].join('.')
+                unity_versions << {
+                  path: expanded_path,
+                  version: version,
+                  major_version: major_version
+                }
+              end
+            end
+          elsif File.exist?(path)
+            version = extract_version_from_path(path)
+            if version
+              major_version = version.split('.')[0..1].join('.')
+              unity_versions << {
+                path: path,
+                version: version,
+                major_version: major_version
+              }
+            end
+          end
+        end
+
+        if unity_versions.empty?
+          puts "调试信息: 搜索的Unity路径:"
+          paths.each do |path|
+            puts "  - #{path}"
+            if path.include?("*")
+              Dir.glob(path).each do |expanded_path|
+                puts "    展开: #{expanded_path}"
+              end
+            elsif File.exist?(path)
+              puts "    存在: #{path}"
+            else
+              puts "    不存在: #{path}"
+            end
+          end
+          raise Informative, "未找到任何Unity版本，请检查Unity是否正确安装"
+        end
+
+        # 精确匹配项目版本
+        select_unity_versions = unity_versions.select { |v| v[:version] == project_unity_version } || []
+        if !select_unity_versions.nil? && !select_unity_versions.empty? && select_unity_versions.length >= 1
+          return select_unity_versions.first[:path]
+        end
+
+        # 按主版本匹配
+        unity_versions.sort_by! { |v| v[:major_version] }
+        select_unity_versions = unity_versions.select { |v| v[:major_version] == unity_major_version } if unity_major_version
+        if select_unity_versions.nil? || select_unity_versions.empty?
+          if force_change_version
+            puts "强制使用最新版本: #{unity_versions.last[:version]}"
+            return unity_versions.last[:path]
+          else
+            puts "调试信息: 项目Unity版本: #{project_unity_version}"
+            puts "调试信息: 可用的Unity版本:"
+            unity_versions.each do |v|
+              puts "  - #{v[:version]} (#{v[:major_version]})"
+            end
+            raise Informative, "未找到匹配的Unity版本 #{project_unity_version}，可用的版本: #{unity_versions.map { |v| v[:version] }.join(', ')}"
+          end
+        else
+          return select_unity_versions.first[:path]
+        end
+      end
+
+      # 从路径中提取 Unity 版本号
+      # @param path [String] Unity 可执行文件路径
+      # @return [String, nil] 版本号或 nil
+      def self.extract_version_from_path(path)
+        # macOS路径格式: /Applications/Unity/Hub/Editor/2021.3.45f1/Unity.app/Contents/MacOS/Unity
+        # macOS路径格式(变体): /Applications/Unity/Hub/Editor/2021.3.45f1c1/Unity.app/Contents/MacOS/Unity
+        # macOS路径格式(旧版): /Applications/Unity/Unity.app/Contents/MacOS/Unity
+        # Windows路径格式: C:/Program Files/Unity/Hub/Editor/2021.3.45f1/Editor/Unity.exe
+        # Windows路径格式(变体): C:/Program Files/Unity/Hub/Editor/2021.3.45f1c1/Editor/Unity.exe
+        # Windows路径格式(旧版): C:/Program Files/Unity/Editor/Unity.exe
+
+        # 尝试匹配 macOS Hub 路径格式
+        if match = path.match(/Editor\/([\d.]+[a-zA-Z]\d+(?:c\d+)?)\//)
+          return match[1]
+        end
+
+        # 尝试匹配 Windows Hub 路径格式
+        if match = path.match(/([\d.]+[a-zA-Z]\d+(?:c\d+)?)\/Editor\//)
+          return match[1]
+        end
+
+        # 尝试匹配 macOS 旧版路径格式 (从Info.plist提取版本)
+        if match = path.match(/Unity\.app\/Contents\/MacOS\/Unity$/)
+          info_plist_path = File.join(File.dirname(File.dirname(path)), "Info.plist")
+          if File.exist?(info_plist_path)
+            begin
+              content = File.read(info_plist_path)
+              if content =~ /<key>CFBundleVersion<\/key>\s*<string>([^<]+)<\/string>/
+                return $1.strip
+              elsif content =~ /<key>CFBundleShortVersionString<\/key>\s*<string>Unity version ([^<]+)<\/string>/
+                return $1.strip
+              end
+            rescue => e
+              puts "警告: 无法读取Info.plist文件: #{e.message}"
+            end
+          end
+        end
+
+        # 尝试匹配 Windows 旧版路径格式
+        if match = path.match(/Unity\.exe$/)
+          # 对于旧版Unity，尝试从父目录获取版本信息
+          parent_dir = File.dirname(path)
+          if File.basename(parent_dir) =~ /^([\d.]+[a-zA-Z]\d+(?:c\d+)?)$/
+            return $1
+          end
+        end
+
+        nil
+      end
+
+      # 比较版本号 (语义化版本比较)
+      # @param v1 [String] 版本1
+      # @param v2 [String] 版本2
+      # @return [Boolean] true 如果 v1 < v2, false 否则
+      def self.version_less_than?(v1, v2)
+        return false if v1.nil? || v2.nil?
+
+        Gem::Version.new(v1) < Gem::Version.new(v2)
+      rescue ArgumentError
+        # 版本格式无效时的降级处理
+        v1.to_s < v2.to_s
+      end
+
+      # 获取项目的 Unity 版本
+      # @param project_path [String] Unity 项目路径
+      # @return [String] Unity 版本号
+      def self.get_unity_version(project_path)
+        version_path = File.join(project_path, "ProjectSettings", "ProjectVersion.txt")
+        if File.exist?(version_path)
+          content = File.read(version_path)
+          if content =~ /m_EditorVersion: (.*)/
+            version = $1.strip
+            version
+          else
+            raise "Could not parse Unity version from #{version_path}"
+          end
+        else
+          raise "Project version file not found at #{version_path}"
+        end
+      end
+
+      # 检查是否为有效的 Unity 项目
+      # @param project_path [String] 项目路径
+      # @return [Boolean] true 如果是有效的 Unity 项目
+      def self.unity_project?(project_path)
+        # 检查关键Unity工程文件和目录是否存在
+        project_settings_path = File.join(project_path, "ProjectSettings")
+        assets_path = File.join(project_path, "Assets")
+        packages_path = File.join(project_path, "Packages")
+
+        File.directory?(project_settings_path) &&
+        File.directory?(assets_path) &&
+        File.directory?(packages_path) &&
+        File.exist?(File.join(project_settings_path, "ProjectSettings.asset"))
+      end
+    end
+  end
+end