feat(common): 提取公共环境变量加载模块

- 创建独立的 file_classification_common crate 用于共享环境变量加载逻辑
- 在 CLI 和 Web API 项目中移除重复的环境变量加载代码
- 引入 dotenvy 依赖到公共模块，统一管理环境配置加载
- 更新 Cargo.toml 和 Cargo.lock 以反映新的依赖结构
- 重构 Web API 静态文件服务，支持从嵌入资源和物理目录双重加
- 添加静态资源目录查找逻辑，提高程序运行时的路径兼容性
- 实现嵌入资源 fallback 机制，确保在缺少物理文件时仍能正常运行
- 移除各项目中冗余的默认环境文件创建逻辑，统一由公共模块处理

Author: DataEraserC

Cargo.lock

@@ -1,6 +1,6 @@
 [workspace]
 resolver = "2"
-members = ["file_classification_*"]
+members = ["file_classification_*", "common"]
 
 [profile.release]
 codegen-units = 1

Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "file_classification_common"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+dotenvy = { workspace = true }
+
+[dev-dependencies]
+tempfile = "3.23"

common/Cargo.toml

@@ -0,0 +1,92 @@
+//! 环境变量加载工具
+//! 
+//! 提供灵活的环境变量文件加载机制，支持自定义文件名和多重回退策略
+
+use std::env;
+use std::fs;
+use std::path::Path;
+
+/// 加载环境变量文件
+/// 
+/// 加载顺序：
+/// 1. 通过 ENV_FILE 环境变量指定的文件
+/// 2. 回退到 .file_classification_env
+/// 3. 如果以上都不存在，则创建带有默认配置的 .file_classification_env
+/// 
+/// # Returns
+/// 返回加载的环境变量文件路径，如果使用默认配置则返回 None
+pub fn load_env_file() -> Result<Option<String>, Box<dyn std::error::Error>> {
+    // 首先检查是否通过环境变量指定了env文件
+    let env_file = env::var("ENV_FILE").unwrap_or_else(|_| ".file_classification_env".to_string());
+    
+    // 尝试加载指定的env文件
+    if Path::new(&env_file).exists() {
+        dotenvy::dotenv_override().ok();
+        dotenvy::from_filename_override(&env_file)?;
+        Ok(Some(env_file))
+    } else if env_file != ".file_classification_env" && Path::new(".file_classification_env").exists() {
+        // 如果指定了自定义env文件但不存在，回退到.file_classification_env
+        dotenvy::dotenv_override().ok();
+        dotenvy::from_filename_override(".file_classification_env")?;
+        Ok(Some(".file_classification_env".to_string()))
+    } else {
+        // 如果文件都不存在，创建默认的.file_classification_env
+        create_default_env_file()?;
+        dotenvy::dotenv_override().ok();
+        dotenvy::from_filename_override(".file_classification_env")?;
+        Ok(None)
+    }
+}
+
+/// 创建默认的环境变量配置文件
+fn create_default_env_file() -> Result<(), Box<dyn std::error::Error>> {
+    let default_content = r#"# File Classification 系统配置文件
+# 数据库配置
+DATABASE_URL=file_classification.db
+DATABASE_TYPE=sqlite
+
+# Web API 配置
+BIND_ADDRESS=127.0.0.1
+BIND_PORT=8082
+
+# 日志配置
+RUST_LOG=info
+RUST_LOG_FILE=debug
+
+# CORS 配置
+CORS_ENABLED=true
+CORS_ORIGIN=http://localhost:8082
+"#;
+    
+    fs::write(".file_classification_env", default_content)?;
+    Ok(())
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use std::fs;
+    use std::env;
+
+    #[test]
+    fn test_create_default_env_file() {
+        // 创建临时目录进行测试
+        let test_dir = tempfile::tempdir().unwrap();
+        let original_dir = env::current_dir().unwrap();
+        
+        // 切换到临时目录
+        env::set_current_dir(test_dir.path()).unwrap();
+        
+        // 测试创建默认env文件
+        assert!(create_default_env_file().is_ok());
+        assert!(Path::new(".file_classification_env").exists());
+        
+        // 检查文件内容
+        let content = fs::read_to_string(".file_classification_env").unwrap();
+        assert!(content.contains("DATABASE_URL=file_classification.db"));
+        assert!(content.contains("DATABASE_TYPE=sqlite"));
+        
+        // 恢复原始目录
+        env::set_current_dir(original_dir).unwrap();
+    }
+}

