cocoapods-bb-PodAssistant 0.3.13.9 → 0.3.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: abec00e48ec639b98614704c2de363bcdbc877221b5a1b353daec7f52bdaf19e
-  data.tar.gz: 70064497c44c232d192d21714910e091d1791cf3174d6031f0261ef02022aa21
+  metadata.gz: e3f29af4e66656505b3e34fec77037f661dda9e6668973eb928dac26395cbbd8
+  data.tar.gz: d6eaa9e0d9eb55b828710b1163537c25849fbe31a5db6e32c381b2e6f803d65a
 SHA512:
-  metadata.gz: a0c0a04aee990b1a4da82c388a3762077d55dafe774a83c050de1c81b9e82ba80ff01d516f5b4b7cbc1ffbe108a7f1bafdd4e6b414caaf4721e44e01b5890a1e
-  data.tar.gz: 32b823a32a8ebaebe6bb9547e772a2fda950e5c7d3263f9f07a6e973acfc3956493a812e9c506f1ecdecda05acd20c51b0e39318745d999360e69bf7abbca3d4
+  metadata.gz: 8caa9d87d55d008b931d17100b60ded1871c7027a83d5c102ae139066efe2e2f38602c3b332bd34b81a20e92d0e30dcd5f9e60dfeeaacb642ac71c960bb40eeb
+  data.tar.gz: a0234edf691867633425b1a7e26dd57368f206a0e7bd7caa190b3d7359bc4197625d294e1c38cc36a02832b57ce6e992e2a8918c060156bdbb2c3009768c2109

data/bin/bb_tools

@@ -96,4 +96,27 @@ command :podfile_tiled do |c|
         BBItools::PodfileTiled.podfile_tiled(args)
     end
 end
-exit run(ARGV)
+
+# 生成 DocC 静态站点
+desc "从 pod lib lint 的临时验证工程生成 DocC 静态站点"
+arg 'podspec path'
+command :docc do |c|
+    c.desc "DocC hosting base path (默认: Docs/<scheme>)"
+    c.flag [:"hosting-base-path"]
+
+    c.action do |global_options, options, args|
+        if args.empty?
+            puts "❌ 错误: 必须提供 podspec 文件路径".red
+            puts "用法: bb_tools docc <podspec>"
+            exit 1
+        end
+
+        gen_options = {
+            podspec: args[0],
+            hosting_base_path: options[:"hosting-base-path"] || options["hosting-base-path"]
+        }
+        
+        BBItools::DocCGenerator.generate(gen_options)
+    end
+end
+exit run(ARGV)

data/lib/cocoapods-bb-PodAssistant/command/stable/push.rb

@@ -18,7 +18,7 @@ module Pod
           参数说明:\n
           --dependencies=依赖组件\n   
           --remove=需要移除组件\n 
-          --stable-specs-index=指定业务specs索引-0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界\n
+          --stable-specs-index=指定业务specs索引-0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界 8:阅读\n
         DESC
         #   --update-matrix 更新矩阵产品公共业务线\n 
         #   --update-common 更新公共组件\n
@@ -31,7 +31,7 @@ module Pod
             [
                 ['--dependencies', '依赖组件名称，多个使用`,`隔开'],
                 ['--remove', '移除公共组件名称，多个使用`,`隔开'],
-                ['--stable-specs-index', '指定业务specs索引-0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界，参照podfile配置信息'],
+                ['--stable-specs-index', '指定业务specs索引-0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界 8:阅读，参照podfile配置信息'],
             ].concat(super)
         end
 
@@ -97,7 +97,7 @@ module Pod
                 end
             }
         end
-        # 0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界
+        # 0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界 8:阅读
         private def get_stable_spec_name
             case @stable_specs_index
             when 1 # 全线矩阵产品公共stable目录
@@ -114,11 +114,13 @@ module Pod
                 return 'br_stable_specs'
             when 7 # 世界产品公共stable目录
                 return 'bw_stable_specs'
+            when 8 # 阅读产品公共stable目录
+                return 'read_stable_specs'
             else # 公共stable目录
                 return 'stable_specs'
             end
         end
-        # 0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界
+        # 0:公共(默认) 1:矩阵全线升级 2:拉布 3:科学 4:思维 5:abc 6:大全 7:世界 8:阅读
         private def get_stable_project_name
             case @stable_specs_index
             when 1 # 全线矩阵产品公共stable目录
@@ -135,6 +137,8 @@ module Pod
                 return 'br_Common_Stable'
             when 7 # 世界产品公共stable目录
                 return 'bw_Common_Stable'
+            when 8 # 阅读产品公共stable目录
+                return 'read_Common_Stable'
             else # 公共stable目录
                 @is_public_data = true
                 return 'Common_Stable'

data/lib/cocoapods-bb-PodAssistant/gem_version.rb

@@ -1,3 +1,3 @@
 module CocoapodsBbPodassistant
-  VERSION = "0.3.13.9"
+  VERSION = "0.3.14.1"
 end

data/lib/cocoapods-bb-PodAssistant/tools/docc_generator.rb

