pindo 5.14.7 → 5.15.1

data/lib/pindo/module/task/model/build/android_build_dev_task.rb

@@ -146,14 +146,15 @@ module Pindo
 
           if git_root
             # 是 Git 仓库，自己计算版本号
-            build_number = git_repo_helper.get_build_number_from_commit(project_dir: @project_path)
+            build_number, commit_hash = git_repo_helper.get_build_number_from_commit(project_dir: @project_path)
             build_version = git_repo_helper.calculate_build_version(
               project_dir: @project_path,
               tag_prefix: @tag_pre,
               create_tag_type: @tag_type,
               version_increase_type: @ver_inc
             )
-            Funlog.instance.fancyinfo_success("自己计算版本号: #{build_version}, Build: #{build_number}")
+            commit_short = commit_hash ? commit_hash[0..7] : "unknown"
+            Funlog.instance.fancyinfo_success("自己计算版本号: #{build_version}, Build: #{build_number}, Commit: #{commit_short}")
           else
             # 不是 Git 仓库且没有从 GitCommitTask 获取到版本号，跳过版本更新
             Funlog.warning("非Git仓库且未从 GitCommitTask 获取到版本号，保持工程原有版本号")

data/lib/pindo/module/task/model/build/ios_build_dev_task.rb

@@ -159,14 +159,15 @@ module Pindo
 
           if git_root
             # 是 Git 仓库，自己计算版本号
-            build_number = git_repo_helper.get_build_number_from_commit(project_dir: @project_path)
+            build_number, commit_hash = git_repo_helper.get_build_number_from_commit(project_dir: @project_path)
             build_version = git_repo_helper.calculate_build_version(
               project_dir: @project_path,
               tag_prefix: @tag_pre,
               create_tag_type: @tag_type,
               version_increase_type: @ver_inc
             )
-            Funlog.instance.fancyinfo_success("自己计算版本号: #{build_version}, Build: #{build_number}")
+            commit_short = commit_hash ? commit_hash[0..7] : "unknown"
+            Funlog.instance.fancyinfo_success("自己计算版本号: #{build_version}, Build: #{build_number}, Commit: #{commit_short}")
           else
             # 不是 Git 仓库且没有从 GitCommitTask 获取到版本号，跳过版本更新
             Funlog.warning("非Git仓库且未从 GitCommitTask 获取到版本号，保持工程原有版本号")

data/lib/pindo/module/task/model/git/git_commit_task.rb

@@ -1,15 +1,13 @@
 require 'pindo/module/task/model/git_task'
 require 'pindo/base/git_handler'
 require 'pindo/module/build/git_repo_helper'
+require 'pindo/options/helpers/git_constants'
 
 module Pindo
   module TaskSystem
     # Git 提交任务
     # 负责检查并提交仓库的未提交修改
     class GitCommitTask < GitTask
-      attr_reader :release_branch, :ver_inc, :tag_type, :tag_pre
-      attr_reader :build_version, :build_number
-
       # 任务键
       def self.task_key
         :git_commit
@@ -37,18 +35,13 @@ module Pindo
       #   2. 执行 check_gitignore（可能创建新提交）
       #   3. 最终使用 fixed_version（如果有）或计算新版本号
       def initialize(project_path, options = {})
-        @release_branch = options[:release_branch] || 'master'
-        @ver_inc = options[:ver_inc] || Pindo::VersionIncreaseType::MINI
-        @tag_type = options[:tag_type] || Pindo::CreateTagType::NEW
-        @tag_pre = options[:tag_pre] || 'v'
+        # GitCommitTask 特有的属性
         @fixed_version = options[:fixed_version]  # 外部指定的固定版本号
-        @process_type = options[:process_type] || 'skip' # 默认跳过
+        @process_type = options[:process_type] || Pindo::UncommittedFilesProcessType::SKIP # 默认跳过
         @commit_message = options[:commit_message] || 'build: 构建产生提交' # 默认提交消息
 
