easyai 2.0.0 → 2.2.0

data/lib/easyai/config/local_config.rb

@@ -62,13 +62,27 @@ module EasyAI
         'deepseek' => 'DeepSeek',
         'glm' => 'GLM（Coding Plan）',
         'kimi' => 'Kimi',
-        'minimax' => 'MiniMax'
+        '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?
 
@@ -81,16 +95,31 @@ module EasyAI
 
       # 解析平台配置。选定平台后会 yield 平台名（如果给了 block），
       # 让上层（AIToolBase）负责打印 UI 提示，保持 LocalConfig 的输出最小化。
-      def resolve_platform(tool:, platform: nil, verbose: false)
+      # 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
-        if !platforms.is_a?(Hash) || platforms.empty?
+        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
 
-        available = platforms.keys
+        # 顺序层：extra 虚拟平台始终排在选择列表最前（如【ChatGPT Subscribe】恒为第一项）
+        available = extra.keys + (visible.keys - extra.keys)
         selected =
           if platform && !platform.empty?
             unless available.include?(platform)
@@ -107,8 +136,8 @@ module EasyAI
             interactive_select(tool, available)
           end
 
-        yield(platform_display_name(selected)) if block_given?
-        platforms[selected]
+        yield(platform_display_name(selected), selected) if block_given?
+        merged[selected]
       end
 
       def upsert_platform(tool, platform, data)

data/lib/easyai/version.rb

@@ -1,3 +1,3 @@
 module EasyAI
-  VERSION = '2.0.0'
+  VERSION = '2.2.0'
 end

data/lib/easyai.rb

@@ -3,7 +3,6 @@ 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/codex'
 require 'easyai/command/utils'
 require 'easyai/command/clean'

data//344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -0,0 +1,117 @@
+# EasyAI 使用说明
+
+一个命令，统一启动 **Claude / Codex** 等 AI 命令行工具。
+
+凭证、代理、多平台切换都放在一个本地配置文件里；启动时只把环境变量注入子进程，**不污染你的终端**。
+
+---
+
+## 1. 安装
+
+```bash
+gem install easyai          # 需要 Ruby >= 3.0
+```
+
+AI CLI 本身需自行安装（EasyAI 只负责帮你启动它们）：
+
+| 工具 | 安装命令 |
+|------|----------|
+| Claude | `npm install -g @anthropic-ai/claude-code` |
+| Codex  | 参考 OpenAI Codex 官方文档 |
+
+---
+
+## 2. 备份已有登录（建议先做）
+
+如果你**已经登录过** Claude Code 或 Codex，配置前先把登录态备份下来，方便日后换机恢复：
+
+```bash
+easyai backup claude        # 备份 Claude Code 登录信息
+easyai backup codex         # 备份 Codex（ChatGPT 订阅）登录信息
+```
+
+**分别备份哪些信息：**
+
+| 命令 | 来源 | 备份内容 |
+|------|------|----------|
+| `backup claude` | `~/.claude.json` | 账号/登录配置（**排除** `projects` 会话历史）；macOS 上额外读取钥匙串「Claude Code-credentials」里的 OAuth token |
+| `backup codex`  | `~/.codex/auth.json` + `config.toml` | ChatGPT 登录凭证（OAuth token）与全局配置（**排除** `[projects.*]` 本地授信段）|
+
+备份统一写入 `~/.easyai/backup/`（`.claude.json` / `.codex.json`，自动 `chmod 600`），
+**只保留凭证与必要配置，不含会话历史、项目授信等大数据**。没登录过可跳过这一步。
+
+> `backup codex` 仅在检测到 ChatGPT 官方登录（OAuth）时才备份；纯第三方 API Key 不在此列。
+
+---
+
+## 3. 首次配置
+
+```bash
+easyai setup
+```
+
+跟着交互提示走：选择工具 → 选择平台 → 填入 API Key 即可。
+
+> 输入 Key 时不回显是正常的，粘贴后直接回车。
+
+配置保存在 `~/.easyai/config.json`，文件权限自动设为私有（`600`）。
+
+---
+
+## 4. 启动使用
+
+```bash
+easyai claude                       # 配了多个平台时会让你选
+easyai claude --platform=kimi       # 直接指定平台
+easyai codex
+```
+
+启动前会打印当前生效的平台和环境变量（Key 已脱敏），确认无误即进入 AI CLI。
+
+传给 AI CLI 的参数照常写在后面，会原样透传：
+
+```bash
+easyai claude --help                # --help 会传给 claude
+```
+
+---
+
+## 5. 常用配置管理
+
+```bash
+easyai setup --list                 # 查看当前配置（Key 脱敏）
+easyai setup --add=kimi --tool=claude      # 追加/覆盖一个平台
+easyai setup --remove=kimi --tool=claude   # 删除一个平台
+easyai setup --edit                 # 用编辑器直接改配置
+easyai setup --reset                # 清空重来
+```
+
+---
+
+## 6. 其他命令
+
+```bash
+easyai clean                        # 清理 claude 缓存
+easyai clean all                    # 清理所有 AI CLI 缓存（不动你的配置）
+easyai clean all --dry-run          # 先预览要删什么
+
+easyai update                       # 升级 EasyAI 自身
+```
+
+---
+
+## 常见问题
+
+**Q：换一台电脑怎么迁移？**
+把整个 `~/.easyai/` 目录拷过去即可——`config.json` 是平台配置，`backup/` 是各 AI CLI 的登录态。
+（内含明文 Key 与登录凭证，注意别外传。）
+
+**Q：网络不通导致启动被版本检查卡住？**
+临时加环境变量跳过：`EASYAI_SKIP_FORCE_UPDATE=1 easyai claude`
+
+**Q：想看详细日志？**
+`easyai claude --verbose` 或 `EASYAI_DEBUG=1 easyai claude`
+
+---
+
+有问题随时反馈，祝使用愉快 🎉

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easyai
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Wade
@@ -114,18 +114,20 @@ files:
 - lib/easyai/base/file_crypto.rb
 - lib/easyai/base/secret_masker.rb
 - lib/easyai/base/system_info.rb
