easyai 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '04579f0d2347a0226227a5d1385fa7e80bfc6e5e0fbad684c45541a768352665'
-  data.tar.gz: df9f71c2a71f06cf3499b2920f4737cd97ebec66e7b2aab22a459f224836b80a
+  metadata.gz: 60e6aec7d6d0d2475a75e26f61f21f1f5354b75ba828006293cdcdd3a6961f8a
+  data.tar.gz: bd0c31dccfcb0918707972a72415382b6ca778015ae67932626e4ad40933b747
 SHA512:
-  metadata.gz: 7fb5b852906e9a6fbf3d4ff07fbb27e30eba6d3c5fdc917b40965405473163feb72c44115e07353fd50e374f8ac0e2f6cecca0fc1978bf54da5246bd48c39678
-  data.tar.gz: 3fec979042cf13ff735d66afbeac7180c873e9088c26c2e2c1eeb3ba6da48b570f264ff2441f7acfc1142fb21634c42caa1260088ca37ce697141d2d45d9156b
+  metadata.gz: 31725ddd0f5c1ce5e3acda536b8c502addefc67271abb0b719521349fd3f3d840f2c41151982fbaca3044d34e6e110ef5e663155ee5c71ff636a6eb5af6b749a
+  data.tar.gz: 3045e64aa95c96a0ca58934f080dc6e82512121348290db4b4d8859b0af016f343893a8208f281f6be33af75afd4e2160fbc04451adf8f89ff9d62a21b202719

data/CLAUDE.md

@@ -12,10 +12,17 @@ EasyAI 是一个 Ruby CLI 工具，作为 AI 命令行工具（Claude、Gemini
 
 代码库采用基于 CLAide 的模块化架构：
 
-- **主命令 (`lib/easyai.rb`)**：抽象基础命令，处理全局选项（`--setup`、`--config`）和配置管理
+- **应用入口 (`lib/easyai.rb`)**：`EasyAIApp` 类负责启动标志显示、版本检查和命令执行
+- **主命令 (`lib/easyai/command.rb`)**：抽象基础命令，处理全局选项和帮助信息
 - **AI 工具子命令 (`lib/easyai/command/*.rb`)**：每个 AI 工具（claude、gemini、gpt）都有自己的命令类，继承自主命令
 - **工具命令 (`lib/easyai/command/utils/`)**：实用工具集合，包括文件加密解密功能
-- **基础模块 (`lib/easyai/base/`)**：核心功能模块，如文件加密 (`file_crypto.rb`) 和系统钥匙串 (`system_keychain.rb`)
+- **认证模块 (`lib/easyai/auth/`)**：处理 AI 工具的认证配置，如 `authclaude.rb`
+- **配置管理 (`lib/easyai/config/`)**：管理配置文件的加载、保存和远程下载
+- **基础模块 (`lib/easyai/base/`)**：
+  - `file_crypto.rb`：文件加密解密核心实现
+  - `system_keychain.rb`：系统钥匙串访问
+  - `version_checker.rb`：版本检查和更新
+  - `update_notifier.rb`：更新通知显示
 - **环境隔离**：使用 Ruby 的 `exec()` 替换当前进程为目标 AI 工具，在注入环境变量的同时保持交互性
 - **跨平台支持**：处理 Unix（`which`）和 Windows（`where`）之间的命令检测差异
 
@@ -37,6 +44,10 @@ gem install easyai-x.x.x.gem # 安装特定版本
 # 测试加密解密功能
 EASYAI_TEST_PASSWORD=testdir123 easyai utils encry /tmp/test_dir
 EASYAI_TEST_PASSWORD=testdir123 easyai utils decry /tmp/test_dir_encrypted
+
+# 调试模式
+EASYAI_DEBUG=1 ruby bin/easyai claude  # 启用调试信息输出
+EASYAI_SKIP_FORCE_UPDATE=1 easyai claude  # 跳过版本更新检查
 ```
 
 ### 配置管理
@@ -48,6 +59,9 @@ easyai --setup
 easyai --config
 
 # 配置文件：~/.easyai/config.yml
+
+# 使用本地配置文件
+easyai claude ./config.json    # 加载指定的 JSON 配置文件
 ```
 
 ### 工具命令
