easyai 1.0.2 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee34c42f56cf088f27d3cc18a895d6117a855a9fdf309d37fc40c4486e50a417
-  data.tar.gz: e1b40e6f017f435dae47ab4f9a3eddf27350c9707afa1b885eb9523cf0880b8b
+  metadata.gz: f7511936104d9115b56bf3ec36425dcdffeedc7cf1c600463901242a281b7505
+  data.tar.gz: 3f656f1f9da2e0a5ff242707865f960077f5b4b6937b4d5de1fd6db41df03f4f
 SHA512:
-  metadata.gz: ff21c89a1df4b50e5d539083d65189439e45f9ad027588dacb8d160d90c83ec8bbbdffc0d0dd72b36a9f231a67711a3755ea37ecde0f8d0556960625a2cbff0d
-  data.tar.gz: efb410b066000120b690e1742bf67799912d7f1c3934447426fe71bf7756e5b794610818f77197f3d430371485e3b89170da3d84bbe95aacea07a172be1b8df6
+  metadata.gz: 05d9c00dfa0732c8379441e29006722e4a9354b255ca6c1209f87b22b586052333fde54edab402406d19883b34f93a36567cf8dd8df4cd08e6b326dd8490323c
+  data.tar.gz: 9648b22cfbbee85132f78dd034d29ca5340af3051f7465bd95d150de942983148fffe4abf43b691cebe0a5cf5eadc8447e0908235825c2618c80107ff5d21881

data/CLAUDE.md

@@ -6,14 +6,16 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## 项目概述
 
-EasyAI 是一个 Ruby CLI 工具，作为 AI 命令行工具（Claude、Gemini、GPT）的包装器。它提供环境隔离和配置管理功能，允许用户使用预配置的 API 令牌和代理设置运行 AI 工具，而不会影响系统环境变量。
+EasyAI 是一个 Ruby CLI 工具，作为 AI 命令行工具（Claude、Gemini、GPT）的包装器。它提供环境隔离和配置管理功能，允许用户使用预配置的 API 令牌和代理设置运行 AI 工具，而不会影响系统环境变量。项目还包含实用工具集合，如文件加密解密功能。
 
 ## 架构设计
 
 代码库采用基于 CLAide 的模块化架构：
 
 - **主命令 (`lib/easyai.rb`)**：抽象基础命令，处理全局选项（`--setup`、`--config`）和配置管理
-- **子命令 (`lib/easyai/*.rb`)**：每个 AI 工具（claude、gemini、gpt）都有自己的命令类，继承自主命令
+- **AI 工具子命令 (`lib/easyai/command/*.rb`)**：每个 AI 工具（claude、gemini、gpt）都有自己的命令类，继承自主命令
+- **工具命令 (`lib/easyai/command/utils/`)**：实用工具集合，包括文件加密解密功能
+- **基础模块 (`lib/easyai/base/`)**：核心功能模块，如文件加密 (`file_crypto.rb`) 和系统钥匙串 (`system_keychain.rb`)
 - **环境隔离**：使用 Ruby 的 `exec()` 替换当前进程为目标 AI 工具，在注入环境变量的同时保持交互性
 - **跨平台支持**：处理 Unix（`which`）和 Windows（`where`）之间的命令检测差异
 
@@ -22,7 +24,7 @@ EasyAI 是一个 Ruby CLI 工具，作为 AI 命令行工具（Claude、Gemini
 ### 开发和测试
 ```bash
 # 本地开发测试
-./test_local.sh              # 本地构建和安装 gem
+./test_local.sh              # 本地构建和安装 gem（自动检测版本和项目名称）
 ruby bin/easyai --help       # 开发期间测试
 
 # 发布流程
@@ -31,6 +33,10 @@ ruby bin/easyai --help       # 开发期间测试
 # 手动 gem 操作
 gem build easyai.gemspec     # 构建 gem 包
 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
 ```
 
 ### 配置管理
