pindo 5.21.4 → 5.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f3b56fbb1ab0c039204dd6a338a884ba5a6b0cc014d4abe0356a18bd92b9277
-  data.tar.gz: 5f1c9874bfb6ed50da8c7f02d5dc2a8fc93a15bd59eb59a6be5e904222a0fe42
+  metadata.gz: 683bf46a8095e20c20a6fdc339b99a6ae83337dc58431b67fb6b1d00263e42a8
+  data.tar.gz: 291caf87a1647dc8af05b26fbbfa94cd588385177869e43ec5983db3e90233f8
 SHA512:
-  metadata.gz: dc8a61f2d93aae23c9f6e2986d962cf15d25dfe3bf5d88c02035f36a08dd4b04d98d1ce2f911ada41b79361fa9f6ff8b19a4c46751dce5fcbb5d30b7c87d08a5
-  data.tar.gz: b1f52d2f1e22c7c5b2d0d06ba51c57f65e240f2305dd8c4c72ad535708d27dd7f08e7dee84ea7f28a7a527930b55f20dd580ee20db69f732e9908771c595d371
+  metadata.gz: 1d0176e844e360885e6bf90ebd9024b1982ee7c519ce6d01f3fe994e085110b12107f34271d379283ca4ca27165e0cb1d2187a1daf4cfcbc2ce65b3445688786
+  data.tar.gz: 5a94ae4f340b1cc924a0e85e1c0a57272014d58c7498d248f91ab5d3d6bba399f2d3521c1d6d90dec2d5b5fdb578d4d05b1ce02b3bf55fd7ecc3eb90837a4e64

data/lib/pindo/base/git_handler.rb

@@ -1,4 +1,5 @@
 require 'fileutils'
+require 'open3'
 require 'pindo/base/executable'
 require 'pindo/base/informative'
 require 'etc'
@@ -556,6 +557,16 @@ module Pindo
 
 
 
+        # 仓库是否已有提交（git init 后尚未首次提交的仓库没有 HEAD）
+        # @param git_root [String] Git 根目录
+        # @return [Boolean]
+        def head_commit_exists?(git_root:)
+            _stdout, _stderr, status = Open3.capture3('git', '-C', git_root, 'rev-parse', '--verify', '--quiet', 'HEAD')
+            status.success?
+        rescue SystemCallError
+            false
+        end
+
         # 获取未提交的文件列表
         # @param project_dir [String] 项目目录路径
         # @return [Array<String>, nil] 返回未提交的文件列表，如果没有则返回 nil
@@ -970,6 +981,15 @@ module Pindo
       # @param default_process_type [Symbol, nil] 非交互模式下的默认处理方式，默认为 nil
       # @return [Symbol] UncommittedFilesProcessType 枚举常量
       def get_uncommitted_files_process_type(project_dir:, interactive: true, default_process_type: nil)
+        # 0. 空仓库没有 HEAD，后续的暂存区重置、版本计算、分支同步和打 tag 都无法进行
+        git_root = git_root_directory(local_repo_dir: project_dir)
+        if git_root && !head_commit_exists?(git_root: git_root)
+          raise Informative, "当前 Git 仓库还没有任何提交，无法计算版本号和打 tag：#{git_root}\n" \
+                             "请先完成首次提交后重新执行：\n" \
+                             "  git -C \"#{git_root}\" add -A\n" \
+                             "  git -C \"#{git_root}\" commit -m \"chore: 初始化工程\""
+        end
+
         # 1. 检查是否有未提交的文件
         uncommitted_files = get_uncommitted_files(project_dir: project_dir)
 
@@ -986,8 +1006,7 @@ module Pindo
           return default_process_type
         end
 
-        # 4. 获取 Git 根目录并获取当前分支名
-        git_root = git_root_directory(local_repo_dir: project_dir)
+        # 4. 获取当前分支名
         unless git_root
           Funlog.instance.fancyinfo_warning("当前目录不是Git仓库")
           return Pindo::UncommittedFilesProcessType::SKIP_WITH_TAG

data/lib/pindo/base/xcodeproj_compat.rb

@@ -0,0 +1,42 @@
+require 'xcodeproj'
+
+module Pindo
+  # Xcode 26.4+/27 工程格式兼容补丁（xcodeproj 1.28.1 尚未支持，见 CocoaPods/Xcodeproj#1017）
+  #
+  # CocoaPods 与 fastlane gym 在 pindo 进程内运行，共用同一份补丁。
+  module XcodeprojCompat
+    # 新格式把 shellScript 存为按行拆分的数组，合并回字符串
+    module ShellScriptArray
+      def shell_script=(value)
+        super(value.is_a?(Array) ? value.join("\n") : value)
+      end
+    end
+
+    # 保存时保留 xcodeproj 不认识的字段（如 Copy Files 阶段的 dstSubfolder），
+    # 否则这些字段会被丢弃，导致扩展等产物的嵌入位置丢失
+    module UnknownAttributes
+      def configure_with_plist(objects_by_uuid_plist)
+        object_plist = objects_by_uuid_plist[uuid]
+        known_keys = self.class.attributes.map(&:plist_name) << 'isa'
+        @pindo_unknown_attributes = object_plist.reject { |key, _| known_keys.include?(key) }
+
+        # 暂时移除未知字段，避免 xcodeproj 对已保留的字段输出误导性警告
+        @pindo_unknown_attributes.each_key { |key| object_plist.delete(key) }
+        super
+      ensure
+        object_plist&.merge!(@pindo_unknown_attributes || {})
+      end
+
+      private
+
+      def to_hash_as(method = :to_hash)
+        plist = super
+        (@pindo_unknown_attributes || {}).each { |key, value| plist[key] = value unless plist.key?(key) }
+        plist
+      end
+    end
+  end
+end
+
+Xcodeproj::Project::Object::PBXShellScriptBuildPhase.prepend(Pindo::XcodeprojCompat::ShellScriptArray)
+Xcodeproj::Project::Object::AbstractObject.prepend(Pindo::XcodeprojCompat::UnknownAttributes)

data/lib/pindo/command/jps/config.rb

@@ -10,31 +10,31 @@ module Pindo
         class Jps < Command
             class Config < Jps
 
-                self.summary = '配置当前工程与 JPS 项目及工作流的绑定'
+                self.summary = '配置当前工程与 JPS 项目及安装包工具 / Git 工作流的绑定'
 
                 self.description = <<-DESC
-                    将当前工程绑定到 JPS 项目及其一个或多个工作流，并写入 JPSBuildConfig.json。
+                    将当前工程绑定到 JPS 项目的安装包工具（ipa/apk/zip/mac/exe）和 Git 工作流，并写入 JPSBuildConfig.json。
 
                     只做配置绑定，不编译、不上传，产出与 pindo ios/and autobuild 一致的配置文件。
 
                     支持功能:
 
-                        * 选一次 JPS 项目，一次配置多个工作流类型
+                        * 选一次 JPS 项目，一次配置多个类型
                         * 交互多选菜单，或用 --type 非交互指定类型
                         * --proj 直接指定项目名，跳过项目选择菜单（非交互场景）
-                        * --workflow_name 按名称指定工作流，用于同类型多工作流消歧（非交互场景）
+                        * --workflow_name 按名称指定 Git 工作流或安装包工具，用于同类型多个时消歧（非交互场景）
                         * 支持类型: ipa、apk、zip(WebGL)、mac(macOS)、exe(Windows)、git
-                        * --clean 清除已绑定的工作流或整个配置文件
+                        * --clean 清除已绑定的工具 / 工作流或整个配置文件
 
                     使用示例:
 