@@ -89,14 +103,42 @@ easyai clean                                      # 清理临时文件和缓存
 - **密码管理**：支持交互式密码输入和环境变量密码（`EASYAI_TEST_PASSWORD`）
 - **错误处理**：完整的错误处理和用户友好提示
 
+### 认证优先级机制
+AI 工具的认证令牌获取优先级（`lib/easyai/auth/authclaude.rb`）：
+1. **远程配置**：首先尝试下载远程配置文件
+2. **本地配置**：如果指定了本地 JSON 配置文件，加载该文件
+3. **系统钥匙串**：从系统钥匙串获取（macOS Keychain）
+4. **环境变量**：从环境变量读取（如 `CLAUDE_CODE_OAUTH_TOKEN`）
+5. **交互输入**：最后提示用户输入并保存到配置文件
+
+### 版本更新机制
+项目包含智能版本管理系统 (`lib/easyai/base/version_checker.rb`)：
+- **启动检查**：在 `EasyAIApp#run` 中自动执行版本检查
+- **强制更新**：`check_force_update!` 方法会阻塞执行直到检查完成
+- **同步检查**：`check_sync` 方法复用已获取的版本信息
+- **更新通知**：`UpdateNotifier` 模块负责显示更新提示
+- **跳过机制**：
+  - 设置 `EASYAI_SKIP_FORCE_UPDATE=1` 环境变量跳过更新检查
+  - `--help`、`--version` 命令自动跳过更新检查
+- **更新命令**：`easyai update` 执行 `gem update easyai`
+
 ## 版本管理
 
 版本在 `lib/easyai/version.rb` 中定义，自动被以下文件引用：
-- `easyai.gemspec` 通过 `require_relative`
-- 发布脚本通过正则解析
-- 主命令通过 `self.version = VERSION`
+- `easyai.gemspec` 通过 `require_relative 'lib/easyai/version'`
+- `lib/easyai/command.rb` 通过 `self.version = VERSION`
+- `lib/easyai.rb` 在启动标志中使用 `VERSION`
+- 发布脚本 (`test_local.sh`, `release_remote.sh`) 通过正则提取版本号
 
-只需更新 `lib/easyai/version.rb` 中的版本 - 其他引用是自动的。
+只需更新 `lib/easyai/version.rb` 中的 `VERSION` 常量 - 其他引用是自动的。
+
+### 发布流程
+`release_remote.sh` 脚本完成以下步骤：
+1. 提交所有未提交的更改
+2. 合并到 master 分支
+3. 构建和安装 gem
+4. 创建并推送 Git 标签（格式：v版本号）
+5. 发布到 RubyGems
 
 ## 依赖管理
 
@@ -104,6 +146,7 @@ easyai clean                                      # 清理临时文件和缓存
 - **运行时依赖**：
   - `claide ~> 1.0`：CLI 框架
   - `colored2 ~> 3.1`：终端颜色输出
+  - `webrick ~> 1.9`：Web 服务器（用于版本检查，使用 1.9.1）
 - **开发依赖**：
   - `bundler ~> 2.0`：依赖管理
   - `rake ~> 13.0`：构建工具
@@ -117,6 +160,8 @@ easyai clean                                      # 清理临时文件和缓存
 3. **测试流程**：使用 `./test_local.sh` 进行本地测试，确保功能正常后再发布
 4. **跨平台兼容性**：添加新功能时要考虑 Windows、Linux、macOS 的兼容性
 5. **环境隔离**：确保不影响用户的系统环境变量，所有配置都应在子进程中生效
+6. **错误处理**：所有命令都应有完善的错误处理和用户友好的错误提示
+7. **调试信息**：使用 `ENV['EASYAI_DEBUG']` 控制调试信息输出
 
 ## 中文化要求
 
@@ -183,6 +228,22 @@ DESC
 
 ## 技术实现注意事项
 
