easyai 1.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ee34c42f56cf088f27d3cc18a895d6117a855a9fdf309d37fc40c4486e50a417
+  data.tar.gz: e1b40e6f017f435dae47ab4f9a3eddf27350c9707afa1b885eb9523cf0880b8b
+SHA512:
+  metadata.gz: ff21c89a1df4b50e5d539083d65189439e45f9ad027588dacb8d160d90c83ec8bbbdffc0d0dd72b36a9f231a67711a3755ea37ecde0f8d0556960625a2cbff0d
+  data.tar.gz: efb410b066000120b690e1742bf67799912d7f1c3934447426fe71bf7756e5b794610818f77197f3d430371485e3b89170da3d84bbe95aacea07a172be1b8df6

data/CLAUDE.md

@@ -0,0 +1,107 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+**重要说明：此项目的所有回答和交流都应该使用中文。**
+
+## 项目概述
+
+EasyAI 是一个 Ruby CLI 工具，作为 AI 命令行工具（Claude、Gemini、GPT）的包装器。它提供环境隔离和配置管理功能，允许用户使用预配置的 API 令牌和代理设置运行 AI 工具，而不会影响系统环境变量。
+
+## 架构设计
+
+代码库采用基于 CLAide 的模块化架构：
+
+- **主命令 (`lib/easyai.rb`)**：抽象基础命令，处理全局选项（`--setup`、`--config`）和配置管理
+- **子命令 (`lib/easyai/*.rb`)**：每个 AI 工具（claude、gemini、gpt）都有自己的命令类，继承自主命令
+- **环境隔离**：使用 Ruby 的 `exec()` 替换当前进程为目标 AI 工具，在注入环境变量的同时保持交互性
+- **跨平台支持**：处理 Unix（`which`）和 Windows（`where`）之间的命令检测差异
+
+## 关键命令
+
+### 开发和测试
+```bash
+# 本地开发测试
+./test_local.sh              # 本地构建和安装 gem
+ruby bin/easyai --help       # 开发期间测试
+
+# 发布流程
+./release_remote.sh          # 完整发布：git 操作、gem 构建和发布到 RubyGems
+
+# 手动 gem 操作
+gem build easyai.gemspec     # 构建 gem 包
+gem install easyai-x.x.x.gem # 安装特定版本
+```
+
+### 配置管理
+```bash
+# 交互式设置 API 令牌
+easyai --setup
+
+# 显示配置文件位置
+easyai --config
+
+# 配置文件：~/.easyai/config.yml
+```
+
+## 核心实现细节
+
+### 环境变量注入
+每个子命令在调用 `exec()` 前合并环境变量：
+- Claude: `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN`
+- Gemini: `GOOGLE_API_KEY`, `GEMINI_API_KEY`  
+- OpenAI: `OPENAI_API_KEY`
+- 代理: `HTTP_PROXY`, `HTTPS_PROXY`, `http_proxy`, `https_proxy`
+
+### 命令验证
+每个子命令使用平台特定检测验证目标 CLI 工具是否已安装：
+- Unix/Linux/macOS: `which <command> > /dev/null 2>&1`
+- Windows: `where <command> >nul 2>&1`
+
+### 进程替换策略
+使用 `exec(env, command, *args)` 而非 `system()` 来：
+- 完全替换当前进程（无子进程）
+- 保留 stdin/stdout/stderr 用于交互式工具
+- 透明处理 Ctrl+C 和其他信号
+- 保持与直接运行工具相同的用户体验
+
+## 版本管理
+
+版本在 `lib/easyai/version.rb` 中定义，自动被以下文件引用：
+- `easyai.gemspec` 通过 `require_relative`
+- 发布脚本通过正则解析
+- 主命令通过 `self.version = VERSION`
+
+只需更新 `lib/easyai/version.rb` 中的版本 - 其他引用是自动的。
+
+## 开发注意事项
+
+1. **使用中文**：所有代码注释、提交信息、文档和交流都应使用中文
+2. **用户界面中文化**：所有命令行帮助信息、提示信息、错误信息都必须使用中文
+3. **测试流程**：使用 `./test_local.sh` 进行本地测试，确保功能正常后再发布
+4. **跨平台兼容性**：添加新功能时要考虑 Windows、Linux、macOS 的兼容性
+5. **环境隔离**：确保不影响用户的系统环境变量，所有配置都应在子进程中生效
+
+## 中文化要求
+
+### 代码界面中文化
+- **命令描述**：所有 `self.summary` 和 `self.description` 必须使用中文
+- **选项说明**：`self.options` 中的描述文字必须为中文  
+- **错误信息**：`help!` 和错误提示必须使用中文
+- **交互提示**：用户输入提示（如 `print` 语句）必须使用中文
+- **状态信息**：运行时的状态输出必须使用中文
+
+### 文档中文化
+- **README.md**：必须完全使用中文编写，包括所有章节标题、描述文字、使用示例
+- **代码注释**：所有代码注释必须使用中文
+- **提交信息**：Git 提交信息必须使用中文描述
+- **变更日志**：如有 CHANGELOG 文件，必须使用中文记录
+- **API 文档**：如有生成的 API 文档，描述内容应为中文
+
+### 中文化检查清单
+在添加新功能或修改现有功能时，确保：
+- [ ] 所有用户可见的文本都是中文
+- [ ] README.md 的新内容使用中文
+- [ ] 新的错误信息使用中文
+- [ ] 代码注释使用中文
+- [ ] 提交信息使用中文