-                        $ pindo jps config                              # 交互选择项目和工作流类型
+                        $ pindo jps config                              # 交互选择项目和绑定类型
 
                         $ pindo jps config --type=ipa,apk,git           # 非交互配置指定类型（项目仍需交互选）
 
                         $ pindo jps config --proj=MyApp --type=ipa,git  # 全程非交互（agent/CI 适用）
 
-                        $ pindo jps config --clean                      # 交互清除已绑定的工作流
+                        $ pindo jps config --clean                      # 交互清除已绑定的工具 / 工作流
 
                         $ pindo jps config --clean --type=ipa           # 清除指定类型的绑定
 
@@ -96,7 +96,7 @@ module Pindo
 
                     selected_types = resolve_selected_types
                     if selected_types.empty?
-                        puts "未选择任何工作流类型，已取消操作"
+                        puts "未选择任何绑定类型，已取消操作"
                         return
                     end
 
@@ -110,9 +110,9 @@ module Pindo
                         raise Informative, "未找到 JPS 项目，请检查项目名称或配置文件"
                     end
 
-                    # Phase 1: 先选定所有类型的工作流（任一歧义/缺失即报错，此时尚未写任何文件）
+                    # Phase 1: 先选定所有类型的工具 / 工作流（任一歧义/缺失即报错，此时尚未写任何文件）
                     selections = selected_types.map do |type|
