easyai 1.2.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bff981d82a8e6f1993636f8cc70ea1737b0709ef9b43a475f04781da0a6a5c53
-  data.tar.gz: f965d82c23c91c6e9796eb8e14f460297b851dda5822f9d1d8537e5447564c3d
+  metadata.gz: 11409804e9d550fb82f6b2d4735c288383430a08f0c8d552c5402359e8eace69
+  data.tar.gz: 3d4afb321b908167b5023b6ea88b0f41d04f352c24dc05243ca439f4d6080ffe
 SHA512:
-  metadata.gz: d455373705c7a3a862f42d909b2808585df70d0fcb4821851caed028c685aaa5e84e083ffa3ccf2e2184dda1136269c4edc06e3368410d3813667579f900d1c6
-  data.tar.gz: c0de6189651a35d9c63c3626e4e3967ef4c0fb9b8e5969f047291f126672b4229cf9e181c08382217cdde04b4e506e4af970c5f025a341ed51864e6491a4e947
+  metadata.gz: f1e5f980648640cea13741fdf15abb62153295c61a21c4fee74ca37431cc81addbf09a507c51591db2cedac86ca057916aa205bd190cad56910f2e5e5e1a3ee0
+  data.tar.gz: a857e396b2f0a2db95369cff98b13ec72ebdd3f3396e4da471d8f0b8a44b6614688c6cccb22f1e2f0ac53dfaf9d257db605eb504c9248e6b1e1e8a997c0a946d

data/CLAUDE.md