data/README.md

@@ -0,0 +1,94 @@
+# EasyAI
+
+一个简化运行 AI 工具的 CLI 包装器，支持 Claude、Gemini 和 GPT，提供环境配置管理功能。
+
+## 安装
+
+```bash
+gem build easyai.gemspec
+gem install easyai-1.0.2.gem
+```
+
+## 设置
+
+首先配置你的 API 令牌：
+
+```bash
+easyai --setup
+```
+
+系统会提示你输入：
+- Claude API 令牌
+- Gemini API 令牌  
+- OpenAI API 令牌
+- HTTP 代理（可选）
+
+配置会保存到 `~/.easyai/config.yml`
+
+## 使用方法
+
+### Claude
+```bash
+# 交互模式
+easyai claude
+
+# 单次查询
+easyai claude --print "解释这段代码"
+
+# 继续对话
+easyai claude --continue
+
+# 选择模型
+easyai claude --model sonnet "分析性能"
+```
+
+### Gemini
+```bash
+# 交互模式
+easyai gemini
+
+# 调试模式
+easyai gemini --debug "优化这个函数"
+
+# YOLO 模式
+easyai gemini --yolo
+```
+
+### GPT
+```bash
+# 交互模式
+easyai gpt
+
+# 单次查询
+easyai gpt "写一个函数"
+```
+
+## 特性
+
+- ✅ 环境变量隔离（不影响系统环境）
+- ✅ HTTP/HTTPS 代理支持
+- ✅ 多 AI 工具支持
+- ✅ 基于 CLAide 的专业 CLI 结构
+- ✅ 完整的参数透传
+- ✅ 交互式配置设置
+- ✅ 跨平台支持（Windows、Linux、macOS）
+
+## 系统要求
+
+- Ruby >= 2.7.0
+- 已安装的 AI CLI 工具：
+  - Claude: `npm install -g @anthropic-ai/claude-code`
+  - Gemini: `npm install -g @google/gemini-cli`
+  - OpenAI: `pip install openai`
+
+## 开发
+
+### 本地测试
+```bash
+./test_local.sh              # 构建并本地安装 gem
+```
+
+### 发布
+```bash
+./release_remote.sh          # 完整发布流程
+```

data/bin/easyai

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+
+lib_path = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift(lib_path) unless $LOAD_PATH.include?(lib_path)
+
+require 'easyai'
+
+EasyAI::Command.run

data/easyai.gemspec

@@ -0,0 +1,27 @@
+require_relative 'lib/easyai/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'easyai'
+  spec.version       = EasyAI::VERSION
+  spec.authors       = ['Wade']
+  spec.email         = ['wade@example.com']
+  
+  spec.summary       = 'Easy AI CLI tool wrapper'
+  spec.description   = 'A CLI tool that simplifies running AI tools like Claude, Gemini, and GPT with environment configuration'
+  spec.homepage      = 'https://github.com/wade/easyai'
+  spec.license       = 'MIT'
+  
+  spec.required_ruby_version = '>= 2.7.0'
+  
+  spec.files         = Dir['lib/**/*', 'bin/*', '*.md', '*.gemspec']
+  spec.bindir        = 'bin'
+  spec.executables   = ['easyai']
+  spec.require_paths = ['lib']
+  
+  spec.add_dependency 'claide', '~> 1.0'
+  spec.add_dependency 'colored2', '~> 3.1'
+  
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/lib/easyai/claude.rb