-                        puts "\n选择工作流: #{type[:name]}"
+                        puts "\n选择#{binding_label(type)}: #{type[:name]}"
                         workflow_info = pgyer_helper.select_workflow_for_project(
                             project_id: app_info_obj["id"],
                             package_type: type[:package_type],
@@ -169,7 +169,7 @@ module Pindo
                 end
 
                 def select_types_interactive
-                    puts "\n请选择要配置的工作流类型（可多选）:"
+                    puts "\n请选择要配置的绑定类型（安装包为工具，git 为工作流，可多选）:"
                     puts DIVIDER
                     WORKFLOW_TYPES.each_with_index do |type, index|
                         puts "  #{index + 1}. #{type[:name]}"
@@ -343,11 +343,20 @@ module Pindo
                     WORKFLOW_TYPES.each do |type|
                         workflow = config[type[:workflow_key]]
                         next if workflow.nil?
-                        puts "  #{type[:name]}: #{workflow['tab_name']} (ID: #{workflow['workflow_id']})"
+                        if type[:manage_type] == 'git'
+                            puts "  #{type[:name]}: 工作流: #{workflow['tab_name']} (ID: #{workflow['workflow_id']})"
+                        else
+                            puts "  #{type[:name]}: 工具: #{workflow['tab_name']} (packageId: #{workflow['package_id']})"
+                        end
                     end
                     puts DIVIDER
                 end
 
+                # 安装包类型绑定的是「工具」，Git 绑定的是「工作流」
+                def binding_label(type)
+                    type[:manage_type] == 'git' ? '工作流' : '工具'
+                end
+
             end
         end
     end

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

@@ -156,6 +156,7 @@ module Pindo
           # 7. 所有验证通过
           result[:valid] = true
           result[:workflow_info] = {
+            package_id: workflow['package_id'].to_s,
             workflow_id: workflow['workflow_id'],
             tab_name: workflow['tab_name'],
             package_name: workflow['package_name'],
@@ -166,6 +167,7 @@ module Pindo
           if ENV['PINDO_DEBUG']
             puts "[PINDO_DEBUG] ✓✓✓ 配置验证通过 (#{workflow_key})"
             puts "[PINDO_DEBUG] 返回 valid=true，workflow_info:"
+            puts "  package_id: #{result[:workflow_info][:package_id]}"
             puts "  workflow_id: #{result[:workflow_info][:workflow_id]}"
             puts "  tab_name: #{result[:workflow_info][:tab_name]}"
             puts "  manage_type: #{result[:workflow_info][:manage_type]}"
@@ -174,86 +176,44 @@ module Pindo
           return result
         end
 
-        # 为项目选择工作流
+        # 为项目选择工作流（Git）或安装包工具（ipa/apk/zip/mac/exe）
+        #
+        # JPS V1.3.94 起，workflow/list 不再返回产物工作流；安装包入口改为项目的 packageTools，
+        # 因此非 git 类型一律从 project/detail 的 packageTools 中选择。
         #
         # @param project_id [String] 项目ID
         # @param package_type [String] 包类型
         # @param working_directory [String] 工作目录
-        # @param manage_type [String] 管理类型（默认为空，"git" 时筛选 git 工作流）
-        # @return [Hash] 选择的工作流信息
+        # @param manage_type [String] 管理类型（默认为空，"git" 时选择 Git 工作流）
+        # @param workflow_name [String, nil] 按名称精确选择（Git 匹配 tabName；工具匹配 name、subtitle 或 name（subtitle））
+        # @return [Hash] 选择的工作流/工具信息（symbol key 结构）
         def select_workflow_for_project(project_id:, package_type:, working_directory:, manage_type: "", workflow_name: nil)
-          # 1. 从 JPS API 获取可用工作流列表
+          if manage_type == "git"
+            return select_git_workflow_for_project(project_id: project_id, package_type: package_type, workflow_name: workflow_name)
+          end
+
+          select_package_tool_for_project(project_id: project_id, package_type: package_type, workflow_name: workflow_name)
+        end
+
+        # 选择 Git 仓库工作流（仍通过 workflow/list 获取）
+        def select_git_workflow_for_project(project_id:, package_type: nil, workflow_name: nil)
           Funlog.instance.fancyinfo_start("正在获取可用工作流...")
 
           workflow_result = @pgyer_client.get_project_workflows(project_id: project_id)
-
           if workflow_result.nil? || workflow_result['data'].nil?
             raise Informative, "获取工作流列表失败"
           end
 
           workflows = workflow_result['data']
-
-          if workflows.empty?
-            raise Informative, "该项目没有可用的工作流"
+          type_desc = 'Git 管理类型'
+          # 严格筛选 manage_type == "git"，不降级到其它类型
+          display_workflows = workflows.select do |w|
+            (w['manageType'] == 'git') || (w['manage_type'] == 'git')
           end
 
-          puts "package_type #{package_type} manage_type: #{manage_type}"
-
-          # 2. 根据 manage_type 或 package_type 过滤工作流
-          if manage_type == "git"
-            # manage_type 为 git 时，只筛选 manage_type == "git" 的工作流，不看 package_type
-            # 严格筛选，不包括 manage_type 为空或其他类型的工作流
-            filtered_workflows = workflows.select do |w|
-              (w['manageType'] == 'git') || (w['manage_type'] == 'git')
-            end
-            type_desc = 'Git 管理类型'
-            # manage_type == "git" 时严格使用筛选结果，不降级
-            display_workflows = filtered_workflows
-          else
-            # 按 package_type 过滤工作流
-            filtered_workflows = workflows.select do |w|
-              # 如果工作流有 packageType 字段，进行过滤
-              if w['packageType']
-                case package_type
-                when 'ipa'
-                  w['packageType'] == 'ipa'
-                when 'apk'
-                  w['packageType'] == 'apk'
-                when 'zip'
-                  w['packageType'] == 'zip'
-                when 'mac'
-                  w['packageType'] == 'mac'
-                when 'exe'
-                  w['packageType'] == 'exe'
-                else
-                  true
-                end
-              else
-                # 如果没有 packageType 字段，显示所有工作流
-                true
-              end
-            end
-
-            type_desc = case package_type
-              when 'ipa' then 'iOS IPA'
-              when 'apk' then 'Android APK'
-              when 'zip' then 'WebGL'
-              when 'mac' then 'macOS App'
-              when 'exe' then 'Windows EXE'
-              else package_type
-            end
-
-            # 非 git 模式：过滤结果即为候选。若为空则交由下方“没有找到匹配工作流”报错，
-            # 不再回退到全部工作流——否则会把其它类型的工作流误当作请求类型（写错 workflow_key）
-            display_workflows = filtered_workflows
-          end
-
-          # 过滤后再报数：只报总数会让人以为剩下的工作流被漏掉了，
-          # 实际是按 manage_type / package_type 筛掉的，两个数字一起给出才不歧义
           Funlog.instance.fancyinfo_success("获取工作流列表成功，共 #{workflows.size} 个工作流，其中 #{type_desc} #{display_workflows.size} 个")
 
-          # 2.5 若指定了 workflow_name，按名称精确匹配（忽略大小写与首尾空格）确定性选择。
-          # 只接受完整精确匹配，不做子串模糊匹配，避免 "Production" 误命中 "Legacy Production Upload"。
+          # 指定 workflow_name 时只接受完整精确匹配（忽略大小写与首尾空格），不做子串模糊匹配
           if workflow_name && !workflow_name.to_s.strip.empty? && !display_workflows.empty?
             key_name = workflow_name.to_s.strip.downcase
             name_matched = display_workflows.select do |w|
@@ -266,44 +226,23 @@ module Pindo
             display_workflows = name_matched
           end
 
-          # 3. 根据匹配数量决定选择方式
-          workflow = nil
-
           if display_workflows.empty?
-            # 情况1: 没有匹配的工作流
-            error_msg = if manage_type == "git"
-              "没有找到匹配 #{type_desc} 的工作流，请在 JPS 后台创建 Git 类型工作流（项目ID: #{project_id}）"
-            else
-              "没有找到匹配 #{type_desc} 的工作流，请在 JPS 后台配置（项目ID: #{project_id}）"
-            end
-            raise Informative, error_msg
-
-          elsif display_workflows.size == 1
-            # 情况2: 只有1个匹配的工作流，自动选择
-            workflow = display_workflows.first
-            workflow_name = workflow['tabName'] || workflow['tab_name']
-            Funlog.instance.fancyinfo_success("自动选择唯一匹配的工作流: #{workflow_name}")
+            raise Informative, "没有找到匹配 #{type_desc} 的工作流，请在 JPS 后台创建 Git 类型工作流（项目ID: #{project_id}）"
+          end
 
+          workflow = if display_workflows.size == 1
+            Funlog.instance.fancyinfo_success("自动选择唯一匹配的工作流: #{display_workflows.first['tabName'] || display_workflows.first['tab_name']}")
+            display_workflows.first
           else
-            # 情况3: 有多个匹配的工作流，让用户选择
-            cli = HighLine.new
-            workflow_choices = display_workflows.map do |w|
+            choices = display_workflows.map do |w|
               "#{w['tabName'] || w['tab_name']} (ID: #{w['id'] || w['workflow_id']})"
             end
-
-            selected = cli.choose do |menu|
-              menu.prompt = "请选择 #{type_desc} 工作流:"
-              menu.choices(*workflow_choices)
-            end
-
-            # 提取选择的工作流
-            selected_index = workflow_choices.index(selected)
-            workflow = display_workflows[selected_index]
+            choose_from_menu(prompt: "请选择 #{type_desc} 工作流:", choices: choices, items: display_workflows)
           end
 
-          # 4. 返回标准化的工作流信息
           {
             workflow_id: workflow['id'] || workflow['workflow_id'],
+            package_id: "",
             tab_name: workflow['tabName'] || workflow['tab_name'],
             package_name: workflow['packageName'] || workflow['package_name'] || workflow['tabName'] || workflow['tab_name'],
             package_type: package_type,
@@ -311,96 +250,73 @@ module Pindo
           }
         end
 
-        # AdHoc 专用工作流选择
-        # 筛选条件：
-        #   1. package_type 匹配
-        #   2. tab_name 必须包含 "提交包"
-        #
-        # @param project_id [String] 项目ID
-        # @param package_type [String] 包类型（ipa/apk/zip/app）
-        # @return [Hash] 选择的工作流信息
-        def select_workflow_for_adhoc(project_id:, package_type:)
-          # 1. 从 JPS API 获取可用工作流列表
-          workflow_result = @pgyer_client.get_project_workflows(project_id: project_id)
+        # 选择安装包工具（来自 project/detail 的 packageTools）
+        def select_package_tool_for_project(project_id:, package_type:, workflow_name: nil)
+          Funlog.instance.fancyinfo_start("正在获取项目工具列表...")
 
-          if workflow_result.nil? || workflow_result['data'].nil?
-            raise Informative, "获取工作流列表失败"
-          end
+          tools = get_project_package_tools(project_id: project_id, package_type: package_type)
+          type_desc = package_type_desc(package_type)
 
-          workflows = workflow_result['data']
+          Funlog.instance.fancyinfo_success("获取工具列表成功，#{type_desc} 工具共 #{tools.size} 个")
 
-          if workflows.empty?
-            raise Informative, "该项目没有可用的工作流"
+          if workflow_name && !workflow_name.to_s.strip.empty? && !tools.empty?
+            tools = match_package_tools_by_name(tools: tools, name: workflow_name, type_desc: type_desc)
           end
 
-          # 2. 第一层过滤：根据 package_type
-          filtered_by_type = workflows.select do |w|
-            if w['packageType']
-              case package_type
-              when 'ipa'
-                w['packageType'] == 'ipa'
-              when 'apk'
-                w['packageType'] == 'apk'
-              when 'zip'
-                w['packageType'] == 'zip'
-              when 'mac'
-                w['packageType'] == 'mac'
-              else
-                true
-              end
-            else
-              # 如果没有 packageType 字段，保留（后续通过名称筛选）
-              true
-            end
-          end
-
-          # 3. 第二层过滤：tab_name 必须包含 "提交包"
-          adhoc_workflows = filtered_by_type.select do |w|
-            tab_name = w['tabName'] || w['tab_name'] || ''
-            tab_name.include?('提交包')
+          if tools.empty?
+            raise Informative, "项目中没有可用的 #{type_desc} 工具，请到 JPS 项目的「工具」页新建（项目ID: #{project_id}）"
           end
 
-          if adhoc_workflows.empty?
-            raise Informative, "未找到符合条件的 AdHoc 工作流\n" \
-                                "要求：package_type=#{package_type} 且 tab_name 包含 '提交包'\n" \
-                                "请检查 JPS 工作流配置"
+          tool = if tools.size == 1
+            Funlog.instance.fancyinfo_success("自动选择唯一匹配的工具: #{package_tool_display_name(tools.first)}")
+            tools.first
+          else
+            choices = tools.map { |t| "#{package_tool_display_name(t)} (版本数: #{t['packageCount'] || 0})" }
+            choose_from_menu(prompt: "请选择 #{type_desc} 工具:", choices: choices, items: tools)
           end
 
-          # 4. 根据匹配数量决定选择方式
-          workflow = nil
+          package_tool_to_workflow_info(tool, package_type)
+        end
 
-          if adhoc_workflows.size == 1
-            # 只有 1 个匹配，自动选择
-            workflow = adhoc_workflows.first
-          else
-            # 有多个匹配，让用户选择
-            require 'highline/import'
-            cli = HighLine.new
+        # 按名称精确匹配工具（忽略大小写与首尾空格）：显示名 name（subtitle）、subtitle（原 tab 名）、name 任一相等
+        def match_package_tools_by_name(tools:, name:, type_desc:)
+          key = name.to_s.strip.downcase
+          matched = tools.select do |t|
+            [package_tool_display_name(t), t["subtitle"], t["name"]].any? { |v| v.to_s.strip.downcase == key }
+          end
+          if matched.empty?
+            available = tools.map { |t| package_tool_display_name(t) }.join('、')
+            raise Informative, "未找到名称精确匹配 \"#{name}\" 的 #{type_desc} 工具，可选: #{available}"
+          end
+          matched
+        end
 
-            workflow_choices = adhoc_workflows.map do |w|
-              tab_name = w['tabName'] || w['tab_name']
-              workflow_id = w['id'] || w['workflow_id']
-              "#{tab_name} (ID: #{workflow_id})"
-            end
+        # AdHoc 专用工具选择
+        # 筛选条件：packageType 匹配，且副标题（原 tab 名）或名称包含 "提交包"
+        #
+        # @param project_id [String] 项目ID
+        # @param package_type [String] 包类型（ipa/apk/zip/mac）
+        # @return [Hash] 选择的工具信息
+        def select_workflow_for_adhoc(project_id:, package_type:)
+          tools = get_project_package_tools(project_id: project_id, package_type: package_type)
+          adhoc_tools = tools.select do |t|
+            t["subtitle"].to_s.include?('提交包') || t["name"].to_s.include?('提交包')
+          end
 
-            selected = cli.choose do |menu|
-              menu.prompt = "请选择 AdHoc 工作流:"
-              menu.choices(*workflow_choices)
-            end
+          if adhoc_tools.empty?
+            raise Informative, "未找到符合条件的 AdHoc 工具\n" \
+                                "要求：packageType=#{package_type} 且副标题包含 '提交包'\n" \
+                                "请到 JPS 项目的「工具」页检查"
+          end
 
-            # 提取选择的工作流
-            selected_index = workflow_choices.index(selected)
-            workflow = adhoc_workflows[selected_index]
+          tool = if adhoc_tools.size == 1
+            adhoc_tools.first
+          else
+            choices = adhoc_tools.map { |t| package_tool_display_name(t) }
+            choose_from_menu(prompt: "请选择 AdHoc 工具:", choices: choices, items: adhoc_tools)
           end
 
-          # 5. 返回标准化的工作流信息
-          {
-            workflow_id: workflow['id'] || workflow['workflow_id'],
-            tab_name: workflow['tabName'] || workflow['tab_name'],
-            package_type: workflow['packageType'] || package_type,
-            package_name: workflow['packageName'] || workflow['package_name'] || '',
-            manage_type: workflow['manageType'] || workflow['manage_type'] || ''
-          }
+          package_tool_to_workflow_info(tool, package_type)
         end
 
         # 获取 AdHoc 上传信息
@@ -463,19 +379,19 @@ module Pindo
             raise Informative, "未找到项目: #{upload_proj_name}，请检查项目名称是否正确"
           end
 
-          # 4. 获取 AdHoc 工作流（调用专用函数）
+          # 4. 获取 AdHoc 工具（调用专用函数）
           workflow_info = select_workflow_for_adhoc(
             project_id: app_info_obj["id"],
             package_type: package_type
           )
 
           unless workflow_info
-            raise Informative, "未能获取 AdHoc 工作流信息"
+            raise Informative, "未能获取 AdHoc 工具信息"
           end
 
-          # 5. 输出最终选择的项目和工作流
+          # 5. 输出最终选择的项目和工具
           puts "\n✓ 项目: #{app_info_obj['projectName']}"
-          puts "✓ 工作流: #{workflow_info[:tab_name]}"
+          puts "✓ 工具: #{workflow_info[:tab_name]}"
 
           # 6. 保存项目名称到实例变量
           @proj_name = upload_proj_name
@@ -532,9 +448,10 @@ module Pindo
               puts "[PINDO_DEBUG] 配置加载结果: valid=#{config_result[:valid]}" if ENV['PINDO_DEBUG']
 
               if config_result[:valid]
+                is_git_config = manage_type.to_s == "git"
                 puts "\n使用 JPSBuildConfig.json 配置:"
                 puts "  项目: #{config_result[:project_name]}"
-                puts "  工作流: #{config_result[:workflow_info][:tab_name]}"
+                puts "  #{is_git_config ? '工作流' : '工具'}: #{config_result[:workflow_info][:tab_name]}"
 
                 if ENV['PINDO_DEBUG']
                   puts "[PINDO_DEBUG] 配置详细信息:"
@@ -547,6 +464,27 @@ module Pindo
                   raise Informative, "JPS 未登录或登录已失效，请执行 pindo jps login 重新登录"
                 end
 
+                # 安装包配置只有 workflow_id（旧格式）时，换算成 package_id 并写回；
+                # 找不到对应工具则落到下方交互重选流程
+                unless is_git_config
+                  migrated = migrate_legacy_workflow_info!(
+                    config_path: config_path,
+                    project_id: config_result[:project_id],
+                    package_type: package_type,
+                    workflow_info: config_result[:workflow_info]
+                  )
+                  if migrated.nil?
+                    puts "旧工作流（ID: #{config_result[:workflow_info][:workflow_id]}）未找到对应工具，将重新选择"
+                    config_result[:valid] = false
+                    # 项目已知，只需重选工具：走下方 --proj 非交互项目解析分支
+                    proj_name = config_result[:project_name]
+                  else
+                    config_result[:workflow_info] = migrated
+                  end
+                end
+              end
+
+              if config_result[:valid]
                 puts "[PINDO_DEBUG] 正在查找项目: #{config_result[:project_name]}" if ENV['PINDO_DEBUG']
                 lookup_bundle_id = resolve_lookup_bundle_id(
                   bundle_name: bundle_name,
@@ -740,9 +678,11 @@ module Pindo
 
         def start_upload(app_info_obj:nil, ipa_file_upload:nil, description:nil, workflow_info:nil)
 
-                # 验证 workflow_info 必传
-                if workflow_info.nil? || workflow_info[:workflow_id].nil?
-                    raise Informative, "workflow_info 和 workflow_id 是必传参数，请确保调用 prepare_upload 时传入了 package_type"
+                # 验证工具信息必传：package_id 优先，旧配置换算不到时才用 workflow_id 兼容
+                package_id = workflow_info && workflow_info[:package_id].to_s.strip
+                workflow_id = workflow_info && workflow_info[:workflow_id]
+                if workflow_info.nil? || (package_id.to_s.empty? && (workflow_id.nil? || workflow_id.to_s.empty?))
+                    raise Informative, "缺少工具信息（package_id），请确保调用 prepare_upload 时传入了 package_type"
                 end
 
                 if !ipa_file_upload.nil? &&
@@ -901,13 +841,13 @@ module Pindo
 
                     puts attachFileUrls
 
-                    # 准备上传参数（workflowId 必传）
-                    upload_params = {
+                    upload_params = build_package_upload_params(
                         description: description,
-                        packageUrl: upload_res,
-                        attachFileUrls: attachFileUrls,
-                        workflowId: workflow_info[:workflow_id]  # workflowId 必传
-                    }
+                        package_url: upload_res,
+                        attach_file_urls: attachFileUrls,
+                        package_id: package_id,
+                        workflow_id: workflow_id
+                    )
 
                     # 提交包信息到服务器
                     Funlog.instance.fancyinfo_start("正在提交包信息到服务器...")
@@ -926,7 +866,9 @@ module Pindo
                         if result_data && result_data["data"] && result_data["data"]["id"]
                             Funlog.instance.fancyinfo_success("提交包信息完成!")
                         else
-                            error_msg = result_data&.dig('msg') || '未知错误'
+                            error_msg = result_data&.dig('msg') || result_data&.dig('meta', 'message') || '未知错误'
+                            hint = package_upload_error_hint(result_data)
+                            error_msg = "#{error_msg}（#{hint}）" if hint
                             Funlog.instance.fancyinfo_error("提交包信息失败: #{error_msg}")
                             raise Informative, "上传失败：未获取到有效的返回数据"
                         end
@@ -945,6 +887,37 @@ module Pindo
 
         end
 
+        # 项目包上传错误码 → 处理提示
+        PACKAGE_UPLOAD_ERROR_HINTS = {
+          97931 => "未传 packageId，请重新执行 pindo jps config 绑定工具",
+          97992 => "packageId 与 workflowId 冲突，只应传 packageId",
+          97953 => "该工具不是安装包类型，不能走项目包上传"
+        }.freeze
+
+        # 组装项目包上传参数：packageId 与 workflowId 只传一个（同时传且不匹配会报 97992）
+        def build_package_upload_params(description:, package_url:, attach_file_urls:, package_id:, workflow_id:)
+          params = {
+            description: description,
+            packageUrl: package_url,
+            attachFileUrls: attach_file_urls
+          }
+          if !package_id.to_s.strip.empty?
+            params.merge(packageId: package_id.to_s.strip)
+          else
+            # 换算不到工具的旧配置：按 workflowId 兼容上传（JPS 长期兼容）
+            Funlog.instance.fancyinfo_warning("未绑定工具，按旧工作流ID兼容上传: #{workflow_id}")
+            params.merge(workflowId: workflow_id)
+          end
+        end
+
+        # 从上传返回体中取错误码提示（码可能在 code 或 meta.code）
+        def package_upload_error_hint(result_data)
+          return nil unless result_data.is_a?(Hash)
+          code = result_data['code'] || result_data.dig('meta', 'code')
+          return nil if code.nil?
+          PACKAGE_UPLOAD_ERROR_HINTS[code.to_i]
+        end
+
         def package_windows_exe_for_upload(exe_file_upload)
             windows_exe_path = File.expand_path(exe_file_upload)
             windows_build_dir = File.dirname(windows_exe_path)
@@ -1435,6 +1408,67 @@ module Pindo
           result&.dig("data")
         end
 
+        # 取项目下可上传的安装包工具（project/detail 的 packageTools）
+        # 按 package_type 筛选，去掉已下架（lifecycle=deprecated）和缺 packageId 的，保持接口返回的排序
+        #
+        # @param project_id [String] 项目ID
+        # @param package_type [String] 包类型（ipa/apk/zip/mac/exe）
+        # @return [Array<Hash>] packageTools 原始项
+        def get_project_package_tools(project_id:, package_type:)
+          detail = get_project_detail(project_id: project_id)
+          tools = detail.is_a?(Hash) ? detail["packageTools"] : nil
+          return [] unless tools.is_a?(Array)
+
+          tools.select do |t|
+            t.is_a?(Hash) &&
+              t["packageType"].to_s.downcase == package_type.to_s.downcase &&
+              t["lifecycle"].to_s != "deprecated" &&
+              !t["packageId"].to_s.strip.empty?
+          end
+        end
+
+        # 工具显示名：name（subtitle），与 GoodUnityBuild 写入的 tab_name 保持一致
+        def package_tool_display_name(tool)
+          name = tool["name"].to_s
+          subtitle = tool["subtitle"].to_s
+          subtitle.strip.empty? ? name : "#{name}（#{subtitle}）"
+        end
+
+        # 工具 → workflow_info（沿用 symbol key 结构，调用方无需改动）
+        def package_tool_to_workflow_info(tool, package_type)
+          {
+            package_id: tool["packageId"].to_s,
+            workflow_id: tool["workflowId"],          # 老工具才有；新工具为 nil，仅用于兼容
+            tab_name: package_tool_display_name(tool),
+            package_name: tool["name"],
+            package_type: package_type,
+            manage_type: "package",
+            subtitle: tool["subtitle"],
+            bundle_id: tool["bundleId"]
+          }
+        end
+
+        # 旧配置（只有 workflow_id、没有 package_id）换算成工具并写回配置文件
+        # 已有 package_id → 原样返回、不发请求；只有 workflow_id → 在 packageTools 里按 workflowId 查找
+        #
+        # @return [Hash, nil] 换算后的 workflow_info；找不到对应工具返回 nil
+        def migrate_legacy_workflow_info!(config_path:, project_id:, package_type:, workflow_info:)
+          return workflow_info unless workflow_info[:package_id].to_s.strip.empty?
+          return nil if workflow_info[:workflow_id].nil? || workflow_info[:workflow_id].to_s.empty?
+
+          tool = get_project_package_tools(project_id: project_id, package_type: package_type)
+                   .find { |t| t["workflowId"].to_s == workflow_info[:workflow_id].to_s }
+          return nil if tool.nil?
+
+          new_info = package_tool_to_workflow_info(tool, package_type)
+          config = JSON.parse(File.read(config_path))
+          key = jps_workflow_key(package_type: package_type)
+          config[key] = build_workflow_data(workflow_info: new_info, package_type: package_type)
+          atomic_write(config_path, JSON.pretty_generate(config))
+          puts "已将旧工作流（ID: #{workflow_info[:workflow_id]}）换算为工具: #{new_info[:tab_name]}"
+          new_info
+        end
+
         PROJECT_PAGE_SIZE = 100
         # 安全上限：最多翻 200 页（约 2 万项目），防止服务端异常（如忽略 pageNo 恒返满页）导致死循环
         MAX_PROJECT_PAGES = 200
@@ -2210,7 +2244,7 @@ module Pindo
           end
 
           atomic_write(config_file, JSON.pretty_generate(config) + "\n")
-          puts "已写入 JPSBuildConfig.json（#{entries.size} 个工作流）"
+          puts "已写入 JPSBuildConfig.json（#{entries.size} 项绑定）"
           config
         end
 
@@ -2252,10 +2286,34 @@ module Pindo
           end
         end
 
-        # 构建单个工作流的写入结构
+        # 包类型 → 显示名
+        def package_type_desc(package_type)
+          case package_type
+          when 'ipa' then 'iOS IPA'
+          when 'apk' then 'Android APK'
+          when 'zip' then 'WebGL'
+          when 'mac' then 'macOS App'
+          when 'exe' then 'Windows EXE'
+          else package_type.to_s
+          end
+        end
+
+        # HighLine 菜单选择，返回 items 中与所选 choice 同下标的元素
+        def choose_from_menu(prompt:, choices:, items:)
+          cli = HighLine.new
+          selected = cli.choose do |menu|
+            menu.prompt = prompt
+            menu.choices(*choices)
+          end
+          items[choices.index(selected)]
+        end
+
+        # 构建单个工作流/工具的写入结构（与 GoodUnityBuild 共用的 JPSBuildConfig.json 格式）
+        # 安装包工具：package_id 为上传依据，workflow_id 仅兼容（新工具为 nil）；Git 工作流：package_id 为空串
         def build_workflow_data(workflow_info:, package_type:)
           {
             "workflow_id" => workflow_info[:workflow_id],
+            "package_id" => workflow_info[:package_id].to_s,
             "tab_name" => workflow_info[:tab_name],
             "package_type" => package_type,
             "package_name" => workflow_info[:package_name],
@@ -2268,20 +2326,24 @@ module Pindo
         # @param workflow [Hash] 工作流配置对象
         # @return [Boolean] 是否有效
         def workflow_valid?(workflow)
-          return false if workflow.nil?
+          return false unless workflow.is_a?(Hash)
 
-          # 检查 workflow_id
-          return false if workflow['workflow_id'].nil? || workflow['workflow_id'].to_s.empty?
-
-          # git 类型的 workflow 不需要 package_name（管理 git commit，不是包文件）
-          # 其他类型的 workflow 需要 package_name
           is_git_workflow = workflow['manage_type'] == 'git'
-          unless is_git_workflow
-            return false if workflow['package_name'].nil? || workflow['package_name'].empty?
+          has_workflow_id = !workflow['workflow_id'].nil? && !workflow['workflow_id'].to_s.empty?
+          has_package_id = !workflow['package_id'].to_s.strip.empty?
+
+          if is_git_workflow
+            # Git 工作流必须有 workflow_id，不需要 package_name
+            return false unless has_workflow_id
+          else
+            # 安装包工具：package_id / workflow_id 有一个即可（只有 workflow_id 的旧配置在 prepare_upload 中换算）
+            return false unless has_package_id || has_workflow_id
+            return false if workflow['package_name'].nil? || workflow['package_name'].to_s.empty?
           end
 
           if ENV['PINDO_DEBUG']
             puts "[PINDO_DEBUG] workflow_valid? 检查通过:"
+            puts "  package_id: #{workflow['package_id']}"
             puts "  workflow_id: #{workflow['workflow_id']}"
             puts "  manage_type: #{workflow['manage_type']}"
             puts "  is_git_workflow: #{is_git_workflow}"
@@ -2395,14 +2457,18 @@ module Pindo
           end
 
           # 8. Project ID 不变，检查工作流是否需要更新
+          # 安装包按 package_id 比较（新工具 workflow_id 都是 nil）；Git 按 workflow_id 比较
           existing_workflow = existing_config[workflow_key]
-          existing_workflow_id = existing_workflow&.dig('workflow_id')
-
-          if existing_workflow_id.nil? ||
-             existing_workflow_id.to_s.empty? ||
-             existing_workflow_id != workflow_info[:workflow_id]
+          changed = if manage_type.to_s == 'git'
+            existing_workflow_id = existing_workflow.is_a?(Hash) ? existing_workflow['workflow_id'] : nil
+            existing_workflow_id.to_s.empty? || existing_workflow_id.to_s != workflow_info[:workflow_id].to_s
+          else
+            existing_package_id = existing_workflow.is_a?(Hash) ? existing_workflow['package_id'] : nil
+            existing_package_id.to_s.empty? || existing_package_id.to_s != workflow_info[:package_id].to_s
+          end
 
-            # Workflow ID 变更 → 更新对应的 workflow 和项目信息
+          if changed
+            # 工作流/工具变更 → 更新对应的 workflow 和项目信息
             puts "#{workflow_key} 变更，更新工作流配置"
             existing_config[workflow_key] = new_workflow_data
             existing_config["bundle_group_name"] = new_bundle_group_name
@@ -2412,7 +2478,7 @@ module Pindo
             return
           end
 
-          # 9. Project ID 和 Workflow ID 都不变 → 不修改
+          # 9. Project ID 和工作流/工具都不变 → 不修改
           puts "配置未变更，跳过保存" if ENV['PINDO_DEBUG']
         end
     end

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

@@ -142,7 +142,8 @@ module Pindo
           project_dir: @project_path,
           workflow_packname: workflow_packname,
           project_id: project_id,
-          bundle_id: @bundle_id
+          bundle_id: @bundle_id,
+          bundle_id_prefix: Pindo::XcodeBuildConfig.bundle_id_prefix_from(config_bundle_id)
         )
 
         # 下载并替换 Icon，优先使用 packageProjectIcon，为空则回退到 projectIcon
@@ -159,7 +160,7 @@ module Pindo
           )
 
           unless icon_replace_success
-            raise Informative, "Icon 下载或替换失败，请检查 Icon URL 是否有效: #{icon_url}"
+            raise Informative, "Icon 下载或替换失败，具体原因见上方日志（Icon URL: #{icon_url}）"
           end
         else
           Funlog.warning("未配置 Icon URL，跳过 Icon 替换")
@@ -196,8 +197,8 @@ module Pindo
             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 获取到版本号，保持工程原有版本号")
+            # 不是 Git 仓库且没有从 GitCommitTask 获取到版本号：沿用工程版本号，但补齐为 JPS 要求的 major.minor.patch
+            normalize_project_version
             return
           end
         end
@@ -210,6 +211,35 @@ module Pindo
         )
       end
 
+      # 非 Git 仓库时沿用工程原有版本号，仅补齐格式（如 Xcode 模板默认的 1.0 => 1.0.0），否则 JPS 拒收
+      def normalize_project_version
+        version, build_number = Pindo::XcodeBuildConfig.current_app_version(project_dir: @project_path)
+        normalized = Pindo::XcodeBuildConfig.normalize_marketing_version(version)
+
+        if normalized.nil?
+          Funlog.warning("非Git仓库，保持工程原有版本号 #{version.inspect}；JPS 要求 major.minor.patch 格式，上传可能失败")
+          return
+        end
+
+        if normalized == version.to_s.strip
+          Funlog.warning("非Git仓库且未从 GitCommitTask 获取到版本号，保持工程原有版本号 #{normalized}")
+          return
+        end
+
+        Funlog.warning("非Git仓库，工程版本号 #{version} 补齐为 #{normalized}")
+        Pindo::XcodeBuildConfig.update_ios_project_version(
+          project_dir: @project_path,
+          version: normalized,
+          build_number: build_number.to_s.strip.empty? ? '1' : build_number
+        )
+      end
+
+      # 当前环境配置仓库中的主 Bundle ID（如 workhard 为 com.eyesofstorms.*），与证书使用同一来源
+      def config_bundle_id
+        require 'pindo/config/ios_config_parser'
+        Pindo::IosConfigParser.instance.bundle_id
+      end
+
       # 检查配置
       def pull_config
         # 检查 IosConfigParser 单例中是否已加载配置

data/lib/pindo/module/task/model/nuget/nuget_upload_task.rb

@@ -7,6 +7,9 @@ module Pindo
     class NugetUploadTask < NugetTask
 
       DEFAULT_NUGET_BUCKET_NAME = 'nuget-resource'.freeze
+      # NuGet 登记项目：JPS「Unity 组件」项目
+      # （原「Nuget 组件库」5e6b36f61b614ed88086373ef874616c 已停止接收 NuGet 登记，返回 90006）
+      NUGET_PROJECT_ID = '1b9f111539ba4715abb2011fbfe46fd8'.freeze
 
       attr_reader :nupkg_file
 
@@ -132,8 +135,8 @@ module Pindo
         puts "✅ 登录成功"
         puts
 
-        # 2. 使用固定的 Nuget 组件库项目 ID
-        nuget_project_id = '5e6b36f61b614ed88086373ef874616c'
+        # 2. 使用固定的 NuGet 登记项目（Unity 组件）
+        nuget_project_id = NUGET_PROJECT_ID
         puts
 
         # 3. 上传文件到存储

data/lib/pindo/module/xcode/res/xcode_res_handler.rb

@@ -12,38 +12,69 @@ module Pindo
             @project_obj = Xcodeproj::Project.open(proj_fullname)
         end
 
-        # 查找工程的 AppIcon.appiconset 目录，找不到返回 nil（不抛异常）
+        DEFAULT_APP_ICON_NAME = "AppIcon".freeze
+        APP_ICON_NAME_SETTING = "ASSETCATALOG_COMPILER_APPICON_NAME".freeze
+
+        # 查找工程的 App 图标集目录（<图标名>.appiconset），找不到返回 nil（不抛异常）
         def find_xcodeproj_icon_path()
-            icon_path = nil
-            select_target = @project_obj.targets.select { |target| target.respond_to?(:product_type) && target.product_type.include?(Xcodeproj::Constants::PRODUCT_TYPE_UTI[:application])  }.first
+            icon_dir_name = "#{app_icon_name}.appiconset"
+
+            # 优先在主 target 自己的 asset catalog 中查找
+            icon_path = main_target_asset_catalogs
+                .map { |catalog| File.join(catalog, icon_dir_name) }
+                .find { |path| File.directory?(path) }
+            return icon_path if icon_path
+
+            icon_path_array = Dir.glob(File.join(@project_obj.project_dir, "**", icon_dir_name))
+            if icon_path_array.size > 1
+                icon_path = icon_path_array.find{ |filename| File.directory?(filename) && filename.include?("Assets.xcassets/#{icon_dir_name}")}
+            elsif icon_path_array.size == 1
+                icon_path = icon_path_array.first
+            end
 
-            project_dir = @project_obj.project_dir
+            return nil if icon_path.nil? || icon_path.empty? || !File.exist?(icon_path)
+            icon_path
+        end
 
-            if !select_target.nil?
-                file_refs = select_target.resources_build_phase.files_references.select { |file| file.display_name.include?("Assets.xcassets") } || []
-                file_refs.each do |file_ref|
-                    icon_path = File.join(file_ref.real_path,"AppIcon.appiconset")
-                    if File.exist?(icon_path)
-                        break
-                    else
-                        next
-                    end
-                end
-            end
-            if icon_path.nil? || icon_path.empty? || !File.exist?(icon_path)
-                icon_path_array = Dir.glob(File.join(project_dir, "**", "AppIcon.appiconset"))
-                if icon_path_array.size > 1
-                    icon_path = icon_path_array.find{ |filename| File.directory?(filename) && filename.include?("Assets.xcassets/AppIcon.appiconset")}
-                elsif icon_path_array.size == 1
-                    icon_path = icon_path_array.first
-                end
+        # 查找 App 图标集目录；工程没有图标集时（如 Xcode 新模板工程），
+        # 在主 target 的 asset catalog 中创建，并设置 ASSETCATALOG_COMPILER_APPICON_NAME
+        def ensure_app_icon_path()
+            icon_path = find_xcodeproj_icon_path()
+            return icon_path if icon_path
+
+            catalog = main_target_asset_catalogs.first
+            if catalog.nil?
+                raise Informative, "没有找到Xcode icon 目录：主 target 中既没有 #{app_icon_name}.appiconset，也没有可存放图标的 .xcassets"
             end
 
-            if icon_path.nil? || icon_path.empty? || !File.exist?(icon_path)
-                return nil
+            icon_path = File.join(catalog, "#{app_icon_name}.appiconset")
+            FileUtils.mkdir_p(icon_path)
+            assign_app_icon_name
+            puts "  ✓ 工程中没有 App 图标集，已创建: #{icon_path}"
+            icon_path
+        end
+
+        # 主 App target 配置的图标名，未配置时为 AppIcon
+        def app_icon_name()
+            names = main_app_target&.build_configurations&.map { |config| config.build_settings[APP_ICON_NAME_SETTING] } || []
+            name = names.compact.map(&:to_s).find { |value| !value.strip.empty? }
+            name || DEFAULT_APP_ICON_NAME
+        end
+
+        # 主 App target 使用的 asset catalog（含文件夹同步方式管理的资源）
+        def main_target_asset_catalogs()
+            target = main_app_target
+            return [] if target.nil?
+
+            referenced = target.resources_build_phase.files_references
+                .select { |file| file.respond_to?(:real_path) && file.real_path.to_s.end_with?(".xcassets") }
+                .map { |file| file.real_path.to_s }
+
+            synchronized = synchronized_group_paths(target).flat_map do |group_path|
+                Dir.glob(File.join(group_path, "**", "*.xcassets")).sort
             end
 
-            return icon_path
+            (referenced + synchronized).uniq.select { |path| File.directory?(path) }
         end
 
         # 工程是否包含 AppIcon 目录（macOS 命令行工具等无 icon 工程返回 false）
@@ -68,7 +99,7 @@ module Pindo
         end
 
         def install_icon_res(new_icon_dir:nil)
-            icon_path = get_xcodeproj_icon_path()
+            icon_path = ensure_app_icon_path()
             begin
                 FileUtils.rm_rf(icon_path)
                 FileUtils.mkdir_p(icon_path)
@@ -265,6 +296,36 @@ module Pindo
 
         end
 
+        private
+
+        def main_app_target()
+            @project_obj.targets.find do |target|
+                target.respond_to?(:product_type) && target.product_type.to_s.include?(Xcodeproj::Constants::PRODUCT_TYPE_UTI[:application])
+            end
+        end
+
+        # 文件夹同步（PBXFileSystemSynchronizedRootGroup）方式管理的 target 目录
+        def synchronized_group_paths(target)
+            return [] unless target.respond_to?(:file_system_synchronized_groups)
+
+            target.file_system_synchronized_groups
+                .map { |group| Xcodeproj::Project::Object::GroupableHelper.real_path(group).to_s }
+                .select { |path| File.directory?(path) }
+        end
+
+        # 未配置图标名的 target 补上 ASSETCATALOG_COMPILER_APPICON_NAME，使图标集参与编译
+        def assign_app_icon_name()
+            target = main_app_target
+            return if target.nil?
+
+            name = app_icon_name
+            missing = target.build_configurations.select { |config| config.build_settings[APP_ICON_NAME_SETTING].to_s.strip.empty? }
+            return if missing.empty?
+
+            missing.each { |config| config.build_settings[APP_ICON_NAME_SETTING] = name }
+            @project_obj.save
+        end
+
     end
 
 end

data/lib/pindo/module/xcode/scene_lifecycle_guard.rb

@@ -21,6 +21,11 @@ module Pindo
       /func\s+application\s*\([^)]*configurationForConnecting\b/
     ).freeze
 
