pindo 5.18.6 → 5.18.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 507433d1ad0c9e38e5c143ed5bd5464a0a4935b274803aa8ec28d48f8edd7d8c
-  data.tar.gz: 1e5e3fa81ef4c65da10dd1a64d234e68098a5539c29e8f13674245b7600a6ad5
+  metadata.gz: d3b74ddb66022968993f331b407f3a50a41d94a827e15e75f75dac1b8d5aadc1
+  data.tar.gz: '08c5e2e855359f4369e02cb6cab841d38e3344794a7d4e8f9b0f2695683d1da2'
 SHA512:
-  metadata.gz: e49b021ce357d5f50a53bf308ff4267fa82cd2ff89bbdf8dd3649b0b871eaac6909d65abce3e9e72145724ccde41aae8a9ded3f94052b880f520f1eeb947693d
-  data.tar.gz: 27bda2c8b2a7cd1e41fdfcf510508628cc4b2fbe3481b2a83077075a68097989b69215d3a4e3cb07257dec05a0f6ad812645923d83b4a5bb5ba9050fb570bba7
+  metadata.gz: 6c1c36ddcf83fcff151bdd21e8e3104eec862b5c72aa15303a8fe3cae4f9be0dd36f37e2cee24d293e6ace76f895c72f057a18f12485c6d4a08905bb49350e21
+  data.tar.gz: 1f3a484ff340bd398d150960753bb541103aca2b5a8ba30e712733c029e209c9fdfcb7db6c2d80b7c1bb1e1c8202d3319600ab12d23c4cb928c3f55c2390e74c

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

