pindo 5.14.4 → 5.14.6

data/lib/pindo/command/web/autobuild.rb

@@ -33,33 +33,55 @@ module Pindo
 
                 # 命令的详细说明,包含用法示例
                 self.description = <<-DESC
-                    编译WebGL包并支持上传到测试平台。
+                    编译WebGL包并支持上传到JPS测试平台。
 
-                    支持功能:
+                    参数优先级说明（从低到高）:
+
+                        1. 无参数：
+                           - Git 提交 → 打 Git Tag → 编译 WebGL → 检查输出
+
+                        2. --upload：
+                           - 在基础流程上增加：上传 WebGL → 发送消息给自己
+
+                        3. --media：
+                           - 自动启用 --upload
+                           - 在 --upload 基础上增加：上传媒体附件（JPSMedia/ 目录）
 
-                        * 编译Debug包
+                        4. --bind：
+                           - 自动启用 --media 和 --upload
+                           - 在 --media 基础上增加：绑定 Git commit 到已上传的包
 
-                        * 上传到测试平台
+                        5. --send：
+                           - 自动启用 --bind、--media 和 --upload
+                           - 在 --bind 基础上增加：发送工作流消息到测试群
 
-                        * 发送测试通知
+                    支持功能:
 
+                        * 编译 Unity WebGL 包
+                        * 上传到 JPS 测试平台
+                        * 上传媒体附件（图片、视频）
+                        * 绑定 Git commit 到已上传的包
+                        * 发送测试通知（自己/测试群）
+                        * 支持本地预览（使用 --run 参数）
                         * 支持并发任务执行（使用 --multi 参数）
 
                     使用示例:
 
-                        $ pindo web autobuild                    # 编译Debug包
+                        $ pindo web autobuild --proj="My App"           # 指定项目名称
+
+                        $ pindo web autobuild                           # 编译、打tag
 
-                        $ pindo web autobuild --upload           # 编译并上传
+                        $ pindo web autobuild --upload                  # 编译、打tag、上传、发上传消息
 
-                        $ pindo web autobuild --proj=myapp       # 指定项目名称
+                        $ pindo web autobuild --media                   # 编译、打tag、上传、发上传消息、上传媒体附件
 
-                        $ pindo web autobuild --media            # 编译、上传并上传媒体附件
+                        $ pindo web autobuild --bind                    # 编译、打tag、上传、发上传消息、上传媒体附件 + 绑定包到工作流
 
-                        $ pindo web autobuild --run              # 编译完成后再本地打开webgl包
+                        $ pindo web autobuild --send                    # 编译、打tag、上传、发上传消息、上传媒体附件、绑定包到工作流 + 发送群消息
 
-                        $ pindo web autobuild --multi            # 使用并发模式执行（速度更快）
+                        $ pindo web autobuild --run                     # 编译完成后在本地打开 WebGL 包
 
-                        $ pindo web autobuild --multi --upload   # 并发执行并上传
+                        $ pindo web autobuild --multi                   # 使用并发模式执行
                 DESC
 
                 # 命令的参数列表