@@ -44,11 +50,21 @@ easyai --config
 # 配置文件：~/.easyai/config.yml
 ```
 
+### 工具命令
+```bash
+# 文件加密解密
+easyai utils encry <文件/目录路径> [输出路径]    # 加密文件或目录
+easyai utils decry <文件/目录路径> [输出路径]    # 解密文件或目录
+
+# 清理功能
+easyai clean                                      # 清理临时文件和缓存
+```
+
 ## 核心实现细节
 
 ### 环境变量注入
 每个子命令在调用 `exec()` 前合并环境变量：
-- Claude: `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN`
+- Claude: `CLAUDE_CODE_OAUTH_TOKEN`
 - Gemini: `GOOGLE_API_KEY`, `GEMINI_API_KEY`  
 - OpenAI: `OPENAI_API_KEY`
 - 代理: `HTTP_PROXY`, `HTTPS_PROXY`, `http_proxy`, `https_proxy`
@@ -65,6 +81,14 @@ easyai --config
 - 透明处理 Ctrl+C 和其他信号
 - 保持与直接运行工具相同的用户体验
 
+### 文件加密系统
+基于 AES-128-ECB 的文件加密功能 (`lib/easyai/base/file_crypto.rb`)：
+- **单文件加密**：支持任意文件类型，输出 `.encrypted` 文件
+- **目录批量加密**：递归加密目录中所有文件，保持原有目录结构
+- **智能解密**：自动识别 `.encrypted` 文件并恢复原文件名
+- **密码管理**：支持交互式密码输入和环境变量密码（`EASYAI_TEST_PASSWORD`）
+- **错误处理**：完整的错误处理和用户友好提示
+
 ## 版本管理
 
 版本在 `lib/easyai/version.rb` 中定义，自动被以下文件引用：
@@ -74,6 +98,18 @@ easyai --config
 
 只需更新 `lib/easyai/version.rb` 中的版本 - 其他引用是自动的。
 
+## 依赖管理
+
+项目依赖在 `easyai.gemspec` 中定义：
+- **运行时依赖**：
+  - `claide ~> 1.0`：CLI 框架
+  - `colored2 ~> 3.1`：终端颜色输出
+- **开发依赖**：
+  - `bundler ~> 2.0`：依赖管理
+  - `rake ~> 13.0`：构建工具
+  - `rspec ~> 3.0`：测试框架
+- **Ruby 版本要求**：>= 2.7.0
+
 ## 开发注意事项
 
 1. **使用中文**：所有代码注释、提交信息、文档和交流都应使用中文
@@ -104,4 +140,117 @@ easyai --config
 - [ ] README.md 的新内容使用中文
 - [ ] 新的错误信息使用中文
 - [ ] 代码注释使用中文
-- [ ] 提交信息使用中文
+- [ ] 提交信息使用中文
+
+## 命令帮助信息格式规范
+
+所有命令的 `--help` 输出必须遵循统一格式，参考 pindo 工具的风格：
+
+### 格式模板
+```ruby
+self.summary = '简短的命令描述'
+self.description = <<-DESC
+  命令的简要说明。
+  
+  主要功能:
+
+      * 功能点1
+
+      * 功能点2
+
+      * 功能点3
+
+  使用示例:
+
+      $ easyai command                     # 基本用法
+
+      $ easyai command --option            # 带选项用法
+
+      $ easyai command arg1 arg2           # 带参数用法
+
+      $ easyai command --opt=value         # 带值的选项
+DESC
+```
+
+### 格式要求
+1. **标题部分**：简洁明了的一句话说明
+2. **功能列表**：使用星号(*)列出主要功能，每个功能独占一行
+3. **示例部分**：使用美元符号($)开头，注释对齐以保持美观
+4. **缩进规则**：
+   - 主要段落顶格
+   - 功能和示例缩进4个空格
+   - 列表项之间空一行
+
+## 技术实现注意事项
+
+### CLAide 框架相关
+
+#### 1. --help 参数处理
+CLAide 框架对 --help 的处理机制：
+- 父类 Command 的 `initialize` 方法会调用 `argv.flag?('help')` 并设置 `@help_arg`
+- 子命令不应重复调用 `argv.flag?('help')`，而应使用父类的 `@help_arg` 属性
+
+正确的实现方式：
+```ruby
+def initialize(argv)
+  super
+  # 使用父类已经设置的 help_arg
+  @args_help_flag = @help_arg
+end
+
+def validate!
+  super
+  help! if args_help_flag?
+end
+```
+
+#### 2. argv.remainder! 调用时机
+**重要**：`argv.remainder!` 必须在调用 `super` 之后执行。
+
+错误示例：
+```ruby
+def initialize(argv)
+  @args = argv.remainder!  # ❌ 错误：会清空 argv，导致父类无法获取 --help
+  super
+end
+```
+
+正确示例：
+```ruby
+def initialize(argv)
+  super
+  @args = @argv.remainder!  # ✅ 正确：super 之后调用，使用 @argv
+end
+```
+
+原因说明：
+- `argv.remainder!` 会消耗并清空 argv 中的所有剩余参数
+- 如果在 `super` 之前调用，父类的 `initialize` 就无法获取 `--help` 等标志
+- 这会导致 `--help` 参数不能正确触发帮助信息，而是执行 `run` 方法
+
+#### 3. validate! 方法
+- 子命令的 `validate!` 中检查 CLI 工具是否可用
+- 父类的 `validate!` 会处理 help 标志
+- 如果检测到 help 标志，会调用 `help!` 抛出异常，阻止 `run` 方法执行
+
+### 命令类继承结构
+```
+CLAide::Command
+  └── EasyAI::Command (abstract_command = true)
+        ├── Claude
+        ├── Gemini
+        ├── GPT
+        ├── Clean
+        ├── Update
+        └── Utils (abstract_command = true)
+              ├── Encry
+              └── Decry
+```
+
+### 添加新命令的标准流程
+1. 创建命令文件 `lib/easyai/command/newcmd.rb`
+2. 继承自 `EasyAI::Command`
+3. 设置 `self.summary` 和 `self.description`（遵循格式规范）
+4. 实现 `initialize` 方法（注意 `super` 和 `argv.remainder!` 的顺序）
+5. 实现 `run` 方法
+6. 在 `lib/easyai.rb` 中 require 新命令文件

data/README.md

@@ -1,94 +1,75 @@
 # EasyAI
 
-一个简化运行 AI 工具的 CLI 包装器，支持 Claude、Gemini 和 GPT，提供环境配置管理功能。
+简化 AI 命令行工具使用的 Ruby 包装器，支持 Claude、Gemini 和 OpenAI。
 
 ## 安装
 
 ```bash