+- lib/easyai/base/toml_sections.rb
 - lib/easyai/base/update_notifier.rb
 - lib/easyai/base/version_checker.rb
 - lib/easyai/command.rb
 - lib/easyai/command/ai_tool_base.rb
 - lib/easyai/command/backup.rb
 - lib/easyai/command/backup/claude.rb
+- lib/easyai/command/backup/codex.rb
 - lib/easyai/command/claude.rb
 - lib/easyai/command/clean.rb
 - lib/easyai/command/codex.rb
-- lib/easyai/command/gemini.rb
 - lib/easyai/command/restore.rb
 - lib/easyai/command/restore/claude.rb
+- lib/easyai/command/restore/codex.rb
 - lib/easyai/command/setup.rb
 - lib/easyai/command/update.rb
 - lib/easyai/command/utils.rb
@@ -133,6 +135,7 @@ files:
 - lib/easyai/command/utils/encry.rb
 - lib/easyai/config/local_config.rb
 - lib/easyai/version.rb
+- 使用说明.md
 homepage: https://github.com/wade/easyai
 licenses:
 - MIT
@@ -151,7 +154,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.11
 specification_version: 4
 summary: Claude / Gemini / Codex 三家 AI CLI 的本地化统一入口
 test_files: []

data/lib/easyai/command/gemini.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'ai_tool_base'
-
-module EasyAI
-  class Command
-    class Gemini < AIToolBase
-      self.summary = '启动 Gemini 命令行（多平台支持）'
-      self.description = <<-DESC
-启动 Google Gemini CLI，从 ~/.easyai/config.json 读取平台配置，并将凭证 / 代理仅注入子进程。
-
-使用示例：
-
-    $ easyai gemini                       # 多平台时进入交互选择
-    $ easyai gemini --platform=google_official
-    $ easyai gemini ./adhoc.json          # 用一次性 JSON 覆盖（单平台扁平 schema）
-    $ easyai gemini -- --help             # 透传参数给 gemini CLI
-DESC
-
-      self.arguments = [
-        CLAide::Argument.new('CONFIG.json', false),
-        CLAide::Argument.new('ARGS', false, true)
-      ]
-
-      def tool_name
-        'gemini'
-      end
-
-      def exec_command
-        'gemini'
-      end
-
-      def install_hint
-        '未找到 gemini CLI。请安装：npm install -g @google/gemini-cli'
-      end
-    end
-  end
-end