pindo 5.14.4 → 5.14.6

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

@@ -0,0 +1,233 @@
+require 'pindo/module/task/model/jps_task'
+require 'pindo/module/task/task_config'
+require 'pindo/module/pgyer/pgyerhelper'
+require 'pindo/base/git_handler'
+
+module Pindo
+  module TaskSystem
+    # JPS 绑定包任务
+    # 将 Git commit 绑定到已上传的项目包（支持批量绑定）
+    #
+    # 支持两种模式：
+    # 1. 指定模式：传入 git_commit_id 和 app_version_list
+    # 2. 依赖模式：从依赖任务（GitCommitTask、JPSUploadTask）获取信息
+    class JPSBindPackageTask < JPSTask
+      attr_reader :git_commit_id, :git_commit_time, :git_commit_desc
+      attr_reader :app_version_list
+
+      # 任务键
+      def self.task_key
+        :jps_bind_package
+      end
+
+      # 初始化绑定包任务
+      # @param app_version_list [Array<Hash>, nil] 应用版本信息列表（可选，如为 nil 则从依赖任务获取）
+      # @param options [Hash] 选项
+      # @option options [String] :git_commit_id Git commit SHA（可选，为空时从依赖任务获取）
+      # @option options [String] :git_commit_time Git commit 时间（可选）
+      # @option options [String] :git_commit_desc Git commit 描述（可选）
+      # @option options [String] :project_dir 项目目录（可选，用于自动获取 commit 信息）
+      # @option options [Hash] :app_info_obj JPS 应用信息对象（可选，继承自基类）
+      # @option options [Hash] :workflow_info 工作流信息（可选，继承自基类）
+      # @option options [String] :project_name 项目名称（可选，继承自基类）
+      def initialize(app_version_list = nil, options = {})
+        # 兼容性处理：如果传入的是单个 Hash，转为数组
+        if app_version_list.is_a?(Hash)
+          @app_version_list = [app_version_list]
+        elsif app_version_list.is_a?(Array)
+          @app_version_list = app_version_list
+        else
+          @app_version_list = nil
+        end
+
+        @git_commit_id = options[:git_commit_id]
+        @git_commit_time = options[:git_commit_time]
+        @git_commit_desc = options[:git_commit_desc]
+        @project_dir = options[:project_dir]
+
+        # 设置任务优先级为 LOW，确保在上传任务之后执行
+        options[:priority] ||= TaskPriority::LOW
+
+        super("绑定 包到Git工作流", options)
+      end
+
+      def validate
+        # app_version_list 和 git_commit_id 可以延迟获取，不在这里验证
+        true
+      end
+
+      # 绑定任务重试配置
+      def self.default_retry_mode
+        RetryMode::DELAYED
+      end
+
+      def self.default_retry_count
+        2  # 绑定任务重试 2 次
+      end
+
+      def self.default_retry_delay
+        3  # 延迟 3 秒
+      end
+
+      protected
+
+      # 构建任务参数（供其他任务使用）
+      def build_task_param
+        return {} unless @status == TaskStatus::SUCCESS && @result
+
+        {
+          git_commit_id: @git_commit_id,
+          app_version_list: @app_version_list,
+          bind_success: @result[:success],
+          bound_package_ids: @result[:bound_package_ids]
+        }
+      end
+
+      def do_work
+        puts ""
+        puts "  📦 开始绑定 Git Commit 到项目包..."
+
+        # 1. 如果没有提供 app_version_list，从依赖任务获取
+        if @app_version_list.nil? || @app_version_list.empty?
+          fetch_app_version_from_dependencies
+        end
+
+        # 验证 app_version_list
+        if @app_version_list.nil? || @app_version_list.empty?
+          raise "无法获取 app_version_list，请确保传入参数或添加 JPSUploadTask 依赖"
+        end
+
+        # 2. 如果没有提供 git_commit_id，从依赖任务获取或自动获取
+        if @git_commit_id.nil? || @git_commit_id.empty?
+          fetch_git_commit_info
+        end
+
+        # 验证 git_commit_id
+        if @git_commit_id.nil? || @git_commit_id.empty?
+          raise "无法获取 git_commit_id，请确保传入参数或添加 GitCommitTask 依赖"
+        end
+
+        # 3. 提取所有 project_package_ids
+        project_package_ids = @app_version_list.map { |pkg| pkg["id"] }.compact
+        if project_package_ids.empty?
+          raise "app_version_list 中的包都缺少 id 字段"
+        end
+
+        # 4. 打印绑定信息
+        puts ""
+        puts "  📝 绑定信息："
+        puts "     Git Commit: #{@git_commit_id[0..7]}"
+        puts "     包数量: #{project_package_ids.size} 个"
+        @app_version_list.each do |pkg|
+          package_type = pkg['nativePackageType'] || pkg['originalType'] || 'unknown'
+          puts "     [#{package_type}] ID: #{pkg['id']}, Version: #{pkg['projectVersion']}, Build: #{pkg['build']}"
+        end
+        if @git_commit_desc
+          puts "     Commit Desc: #{@git_commit_desc}"
+        end
+        if @git_commit_time
+          puts "     Commit Time: #{@git_commit_time}"
+        end
+        puts ""
+
+        # 5. 确保 PgyerHelper 已登录
+        pgyer_helper = PgyerHelper.share_instace
+        unless pgyer_helper.login
+          raise "无法登录 JPS，请检查配置"
+        end
+
+        # 6. 获取工作流 ID
+        workflow_id = @workflow_info&.dig(:workflow_id) || @workflow_info&.dig('id')
+        unless workflow_id
+          raise "缺少 workflow_info，无法获取 workflow_id"
+        end
+
+        # 7. 获取工作流中已绑定的包 ID
+        existing_bound_ids = pgyer_helper.get_workflow_bound_package_ids(workflow_id: workflow_id)
+
+        if existing_bound_ids.any?
+          puts "  📋 工作流中已绑定的包: #{existing_bound_ids.size} 个"
+        end
+
+        # 8. 合并已绑定的包 ID 和新的包 ID（去重）
+        merged_package_ids = (existing_bound_ids + project_package_ids).uniq
+
+        puts "  📦 合并后的包 ID 数量: #{merged_package_ids.size} 个"
+        if merged_package_ids.size > project_package_ids.size
+          puts "     └─ 新增: #{project_package_ids.size} 个"
+          puts "     └─ 已存在: #{existing_bound_ids.size} 个"
+        end
+        puts ""
+
+        # 9. 批量绑定所有包
+        Funlog.instance.fancyinfo_start("正在绑定 #{merged_package_ids.size} 个项目包...")
+
+        bind_result = pgyer_helper.bind_commit_to_package(
+          commit_id: @git_commit_id,
+          project_package_ids: merged_package_ids
+        )
+
+        if bind_result[:success]
+          Funlog.instance.fancyinfo_success("绑定成功！")
+          puts ""
+
+          {
+            success: true,
+            git_commit_id: @git_commit_id,
+            bound_package_ids: merged_package_ids,  # 返回合并后的包 ID 列表
+            app_version_list: @app_version_list
+          }
+        else
+          if ENV['PINDO_DEBUG']
+            puts "[PINDO_DEBUG] bind_commit_to_package 返回结果: #{bind_result.inspect}"
+            puts "[PINDO_DEBUG] git_commit_id: #{@git_commit_id}"
+            puts "[PINDO_DEBUG] project_package_ids: #{project_package_ids.inspect}"
+          end
+
+          raise "绑定失败: #{bind_result[:error]}"
+        end
+      end
+
+      private
+
+      # 从依赖任务获取 app_version_list
+      def fetch_app_version_from_dependencies
+        # 获取所有 JPSUploadTask 的数据（可能有多个平台的上传任务）
+        all_upload_data = get_all_data_params_by_key(:jps_upload)
+
+        @app_version_list = []
+
+        # 遍历所有上传任务，收集 app_version_info
+        all_upload_data.each do |upload_data|
+          if upload_data[:task_param] && upload_data[:task_param][:app_version_info]
+            @app_version_list << upload_data[:task_param][:app_version_info]
+          end
+        end
+      end
+
+      # 从依赖任务获取或自动获取 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]
+          @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，使用自动获取
+        if (@git_commit_id.nil? || @git_commit_id.empty?) && @project_dir
+          # 查找 git 仓库根目录
+          git_root = Pindo::GitHandler.git_root_directory(local_repo_dir: @project_dir)
+          if git_root
+            git_info = Pindo::GitHandler.get_latest_conventional_commit(project_dir: git_root)
+            @git_commit_id = git_info[:commit_id]
+            @git_commit_time = git_info[:commit_time]
+            @git_commit_desc = git_info[:commit_desc]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -27,7 +27,7 @@ module Pindo
         # 消息发送任务优先级为 LOW，确保在上传任务之后执行
         options[:priority] ||= TaskPriority::LOW
 