common/src/env_loader.rs

@@ -0,0 +1,6 @@
+//! 公共工具库
+//! 
+//! 包含项目中多个模块共享的工具函数和类型定义
+
+/// 环境变量加载工具模块
+pub mod env_loader;

common/src/lib.rs

@@ -4,12 +4,12 @@ version = "0.2.0"
 edition = "2024"
 
 [dependencies]
+file_classification_common = { path = "../common" }
 file_classification_core = { path = "../file_classification_core" }
 clap = { version = "4.5", features = ["derive"] }
 dialoguer = "0.12.0"
 rustyline = "17.0.2"
 shlex = "1.3.0"
-dotenvy = { workspace = true }
 
 [[bin]]
 name = "file_classification_cli"

file_classification_cli/Cargo.toml

@@ -2,17 +2,16 @@
 // 主入口文件，负责解析CLI参数并分派到相应处理函数
 
 use std::error::Error;
-use std::env;
-use std::fs;
-use std::path::Path;
 
 use clap::Parser;
 
 use crate::cli::Cli;
 use crate::context::Context;
 use crate::handlers::handle_command;
 use crate::repl::run_repl;
-use file_classification_core::utils;
+use file_classification_core::utils::database;
+// 引入环境变量加载工具
+use file_classification_common::env_loader::load_env_file;
 
 mod cli;
 mod context;
@@ -22,59 +21,6 @@ mod interactive;
 mod parsers;
 mod repl;
 