@@ -70,6 +92,7 @@ module Pindo
                 # 定义此命令使用的参数项
                 def self.option_items
                     @option_items ||= Pindo::Options::OptionGroup.merge(
+                        Pindo::Options::BuildOptions.select(:bundleid),  # 添加 bundleid 参数
                         Pindo::Options::JPSOptions.select(:proj, :upload, :send, :media),
                         Pindo::Options::UnityOptions.select(:skiplib, :skipyoo),
                         Pindo::Options::UnityOptions.select_with_defaults(skipconfig: true),
@@ -81,7 +104,6 @@ module Pindo
                 # 命令的选项列表
                 def self.options
                     [
-                        ['--bundleid', '指定打包的bundleID'],
                         ['--run',   '编译完成后再本地打开webgl包']
                     ].concat(option_items.map(&:to_claide_option)).concat(super)
                 end
@@ -91,12 +113,22 @@ module Pindo
 
                     @args_deploy_flag = argv.flag?('deploy', false)
                     @args_adhoc_flag = argv.flag?('adhoc', false)
-                    @args_upload_flag = @options[:upload] || false
-                    @args_send_flag = @options[:send] || false
-                    @args_media_flag = @options[:media] || false
                     @args_proj_name = @options[:proj]
-                    @args_bundle_id = argv.option('bundleid')
+                    @args_bundle_id = @options[:bundleid]  # 从 @options 获取，确保能被缓存
                     @args_run_flag = argv.flag?('run', false)
+
+                    # send、media 或 bind 都依赖 upload：如果指定了任一参数，自动启用 upload
+                    @args_upload_flag = @options[:send] || @options[:bind] || @options[:media] || @options[:upload]
+
+                    # media 任务是独立的，不依赖任何其他任务，但是为输入命令参数更加简单，如果有--bind和--send， 则默认认为一定会有--media参数
+                    @args_media_flag = @options[:send] || @options[:bind] || @options[:media] || false
+
+                    # send 都依赖 bind：如果指定了任一参数，自动启用 bind
+                    @args_bind_flag = @options[:send] || @options[:bind] || false
+
+                    @args_send_flag = @options[:send]
+
+                    # Unity 参数
                     @args_skip_lib = @options[:skiplib] || false
                     @args_skip_yoo = @options[:skipyoo] || false
 
@@ -109,10 +141,6 @@ module Pindo
                     @args_tag_type = Pindo::Options::GitOptions.parse_create_tag_type(@options[:tag_type] || 'new')
                     @args_tag_pre = @options[:tag_pre] || 'v'
 
-                    if @args_send_flag || @args_media_flag
-                        @args_upload_flag = true
-                    end
-
                     super
                     @additional_args = argv.remainder!
                 end
@@ -292,8 +320,6 @@ module Pindo
                       options: {
                         project_path: config[:project_path],
                         proj_name: @args_proj_name,
-                        upload: @args_upload_flag,
-                        send: @args_send_flag,
                         app_info_obj: config[:app_info_obj],
                         workflow_info: config[:workflow_info]
                       }
@@ -302,6 +328,7 @@ module Pindo
                     tasks << build_task
 
                     # 7. 上传和消息发送任务（如果需要）
+                    upload_task = nil  # 声明变量以便后续绑定任务使用
                     if @args_upload_flag
                       # WebGL 输出路径: GoodPlatform/WebGL/build
                       webgl_build_path = File.join(config[:project_path], 'GoodPlatform', 'WebGL', 'build')
@@ -318,15 +345,15 @@ module Pindo
                       upload_task.dependencies << build_task.id
                       tasks << upload_task
 
-                      # 7.2 创建消息发送任务（只依赖上传任务）
+                      # 7.2 创建消息发送任务（只依赖上传任务，固定发送给自己）
                       # app_version_info 将从 upload_task 的数据参数中获取
                       message_task = Pindo::TaskSystem::JPSMessageTask.new(
                         nil,  # app_version_info 为 nil，从依赖任务获取
                         app_info_obj: config[:app_info_obj],
                         project_name: @args_proj_name,
-                        send_message_type: @args_send_flag ? 'group' : 'self',
-                        dependencies: [upload_task.id]  # 从 upload_task 获取数据
+                        send_message_type: 'self'  # 固定发送给自己
                       )
+                      message_task.dependencies << upload_task.id
                       tasks << message_task
                     end
 
@@ -347,11 +374,52 @@ module Pindo
                         workflow_info: git_workflow_info,
                         project_name: @args_proj_name
                       )
-                      # 只依赖 Git 提交任务
+                      # 依赖 Git 提交任务
                       media_upload_task.dependencies << git_commit_task.id
                       tasks << media_upload_task
                     end
 