@@ -96,7 +96,7 @@ module Pindo
         # 定义此命令使用的参数项
         def self.option_items
           @option_items ||= Pindo::Options::OptionGroup.merge(
-            Pindo::Options::BuildOptions.select(:bundle_name, :release, :skipclean, :skipvalidate, :injectsigning),
+            Pindo::Options::BuildOptions.select(:bundle_name, :release),
             Pindo::Options::JPSOptions.select(:conf, :upload, :media, :bind, :send),
             Pindo::Options::UnityOptions.select(:skiplib, :skipyoo),
             Pindo::Options::UnityOptions.select_with_defaults(skipmacro: true),
@@ -147,7 +147,7 @@ module Pindo
         end
 
         def run
-          pindo_project_dir = Dir.pwd
+          pindo_project_dir = safe_pwd!
 
           begin
             # 加载 JPS 配置（缓存 project_name，并通过映射表解析 bundle_id）
@@ -182,6 +182,19 @@ module Pindo
 
         private
 
+        # 有些场景下（例如用户删除了当前所在目录、或 shell 的 cwd 已失效），Dir.pwd 会抛 Errno::ENOENT。
+        # 这里做一次兜底：尝试切换到 ENV["PWD"]（若可用），否则回退到 HOME，确保命令可继续执行并给出更可理解的行为。
+        def safe_pwd!
+          Dir.pwd
+        rescue Errno::ENOENT
+          fallback = ENV["PWD"]
+          fallback = nil unless fallback && File.directory?(fallback)
+          fallback ||= Dir.home
+
+          Dir.chdir(fallback)
+          Dir.pwd
+        end
+
         # 解析 bundle_name（优先级：命令行参数 > JPSBuildConfig映射 > prepare_upload交互选择）
         def resolve_bundle_name!
           # 优先级 1：命令行 --bundle_name 参数

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

@@ -101,7 +101,7 @@ module Pindo
                 # 定义此命令使用的参数项
                 def self.option_items
                     @option_items ||= Pindo::Options::OptionGroup.merge(
-                        Pindo::Options::BuildOptions.select(:bundleid, :bundle_name, :types, :release, :adhoc, :skipclean, :skipvalidate, :injectsigning),
+                        Pindo::Options::BuildOptions.select(:bundleid, :bundle_name, :types, :release, :adhoc),
                         Pindo::Options::JPSOptions.select(:conf, :upload, :send, :media, :bind),
                         Pindo::Options::UnityOptions.select(:skiplib, :skipyoo, :kill_unity),
                         Pindo::Options::UnityOptions.select_with_defaults(skipmacro: true),

data/lib/pindo/command/utils/gitconfig.rb

@@ -0,0 +1,268 @@
+require 'fileutils'
+require 'highline'
+require 'pindo/base/git_handler'
+require 'pindo/module/utils/git_hook_helper'
+
+module Pindo
+  class Command
+    class Utils < Command
+      class Gitconfig < Utils
+
+        self.summary = '设置 pindo 全局 Git 配置与 commit 变更统计 hook'
+
+        self.description = <<-DESC
+                    一次性配置本机全局 Git 环境，使所有 Git 仓库共享同一套 pindo 约定。
+
+                    支持功能:
+
+                        * 设置 Git 用户身份 (交互式):
+                          - user.name  要求与飞书账号用户名一致，便于团队识别提交人
+                          - user.email 要求与注册 gitee.com 等代码仓库的邮箱一致
+                          - 已设置的值会显示当前值并询问是否修改，默认保留
+
+                        * 设置全局 Git 配置:
+                          - 禁止大小写:      core.ignorecase = false
+                          - 禁止自动 rebase: pull.rebase     = false
+                          - git 缓存内存大小: http.postBuffer = 157286400
+
+                        * 自动安装并配置 git-lfs:
+                          - 未检测到时通过 Homebrew 自动安装
+                          - 运行 git lfs install --skip-repo 写全局 filter 配置
+                          - 通过全局 hook (pre-push / post-checkout / post-commit /
+                            post-merge) 让 git-lfs 全局生效，无需逐仓库 git lfs install
+                          - 已知行为: 若仓库本地已有 git lfs install 生成的同名 hook，
+                            LFS 会被调用两次（LFS 幂等无副作用，但 pre-push 会多一次
+                            LFS 对象检查耗时; 这是为了保证自定义 hybrid hook 不被吞的
+                            主动权衡）
+
+                        * 安装全局 commit 变更统计 hook (通过 core.hooksPath):
+                          - 目标目录: 自适应已有 core.hooksPath，默认 ~/.git-hooks/
+                          - prepare-commit-msg: 完全接管，自动追加变更统计
+                          - 27 个转发桩: 4 个 LFS-aware + 23 个纯转发（尊重 foreign 文件）
+
+                    使用示例:
+
+                        $ pindo utils gitconfig
+
+                    撤销方式:
+
+                        $ git config --global --unset core.hooksPath
+                        $ git config --global --unset core.ignorecase
+                        $ git config --global --unset pull.rebase
+                        $ git config --global --unset http.postBuffer
+                        $ git lfs uninstall --skip-repo
+                        $ rm -rf ~/.git-hooks
+        DESC
+
+        self.arguments = []
+
+        # 需要统一设置的全局 Git 配置（按团队约定）
+        # value: 目标值 / desc: 中文含义（用于日志输出）
+        GLOBAL_CONFIGS = {
+          'core.ignorecase' => { value: 'false',     desc: '禁止大小写' },
+          'pull.rebase'     => { value: 'false',     desc: '禁止自动rebase' },
+          'http.postBuffer' => { value: '157286400', desc: 'git缓存内存大小' },
+        }.freeze
+
+        def run
+          # --verbose 通过 ENV 向下传递到 GitHookHelper（helper 没有 CLAide 上下文）
+          ENV['PINDO_DEBUG'] ||= '1' if pindo_verbose?
+
+          if pindo_verbose?
+            puts ""
+            puts "==> pindo utils gitconfig：配置本机全局 Git 环境"
+            puts "    共 5 个步骤：用户身份 → Git 配置 → git-lfs 安装 → LFS filter → 全局 hook"
+          end
+
+          # 汇总 5 项全局 Git 配置，step [1/5] 和 [2/5] 处理完后统一打印
+          @final_configs = []
+
+          step_header(1, "设置 Git 用户身份 (user.name / user.email)")
+          setup_git_user_identity
+
+          step_header(2, "设置全局 Git 配置")
+          apply_global_git_configs
+
+          print_global_configs_summary
+
+          step_header(3, "检查并安装 git-lfs")
+          ensure_git_lfs_installed
+
+          step_header(4, "配置 git-lfs 全局 filter")
+          setup_git_lfs_filters
+
+          step_header(5, "安装全局 Git hook")
+          Pindo::GitHookHelper.share_instance.install_global_commit_stats_hook
+
+          puts "" if pindo_verbose?
+          Funlog.instance.fancyinfo_success("pindo utils gitconfig 全部完成 ✓")
+        end
+
+        private
+
+        # 打印 [1/5] + [2/5] 共 5 项全局 Git 配置的汇总
+        def print_global_configs_summary
+          puts ""
+          Funlog.instance.fancyinfo_start("全局 Git 配置汇总 (#{@final_configs.size} 项):")
+          @final_configs.each do |cfg|
+            line = "  #{cfg[:desc]}：#{cfg[:key]} = #{cfg[:value]}"
+            line += "（#{cfg[:note]}）" if cfg[:note]
+            if cfg[:status] == :updated
+              Funlog.instance.fancyinfo_update(line)
+            else
+              Funlog.instance.fancyinfo_success(line)
+            end
+          end
+          puts ""
+        end
+
+        # verbose 模式：--verbose 或 PINDO_DEBUG 环境变量
+        # 用 pindo_ 前缀避免与 CLAide 内部 verbose? 的方法可见性冲突
+        def pindo_verbose?
+          @verbose || !ENV['PINDO_DEBUG'].to_s.empty?
+        end
+
+        def step_header(n, title)
+          return unless pindo_verbose?
+          puts ""
+          puts "[#{n}/5] #{title}"
+        end
+
+        def vstart(msg)
+          Funlog.instance.fancyinfo_start(msg) if pindo_verbose?
+        end
+
+        # 检测 git-lfs 是否已安装，未安装时通过 Homebrew 自动安装
+        def ensure_git_lfs_installed
+          vstart("检查 git-lfs 安装状态...")
+          if system('command -v git-lfs > /dev/null 2>&1')
+            lfs_version = `git-lfs version 2>/dev/null`.strip
+            Funlog.instance.fancyinfo_success("git-lfs 已安装 (#{lfs_version})")
+            return
+          end
+
+          Funlog.instance.fancyinfo_warning("未检测到 git-lfs，准备通过 Homebrew 自动安装")
+          unless system('command -v brew > /dev/null 2>&1')
+            Funlog.instance.fancyinfo_error("Homebrew 未安装，无法自动安装 git-lfs")
+            Funlog.instance.fancyinfo_error("请手动安装 git-lfs 后重试: https://git-lfs.com/")
+            raise Informative, "git-lfs not installed and brew unavailable"
+          end
+
+          # 显式关闭 brew auto-update + env hints
+          # auto-update 会触发 brew 仓库的 git fetch，在无交互式凭据的环境下
+          # （例如 CI、GIT_TERMINAL_PROMPT=0）会卡死或报错，与本次安装无关
+          brew_env = {
+            'HOMEBREW_NO_AUTO_UPDATE' => '1',
+            'HOMEBREW_NO_ENV_HINTS'   => '1',
+          }
+          vstart("执行: HOMEBREW_NO_AUTO_UPDATE=1 brew install git-lfs")
+          unless system(brew_env, 'brew', 'install', 'git-lfs')
+            Funlog.instance.fancyinfo_error("brew install git-lfs 失败")
+            Funlog.instance.fancyinfo_error("请手动执行以上命令排查后重试")
+            raise Informative, "brew install git-lfs failed"
+          end
+          Funlog.instance.fancyinfo_success("git-lfs 已安装")
+        end
+
+        # 设置 git-lfs 全局 filter 配置（写入 ~/.gitconfig，不触碰任何仓库的 .git/hooks/）
+        def setup_git_lfs_filters
+          vstart("执行: git lfs install --skip-repo（写入 ~/.gitconfig 的 filter.lfs.* 配置）")
+          Pindo::GitHandler.git!(%w(lfs install --skip-repo))
+          Funlog.instance.fancyinfo_success("git-lfs filter 已配置")
+        end
+
+        # 交互式设置 Git 用户身份 (user.name / user.email)
+        # - 已设置 → 显示当前值，询问是否修改（默认 N）
+        # - 未设置 → 强制提示，并明确告知命名要求
+        def setup_git_user_identity
+          ensure_git_user_field(
+            key:      'user.name',
+            label:    'Git 提交用户名',
+            hint:     '请确保与飞书账号的用户名保持一致（便于团队识别提交人）',
+            prompt:   '请输入 Git 提交用户名',
+            validator: ->(v) { !v.strip.empty? },
+            error_msg: '用户名不能为空'
+          )
+
+          ensure_git_user_field(
+            key:      'user.email',
+            label:    'Git 提交邮箱',
+            hint:     '请确保与注册 gitee.com 等代码仓库使用的邮箱一致（否则提交可能无法关联到个人账号）',
+            prompt:   '请输入 Git 提交邮箱',
+            validator: ->(v) { v.strip.match?(/\A[^@\s]+@[^@\s]+\.[^@\s]+\z/) },
+            error_msg: '邮箱格式不合法，请输入形如 user@example.com 的地址'
+          )
+        end
+
+        def ensure_git_user_field(key:, label:, hint:, prompt:, validator:, error_msg:)
+          current = begin
+            Pindo::GitHandler.git!(%W(config --global --get #{key})).strip
+          rescue
+            ''
+          end
+
+          if !current.empty?
+            cli = HighLine.new
+            answer = cli.ask("  当前#{label}是 #{current}，是否修改？[y/N] ")
+            unless answer.to_s.strip.downcase.start_with?('y')
+              @final_configs << { desc: label, key: key, value: current, status: :kept }
+              return
+            end
+          else
+            Funlog.instance.fancyinfo_warning("  当前#{label}未设置，需要设置")
+          end
+
+          puts ""
+          puts "  ⚠ #{hint}"
+          puts ""
+
+          new_value = nil
+          cli = HighLine.new
+          loop do
+            new_value = cli.ask("  #{prompt}: ").to_s.strip
+            break if validator.call(new_value)
+            Funlog.instance.fancyinfo_warning("  #{error_msg}")
+          end
+
+          Pindo::GitHandler.git!(%W(config --global #{key} #{new_value}))
+          if current.empty?
+            @final_configs << { desc: label, key: key, value: new_value, status: :new, note: '新增' }
+          else
+            @final_configs << { desc: label, key: key, value: new_value, status: :updated, note: "更新: #{current} → #{new_value}" }
+          end
+        end
+
+        def apply_global_git_configs
+          if pindo_verbose?
+            Funlog.instance.fancyinfo_start("即将设置 #{GLOBAL_CONFIGS.size} 项全局 Git 配置（直接覆盖策略）:")
+            GLOBAL_CONFIGS.each do |key, cfg|
+              Funlog.instance.fancyinfo_start("  - #{cfg[:desc]}：#{key} → #{cfg[:value]}")
+            end
+          end
+          GLOBAL_CONFIGS.each { |key, cfg| ensure_global_config(key, cfg[:value], cfg[:desc]) }
+        end
+
+        def ensure_global_config(key, expected, desc)
+          current = begin
+            Pindo::GitHandler.git!(%W(config --global --get #{key})).strip
+          rescue
+            ''
+          end
+
+          if current == expected
+            @final_configs << { desc: desc, key: key, value: expected, status: :kept }
+          elsif current.empty?
+            vstart("  #{desc}：#{key} 未设置，写入 #{expected}")
+            Pindo::GitHandler.git!(%W(config --global #{key} #{expected}))
+            @final_configs << { desc: desc, key: key, value: expected, status: :new, note: '新增' }
+          else
+            vstart("  #{desc}：#{key} 当前 #{current}，覆盖为 #{expected}")
+            Pindo::GitHandler.git!(%W(config --global #{key} #{expected}))
+            @final_configs << { desc: desc, key: key, value: expected, status: :updated, note: "覆盖: #{current} → #{expected}" }
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/pindo/command/utils.rb

@@ -11,6 +11,7 @@ require 'pindo/command/utils/renewcert'
 # require 'pindo/command/utils/copyconfig'
 # require 'pindo/command/utils/allcopyconfig'
 require 'pindo/command/utils/repoinit'
+require 'pindo/command/utils/gitconfig'
 # require 'pindo/command/utils/tag'
 require 'pindo/command/utils/updateconfig'
 require 'pindo/command/utils/fabric'

data/lib/pindo/module/android/android_build_helper.rb

@@ -73,16 +73,21 @@ module Pindo
             unless build_so_library(unity_dir)
               raise RuntimeError, "编译 Unity 模块 SO 库失败"
             end
-            copy_so_files(unity_dir, project_dir)
-            validate_unity_libs_state!(project_dir, stage: "导出后")
-
-            # SO 库拷贝完成后，重新配置主工程的 Java Home 和 Gradle 环境
-            puts "Unity SO库编译完成，切换到主工程编译环境"
-            Pindo::JavaEnvHelper.setup_java_home_from_project(project_dir, use_main: true)
-            Pindo::GradleHelper.check_gradle_with_project(project_dir, configure_main: true)
           else
             puts "未检测到 IL2CPP 目录，可能使用 Mono 后端，跳过 SO 库构建"
           end
+
+          # 无论 IL2CPP 或 Mono，均需要将 Unity 导出工程的关键产物同步回主工程：
+          # - unityLibrary/libs（Java/Kotlin 库）
+          # - unityLibrary/src/main/assets（StreamingAssets 等资源）
+          # - unityLibrary/src/main/jniLibs（若存在）
+          copy_so_files(unity_dir, project_dir)
+          validate_unity_libs_state!(project_dir, stage: "导出后")
+
+          # 同步完成后，重新配置主工程的 Java Home 和 Gradle 环境
+          puts "Unity 产物同步完成，切换到主工程编译环境"
+          Pindo::JavaEnvHelper.setup_java_home_from_project(project_dir, use_main: true)
+          Pindo::GradleHelper.check_gradle_with_project(project_dir, configure_main: true)
         else
           puts "警告：Unity 作为 lib 的工程，但未找到 Unity 目录"
         end
@@ -101,33 +106,81 @@ module Pindo
       build_type = debug ? "debug" : "release"
       raise "bundle_name 不能为空，Keystore 签名需要 Application ID" if bundle_name.nil? || bundle_name.empty?
 
-      unless Pindo::KeystoreHelper.apply_keystore_config(project_dir, build_type, bundle_id: bundle_name)
-        raise RuntimeError, "Keystore 签名配置失败"
-      end
-      puts "✓ Android 签名配置成功"
-
-      if workflow_name && !workflow_name.to_s.empty?
-        injector = Pindo::Android::WorkflowGradleInjector.new
-        ctx = injector.prepare!(
-          project_dir: project_dir,
-          workflow_name: workflow_name,
-          enable_pad: true
-        )
-        apk_path = nil
-        begin
-          apk_path = build_apk(project_dir, debug, workflow_build_type: ctx[:workflow_build_type])
-        ensure
-          injector.cleanup!(ctx)
+      apk_path = nil
+      begin
+        unless Pindo::KeystoreHelper.apply_keystore_config(project_dir, build_type, bundle_id: bundle_name)
+          raise RuntimeError, "Keystore 签名配置失败"
         end
-        # JKS 仅在 universal.apk 已成功产出后删除；失败则保留，便于排查（Gradle 注入已在 ensure 中恢复）
-        Pindo::KeystoreHelper.cleanup_managed_signing_paths! if apk_path && File.exist?(apk_path.to_s)
-        Pindo::Android::WorkflowGradleInjector.remove_project_pindo_tmp_dir!(project_dir)
-      else
-        # 兼容旧行为：仍会永久写入 PAD 相关变更（如需临时恢复，请传 workflow_name 走注入管线）
-        setup_play_asset_delivery(project_dir)
-        apk_path = build_apk(project_dir, debug)
-        Pindo::KeystoreHelper.cleanup_managed_signing_paths! if apk_path && File.exist?(apk_path.to_s)
+        puts "✓ Android 签名配置成功"
+
+        if workflow_name && !workflow_name.to_s.empty?
+          pad_persist = pad_persist_enabled?
+
+          # 永久 PAD：每次构建前清理旧的 *_pack，并从当前导出产物重新生成
+          # 注意：PAD 会移动 unityLibrary/src/main/assets 下的目录到 *_pack；
+          # 因此要保证在此之前已经把 Unity/ 导出产物同步回主工程（Unity as lib 分支已同步）。
+          setup_play_asset_delivery_persistent(project_dir) if pad_persist
+
+          injector = Pindo::Android::WorkflowGradleInjector.new
+          ctx = injector.prepare!(
+            project_dir: project_dir,
+            workflow_name: workflow_name,
+            enable_pad: !pad_persist
+          )
+          begin
+            apk_path = build_apk(project_dir, debug, workflow_build_type: ctx[:workflow_build_type])
+          ensure
+            injector.cleanup!(ctx)
+            Pindo::Android::WorkflowGradleInjector.remove_project_pindo_tmp_dir!(project_dir)
+          end
+        else
+          # 兼容旧行为：仍会永久写入 PAD 相关变更（如需临时恢复，请传 workflow_name 走注入管线）
+          setup_play_asset_delivery(project_dir)
+          apk_path = build_apk(project_dir, debug)
+        end
+      ensure
+        # 安全优先：无论成功/失败，均清理本次下载/拷贝到工程 signing/ 的签名文件，并恢复本次改动的 Gradle 签名配置与进程 ENV。
+        # 说明：这会降低“失败后保留签名文件便于排查”的便利性，但可以显著降低泄露风险。
+        Pindo::KeystoreHelper.cleanup_managed_signing_paths!
+        Pindo::KeystoreHelper.restore_managed_signing_config!
+        Pindo::KeystoreHelper.cleanup_managed_signing_env!
+      end
+    end
+
+    private def pad_persist_enabled?
+      # 默认开启永久 PAD（避免 workflow 注入管线在 cleanup 时删除 *_pack）
+      # 如需回到“临时 PAD（构建结束自动回滚）”，可显式设置：
+      #   export PINDO_PAD_PERSIST=0
+      val = ENV.fetch("PINDO_PAD_PERSIST", nil)
+      return true if val.nil?
+
+      v = val.to_s.strip.downcase
+      return true if v.empty?
+      return false if %w[0 false no off].include?(v)
+
+      true
+    end
+
+    # 永久 PAD：先清理旧的 *_pack，再从当前 assets 生成新的 pack
+    private def setup_play_asset_delivery_persistent(project_dir)
+      # 仅 Unity 导出工程才有 unityLibrary/src/main/assets
+      unity_assets = File.join(project_dir, "unityLibrary", "src", "main", "assets")
+      return unless File.directory?(unity_assets)
+
+      # 清理旧 pack：避免 assets 内容变化后残留旧 pack 目录导致重复/脏数据
+      Dir.glob(File.join(project_dir, "*_pack")).each do |dir|
+        next unless File.directory?(dir)
+
+        # 尽量只删除我们生成的模块：要求 build.gradle 存在且包含 asset-pack 插件
+        gradle = File.join(dir, "build.gradle")
+        next unless File.file?(gradle)
+        content = File.read(gradle)
+        next unless content.include?("com.android.asset-pack")
+
+        FileUtils.rm_rf(dir)
       end
+
+      setup_play_asset_delivery(project_dir)
     end
 
     def build_apk(project_path, debug, workflow_build_type: nil)
@@ -142,13 +195,6 @@ module Pindo
       main_module = Pindo::AndroidProjectHelper.get_main_module(project_path)
       raise ArgumentError, "无法找到主模块" unless main_module
 
-      keystore_config = Pindo::KeystoreHelper.get_keystore_config_from_project(
-        project_path,
-        debug,
-        workflow_build_type: workflow_build_type
-      )
-      raise ArgumentError, "无法从 build.gradle 中获取 keystore 信息" unless keystore_config
-
       build_tools = Pindo::AndroidProjectHelper.get_build_tools
       unless build_tools
         Funlog.error("无法继续构建：缺少必要的构建工具")
@@ -209,29 +255,27 @@ module Pindo
       end
       # --- END ---
 
-      # puts "解析 keystore 配置"
-      # 与 Gradle 对 storeFile 的生效顺序一致：常见写法为
-      #   storeFile file(System.getenv("RELEASE_KEYSTORE_PATH") ?: "signing/gxdebug.jks")
-      # apply_keystore_config 已在当前进程设置 RELEASE_*，Gradle 打 AAB 时走 ENV 指向的真实 jks；
-      # get_keystore_config_from_project 若只解析到 ?: 右侧占位路径，会与 AAB 实际签名不一致且文件可能不存在。
-      # 故：当 RELEASE_KEYSTORE_PATH 展开后文件存在时，bundletool 必须使用同一套 RELEASE_*（非「失败回退」）。
       kh = Pindo::KeystoreHelper
       env_ks = ENV[kh::ENV_RELEASE_KEYSTORE_PATH]
       env_ks_abs = env_ks && !env_ks.to_s.empty? ? File.expand_path(env_ks) : nil
-      gradle_ks = keystore_config[:store_file]
-
-      use_release_env = env_ks_abs && File.exist?(env_ks_abs)
-      if use_release_env
-        ks = env_ks_abs
-        ks_pass = ENV[kh::ENV_RELEASE_KEYSTORE_PASSWORD] || keystore_config[:store_password]
-        key_alias = ENV[kh::ENV_RELEASE_KEY_ALIAS] || keystore_config[:key_alias]
-        key_pass = ENV[kh::ENV_RELEASE_KEY_PASSWORD] || keystore_config[:key_password]
-      else
-        ks = gradle_ks || env_ks
-        ks = File.expand_path(ks.to_s) if ks && !ks.to_s.empty?
-        ks_pass = keystore_config[:store_password] || ENV[kh::ENV_RELEASE_KEYSTORE_PASSWORD]
-        key_alias = keystore_config[:key_alias] || ENV[kh::ENV_RELEASE_KEY_ALIAS]
-        key_pass = keystore_config[:key_password] || ENV[kh::ENV_RELEASE_KEY_PASSWORD]
+      # 签名信息只允许从环境变量读取，禁止从 build.gradle 解析值作为回退来源。
+      # 这样可以避免「环境变量缺失时悄悄退回到 Gradle 文本里的占位/历史明文」导致签名不一致。
+      ks = env_ks_abs
+      ks_pass = ENV.fetch(kh::ENV_RELEASE_KEYSTORE_PASSWORD, nil)
+      key_alias = ENV.fetch(kh::ENV_RELEASE_KEY_ALIAS, nil)
+      key_pass = ENV.fetch(kh::ENV_RELEASE_KEY_PASSWORD, nil)
+
+      missing_env = []
+      missing_env << kh::ENV_RELEASE_KEYSTORE_PATH if env_ks_abs.nil? || env_ks_abs.to_s.empty?
+      missing_env << kh::ENV_RELEASE_KEYSTORE_PASSWORD if ks_pass.to_s.empty?
+      missing_env << kh::ENV_RELEASE_KEY_ALIAS if key_alias.to_s.empty?
+      missing_env << kh::ENV_RELEASE_KEY_PASSWORD if key_pass.to_s.empty?
+      unless missing_env.empty?
+        raise RuntimeError, "缺少 Android release 签名所需环境变量：#{missing_env.join(', ')}"
+      end
+
+      unless File.exist?(ks)
+        raise RuntimeError, "Keystore 文件不存在: #{ks}"
       end
 
       ks_display = ks && !ks.to_s.empty? ? File.expand_path(ks.to_s) : ks.to_s
@@ -239,7 +283,7 @@ module Pindo
       # if workflow_build_type && !workflow_build_type.to_s.empty?
       #   puts "[bundletool] workflow buildType: #{workflow_build_type}"
       # end
-      # puts "[bundletool] 签名来源: #{use_release_env ? "RELEASE_KEYSTORE_PATH（文件存在，与 Gradle 打 AAB 一致）" : "build.gradle 解析 / ENV 兜底（非 RELEASE 路径或文件不存在时）"}"
+      # puts "[bundletool] 签名来源: RELEASE_* 环境变量（强制）"
       # puts "[bundletool] keyAlias: #{key_alias.inspect}（口令不落日志）"
 
       # 构建 APK
@@ -270,7 +314,7 @@ module Pindo
       end
 
       if ks.nil? || ks.to_s.empty?
-        raise RuntimeError, "Keystore 路径为空：无法从 build.gradle 解析签名配置，且未从环境变量获取到 #{Pindo::KeystoreHelper::ENV_RELEASE_KEYSTORE_PATH}"
+        raise RuntimeError, "Keystore 路径为空：未从环境变量获取到 #{Pindo::KeystoreHelper::ENV_RELEASE_KEYSTORE_PATH}"
       end
 
       unless File.exist?(ks)
@@ -314,12 +358,9 @@ module Pindo
                   end
 
       bundle_task = "#{prefix}#{task_name}"
-      skip_clean = Pindo::Options::GlobalOptionsState.instance[:skipclean]
-      # 任意 bundle 变体（含 debug）均先 clean，避免 aabresguard 等任务因残留输出报「文件已存在」；可通过 --skipclean 或 PINDO_SKIP_GRADLE_CLEAN=1 跳过
-      puts '  AAB 构建前先执行 Gradle clean（--skipclean 可跳过）' unless skip_clean
-      puts '  已跳过 Gradle clean（--skipclean）' if skip_clean
-
-      gradle_clean_resilient!(project_path) unless skip_clean
+      # 任意 bundle 变体（含 debug）均先 clean，避免 aabresguard 等任务因残留输出报「文件已存在」
+      puts '  AAB 构建前先执行 Gradle clean'
+      gradle_clean_resilient!(project_path)
 
       cmd = "cd \"#{project_path}\" && ./gradlew --no-daemon #{bundle_task}"
       system(cmd)
@@ -440,8 +481,7 @@ module Pindo
     def validate_unity_libs_state!(android_root, stage:)
       # 某些项目会将 unityLibrary 作为缓存/中间产物纳入仓库，但 libs 下的 .aar -> .srcaar
       # 符号链接目标是由 EDM4U/导出过程生成，初次拉取代码时可能为断链。
-      # 默认仍严格失败；可通过 --skipvalidate 或 PINDO_SKIP_UNITY_LIBS_VALIDATE=1 跳过
-      return if Pindo::Options::GlobalOptionsState.instance[:skipvalidate]
+      # 这里必须严格失败，避免后续构建阶段才出现不可读/缺失依赖导致更难定位的问题
 
       libs_dir = File.join(android_root, "unityLibrary", "libs")
       return unless File.directory?(libs_dir)