easyai 2.0.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0e9e5abc64041d1ca3e0a9fb59a81aa3dcdd16edfdfa716069fa17a71df1f4b
-  data.tar.gz: b729e5453a287e1e7fb6908fba42bd4516e48800eafff811d4b0fea80bb83653
+  metadata.gz: 1913c617c3cd8a792e90964f704dd92c2ca3795925aa4826065e9235ba6c732a
+  data.tar.gz: db3b5e247223d08364d4788b499e43cfb838866c22de215c97a3c44a864ba60f
 SHA512:
-  metadata.gz: f5fa95bca000bf57323f11026e5392b90fa71d22f606e77ddf49e87420afe1b128ef8313e3c51e6940bec15a177df3bc1ba7b81de532613c23cd394556a1c2f4
-  data.tar.gz: a4b24f06ec5dfa6ea7ed8a7476619eb580f4b606151e22a0921ad7a6760775e8ee5202e7832d7bfca2a8c470664e57daa0be0ac1944ca55d3b82e502a0c779de
+  metadata.gz: 30f3c3c3dbc3fbbc916893737ba9ee15b922679c2cab0b36ac377d5527a576e355712fc4c5e1a00981c1d04a4af970cd483dc11c13ae2960c574343d3b9d6bf7
+  data.tar.gz: 98c6112929ddf724f2dc1e6642d9b5055968f7ff05d6b987b6dd6cc60ae6b02ef9c636ba4c90640f232122e47ef1e391ac1c0be0245b828caf4ccdce5547c4be

data/CLAUDE.md

@@ -272,3 +272,13 @@ CLAide::Command
   - 输入用 `IO#noecho` 不回显
   - `--list` 输出做"前 4 + 后 4 + 长度"脱敏
 - 不得把 `~/.easyai/config.json` 上传到代码仓库或日志服务
+
+## Ruby Rules
+
+编写 Ruby 代码时参考以下规范：
+- 通用编码风格：`.claude/rules/ecc/common/coding-style.md`
+- Ruby 专项规范：`.claude/rules/ecc/ruby/` 目录（coding-style / testing / security / patterns / hooks）
+
+## 提交规范
+
+提交代码时参考 `.claude/rules/git-flow/git-flow.md` 中的规范。