-        super("JPS 消息发送", options)
+        super("JPS 发送包的消息", options)
       end
 
       def validate
@@ -71,11 +71,14 @@ module Pindo
           # 1. 打印应用版本信息（失败只警告，不中断）
           print_version_info(pgyer_helper)
 
-          # 2. 发送消息给自己（失败只警告，不中断）
-          send_message_to_self(pgyer_helper)
-
-          # 3. 如果消息类型为 group，发送到测试群（失败只警告，不中断）
-          send_message_to_group(pgyer_helper) if @send_message_type == 'group'
+          # 2. 根据消息类型发送消息（失败只警告，不中断）
+          if @send_message_type == 'group'
+            # 发送到测试群
+            send_message_to_group(pgyer_helper)
+          else
+            # 发送消息给自己
+            send_message_to_self(pgyer_helper)
+          end
 
           puts "  ✅ JPS 消息发送全部完成\n"
 

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

@@ -7,22 +7,27 @@ module Pindo
     # JPS 重签名任务
     # 从 JPS 平台下载应用并使用指定证书重签名
     class JPSResignTask < JPSTask
-      attr_reader :version_info, :cert_id, :send_flag
+      attr_reader :version_info, :cert_id
 
       # 重试配置（降低重试次数）
       def self.default_retry_count
         2  # 默认可以重试 2 次
       end
 
