easyai 1.7.0 → 2.1.0

data/lib/easyai/command/update.rb

@@ -1,210 +1,61 @@
-require 'fileutils'
-require 'tmpdir'
+# frozen_string_literal: true
+
 require 'colored2'
+require_relative '../command'
 
 module EasyAI
   class Command
+    # 通过 RubyGems 自更新 EasyAI 自身。
+    #
+    # 设计要点（详见 docs/设计文档.md §2.7）：
+    #   - 用 system('gem', 'update', 'easyai') 触发 RubyGems 自更新
+    #   - 不用 exec，便于子进程结束后继续打印中文提示
+    #   - 启动时 EasyAIApp 识别到子命令为 update 会跳过强制版本阻塞，避免死循环
     class Update < Command
-      self.summary = '从代码仓库安装最新开发版本（仅用于测试）'
+      self.summary = '通过 RubyGems 更新 EasyAI 到最新发布版本'
       self.description = <<-DESC
-        从 Gitee 代码仓库下载并安装最新的开发版本。
-        
-        主要功能:
-
-            * 从远程仓库拉取最新代码
-
-            * 自动构建 gem 包
-
-            * 安装到本地系统
-
-        使用示例:
+通过 `gem update easyai` 将 EasyAI 升级到 RubyGems 上的最新版本，
+等价于手动执行该命令，但用 system 而非 exec，子进程结束后会打印中文成功 / 失败提示。
 
-            $ easyai update                      # 安装 master 分支
+如果当前与 RubyGems 网络不通导致启动时被强制版本检查阻塞，可临时跳过：
 
-            $ easyai update --branch=dev         # 安装指定分支
+    $ EASYAI_SKIP_FORCE_UPDATE=1 easyai <子命令>
 
-            $ easyai update --keep-source        # 保留源代码
+使用示例：
 
-            $ easyai update --verbose            # 显示详细输出
-      DESC
+    $ easyai update              # 静默模式，仅打印必要提示
+    $ easyai update --verbose    # 显示 gem 命令的完整输出
+DESC
 
       def self.options
         [
-          ['--branch=BRANCH', '指定要安装的分支（默认: master）'],
-          ['--keep-source', '保留下载的源代码'],
-          ['--verbose', '显示详细输出']
+          ['--verbose', '显示 gem update 命令的完整输出']
         ].concat(super)
       end
 
-      def initialize(argv)
-        @branch = argv.option('branch') || 'master'
-        @keep_source = argv.flag?('keep-source')
-        @verbose = argv.flag?('verbose')
-        super
-      end
-
-      def validate!
-        super
-        help! '未找到 git 命令。请先安装 git。' unless git_available?
-      end
-
       def run
