pindo 5.18.6 → 5.18.9

data/lib/pindo/module/utils/git_hook_helper.rb

@@ -21,6 +21,31 @@ module Pindo
     # 变更统计关键字（用于旧版 hook 特征识别）
     COMMIT_STATS_MARKER = '变更统计'
 
+    # 全局 hook 目录（由 install_global_commit_stats_hook 使用）
+    # 不放在 ~/.pindo 下，便于后续 shell 脚本入口以同一路径写入
+    GLOBAL_HOOKS_DIR = File.expand_path('~/.git-hooks').freeze
+
+    # Git 官方支持的 hook 名称列表（来自 githooks(5)）
+    # 不含 prepare-commit-msg —— 该 hook 由 pindo 装完整统计逻辑，不做转发
+    GIT_HOOK_NAMES = %w[
+      applypatch-msg         pre-applypatch         post-applypatch
+      pre-commit             pre-merge-commit       commit-msg
+      post-commit            pre-rebase             post-checkout
+      post-merge             pre-push               pre-receive
+      update                 proc-receive           post-receive
+      post-update            reference-transaction  push-to-checkout
+      pre-auto-gc            post-rewrite           sendemail-validate
+      fsmonitor-watchman     p4-changelist          p4-prepare-changelist
+      p4-post-changelist     p4-pre-submit          post-index-change
+    ].freeze
+
+    # git-lfs 相关的 4 个 hook —— 使用 LFS-aware 转发桩
+    # 执行顺序: 1) 调 git lfs <name> 完成 LFS 工作 → 2) 无条件转发仓库本地同名 hook
+    # 标准 git-lfs 本地 hook 会让 LFS 被调用两次，但 LFS 是幂等的无副作用；
+    # 换取"用户自定义逻辑（含 hybrid 脚本）完整执行"的保证。
+    # 其余 23 个 hook 使用纯转发桩。
+    LFS_AWARE_HOOKS = %w[pre-push post-checkout post-commit post-merge].freeze
+
     # 为仓库及其子模块安装 prepare-commit-msg hook（自动追加变更统计）
     # 支持普通仓库、子模块、Husky 项目
     # 版本匹配则跳过，版本不匹配或无版本则覆盖
@@ -51,6 +76,60 @@ module Pindo
       Funlog.instance.fancyinfo_success("commit 变更统计 hook 安装完成!")
     end
 
