feat: 添加全局环境变量加载功能并更新配置说明

codex-lens/src/codexlens/cli/commands.py

@@ -527,8 +527,8 @@ def search(
                 console.print("[dim]Use --method with: fts, vector, splade, hybrid, cascade[/dim]")
             raise typer.Exit(code=1)
 
-    # Configure search
-    config = Config()
+    # Configure search (load settings from file)
+    config = Config.load()
 
     # Validate method
     valid_methods = ["fts", "vector", "splade", "hybrid", "cascade"]

codex-lens/src/codexlens/config.py

@@ -265,6 +265,12 @@ class Config:
                 "timeout_ms": self.llm_timeout_ms,
                 "batch_size": self.llm_batch_size,
             },
+            "reranker": {
+                "enabled": self.enable_cross_encoder_rerank,
+                "backend": self.reranker_backend,
+                "model": self.reranker_model,
+                "top_k": self.reranker_top_k,
+            },
         }
         with open(self.settings_path, "w", encoding="utf-8") as f:
             json.dump(settings, f, indent=2)
@@ -313,6 +319,25 @@ class Config:
                 self.llm_timeout_ms = llm["timeout_ms"]
             if "batch_size" in llm:
                 self.llm_batch_size = llm["batch_size"]
+
+            # Load reranker settings
+            reranker = settings.get("reranker", {})
+            if "enabled" in reranker:
+                self.enable_cross_encoder_rerank = reranker["enabled"]
+            if "backend" in reranker:
+                backend = reranker["backend"]
+                if backend in {"onnx", "api", "litellm", "legacy"}:
+                    self.reranker_backend = backend
+                else:
+                    log.warning(
+                        "Invalid reranker backend in %s: %r (expected 'onnx', 'api', 'litellm', or 'legacy')",
+                        self.settings_path,
+                        backend,
+                    )
+            if "model" in reranker:
+                self.reranker_model = reranker["model"]
+            if "top_k" in reranker:
+                self.reranker_top_k = reranker["top_k"]
         except Exception as exc:
             log.warning(
                 "Failed to load settings from %s (%s): %s",

codex-lens/src/codexlens/env_config.py

@@ -95,39 +95,68 @@ def load_env_file(env_path: Path) -> Dict[str, str]:
     return env_vars
 
 
+def _get_global_data_dir() -> Path:
+    """Get global CodexLens data directory."""
+    env_override = os.environ.get("CODEXLENS_DATA_DIR")
+    if env_override:
+        return Path(env_override).expanduser().resolve()
+    return (Path.home() / ".codexlens").resolve()
+
+
+def load_global_env() -> Dict[str, str]:
+    """Load environment variables from global ~/.codexlens/.env file.
+
+    Returns:
+        Dictionary of environment variables from global config
+    """
+    global_env_path = _get_global_data_dir() / ".env"
+    if global_env_path.is_file():
+        env_vars = load_env_file(global_env_path)
+        log.debug("Loaded %d vars from global %s", len(env_vars), global_env_path)
+        return env_vars
+    return {}
+
+
 def load_workspace_env(workspace_root: Path | None = None) -> Dict[str, str]:
     """Load environment variables from workspace .env files.
-    
+
     Priority (later overrides earlier):
-    1. Project root .env
-    2. .codexlens/.env
-    
+    1. Global ~/.codexlens/.env (lowest priority)
+    2. Project root .env
+    3. .codexlens/.env (highest priority)
+
     Args:
         workspace_root: Workspace root directory. If None, uses current directory.
-        
+
     Returns:
         Merged dictionary of environment variables
     """
     if workspace_root is None:
         workspace_root = Path.cwd()
-    
+
     workspace_root = Path(workspace_root).resolve()
-    
+
     env_vars: Dict[str, str] = {}
-    
-    # Load from project root .env (lowest priority)
+
+    # Load from global ~/.codexlens/.env (lowest priority)
+    global_vars = load_global_env()
+    if global_vars:
+        env_vars.update(global_vars)
+
+    # Load from project root .env (medium priority)
     root_env = workspace_root / ".env"
     if root_env.is_file():
-        env_vars.update(load_env_file(root_env))
-        log.debug("Loaded %d vars from %s", len(env_vars), root_env)
-    
-    # Load from .codexlens/.env (higher priority)
+        loaded = load_env_file(root_env)
+        env_vars.update(loaded)
+        log.debug("Loaded %d vars from %s", len(loaded), root_env)
+
+    # Load from .codexlens/.env (highest priority)
     codexlens_env = workspace_root / ".codexlens" / ".env"
     if codexlens_env.is_file():
         loaded = load_env_file(codexlens_env)
         env_vars.update(loaded)
         log.debug("Loaded %d vars from %s", len(loaded), codexlens_env)
-    
+
     return env_vars