+      # 任务键
+      def self.task_key
+        :jps_resign
+      end
+
       # 初始化 JPS 重签名任务
       # @param options [Hash] 选项
       # @option options [Hash] :app_info_obj JPS 应用信息对象（可选，如为 nil 则延迟获取）
       # @option options [String] :project_name 项目名称（可选）
       # @option options [String] :cert_id 重签名使用的 Bundle ID（可选，nil 表示交互选择）
-      # @option options [Boolean] :send_flag 是否发送到测试群（默认 false，始终会发送给自己）
+      # @option options [Boolean] :list_flag 是否列出历史版本（默认 false）
       def initialize(options = {})
         @cert_id = options[:cert_id]
-        @send_flag = options[:send_flag] || false
+        @list_flag = options[:list_flag] || false
         @version_info = nil
 
         # 设置重签名任务的优先级为 LOW，确保在上传任务之后执行
@@ -38,6 +43,16 @@ module Pindo
 
       protected
 
+      # 构建任务参数（供其他任务使用）
+      def build_task_param
+        return {} unless @status == TaskStatus::SUCCESS && @version_info
+
+        {
+          app_version_info: @version_info,
+          cert_id: @cert_id
+        }
+      end
+
       def do_work
         pgyer_helper = PgyerHelper.share_instace
 
@@ -49,7 +64,7 @@ module Pindo
         # 2. 获取要重签名的版本
         @version_info = pgyer_helper.get_versioon_history_item(
           app_info_obj: @app_info_obj,
-          list_select_flat: false
+          list_select_flat: @list_flag  # 使用 list_flag
         )
 
         if @version_info.nil?
@@ -99,23 +114,7 @@ module Pindo
           app_version_info_obj: @version_info
         )
 