+    # SwiftUI App 生命周期（@main 入口遵循 App 协议）本身基于 UIScene
+    SWIFTUI_APP_PATTERN = /^[ \t]*@main\b[^{]*?\b(?:struct|class|enum)\s+\w+\s*:[^{]*\bApp\b/.freeze
+
+    SCENE_ADOPTION_SOURCE_PATTERN = Regexp.union(SCENE_CONFIGURATION_PATTERN, SWIFTUI_APP_PATTERN).freeze
+
     SOURCE_EXTENSIONS = %w[.m .mm .swift].freeze
 
     EXCLUDED_DIRECTORY_NAMES = %w[.git Pods build DerivedData].freeze
@@ -47,7 +52,7 @@ module Pindo
         )
         return if scene_manifest_declared?(info_plist_path)
         return if scene_manifest_generated?(release_config)
-        return if delegate_provides_scene_configuration?(project_dir)
+        return if sources_adopt_scene_lifecycle?(project_dir)
 
         raise Informative, adoption_error_message(sdk_version, info_plist_path)
       end
@@ -91,13 +96,19 @@ module Pindo
       # Xcode 只在 GENERATE_INFOPLIST_FILE = YES 时采用 INFOPLIST_KEY_* 设置
       def scene_manifest_generated?(release_config)
         settings = release_config.build_settings
-        settings['GENERATE_INFOPLIST_FILE'].to_s.casecmp?('YES') &&
-          settings[SCENE_MANIFEST_GENERATION_SETTING].to_s.casecmp?('YES')
+        iphoneos_setting(settings, 'GENERATE_INFOPLIST_FILE').to_s.casecmp?('YES') &&
+          iphoneos_setting(settings, SCENE_MANIFEST_GENERATION_SETTING).to_s.casecmp?('YES')
+      end
+
+      # iOS 真机构建实际生效的值：[sdk=iphoneos*] 条件设置优先于无条件设置（多平台模板只写条件设置）
+      def iphoneos_setting(settings, key)
+        _name, conditional = settings.find { |name, _value| name.start_with?("#{key}[sdk=iphoneos") }
+        conditional.nil? ? settings[key] : conditional
       end
 
-      def delegate_provides_scene_configuration?(project_dir)
+      def sources_adopt_scene_lifecycle?(project_dir)
         each_source_file(project_dir).any? do |path|
-          File.binread(path).match?(SCENE_CONFIGURATION_PATTERN)
+          File.binread(path).match?(SCENE_ADOPTION_SOURCE_PATTERN)
         end
       end
 

data/lib/pindo/module/xcode/xcode_build_config.rb

@@ -11,6 +11,18 @@ module Pindo
 
     class XcodeBuildConfig
 
+        # 未提供任何 Bundle ID 线索时，工作流推导 Bundle ID 使用的前缀
+        DEFAULT_BUNDLE_ID_PREFIX = "com.heroneverdie101".freeze
+
+        # 从 Bundle ID 提取前缀：通配 ID 去掉 ".*"，具体 ID 去掉最后一段
+        # @param bundle_id [String, nil] 如 "com.example.*" 或 "com.example.app"
+        # @return [String, nil] 如 "com.example"；无法提取时返回 nil
+        def self.bundle_id_prefix_from(bundle_id)
+            value = bundle_id.to_s.strip
+            prefix = value.end_with?(".*") ? value.chomp(".*") : value.rpartition(".").first
+            prefix.empty? || prefix.include?("*") ? nil : prefix
+        end
+
         # 使用package_name一次性更新Display Name、Bundle ID和URL Schemes（基于package_name）
         # 优化版本：只读写一次plist文件，提高性能
         # 注意：此函数只添加基于package_name的URL Scheme，基于实际Bundle ID的URL Scheme
@@ -19,8 +31,9 @@ module Pindo
         # @param workflow_packname [String] 工作流的名称（如："Test Demo"）
         # @param project_id [String] JPS项目ID（可选，用于添加快捷操作）
         # @param bundle_id [String] 显式指定的 Bundle ID（可选，来自 --bundleid）
+        # @param bundle_id_prefix [String] 工作流推导 Bundle ID 的前缀（可选，如 "com.example"）
         # @return [Boolean] 是否成功更新
-        def self.update_project_with_workflow(project_dir: nil, workflow_packname: nil, project_id: nil, bundle_id: nil)
+        def self.update_project_with_workflow(project_dir: nil, workflow_packname: nil, project_id: nil, bundle_id: nil, bundle_id_prefix: nil)
             raise ArgumentError, "项目目录不能为空" if project_dir.nil?
             raise ArgumentError, "Workflow Package Name不能为空" if workflow_packname.nil?
 
@@ -30,10 +43,14 @@ module Pindo
 
             # Bundle ID 优先使用显式传入的值（--bundleid），未传时按工作流名推导。
             # 通配符（如 com.example.*）不能作为工程的 PRODUCT_BUNDLE_IDENTIFIER，
-            # 与 BaseCertOperator#configure_target_build_settings 的处理保持一致，退回推导值。
+            # 与 BaseCertOperator#configure_target_build_settings 的处理保持一致，退回推导值，
+            # 推导值的前缀依次取 bundle_id_prefix、通配 ID 的前缀、默认前缀。
             explicit_bundle_id = bundle_id.to_s.strip
             use_explicit_bundle_id = !explicit_bundle_id.empty? && !explicit_bundle_id.include?("*")
-            final_bundle_id = use_explicit_bundle_id ? explicit_bundle_id : "com.heroneverdie101.#{package_scheme}"
+            derived_prefix = bundle_id_prefix.to_s.strip
+            derived_prefix = bundle_id_prefix_from(explicit_bundle_id).to_s if derived_prefix.empty?
+            derived_prefix = DEFAULT_BUNDLE_ID_PREFIX if derived_prefix.empty?
+            final_bundle_id = use_explicit_bundle_id ? explicit_bundle_id : "#{derived_prefix}.#{package_scheme}"
 
             project_fullname = Dir.glob(File.join(project_dir, "/*.xcodeproj")).max_by {|f| File.mtime(f)}
             return false if project_fullname.nil?
@@ -315,6 +332,33 @@ module Pindo
         # @param version [String] 版本号
         # @param build_number [Integer] Build号
         # @return [Boolean] 是否成功更新
+        # 把纯数字版本补齐为 major.minor.patch（JPS 要求的格式），如 "1.0" => "1.0.0"
+        # @param version [String, nil] 工程中的版本号
+        # @return [String, nil] 补齐后的版本号；含变量、后缀或超过三段时返回 nil
+        def self.normalize_marketing_version(version)
+            value = version.to_s.strip
+            return nil unless value.match?(/\A\d+(\.\d+){0,2}\z/)
+
+            segments = value.split(".")
+            (segments + ["0"] * (3 - segments.size)).join(".")
+        end
+
+        # 读取主 App target 当前的版本号与 Build 号（Release 配置优先）
+        # @param project_dir [String] 项目目录
+        # @return [Array(String, String)] [MARKETING_VERSION, CURRENT_PROJECT_VERSION]，取不到时为 nil
+        def self.current_app_version(project_dir:)
+            xcodeproj_path = find_xcodeproj(project_dir)
+            return [nil, nil] if xcodeproj_path.nil?
+
+            target = Xcodeproj::Project.open(xcodeproj_path).targets.find do |t|
+                t.respond_to?(:product_type) && t.product_type.to_s.eql?("com.apple.product-type.application")
+            end
+            return [nil, nil] if target.nil?
+
+            config = target.build_configurations.find { |c| c.name == "Release" } || target.build_configurations.first
+            [config.build_settings['MARKETING_VERSION'], config.build_settings['CURRENT_PROJECT_VERSION']]
+        end
+
         def self.update_ios_project_version(project_dir: nil, version: nil, build_number: nil)
             raise ArgumentError, "项目目录不能为空" if project_dir.nil?
             raise ArgumentError, "版本号不能为空" if version.nil?

data/lib/pindo/options/groups/jps_options.rb

@@ -177,13 +177,13 @@ module Pindo
 
           workflow_name: OptionItem.new(
             key: :workflow_name,
-            name: '工作流名称',
-            description: '按名称指定工作流，用于某类型匹配到多个工作流时消歧（非交互场景使用）',
+            name: '工作流/工具名称',
+            description: '按名称精确选择 Git 工作流或安装包工具（工具可匹配 name、subtitle 或 name（subtitle）），用于同类型多个时消歧（非交互场景使用）',
             type: String,
             env_name: 'PINDO_JPS_WORKFLOW_NAME',
             optional: true,
             cacheable: false,
-            example: 'pindo jps config --proj=MyApp --type=ipa --workflow_name="iOS IPA Upload"'
+            example: 'pindo jps config --proj=MyApp --type=ipa --workflow_name="iOS提交包"'
           )
         }
       end

