unipod 0.1.0

data/lib/unipod/server/cache_manager.rb

@@ -0,0 +1,1106 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'open3'
+require 'json'
+require 'pathname'
+require 'yaml'
+require 'digest'
+require 'open-uri'
+require 'unipod/config'
+
+module UniPod
+  module Server
+    # 管理本地缓存和索引仓库
+    class CacheManager
+      DEFAULT_CACHE_DIR = File.join(Dir.home, 'Library', 'Caches', 'UniPod')
+      DEFAULT_INDEX_REPO_DIR = File.join(DEFAULT_CACHE_DIR, 'scoped')
+      DEFAULT_PACKAGES_DIR = File.join(DEFAULT_CACHE_DIR, 'packages')
+      DEFAULT_TARBALLS_DIR = File.join(DEFAULT_CACHE_DIR, 'tarballs')
+      
+      # 增加Unity和NPM的包类型常量
+      PACKAGE_TYPE_UNITY = 'unity'.freeze
+      PACKAGE_TYPE_NPM = 'npm'.freeze
+
+      def initialize(options = {})
+        @cache_dir = options[:cache_dir] || detect_cache_dir
+        @index_repo_dir = options[:index_repo_dir] || File.join(@cache_dir, 'scoped')
+        @packages_dir = File.join(@cache_dir, 'packages')
+        @tarballs_dir = File.join(@cache_dir, 'tarballs')
+        @verbose = options[:verbose] || false
+        @index_repos = []
+        @cache = {}  # 内存缓存
+        @last_update_time = {}  # 最后更新时间
+        @index_updated = false  # 索引是否已更新
+        @package_type_cache = {}  # 包类型缓存
+        
+        # 确保缓存目录存在
+        FileUtils.mkdir_p(@cache_dir)
+        FileUtils.mkdir_p(@index_repo_dir)
+        FileUtils.mkdir_p(@packages_dir)
+        FileUtils.mkdir_p(@tarballs_dir)
+        
+        # 从配置中读取索引库
+        load_index_repos_from_config
+        
+        # 初始化索引库
+        update_index_repos
+      end
+
+      # 刷新缓存的公开方法，确保在private方法列表之前定义
+      def refresh_cache
+        UI.puts "刷新包缓存..." if @verbose
+        @index_updated = false
+        @cache = {}  # 清空缓存
+        get_all_packages  # 重新加载所有包
+        UI.puts "包缓存已刷新，共发现#{@cache.size}个包" if @verbose
+        true
+      end
+
+      # 从Unity的manifest.json文件中读取索引库配置
+      def load_index_repos_from_config
+        # 从Config模块获取配置的索引库
+        config_repos = Config.index_repos || []
+        
+        # 将配置的索引库添加到索引库列表
+        config_repos.each do |repo|
+          if repo[:package_index_url]
+            @index_repos << repo
+          end
+        end
+        
+        # 如果没有配置索引库，使用默认索引库
+        if @index_repos.empty?
+          # 默认Git URL
+          default_git_url = 'https://gitee.com/goodunitylib/JoyUnityLibIndex.git'
+          
+          # 从URL中提取仓库名称
+          repo_name = extract_repo_name_from_url(default_git_url)
+          
+          @index_repos = [
+            {
+              name: repo_name,
+              url: default_git_url,
+              package_index_url: default_git_url
+            }
+          ]
+        end
+        
+        UI.puts "加载了#{@index_repos.size}个索引库配置" if @verbose
+      end
+      
+      # 从Git URL中提取仓库名称
+      def extract_repo_name_from_url(url)
+        # 处理URL格式
+        # 示例: https://gitee.com/goodunitylib/JoyUnityLibIndex.git -> JoyUnityLibIndex
+        # 示例: git@github.com:user/repo.git -> repo
+        # 示例: https://github.com/user/repo -> repo
+        
+        if url.nil? || url.empty?
+          return 'default_repo'
+        end
+        
+        # 移除尾部的.git（如果有）
+        url = url.sub(/\.git\z/, '')
+        
+        # 处理不同格式的URL
+        if url.include?('/')
+          # 处理https://格式或git://格式
+          repo_name = url.split('/').last
+        elsif url.include?(':')
+          # 处理git@格式
+          repo_name = url.split(':').last.split('/').last
+        else
+          # 无法解析时使用默认名称
+          repo_name = 'default_repo'
+        end
+        
+        # 确保名称不包含特殊字符
+        repo_name.gsub(/[^a-zA-Z0-9_-]/, '_')
+      end
+
+      # 获取包信息
+      def get_package_info(package_name)
+        # 从缓存中获取
+        if @cache.key?(package_name)
+          return @cache[package_name]
+        end
+        
+        ensure_index_updated
+        
+        UI.puts "获取包信息: #{package_name}" if @verbose
+        
+        # 从索引库中查找包信息
+        @index_repos.each do |repo|
+          repo_dir = get_repo_dir(repo[:name])
+          specs_dir = File.join(repo_dir, 'Specs')
+          
+          # 首先检查Specs目录（CocoaPods结构）
+          package_dir = File.join(specs_dir, package_name)
+          if Dir.exist?(package_dir)
+            # 查找最新版本
+            version_dirs = Dir.glob(File.join(package_dir, '*')).select { |d| File.directory?(d) }
+            if version_dirs.any?
+              # 获取最新版本
+              latest_version_dir = version_dirs.sort_by { |d| Gem::Version.new(File.basename(d)) rescue '0.0.0' }.last
+              spec_path = File.join(latest_version_dir, 'spec.json')
+              
+              if File.exist?(spec_path)
+                begin
+                  spec = JSON.parse(File.read(spec_path))
+                  package_info = convert_spec_to_package(spec)
+                  processed_info = ensure_package_structure(package_info)
+                  @cache[package_name] = processed_info
+                  return processed_info
+                rescue => e
+                  UI.puts "解析spec.json错误: #{e.message}" if @verbose
+                end
+              end
+            end
+          end
+          
+          # 向后兼容：检查package.json
+          package_path = File.join(repo_dir, package_name, 'package.json')
+          if File.exist?(package_path)
+            begin
+              package_info = JSON.parse(File.read(package_path))
+              processed_info = ensure_package_structure(package_info)
+              @cache[package_name] = processed_info
+              return processed_info
+            rescue => e
+              UI.puts "解析package.json错误: #{e.message}" if @verbose
+            end
+          end
+        end
+        
+        nil
+      end
+
+      # 获取所有包的信息
+      def get_all_packages
+        UI.puts 'CacheManager: 获取所有包' if @verbose
+        
+        # 检查索引是否已更新且缓存不为空
+        if is_index_updated? && !@cache.empty?
+          UI.puts "CacheManager: 返回缓存中的 #{@cache.size} 个包" if @verbose
+          # 确保返回格式化的结果
+          return format_packages_response(@cache.values)
+        end
+        
+        packages = {}
+        
+        # 获取存储库目录中的package.json文件
+        package_files = Dir.glob(File.join(@index_repo_dir, '**/package.json'))
+        spec_files = Dir.glob(File.join(@index_repo_dir, '**/spec.json'))
+        
+        UI.puts "CacheManager: 找到 #{package_files.size} 个package.json文件" if @verbose
+        UI.puts "CacheManager: 找到 #{spec_files.size} 个spec.json文件" if @verbose
+        
+        # 处理所有找到的package.json文件
+        package_files.each do |package_file|
+          begin
+            package_data = JSON.parse(File.read(package_file))
+            package_name = package_data['name']
+            
+            if package_name.nil? || package_name.empty?
+              UI.puts "CacheManager: 忽略没有名称的包: #{package_file}" if @verbose
+              next
+            end
+            
+            UI.puts "CacheManager: 处理包 #{package_name}" if @verbose
+            packages[package_name] = package_data
+            
+          rescue JSON::ParserError => e
+            UI.puts "CacheManager: 解析错误 #{package_file}: #{e.message}" if @verbose
+          rescue => e
+            UI.puts "CacheManager: 处理 #{package_file} 时出错: #{e.message}" if @verbose
+          end
+        end
+        
+        # 处理所有找到的spec.json文件
+        spec_files.each do |spec_file|
+          begin
+            spec_data = JSON.parse(File.read(spec_file))
+            package_name = spec_data['name']
+            
+            if package_name.nil? || package_name.empty?
+              UI.puts "CacheManager: 忽略没有名称的规格: #{spec_file}" if @verbose
+              next
+            end
+            
+            if packages.key?(package_name)
+              # 合并spec.json中的信息到现有包
+              packages[package_name] = packages[package_name].merge(spec_data)
+              UI.puts "CacheManager: 合并规格到包 #{package_name}" if @verbose
+            else
+              # 添加新包
+              packages[package_name] = spec_data
+              UI.puts "CacheManager: 添加规格作为新包 #{package_name}" if @verbose
+            end
+            
+          rescue JSON::ParserError => e
+            UI.puts "CacheManager: 解析错误 #{spec_file}: #{e.message}" if @verbose
+          rescue => e
+            UI.puts "CacheManager: 处理 #{spec_file} 时出错: #{e.message}" if @verbose
+          end
+        end
+        
+        # 如果没有找到包，添加示例包以确保功能正常运行
+        if packages.empty?
+          UI.puts "CacheManager: 警告 - 未找到有效的包，创建示例包" if @verbose
+          # 创建并添加示例包
+          example_package = create_example_package
+          packages[example_package['name']] = example_package
+          UI.puts "CacheManager: 添加了示例包: #{example_package['name']}" if @verbose
+        end
+        
+        # 更新缓存
+        @cache = packages
+        @index_updated = true
+        
+        # 使用format_packages_response格式化返回结果
+        formatted_result = format_packages_response(@cache.values)
+        UI.puts "CacheManager: 返回 #{formatted_result['objects'].size} 个包" if @verbose
+        
+        return formatted_result
+      end
+
+      # 获取包的版本信息
+      def get_package_versions(package_name)
+        UI.puts "获取包版本信息: #{package_name}" if @verbose
+        
+        package_info = get_package_info(package_name)
+        return nil unless package_info
+        
+        versions = {}
+        package_info['versions'].each do |version, info|
+          versions[version] = ensure_package_structure(info)
+        end
+        
+        {
+          'name' => package_name,
+          'versions' => versions,
+          'time' => {
+            'modified' => Time.now.iso8601,
+            'created' => Time.now.iso8601
+          },
+          'dist-tags' => package_info['dist-tags'] || { 'latest' => package_info['version'] }
+        }
+      end
+
+      # 获取包的压缩文件
+      def get_package_tarball(package_name, tarball_name)
+        UI.puts "获取包压缩文件: #{package_name} - #{tarball_name}" if @verbose
+        
+        # 查找缓存的压缩文件
+        tarball_path = File.join(@tarballs_dir, package_name, tarball_name)
+        if File.exist?(tarball_path)
+          UI.puts "使用缓存的压缩文件: #{tarball_path}" if @verbose
+          return tarball_path
+        end
+        
+        UI.puts "缓存中没有找到压缩文件，尝试从Git仓库构建" if @verbose
+        
+        # 获取包信息
+        package_info = get_package_info(package_name)
+        unless package_info
+          UI.puts "未找到包信息: #{package_name}" if @verbose
+          return nil
+        end
+        
+        # 检查是否有Git仓库信息
+        if package_info['git'] && package_info['git']['url']
+          git_url = package_info['git']['url']
+          git_tag = package_info['git']['tag'] || package_info['version']
+          git_branch = package_info['git']['branch'] || 'main'
+          
+          UI.puts "从Git仓库构建压缩包: #{git_url} (tag: #{git_tag}, branch: #{git_branch})" if @verbose
+          
+          # 调用克隆并构建包的方法
+          if clone_and_build_package(package_name, git_url, git_tag, git_branch)
+            # 检查是否成功生成压缩文件
+            if File.exist?(tarball_path)
+              UI.puts "成功构建压缩包: #{tarball_path}" if @verbose
+              return tarball_path
+            end
+          end
+        end
+        
+        # 如果还是没有找到，尝试从索引库中查找现有的tgz文件
+        @index_repos.each do |repo|
+          repo_dir = get_repo_dir(repo[:name])
+          pkg_dir = File.join(repo_dir, package_name)
+          
+          # 检查是否有对应的压缩文件
+          tarball_paths = Dir.glob(File.join(pkg_dir, "*.tgz"))
+          if !tarball_paths.empty?
+            # 保存到缓存
+            FileUtils.mkdir_p(File.dirname(tarball_path))
+            FileUtils.cp(tarball_paths.first, tarball_path)
+            return tarball_path
+          end
+        end
+        
+        nil
+      end
+
+      # 搜索包
+      def search_packages(query)
+        # 确保索引是最新的
+        ensure_index_updated
+        
+        UI.puts "搜索包: #{query}" if @verbose
+        
+        # 获取所有包信息
+        all_packages = get_all_packages
+        
+        # 如果没有查询，返回所有包
+        if query.nil? || query.empty?
+          return all_packages
+        end
+        
+        # 过滤包
+        filtered_packages = all_packages['objects'].select do |obj|
+          package = obj['package']
+          name_matches_query?(package['name'], query) ||
+            (package['description'] && package['description'].downcase.include?(query.downcase)) ||
+            (package['keywords'] && package['keywords'].any? { |k| k.downcase.include?(query.downcase) })
+        end
+        
+        # 为空结果时尝试更灵活的匹配
+        if filtered_packages.empty?
+          # 尝试作用域匹配
+          if query.include?('.')
+            scope = query.split('.').first
+            filtered_packages = all_packages['objects'].select do |obj|
+              package = obj['package']
+              package['name'].start_with?(scope)
+            end
+          end
+          
+          # 尝试前缀匹配
+          if filtered_packages.empty?
+            filtered_packages = all_packages['objects'].select do |obj|
+              package = obj['package']
+              package['name'].include?(query.downcase)
+            end
+          end
+        end
+        
+        {
+          'objects' => filtered_packages,
+          'total' => filtered_packages.size,
+          'time' => all_packages['time']
+        }
+      end
+      
+      private
+      
+      # 检查包名是否匹配查询条件
+      def name_matches_query?(name, query)
+        # 标准化名称和查询
+        name_lower = name.downcase
+        query_lower = query.downcase
+        
+        # 直接匹配
+        return true if name_lower == query_lower
+        
+        # 处理作用域名称匹配
+        if query_lower.include?('.')
+          # Unity包格式: com.company.package
+          parts = query_lower.split('.')
+          return true if name_lower == parts.join('.')
+          
+          # 匹配前缀
+          return true if name_lower.start_with?(query_lower)
+        end
+        
+        # 部分匹配
+        name_lower.include?(query_lower)
+      end
+
+      def detect_cache_dir
+        # 使用 Config 类提供的缓存目录，确保所有系统统一
+        UniPod::Config.cache_dir
+      end
+
+      def init_cache_dirs
+        FileUtils.mkdir_p(@index_repo_dir)
+        FileUtils.mkdir_p(@packages_dir)
+        FileUtils.mkdir_p(@tarballs_dir)
+      end
+
+      # 获取当前缓存目录
+      def cache_dir
+        detect_cache_dir
+      end
+
+      # 获取索引仓库目录
+      def scoped_dir
+        File.join(cache_dir, 'scoped')
+      end
+
+      # 获取包仓库目录
+      def packages_dir
+        File.join(cache_dir, 'packages')
+      end
+      
+      # 获取压缩文件目录
+      def tarballs_dir
+        File.join(cache_dir, 'tarballs')
+      end
+
+      def update_index_repos
+        # 如果最后更新时间在1小时内，跳过
+        if @index_updated
+          return true
+        end
+        
+        UI.puts "更新索引库" if @verbose
+        
+        success = true
+        @index_repos.each do |repo|
+          success = success && update_index_repo(repo)
+        end
+        
+        if @index_repos.empty?
+          # 如果没有配置索引库，创建一个默认目录
+          UI.puts "没有配置索引库，创建默认目录结构" if @verbose
+          
+          # 获取默认仓库名称
+          default_git_url = 'https://gitee.com/goodunitylib/JoyUnityLibIndex.git'
+          default_repo_name = extract_repo_name_from_url(default_git_url)
+          
+          FileUtils.mkdir_p(File.join(@index_repo_dir, default_repo_name))
+          
+          # 获取包信息
+          dirs = Dir.glob(File.join(@index_repo_dir, '**/package.json'))
+          dirs.each do |d|
+            UI.puts "发现包: #{d}" if @verbose
+          end
+        end
+        
+        @index_updated = success
+        get_all_packages if success  # 预加载所有包信息
+        success
+      end
+
+      def update_index_repo(repo)
+        repo_name = repo[:name]
+        repo_url = repo[:package_index_url] || repo[:url]
+        repo_dir = get_repo_dir(repo_name)
+        
+        # 检查最后更新时间
+        last_update = @last_update_time[repo_name]
+        if last_update && (Time.now - last_update) < 3600  # 1小时
+          UI.puts "索引库 #{repo_name} 已在1小时内更新，跳过" if @verbose
+          return true
+        end
+        
+        UI.puts "更新索引库: #{repo_name} - #{repo_url}" if @verbose
+        
+        begin
+          # 如果目录不存在，克隆仓库
+          if !Dir.exist?(repo_dir)
+            UI.puts "克隆索引库: #{repo_url} 到 #{repo_dir}" if @verbose
+            
+            # 使用git克隆
+            clone_cmd = "git clone #{repo_url} #{repo_dir}"
+            system(clone_cmd)
+            
+            unless $?.success?
+              UI.error "克隆索引库失败: #{repo_url}"
+              return false
+            end
+          else
+            # 更新仓库
+            UI.puts "更新索引库: #{repo_dir}" if @verbose
+            
+            # 切换到仓库目录
+            Dir.chdir(repo_dir) do
+              # 拉取更新
+              pull_cmd = "git pull"
+              system(pull_cmd)
+              
+              unless $?.success?
+                UI.error "更新索引库失败: #{repo_dir}"
+                return false
+              end
+            end
+          end
+          
+          # 更新最后更新时间
+          @last_update_time[repo_name] = Time.now
+          
+          true
+        rescue => e
+          UI.error "更新索引库时出错: #{e.message}"
+          false
+        end
+      end
+
+      def find_package_file(package_name)
+        # 首先查找spec.json文件
+        spec_files = Dir.glob(File.join(@index_repo_dir, "*/Specs/#{package_name}/**/spec.json"))
+        return spec_files.first if spec_files.any?
+        
+        # 如果没有找到spec.json，查找package.json
+        Dir.glob(File.join(@index_repo_dir, "*/#{package_name}/**/package.json")).first
+      end
+
+      def convert_spec_to_package(spec_info)
+        # 将spec.json格式转换为标准的package.json格式
+        package_info = spec_info.dup
+        
+        # 确保有displayName字段（Unity需要）
+        package_info['displayName'] ||= humanize_package_name(package_info['name'])
+        
+        # 确保有unity字段
+        package_info['unity'] ||= '2019.4'
+        
+        # 添加Unity特定字段
+        package_info['unity'] ||= '2019.4'
+        package_info['type'] ||= 'library'
+        
+        # 添加versions字段
+        package_info['versions'] = {
+          spec_info['version'] => package_info.dup
+        }
+        
+        # 添加repository字段
+        if spec_info['git'] && spec_info['git']['url']
+          package_info['repository'] = {
+            'type' => 'git',
+            'url' => spec_info['git']['url']
+          }
+        end
+        
+        # 添加dist标签
+        tarball_name = "#{package_info['name'].gsub('/', '-')}-#{package_info['version']}.tgz"
+        package_info['dist'] = {
+          'tarball' => "http://localhost:7748/#{package_info['name']}/-/#{tarball_name}"
+        }
+        
+        package_info
+      end
+      
+      # 确保包信息具有Unity包管理器需要的结构
+      def ensure_package_structure(package_info)
+        return {} unless package_info
+
+        # 检测包类型        
+        package_type = detect_package_type(package_info)
+        
+        # 复制包信息，确保不修改原始对象
+        info = package_info.clone
+        
+        # 添加必要的字段
+        info['name'] ||= 'unknown'
+        info['version'] ||= '1.0.0'
+        info['description'] ||= ''
+        info['author'] ||= { 'name' => 'Unknown' }
+        info['keywords'] ||= []
+        info['maintainers'] ||= [{ 'name' => info['author']['name'] || 'Unknown' }]
+        
+        # 处理Unity特定字段
+        if package_type == PACKAGE_TYPE_UNITY
+          # 对于Unity包，确保有正确的格式
+          info['displayName'] ||= humanize_package_name(info['name'])
+          info['unity'] ||= '*'
+          
+          # 确保dependencies格式正确
+          if info['dependencies']
+            info['dependencies'].each do |k, v|
+              # 确保版本格式是Unity兼容的
+              info['dependencies'][k] = ensure_unity_version_format(v)
+            end
+          end
+        end
+        
+        # 处理版本信息
+        if !info['versions'] || info['versions'].empty?
+          version = info['version']
+          info['versions'] = {
+            version => {
+              'name' => info['name'],
+              'version' => version,
+              'description' => info['description'],
+              'displayName' => info['displayName'],
+              'author' => info['author'],
+              'dependencies' => info['dependencies'] || {},
+              'keywords' => info['keywords'],
+              'dist' => {
+                'shasum' => '',
+                'tarball' => "./#{info['name']}/#{info['name']}-#{version}.tgz"
+              }
+            }
+          }
+        end
+        
+        # 确保dependencies字段在每个版本中都存在
+        info['versions'].each do |version, version_info|
+          version_info['dependencies'] ||= {}
+          
+          # 处理Unity特定字段
+          if package_type == PACKAGE_TYPE_UNITY
+            version_info['displayName'] ||= info['displayName'] || humanize_package_name(info['name'])
+            version_info['unity'] ||= info['unity'] || '*'
+            
+            # 确保有特定的Unity字段
+            version_info['unity'] ||= info['unity'] || '*'
+            version_info['unityRelease'] ||= info['unityRelease'] || ''
+            
+            # 确保dependencies格式正确
+            if version_info['dependencies']
+              version_info['dependencies'].each do |k, v|
+                # 确保版本格式是Unity兼容的
+                version_info['dependencies'][k] = ensure_unity_version_format(v)
+              end
+            end
+          end
+        end
+        
+        # 确保dist-tags字段存在
+        info['dist-tags'] ||= { 'latest' => info['version'] || info['versions'].keys.sort.last }
+        
+        info
+      end
+      
+      # 将包名转换为更友好的显示名称
+      def humanize_package_name(name)
+        return name unless name
+        
+        # 处理Unity包名格式 (com.company.package)
+        if name.include?('.')
+          parts = name.split('.')
+          if parts.size > 1
+            # 使用最后一部分作为显示名称
+            display_name = parts.last
+            # 将camelCase转换为有空格的形式
+            display_name = display_name.gsub(/([A-Z])/, ' \1').strip
+            # 首字母大写
+            return display_name.capitalize
+          end
+        end
+        
+        # 处理NPM包名格式 (@scope/package)
+        if name.include?('/')
+          parts = name.split('/')
+          if parts.size > 1
+            # 移除前缀@
+            scope = parts.first.sub(/^@/, '')
+            package = parts.last
+            # 将camelCase转换为有空格的形式
+            package = package.gsub(/([A-Z])/, ' \1').strip
+            # 首字母大写
+            return "#{scope.capitalize} #{package.capitalize}"
+          end
+        end
+        
+        # 将camelCase或snake_case转换为有空格的形式
+        name = name.gsub(/([A-Z])/, ' \1').gsub('_', ' ').strip
+        name.capitalize
+      end
+      
+      # 确保版本号符合Unity要求
+      def ensure_unity_version_format(version)
+        return '*' if version.nil? || version.empty?
+        
+        # 处理特殊值
+        return version if ['*', 'latest'].include?(version)
+        
+        # 如果是纯数字或常规版本号，添加^前缀
+        if version =~ /^\d/ && !version.start_with?('^', '~', '>', '<', '=')
+          return "^#{version}"
+        end
+        
+        version
+      end
+
+      def clone_and_build_package(package_name, git_url, git_tag = nil, git_branch = nil)
+        UI.puts "克隆并构建包: #{package_name} (#{git_url})" if @verbose
+        
+        # 创建包目录
+        package_dir = File.join(@packages_dir, package_name)
+        FileUtils.mkdir_p(package_dir) unless Dir.exist?(package_dir)
+        
+        begin
+          # 检查目录是否已经是Git仓库
+          if File.directory?(File.join(package_dir, '.git'))
+            # 已存在Git仓库，更新它
+            UI.puts "更新现有的Git仓库: #{package_dir}" if @verbose
+            Dir.chdir(package_dir) do
+              # 获取远程URL
+              remote_url = `git config --get remote.origin.url`.strip
+              
+              # 如果远程URL与预期不同，重新设置
+              if remote_url != git_url
+                UI.puts "重新设置远程URL: #{git_url}" if @verbose
+                run_git_command("git remote set-url origin #{git_url}")
+              end
+              
+              # 获取最新更改
+              run_git_command("git fetch --all --quiet")
+              
+              # 尝试切换到指定标签或分支
+              if git_tag
+                UI.puts "切换到标签: #{git_tag}" if @verbose
+                result = run_git_command("git checkout tags/#{git_tag} -f --quiet")
+                
+                # 如果标签不存在，尝试直接使用作为提交ID
+                unless result
+                  UI.puts "标签不存在，尝试作为提交ID: #{git_tag}" if @verbose
+                  result = run_git_command("git checkout #{git_tag} -f --quiet")
+                end
+                
+                # 如果仍然失败，尝试使用分支
+                unless result
+                  UI.puts "使用分支: #{git_branch}" if @verbose
+                  run_git_command("git checkout #{git_branch} -f --quiet && git pull --quiet")
+                end
+              elsif git_branch
+                UI.puts "切换到分支: #{git_branch}" if @verbose
+                run_git_command("git checkout #{git_branch} -f --quiet && git pull --quiet")
+              else
+                # 如果没有指定标签或分支，使用主分支
+                UI.puts "使用默认分支" if @verbose
+                run_git_command("git checkout main -f --quiet || git checkout master -f --quiet")
+                run_git_command("git pull --quiet")
+              end
+            end
+          else
+            # 不存在Git仓库，克隆它
+            UI.puts "克隆新的Git仓库: #{git_url} 到 #{package_dir}" if @verbose
+            
+            # 先清空目录（如果非空）
+            FileUtils.rm_rf(package_dir)
+            FileUtils.mkdir_p(package_dir)
+            
+            # 克隆仓库 - 使用--quiet选项减少输出
+            clone_cmd = "git clone --quiet #{git_url} #{package_dir}"
+            unless run_git_command(clone_cmd)
+              UI.error "克隆Git仓库失败: #{git_url}"
+              return false
+            end
+            
+            # 切换到指定标签或分支
+            Dir.chdir(package_dir) do
+              if git_tag
+                UI.puts "切换到标签: #{git_tag}" if @verbose
+                result = run_git_command("git checkout tags/#{git_tag} --quiet")
+                
+                # 如果标签不存在，尝试直接使用作为提交ID
+                unless result
+                  UI.puts "标签不存在，尝试作为提交ID: #{git_tag}" if @verbose
+                  result = run_git_command("git checkout #{git_tag} --quiet")
+                end
+                
+                # 如果仍然失败，尝试使用分支
+                unless result
+                  UI.puts "使用分支: #{git_branch}" if @verbose
+                  run_git_command("git checkout #{git_branch} --quiet")
+                end
+              elsif git_branch
+                UI.puts "切换到分支: #{git_branch}" if @verbose
+                run_git_command("git checkout #{git_branch} --quiet")
+              end
+            end
+          end
+          
+          # 构建压缩包
+          build_package_tarball(package_name, package_dir)
+          
+          true
+        rescue => e
+          UI.error "克隆并构建包时出错: #{e.message}"
+          UI.error e.backtrace.join("\n") if @verbose
+          false
+        end
+      end
+      
+      # 执行Git命令并减少输出
+      def run_git_command(cmd)
+        # 1. 将命令输出重定向到/dev/null (Unix) 或 NUL (Windows)
+        # 2. 使用system返回命令执行结果（成功/失败）
+        null_device = RUBY_PLATFORM =~ /mswin|mingw|cygwin/ ? 'NUL' : '/dev/null'
+        
+        # 默认不显示详细输出，除非启用了verbose且明确标记为需要输出
+        if @verbose && ENV['UNIPOD_GIT_VERBOSE'] == 'true'
+          system(cmd)
+        else
+          # 重定向标准输出和错误输出
+          system("#{cmd} > #{null_device} 2>&1")
+        end
+      end
+
+      def build_package_tarball(package_name, package_dir)
+        UI.puts "构建包压缩文件: #{package_name}" if @verbose
+        
+        # 确保包目录存在
+        unless Dir.exist?(package_dir)
+          UI.error "包目录不存在: #{package_dir}"
+          return false
+        end
+        
+        # 确保package.json文件存在
+        package_json_path = File.join(package_dir, 'package.json')
+        unless File.exist?(package_json_path)
+          UI.error "package.json文件不存在: #{package_json_path}"
+          return false
+        end
+        
+        # 读取package.json获取版本信息
+        begin
+          package_json = JSON.parse(File.read(package_json_path))
+          version = package_json['version']
+          
+          unless version
+            UI.error "package.json中未找到版本信息"
+            return false
+          end
+          
+          # 创建压缩文件目录
+          tarball_dir = File.join(@tarballs_dir, package_name)
+          FileUtils.mkdir_p(tarball_dir)
+          
+          # 压缩文件路径
+          tarball_filename = "#{package_name.gsub('/', '-')}-#{version}.tgz"
+          tarball_path = File.join(tarball_dir, tarball_filename)
+          
+          # 创建临时目录
+          temp_dir = File.join(@cache_dir, 'temp', "#{package_name}-#{version}")
+          FileUtils.rm_rf(temp_dir) if Dir.exist?(temp_dir)
+          FileUtils.mkdir_p(temp_dir)
+          
+          # 复制文件到临时目录（排除.git目录）
+          UI.puts "复制文件到临时目录: #{temp_dir}" if @verbose
+          Dir.glob(File.join(package_dir, '*')).each do |path|
+            basename = File.basename(path)
+            next if basename == '.git' # 排除.git目录
+            
+            if File.directory?(path)
+              FileUtils.cp_r(path, temp_dir)
+            else
+              FileUtils.cp(path, temp_dir)
+            end
+          end
+          
+          # 创建压缩文件
+          UI.puts "创建压缩文件: #{tarball_path}" if @verbose
+          
+          Dir.chdir(temp_dir) do
+            system("tar -czf #{tarball_path} .")
+          end
+          
+          # 清理临时目录
+          FileUtils.rm_rf(temp_dir)
+          
+          # 检查压缩文件是否创建成功
+          if File.exist?(tarball_path)
+            UI.puts "压缩文件创建成功: #{tarball_path}" if @verbose
+            return true
+          else
+            UI.error "压缩文件创建失败"
+            return false
+          end
+        rescue => e
+          UI.error "构建压缩文件时出错: #{e.message}"
+          UI.error e.backtrace.join("\n") if @verbose
+          false
+        end
+      end
+
+      def verbose?
+        # 可以从配置或环境变量获取
+        ENV['UNIPOD_VERBOSE'] == 'true'
+      end
+
+      # 计算搜索得分
+      def calculate_search_score(name, query)
+        return 1.0 if query.empty?
+        
+        name_downcase = name.downcase
+        query_downcase = query.downcase
+        
+        if name_downcase == query_downcase
+          # 完全匹配
+          return 1.0
+        elsif name_downcase.start_with?(query_downcase)
+          # 前缀匹配
+          return 0.9
+        elsif name_downcase.include?(query_downcase)
+          # 包含匹配
+          return 0.7
+        else
+          # 使用Levenshtein距离计算相似度
+          return calculate_similarity(name_downcase, query_downcase)
+        end
+      end
+      
+      # 计算字符串相似度
+      def calculate_similarity(str1, str2)
+        len1 = str1.length
+        len2 = str2.length
+        
+        # 如果一个字符串为空，距离等于另一个字符串的长度
+        return 0.0 if len1 == 0 || len2 == 0
+        
+        # 使用更简单的方法计算相似度
+        common_chars = 0
+        str2.each_char do |char|
+          if str1.include?(char)
+            common_chars += 1
+          end
+        end
+        
+        # 计算相似度得分 (0-1之间)
+        similarity = common_chars.to_f / [len1, len2].max
+        
+        # 归一化得分
+        [similarity, 0.5].max
+      end
+
+      # 确保索引已更新
+      def ensure_index_updated(force_refresh = false)
+        if force_refresh
+          UI.puts "强制刷新缓存..." if @verbose
+          @index_updated = false
+          @cache = {}  # 清空缓存
+        end
+        update_index_repos unless @index_updated
+      end
+
+      # 获取索引库目录
+      def get_repo_dir(repo_name)
+        repo_name = repo_name.gsub(/[^a-zA-Z0-9_-]/, '_')
+        File.join(@index_repo_dir, repo_name)
+      end
+
+      # 检测包类型
+      def detect_package_type(package_info)
+        # 如果已经检测过，直接返回
+        if @package_type_cache.key?(package_info['name'])
+          return @package_type_cache[package_info['name']]
+        end
+        
+        type = PACKAGE_TYPE_NPM
+        
+        # 检查Unity特定字段
+        if package_info['name']&.include?('.') || package_info['unity'] || package_info['displayName']
+          type = PACKAGE_TYPE_UNITY
+        end
+        
+        # 缓存结果
+        @package_type_cache[package_info['name']] = type
+        type
+      end
+
+      # 转换包信息为返回格式
+      def format_packages_response(packages)
+        packages_array = packages.is_a?(Hash) ? packages.values : packages
+        
+        objects = packages_array.map do |package|
+          {
+            'package' => {
+              'name' => package['name'],
+              'scope' => package_scope(package['name']),
+              'version' => package['version'] || package['dist-tags']&.[]('latest') || '1.0.0',
+              'description' => package['description'] || '',
+              'keywords' => package['keywords'] || [],
+              'date' => Time.now.iso8601,
+              'links' => {},
+              'author' => package['author'] || { 'name' => 'Unknown' },
+              'publisher' => package['author'] || { 'name' => 'Unknown' },
+              'maintainers' => package['maintainers'] || [{ 'name' => 'Unknown' }]
+            },
+            'score' => {
+              'final' => 1.0,
+              'detail' => {
+                'quality' => 1.0,
+                'popularity' => 1.0,
+                'maintenance' => 1.0
+              }
+            },
+            'searchScore' => 1.0
+          }
+        end
+        
+        {
+          'objects' => objects,
+          'total' => objects.size,
+          'time' => Time.now.iso8601
+        }
+      end
+      
+      # 获取包的作用域
+      def package_scope(name)
+        return nil unless name
+        
+        # 检查Unity包格式
+        if name.include?('.')
+          parts = name.split('.')
+          if parts.size >= 2
+            return parts[0, parts.size - 1].join('.')
+          end
+        end
+        
+        # 检查NPM包格式
+        if name.start_with?('@')
+          return name.split('/').first
+        end
+        
+        nil
+      end
+
+      # 确保索引已更新
+      def is_index_updated?
+        @index_updated
+      end
+
+      # 创建示例包
+      def create_example_package
+        package_name = 'com.dreamstudio.example'
+        version = '1.0.0'
+        
+        # 确保示例包的目录结构存在
+        tarball_dir = File.join(@tarballs_dir, package_name)
+        FileUtils.mkdir_p(tarball_dir)
+        
+        # 创建示例包结构
+        {
+          'name' => package_name,
+          'displayName' => 'Dream Studio Example Package',
+          'version' => version,
+          'unity' => '2019.4',
+          'description' => '这是一个示例包，用于测试Unity包管理器功能',
+          'keywords' => ['example', 'test', 'unity'],
+          'category' => 'Libraries',
+          'author' => {
+            'name' => 'DreamStudio',
+            'email' => 'example@dreamstudio.com',
+            'url' => 'https://www.dreamstudio.com'
+          },
+          'maintainers' => [
+            {
+              'name' => 'DreamStudio',
+              'email' => 'example@dreamstudio.com'
+            }
+          ],
+          'dependencies' => {},
+          'repository' => {
+            'type' => 'git',
+            'url' => 'https://github.com/dreamstudio/example-package.git'
+          },
+          'license' => 'MIT',
+          'dist' => {
+            'tarball' => "http://127.0.0.1:7748/#{package_name}/-/#{package_name}-#{version}.tgz",
+            'type' => 'tgz'
+          }
+        }
+      end
+
+      # 提供缓存目录的访问方法
+      attr_reader :cache_dir
+    end
+  end
+end