-        @build_version = nil
-        @build_number = nil
         options[:project_path] = project_path
-
+        # 调用基类初始化（基类会设置 release_branch, ver_inc, tag_type, tag_pre 等通用属性）
         super("Git仓库文件提交检查", options)
       end
 
@@ -79,7 +72,7 @@ module Pindo
         # 1. 如果 fixed_version 为 nil，尝试从 HEAD 的 tag 获取版本
         # 必须在 check_gitignore 之前检查，因为 check_gitignore 可能创建提交导致 HEAD 移动
         if (@fixed_version.nil? || @fixed_version.empty?) &&
-           git_repo_helper.head_has_version_tag?(project_dir: root_dir, tag_prefix: @tag_pre) &&
+           Pindo::GitHandler.head_has_version_tag?(project_dir: root_dir, tag_prefix: @tag_pre) &&
            !Pindo::GitHandler.has_uncommitted_changes?(git_root_dir: root_dir)
           # HEAD 有 tag 且工作目录干净，使用 tag 的版本
           latest_tag = Pindo::GitHandler.get_latest_version_tag(
@@ -87,7 +80,7 @@ module Pindo
             tag_prefix: @tag_pre
           )
           @fixed_version = latest_tag.sub(/^#{@tag_pre}/, '') if latest_tag
-          Funlog.instance.fancyinfo_success("HEAD 存在 tag 且工作目录干净，设置 fixed_version: #{@fixed_version}")
+          Funlog.instance.fancyinfo_success("HEAD 存在 tag 且工作目录干净，会强制使用HEAD上的版本号: #{@fixed_version}")
         end
 
         # 2. 检查并修复 .gitignore（可能创建新提交，但 fixed_version 已经确定）
@@ -98,7 +91,7 @@ module Pindo
         begin
             Pindo::GitHandler.process_need_add_files(
                 project_dir: root_dir,
-                process_type: @process_type || 'skip',
+                process_type: @process_type || Pindo::UncommittedFilesProcessType::NONE,
                 commit_message: @commit_message
             )
         rescue Pindo::Informative => e
@@ -112,10 +105,11 @@ module Pindo
 
         # 4. Stash 工作目录的残留修改（为分支同步做准备）
         stash_saved = false
+        stash_name = "pindo_stash_#{Time.now.strftime('%Y%m%d%H%M%S')}_#{rand(1000)}"
         status = Pindo::GitHandler.git!(%W(-C #{root_dir} status --porcelain)).strip
         unless status.empty?
-          Funlog.instance.fancyinfo_update("工作目录有未提交更改，暂存到 stash")
-          Pindo::GitHandler.git!(%W(-C #{root_dir} stash -u))
+          Funlog.instance.fancyinfo_update("工作目录有未提交更改，暂存到 stash: #{stash_name}")
+          Pindo::GitHandler.git!(%W(-C #{root_dir} stash push -u -m #{stash_name}))
           stash_saved = true
         end
 
@@ -141,26 +135,40 @@ module Pindo
         # 优先级 1: 如果指定了 fixed_version（外部传入或从 HEAD tag 获取），使用它
         if @fixed_version && !@fixed_version.empty?
           @build_version = @fixed_version
-          @build_number = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
-          Funlog.instance.fancyinfo_success("使用 fixed_version: #{@build_version}, Build: #{@build_number}")
+          @build_number, @commit_hash = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
+          commit_short = @commit_hash ? @commit_hash[0..7] : "unknown"
+          Funlog.instance.fancyinfo_success("Version: #{@build_version}, Build: #{@build_number}, Commit: #{commit_short}")
 
         # 优先级 2: 计算新版本号
         else
-          @build_number = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
+          @build_number, @commit_hash = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
           @build_version = git_repo_helper.calculate_build_version(
             project_dir: root_dir,
             tag_prefix: @tag_pre,
             create_tag_type: @tag_type,
             version_increase_type: @ver_inc
           )
-          Funlog.instance.fancyinfo_success("计算新版本号: #{@build_version}, Build: #{@build_number}")
+          commit_short = @commit_hash ? @commit_hash[0..7] : "unknown"
+          Funlog.instance.fancyinfo_success("Version: #{@build_version}, Build: #{@build_number}, Commit: #{commit_short}")
         end
 
+
         # 9. 还原 stash（如果之前有 stash）
         if stash_saved
           begin
-            Pindo::GitHandler.git!(%W(-C #{root_dir} stash pop))
-            Funlog.instance.fancyinfo_success("已还原 stash")
+            # 查找指定名字的 stash
+            stash_list = Pindo::GitHandler.git!(%W(-C #{root_dir} stash list)).strip
+            matched_line = stash_list.lines.find { |l| l.include?(stash_name) }
+
+            if matched_line && (stash_id = matched_line.match(/(stash@\{\d+\})/)&.[](1))
+              # 先应用 stash（不删除）
+              Pindo::GitHandler.git!(%W(-C #{root_dir} stash apply #{stash_id}))
+              # 应用成功后再删除 stash
+              Pindo::GitHandler.git!(%W(-C #{root_dir} stash drop #{stash_id}))
+              Funlog.instance.fancyinfo_success("已还原 stash: #{stash_name} (#{stash_id})")
+            else
+              Funlog.instance.fancyinfo_warning("未找到名为 #{stash_name} 的 stash，请手动检查")
+            end
           rescue => e
             Funlog.instance.fancyinfo_warning("stash 还原时发生冲突: #{e.message}")
             Funlog.instance.fancyinfo_warning("stash 已保留，请手动执行 'git stash pop' 处理冲突")
@@ -168,6 +176,10 @@ module Pindo
           end
         end
 
+        
+        # 10. 显示主仓库和所有子仓库的 commit info
+        display_all_repos_commit_info(root_dir)
+
         {
           success: true,
           root_dir: root_dir,
@@ -176,39 +188,86 @@ module Pindo
         }
       end
 
-      # 构建任务参数（供其他任务使用）
-      def build_task_param
-        return {} unless @status == TaskStatus::SUCCESS
+      # ----------------------------------------------------
+      # 10. 显示主仓库和所有子仓库的 commit id 和 commit message
+      # ----------------------------------------------------
+      def display_all_repos_commit_info(root_dir)
+        Funlog.instance.fancyinfo_start("仓库及子模块 Commit 信息概览")
 
-        # 如果不是 Git 仓库，返回空参数（让依赖任务知道没有有效数据）
-        return {} if @build_version.nil? || @build_number.nil?
+        # 10.1 主仓库
+        begin
+          main_info = Pindo::GitHandler.git!(%W(-C #{root_dir} log -1 --format=%h|%s)).strip
+          main_id, main_msg = main_info.split('|', 2)
+          puts ""
+          puts "  [Main Repo] #{File.basename(root_dir)}".green
+          puts "  Commit: #{main_id} - #{main_msg}"
+        rescue => e
+          Funlog.instance.warning("获取主仓库信息失败: #{e.message}")
+        end
 
-        param = {
-          release_branch: @release_branch,
-          build_version: @build_version,
-          build_number: @build_number,
-          tag_pre: @tag_pre,
-          tag_type: @tag_type,
-          ver_inc: @ver_inc
-        }
+        # 10.2 子模块
+        begin
+          # 使用 git submodule status 获取列表，更可靠
+          submodule_status_output = Pindo::GitHandler.git!(%W(-C #{root_dir} submodule status --recursive)).strip
+          
+          unless submodule_status_output.empty?
+            puts ""
+            puts "  [Submodules]".yellow
+            submodule_status_output.each_line do |line|
+              # line format: " 923... path/to/sub (v1.2)" or "-..." for uninitialized
+              parts = line.strip.split(' ')
+              next if parts.length < 2
+              
+              clean_sha = parts[0].gsub(/^[-+U]/, '') # 去除状态前缀
+              short_sha = clean_sha[0..6]
+              sub_path = parts[1]
+              sub_abs_path = File.join(root_dir, sub_path)
+              
+              # 只有当目录存在且是 git 仓库时才尝试读取 log
+              if File.directory?(sub_abs_path) && File.exist?(File.join(sub_abs_path, '.git'))
+                begin
+                   # 使用 git show 指定 SHA 获取 message，避免 HEAD 指向不明的问题
+                   raw_msg = Pindo::GitHandler.git!(%W(-C #{sub_abs_path} show -s --format=%s #{clean_sha}))
+                   sub_msg = raw_msg.strip
+                   
+                   # 处理编码问题：将 ASCII-8BIT 转换为 UTF-8，无效字符替换为 ?
+                   if sub_msg.respond_to?(:force_encoding)
+                     sub_msg.force_encoding("UTF-8")
+                     unless sub_msg.valid_encoding?
+                       sub_msg = sub_msg.encode("UTF-8", "binary", invalid: :replace, undef: :replace, replace: "?")
+                     end
+                   end
 
-        # 添加 git commit 信息（供 JPSUploadMediaTask 等任务使用）
-        if @git_root_path
-          begin
-            # 获取当前 HEAD commit 信息
-            git_commit_info = Pindo::GitHandler.get_latest_conventional_commit(project_dir: @git_root_path)
-            if git_commit_info
-              param[:git_commit_id] = git_commit_info[:commit_id]
-              param[:git_commit_time] = git_commit_info[:commit_time]
-              param[:git_commit_desc] = git_commit_info[:commit_desc]
+                   puts "  • #{sub_path}: #{short_sha} - #{sub_msg}"
+                rescue => e
+                   # 如果获取 log 失败，显示错误原因
+                   puts "  • #{sub_path}: #{short_sha} (获取Message失败: #{e.message.strip})"
+                end
+              else
+                # 未初始化或其他情况
+                status_char = parts[0][0] # 获取状态字符 (+, -, U, space)
+                status_desc = case status_char
+                              when '-' then "未初始化"
+                              when '+' then "版本不一致"
+                              when 'U' then "合并冲突"
+                              else "目录或.git不存在"
+                              end
+                puts "  • #{sub_path}: #{short_sha} (#{status_desc})"
+              end
             end
-          rescue => e
-            # 如果获取失败，不影响主流程
-            Funlog.instance.fancyinfo_warning("获取 git commit 信息失败: #{e.message}") if ENV['PINDO_DEBUG']
           end
+        rescue => e
+          # 忽略子模块错误
+          # Funlog.instance.warning("获取子模块信息异常: #{e.message}")
         end
+        
+        puts ""
+        Funlog.instance.fancyinfo_success("Commit 信息展示完成")
+      end
 
-        param
+      # 在 do_work 结束前调用
+      def do_work_end_hook(root_dir)
+          display_all_repos_commit_info(root_dir)
       end
     end
   end

data/lib/pindo/module/task/model/git/git_tag_task.rb

@@ -7,9 +7,6 @@ module Pindo
     # Git 标签任务
     # 负责在构建成功后创建 Git 标签
     class GitTagTask < GitTask
-      attr_reader :release_branch, :ver_inc, :tag_type, :tag_pre
-      attr_reader :build_version, :build_number
-
       # 任务键
       def self.task_key
         :git_tag
@@ -29,15 +26,8 @@ module Pindo
       #   - tag_pre: tag前缀，默认 'v'
       # 注意：版本号从 GitCommitTask 获取（GitTagTask 必须依赖 GitCommitTask）
       def initialize(project_path, options = {})
-        @release_branch = options[:release_branch] || 'master'
-        @ver_inc = options[:ver_inc] || Pindo::VersionIncreaseType::MINI
-        @tag_type = options[:tag_type] || Pindo::CreateTagType::NEW
-        @tag_pre = options[:tag_pre] || 'v'
-
-        @build_version = nil
-        @build_number = nil
         options[:project_path] = project_path
-
+        # 调用基类初始化（基类会设置所有通用属性）
         super("Git仓库打Tag", options)
       end
 
@@ -62,14 +52,15 @@ module Pindo
         root_dir = @git_root_path
         git_repo_helper = Pindo::GitRepoHelper.share_instance
         stash_saved = false
+        stash_name = "pindo_stash_#{Time.now.strftime('%Y%m%d%H%M%S')}_#{rand(1000)}"
         coding_branch = Pindo::GitHandler.git!(%W(-C #{root_dir} rev-parse --abbrev-ref HEAD)).strip
 
         begin
           # 1. 检查工作目录，不干净则 stash
           status = Pindo::GitHandler.git!(%W(-C #{root_dir} status --porcelain)).strip
           unless status.empty?
-            Funlog.instance.fancyinfo_update("工作目录有未提交更改，暂存到 stash")
-            Pindo::GitHandler.git!(%W(-C #{root_dir} stash -u))
+            Funlog.instance.fancyinfo_update("工作目录有未提交更改，暂存到 stash: #{stash_name}")
+            Pindo::GitHandler.git!(%W(-C #{root_dir} stash push -u -m #{stash_name}))
             stash_saved = true
           end
 
@@ -98,14 +89,15 @@ module Pindo
 
           # 优先级 2: 自己计算（降级方案，用于向后兼容或 GitCommitTask 无有效数据）
           else
-            @build_number = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
+            @build_number, @commit_hash = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
             @build_version = git_repo_helper.calculate_build_version(
               project_dir: root_dir,
               tag_prefix: @tag_pre,
               create_tag_type: @tag_type,
               version_increase_type: @ver_inc
             )
-            Funlog.instance.fancyinfo_warning("未找到 GitCommitTask 依赖，降级为自己计算版本号: #{@build_version}")
+            commit_short = @commit_hash ? @commit_hash[0..7] : "unknown"
+            Funlog.instance.fancyinfo_warning("未找到 GitCommitTask 依赖，降级为自己计算版本号: #{@build_version}, Build: #{@build_number}, Commit: #{commit_short}")
           end
 
           # 4. 创建并推送 Tag
@@ -118,13 +110,22 @@ module Pindo
 
         ensure
           # 5. 还原 stash
+
           if stash_saved
             begin
-              # 先应用 stash（不删除）
-              Pindo::GitHandler.git!(%W(-C #{root_dir} stash apply))
-              # 应用成功后再删除 stash
-              Pindo::GitHandler.git!(%W(-C #{root_dir} stash drop))
-              Funlog.instance.fancyinfo_success("已还原 stash")
+              # 查找指定名字的 stash
+              stash_list = Pindo::GitHandler.git!(%W(-C #{root_dir} stash list)).strip
+              matched_line = stash_list.lines.find { |l| l.include?(stash_name) }
+
+              if matched_line && (stash_id = matched_line.match(/(stash@\{\d+\})/)&.[](1))
+                # 先应用 stash（不删除）
+                Pindo::GitHandler.git!(%W(-C #{root_dir} stash apply #{stash_id}))
+                # 应用成功后再删除 stash
+                Pindo::GitHandler.git!(%W(-C #{root_dir} stash drop #{stash_id}))
+                Funlog.instance.fancyinfo_success("已还原 stash: #{stash_name} (#{stash_id})")
+              else
+                Funlog.instance.fancyinfo_warning("未找到名为 #{stash_name} 的 stash，请手动检查")
+              end
             rescue => e
               # 如果应用失败（通常是有冲突），stash 仍然保留，用户可以手动处理
               Funlog.instance.fancyinfo_warning("stash 还原时发生冲突: #{e.message}")

data/lib/pindo/module/task/model/git_task.rb

@@ -1,5 +1,6 @@
 require 'pindo/module/task/pindo_task'
 require 'pindo/base/git_handler'
+require 'pindo/module/build/git_repo_helper'
 
 module Pindo
   module TaskSystem
@@ -7,10 +8,23 @@ module Pindo
     # 所有 Git 相关任务的父类，提供通用的 Git 操作和配置
     class GitTask < PindoTask
       attr_reader :project_path, :git_root_path
+      attr_reader :release_branch, :ver_inc, :tag_type, :tag_pre
+      attr_reader :build_version, :build_number, :commit_hash
 
       def initialize(name, options = {})
         @project_path = options[:project_path] ? File.expand_path(options[:project_path]) : nil
 
+        # Git 版本管理相关属性（子类可以覆盖默认值）
+        @release_branch = options[:release_branch] || 'master'
+        @ver_inc = options[:ver_inc] || Pindo::VersionIncreaseType::MINI
+        @tag_type = options[:tag_type] || Pindo::CreateTagType::NEW
+        @tag_pre = options[:tag_pre] || 'v'
+
+        # 版本信息（由子类在 do_work 中赋值）
+        @build_version = nil
+        @build_number = nil
+        @commit_hash = nil
+
         # 通过 project_path 获取 git_root_path
         @git_root_path = @project_path ? Pindo::GitHandler.git_root_directory(local_repo_dir: @project_path) : nil
 
@@ -76,6 +90,41 @@ module Pindo
         return nil unless @git_root_path
         Pindo::GitHandler.git!(%W(-C #{@git_root_path} rev-parse --abbrev-ref HEAD)).strip
       end
+
+      # 构建任务参数（供其他任务使用）
+      def build_task_param
+        return {} unless @status == TaskStatus::SUCCESS
+
+        # 如果不是 Git 仓库，返回空参数（让依赖任务知道没有有效数据）
+        return {} if @build_version.nil? || @build_number.nil?
+
+        param = {
+          release_branch: @release_branch,
+          build_version: @build_version,
+          build_number: @build_number,
+          tag_pre: @tag_pre,
+          tag_type: @tag_type,
+          ver_inc: @ver_inc
+        }
+
+        # 添加 git commit 信息（供 JPSUploadMediaTask 等任务使用）
+        if @git_root_path
+          begin
+            # 获取当前 HEAD commit 信息
+            git_commit_info = Pindo::GitHandler.get_latest_conventional_commit(project_dir: @git_root_path)
+            if git_commit_info
+              param[:git_commit_id] = git_commit_info[:commit_id]
+              param[:git_commit_time] = git_commit_info[:commit_time]
+              param[:git_commit_desc] = git_commit_info[:commit_desc]
+            end
+          rescue => e
+            # 如果获取失败，不影响主流程
+            Funlog.instance.fancyinfo_warning("获取 git commit 信息失败: #{e.message}") if ENV['PINDO_DEBUG']
+          end
+        end
+
+        param
+      end
     end
   end
 end

data/lib/pindo/module/task/model/jps/jps_bind_package_task.rb

@@ -210,16 +210,19 @@ module Pindo
 
       # 从依赖任务获取或自动获取 git commit 信息
       def fetch_git_commit_info
-        # 1. 首先尝试从 GitCommitTask 依赖任务获取
-        git_commit_data = get_data_param_by_key(:git_commit)
-        if git_commit_data && git_commit_data[:task_param]
-          param = git_commit_data[:task_param]
+        # 1. 优先从 GitTagTask 依赖任务获取（打 tag 后的 commit 信息更准确）
+        git_data = get_data_param_by_key(:git_tag)
+        # 2. 降级到 GitCommitTask
+        git_data = get_data_param_by_key(:git_commit) if git_data.nil? || git_data.empty?
+
+        if git_data && git_data[:task_param]
+          param = git_data[:task_param]
           @git_commit_id = param[:git_commit_id] if param[:git_commit_id]
           @git_commit_time = param[:git_commit_time] if param[:git_commit_time]
           @git_commit_desc = param[:git_commit_desc] if param[:git_commit_desc]
         end
 
-        # 2. 如果依赖任务没有提供，且指定了 project_dir，使用自动获取
+        # 3. 如果依赖任务都没有提供，且指定了 project_dir，使用自动获取
         if (@git_commit_id.nil? || @git_commit_id.empty?) && @project_dir
           # 查找 git 仓库根目录
           git_root = Pindo::GitHandler.git_root_directory(local_repo_dir: @project_dir)

data/lib/pindo/module/task/model/jps/jps_upload_media_task.rb

@@ -97,17 +97,20 @@ module Pindo
 
         # 2. 如果没有提供 git_commit_id，尝试从依赖任务获取或自动获取
         if @git_commit_id.nil? || @git_commit_id.empty?
-          # 2.1 首先尝试从 GitCommitTask 依赖任务获取
-          git_commit_data = get_data_param_by_key(:git_commit)
-          if git_commit_data && git_commit_data[:task_param]
-            param = git_commit_data[:task_param]
+          # 2.1 优先从 GitTagTask 依赖任务获取（打 tag 后的 commit 信息更准确）
+          git_data = get_data_param_by_key(:git_tag)
+          # 2.2 降级到 GitCommitTask
+          git_data = get_data_param_by_key(:git_commit) if git_data.nil? || git_data.empty?
+
+          if git_data && git_data[:task_param]
+            param = git_data[:task_param]
             # 尝试从 task_param 获取 commit 信息
             @git_commit_id = param[:git_commit_id] if param[:git_commit_id]
             @git_commit_time = param[:git_commit_time] if param[:git_commit_time]
             @git_commit_desc = param[:git_commit_desc] if param[:git_commit_desc]
           end
 
-          # 2.2 如果依赖任务没有提供，使用 get_latest_conventional_commit
+          # 2.3 如果依赖任务都没有提供，使用 get_latest_conventional_commit
           if @git_commit_id.nil? || @git_commit_id.empty?
             git_info = Pindo::GitHandler.get_latest_conventional_commit(project_dir: git_root)
             @git_commit_id = git_info[:commit_id]
@@ -291,7 +294,7 @@ module Pindo
             FileUtils.mkdir_p(backup_dir) unless Dir.exist?(backup_dir)
 
             # 移动文件
-            file_name = File.basename(file_path)
+            file_name = File.basename(file_path).force_encoding('UTF-8').scrub('')
             dest_path = File.join(backup_dir, file_name)
 
             # 如果目标文件已存在，添加序号避免覆盖
@@ -388,11 +391,12 @@ module Pindo
         puts ""
         files.each_with_index do |file, index|
           size_str = format_file_size(File.size(file))
-          file_name = File.basename(file)
+          file_name = File.basename(file).force_encoding('UTF-8').scrub('')
           # 对齐：序号（3位） + 文件名（左对齐） + 大小（右对齐）
           puts "     \e[90m#{(index + 1).to_s.rjust(2)}.\e[0m  %-40s  \e[33m%8s\e[0m" % [file_name, size_str]
           if debug_mode
-            puts "          \e[90m路径: #{file}\e[0m"
+            safe_path = file.force_encoding('UTF-8').scrub('')
+            puts "          \e[90m路径: #{safe_path}\e[0m"
           end
         end
         puts ""
@@ -419,7 +423,7 @@ module Pindo
         failed_files = []
 
         files.each_with_index do |file, index|
-          file_name = File.basename(file)
+          file_name = File.basename(file).force_encoding('UTF-8').scrub('')
 
           # 显示进度（简洁模式）
           progress = "#{index + 1}/#{files.size}"
@@ -430,7 +434,10 @@ module Pindo
             # MacCompressCliTool 的 -f 参数需要一个包含文件路径列表的文本文件
             file_list_path = File.join(compress_dir, "file_list_#{index}.txt")
             File.open(file_list_path, 'w:UTF-8') do |f|
-              f.puts(file)
+              # 强制将文件路径转换为 UTF-8 编码，处理无效字符
+              # 避免 "incompatible character encodings: UTF-8 and BINARY" 错误
+              safe_path = file.force_encoding('UTF-8').scrub('')
+              f.puts(safe_path)
             end
 
             # 调用压缩工具: compress-cli -s -f file_list.txt -o output_dir/
@@ -441,7 +448,8 @@ module Pindo
 
             if debug_mode
               puts ""
-              puts "          \e[90m完整路径: #{file}\e[0m"
+              safe_file = file.force_encoding('UTF-8').scrub('')
+              puts "          \e[90m完整路径: #{safe_file}\e[0m"
               puts "          \e[90m文件列表: #{file_list_path}\e[0m"
               puts "          \e[90m执行命令: #{cmd}\e[0m"
               print "     "
@@ -494,7 +502,7 @@ module Pindo
               if all_files.empty?
                 puts "     \e[90m（目录为空）\e[0m"
               else
-                all_files.each { |f| puts "     \e[90m- #{File.basename(f)}\e[0m" }
+                all_files.each { |f| puts "     \e[90m- #{File.basename(f).force_encoding('UTF-8').scrub('')}\e[0m" }
               end
             else
               puts "     \e[90m（目录不存在）\e[0m"
@@ -529,7 +537,7 @@ module Pindo
           puts ""
           puts "     \e[31m失败文件 (#{failed_files.size}):\e[0m"
           failed_files.each do |f|
-            puts "       \e[31m✗\e[0m #{File.basename(f)}"
+            puts "       \e[31m✗\e[0m #{File.basename(f).force_encoding('UTF-8').scrub('')}"
           end
         end
 

data/lib/pindo/module/task/model/jps/jps_workflow_message_task.rb

@@ -93,11 +93,15 @@ module Pindo
 
       # 从依赖任务获取数据
       def fetch_data_from_dependencies
-        # 1. 从 GitCommitTask 获取 commit 信息
+        # 1. 获取 commit 信息（优先从 GitTagTask，降级到 GitCommitTask）
         if @git_commit_id.nil?
-          git_commit_data = get_data_param_by_key(:git_commit)
-          if git_commit_data && git_commit_data[:task_param]
-            param = git_commit_data[:task_param]
+          # 1.1 优先从 GitTagTask 依赖任务获取（打 tag 后的 commit 信息更准确）
+          git_data = get_data_param_by_key(:git_tag)
+          # 1.2 降级到 GitCommitTask
+          git_data = get_data_param_by_key(:git_commit) if git_data.nil? || git_data.empty?
+
+          if git_data && git_data[:task_param]
+            param = git_data[:task_param]
             @git_commit_id = param[:git_commit_id] if param[:git_commit_id]
             @git_commit_time = param[:git_commit_time] if param[:git_commit_time]
             @git_commit_desc = param[:git_commit_desc] if param[:git_commit_desc]

data/lib/pindo/module/task/model/resign/ipa_local_resign_task.rb

@@ -13,6 +13,11 @@ module Pindo
         :resign
       end
 
+      # 任务键
+      def self.task_key
+        :ipa_local_resign
+      end
+
       # 任务类型显示名称
       def self.task_type_name
         "重签名"

data/lib/pindo/options/core/option_item.rb

@@ -154,11 +154,10 @@ module Pindo
 
       # 构建描述文本（描述 + 环境变量）
       def build_description_text
-        if @env_name
-          "#{@description} (环境变量: #{@env_name})"
-        else
-          @description
-        end
+        desc = @description.dup
+        desc += " (环境变量: #{@env_name})" if @env_name
+        desc += " 示例: #{@example}" if @example && !@example.to_s.strip.empty?
+        desc
       end
 
       # 类型转换为提示字符串