data/lib/easyai/base/toml_sections.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module EasyAI
+  module Base
+    # 极简 TOML "段" 处理工具：只按 table 头切块，不解析具体值。
+    #
+    # 适用范围：codex ~/.codex/config.toml 这类结构简单的文件
+    # （顶层 key/value + 若干 [table] / [a.b] 段，无多行数组 / 复杂内联表）。
+    #
+    # 提供能力：
+    #   - split_sections  把文本切成有序的段（每段含 header + 原始行）
+    #   - reject_projects 过滤掉所有 [projects.*] 段，返回新文本
+    #   - merge           段级合并：override 覆盖 base 同名段，base 独有段保留
+    module TomlSections
+      module_function
+
+      PROJECT_HEADER_PREFIX = '[projects.'
+
+      Section = Struct.new(:header, :body, keyword_init: true)
+
+      # 判断一行是否是 table 头：去掉前导空白后以 '[' 开头（含 '[[' 数组表）
+      def header_line?(line)
+        line.lstrip.start_with?('[')
+      end
+
+      # 归一化 header（整行去空白），用于同名段比对
+      def header_key(line)
+        line.strip
+      end
+
+      def project_header?(header)
+        return false if header.nil?
+
+        header.start_with?(PROJECT_HEADER_PREFIX)
+      end
+
+      # 切段：返回 [Section, ...]。文件开头无 table 头的部分作为 header=nil 的前导段。
+      def split_sections(text)
+        sections = []
+        current = Section.new(header: nil, body: +'')
+
+        text.to_s.each_line do |line|
+          if header_line?(line)
+            sections << current unless empty_preamble?(current)
+            current = Section.new(header: header_key(line), body: +line.dup)
+          else
+            current.body << line
+          end
+        end
+        sections << current unless empty_preamble?(current)
+        sections
+      end
+
+      def reject_projects(text)
+        kept = split_sections(text).reject { |s| project_header?(s.header) }
+        render(kept)
+      end
+
+      # 段级合并，override 优先：
+      #   - override 出现的 header 覆盖 base 同名段
+      #   - base 独有 header（含 [projects.*]）保留，追加在 override 具名段之后
+      #   - 前导段（header=nil）：override 非空用 override，否则用 base
+      def merge(base_text, override_text)
+        base = split_sections(base_text)
+        override = split_sections(override_text)
+        override_keys = override.map(&:header).compact
+
+        result = []
+
+        over_pre = override.find { |s| s.header.nil? }
+        base_pre = base.find { |s| s.header.nil? }
+        preamble = over_pre && !over_pre.body.strip.empty? ? over_pre : base_pre
+        result << preamble if preamble
+
+        override.each { |s| result << s unless s.header.nil? }
+        base.each do |s|
+          next if s.header.nil?
+          next if override_keys.include?(s.header)
+
+          result << s
+        end
+
+        render(result)
+      end
+
+      # ----- private -----
+
+      def render(sections)
+        sections.map { |s| ensure_trailing_newline(s.body) }.join
+      end
+
+      def ensure_trailing_newline(body)
+        return body if body.empty? || body.end_with?("\n")
+
+        "#{body}\n"
+      end
+
+      def empty_preamble?(section)
+        section.header.nil? && section.body.empty?
+      end
+
+      private_class_method :render, :ensure_trailing_newline, :empty_preamble?
+    end
+  end
+end

data/lib/easyai/command/ai_tool_base.rb

@@ -48,11 +48,12 @@ module EasyAI
 
       def run
         cfg = resolve_config
+        @resolved_config = cfg # 供子类 pre_exec 读取当前生效的平台配置
         print_platform_env(cfg)
-        env = build_environment(cfg)
-        export_environment_variables(env)
+        @env = build_environment(cfg) # 存 ivar：pre_exec 可按需追加（如 codex 注入 CODEX_HOME）
+        export_environment_variables(@env)
         pre_exec
-        exec(env, exec_command, *@passthrough_args)
+        exec(@env, exec_command, *@passthrough_args)
       rescue Config::LocalConfig::NotFoundError => e
         print_error(e.message)
         puts "  请运行: #{'easyai setup'.yellow}"
@@ -95,12 +96,19 @@ module EasyAI
         {}
       end
 
-      # 子类可选重写：在 exec 启动子进程之前执行的钩子（如：写入子进程依赖的状态文件）。
+      # 子类可选重写：在 exec 启动子进程之前执行的钩子（如：写入子进程依赖的状态文件、
+      # 追加只对本次子进程生效的环境变量到 @env，如 codex 注入 CODEX_HOME）。
       # 默认 no-op；不应阻塞主流程，异常应降级为 warning。
       def pre_exec
         # no-op
       end
 
+      # 子类可选重写：向平台选择列表注入的虚拟平台 { key => data }（如 codex 的 ChatGPT Subscribe）。
+      # 默认空；与 config.json 真实平台合并参与交互选择。
+      def extra_platforms
+        {}
+      end
+
       private
 
       # 从 remainder 中识别第一个以 .json 结尾且文件存在的位置参数作为本地覆盖入口
@@ -119,7 +127,9 @@ module EasyAI
           print_success("使用本地覆盖配置 #{@local_config_file}（工具：#{tool_name}）")
           cfg
         else
-          Config::LocalConfig.resolve_platform(tool: tool_name, platform: @platform, verbose: @verbose) do |name|
+          Config::LocalConfig.resolve_platform(
+            tool: tool_name, platform: @platform, verbose: @verbose, extra: extra_platforms
+          ) do |name|
             print_success("使用平台 #{name}（工具：#{tool_name}）")
           end
         end