@@ -0,0 +1,1005 @@
+require "fileutils"
+require "find"
+require "pathname"
+require "timeout"
+
+module BBItools
+  class DocCGenerator
+    PODSPEC_REPO = "babybus-babybus-ios-specs-babybus-specs"
+    DESTINATION = "generic/platform=iOS Simulator"
+    CONFIGURATION = "Debug"
+    KEYCHAIN_HOST = "git.babybus.co"
+
+    def self.generate(options)
+      new(options).run
+    end
+
+    def initialize(options)
+      @options = options
+      @podspec = options[:podspec]
+      @workdir = options[:workdir]
+      @output = options[:output]
+      @logs = options[:logs]
+      @derived_data = options[:derived_data]
+      @lint_root = options[:lint_root]
+      @hosting_base_path = options[:hosting_base_path]
+    end
+
+    def run
+      $stdout.sync = true
+      $stderr.sync = true
+
+      fail!("必须传入 podspec") if @podspec.to_s.strip.empty?
+
+      base_dir = Dir.pwd
+      podspec_path_abs = abs_path(@podspec.to_s.strip, base_dir: base_dir)
+      fail!("podspec 不存在: #{@podspec}") unless File.file?(podspec_path_abs)
+      podspec_path_rel = rel_path(podspec_path_abs, base_dir: base_dir)
+
+      podspec_basename = File.basename(podspec_path_abs)
+      workdir_opt = @workdir.to_s.strip
+      podspec_dir_abs =
+        if workdir_opt.empty?
+          File.dirname(podspec_path_abs)
+        else
+          abs_path(workdir_opt, base_dir: base_dir)
+        end
+      fail!("workdir 不存在: #{rel_path(podspec_dir_abs, base_dir: base_dir)}") unless File.directory?(podspec_dir_abs)
+      
+      # 如果指定了 workdir，且 podspec 不在其中，则复制过去
+      podspec_in_workdir = File.join(podspec_dir_abs, podspec_basename)
+      if File.expand_path(podspec_in_workdir) != File.expand_path(podspec_path_abs)
+        FileUtils.cp(podspec_path_abs, podspec_in_workdir)
+      end
+
+      zip_push_repo = ENV["BB_DOCC_ZIP_PUSH_REPO"].to_s.strip
+      zip_push_repo = "https://git.babybus.co/babybus/ios/CommonBusiness/Tools/iOSWeb" if zip_push_repo.empty?
+      zip_push_branch = ENV["BB_DOCC_ZIP_PUSH_BRANCH"].to_s.strip
+      zip_push_branch = "main" if zip_push_branch.empty?
+      zip_push_subdir = ENV["BB_DOCC_ZIP_PUSH_SUBDIR"].to_s.strip
+      zip_push_subdir = "docc_zips" if zip_push_subdir.empty?
+
+      final_destination_root = nil
+      real_home = ENV["HOME"].to_s
+      scheme = extract_name_from_podspec(podspec_path_abs)
+      deployment_target = extract_ios_deployment_target_from_podspec(podspec_path_abs)
+      
+      # ---------------------------------------------------------
+      # 2. 所有操作都在脚本同级目录下的 _docc_temp 中进行
+      # ---------------------------------------------------------
+      # 脚本所在目录 (Gem 安装位置可能只读，所以使用当前运行目录 Dir.pwd)
+      local_work_root = File.join(Dir.pwd, "_docc_temp", scheme)
+      FileUtils.rm_rf(local_work_root) # 清理旧的
+      FileUtils.mkdir_p(local_work_root)
+      
+      log "🔨 本地工作区 (生成中): file://#{local_work_root}"
+
+      # 各个子目录都在本地工作区内
+      logs_dir = File.join(local_work_root, "logs")
+      FileUtils.mkdir_p(logs_dir)
+      
+      derived_data_root = File.join(local_work_root, "DerivedData")
+      FileUtils.mkdir_p(derived_data_root)
+      
+      lint_root = File.join(local_work_root, "Lint")
+      FileUtils.mkdir_p(lint_root)
+      lint_root_rel = lint_root
+
+      # 最终生成的站点先放在本地
+      local_site_output = File.join(local_work_root, "site_output")
+      FileUtils.mkdir_p(local_site_output)
+
+      # 模拟 component_dir_abs 供后续逻辑使用 (指向本地)
+      component_dir_abs = local_site_output
+      component_dir_rel = component_dir_abs
+
+      hosting_base_path = @options[:hosting_base_path].to_s.strip
+      if hosting_base_path.empty?
+        hosting_base_path = "Docs/#{scheme}"
+      end
+      hosting_base_path = hosting_base_path.sub(%r{\A/+}, "")
+
+      status_md = File.join(logs_dir, "status.md")
+      File.open(status_md, "w") do |f|
+        f.puts "# #{scheme}"
+        f.puts
+        f.puts "- 时间: #{Time.now.strftime("%Y-%m-%d %H:%M:%S")}"
+        f.puts "- podspec: #{podspec_path_rel}"
+        f.puts "- workdir: #{rel_path(podspec_dir_abs, base_dir: base_dir)}" unless workdir_opt.empty?
+        f.puts "- local_work_root: #{local_work_root}"
+        f.puts "- zip_push_repo: #{redact_git_url(zip_push_repo)}"
+        f.puts "- zip_push_branch: #{zip_push_branch}"
+        f.puts "- zip_push_subdir: #{zip_push_subdir}"
+        f.puts "- home: ~"
+        f.puts "- deployment_target: #{deployment_target}" unless deployment_target.to_s.strip.empty?
+        f.puts "- hosting_base_path: #{hosting_base_path}"
+        f.puts "- sources: #{PODSPEC_REPO}"
+      end
+
+      exported_source_root = File.join(component_dir_abs, "exported-source")
+      export_staging_dir = ""
+      cleanup_written = false
+      is_success = false
+
+      # Cleanup hook
+      at_exit_block = proc do
+        next if cleanup_written
+        cleanup_written = true
+
+        exit_code = $!.is_a?(SystemExit) ? $!.status : 0
+        
+        # ---------------------------------------------------------
+        # 3. 任务结束：移动产物到 SMB 并清理本地
+        # ---------------------------------------------------------
+        if final_destination_root
+          # 只有明确标记成功 (is_success = true) 才执行同步
+          if is_success && exit_code.zero? && File.directory?(local_site_output)
+            # 关键校验：检查目标目录下是否存在 server.js
+            server_js_path = File.join(final_destination_root, "server.js")
+            
+            if File.file?(server_js_path)
+              log "✅ 校验通过：发现 server.js"
+              
+              # ---------------------------------------------------------
+              # 压缩 -> 移动 -> 删除旧版 -> 解压 -> 删除压缩包
+              # ---------------------------------------------------------
+              
+              # 1. 准备压缩：将 site_output 重命名为 #{scheme}，这样解压后直接就是正确的目录名
+              staging_dir = File.join(local_work_root, scheme)
+              FileUtils.rm_rf(staging_dir)
+              FileUtils.mv(local_site_output, staging_dir)
+              
+              zip_name = "#{scheme}.zip"
+              local_zip_path = File.join(local_work_root, zip_name)
+
+              remote_zip_name = "#{scheme}_#{Time.now.strftime("%Y%m%d_%H%M%S")}_#{Process.pid}.zip"
+
+              zip_log = File.join(logs_dir, "zip.log")
+              zip_timeout_sec = (ENV["BB_DOCC_ZIP_TIMEOUT_SEC"].to_s.strip.empty? ? 1800 : ENV["BB_DOCC_ZIP_TIMEOUT_SEC"].to_i)
+
+              log "📦 正在压缩产物 (zip)... (timeout=#{zip_timeout_sec}s)"
+              log "📄 zip 日志: #{rel_path(zip_log, base_dir: base_dir)}"
+
+              zip_exit = nil
+              FileUtils.mkdir_p(File.dirname(zip_log))
+              File.open(zip_log, "w") do |f|
+                Dir.chdir(local_work_root) do
+                  pid = Process.spawn({ "HOME" => real_home }, "zip", "-r", "-q", zip_name, scheme, out: f, err: f)
+                  begin
+                    Timeout.timeout(zip_timeout_sec) do
+                      _pid, status = Process.wait2(pid)
+                      zip_exit = status.exitstatus
+                    end
+                  rescue Timeout::Error
+                    begin
+                      Process.kill("TERM", pid)
+                    rescue StandardError
+                    end
+                    sleep 2
+                    begin
+                      Process.kill("KILL", pid)
+                    rescue StandardError
+                    end
+                    zip_exit = 124
+                  end
+                end
+              end
+
+              log "📦 压缩结束 (exit=#{zip_exit})"
+
+              if zip_exit == 0 && File.exist?(local_zip_path)
+                lock_dir = File.join(final_destination_root, ".docc_deploy_lock_#{scheme}")
+                lock_timeout_sec = (ENV["BB_DOCC_DEPLOY_LOCK_TIMEOUT_SEC"].to_s.strip.empty? ? 600 : ENV["BB_DOCC_DEPLOY_LOCK_TIMEOUT_SEC"].to_i)
+                lock_stale_sec = (ENV["BB_DOCC_DEPLOY_LOCK_STALE_SEC"].to_s.strip.empty? ? 21600 : ENV["BB_DOCC_DEPLOY_LOCK_STALE_SEC"].to_i)
+
+                lock_start = Time.now
+                acquired_lock = false
+
+                until acquired_lock
+                  begin
+                    Dir.mkdir(lock_dir)
+                    acquired_lock = true
+                  rescue Errno::EEXIST
+                    begin
+                      if File.exist?(lock_dir) && (Time.now - File.mtime(lock_dir)) > lock_stale_sec
+                        FileUtils.rm_rf(lock_dir)
+                        next
+                      end
+                    rescue StandardError
+                    end
+
+                    if (Time.now - lock_start) > lock_timeout_sec
+                      log "❌ 获取部署锁超时 (timeout=#{lock_timeout_sec}s)：#{lock_dir}"
+                      break
+                    end
+                    sleep 2
+                  end
+                end
+
+                begin
+                  if acquired_lock
+                    log "🚚 正在将压缩包移动到 SMB..."
+                    target_zip_path = File.join(final_destination_root, remote_zip_name)
+
+                    copy_log = File.join(logs_dir, "copy.log")
+                    copy_timeout_sec = (ENV["BB_DOCC_COPY_TIMEOUT_SEC"].to_s.strip.empty? ? 600 : ENV["BB_DOCC_COPY_TIMEOUT_SEC"].to_i)
+
+                    log "🚚 正在复制到 SMB... (timeout=#{copy_timeout_sec}s)"
+                    log "📄 copy 日志: #{rel_path(copy_log, base_dir: base_dir)}"
+
+                    copy_exit = nil
+                    File.open(copy_log, "w") do |f|
+                      pid = Process.spawn({ "HOME" => real_home }, "cp", "-f", local_zip_path, target_zip_path, out: f, err: f)
+                      begin
+                        Timeout.timeout(copy_timeout_sec) do
+                          _pid, status = Process.wait2(pid)
+                          copy_exit = status.exitstatus
+                        end
+                      rescue Timeout::Error
+                        begin
+                          Process.kill("TERM", pid)
+                        rescue StandardError
+                        end
+                        sleep 2
+                        begin
+                          Process.kill("KILL", pid)
+                        rescue StandardError
+                        end
+                        copy_exit = 124
+                      end
+                    end
+
+                    if copy_exit != 0
+                      log "❌ 复制到 SMB 失败 (exit=#{copy_exit})：#{target_zip_path}"
+                    else
+                      target_dir = File.join(final_destination_root, scheme)
+
+                      if File.exist?(target_dir)
+                        log "🗑️ 发现旧版本，正在删除..."
+                        FileUtils.rm_rf(target_dir)
+                      end
+
+                      unzip_log = File.join(logs_dir, "unzip.log")
+                      unzip_timeout_sec = (ENV["BB_DOCC_UNZIP_TIMEOUT_SEC"].to_s.strip.empty? ? 600 : ENV["BB_DOCC_UNZIP_TIMEOUT_SEC"].to_i)
+
+                      log "📦 正在解压并部署... (timeout=#{unzip_timeout_sec}s)"
+                      log "📄 unzip 日志: #{rel_path(unzip_log, base_dir: base_dir)}"
+
+                      unzip_exit = nil
+                      File.open(unzip_log, "w") do |f|
+                        Dir.chdir(final_destination_root) do
+                          pid = Process.spawn({ "HOME" => real_home }, "unzip", "-q", "-o", remote_zip_name, out: f, err: f)
+                          begin
+                            Timeout.timeout(unzip_timeout_sec) do
+                              _pid, status = Process.wait2(pid)
+                              unzip_exit = status.exitstatus
+                            end
+                          rescue Timeout::Error
+                            begin
+                              Process.kill("TERM", pid)
+                            rescue StandardError
+                            end
+                            sleep 2
+                            begin
+                              Process.kill("KILL", pid)
+                            rescue StandardError
+                            end
+                            unzip_exit = 124
+                          end
+                        end
+                      end
+
+                      log "📦 解压结束 (exit=#{unzip_exit})"
+
+                      FileUtils.rm_f(target_zip_path)
+
+                      if unzip_exit == 0
+                        target_logs = File.join(target_dir, "docc-logs")
+                        FileUtils.mkdir_p(target_logs)
+                        sync_dir_contents(logs_dir, target_logs)
+
+                        log "✅ 部署完成: file://#{target_dir.gsub(' ', '%20')}"
+                      else
+                        log "❌ 解压失败 (exit=#{unzip_exit})"
+                      end
+                    end
+                  end
+                ensure
+                  FileUtils.rm_rf(lock_dir) if acquired_lock && File.exist?(lock_dir)
+                end
+              else
+                log "❌ 压缩失败，未找到 zip 文件"
+              end
+            else
+              log "❌ 校验失败：在目标目录未找到 server.js"
+              log "❌ 目标路径: #{final_destination_root}"
+              log "⚠️ 取消同步，生成的静态站点将被删除"
+            end
+          else
+            # ---------------------------------------------------------
+            # 失败处理：将日志同步到 Docs/log 目录
+            # ---------------------------------------------------------
+            log "⚠️ 任务失败或被中断，正在保存错误日志..."
+            
+            # 确保 log 根目录存在
+            global_log_root = File.join(final_destination_root, "log")
+            if File.directory?(final_destination_root)
+              FileUtils.mkdir_p(global_log_root)
+              
+              # 创建带时间戳的日志目录: Docs/log/Scheme_20230101_120000
+              timestamp = Time.now.strftime("%Y%m%d_%H%M%S")
+              fail_log_dir = File.join(global_log_root, "#{scheme}_#{timestamp}")
+              FileUtils.mkdir_p(fail_log_dir)
+              
+              # 同步日志文件
+              if File.directory?(logs_dir)
+                sync_dir_contents(logs_dir, fail_log_dir)
+                log "📄 错误日志已保存至: file://#{fail_log_dir.gsub(' ', '%20')}"
+              else
+                log "❌ 无法保存日志：本地日志目录不存在"
+              end
+            else
+              log "❌ 无法保存日志：SMB 目标目录不可访问"
+            end
+          end
+        end
+
+        # 强制删除本地临时目录 (_docc_temp)
+        # local_work_root 是 _docc_temp/scheme
+        # 我们要删除的是 _docc_temp
+        temp_root = File.dirname(local_work_root)
+        
+        if File.exist?(temp_root)
+          log "正在清理本地临时目录: file://#{temp_root}"
+          FileUtils.rm_rf(temp_root)
+          
+          if File.exist?(temp_root)
+             log "⚠️ 清理失败，目录仍存在: file://#{temp_root}"
+          else
+             log "🗑️ 已清理本地临时目录"
+          end
+        end
+      end
+      
+      # 注意：at_exit 是全局的，这里直接调用可能不太合适，最好是 ensure 块
+      # 但为了保持逻辑，我们使用 ensure
+
+      begin
+        require_cmd!("pod")
+        require_cmd!("xcodebuild")
+        require_cmd!("xcrun")
+        require_cmd!("git")
+
+        lint_log = File.join(logs_dir, "pod-lib-lint.log")
+        lint_log_rel = rel_path(lint_log, base_dir: base_dir)
+        lint_cmd = [
+          "pod", "lib", "lint", podspec_basename,
+          "--verbose", "--no-clean", "--skip-tests", "--skip-import-validation",
+          "--use-modular-headers", "--use-static-frameworks",
+          "--allow-warnings",
+          "--sources=#{PODSPEC_REPO}"
+        ]
+
+        File.open(status_md, "a") { |f| f.puts "- lint: #{lint_cmd.join(" ")}" }
+
+        log "执行 lint: #{podspec_basename}（cwd=#{rel_path(podspec_dir_abs, base_dir: base_dir)}）"
+        lint_env = {
+          "HOME" => real_home,
+          "TMPDIR" => lint_root
+        }
+
+        # 移除所有手动注入的 GIT_CONFIG_ 配置，完全依赖用户本地环境的 Git 配置。
+        # 仅保留 GIT_TERMINAL_PROMPT=0 以防止在日志重定向模式下进程卡死。
+        # 如果用户本地 Keychain 配置正确，Git 会自动读取，无需我们干预。
+        
+        if ENV["BB_DOCC_ALLOW_PROMPT"] != "1"
+          lint_env["GIT_TERMINAL_PROMPT"] = "0"
+        end
+
+        lint_exit = run_to_file(lint_cmd, cwd: podspec_dir_abs, env: lint_env, log_path: lint_log)
+
+        File.open(status_md, "a") do |f|
+          if lint_exit.zero?
+            f.puts "- lint: 成功"
+          else
+            f.puts "- lint: 失败（exit=#{lint_exit}）"
+          end
+          f.puts
+          f.puts "**pod lib lint 日志（尾部）**"
+          f.puts "```"
+          tail_lines(lint_log, 200).each { |line| f.puts line }
+          f.puts "```"
+        end
+
+        unless lint_exit.zero?
+          File.open(status_md, "a") do |f|
+            f.puts "- docbuild: 跳过（lint 失败）"
+            f.puts "- export: 跳过（lint 失败）"
+          end
+
+          log "lint 失败，跳过 docbuild 与导出"
+          log "失败日志: #{lint_log_rel}"
+          log "状态汇总: #{rel_path(status_md, base_dir: base_dir)}"
+
+          puts "[docc] -------- pod lib lint 日志（尾部 200 行）--------"
+          puts tail_lines(lint_log, 200).join("\n")
+          puts "[docc] -------- 关键错误/失败行（尾部 400 行过滤）--------"
+
+          tail_lines(lint_log, 400).each_with_index do |line, idx|
+            next unless line.match?(/^\[!\]| error: | ERROR | fatal: |Undefined symbols|Ld /)
+            puts "#{idx + 1}:#{line}"
+          end
+
+          if safe_read_text(lint_log).include?("Authentication failed for 'https://#{KEYCHAIN_HOST}/")
+            puts "[docc] 提示: 检测到 git clone 认证失败（#{KEYCHAIN_HOST}）"
+            puts "[docc] 处理方式: 确保系统 git 能在终端里无交互 clone 私有仓库（一般用 Token）"
+          end
+
+          # Early return instead of exit
+          return
+        end
+
+        workspace_path_abs = find_workspace_from_lint_log(lint_log, lint_root)
+        
+        if workspace_path_abs.to_s.strip.empty?
+          fail!("未找到 *.xcworkspace（lint_root=#{lint_root_rel}）")
+        end
+        
+        workspace_path_rel = rel_path(workspace_path_abs.to_s, base_dir: base_dir)
+        fail!("workspace 不存在: #{workspace_path_rel}") unless File.directory?(workspace_path_abs)
+
+        validation_dir_abs = File.dirname(workspace_path_abs)
+        File.open(status_md, "a") do |f|
+          f.puts "- validation_dir: #{rel_path(validation_dir_abs, base_dir: base_dir)}"
+          f.puts "- workspace: #{workspace_path_rel}"
+        end
+
+        if deployment_target && !deployment_target.strip.empty?
+          changed = bump_deployment_targets_in_validation_dir(validation_dir_abs, deployment_target)
+          File.open(status_md, "a") { |f| f.puts "- bumped_deployment_target: #{deployment_target} (changed=#{changed})" }
+        end
+
+        exported_source = ""
+        dev_pod_dir = File.join(validation_dir_abs, "Pods", "Development Pods", scheme)
+        if File.directory?(dev_pod_dir)
+          FileUtils.rm_rf(exported_source_root)
+          FileUtils.mkdir_p(exported_source_root)
+          FileUtils.cp_r(dev_pod_dir, exported_source_root)
+          exported_source = File.join(exported_source_root, scheme)
+        end
+
+        File.open(status_md, "a") do |f|
+          if exported_source.empty?
+            f.puts "- exported_source: 未找到（跳过）"
+          else
+            f.puts "- exported_source: #{rel_path(exported_source, base_dir: base_dir)}"
+          end
+        end
+
+        derived_dir = File.join(derived_data_root, scheme)
+        FileUtils.mkdir_p(derived_dir)
+        derived_dir_rel = rel_path(derived_dir, base_dir: base_dir)
+
+        docbuild_log = File.join(logs_dir, "xcodebuild-docbuild.log")
+
+        workspace_for_docbuild = rel_path(workspace_path_abs, base_dir: podspec_dir_abs)
+        derived_dir_for_docbuild = rel_path(derived_dir, base_dir: podspec_dir_abs)
+        docbuild_cmd = [
+          "xcodebuild", "docbuild",
+          "-workspace", workspace_for_docbuild,
+          "-scheme", scheme,
+          "-destination", DESTINATION,
+          "-configuration", CONFIGURATION,
+          "-derivedDataPath", derived_dir_for_docbuild
+        ]
+        if deployment_target && !deployment_target.strip.empty?
+          docbuild_cmd << "IPHONEOS_DEPLOYMENT_TARGET=#{deployment_target}"
+          docbuild_cmd << "SWIFT_VERSION=5.0"
+        end
+        docbuild_cmd += ["CODE_SIGNING_ALLOWED=NO", "CODE_SIGNING_REQUIRED=NO", "CODE_SIGN_IDENTITY="]
+
+        docbuild_cmd_report = docbuild_cmd.dup
+        docbuild_cmd_report[docbuild_cmd_report.index(workspace_for_docbuild) || 0] = workspace_path_rel
+        docbuild_cmd_report[docbuild_cmd_report.index(derived_dir_for_docbuild) || 0] = derived_dir_rel
+        File.open(status_md, "a") { |f| f.puts "- docbuild: #{docbuild_cmd_report.join(" ")}" }
+
+        log "执行 docbuild: #{scheme}"
+        docbuild_exit = run_to_file(docbuild_cmd, cwd: podspec_dir_abs, env: { "HOME" => real_home }, log_path: docbuild_log)
+
+        unless docbuild_exit.zero?
+          File.open(status_md, "a") do |f|
+            f.puts "- docbuild: 失败（exit=#{docbuild_exit}）"
+            f.puts
+            f.puts "**xcodebuild 日志（尾部）**"
+            f.puts "```"
+            tail_lines(docbuild_log, 200).each { |line| f.puts line }
+            f.puts "```"
+          end
+          fail!("docbuild 失败")
+        end
+
+        File.open(status_md, "a") { |f| f.puts "- docbuild: 成功" }
+
+        archives = []
+        Find.find(derived_dir) do |p|
+          next unless File.directory?(p)
+          next unless p.end_with?(".doccarchive")
+          archives << p
+          Find.prune
+        end
+
+        doccarchive_path =
+          archives
+            .select { |p| File.directory?(p) }
+            .sort_by { |p| File.mtime(p) }
+            .reverse
+            .find { |p| File.basename(p) == "#{scheme}.doccarchive" } || archives.max_by { |p| File.mtime(p) }
+
+        fail!("未找到 .doccarchive（derivedData=#{derived_dir_rel}）") if doccarchive_path.to_s.strip.empty?
+
+        doccarchive_rel = rel_path(doccarchive_path, base_dir: base_dir)
+        File.open(status_md, "a") { |f| f.puts "- doccarchive: #{doccarchive_rel}" }
+
+        site_out = component_dir_abs
+        FileUtils.mkdir_p(site_out)
+
+        export_log = File.join(logs_dir, "docc-transform.log")
+
+        doccarchive_for_export = rel_path(doccarchive_path, base_dir: podspec_dir_abs)
+        export_staging_dir = File.join(derived_data_root, ".docc-site", scheme)
+        FileUtils.rm_rf(export_staging_dir)
+        FileUtils.mkdir_p(export_staging_dir)
+        site_out_for_export = rel_path(export_staging_dir, base_dir: podspec_dir_abs)
+        export_cmd = [
+          "xcrun", "docc", "process-archive", "transform-for-static-hosting",
+          doccarchive_for_export,
+          "--output-path", site_out_for_export,
+          "--hosting-base-path", hosting_base_path
+        ]
+
+        export_cmd_report = export_cmd.dup
+        export_cmd_report[export_cmd_report.index(doccarchive_for_export) || 0] = doccarchive_rel
+        export_cmd_report[export_cmd_report.index(site_out_for_export) || 0] = rel_path(site_out, base_dir: base_dir)
+        File.open(status_md, "a") { |f| f.puts "- export: #{export_cmd_report.join(" ")}" }
+
+        log "导出静态站点: #{component_dir_rel}"
+        export_exit = run_to_file(export_cmd, cwd: podspec_dir_abs, env: { "HOME" => real_home }, log_path: export_log)
+        unless export_exit.zero?
+          warn tail_lines(export_log, 200).join("\n")
+          fail!("docc 导出失败")
+        end
+
+        sync_dir_contents(export_staging_dir, site_out)
+
+        log "本地生成完成: file://#{component_dir_abs.gsub(' ', '%20')}"
+        is_success = true
+
+        staging_dir = File.join(local_work_root, scheme)
+        FileUtils.rm_rf(staging_dir)
+        FileUtils.mv(local_site_output, staging_dir)
+
+        zip_name = "#{scheme}_#{Time.now.strftime("%Y%m%d_%H%M%S")}_#{Process.pid}.zip"
+        local_zip_path = File.join(local_work_root, zip_name)
+
+        zip_log = File.join(logs_dir, "zip.log")
+        zip_timeout_sec = (ENV["BB_DOCC_ZIP_TIMEOUT_SEC"].to_s.strip.empty? ? 1800 : ENV["BB_DOCC_ZIP_TIMEOUT_SEC"].to_i)
+
+        log "📦 正在压缩产物 (zip)... (timeout=#{zip_timeout_sec}s)"
+        log "📄 zip 日志: #{rel_path(zip_log, base_dir: base_dir)}"
+
+        zip_exit = nil
+        FileUtils.mkdir_p(File.dirname(zip_log))
+        File.open(zip_log, "w") do |f|
+          Dir.chdir(local_work_root) do
+            pid = Process.spawn({ "HOME" => real_home }, "zip", "-r", "-q", zip_name, scheme, out: f, err: f)
+            begin
+              Timeout.timeout(zip_timeout_sec) do
+                _pid, status = Process.wait2(pid)
+                zip_exit = status.exitstatus
+              end
+            rescue Timeout::Error
+              begin
+                Process.kill("TERM", pid)
+              rescue StandardError
+              end
+              sleep 2
+              begin
+                Process.kill("KILL", pid)
+              rescue StandardError
+              end
+              zip_exit = 124
+            end
+          end
+        end
+
+        log "📦 压缩结束 (exit=#{zip_exit})"
+        fail!("压缩失败，未找到 zip 文件") unless zip_exit == 0 && File.exist?(local_zip_path)
+
+        zip_rel_path_in_repo = File.join(zip_push_subdir, scheme, zip_name)
+        git_log = File.join(logs_dir, "git-push.log")
+        git_timeout_sec = (ENV["BB_DOCC_GIT_TIMEOUT_SEC"].to_s.strip.empty? ? 600 : ENV["BB_DOCC_GIT_TIMEOUT_SEC"].to_i)
+
+        git_env = { "HOME" => real_home }
+        git_env["GIT_TERMINAL_PROMPT"] = "0" if ENV["BB_DOCC_ALLOW_PROMPT"].to_s.strip != "1"
+
+        log "🚚 正在推送 zip 到 Git: #{redact_git_url(zip_push_repo)} (branch=#{zip_push_branch})"
+        log "📄 git 日志: #{rel_path(git_log, base_dir: base_dir)}"
+
+        git_exit = push_zip_to_git(
+          repo_url: zip_push_repo,
+          branch: zip_push_branch,
+          scheme: scheme,
+          zip_path: local_zip_path,
+          zip_rel_path_in_repo: zip_rel_path_in_repo,
+          log_path: git_log,
+          env: git_env,
+          timeout_sec: git_timeout_sec
+        )
+        fail!("推送 zip 失败（exit=#{git_exit}）") unless git_exit.zero?
+
+      ensure
+        at_exit_block.call
+      end
+    end
+
+    private
+
+    def log(msg)
+      puts "[docc] #{msg}"
+    end
+
+    def fail!(msg)
+      warn "[docc][error] #{msg}"
+      exit 1
+    end
+
+    def abs_path(path, base_dir:)
+      return "" if path.nil? || path.empty?
+      return File.expand_path(path) if path.start_with?("/")
+      File.expand_path(path, base_dir)
+    end
+
+    def rel_path(path, base_dir:)
+      p = path.to_s
+      return "" if p.empty?
+      return p unless p.start_with?("/")
+      base = base_dir.to_s
+      return p if base.empty?
+
+      Pathname.new(p).relative_path_from(Pathname.new(base)).to_s
+    rescue StandardError
+      p
+    end
+
+    def path_inside_dir?(path, dir)
+      p = File.expand_path(path.to_s)
+      d = File.expand_path(dir.to_s)
+      return false if p.empty? || d.empty?
+      return true if p == d
+      p.start_with?(d + File::SEPARATOR)
+    rescue StandardError
+      false
+    end
+
+    def cleanup_temp_dirs(keep_dir:, logs_dir:, dirs:)
+      keep_abs = File.expand_path(keep_dir.to_s)
+      logs_abs = File.expand_path(logs_dir.to_s)
+
+      cleaned = []
+      skipped = []
+
+      dirs.each do |dir|
+        p = dir.to_s.strip
+        next if p.empty?
+
+        abs = File.expand_path(p)
+        next if abs.empty?
+        next if abs == "/"
+        next if abs == keep_abs
+
+        if path_inside_dir?(abs, logs_abs)
+          skipped << abs
+          next
+        end
+
+        unless path_inside_dir?(abs, keep_abs)
+          skipped << abs
+          next
+        end
+
+        FileUtils.rm_rf(abs)
+        cleaned << abs
+      rescue StandardError
+        skipped << p
+      end
+
+      [cleaned.uniq, skipped.uniq]
+    end
+
+    def which(cmd)
+      path = ENV["PATH"].to_s
+      path.split(":").each do |dir|
+        p = File.join(dir, cmd)
+        return p if File.file?(p) && File.executable?(p)
+      end
+      nil
+    end
+
+    def require_cmd!(cmd)
+      return if which(cmd)
+      fail!("缺少命令: #{cmd}")
+    end
+
+    def safe_read_text(path)
+      File.read(path, mode: "r:bom|utf-8", invalid: :replace, undef: :replace, replace: "")
+    rescue StandardError
+      ""
+    end
+
+    def parse_version(v)
+      parts = v.to_s.strip.split(".")
+      major = parts[0].to_s.match?(/\A\d+\z/) ? parts[0].to_i : 0
+      minor = parts[1].to_s.match?(/\A\d+\z/) ? parts[1].to_i : 0
+      [major, minor]
+    end
+
+    def tail_lines(path, max_lines)
+      return [] unless File.file?(path)
+
+      lines = []
+      chunk_size = 8192
+
+      File.open(path, "rb") do |f|
+        f.seek(0, IO::SEEK_END)
+        pos = f.pos
+        buffer = +""
+
+        while lines.length <= max_lines && pos.positive?
+          read_size = [chunk_size, pos].min
+          pos -= read_size
+          f.seek(pos, IO::SEEK_SET)
+          buffer.prepend(f.read(read_size))
+          parts = buffer.split(/\r?\n/, -1)
+          buffer = parts.shift.to_s
+          lines = parts + lines
+        end
+
+        lines.unshift(buffer) unless buffer.empty?
+      end
+
+      # Fix: Convert lines to UTF-8 and scrub invalid bytes to avoid encoding errors
+      lines.last(max_lines).map do |line|
+        line.force_encoding("UTF-8").scrub("?")
+      end
+    end
+
+    def extract_name_from_podspec(spec_path)
+      begin
+        require "cocoapods"
+        name = Pod::Spec.from_file(spec_path).name.to_s
+        return name unless name.empty?
+      rescue StandardError
+      end
+
+      text = safe_read_text(spec_path)
+      if (m = text.match(/^[[:space:]]*s\.name[[:space:]]*=[[:space:]]*['"]([^'"]+)['"]/))
+        return m[1].to_s.strip
+      end
+
+      File.basename(spec_path, ".podspec")
+    end
+
+    def extract_ios_deployment_target_from_podspec(spec_path)
+      begin
+        require "cocoapods"
+        target = Pod::Spec.from_file(spec_path).ios.deployment_target.to_s
+        return target unless target.empty?
+      rescue StandardError
+      end
+
+      text = safe_read_text(spec_path)
+      if (m = text.match(/^[[:space:]]*s\.ios\.deployment_target[[:space:]]*=[[:space:]]*['"]([^'"]+)['"]/))
+        return m[1].to_s.strip
+      end
+
+      if (m = text.match(/^[[:space:]]*s\.platform[[:space:]]*=[[:space:]]*:ios[[:space:]]*,[[:space:]]*['"]([^'"]+)['"]/))
+        return m[1].to_s.strip
+      end
+
+      "13.0"
+    end
+
+    def run_to_file(cmd, cwd:, env:, log_path:)
+      FileUtils.mkdir_p(File.dirname(log_path))
+      File.open(log_path, "w") do |f|
+        pid = Process.spawn(env, *cmd, chdir: cwd, out: f, err: f)
+        _pid, status = Process.wait2(pid)
+        status.exitstatus
+      end
+    end
+
+    def sync_dir_contents(src_dir, dst_dir)
+      FileUtils.mkdir_p(dst_dir)
+      Dir.children(src_dir).each do |name|
+        src = File.join(src_dir, name)
+        dst = File.join(dst_dir, name)
+        FileUtils.rm_rf(dst)
+        FileUtils.cp_r(src, dst, preserve: true)
+      end
+    end
+
+    def redact_git_url(url)
+      s = url.to_s
+      return s if s.empty?
+
+      if (m = s.match(/\A(https?:\/\/)([^@\/]+)@(.+)\z/))
+        "#{m[1]}***@#{m[3]}"
+      else
+        s
+      end
+    end
+
+    def run_to_file_with_timeout(cmd, cwd:, env:, log_path:, timeout_sec:)
+      FileUtils.mkdir_p(File.dirname(log_path))
+      File.open(log_path, "a") do |f|
+        f.puts
+        f.puts "$ #{cmd.join(" ")}"
+
+        pid = Process.spawn(env, *cmd, chdir: cwd, out: f, err: f)
+        exitstatus = nil
+
+        begin
+          Timeout.timeout(timeout_sec) do
+            _pid, status = Process.wait2(pid)
+            exitstatus = status.exitstatus
+          end
+        rescue Timeout::Error
+          begin
+            Process.kill("TERM", pid)
+          rescue StandardError
+          end
+          sleep 2
+          begin
+            Process.kill("KILL", pid)
+          rescue StandardError
+          end
+          exitstatus = 124
+        end
+
+        f.puts "=> exit=#{exitstatus}"
+        exitstatus
+      end
+    end
+
+    def push_zip_to_git(repo_url:, branch:, scheme:, zip_path:, zip_rel_path_in_repo:, log_path:, env:, timeout_sec:)
+      repo_dir = File.join(File.dirname(log_path.to_s), "zip_push_repo")
+      FileUtils.rm_rf(repo_dir)
+      FileUtils.mkdir_p(File.dirname(repo_dir))
+
+      clone_cmd = ["git", "clone", "--depth", "1", "--branch", branch, repo_url, repo_dir]
+      clone_exit = run_to_file_with_timeout(clone_cmd, cwd: Dir.pwd, env: env, log_path: log_path, timeout_sec: timeout_sec)
+      return clone_exit unless clone_exit.zero?
+
+      target_path = File.join(repo_dir, zip_rel_path_in_repo)
+      target_dir_abs = File.dirname(target_path)
+      target_dir_rel = File.dirname(zip_rel_path_in_repo)
+      target_dir_rel = "" if target_dir_rel == "."
+
+      FileUtils.mkdir_p(target_dir_abs)
+      FileUtils.cp(zip_path, target_path)
+
+      if !target_dir_rel.empty?
+        Dir.glob(File.join(target_dir_abs, "*.zip")).each do |p|
+          next if File.expand_path(p) == File.expand_path(target_path)
+          FileUtils.rm_f(p)
+        end
+      end
+
+      pathspec = target_dir_rel.empty? ? zip_rel_path_in_repo : target_dir_rel
+      add_exit = run_to_file_with_timeout(["git", "add", "-A", "--", pathspec], cwd: repo_dir, env: env, log_path: log_path, timeout_sec: timeout_sec)
+      return add_exit unless add_exit.zero?
+
+      diff_exit = run_to_file_with_timeout(["git", "diff", "--cached", "--quiet"], cwd: repo_dir, env: env, log_path: log_path, timeout_sec: timeout_sec)
+      return 0 if diff_exit.zero?
+
+      author_name = ENV["BB_DOCC_GIT_AUTHOR_NAME"].to_s.strip
+      author_name = "docc-bot" if author_name.empty?
+      author_email = ENV["BB_DOCC_GIT_AUTHOR_EMAIL"].to_s.strip
+      author_email = "docc-bot@babybus.co" if author_email.empty?
+
+      commit_message = ENV["BB_DOCC_GIT_COMMIT_MESSAGE"].to_s.strip
+      commit_message = "添加#{scheme}静态站点" if commit_message.empty?
+
+      commit_cmd = ["git", "-c", "user.name=#{author_name}", "-c", "user.email=#{author_email}", "commit", "-m", commit_message]
+      commit_exit = run_to_file_with_timeout(commit_cmd, cwd: repo_dir, env: env, log_path: log_path, timeout_sec: timeout_sec)
+      return commit_exit unless commit_exit.zero?
+
+      push_cmd = ["git", "push", "origin", "HEAD:#{branch}"]
+      push_exit = nil
+
+      3.times do |i|
+        push_exit = run_to_file_with_timeout(push_cmd, cwd: repo_dir, env: env, log_path: log_path, timeout_sec: timeout_sec)
+        return 0 if push_exit.zero?
+
+        pull_exit = run_to_file_with_timeout(["git", "pull", "--rebase", "origin", branch], cwd: repo_dir, env: env, log_path: log_path, timeout_sec: timeout_sec)
+        return push_exit unless pull_exit.zero?
+
+        sleep 1 + i
+      end
+
+      push_exit
+    end
+
+    def find_workspace_from_lint_log(lint_log, lint_root)
+      workspace_path = nil
+
+      # Fix: explicitly specify encoding to avoid ASCII-8BIT to UTF-8 errors
+      File.foreach(lint_log, encoding: "UTF-8", invalid: :replace, undef: :replace, replace: "?") do |line|
+        if (m = line.match(/Pods workspace available at `([^`]+)`/))
+          workspace_path = m[1].to_s.strip
+        elsif (m = line.match(%r{(/[^ ]+App\.xcworkspace)}))
+          workspace_path = m[1].to_s.strip
+        end
+      end
+
+      if workspace_path && File.directory?(workspace_path)
+        return workspace_path
+      end
+
+      candidates = []
+      root = File.expand_path(lint_root)
+      root_depth = root.split(File::SEPARATOR).length
+
+      Find.find(root) do |p|
+        if File.directory?(p) && p.end_with?(".xcworkspace")
+          depth = p.split(File::SEPARATOR).length - root_depth
+          candidates << p if depth <= 4
+          Find.prune
+        end
+      end
+
+      candidates
+        .select { |p| File.directory?(p) }
+        .max_by { |p| File.mtime(p) }
+    end
+
+    def bump_deployment_targets_in_validation_dir(validation_dir, min_target)
+      min_v = parse_version(min_target)
+      pattern = /(IPHONEOS_DEPLOYMENT_TARGET\s*=\s*)([0-9]+(?:\.[0-9]+)?)(\s*;?)/
+
+      files = []
+      pods_pbxproj = File.join(validation_dir, "Pods", "Pods.xcodeproj", "project.pbxproj")
+      files << pods_pbxproj if File.file?(pods_pbxproj)
+
+      tsf_dir = File.join(validation_dir, "Pods", "Target Support Files")
+      if File.directory?(tsf_dir)
+        Find.find(tsf_dir) do |p|
+          files << p if File.file?(p) && p.end_with?(".xcconfig")
+        end
+      end
+
+      changed = 0
+      files.each do |path|
+        text = safe_read_text(path)
+        next if text.empty?
+
+        new_text = text.gsub(pattern) do
+          prefix = Regexp.last_match(1)
+          cur = Regexp.last_match(2)
+          suffix = Regexp.last_match(3)
+          if (parse_version(cur) <=> min_v) == -1
+            changed += 1
+            "#{prefix}#{min_target}#{suffix}"
+          else
+            Regexp.last_match(0)
+          end
+        end
+
+        next if new_text == text
+        File.write(path, new_text)
+      end
+
+      changed
+    end
+  end
+end

data/lib/cocoapods-bb-PodAssistant/tools.rb

@@ -7,4 +7,5 @@ require "cocoapods-bb-PodAssistant/tools/file_handle"
 require "cocoapods-bb-PodAssistant/tools/class_unuse_finder"
 require "cocoapods-bb-PodAssistant/tools/count_code_line"
 require "cocoapods-bb-PodAssistant/tools/git_sets"
-require "cocoapods-bb-PodAssistant/tools/podfile_tiled"
+require "cocoapods-bb-PodAssistant/tools/podfile_tiled"
+require "cocoapods-bb-PodAssistant/tools/docc_generator"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cocoapods-bb-PodAssistant
 version: !ruby/object:Gem::Version
-  version: 0.3.13.9
+  version: 0.3.14.1
 platform: ruby
 authors:
 - humin
@@ -189,6 +189,7 @@ files:
 - lib/cocoapods-bb-PodAssistant/tools.rb
 - lib/cocoapods-bb-PodAssistant/tools/class_unuse_finder.rb
 - lib/cocoapods-bb-PodAssistant/tools/count_code_line.rb
+- lib/cocoapods-bb-PodAssistant/tools/docc_generator.rb
 - lib/cocoapods-bb-PodAssistant/tools/file_handle.rb
 - lib/cocoapods-bb-PodAssistant/tools/find_unuse_img.rb
 - lib/cocoapods-bb-PodAssistant/tools/get_size.rb