@@ -6,27 +6,9 @@ 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`)**：`EasyAIApp` 类负责启动标志显示、版本检查和命令执行
-- **主命令 (`lib/easyai/command.rb`)**：抽象基础命令，处理全局选项和帮助信息
-- **AI 工具子命令 (`lib/easyai/command/*.rb`)**：每个 AI 工具（claude、gemini、gpt）都有自己的命令类，继承自主命令
-- **工具命令 (`lib/easyai/command/utils/`)**：实用工具集合，包括文件加密解密功能
-- **认证模块 (`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`）之间的命令检测差异
-
-## 关键命令
+## 常用命令
 
 ### 开发和测试
 ```bash
@@ -48,234 +30,108 @@ 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  # 跳过版本更新检查
+EASYAI_VERBOSE=1 easyai claude  # 启用详细输出模式
 ```
 
 ### 配置管理
 ```bash
-# 交互式设置 API 令牌
-easyai --setup
+# 交互式设置 API 令牌和初始化
+easyai setup                   # 一键配置初始化
+easyai --setup                 # 旧版设置命令
 
 # 显示配置文件位置
 easyai --config
 
-# 配置文件：~/.easyai/config.yml
+# 配置文件位置：~/.easyai/config.yml
 
 # 使用本地配置文件
 easyai claude ./config.json    # 加载指定的 JSON 配置文件
+
+# 导出配置信息
+easyai utils export            # 自动生成文件名（使用邮箱地址）
+easyai utils export --output=config.json  # 指定输出文件名
 ```
 
-### 工具命令
+### 清理功能
 ```bash
-# 文件加密解密
-easyai utils encry <文件/目录路径> [输出路径]    # 加密文件或目录
-easyai utils decry <文件/目录路径> [输出路径]    # 解密文件或目录
-
-# 清理功能
-easyai clean                                      # 清理临时文件和缓存
+easyai clean                   # 清理 Claude 配置缓存
+easyai clean all               # 清理所有配置（Claude、Gemini、GPT）
 ```
 
-## 核心实现细节
+## 架构设计
+
+代码库采用基于 CLAide 的模块化架构：
+
+- **应用入口 (`lib/easyai.rb`)**：`EasyAIApp` 类负责启动标志显示、版本检查和命令执行
+- **主命令 (`lib/easyai/command.rb`)**：抽象基础命令，处理全局选项和帮助信息
+- **AI 工具子命令 (`lib/easyai/command/*.rb`)**：每个 AI 工具（claude、gemini、gpt）都有自己的命令类，继承自主命令
+- **工具命令 (`lib/easyai/command/utils/`)**：实用工具集合，包括文件加密解密（encry/decry）和配置导出（export）功能
+- **设置命令 (`lib/easyai/command/setup.rb`)**：一键配置初始化命令
+- **认证模块 (`lib/easyai/auth/`)**：处理 AI 工具的认证配置
+  - `authclaude.rb`：Claude 认证管理
+  - `jpsloginhelper.rb`：JPS 客户端登录助手，提供统一的 JPS 认证接口
+- **配置管理 (`lib/easyai/config/`)**：管理配置文件的加载、保存和远程下载
+  - `config.rb`：传统配置管理
+  - `easyai_config.rb`：新一代配置仓库管理，支持自动下载、更新和解密远程配置
+- **基础模块 (`lib/easyai/base/`)**：
+  - `file_crypto.rb`：文件加密解密核心实现（AES-128-ECB）
+  - `system_keychain.rb`：系统钥匙串访问
+  - `version_checker.rb`：版本检查和更新
+  - `update_notifier.rb`：更新通知显示
+- **环境隔离**：使用 Ruby 的 `exec()` 替换当前进程为目标 AI 工具，在注入环境变量的同时保持交互性
 
 ### 环境变量注入
 每个子命令在调用 `exec()` 前合并环境变量：
 - Claude: `CLAUDE_CODE_OAUTH_TOKEN`
-- Gemini: `GOOGLE_API_KEY`, `GEMINI_API_KEY`  
+- 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 和其他信号
-- 保持与直接运行工具相同的用户体验
-
-### 文件加密系统
-基于 AES-128-ECB 的文件加密功能 (`lib/easyai/base/file_crypto.rb`)：
-- **单文件加密**：支持任意文件类型，输出 `.encrypted` 文件
-- **目录批量加密**：递归加密目录中所有文件，保持原有目录结构
-- **智能解密**：自动识别 `.encrypted` 文件并恢复原文件名
-- **密码管理**：支持交互式密码输入和环境变量密码（`EASYAI_TEST_PASSWORD`）
-- **错误处理**：完整的错误处理和用户友好提示
-
 ### 认证优先级机制
-AI 工具的认证令牌获取优先级（`lib/easyai/auth/authclaude.rb`）：
-1. **远程配置**：首先尝试下载远程配置文件
+AI 工具的认证令牌获取优先级：
+1. **远程配置**：首先尝试通过 `EasyAIConfig` 下载并解密远程配置文件
 2. **本地配置**：如果指定了本地 JSON 配置文件，加载该文件
 3. **系统钥匙串**：从系统钥匙串获取（macOS Keychain）
 4. **环境变量**：从环境变量读取（如 `CLAUDE_CODE_OAUTH_TOKEN`）
 5. **交互输入**：最后提示用户输入并保存到配置文件
 
+### 配置管理系统
+
+**EasyAIConfig** - 配置仓库管理：
+- 自动从 `https://gitee.com/goodtools/EasyAISetting.git` 下载和更新配置仓库
+- 智能分支选择：测试环境使用 dev 分支，生产环境使用 master 分支
+- 智能解密：对比文件时间戳，按需解密
+- 自动清理：使用后自动清理解密文件
+
+**ConfigManager** - 业务配置逻辑：
+- 支持多工具类型（claude、gemini、gpt）
+- 支持多认证平台（claude_auth、kimi_auth、deepseek_auth）
+- 智能平台选择和用户交互
+- 复杂加密配置的密码验证机制
+
 ### 版本更新机制
-项目包含智能版本管理系统 (`lib/easyai/base/version_checker.rb`)：
 - **启动检查**：在 `EasyAIApp#run` 中自动执行版本检查
 - **强制更新**：`check_force_update!` 方法会阻塞执行直到检查完成
-- **同步检查**：`check_sync` 方法复用已获取的版本信息
-- **更新通知**：`UpdateNotifier` 模块负责显示更新提示
-- **跳过机制**：
-  - 设置 `EASYAI_SKIP_FORCE_UPDATE=1` 环境变量跳过更新检查
-  - `--help`、`--version` 命令自动跳过更新检查
+- **跳过机制**：设置 `EASYAI_SKIP_FORCE_UPDATE=1` 环境变量或使用 `--help`、`--version` 命令时自动跳过
 - **更新命令**：`easyai update` 执行 `gem update easyai`
 
 ## 版本管理
 
-版本在 `lib/easyai/version.rb` 中定义，自动被以下文件引用：
-- `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` 中的 `VERSION` 常量 - 其他引用是自动的。
+版本在 `lib/easyai/version.rb` 中定义，只需更新 `VERSION` 常量即可。
 
 ### 发布流程
 `release_remote.sh` 脚本完成以下步骤：
-1. 提交所有未提交的更改
+1. 提交所有未提交的更改（提交信息：`res 版本号`）
 2. 合并到 master 分支
 3. 构建和安装 gem
 4. 创建并推送 Git 标签（格式：v版本号）
 5. 发布到 RubyGems
 
-## 依赖管理
-
-项目依赖在 `easyai.gemspec` 中定义：
-- **运行时依赖**：
-  - `claide ~> 1.0`：CLI 框架
-  - `colored2 ~> 3.1`：终端颜色输出
-  - `webrick ~> 1.9`：Web 服务器（用于版本检查，使用 1.9.1）
-- **开发依赖**：
-  - `bundler ~> 2.0`：依赖管理
-  - `rake ~> 13.0`：构建工具
-  - `rspec ~> 3.0`：测试框架
-- **Ruby 版本要求**：>= 2.7.0
-
-## 开发注意事项
-
-1. **使用中文**：所有代码注释、提交信息、文档和交流都应使用中文
-2. **用户界面中文化**：所有命令行帮助信息、提示信息、错误信息都必须使用中文
-3. **测试流程**：使用 `./test_local.sh` 进行本地测试，确保功能正常后再发布
-4. **跨平台兼容性**：添加新功能时要考虑 Windows、Linux、macOS 的兼容性
-5. **环境隔离**：确保不影响用户的系统环境变量，所有配置都应在子进程中生效
-6. **错误处理**：所有命令都应有完善的错误处理和用户友好的错误提示
-7. **调试信息**：使用 `ENV['EASYAI_DEBUG']` 控制调试信息输出
-
-## 中文化要求
-
-### 代码界面中文化
-- **命令描述**：所有 `self.summary` 和 `self.description` 必须使用中文
-- **选项说明**：`self.options` 中的描述文字必须为中文  
-- **错误信息**：`help!` 和错误提示必须使用中文
-- **交互提示**：用户输入提示（如 `print` 语句）必须使用中文
-- **状态信息**：运行时的状态输出必须使用中文
-
-### 文档中文化
-- **README.md**：必须完全使用中文编写，包括所有章节标题、描述文字、使用示例
-- **代码注释**：所有代码注释必须使用中文
-- **提交信息**：Git 提交信息必须使用中文描述
-- **变更日志**：如有 CHANGELOG 文件，必须使用中文记录
-- **API 文档**：如有生成的 API 文档，描述内容应为中文
-
-### 中文化检查清单
-在添加新功能或修改现有功能时，确保：
-- [ ] 所有用户可见的文本都是中文
-- [ ] README.md 的新内容使用中文
-- [ ] 新的错误信息使用中文
-- [ ] 代码注释使用中文
-- [ ] 提交信息使用中文
-
-## 命令帮助信息格式规范
-
-所有命令的 `--help` 输出必须遵循统一格式，参考 pindo 工具的风格：
-
-### 格式模板
-```ruby
-self.summary = '简短的命令描述'
-self.description = <<-DESC
-  命令的简要说明。
-  
-  主要功能:
-
-      * 功能点1
-
-      * 功能点2
-
-      * 功能点3
-
-  使用示例:
-
-      $ easyai command                     # 基本用法
+## CLAide 框架注意事项
 
-      $ easyai command --option            # 带选项用法
-
-      $ easyai command arg1 arg2           # 带参数用法
-
-      $ easyai command --opt=value         # 带值的选项
-DESC
-```
-
-### 格式要求
-1. **标题部分**：简洁明了的一句话说明
-2. **功能列表**：使用星号(*)列出主要功能，每个功能独占一行
-3. **示例部分**：使用美元符号($)开头，注释对齐以保持美观
-4. **缩进规则**：
-   - 主要段落顶格
-   - 功能和示例缩进4个空格
-   - 列表项之间空一行
-
-## 技术实现注意事项
-
-### 启动流程
-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 参数处理
-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! 调用时机
 **重要**：`argv.remainder!` 必须在调用 `super` 之后执行。
 
-错误示例：
-```ruby
-def initialize(argv)
-  @args = argv.remainder!  # ❌ 错误：会清空 argv，导致父类无法获取 --help
-  super
-end
-```
-
 正确示例：
 ```ruby
 def initialize(argv)
@@ -284,20 +140,7 @@ def initialize(argv)
 end
 ```
 
-原因说明：
-- `argv.remainder!` 会消耗并清空 argv 中的所有剩余参数
-- 如果在 `super` 之前调用，父类的 `initialize` 就无法获取 `--help` 等标志
-- 这会导致 `--help` 参数不能正确触发帮助信息，而是执行 `run` 方法
-
-#### 3. validate! 方法
-- 子命令的 `validate!` 中检查 CLI 工具是否可用
-- 父类的 `validate!` 会处理 help 标志
-- 如果检测到 help 标志，会调用 `help!` 抛出异常，阻止 `run` 方法执行
-
-#### 4. 抽象命令设置
-使用 `abstract_command = true` 标记抽象命令：
-- `EasyAI::Command` 是抽象基类
-- `EasyAI::Command::Utils` 也是抽象命令，包含子命令 Encry 和 Decry
+原因：`argv.remainder!` 会消耗并清空 argv 中的所有剩余参数，如果在 `super` 之前调用，父类就无法获取 `--help` 等标志。
 
 ### 命令类继承结构
 ```
@@ -308,15 +151,39 @@ CLAide::Command
         ├── GPT
         ├── Clean
         ├── Update
+        ├── Setup
         └── Utils (abstract_command = true)
               ├── Encry
-              └── Decry
+              ├── Decry
+              └── Export
 ```
 
-### 添加新命令的标准流程
+## 添加新命令的标准流程
+
 1. 创建命令文件 `lib/easyai/command/newcmd.rb`
 2. 继承自 `EasyAI::Command`
-3. 设置 `self.summary` 和 `self.description`（遵循格式规范）
+3. 设置 `self.summary` 和 `self.description`（使用中文）
 4. 实现 `initialize` 方法（注意 `super` 和 `argv.remainder!` 的顺序）
-5. 实现 `run` 方法
-6. 在 `lib/easyai.rb` 中 require 新命令文件
+5. 实现 `validate!` 方法（可选，用于验证参数）
+6. 实现 `run` 方法（主要逻辑）
+7. 在 `lib/easyai.rb` 中 require 新命令文件
+
+### 输出格式规范
+各命令使用统一的输出格式：
+- `print_status(icon_text, detail)`：状态信息，图标左对齐，详情用 cyan 色
+- `print_success(message)`：成功信息，绿色勾号
+- `print_warning(message)`：警告信息，黄色警告符
+- `print_error(message)`：错误信息，红色叉号
+
+## 中文化要求
+
+- **所有用户界面必须使用中文**：包括命令描述、选项说明、错误信息、交互提示、状态信息
+- **所有文档必须使用中文**：README.md、代码注释、提交信息、API 文档
+
+## JPS 认证集成
+
+项目集成了 JPS 客户端认证系统（`lib/easyai/auth/jpsloginhelper.rb`）：
+- **统一认证接口**：兼容原 JPSLogin 的接口，提供 `login()` 和 `get_username()` 方法
+- **配置文件管理**：通过 `EasyAIConfig` 自动获取 `jps_client_config.json` 配置文件路径
+- **自动配置下载**：如果配置文件不存在，会自动触发配置仓库的下载和解密
+- **用户名提取**：自动从认证令牌中提取用户名信息

data/easyai.gemspec

@@ -21,6 +21,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'claide', '~> 1.0'
   spec.add_dependency 'colored2', '~> 3.1'
   spec.add_dependency 'webrick', '~> 1.9'
+  spec.add_runtime_dependency 'jpsclient', '~> 1.0.0', '>= 1.0.0'
   
   spec.add_development_dependency 'bundler', '~> 2.0'
   spec.add_development_dependency 'rake', '~> 13.0'