-        puts "\n╔#{'═' * 58}╗".cyan
-        puts "║#{'EasyAI 开发版本更新工具'.center(58)}║".cyan
-        puts "╚#{'═' * 58}╝\n".cyan
-        
-        puts "⚠️  注意：此命令仅用于测试开发版本".yellow
-        puts "📦 生产环境请使用: #{'gem update easyai'.green}\n\n"
-        
-        # 确认继续
-        unless confirm_update?
-          puts "❌ 更新已取消".red
-          return
-        end
-        
-        # 创建临时目录
-        temp_dir = Dir.mktmpdir('easyai-update-')
-        
-        begin
-          # 克隆仓库
-          clone_repository(temp_dir)
-          
-          # 执行安装脚本
-          install_from_source(temp_dir)
-          
-          # 显示成功信息
-          show_success_message
-          
-        rescue => e
-          puts "\n❌ 更新失败: #{e.message}".red
-          puts "   请检查网络连接或稍后重试".red
-          exit 1
-        ensure
-          # 清理临时文件
-          cleanup_temp_files(temp_dir) unless @keep_source
-        end
-      end
-
-      private
-
-      def git_available?
-        system('which git > /dev/null 2>&1')
-      end
-
-      def confirm_update?
-        print "确认从 Gitee 安装开发版本？[y/N]: ".yellow
-        begin
-          response = STDIN.gets
-          return false unless response
-          response = response.chomp.downcase
-          response == 'y' || response == 'yes'
-        rescue => e
-          puts "\n❌ 无法读取输入: #{e.message}".red
-          false
-        end
-      end
-
-      def clone_repository(temp_dir)
-        repo_url = 'https://gitee.com/goodtools/EasyAI.git'
-        clone_path = File.join(temp_dir, 'EasyAI')
-        
-        puts "📥 正在下载源代码...".cyan
-        puts "   仓库: #{repo_url}"
-        puts "   分支: #{@branch}"
-        
-        # 构建 git clone 命令
-        git_cmd = "git clone --depth 1 --branch #{@branch} #{repo_url} #{clone_path}"
-        git_cmd += " > /dev/null 2>&1" unless @verbose
-        
-        # 执行克隆
-        success = system(git_cmd)
-        
-        unless success
-          raise "无法克隆仓库。请检查网络连接和分支名称。"
-        end
-        
-        puts "   ✓ 源代码下载完成".green
-        
-        clone_path
-      end
-
-      def install_from_source(temp_dir)
-        source_dir = File.join(temp_dir, 'EasyAI')
-        
-        unless File.exist?(source_dir)
-          raise "源代码目录不存在: #{source_dir}"
-        end
-        
-        # 检查 test_local.sh 是否存在
-        install_script = File.join(source_dir, 'test_local.sh')
-        unless File.exist?(install_script)
-          raise "安装脚本不存在: test_local.sh"
-        end
-        
-        puts "\n🔧 正在构建并安装...".cyan
-        
-        # 切换到源代码目录并执行安装脚本
-        Dir.chdir(source_dir) do
-          # 确保脚本可执行
-          File.chmod(0755, 'test_local.sh')
-          
-          # 执行安装脚本
-          install_cmd = "./test_local.sh"
-          install_cmd += " > /dev/null 2>&1" unless @verbose
-          
-          success = system(install_cmd)
-          
-          unless success
-            raise "安装脚本执行失败"
-          end
-        end
-        
-        puts "   ✓ 安装完成".green
-      end
-
-      def cleanup_temp_files(temp_dir)
-        if @keep_source
-          puts "\n📁 源代码保留在: #{temp_dir}".cyan
-        else
-          puts "\n🧹 正在清理临时文件...".cyan
-          FileUtils.rm_rf(temp_dir)
-          puts "   ✓ 清理完成".green
-        end
-      end
-
-      def show_success_message
-        # 获取安装后的版本
-        installed_version = get_installed_version
-        
-        puts "\n" + "─" * 60
-        puts "✅ #{'开发版本安装成功！'.green}"
-        puts "─" * 60
-        
-        if installed_version
-          puts "📌 当前版本: #{installed_version}"
-        end
-        
-        puts "\n提示:".cyan
-        puts "  • 这是开发版本，可能包含未发布的功能"
-        puts "  • 如需回退到稳定版本: gem install easyai"
-        puts "  • 查看版本信息: easyai --version"
-        
-        if @branch != 'master'
-          puts "\n📝 已安装分支: #{@branch}".yellow
-        end
-      end
-
-      def get_installed_version
-        # 尝试获取已安装的版本
-        output = `easyai --version 2>&1`
-        if output =~ /EasyAI 版本:\s*(\S+)/
-          $1
+        puts "开始更新 EasyAI...".cyan
+        puts "正在执行：gem update easyai".cyan
+
+        ok = if @verbose
+               system('gem', 'update', 'easyai')
+             else
+               system('gem', 'update', 'easyai', out: File::NULL, err: File::NULL)
+             end
+
+        if ok
+          puts "✓ 更新完成".green
+          puts "请重新打开终端，然后运行 `easyai --version` 查看新版本".cyan
         else
-          nil
+          puts "✗ 更新失败".red
+          puts "请尝试以下排查方式：".yellow
+          puts "  • 检查网络连接是否能访问 https://rubygems.org"
+          puts "  • 确认 RubyGems 源可用：gem sources -l"
+          puts "  • 权限不足时尝试：sudo gem update easyai"
+          puts "  • 重新执行并加 --verbose 查看详细输出"
+          exit($?.respond_to?(:exitstatus) && $?.exitstatus ? $?.exitstatus : 1)
         end
-      rescue
-        nil
       end
     end
   end
-end
+end

data/lib/easyai/command/utils.rb

@@ -4,22 +4,18 @@ module EasyAI
       self.summary = '实用工具集合'
       self.description = <<-DESC
         提供各种实用工具。