+                    # 9. 创建 Git Commit 绑定任务（如果需要，依赖上传任务）
+                    bind_package_task = nil  # 声明变量以便后续工作流消息任务使用
+                    if @args_bind_flag
+                      bind_package_task = Pindo::TaskSystem::JPSBindPackageTask.new(
+                        nil,  # app_version_list 为 nil，从依赖任务获取
+                        project_dir: config[:project_path],
+                        app_info_obj: config[:app_info_obj],
+                        workflow_info: config[:workflow_info],
+                        project_name: @args_proj_name
+                      )
+                      # 依赖上传任务和 Git 提交任务
+                      bind_package_task.dependencies << upload_task.id
+                      bind_package_task.dependencies << git_commit_task.id
+                      tasks << bind_package_task
+                    end
+
+                    # 10. 创建工作流消息任务（如果需要，发送到测试群）
+                    if @args_send_flag
+                      # 获取 Git 工作流信息
+                      git_app_info_obj, git_workflow_info = PgyerHelper.share_instace.prepare_upload(
+                        working_directory: config[:project_path],
+                        proj_name: @args_proj_name,
+                        package_type: "",
+                        manage_type: "git"
+                      )
+
+                      workflow_message_task = Pindo::TaskSystem::JPSWorkFlowMessageTask.new(
+                        project_id: git_app_info_obj["id"],
+                        workflow_id: git_workflow_info["id"],
+                        branch: 'master',
+                        single: true,
+                        app_info_obj: git_app_info_obj,
+                        workflow_info: git_workflow_info
+                      )
+                      # 依赖 Git Commit、Git Tag 和 Bind Package 任务
+                      workflow_message_task.dependencies << git_commit_task.id
+                      workflow_message_task.dependencies << git_tag_task.id
+                      workflow_message_task.dependencies << bind_package_task.id
+                      tasks << workflow_message_task
+                    end
+
                     tasks
                   else
                     raise Informative, "Web 编译只支持 Unity 工程"

data/lib/pindo/command.rb

@@ -11,7 +11,22 @@ require 'pindo/client/giteeclient'
 require 'pindo/config/pindoconfig'
 
 module Pindo
+    # Help 拦截器模块：统一处理 --help 参数
+    # 使用 prepend 确保在所有子类的 validate! 方法之前执行
+    module HelpValidator
+        def validate!
+            # 如果是 help 请求，调用 help! 并终止执行
+            # help! 会抛出 CLAide::Help 异常，阻止后续逻辑执行
+            help! if @args_help_flag
+
+            # 否则正常执行
+            super
+        end
+    end
+
     class Command < CLAide::Command
+        # 使用 prepend 确保 HelpValidator 在所有子类之前执行
+        prepend HelpValidator
 
         include Pindoconfig::Mixin
         include Funlog::Mixin
@@ -105,30 +120,23 @@ module Pindo
           end
         end
 
-        def validate!
-            super
-            help! if args_help_flag?
-        end
-
         def self.run(argv)
             super(argv)
         end
 
         def initialize(argv)
             super
-            @args_help_flag = argv.flag?('help', false)
-            @args_verbose_flag = argv.flag?('verbose', false)
 
-            # 检查是否是 help 请求（检查原始命令行参数）
-            original_args = ARGV.join(' ')
-            is_help_request = @args_help_flag ||
-                            original_args.include?('--help') ||
-                            original_args.include?('-h') ||
-                            argv.remainder.include?('--help') ||
-                            argv.remainder.include?('-h')
+            # 检查是否是 help 请求
+            # CLAide 可能提前处理了 --help，所以我们需要检查原始参数
+            @args_help_flag = argv.flag?('help', false) ||
+                            ARGV.include?('--help') ||
+                            ARGV.include?('-h')
+
+            @args_verbose_flag = argv.flag?('verbose', false)
 
             # 设置全局 verbose 标志