+    # verbose 模式: PINDO_DEBUG 环境变量（由命令层 --verbose 透传）
+    def verbose?
+      !ENV['PINDO_DEBUG'].to_s.empty?
+    end
+
+    # verbose 模式下才打印的 start 消息
+    def vstart(msg)
+      Funlog.instance.fancyinfo_start(msg) if verbose?
+    end
+
+    # 全局安装 commit 变更统计 hook（通过 core.hooksPath 对所有 Git 仓库生效）
+    #
+    # 执行四件事：
+    #   1. 解析目标目录 —— 读 global + system 级 core.hooksPath：
+    #      - 已指向某目录 → 沿用（adaptive，避免破坏已有全局 hook 体系）
+    #      - 未设置 → 使用默认 GLOBAL_HOOKS_DIR (~/.git-hooks)，并负责设置 core.hooksPath
+    #   2. 写入 prepare-commit-msg —— 主 hook，**完全接管**，不调用仓库本地同名 hook
+    #   3. 写入 27 个转发桩 —— 逐个独立判断：空位写入 / pindo 老版本升级 / foreign 保留
+    #      其中 LFS_AWARE_HOOKS (4 个) 使用 LFS-aware 模板，其余 23 个使用纯转发桩
+    #   4. 若是默认路径 → 设置 git config --global core.hooksPath
+    #
+    # @return [String] 实际使用的全局 hook 目录路径
+    def install_global_commit_stats_hook
+      vstart("开始安装全局 Git hook (pindo v#{HOOK_VERSION})")
+      vstart("  包含: 1 个 prepare-commit-msg 主 hook + #{GIT_HOOK_NAMES.size} 个转发桩 (#{LFS_AWARE_HOOKS.size} LFS-aware + #{GIT_HOOK_NAMES.size - LFS_AWARE_HOOKS.size} 纯转发)")
+
+      vstart("[4.1] 解析目标 hooks 目录 (自适应 core.hooksPath)")
+      target_dir, need_set_config = resolve_target_hooks_dir
+
+      FileUtils.mkdir_p(target_dir)
+      unless File.writable?(target_dir)
+        Funlog.instance.fancyinfo_error("  目标目录不可写: #{target_dir}")
+        raise Informative, "target hooks dir not writable: #{target_dir}"
+      end
+
+      vstart("[4.2] 安装 prepare-commit-msg 主 hook (完全接管，不调用仓库本地同名 hook)")
+      install_main_global_hook(target_dir)
+
+      vstart("[4.3] 安装 #{GIT_HOOK_NAMES.size} 个 hook 转发桩 (逐文件独立判断，foreign 保留不动)")
+      install_forwarder_stubs(target_dir)
+
+      vstart("[4.4] 配置 core.hooksPath")
+      if need_set_config
+        vstart("  执行: git config --global core.hooksPath #{target_dir}")
+        Pindo::GitHandler.git!(%W(config --global core.hooksPath #{target_dir}))
+        Funlog.instance.fancyinfo_success("  core.hooksPath 已设置: #{target_dir}")
+      else
+        vstart("  core.hooksPath 已指向 #{target_dir}，跳过")
+      end
+
+      Funlog.instance.fancyinfo_success("全局 Git hook 安装完成! (target: #{target_dir})")
+      target_dir
+    end
+
     private
 
     # 从文件内容中提取 hook 版本号
@@ -366,5 +445,210 @@ module Pindo
       HOOK
     end
 
+    # 安装全局主 hook (prepare-commit-msg)
+    # 复用 check_hook_status 做版本比对：已是最新 → 跳过；旧版 / foreign / 首次 → 覆盖
+    def install_main_global_hook(global_hooks_dir)
+      hook_path = File.join(global_hooks_dir, 'prepare-commit-msg')
+      vstart("  检查 #{hook_path} 状态")
+
+      if File.exist?(hook_path)
+        status = check_hook_status(File.read(hook_path))
+        case status
+        when :skip
+          Funlog.instance.fancyinfo_success("  prepare-commit-msg 已是最新版本 (v#{HOOK_VERSION})，跳过")
+          return
+        when :foreign
+          Funlog.instance.fancyinfo_warning("  prepare-commit-msg 非 pindo 文件，即将强制覆盖（保证变更统计功能）")
+        when :update
+          old_version = extract_hook_version(File.read(hook_path)) || '未知'
+          Funlog.instance.fancyinfo_update("  prepare-commit-msg 升级 (v#{old_version} → v#{HOOK_VERSION})")
+        when :install
+          vstart("  prepare-commit-msg 文件为空，首次写入")
+        end
+      else
+        vstart("  prepare-commit-msg 不存在，首次写入")
+      end
+
+      File.write(hook_path, full_global_hook_content)
+      File.chmod(0755, hook_path)
+      Funlog.instance.fancyinfo_success("  prepare-commit-msg 已写入 (0755)")
+    end
+
+    # 安装 27 个 hook 转发桩（逐文件独立判断，尊重已有非 pindo 文件）
+    # - 空位: 写入
+    # - pindo 当前版本: 跳过
+    # - pindo 老版本 (含 "Pindo global hook forwarder" 标识): 升级
+    # - 非 pindo (foreign): 保留不动（尊重用户 / 其它工具放在这里的文件）
+    #
+    # 其中 LFS_AWARE_HOOKS 的 4 个 hook 使用 LFS-aware 模板（先调 git lfs，
+    # 再无条件转发本地同名 hook，接受 LFS 可能的幂等重复调用成本），
+    # 其余 23 个使用纯转发桩（仅转发到仓库本地同名 hook）。
+    def install_forwarder_stubs(target_dir)
+      vstart("  遍历 #{GIT_HOOK_NAMES.size} 个 hook 名称，逐个判断 (安装/升级/跳过/保留)")
+      pure_tpl = hook_forwarder_content
+      lfs_tpl  = lfs_aware_forwarder_content
+
+      installed = 0
+      upgraded  = 0
+      skipped   = 0
+      kept      = 0
+
+      GIT_HOOK_NAMES.each do |name|
+        path = File.join(target_dir, name)
+        expected = LFS_AWARE_HOOKS.include?(name) ? lfs_tpl : pure_tpl
+
+        if !File.exist?(path)
+          File.write(path, expected)
+          File.chmod(0755, path)
+          installed += 1
+          next
+        end
+
+        existing = File.read(path)
+        if existing == expected
+          skipped += 1
+        elsif existing.include?('Pindo global hook forwarder')
+          # pindo 自己的老版本或不同类型桩 → 升级到当前期望版本
+          File.write(path, expected)
+          File.chmod(0755, path)
+          upgraded += 1
+        else
+          # foreign → 保留不动
+          kept += 1
+        end
+      end
+
+      Funlog.instance.fancyinfo_success(
+        "  转发桩: 安装 #{installed} / 升级 #{upgraded} / 跳过 #{skipped} / 保留用户文件 #{kept}"
+      )
+      if kept > 0
+        Funlog.instance.fancyinfo_warning("  #{kept} 个位置已存在非 pindo 文件，已保留。若需启用 pindo 转发，请手动移除它们后重跑")
+      end
+    end
+
+    # 解析目标 hooks 目录（自适应）
+    # 分别查询 global + system 级 core.hooksPath（不走 local 级，避免被仓库本地 Husky 等配置干扰）：
+    #   - 任一级已设置 → 沿用为 target，不修改 core.hooksPath
+    #   - 都未设置 → 使用默认 GLOBAL_HOOKS_DIR，由调用方负责写入 global 级 core.hooksPath
+    #
+    # @return [Array<(String, Boolean)>] [target_dir, need_set_config]
+    def resolve_target_hooks_dir
+      vstart("  读取 git config --global --get core.hooksPath")
+      global_val = git_config_get('--global', 'core.hooksPath')
+      vstart("  读取 git config --system --get core.hooksPath")
+      system_val = git_config_get('--system', 'core.hooksPath')
+
+      effective = !global_val.empty? ? global_val : system_val
+      source    = !global_val.empty? ? 'global' : 'system'
+
+      if effective.empty?
+        Funlog.instance.fancyinfo_success("  未检测到 core.hooksPath，使用默认目标目录: #{GLOBAL_HOOKS_DIR}")
+        return [GLOBAL_HOOKS_DIR, true]
+      end
+
+      # /dev/null 是 Git 官方的"禁用 hooks"哨兵值 —— pindo 绝不在这种情况下写入
+      if effective == '/dev/null'
+        Funlog.instance.fancyinfo_error("  检测到 #{source} 级 core.hooksPath=/dev/null (Git 标准的禁用 hooks 配置)")
+        Funlog.instance.fancyinfo_error("  pindo 不会在禁用状态下安装 hook。如需启用 pindo 全局 hook，请先执行:")
+        Funlog.instance.fancyinfo_error("    git config --#{source} --unset core.hooksPath")
+        raise Informative, "core.hooksPath is set to /dev/null (hooks disabled)"
+      end
+
+      # ~/ 由 git 自己负责展开，pindo 这里也做相同展开以保持一致
+      resolved = effective.start_with?('~') ? File.expand_path(effective) : effective
+
+      # 相对路径 —— git 会按 hook 运行目录解析，pindo 无法可靠对齐
+      unless resolved.start_with?('/')
+        Funlog.instance.fancyinfo_error("  检测到 #{source} 级 core.hooksPath=#{effective} (相对路径)")
+        Funlog.instance.fancyinfo_error("  Git 会按 hook 运行目录解析相对 hooksPath，pindo 无法可靠定位此目录")
+        Funlog.instance.fancyinfo_error("  请改为绝对路径后重试:")
+        Funlog.instance.fancyinfo_error("    git config --#{source} core.hooksPath /绝对路径/to/hooks")
+        raise Informative, "core.hooksPath is a relative path: #{effective}"
+      end
+
+      Funlog.instance.fancyinfo_success("  检测到 #{source} 级 core.hooksPath，沿用为目标目录: #{resolved}")
+      [resolved, false]
+    end
+
+    # 安全读取 git config 某作用域下的指定 key
+    # 不存在返回空串，不抛异常
+    def git_config_get(scope, key)
+      Pindo::GitHandler.git!(%W(config #{scope} --get #{key})).strip
+    rescue
+      ''
+    end
+
+    # 纯转发桩内容（23 个非 LFS hook 共用）
+    # 用 exec 透传 stdin / stdout / 退出码；字符串比较防递归
+    def hook_forwarder_content
+      <<~SH
+        #!/bin/bash
+        # Pindo global hook forwarder (plain, v#{HOOK_VERSION})
+        # 作用: core.hooksPath 启用后转发到仓库本地同名 hook，保留原有行为
+        # 由 pindo utils gitconfig 安装，勿手动编辑
+
+        repo_git_dir=$(git rev-parse --git-dir 2>/dev/null)
+        if [ -n "$repo_git_dir" ]; then
+            local_hook="$repo_git_dir/hooks/$(basename "$0")"
+            if [ -x "$local_hook" ] && [ "$local_hook" != "$0" ]; then
+                exec "$local_hook" "$@"
+            fi
+        fi
+        exit 0
+      SH
+    end
+
+    # LFS-aware 转发桩内容（4 个 LFS hook 共用：pre-push / post-checkout / post-commit / post-merge）
+    # 顺序:
+    #   1) 调 git lfs <hook-name> 完成 LFS 工作
+    #   2) 始终转发到仓库本地同名 hook —— 无条件转发，保证用户自定义逻辑（包括
+    #      "先跑 npm test 再调 LFS" 这种 hybrid 脚本）完整执行
+    #
+    # 设计权衡:
+    #   - 标准 git-lfs install 生成的本地 hook 会让 LFS 被调用两次，但 git lfs
+    #     是幂等的：第二次调用检查到 LFS 对象已上传/已拉取，立即返回，无副作用
+    #   - 换取"零数据丢失"的保证：用户写的 mixed hook 里的非-LFS 部分不会被吞
+    def lfs_aware_forwarder_content
+      <<~SH
+        #!/bin/bash
+        # Pindo global hook forwarder (LFS-aware, v#{HOOK_VERSION})
+        # 作用: 先调 git-lfs 完成 LFS 工作，再始终转发到仓库本地同名 hook
+        # 由 pindo utils gitconfig 安装，勿手动编辑
+
+        hook_name=$(basename "$0")
+
+        # 1. 调用 git-lfs 完成 LFS 相关逻辑
+        if command -v git-lfs >/dev/null 2>&1; then
+            git lfs "$hook_name" "$@" || exit $?
+        fi
+
+        # 2. 无条件转发到仓库本地同名 hook（保留用户自定义逻辑）
+        # 若本地是 git-lfs 标准脚本会让 LFS 被调用两次，但 git lfs 是幂等的，
+        # 第二次调用会检测到 LFS 对象已处理并立即返回，无副作用
+        repo_git_dir=$(git rev-parse --git-dir 2>/dev/null)
+        if [ -n "$repo_git_dir" ]; then
+            local_hook="$repo_git_dir/hooks/$hook_name"
+            if [ -x "$local_hook" ] && [ "$local_hook" != "$0" ]; then
+                exec "$local_hook" "$@"
+            fi
+        fi
+        exit 0
+      SH
+    end
+
+    # 全局 prepare-commit-msg 的完整内容
+    # 完全接管：不调用仓库本地 prepare-commit-msg，只运行 pindo 变更统计逻辑
+    # = shebang + 注释头 + hook_core_content
+    def full_global_hook_content
+      header = <<~SH
+        #!/bin/bash
+        # Git Hook: prepare-commit-msg (Pindo global)
+        # 功能: 完全接管，自动追加变更统计信息（不调用仓库本地 prepare-commit-msg）
+        # 由 pindo utils gitconfig 安装，勿手动编辑
+
+      SH
+      header + hook_core_content
+    end
+
   end
 end

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

@@ -127,39 +127,6 @@ module Pindo
             default_value: false,
             optional: true,
             example: 'pindo appstore cert --develop_id --platform=macos'
-          ),
-
-          skipclean: OptionItem.new(
-            key: :skipclean,
-            name: '跳过 Gradle Clean',
-            description: '跳过 Android AAB 构建前的 Gradle clean 步骤（加速本地开发）',
-            type: OptionItem::Boolean,
-            env_name: 'PINDO_SKIP_GRADLE_CLEAN',
-            default_value: false,
-            optional: true,
-            example: 'pindo android autobuild --skipclean'
-          ),
-
-          skipvalidate: OptionItem.new(
-            key: :skipvalidate,
-            name: '跳过 Unity 库校验',
-            description: '跳过 Unity unityLibrary/libs 符号链接有效性校验',
-            type: OptionItem::Boolean,
-            env_name: 'PINDO_SKIP_UNITY_LIBS_VALIDATE',
-            default_value: false,
-            optional: true,
-            example: 'pindo android autobuild --skipvalidate'
-          ),
-
-          injectsigning: OptionItem.new(
-            key: :injectsigning,
-            name: '注入签名配置',
-            description: '注入签名配置到 Android build.gradle（自动改写 signingConfigs）',
-            type: OptionItem::Boolean,
-            env_name: 'PINDO_INJECT_ANDROID_SIGNING_GRADLE',
-            default_value: false,
-            optional: true,
-            example: 'pindo android autobuild --injectsigning'
           )
         }
       end

data/lib/pindo/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pindo
 version: !ruby/object:Gem::Version
-  version: 5.18.6
+  version: 5.18.9
 platform: ruby
 authors:
 - wade
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: claide
@@ -357,6 +357,7 @@ files:
 - lib/pindo/command/utils/device.rb
 - lib/pindo/command/utils/encrypt.rb
 - lib/pindo/command/utils/fabric.rb
+- lib/pindo/command/utils/gitconfig.rb
 - lib/pindo/command/utils/icon.rb
 - lib/pindo/command/utils/installskills.rb
 - lib/pindo/command/utils/renewbundleid.rb
@@ -523,7 +524,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 3.0.0
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.3
 specification_version: 4
 summary: easy work
 test_files: []