-        # 8. 发送消息给自己
-        pgyer_helper.send_apptest_msg(
-          app_info_obj: @app_info_obj,
-          app_version_info_obj: @version_info,
-          receiveType: "self"
-        )
-
-        # 9. 如果需要发送到测试群
-        if @send_flag
-          pgyer_helper.send_apptest_msg(
-            app_info_obj: @app_info_obj,
-            app_version_info_obj: @version_info,
-            chatEnv: "DevTest",
-            receiveType: "chat"
-          )
-        end
-
+        # 8. 返回结果（消息发送由外部任务处理）
         {
           success: true,
           version_info: @version_info,

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

@@ -43,7 +43,7 @@ module Pindo
         # 设置任务优先级为 LOW，确保在其他任务之后执行
         options[:priority] ||= TaskPriority::LOW
 
-        name = "上传 Media 附件"
+        name = "上传 工作流的图片/视频"
 
         super(name, options)
       end
@@ -90,17 +90,30 @@ module Pindo
 
       def do_work
         # 1. 查找 git 仓库根目录
-        git_root = find_git_root(@upload_path)
+        git_root = Pindo::GitHandler.git_root_directory(local_repo_dir: @upload_path)
         unless git_root
           raise "未找到 git 仓库，请确保 upload_path 在 git 仓库内"
         end
 
-        # 2. 如果没有提供 git_commit_id，获取最新的符合规范的 commit
+        # 2. 如果没有提供 git_commit_id，尝试从依赖任务获取或自动获取
         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]
-          @git_commit_time = git_info[:commit_time]
-          @git_commit_desc = git_info[:commit_desc]
+          # 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]
+            # 尝试从 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
+          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]
+            @git_commit_time = git_info[:commit_time]
+            @git_commit_desc = git_info[:commit_desc]
+          end
         end
 
         # 验证 git_commit_id
@@ -110,8 +123,8 @@ module Pindo
 
         # 3. 打印 git commit 信息
         puts ""
-        puts "  📝 Commit: #{@git_commit_desc}" if @git_commit_desc
         puts "     ID: #{@git_commit_id[0..7]}"
+        puts "  📝 Commit: #{@git_commit_desc}" if @git_commit_desc
         puts "     Time: #{@git_commit_time}" if @git_commit_time
         puts ""
 
@@ -124,6 +137,9 @@ module Pindo
           @file_paths = expand_file_paths(@file_paths)
         end
 
+        # 保存源文件列表（用于上传成功后归档）
+        original_source_files = @file_paths.dup
+
         # 5. 自动压缩文件（如果有文件需要上传）
         if @file_paths.any?
           @file_paths = compress_media_files(@file_paths, git_root)
@@ -171,6 +187,13 @@ module Pindo
           # 上传成功后，将重试次数设为 0
           @retry_count = 0
 