-            ENV['PINDO_VERBOSE'] = '1' if @args_verbose_flag
+            ENV['PINDO_DEBUG'] = '1' if @args_verbose_flag
         end
 
     end

data/lib/pindo/module/pgyer/pgyerhelper.rb

@@ -103,6 +103,7 @@ module Pindo
               when 'apk' then 'apk_workflow'
               when 'zip' then 'webgl_workflow'
               when 'app' then 'macos_workflow'
+              when 'exe' then 'win_workflow'
               else
                 puts "[JPSConfig] 不支持的 package_type: #{package_type}"
                 return result
@@ -1550,6 +1551,185 @@ module Pindo
             end
         end
 
+        # 获取工作流中已绑定的包 ID
+        #
+        # @param workflow_id [Integer, String] 工作流 ID
+        # @return [Array<String>] 已绑定的包 ID 数组
+        def get_workflow_bound_package_ids(workflow_id:)
+            return [] if workflow_id.nil?
+
+            begin
+                # 调用 JPS API 获取工作流详情
+                result = @pgyer_client.get_workflow_detail(workflowId: workflow_id)
+
+                # 兼容两种响应格式
+                response_code = result&.dig("code") || result&.dig("meta", "code")
+
+                if result && (response_code == 0 || response_code == 200)
+                    # 从响应中提取 boundPackageIds
+                    workflow_data = result&.dig("data") || result&.dig("result")
+                    bound_ids = workflow_data&.dig("boundPackageIds") || []
+
+                    # 确保返回数组（兼容字符串和数组）
+                    bound_ids = [bound_ids] unless bound_ids.is_a?(Array)
+
+                    return bound_ids.compact
+                else
+                    # 如果获取失败，返回空数组（不阻止绑定流程）
+                    if ENV['PINDO_DEBUG']
+                        error_msg = result&.dig("msg") || result&.dig("meta", "message") || "未知错误"
+                        puts "[PINDO_DEBUG] 获取工作流绑定包失败: #{error_msg}"
+                    end
+                    return []
+                end
+            rescue => e
+                # 异常时返回空数组，不阻止绑定流程
+                if ENV['PINDO_DEBUG']
+                    puts "[PINDO_DEBUG] 获取工作流绑定包异常: #{e.message}"
+                end
+                return []
+            end
+        end
+
+        # 获取工作流中最新的 commit id
+        #
+        # @param workflow_id [Integer, String] 工作流 ID
+        # @return [String, nil] 最新的 commit id，失败时返回 nil
+        def get_workflow_latest_commit_id(workflow_id:)
+            return nil if workflow_id.nil?
+
+            begin
+                # 调用 JPS API 获取工作流详情
+                result = @pgyer_client.get_workflow_detail(workflowId: workflow_id)
+
+                # 兼容两种响应格式
+                response_code = result&.dig("code") || result&.dig("meta", "code")
+
+                if result && (response_code == 0 || response_code == 200)
+                    # 从响应中提取工作流数据
+                    workflow_data = result&.dig("data") || result&.dig("result")
+
+                    # 尝试从不同字段获取最新的 commit id
+                    # 1. 尝试从 latestCommitId 字段获取
+                    latest_commit = workflow_data&.dig("latestCommitId")
+
+                    # 2. 如果没有 latestCommitId，尝试从 commits 数组获取第一个
+                    if latest_commit.nil? || latest_commit.empty?
+                        commits = workflow_data&.dig("commits") || []
+                        latest_commit = commits.first&.dig("id") || commits.first&.dig("commitId") if commits.any?
+                    end
+
+                    # 3. 如果还是没有，尝试从 lastCommit 对象获取
+                    if latest_commit.nil? || latest_commit.empty?
+                        last_commit = workflow_data&.dig("lastCommit")
+                        latest_commit = last_commit&.dig("id") || last_commit&.dig("commitId")
+                    end
+
+                    return latest_commit
+                else
+                    # 如果获取失败，返回 nil
+                    if ENV['PINDO_DEBUG']
+                        error_msg = result&.dig("msg") || result&.dig("meta", "message") || "未知错误"
+                        puts "[PINDO_DEBUG] 获取工作流最新 commit id 失败: #{error_msg}"
+                    end
+                    return nil
+                end
+            rescue => e
+                # 异常时返回 nil
+                if ENV['PINDO_DEBUG']
+                    puts "[PINDO_DEBUG] 获取工作流最新 commit id 异常: #{e.message}"
+                end
+                return nil
+            end
+        end
+
+        # 绑定 Git commit 到项目包
+        #
+        # @param commit_id [String] Git commit SHA
+        # @param project_package_ids [Array<String>] 项目包 ID 数组
+        # @return [Hash] 绑定结果
+        def bind_commit_to_package(commit_id:, project_package_ids:)
+            if commit_id.nil? || commit_id.empty?
+                Funlog.instance.fancyinfo_error("commit_id 不能为空")
+                return { success: false, error: "commit_id 不能为空" }
+            end
+
+            if project_package_ids.nil? || project_package_ids.empty?
+                Funlog.instance.fancyinfo_error("project_package_ids 不能为空")
+                return { success: false, error: "project_package_ids 不能为空" }
+            end
+
+            begin
+                result = @pgyer_client.bind_commit_to_package(
+                    commitId: commit_id,
+                    projectPackageIds: project_package_ids
+                )
+
+                # 兼容两种响应格式
+                response_code = result&.dig("code") || result&.dig("meta", "code")
+
+                if result && (response_code == 0 || response_code == 200)
+                    return { success: true, result: result }
+                else
+                    error_msg = result&.dig("msg") || result&.dig("meta", "message") || result&.dig("message") || "未知错误"
+                    return { success: false, error: error_msg, result: result }
+                end
+            rescue => e
+                Funlog.instance.fancyinfo_error("绑定失败: #{e.message}")
+                return { success: false, error: e.message }
+            end
+        end
+
+        # 发送工作流消息（commit log 消息）
+        #
+        # @param project_id [String] 项目 ID
+        # @param workflow_id [Integer] 工作流 ID
+        # @param commit_id [String] Git commit SHA
+        # @param branch [String] 分支名（可选，默认 'master'）
+        # @param single [Boolean] 是否单个提交（可选，默认 true）
+        # @return [Hash] 发送结果
+        def send_workflow_message(project_id:, workflow_id:, commit_id:, branch: 'master', single: true)
+            if project_id.nil? || project_id.empty?
+                Funlog.instance.fancyinfo_error("project_id 不能为空")
+                return { success: false, error: "project_id 不能为空" }
+            end
+
+            if workflow_id.nil?
+                Funlog.instance.fancyinfo_error("workflow_id 不能为空")
+                return { success: false, error: "workflow_id 不能为空" }
+            end
+
+            if commit_id.nil? || commit_id.empty?
+                Funlog.instance.fancyinfo_error("commit_id 不能为空")
+                return { success: false, error: "commit_id 不能为空" }
+            end
+
+            begin
+                result = @pgyer_client.send_commit_log_message(
+                    projectId: project_id,
+                    workflowId: workflow_id,
+                    params: {
+                        single: single,
+                        branch: branch,
+                        commitIds: [commit_id]
+                    }
+                )
+
+                # 兼容两种响应格式
+                response_code = result&.dig("code") || result&.dig("meta", "code")
+
+                if result && (response_code == 0 || response_code == 200)
+                    return { success: true, result: result }
+                else
+                    error_msg = result&.dig("msg") || result&.dig("meta", "message") || result&.dig("message") || "未知错误"
+                    return { success: false, error: error_msg, result: result }
+                end
+            rescue => e
+                Funlog.instance.fancyinfo_error("发送工作流消息失败: #{e.message}")
+                return { success: false, error: e.message }
+            end
+        end
+
         private
 
         # 确定 JPSBuildConfig.json 文件路径