-        
+
         可用命令:
 
             * encry - 文件加密工具
 
             * decry - 文件解密工具
 
-            * export - 导出 AI 配置信息
-
         使用示例:
 
             $ easyai utils encry file.txt       # 加密文件
 
             $ easyai utils decry file.encrypted # 解密文件
-
-            $ easyai utils export                # 导出配置
       DESC
       
       self.abstract_command = true
@@ -33,5 +29,4 @@ end
 
 # 加载子命令
 require_relative 'utils/encry'
-require_relative 'utils/decry'
-require_relative 'utils/export'
+require_relative 'utils/decry'

data/lib/easyai/command.rb

@@ -1,8 +1,6 @@
 require 'claide'
-require 'yaml'
 require 'fileutils'
 require 'colored2'
-require_relative 'base/system_keychain'
 require_relative 'base/version_checker'
 
 module EasyAI
@@ -11,7 +9,7 @@ module EasyAI
     self.abstract_command = true  
     self.command = 'easyai'
     self.version = VERSION
-    self.description = '简化 AI 命令行工具的 CLI 包装器，支持 Claude、Gemini 和 GPT'
+    self.description = '简化 AI 命令行工具的 CLI 包装器，支持 Claude、Gemini 和 Codex'
     self.plugin_prefixes = %w(easyai)
 
     # 定义帮助标志访问器（类似 pindo）