data/lib/easyai/command/backup/claude.rb

@@ -27,20 +27,23 @@ module EasyAI
               $ easyai backup claude
         DESC
 
-        SOURCE_PATH = File.expand_path('~/.claude.json').freeze
-        BACKUP_DIR  = File.expand_path('~/.easyai/backup').freeze
-        BACKUP_PATH = File.join(BACKUP_DIR, '.claude.json').freeze
         EXCLUDED_KEYS = %w[projects].freeze
         KEYCHAIN_LABEL = 'Claude Code-credentials'.freeze
         KEYCHAIN_BACKUP_KEY = '_easyai_keychain'.freeze
 
+        # 注意：路径用方法动态 expand_path，避免常量在加载期冻结真实 HOME，
+        # 让 spec 切换 ENV['HOME'] 后定位失败（同 LocalConfig.config_path 的处理）
+        def source_path = File.expand_path('~/.claude.json')
+        def backup_dir  = File.expand_path('~/.easyai/backup')
+        def backup_path = File.join(backup_dir, '.claude.json')
+
         def validate!
           super
-          help! "源文件不存在: #{SOURCE_PATH}\n请先登录 Claude Code 后再备份。" unless File.exist?(SOURCE_PATH)
+          help! "源文件不存在: #{source_path}\n请先登录 Claude Code 后再备份。" unless File.exist?(source_path)
         end
 
         def run
-          source = read_json(SOURCE_PATH)
+          source = read_json(source_path)
           EXCLUDED_KEYS.each { |key| source.delete(key) }
 
           keychain_value = read_keychain_credential(KEYCHAIN_LABEL)
@@ -48,18 +51,31 @@ module EasyAI
             source[KEYCHAIN_BACKUP_KEY] = { KEYCHAIN_LABEL => keychain_value }
           end
 
-          target = File.exist?(BACKUP_PATH) ? read_json(BACKUP_PATH) : {}
+          target = File.exist?(backup_path) ? read_json(backup_path) : {}
           before_keys = target.keys
 
           merged = deep_merge(target, source)
 
-          FileUtils.mkdir_p(BACKUP_DIR)
-          File.write(BACKUP_PATH, JSON.pretty_generate(merged))
-          File.chmod(0o600, BACKUP_PATH) unless windows?
+          FileUtils.mkdir_p(backup_dir)
+          File.write(backup_path, JSON.pretty_generate(merged))
+          File.chmod(0o600, backup_path) unless windows?
 
           report(before_keys, source.keys, merged.keys, keychain_value)
         end
 
+        # 供 easyai claude 运行前调用：仅当备份不存在且源文件存在时自动备份一次。
+        # 返回是否执行了备份；任何异常降级为 warning，绝不阻塞启动。
+        def backup_if_absent
+          return false if File.exist?(backup_path)
+          return false unless File.exist?(source_path)
+
+          run
+          true
+        rescue StandardError => e
+          warn "  ⚠ 自动备份 Claude 登录信息失败（#{e.message}），继续启动"
+          false
+        end
+
         private
 
         def read_json(path)
@@ -100,8 +116,8 @@ module EasyAI
           kept    = before_keys - source_keys
 
           puts "✓ Claude 登录信息已备份"
-          puts "  源文件:   #{SOURCE_PATH}"
-          puts "  备份路径: #{BACKUP_PATH}"
+          puts "  源文件:   #{source_path}"
+          puts "  备份路径: #{backup_path}"
           puts "  排除字段: #{EXCLUDED_KEYS.join(', ')}"
           puts "  字段更新: 新增 #{added.size}，更新 #{updated.size}，保留目标独有 #{kept.size}（合计 #{after_keys.size}）"
           if keychain_value

data/lib/easyai/command/backup/codex.rb