-gem build easyai.gemspec
-gem install easyai-1.0.2.gem
+gem install easyai
 ```
 
-## 设置
-
-首先配置你的 API 令牌：
-
+或从源码安装：
 ```bash
-easyai --setup
+gem build easyai.gemspec
+gem install easyai-*.gem
 ```
 
-系统会提示你输入：
-- Claude API 令牌
-- Gemini API 令牌  
-- OpenAI API 令牌
-- HTTP 代理（可选）
-
-配置会保存到 `~/.easyai/config.yml`
-
-## 使用方法
+## 快速开始
 
 ### Claude
 ```bash
-# 交互模式
-easyai claude
-
-# 单次查询
-easyai claude --print "解释这段代码"
-
-# 继续对话
-easyai claude --continue
-
-# 选择模型
-easyai claude --model sonnet "分析性能"
+easyai claude                    # 启动 Claude CLI
+easyai claude ./config.json      # 使用本地配置文件
 ```
 
 ### Gemini
 ```bash
-# 交互模式
-easyai gemini
-
-# 调试模式
-easyai gemini --debug "优化这个函数"
-
-# YOLO 模式
-easyai gemini --yolo
+easyai gemini                    # 启动 Gemini CLI
+easyai gemini chat               # 开始聊天会话
 ```
 
-### GPT
+### OpenAI GPT
 ```bash
-# 交互模式
-easyai gpt
-
-# 单次查询
-easyai gpt "写一个函数"
+easyai gpt                       # 启动 OpenAI CLI
+easyai gpt api chat.completions  # 调用 API
 ```
 
-## 特性
+## 实用工具
+
+### 文件加密解密
+```bash
+easyai utils encry file.txt     # 加密文件
+easyai utils decry file.encrypted # 解密文件
+```
 
-- ✅ 环境变量隔离（不影响系统环境）
-- ✅ HTTP/HTTPS 代理支持
-- ✅ 多 AI 工具支持
-- ✅ 基于 CLAide 的专业 CLI 结构
-- ✅ 完整的参数透传
-- ✅ 交互式配置设置
-- ✅ 跨平台支持（Windows、Linux、macOS）
+### 配置清理
+```bash
+easyai clean                     # 清理 Claude 配置
+easyai clean all                 # 清理所有配置
+```
 
 ## 系统要求
 
 - Ruby >= 2.7.0
-- 已安装的 AI CLI 工具：
+- 对应的 AI CLI 工具：
   - Claude: `npm install -g @anthropic-ai/claude-code`
   - Gemini: `npm install -g @google/gemini-cli`
   - OpenAI: `pip install openai`
 
+## 特性
+
+- 🔐 环境隔离，不影响系统配置
+- 🌐 支持远程配置自动下载
+- 🔄 透传所有参数到原生 CLI
+- 🛠 包含实用工具集
+
 ## 开发
 
-### 本地测试
 ```bash
-./test_local.sh              # 构建并本地安装 gem
+./test_local.sh      # 本地测试
+./release_remote.sh  # 发布到 RubyGems
 ```
 
-### 发布
-```bash
-./release_remote.sh          # 完整发布流程
-```
+## License
+
+MIT

data/bin/easyai

@@ -1,10 +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)
+# 设置lib路径
+lib = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 require 'easyai'
 
-EasyAI::Command.run
+# 创建并运行 EasyAI 应用
+EasyAI::EasyAIApp.new.run(ARGV)

data/easyai.gemspec

@@ -20,6 +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_development_dependency 'bundler', '~> 2.0'
   spec.add_development_dependency 'rake', '~> 13.0'