@@ -0,0 +1,61 @@
+module EasyAI
+  class Claude < Command
+    self.command = 'claude'
+    self.summary = '使用配置的环境运行 Claude CLI'
+    self.description = <<-DESC
+      使用预配置的 API 令牌和代理设置运行 Claude CLI 工具。
+      所有参数都会传递给 claude 命令。
+    DESC
+    
+    def initialize(argv)
+      @claude_args = argv.remainder!
+      super
+    end
+    
+    def validate!
+      super
+      help! '未找到 Claude CLI。请安装：npm install -g @anthropic-ai/claude-code' unless claude_available?
+    end
+    
+    def run
+      config = load_config
+      
+      env = ENV.to_h.merge({
+        'ANTHROPIC_API_KEY' => config['claude_token'] || config['anthropic_api_key'],
+        'CLAUDE_CODE_OAUTH_TOKEN' => config['claude_token'] || config['anthropic_api_key']
+      })
+      
+      # Add proxy settings if configured
+      if config['http_proxy']
+        env['HTTP_PROXY'] = config['http_proxy']
+        env['HTTPS_PROXY'] = config['http_proxy']
+        env['http_proxy'] = config['http_proxy']
+        env['https_proxy'] = config['http_proxy']
+      end
+      
+      puts "正在运行: claude #{@claude_args.join(' ')}".blue if verbose?
+      exec(env, 'claude', *@claude_args)
+    end
+    
+    private
+    
+    def claude_available?
+      # 跨平台命令检测
+      if RUBY_PLATFORM =~ /mswin|mingw|cygwin/
+        system('where claude >nul 2>&1')
+      else
+        system('which claude > /dev/null 2>&1')
+      end
+    end
+    
+    def load_config
+      config_path = File.expand_path('~/.easyai/config.yml')
+      return {} unless File.exist?(config_path)
+      
+      YAML.load_file(config_path) || {}
+    rescue => e
+      puts "加载配置出错: #{e.message}".red
+      {}
+    end
+  end
+end

data/lib/easyai/gemini.rb

@@ -0,0 +1,61 @@
+module EasyAI
+  class Gemini < Command
+    self.command = 'gemini'
+    self.summary = '使用配置的环境运行 Gemini CLI'
+    self.description = <<-DESC
+      使用预配置的 API 令牌和代理设置运行 Gemini CLI 工具。
+      所有参数都会传递给 gemini 命令。
+    DESC
+    
+    def initialize(argv)
+      @gemini_args = argv.remainder!
+      super
+    end
+    
+    def validate!
+      super
+      help! '未找到 Gemini CLI。请安装：npm install -g @google/gemini-cli' unless gemini_available?
+    end
+    
+    def run
+      config = load_config
+      
+      env = ENV.to_h.merge({
+        'GOOGLE_API_KEY' => config['gemini_token'] || config['google_api_key'],
+        'GEMINI_API_KEY' => config['gemini_token'] || config['google_api_key']
+      })
+      
+      # Add proxy settings if configured
+      if config['http_proxy']
+        env['HTTP_PROXY'] = config['http_proxy']
+        env['HTTPS_PROXY'] = config['http_proxy']
+        env['http_proxy'] = config['http_proxy']
+        env['https_proxy'] = config['http_proxy']
+      end
+      
+      puts "正在运行: gemini #{@gemini_args.join(' ')}".blue if verbose?
+      exec(env, 'gemini', *@gemini_args)
+    end
+    
+    private
+    
+    def gemini_available?
+      # 跨平台命令检测
+      if RUBY_PLATFORM =~ /mswin|mingw|cygwin/
+        system('where gemini >nul 2>&1')
+      else
+        system('which gemini > /dev/null 2>&1')
+      end
+    end
+    
+    def load_config
+      config_path = File.expand_path('~/.easyai/config.yml')
+      return {} unless File.exist?(config_path)
+      
+      YAML.load_file(config_path) || {}
+    rescue => e
+      puts "加载配置出错: #{e.message}".red
+      {}
+    end
+  end
+end

data/lib/easyai/gpt.rb