+### 启动流程
+1. **入口点**：`bin/easyai` 调用 `EasyAI::EasyAIApp.new.run(ARGV)`
+2. **启动标志**：`EasyAIApp#show_banner` 显示版本信息（跳过 --help 和 --version）
+3. **版本检查**：`EasyAIApp#check_version_before_run` 执行更新检查
+   - 强制更新检查：`Base::VersionChecker.check_force_update!`
+   - 同步检查：`Base::VersionChecker.check_sync`
+   - 更新通知：`Base::UpdateNotifier.maybe_show_notification`
+4. **命令执行**：`EasyAI::Command.run(argv)` 处理实际命令
+
+### 输出格式规范
+各命令使用统一的输出格式（参考 `lib/easyai/command/claude.rb`）：
+- `print_status(icon_text, detail)`：状态信息，图标左对齐，详情用 cyan 色
+- `print_success(message)`：成功信息，绿色勾号
+- `print_warning(message)`：警告信息，黄色警告符
+- `print_error(message)`：错误信息，红色叉号
+
 ### CLAide 框架相关
 
 #### 1. --help 参数处理
@@ -233,6 +294,11 @@ end
 - 父类的 `validate!` 会处理 help 标志
 - 如果检测到 help 标志，会调用 `help!` 抛出异常，阻止 `run` 方法执行
 