@@ -1634,6 +1814,7 @@ module Pindo
               when 'apk' then 'apk_workflow'
               when 'zip' then 'webgl_workflow'
               when 'app' then 'macos_workflow'
+              when 'exe' then 'win_workflow'
               else raise Informative, "不支持的 package_type: #{package_type}"
             end
           end

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

@@ -110,13 +110,34 @@ module Pindo
           raise e
         end
 
-        # 4. 获取当前分支
+        # 4. Stash 工作目录的残留修改（为分支同步做准备）
+        stash_saved = false
+        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))
+          stash_saved = true
+        end
+
+        # 5. 获取当前分支
         coding_branch = get_current_branch_name
 
-        # 5. 检查并推送本地提交到远程
+        # 6. 检查并推送本地提交到远程（确保本地和远程同步）
         Pindo::GitHandler.check_unpushed_commits(project_dir: root_dir, branch: coding_branch)
 
-        # 6. 计算 build_version
+        # 7. 分支同步：将 coding_branch 和 release_branch 双向合并（确保两分支在同一节点）
+        if coding_branch != @release_branch
+          Funlog.instance.fancyinfo_start("开始同步 #{coding_branch} 和 #{@release_branch} 分支")
+          Pindo::GitHandler.merge_branches(
+            project_dir: root_dir,
+            source_branch: coding_branch,
+            target_branch: @release_branch,
+            sync_branches: true  # 双向合并，确保两分支完全同步
+          )
+          Funlog.instance.fancyinfo_success("分支同步完成，#{coding_branch} 和 #{@release_branch} 现在在同一节点")
+        end
+
+        # 8. 计算 build_version
         # 优先级 1: 如果指定了 fixed_version（外部传入或从 HEAD tag 获取），使用它
         if @fixed_version && !@fixed_version.empty?
           @build_version = @fixed_version
@@ -135,6 +156,18 @@ module Pindo
           Funlog.instance.fancyinfo_success("计算新版本号: #{@build_version}, Build: #{@build_number}")
         end
 
+        # 9. 还原 stash（如果之前有 stash）
+        if stash_saved
+          begin
+            Pindo::GitHandler.git!(%W(-C #{root_dir} stash pop))
+            Funlog.instance.fancyinfo_success("已还原 stash")
+          rescue => e
+            Funlog.instance.fancyinfo_warning("stash 还原时发生冲突: #{e.message}")
+            Funlog.instance.fancyinfo_warning("stash 已保留，请手动执行 'git stash pop' 处理冲突")
+            # 不抛出异常，任务继续（版本号已计算成功，stash 冲突不影响构建）
+          end
+        end
+
         {
           success: true,
           root_dir: root_dir,
@@ -150,7 +183,7 @@ module Pindo
         # 如果不是 Git 仓库，返回空参数（让依赖任务知道没有有效数据）
         return {} if @build_version.nil? || @build_number.nil?
 
-        {
+        param = {
           release_branch: @release_branch,
           build_version: @build_version,
           build_number: @build_number,
@@ -158,6 +191,24 @@ module Pindo
           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

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

@@ -73,12 +73,13 @@ module Pindo
             stash_saved = true
           end
 
-          # 2. 合并到发布分支（方法内部会切回 coding_branch）
+          # 2. 合并到发布分支（双向同步，确保 coding_branch 和 release_branch 保持一致）
           if coding_branch != @release_branch
-            Pindo::GitHandler.merge_to_release_branch(
+            Pindo::GitHandler.merge_branches(
               project_dir: root_dir,
-              release_branch: @release_branch,
-              coding_branch: coding_branch
+              source_branch: coding_branch,
+              target_branch: @release_branch,
+              sync_branches: true  # 双向合并，确保两分支完全同步
             )
           end