@@ -0,0 +1,206 @@
+require 'json'
+require 'fileutils'
+require_relative '../../base/toml_sections'
+require_relative '../../base/system_info'
+
+module EasyAI
+  class Command
+    class Backup
+      class Codex < Backup
+        self.summary = '备份 Codex 登录信息'
+        self.description = <<-DESC
+          把 ~/.codex/auth.json（登录凭证）+ ~/.codex/config.toml（去除 [projects.*] 授信段）
+          合并存进单个文件 ~/.easyai/backup/.codex.json，便于跨机器迁移或灾难恢复。
+
+          特点:
+
+              * 单文件存储：auth 与 config.toml 文本一并放进 .codex.json 的 auth / config_toml 字段
+
+              * auth 字段级深度 merge：源字段覆盖/新增到备份，备份独有字段保留
+
+              * config.toml 排除 [projects.*]：本地按项目授信的段不进备份，其余段段级 merge（源覆盖）
+
+              * 安全权限：备份文件 chmod 600（仅当前用户可读写）
+
+          使用示例:
+
+              $ easyai backup codex
+        DESC
+
+        AUTH_KEY   = 'auth'.freeze
+        CONFIG_KEY = 'config_toml'.freeze
+
+        # 注意：路径用方法动态 expand_path，避免常量在加载期冻结真实 HOME，
+        # 让 spec 切换 ENV['HOME'] 后定位失败（同 LocalConfig.config_path 的处理）
+        def auth_source   = File.expand_path('~/.codex/auth.json')
+        def config_source = File.expand_path('~/.codex/config.toml')
+        def backup_dir    = File.expand_path('~/.easyai/backup')
+        def backup_path   = File.join(backup_dir, '.codex.json')
+
+        def validate!
+          super
+          ensure_file_credentials_supported!
+          help! "源文件不存在: #{auth_source}\n请先登录 Codex 后再备份。" unless File.exist?(auth_source)
+        end
+
+        def run
+          ensure_file_credentials_supported!
+          unless official_token_present?
+            puts '⚠ 未在 ~/.codex/auth.json 检测到 ChatGPT 官方登录 token（OAuth），跳过备份。'
+            puts '  如需备份，请先运行 codex 完成 ChatGPT 订阅账户登录后重试。'
+            return
+          end
+
+          perform_backup
+        end
+
+        # 供 easyai setup 选择 ChatGPT Subscribe 时复用：仅当存在官方 token 才更新备份，
+        # 效果等同 easyai backup codex。返回是否实际执行了备份。
+        def backup_if_official
+          return false unless official_token_present?
+
+          perform_backup
+          true
+        end
+
+        # 供 easyai codex 运行前调用：仅当备份不存在、源文件存在且含官方 token 时自动备份一次。
+        # 返回是否执行了备份；任何异常降级为 warning，绝不阻塞启动。
+        def backup_if_absent
+          return false if File.exist?(backup_path)
+          return false unless File.exist?(auth_source)
+          # keyring 模式下凭证不在文件里，自动备份会一路触发 help! → 每次启动刷屏；此处静默跳过
+          return false if File.exist?(config_source) && keyring_credentials_store?(File.read(config_source))
+          # 只备份真正的 ChatGPT 官方登录态；EasyAI 给 longcat/deepseek 写的纯 API Key auth.json 不在此列
+          return false unless official_token_present?
+
+          perform_backup
+          true
+        rescue StandardError => e
+          warn "  ⚠ 自动备份 Codex 登录信息失败（#{e.message}），继续启动"
+          false
+        end
+
+        # 备份文件 .codex.json 中是否含 ChatGPT 官方 OAuth token，
+        # 供 easyai codex 运行时决定是否提供 ChatGPT Subscribe 选项。
+        def backup_has_official_token?
+          return false unless File.exist?(backup_path)
+
+          oauth_token?(read_json(backup_path)[AUTH_KEY])
+        rescue StandardError
+          false
+        end
+
+        private
+
+        def perform_backup
+          FileUtils.mkdir_p(backup_dir)
+          existing = File.exist?(backup_path) ? read_json(backup_path) : {}
+
+          auth_summary = merge_auth(existing)
+          config_summary = merge_config(existing)
+
+          File.write(backup_path, JSON.pretty_generate(existing))
+          File.chmod(0o600, backup_path) unless windows?
+
+          report(auth_summary, config_summary)
+        end
+
+        # 检测 ~/.codex/auth.json 是否为 ChatGPT 官方登录（OAuth）。
+        def official_token_present?
+          return false unless File.exist?(auth_source)
+
+          oauth_token?(read_json(auth_source))
+        rescue StandardError
+          false
+        end
+
+        # auth hash 是否带 ChatGPT OAuth 凭证：含非空 tokens 段，或 auth_mode == "chatgpt"。
+        # 仅有第三方 OPENAI_API_KEY 不算。
+        def oauth_token?(auth)
+          return false unless auth.is_a?(Hash)
+
+          tokens = auth['tokens']
+          has_oauth = tokens.is_a?(Hash) && tokens.values.any? { |v| !v.to_s.strip.empty? }
+          has_oauth || auth['auth_mode'].to_s == 'chatgpt'
+        end
+
+        def ensure_file_credentials_supported!
+          return unless File.exist?(config_source)
+
+          return unless keyring_credentials_store?(File.read(config_source))
+
+          help! <<~MSG
+            当前 Codex 配置 cli_auth_credentials_store = "keyring"，凭证存储在系统钥匙串中。
+            easyai backup codex 目前只支持 file/auth.json 凭证备份，请先改用 file 存储或手动备份系统钥匙串凭证。
+          MSG
+        end
+
+        def keyring_credentials_store?(toml_text)
+          toml_text.to_s.each_line.any? do |line|
+            line.match?(/^\s*cli_auth_credentials_store\s*=\s*["']keyring["']\s*(?:#.*)?$/)
+          end
+        end
+
+        # 把 ~/.codex/auth.json 深度 merge 进 existing[AUTH_KEY]，返回统计
+        def merge_auth(existing)
+          source = read_json(auth_source)
+          target = existing[AUTH_KEY].is_a?(Hash) ? existing[AUTH_KEY] : {}
+          before = target.keys
+          existing[AUTH_KEY] = deep_merge(target, source)
+
+          {
+            added: (source.keys - before).size,
+            updated: (source.keys & before).size,
+            kept: (before - source.keys).size,
+            total: existing[AUTH_KEY].keys.size
+          }
+        end
+
+        # 把 config.toml（去 projects）段级 merge 进 existing[CONFIG_KEY]，返回统计
+        def merge_config(existing)
+          return nil unless File.exist?(config_source)
+
+          raw = File.read(config_source)
+          excluded = Base::TomlSections.split_sections(raw)
+                                       .count { |s| Base::TomlSections.project_header?(s.header) }
+          filtered = Base::TomlSections.reject_projects(raw)
+          base = existing[CONFIG_KEY].is_a?(String) ? existing[CONFIG_KEY] : ''
+          existing[CONFIG_KEY] = Base::TomlSections.merge(base, filtered)
+
+          { excluded_projects: excluded }
+        end
+
+        def read_json(path)
+          JSON.parse(File.read(path))
+        rescue JSON::ParserError => e
+          raise "解析 JSON 失败 (#{path}): #{e.message}"
+        end
+
+        def deep_merge(target, source)
+          target.merge(source) do |_key, old_val, new_val|
+            if old_val.is_a?(Hash) && new_val.is_a?(Hash)
+              deep_merge(old_val, new_val)
+            else
+              new_val
+            end
+          end
+        end
+
+        def report(auth, config)
+          puts "✓ Codex 登录信息已备份"
+          puts "  备份文件: #{backup_path}"
+          puts "  auth:        新增 #{auth[:added]}，更新 #{auth[:updated]}，保留备份独有 #{auth[:kept]}（合计 #{auth[:total]}）"
+          if config
+            puts "  config.toml: 已备份（排除 #{config[:excluded_projects]} 个 [projects.*] 授信段）"
+          else
+            puts "  config.toml: 源文件不存在，跳过"
+          end
+        end
+
+        def windows?
+          Base::SystemInfo.windows?
+        end
+      end
+    end
+  end
+end

data/lib/easyai/command/backup.rb

@@ -8,10 +8,12 @@ module EasyAI
         可用命令:
 
             * claude - 备份 Claude Code 登录信息
+            * codex  - 备份 Codex 登录信息
 
         使用示例:
 
             $ easyai backup claude    # 备份 ~/.claude.json（去除 projects）到 ~/.easyai/backup/.claude.json
+            $ easyai backup codex     # 备份 ~/.codex/auth.json + config.toml（去除 [projects.*]）到 ~/.easyai/backup/.codex.json
       DESC
 
       self.abstract_command = true
@@ -21,3 +23,4 @@ end
 
 # 加载子命令
 require_relative 'backup/claude'
+require_relative 'backup/codex'

data/lib/easyai/command/claude.rb

@@ -4,6 +4,7 @@ require 'json'
 require 'fileutils'
 require 'open3'
 require_relative 'ai_tool_base'
+require_relative 'backup'
 
 module EasyAI
   class Command
@@ -57,6 +58,8 @@ DESC
       # 会清掉 OAuth 状态。EasyAI 设计前提是统一走 ANTHROPIC_AUTH_TOKEN 环境变量路径，OAuth 登录
       # 态由 `easyai backup claude` / `easyai restore claude` 显式管理。
       def pre_exec
+        # 方案 A：清理 OAuth 残留前先兜底备份，确保首次运行可恢复（仅当备份缺失时触发）
+        Backup::Claude.new(CLAide::ARGV.new([])).backup_if_absent
         reset_claude_state_to_token_mode
         delete_keychain_credential(KEYCHAIN_LABEL)
       end

data/lib/easyai/command/clean.rb

@@ -9,18 +9,17 @@ module EasyAI
     # 清理 AI CLI 自身在本地产生的缓存与配置目录。
     #
     # 设计要点（详见 docs/设计文档.md §2.6）：
-    #   - 仅清理三家 AI CLI（claude / gemini / codex）的缓存路径
+    #   - 仅清理两家 AI CLI（claude / codex）的缓存路径
     #   - 不会触碰 ~/.easyai/config.json（重置 EasyAI 自身配置请用 easyai setup --reset）
     #   - --force 跳过确认；--dry-run 仅打印
     #   - 删除时遇到 Errno::EACCES 继续删余下项；最终如有失败项以退出码 1 退出
     class Clean < Command
       self.summary = '清理 AI CLI 自身缓存（不影响 EasyAI 配置）'
       self.description = <<-DESC
-清理 claude / gemini / codex 各自在本地产生的缓存目录与配置文件。
+清理 claude / codex 各自在本地产生的缓存目录与配置文件。
 
 支持范围：
     * claude → ~/.claude、~/.claude.json、~/.config/claude
-    * gemini → ~/.gemini、~/.config/gemini
     * codex  → ~/.codex、~/.config/codex
     * all    → 上述全部
 
@@ -37,12 +36,11 @@ module EasyAI
     $ easyai setup --reset
 DESC
 
-      VALID_TOOLS = %w[claude gemini codex all].freeze
+      VALID_TOOLS = %w[claude codex all].freeze
 
       # AI CLI 自身的缓存路径表（不含 ~/.easyai/config.json）
       CACHE_PATHS = {
         'claude' => %w[~/.claude ~/.claude.json ~/.config/claude],
-        'gemini' => %w[~/.gemini ~/.config/gemini],
         'codex'  => %w[~/.codex ~/.config/codex]
       }.freeze