+#### 4. 抽象命令设置
+使用 `abstract_command = true` 标记抽象命令：
+- `EasyAI::Command` 是抽象基类
+- `EasyAI::Command::Utils` 也是抽象命令，包含子命令 Encry 和 Decry
+
 ### 命令类继承结构
 ```
 CLAide::Command

data/easyai.gemspec

@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
   
   spec.add_dependency 'claide', '~> 1.0'
   spec.add_dependency 'colored2', '~> 3.1'
-  spec.add_dependency 'webrick', '~> 1.7'
+  spec.add_dependency 'webrick', '~> 1.9'
   
   spec.add_development_dependency 'bundler', '~> 2.0'
   spec.add_development_dependency 'rake', '~> 13.0'

data/lib/easyai/auth/jpslogin.rb

@@ -78,6 +78,16 @@ module EasyAI
 
       private
 
+      # 获取跨平台的 null 设备路径
+      def get_null_device
+        case RbConfig::CONFIG['host_os']
+        when /mswin|mingw|cygwin/
+          'NUL'
+        else
+          '/dev/null'
+        end
+      end
+
       # 完整的授权和登录流程
       def authorize_and_login
         # 构建授权 URL
@@ -150,7 +160,8 @@ module EasyAI
       def open_browser(url)
         case RbConfig::CONFIG['host_os']
         when /mswin|mingw|cygwin/
-          system("start", url)
+          # Windows: 使用双引号包围URL避免参数解析问题
+          system("start \"\" \"#{url}\"")
         when /darwin/
           system("open", url)
         when /linux|bsd/
@@ -175,14 +186,21 @@ module EasyAI
         begin
           server = WEBrick::HTTPServer.new(
             Port: @server_port,
-            Logger: WEBrick::Log.new("/dev/null"),
+            BindAddress: '127.0.0.1',
+            Logger: WEBrick::Log.new(get_null_device),
             AccessLog: []
           )
         rescue Errno::EADDRINUSE
           puts "✗ 端口 #{@server_port} 仍被占用，无法启动服务器"
           return nil
+        rescue Errno::ENOENT
+          puts "✗ 启动服务器失败: 系统找不到指定的路径或文件"
+          return nil
         rescue => e
           puts "✗ 启动服务器失败: #{e.message}"
+          if RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/
+            puts "  提示: 如果是Windows系统，请确保防火墙允许Ruby访问网络"
+          end
           return nil
         end
 

data/lib/easyai/base/system_keychain.rb

@@ -1,4 +1,5 @@
 require 'rbconfig'
+require 'fileutils'
 
 module EasyAI
   module Base
@@ -120,15 +121,30 @@ module EasyAI
         # 使用 cmdkey 命令存储密码
         target_name = "#{SERVICE_NAME}_#{ACCOUNT_NAME}"
         cmd = "cmdkey /add:#{target_name} /user:#{ACCOUNT_NAME} /pass:\"#{password}\""
-        
+
         success = system(cmd + " >nul 2>&1")
-        
+
+        # 同时保存到文件作为备用
+        keyring_dir = File.expand_path('~/.easyai/.keyring')
+        FileUtils.mkdir_p(keyring_dir) unless Dir.exist?(keyring_dir)
+
+        keyring_file = File.join(keyring_dir, 'windows_credential')
+
+        begin
+          require 'base64'
+          encoded_password = Base64.strict_encode64(password)
+          File.write(keyring_file, encoded_password)
+          File.chmod(0600, keyring_file) rescue nil # 尝试设置权限，Windows 可能不支持
+        rescue => e
+          # 忽略文件写入错误
+        end
+
         if success
           puts "✓ 密码已安全存储到 Windows 凭据管理器"
         else
           puts "⚠ 无法存储密码到 Windows 凭据管理器"
         end
-        
+
         success
       rescue => e
         puts "⚠ Windows 凭据存储出错: #{e.message}"
@@ -138,33 +154,29 @@ module EasyAI
       # Windows 凭据管理器密码获取
       def self.get_password_windows
         target_name = "#{SERVICE_NAME}_#{ACCOUNT_NAME}"
-        
+
         # 首先检查凭据是否存在
-        check_cmd = "cmdkey /list:#{target_name} >nul 2>&1"
-        return nil unless system(check_cmd)
-        
-        # 使用 PowerShell 获取密码（简化版本，兼容性更好）
-        ps_script = <<~PS
-          try {
-            $credential = Get-StoredCredential -Target "#{target_name}" -ErrorAction Stop
-            $ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($credential.Password)
-            $password = [Runtime.InteropServices.Marshal]::PtrToStringAuto($ptr)
-            [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr)
-            Write-Output $password
-          } catch {
-            # 如果 Get-StoredCredential 不可用，尝试使用原生方法
-            $output = & cmdkey /list:"#{target_name}" 2>$null
-            if ($output -match "User: #{ACCOUNT_NAME}") {
-              Write-Output "CREDENTIAL_EXISTS_BUT_CANNOT_RETRIEVE"
-            }
-          }
-        PS
-        
-        password = `powershell -Command "#{ps_script}" 2>nul`.chomp
-        
-        # 如果无法获取密码但凭据存在，返回特殊标识
-        return nil if password.empty? || password == "CREDENTIAL_EXISTS_BUT_CANNOT_RETRIEVE"
-        password
+        check_cmd = "cmdkey /list:#{target_name} 2>nul"
+        check_output = `#{check_cmd}`
+        return nil unless check_output.include?(target_name)
+
+        # 使用备用文件存储方式
+        # 因为 Windows 凭据管理器的密码获取需要特殊权限或 CredentialManager 模块
+        # 我们使用加密文件作为备用方案
+        keyring_file = File.expand_path('~/.easyai/.keyring/windows_credential')
+
+        if File.exist?(keyring_file)
+          begin
+            require 'base64'
+            encoded_password = File.read(keyring_file).chomp
+            Base64.strict_decode64(encoded_password)
+          rescue => e
+            nil
+          end
+        else
+          # 提示用户重新输入密码
+          nil
+        end
       rescue => e
         nil
       end
@@ -173,13 +185,19 @@ module EasyAI
       def self.delete_password_windows
         target_name = "#{SERVICE_NAME}_#{ACCOUNT_NAME}"
         cmd = "cmdkey /delete:#{target_name}"
-        
+
         success = system(cmd + " >nul 2>&1")
-        
+
+        # 同时删除备用文件
+        keyring_file = File.expand_path('~/.easyai/.keyring/windows_credential')
+        if File.exist?(keyring_file)
+          File.delete(keyring_file) rescue nil
+        end
+
         if success
           puts "✓ 已从 Windows 凭据管理器删除存储的密码"
         end
-        
+
         success
       rescue => e
         false

data/lib/easyai/version.rb

@@ -1,3 +1,3 @@
 module EasyAI
-  VERSION = '1.1.0'
+  VERSION = '1.1.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easyai
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Wade
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.9'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement