pindo 5.18.5 → 5.18.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c5570599c0e84edb77c22267e890c57f736800bc046581d7a902e28b4b5c33f
-  data.tar.gz: 46b689df14719e8a7b0ef3af23e209d9e70484b3915b45a02c8c014ab1d2ddb3
+  metadata.gz: d3b74ddb66022968993f331b407f3a50a41d94a827e15e75f75dac1b8d5aadc1
+  data.tar.gz: '08c5e2e855359f4369e02cb6cab841d38e3344794a7d4e8f9b0f2695683d1da2'
 SHA512:
-  metadata.gz: c2e5bb57d0a922210eff69f20fc7aabdf42660f01073e2a56378f32ff2380173eedd37b00e54f368051566903ac95c37f7139b17760c19c17ce889422e7078a8
-  data.tar.gz: 84d21199d7e08ad161a286090fbbc40c0a421f021f654dfde9b663fffc2c0921927e6a95a7cc0db21b074a1a4af0dcd28e354183bcf4bd5bb318dc178cf0a37b
+  metadata.gz: 6c1c36ddcf83fcff151bdd21e8e3104eec862b5c72aa15303a8fe3cae4f9be0dd36f37e2cee24d293e6ace76f895c72f057a18f12485c6d4a08905bb49350e21
+  data.tar.gz: 1f3a484ff340bd398d150960753bb541103aca2b5a8ba30e712733c029e209c9fdfcb7db6c2d80b7c1bb1e1c8202d3319600ab12d23c4cb928c3f55c2390e74c

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

@@ -2,7 +2,7 @@ require 'highline/import'
 require 'fileutils'
 require 'pindo/base/executable'
 require 'pindo/module/build/build_helper'
-require 'pindo/module/build/git_repo_helper'
+require 'pindo/module/utils/git_repo_helper'
 require 'pindo/module/android/android_build_helper'
 require 'pindo/module/android/android_config_helper'
 require 'pindo/module/task/task_manager'
@@ -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/appstore/adhocbuild.rb

@@ -4,7 +4,7 @@ require 'find'
 require 'fileutils'
 require 'pindo/base/executable'
 require 'pindo/module/build/build_helper'
-require 'pindo/module/build/git_repo_helper'
+require 'pindo/module/utils/git_repo_helper'
 require 'pindo/module/xcode/xcode_build_config'
 require 'pindo/module/xcode/xcode_build_helper'
 require 'pindo/config/ios_config_parser'

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

@@ -4,7 +4,7 @@ require 'find'
 require 'fileutils'
 require 'pindo/base/executable'
 require 'pindo/module/build/build_helper'
-require 'pindo/module/build/git_repo_helper'
+require 'pindo/module/utils/git_repo_helper'
 require 'pindo/module/xcode/xcode_build_config'
 require 'pindo/module/xcode/xcode_build_helper'
 require 'pindo/module/task/task_manager'

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

@@ -3,7 +3,7 @@ require 'fileutils'
 require 'json'
 require 'faraday'
 require 'pindo/module/pgyer/pgyerhelper'
-require 'pindo/module/build/git_repo_helper'
+require 'pindo/module/utils/git_repo_helper'
 require 'pindo/module/build/build_helper'
 require 'pindo/module/task/task_manager'
 require 'pindo/module/task/model/jps/jps_upload_task'

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

@@ -5,7 +5,7 @@ require 'fileutils'
 require 'pindo/base/executable'
 require 'pindo/module/unity/unity_helper'
 require 'pindo/module/build/build_helper'
-require 'pindo/module/build/git_repo_helper'
+require 'pindo/module/utils/git_repo_helper'
 require 'pindo/module/task/pindo_task'
 require 'pindo/module/task/task_manager'
 require 'pindo/module/task/model/build_task'
@@ -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/repoinit.rb

@@ -1,6 +1,8 @@
 require 'highline/import'
 require 'fileutils'
 require 'pindo/options/options'
+require 'pindo/module/utils/git_repo_helper'
+require 'pindo/module/utils/git_hook_helper'
 
 module Pindo
   class Command
@@ -8,28 +10,31 @@ module Pindo
       class Repoinit < Utils
 
         # 命令的简要说明 - 初始化git仓库配置
-        self.summary = '初始化git仓库中git cliff的配置'
+        self.summary = '初始化git仓库配置（.gitignore、commit统计hook、git-cliff）'
 
         # 命令的详细说明,包含用法示例
         self.description = <<-DESC
-                    初始化git仓库中git cliff的配置。
+                    初始化git仓库配置。
 
                     支持功能:
 
-                        * 初始化git cliff配置
+                        * 检查并补充 .gitignore 规则（默认）
 
-                        * 生成配置文件
+                        * 安装 commit 变更统计 hook（默认，支持普通仓库/子模块/Husky）
+
+                        * 初始化 git-cliff 配置（需指定 --cliff）
 
                     使用示例:
 
-                        $ pindo utils repoinit                   # 初始化配置
+                        $ pindo utils repoinit                   # 检查 .gitignore + 安装统计 hook
+                        $ pindo utils repoinit --cliff           # 同时初始化 git-cliff
         DESC
 
         # 命令的参数列表
         self.arguments = []
 
         def self.option_items
-          @option_items ||= Pindo::Options::UtilsOptions.select(:mode, :retag)
+          @option_items ||= Pindo::Options::UtilsOptions.select(:cliff)
         end
 
         def self.options
@@ -39,22 +44,34 @@ module Pindo
         def initialize(argv)
           @options = initialize_options(argv)
 
-          @mode = @options[:mode] || 'minor'
-          @force_retag = @options[:retag] || false
-
-          unless ['major', 'minor', 'patch'].include?(@mode)
-            raise Informative, "mode参数必须是 major, minor 或 patch"
-          end
+          @enable_cliff = @options[:cliff] || false
 
           super
           @additional_args = argv.remainder!
         end
 
         def run
-          
+
           pindo_project_dir = Dir.pwd
-          build_helper = Pindo::BuildHelper.share_instance
-          Pindo::GitRepoHelper.share_instance.check_check_and_install_cliff(pindo_project_dir)
+
+          unless Pindo::GitHandler.is_git_directory?(local_repo_dir: pindo_project_dir)
+            Funlog.instance.fancyinfo_warning("当前目录不是 Git 仓库，跳过初始化")
+            return
+          end
+
+          current_git_root_path = Pindo::GitHandler.git_root_directory(local_repo_dir: pindo_project_dir)
+          git_repo_helper = Pindo::GitRepoHelper.share_instance
+
+          # 1. 检查并补充 .gitignore 规则
+          git_repo_helper.check_gitignore(current_git_root_path)
+
+          # 2. 安装 commit 变更统计 hook（主仓库 + 子模块，支持 Husky）
+          Pindo::GitHookHelper.share_instance.install_commit_stats_hook(current_git_root_path)
+
+          # 3. 指定 --cliff 参数时，才检测安装 git-cliff 并初始化配置
+          if @enable_cliff
+            git_repo_helper.check_and_install_cliff(pindo_project_dir)
+          end
 
         end
 

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

@@ -1,7 +1,7 @@
 require 'highline/import'
 require 'fileutils'
 require 'pindo/base/git_handler'
-require 'pindo/module/build/git_repo_helper'
+require 'pindo/module/utils/git_repo_helper'
 require 'pindo/module/task/task_manager'
 require 'pindo/module/task/model/git/git_commit_task'
 require 'pindo/module/task/model/git/git_tag_task'

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'