data/lib/pindo/version.rb

@@ -6,7 +6,7 @@ require 'time'
 
 module Pindo
 
-  VERSION = "5.21.4"
+  VERSION = "5.22.0"
 
   class VersionCheck
     RUBYGEMS_API = 'https://rubygems.org/api/v1/gems/pindo.json'

data/lib/pindo.rb

@@ -10,6 +10,7 @@ module Pindo
   	autoload :Executable,                'pindo/base/executable'
   	autoload :Plistbuddyexecutable,      'pindo/base/plistbuddyexecutable'
 
+	require 'pindo/base/xcodeproj_compat'
 	require 'pindo/command'
 	require 'pindo/version'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pindo
 version: !ruby/object:Gem::Version
-  version: 5.21.4
+  version: 5.22.0
 platform: ruby
 authors:
 - wade
@@ -272,6 +272,7 @@ files:
 - lib/pindo/base/plaininformative.rb
 - lib/pindo/base/plistbuddyexecutable.rb
 - lib/pindo/base/standarderror.rb
+- lib/pindo/base/xcodeproj_compat.rb
 - lib/pindo/client/applovinclient.rb
 - lib/pindo/client/aws3sclient.rb
 - lib/pindo/client/bossclient.rb
@@ -535,7 +536,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 3.0.0
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.10
 specification_version: 4
 summary: easy work
 test_files: []