data/lib/easyai/config/local_config.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'fileutils'
+
+module EasyAI
+  module Config
+    # 本地配置门面：~/.easyai/config.json 的唯一读写入口
+    module LocalConfig
+      SCHEMA_VERSION = '2.0.0'
+
+      class Error < StandardError; end
+      class NotFoundError < Error; end
+      class ParseError < Error; end
+      class IncompatibleVersionError < Error; end
+      class ToolNotConfiguredError < Error; end
+      class PlatformNotFoundError < Error; end
+
+      module_function
+
+      # 注意：必须每次动态 expand_path，避免常量在加载期 freeze 路径，
+      # 让 spec 中切换 ENV['HOME'] 后定位失败
+      def config_path
+        File.expand_path('~/.easyai/config.json')
+      end
+
+      def exists?
+        File.file?(config_path)
+      end
+
+      def load
+        path = config_path
+        raise NotFoundError, "未找到本地配置文件 #{path}，请运行 easyai setup" unless File.file?(path)
+
+        raw = File.read(path)
+        data = begin
+          JSON.parse(raw)
+        rescue JSON::ParserError => e
+          raise ParseError,
+                "配置解析失败 #{path}: #{e.message}；可运行 easyai setup --reset 重新生成"
+        end
+
+        version = data['version']
+        unless version == SCHEMA_VERSION
+          raise IncompatibleVersionError,
+                "配置版本 #{version.inspect} 不被支持，期望 #{SCHEMA_VERSION}"
+        end
+
+        data
+      end
+
+      def save(cfg)
+        path = config_path
+        FileUtils.mkdir_p(File.dirname(path))
+        File.write(path, JSON.pretty_generate(cfg))
+        File.chmod(0o600, path) unless Gem.win_platform?
+        path
+      end
+
+      PLATFORM_DISPLAY_NAMES = {
+        'claude_official' => 'Claude 官方',
+        'deepseek' => 'DeepSeek',
+        'glm' => 'GLM（Coding Plan）',
+        'kimi' => 'Kimi',
+        'longcat' => 'LongCat（美团）',
+        'minimax' => 'MiniMax',
+        'openai_official' => 'ChatGPT Subscribe'
+      }.freeze
+
+      def platform_display_name(key)
+        PLATFORM_DISPLAY_NAMES.fetch(key, key)
+      end
+
+      # 已屏蔽的平台：保留模板与 config 数据，仅暂不对外提供（setup 不列出、runtime 不可选）。
+      # codex/deepseek：新版 codex 移除了 wire_api="chat"，而 DeepSeek 暂无 Responses API
+      # （/responses 实测 404），接入即失败，故先屏蔽。待 DeepSeek 支持 Responses 或接入协议
+      # 转换代理后，从本表删除该项即可恢复（profile 模板与 KNOWN_PLATFORMS 条目均未删除）。
+      DISABLED_PLATFORMS = {
+        'codex' => %w[deepseek]
+      }.freeze
+
+      def disabled_platform?(tool, platform)
+        Array(DISABLED_PLATFORMS[tool]).include?(platform)
+      end
+
+      def available_platforms(tool)
+        return [] unless exists?
+
+        cfg = load
+        platforms = cfg.dig(tool, 'platforms')
+        platforms.is_a?(Hash) ? platforms.keys : []
+      rescue Error
+        []
+      end
+
+      # 解析平台配置。选定平台后会 yield 平台名（如果给了 block），
+      # 让上层（AIToolBase）负责打印 UI 提示，保持 LocalConfig 的输出最小化。
+      # extra：调用方注入的虚拟平台 { key => data }（如 codex 的 ChatGPT Subscribe），
+      # 与 config.json 中真实平台合并参与选择；选中虚拟平台时返回其 data。
+      def resolve_platform(tool:, platform: nil, verbose: false, extra: {})
+        cfg = load
+        tool_cfg = cfg[tool]
+        platforms = tool_cfg.is_a?(Hash) ? tool_cfg['platforms'] : nil
+        platforms = {} unless platforms.is_a?(Hash)
+        extra = {} unless extra.is_a?(Hash)
+
+        # 显式指定了已屏蔽平台：直接拒绝（extra 虚拟平台不受屏蔽影响）
+        if platform && !platform.empty? && disabled_platform?(tool, platform) && !extra.key?(platform)
+          raise PlatformNotFoundError, "工具 #{tool} 的平台 #{platform} 已被屏蔽（暂不可用）"
+        end
+
+        # 屏蔽清单中的真实平台不参与选择（保留 config 数据，仅隐藏）
+        visible = platforms.reject { |name, _| disabled_platform?(tool, name) }
+        # 数据层：extra（虚拟平台，如 ChatGPT Subscribe）覆盖同名真实平台，保留其 marker
+        merged = visible.merge(extra)
+        if merged.empty?
+          raise ToolNotConfiguredError,
+                "工具 #{tool} 未配置任何平台，请运行 easyai setup --tool=#{tool}"
+        end
+
+        # 顺序层：extra 虚拟平台始终排在选择列表最前（如【ChatGPT Subscribe】恒为第一项）
+        available = extra.keys + (visible.keys - extra.keys)
+        selected =
+          if platform && !platform.empty?
+            unless available.include?(platform)
+              raise PlatformNotFoundError,
+                    "工具 #{tool} 未配置平台 #{platform}（可用：#{available.join(', ')}）"
+            end
+
+            platform
+          elsif available.size == 1
+            only = available.first
+            puts "使用平台 #{platform_display_name(only)}" if verbose
+            only
+          else
+            interactive_select(tool, available)
+          end
+
+        yield(platform_display_name(selected), selected) if block_given?
+        merged[selected]
+      end
+
+      def upsert_platform(tool, platform, data)
+        cfg = exists? ? load : { 'version' => SCHEMA_VERSION }
+        cfg['version'] ||= SCHEMA_VERSION
+        cfg[tool] ||= { 'platforms' => {} }
+        cfg[tool]['platforms'] ||= {}
+        cfg[tool]['platforms'][platform] = data
+        save(cfg)
+        cfg
+      end
+
+      def delete_platform(tool, platform)
+        return unless exists?
+
+        cfg = load
+        platforms = cfg.dig(tool, 'platforms')
+        return cfg unless platforms.is_a?(Hash) && platforms.key?(platform)
+
+        platforms.delete(platform)
+        cfg.delete(tool) if platforms.empty?
+        save(cfg)
+        cfg
+      end
+
+      # ----- private helpers -----
+
+      def interactive_select(tool, available)
+        puts "请选择平台（工具：#{tool}）："
+        available.each_with_index do |name, idx|
+          puts "  #{idx + 1}) #{platform_display_name(name)}"
+        end
+        print '请输入序号 (q 取消): '
+        input = $stdin.gets
+        raise Interrupt, '用户取消平台选择' if input.nil?
+
+        input = input.chomp.strip
+        raise Interrupt, '用户取消平台选择' if input.empty? || input.casecmp('q').zero?
+
+        idx = Integer(input, 10) rescue nil
+        if idx.nil? || idx < 1 || idx > available.size
+          raise Interrupt, "非法输入：#{input}"
+        end
+
+        available[idx - 1]
+      end
+      private_class_method :interactive_select
+    end
+  end
+end