+          # 8. 上传成功后，将源文件移动到备份目录
+          # 移动的是压缩前的原始文件，而不是压缩后的临时文件
+          # 这样可以避免下次编译时重复压缩和上传
+          if original_source_files.any?
+            move_uploaded_files_to_backup(original_source_files)
+          end
+
           {
             success: true,
             success_urls: upload_result[:success_urls],
@@ -192,20 +215,6 @@ module Pindo
 
       private
 
-      # 查找 git 仓库根目录
-      # @param path [String] 起始路径
-      # @return [String, nil] git 仓库根目录路径，未找到返回 nil
-      def find_git_root(path)
-        current = File.expand_path(path)
-        while current != '/'
-          if File.exist?(File.join(current, '.git'))
-            return current
-          end
-          current = File.dirname(current)
-        end
-        nil
-      end
-
       # 展开文件路径（支持通配符和目录）
       # 自动过滤 3 小时以内的文件，超过 3 小时的文件归档
       # @param paths [Array<String>] 原始路径列表
@@ -248,6 +257,30 @@ module Pindo
 
         puts "  📦 归档 #{files.size} 个超时文件 → JPSMedia/#{backup_dir_name}/"
 
+        move_files_to_backup(files, backup_dir_name)
+      end
+
+      # 将已上传文件移动到备份目录
+      # @param files [Array<String>] 要移动的文件列表
+      def move_uploaded_files_to_backup(files)
+        return if files.empty?
+
+        # 备份目录名：backup_YYYY-MM-DD_HHMMSS
+        backup_dir_name = "backup_#{Time.now.strftime('%Y-%m-%d_%H%M%S')}"
+
+        puts ""
+        puts "  📦 归档 #{files.size} 个已上传文件 → JPSMedia/#{backup_dir_name}/"
+        puts ""
+
+        move_files_to_backup(files, backup_dir_name)
+      end
+
+      # 移动文件到备份目录（通用方法）
+      # @param files [Array<String>] 要移动的文件列表
+      # @param backup_dir_name [String] 备份目录名称
+      def move_files_to_backup(files, backup_dir_name)
+        return if files.empty?
+
         files.each do |file_path|
           begin
             # 在文件所在目录下创建备份子目录
@@ -278,6 +311,8 @@ module Pindo
             puts "     ✗ #{file_name} - #{e.message}"
           end
         end
+
+        puts ""
       end
 
       # 在 JPSMedia 目录下查找 media 文件（仅查找根目录，不递归子目录）

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

@@ -34,13 +34,13 @@ module Pindo
 
         name = case file_type
                when 'ipa'
-                 "上传 IPA"
+                 "上传 IPA包"
                when 'apk'
-                 "上传 APK"
+                 "上传 APK包"
                when 'html'
-                 "上传 WebGL"
+                 "上传 WebGL包"
                when 'app'
-                 "上传 macOS App"
+                 "上传 macOS App包"
                else
                  "上传 #{file_type.upcase}"
                end

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

@@ -0,0 +1,190 @@
+require 'pindo/module/task/model/jps_task'
+require 'pindo/module/task/task_config'
+require 'pindo/module/pgyer/pgyerhelper'
+
+module Pindo
+  module TaskSystem
+    # JPS 工作流消息发送任务
+    # 使用 commit_log/send_message 接口发送 Git commit 消息到工作流
+    class JPSWorkFlowMessageTask < JPSTask
+      attr_reader :git_commit_id, :git_commit_time, :git_commit_desc
+      attr_reader :project_id, :workflow_id, :branch
+
+      # 任务键
+      def self.task_key
+        :jps_workflow_message
+      end
+
+      # 初始化工作流消息发送任务
+      # @param options [Hash] 选项
+      # @option options [String] :git_commit_id Git commit SHA（可选，从依赖任务获取）
+      # @option options [String] :git_commit_time Git commit 时间（可选）
+      # @option options [String] :git_commit_desc Git commit 描述（可选）
+      # @option options [String] :project_id 项目 ID（可选，从 app_info_obj 获取）
+      # @option options [Integer] :workflow_id 工作流 ID（可选，从 workflow_info 获取）
+      # @option options [String] :branch 分支名（可选，默认 'master'）
+      # @option options [Boolean] :single 是否单个提交（默认 true）
+      # @option options [Hash] :app_info_obj JPS 应用信息对象（可选，用于获取 project_id）
+      # @option options [Hash] :workflow_info 工作流信息（可选，用于获取 workflow_id）
+      def initialize(options = {})
+        @git_commit_id = options[:git_commit_id]
+        @git_commit_time = options[:git_commit_time]
+        @git_commit_desc = options[:git_commit_desc]
+        @project_id = options[:project_id]
+        @workflow_id = options[:workflow_id]
+        @branch = options[:branch] || 'master'
+        @single = options.fetch(:single, true)
+
+        # 消息发送任务优先级为 LOW，确保在其他任务之后执行
+        options[:priority] ||= TaskPriority::LOW
+
+        super("JPS 发送工作流消息", options)
+      end
+
+      def validate
+        # 参数可以从依赖任务获取，这里不做严格验证
+        true
+      end
+
+      protected
+
+      def do_work
+        puts "\n  📋 开始发送 JPS 工作流消息..."
+
+        begin
+          # 1. 如果没有提供参数，从依赖任务获取
+          fetch_data_from_dependencies if need_fetch_dependencies?
+
+          # 2. 验证必需参数
+          validate_required_params!
+
+          # 3. 发送消息
+          send_workflow_message
+
+          puts "  ✅ JPS 工作流消息发送完成\n"
+
+          {
+            success: true,
+            git_commit_id: @git_commit_id,
+            project_id: @project_id,
+            workflow_id: @workflow_id
+          }
+        rescue => e
+          # 外层错误保护：消息发送失败不应影响整体流程
+          puts "  ⚠️  JPS 工作流消息发送发生错误: #{e.message}"
+          puts "  ⚠️  错误堆栈: #{e.backtrace.first(3).join("\n           ")}" if ENV['PINDO_DEBUG'] && e.backtrace
+          puts "  ℹ️  消息发送失败不影响主流程\n"
+
+          # 消息发送失败不抛出异常，返回成功但带警告
+          {
+            success: true,
+            warning: e.message,
+            git_commit_id: @git_commit_id
+          }
+        end
+      end
+
+      private
+
+      # 判断是否需要从依赖任务获取数据
+      def need_fetch_dependencies?
+        @git_commit_id.nil? || @project_id.nil? || @workflow_id.nil?
+      end
+
+      # 从依赖任务获取数据
+      def fetch_data_from_dependencies
+        # 1. 从 GitCommitTask 获取 commit 信息
+        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]
+            @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
+        end
+
+        # 2. 从 JPSUploadTask 获取 project_id 和 workflow_id
+        if @project_id.nil? || @workflow_id.nil?
+          upload_data = get_data_param_by_key(:jps_upload)
+          if upload_data && upload_data[:task_param]
+            param = upload_data[:task_param]
+
+            # 从 app_info_obj 获取 project_id
+            if @project_id.nil? && param[:app_info_obj]
+              @project_id = param[:app_info_obj]["id"] || param[:app_info_obj][:id]
+            end
+
+            # 从 workflow_info 获取 workflow_id
+            if @workflow_id.nil? && param[:workflow_info]
+              @workflow_id = param[:workflow_info]["id"] ||
+                             param[:workflow_info][:id] ||
+                             param[:workflow_info]["workflow_id"] ||
+                             param[:workflow_info][:workflow_id]
+            end
+          end
+        end
+
+        # 3. 如果还没有，尝试从 app_info_obj 和 workflow_info（基类属性）获取
+        if @project_id.nil? && @app_info_obj
+          @project_id = @app_info_obj["id"] || @app_info_obj[:id]
+        end
+
+        if @workflow_id.nil? && @workflow_info
+          @workflow_id = @workflow_info["id"] ||
+                         @workflow_info[:id] ||
+                         @workflow_info["workflow_id"] ||
+                         @workflow_info[:workflow_id]
+        end
+      end
+
+      # 验证必需参数
+      def validate_required_params!
+        missing_params = []
+        missing_params << "git_commit_id" if @git_commit_id.nil? || @git_commit_id.empty?
+        missing_params << "project_id" if @project_id.nil? || @project_id.empty?
+        missing_params << "workflow_id" if @workflow_id.nil?
+
+        unless missing_params.empty?
+          raise "缺少必需参数: #{missing_params.join(', ')}"
+        end
+      end
+
+      # 发送工作流消息
+      def send_workflow_message
+        puts "  📨 发送工作流消息..."
+        puts "     Project ID: #{@project_id}"
+        puts "     Workflow ID: #{@workflow_id}"
+        puts "     Commit ID: #{@git_commit_id[0..7]}" if @git_commit_id
+        puts "     Branch: #{@branch}"
+        puts ""
+
+        pgyer_helper = PgyerHelper.share_instace
+
+        # 确保已登录
+        unless pgyer_helper.login
+          raise "无法登录 JPS，请检查配置"
+        end
+
+        # 使用 PgyerHelper 的便捷方法发送工作流消息
+        result = pgyer_helper.send_workflow_message(
+          project_id: @project_id,
+          workflow_id: @workflow_id,
+          commit_id: @git_commit_id,
+          branch: @branch,
+          single: @single
+        )
+
+        if result[:success]
+          puts "  ✓ 工作流消息发送成功"
+        else
+          if ENV['PINDO_DEBUG']
+            puts "[PINDO_DEBUG] send_workflow_message 返回结果: #{result.inspect}"
+          end
+
+          raise "工作流消息发送失败: #{result[:error]}"
+        end
+      end
+    end
+  end
+end