@@ -0,0 +1,60 @@
+module EasyAI
+  class GPT < Command
+    self.command = 'gpt'
+    self.summary = '使用配置的环境运行 OpenAI CLI'
+    self.description = <<-DESC
+      使用预配置的 API 令牌和代理设置运行 OpenAI CLI 工具。
+      所有参数都会传递给 openai 命令。
+    DESC
+    
+    def initialize(argv)
+      @gpt_args = argv.remainder!
+      super
+    end
+    
+    def validate!
+      super
+      help! '未找到 OpenAI CLI。请安装：pip install openai' unless gpt_available?
+    end
+    
+    def run
+      config = load_config
+      
+      env = ENV.to_h.merge({
+        'OPENAI_API_KEY' => config['openai_token'] || config['openai_api_key']
+      })
+      
+      # Add proxy settings if configured
+      if config['http_proxy']
+        env['HTTP_PROXY'] = config['http_proxy']
+        env['HTTPS_PROXY'] = config['http_proxy']
+        env['http_proxy'] = config['http_proxy']
+        env['https_proxy'] = config['http_proxy']
+      end
+      
+      puts "正在运行: openai #{@gpt_args.join(' ')}".blue if verbose?
+      exec(env, 'openai', *@gpt_args)
+    end
+    
+    private
+    
+    def gpt_available?
+      # 跨平台命令检测
+      if RUBY_PLATFORM =~ /mswin|mingw|cygwin/
+        system('where openai >nul 2>&1')
+      else
+        system('which openai > /dev/null 2>&1')
+      end
+    end
+    
+    def load_config
+      config_path = File.expand_path('~/.easyai/config.yml')
+      return {} unless File.exist?(config_path)
+      
+      YAML.load_file(config_path) || {}
+    rescue => e
+      puts "加载配置出错: #{e.message}".red
+      {}
+    end
+  end
+end

data/lib/easyai/version.rb

@@ -0,0 +1,3 @@
+module EasyAI
+  VERSION = '1.0.2'
+end

data/lib/easyai.rb

@@ -0,0 +1,75 @@
+require 'claide'
+require 'yaml'
+require 'fileutils'
+require 'colored2'
+require 'easyai/version'
+
+module EasyAI
+  
+  class Command < CLAide::Command
+    self.abstract_command = true
+    self.command = 'easyai'
+    self.version = VERSION
+    self.description = '简化 AI 命令行工具的 CLI 包装器，支持 Claude、Gemini 和 GPT'
+    
+    def self.options
+      [
+        ['--config', '显示配置文件路径'],
+        ['--setup', '交互式设置配置']
+      ].concat(super)
+    end
+    
+    def initialize(argv)
+      @config_flag = argv.flag?('config')
+      @setup_flag = argv.flag?('setup')
+      super
+    end
+    
+    def run
+      if @config_flag
+        puts config_file_path
+        return
+      end
+      
+      if @setup_flag
+        setup_config
+        return
+      end
+      
+      super
+    end
+    
+    private
+    
+    def config_file_path
+      @config_file_path ||= File.expand_path('~/.easyai/config.yml')
+    end
+    
+    def setup_config
+      puts "正在设置 EasyAI 配置...".green
+      FileUtils.mkdir_p(File.dirname(config_file_path))
+      
+      config = {}
+      
+      print "Claude API 令牌 (ANTHROPIC_API_KEY): "
+      config['claude_token'] = STDIN.gets.chomp
+      
+      print "Gemini API 令牌 (GOOGLE_API_KEY): "
+      config['gemini_token'] = STDIN.gets.chomp
+      
+      print "OpenAI API 令牌 (OPENAI_API_KEY): "
+      config['openai_token'] = STDIN.gets.chomp
+      
+      print "HTTP 代理 (可选): "
+      proxy = STDIN.gets.chomp
+      config['http_proxy'] = proxy unless proxy.empty?
+      
+      File.write(config_file_path, config.to_yaml)
+      puts "配置已保存到 #{config_file_path}".green
+    end
+  end
+end
+
+require 'easyai/claude'
+require 'easyai/gemini'
+require 'easyai/gpt'

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: easyai
+version: !ruby/object:Gem::Version
+  version: 1.0.2
+platform: ruby
+authors:
+- Wade
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: claide
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: colored2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A CLI tool that simplifies running AI tools like Claude, Gemini, and
+  GPT with environment configuration
+email:
+- wade@example.com
+executables:
+- easyai
+extensions: []
+extra_rdoc_files: []
+files:
+- CLAUDE.md
+- README.md
+- bin/easyai
+- easyai.gemspec
+- lib/easyai.rb
+- lib/easyai/claude.rb
+- lib/easyai/gemini.rb
+- lib/easyai/gpt.rb
+- lib/easyai/version.rb
+homepage: https://github.com/wade/easyai
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Easy AI CLI tool wrapper
+test_files: []