data/lib/easyai/version.rb

@@ -1,3 +1,3 @@
 module EasyAI
-  VERSION = '1.7.0'
+  VERSION = '2.1.0'
 end

data/lib/easyai.rb

@@ -1,14 +1,15 @@
 require 'easyai/version'
-require 'easyai/config/config'
-require 'easyai/config/easyai_config'
+require 'easyai/config/local_config'
 require 'easyai/command'
+require 'easyai/command/ai_tool_base'
 require 'easyai/command/claude'
-require 'easyai/command/gemini'
-require 'easyai/command/gpt'
+require 'easyai/command/codex'
 require 'easyai/command/utils'
 require 'easyai/command/clean'
 require 'easyai/command/update'
 require 'easyai/command/setup'
+require 'easyai/command/backup'
+require 'easyai/command/restore'
 require 'easyai/base/version_checker'
 require 'easyai/base/update_notifier'
 require 'easyai/base/system_info'
@@ -30,14 +31,8 @@ module EasyAI
       # 在运行命令前进行版本检查
       check_version_before_run(argv)
 
-      # 设置退出时清理
-      setup_cleanup_handler
-
       # 运行命令
       EasyAI::Command.run(argv)
-    ensure
-      # 确保清理临时文件
-      cleanup_temp_files
     end
     
     private
@@ -64,21 +59,38 @@ module EasyAI
       require 'claide'
       require 'colored2'
       coerced_argv = CLAide::ARGV.coerce(argv)
-      
+
+      # 识别第一个非选项位置参数（子命令名）
+      # 注意：CLAide::ARGV#arguments 返回剩余的位置参数列表
+      first_subcommand = coerced_argv.arguments.first
+
       # 如果是以下情况，跳过版本检查：
       # 1. 请求帮助信息 (--help)
       # 2. 显示版本信息 (--version)
       # 3. 主动检查更新 (--check-update)
-      skip_check = coerced_argv.flag?('help') || 
-                   coerced_argv.flag?('version') || 
-                   coerced_argv.flag?('check-update')
-      
+      # 4. 紧急跳过开关 (EASYAI_SKIP_FORCE_UPDATE=1)
+      # 5. 子命令为 update —— 避免"过期必须更新 → update 命令本身被阻塞"死循环
+      skip_reason =
+        if coerced_argv.flag?('help')
+          '--help'
+        elsif coerced_argv.flag?('version')
+          '--version'
+        elsif coerced_argv.flag?('check-update')
+          '--check-update'
+        elsif ENV['EASYAI_SKIP_FORCE_UPDATE']
+          'EASYAI_SKIP_FORCE_UPDATE=1'
+        elsif first_subcommand == 'update'
+          '子命令为 update'
+        end
+
+      skip_check = !skip_reason.nil?
+
       if ENV['EASYAI_DEBUG']
         puts "📊 版本检查状态：".cyan
         puts "  • 当前版本: v#{EasyAI::VERSION}".green
-        puts "  • 跳过检查: #{skip_check ? '是（--help/--version）'.yellow : '否'.cyan}"
+        puts "  • 跳过检查: #{skip_check ? "是（#{skip_reason}）".yellow : '否'.cyan}"
       end
-      
+
       return if skip_check
       
       # 强制更新检查（会阻塞执行）
@@ -97,24 +109,5 @@ module EasyAI
       puts e.backtrace.join("\n") if ENV['EASYAI_DEBUG']
     end
 
-    # 设置清理处理器
-    def setup_cleanup_handler
-      # 注册信号处理器，确保 Ctrl+C 等信号时也能清理
-      %w[INT TERM].each do |signal|
-        Signal.trap(signal) do
-          cleanup_temp_files
-          exit(130) # 标准的 Ctrl+C 退出码
-        end
-      end
-    end
-
-    # 清理临时文件
-    def cleanup_temp_files
-      verbose = ENV['EASYAI_DEBUG'] || ENV['EASYAI_VERBOSE']
-      EasyAIConfig.cleanup(verbose)
-    rescue => e
-      # 清理失败不影响退出
-      puts "⚠️ 清理临时文件失败: #{e.message}" if ENV['EASYAI_DEBUG']
-    end
   end
 end