-/// 加载环境变量文件
-///
-/// 加载顺序：
-/// 1. 通过 ENV_FILE 环境变量指定的文件
-/// 2. 回退到 .file_classification_env
-/// 3. 如果以上都不存在，则创建带有默认配置的 .file_classification_env
-fn load_env_file() -> Result<Option<String>, Box<dyn std::error::Error>> {
-    // 首先检查是否通过环境变量指定了env文件
-    let env_file = env::var("ENV_FILE").unwrap_or_else(|_| ".file_classification_env".to_string());
-    
-    // 尝试加载指定的env文件
-    if Path::new(&env_file).exists() {
-        dotenvy::dotenv_override().ok();
-        dotenvy::from_filename_override(&env_file)?;
-        Ok(Some(env_file))
-    } else if env_file != ".file_classification_env" && Path::new(".file_classification_env").exists() {
-        // 如果指定了自定义env文件但不存在，回退到.file_classification_env
-        dotenvy::dotenv_override().ok();
-        dotenvy::from_filename_override(".file_classification_env")?;
-        Ok(Some(".file_classification_env".to_string()))
-    } else {
-        // 如果文件都不存在，创建默认的.file_classification_env
-        create_default_env_file()?;
-        dotenvy::dotenv_override().ok();
-        dotenvy::from_filename_override(".file_classification_env")?;
-        Ok(None)
-    }
-}
-
-/// 创建默认的环境变量配置文件
-fn create_default_env_file() -> Result<(), Box<dyn std::error::Error>> {
-    let default_content = r#"# File Classification 系统配置文件
-# 数据库配置
-DATABASE_URL=file_classification.db
-DATABASE_TYPE=sqlite
-
-# Web API 配置
-BIND_ADDRESS=127.0.0.1
-BIND_PORT=8082
-
-# 日志配置
-RUST_LOG=info
-RUST_LOG_FILE=debug
-
-# CORS 配置
-CORS_ENABLED=true
-CORS_ORIGIN=http://localhost:8082
-"#;
-    
-    fs::write(".file_classification_env", default_content)?;
-    Ok(())
-}
-
 /// 主函数：解析命令行参数，初始化数据库连接和上下文，并处理命令
 fn main() -> Result<(), Box<dyn Error>> {
     let cli = Cli::parse();
@@ -88,10 +34,10 @@ fn main() -> Result<(), Box<dyn Error>> {
     let database_url = std::env::var("DATABASE_URL").expect("DATABASE_URL must be set");
     let database_type = std::env::var("DATABASE_TYPE").expect("DATABASE_TYPE must be set");
 
-    let mut conn = utils::database::establish_connection(&database_url, &database_type);
+    let mut conn = database::establish_connection(&database_url, &database_type);
 
     // 运行待处理的数据库迁移
-    if let Err(e) = utils::database::run_pending_migrations(&mut conn) {
+    if let Err(e) = database::run_pending_migrations(&mut conn) {
         eprintln!("数据库迁移失败: {}", e);
         return Err(e);
     }

file_classification_cli/src/main.rs

@@ -0,0 +1,57 @@
+//! CLI 工具模块
+
+/// 加载环境变量文件
+/// 
+/// 加载顺序：
+/// 1. 通过 ENV_FILE 环境变量指定的文件
+/// 2. 回退到 .file_classification_env
+/// 3. 如果以上都不存在，则创建带有默认配置的 .file_classification_env
+/// 
+/// # Returns
+/// 返回加载的环境变量文件路径，如果使用默认配置则返回 None
+pub fn load_env_file() -> Result<Option<String>, Box<dyn std::error::Error>> {
+    // 首先检查是否通过环境变量指定了env文件
+    let env_file = std::env::var("ENV_FILE").unwrap_or_else(|_| ".file_classification_env".to_string());
+    
+    // 尝试加载指定的env文件
+    if std::path::Path::new(&env_file).exists() {
+        dotenvy::dotenv_override().ok();
+        dotenvy::from_filename_override(&env_file)?;
+        Ok(Some(env_file))
+    } else if env_file != ".file_classification_env" && std::path::Path::new(".file_classification_env").exists() {
+        // 如果指定了自定义env文件但不存在，回退到.file_classification_env
+        dotenvy::dotenv_override().ok();
+        dotenvy::from_filename_override(".file_classification_env")?;
+        Ok(Some(".file_classification_env".to_string()))
+    } else {
+        // 如果文件都不存在，创建默认的.file_classification_env
+        create_default_env_file()?;
+        dotenvy::dotenv_override().ok();
+        dotenvy::from_filename_override(".file_classification_env")?;
+        Ok(None)
+    }
+}
+
+/// 创建默认的环境变量配置文件
+fn create_default_env_file() -> Result<(), Box<dyn std::error::Error>> {
+    let default_content = r#"# File Classification 系统配置文件
+# 数据库配置
+DATABASE_URL=file_classification.db
+DATABASE_TYPE=sqlite
+
+# Web API 配置
+BIND_ADDRESS=127.0.0.1
+BIND_PORT=8082
+
+# 日志配置
+RUST_LOG=info
+RUST_LOG_FILE=debug
+
+# CORS 配置
+CORS_ENABLED=true
+CORS_ORIGIN=http://localhost:8082
+"#;
+    
+    std::fs::write(".file_classification_env", default_content)?;
+    Ok(())
+}

file_classification_cli/src/utils.rs

@@ -4,12 +4,12 @@ version = "0.2.0"
 edition = "2024"
 
 [dependencies]
+file_classification_common = { path = "../common" }
 file_classification_core = { path = "../file_classification_core", features = ["swagger"] }
 chrono = { workspace = true }
 serde = { workspace = true }
 #diesel = { workspace = true, features = ["r2d2"] }
 diesel = { workspace = true }
-dotenvy = { workspace = true }
 # web related deps
 actix-web = "4.11"
 actix-cors = "0.7"