新增：应用配置管理模块，优化文件系统功能

- 新增 ConfigAPI 和 ConfigService 实现配置管理 - 新增 SettingsPanel 和 UpdateNotification 组件 - 文件系统模块化重构，提升代码质量 - 提取公共函数，优化代码结构 - 版本号更新至 0.2.0
2026-01-28 22:48:10 +08:00
parent 7e79a53dae
commit b849e6cc46
31 changed files with 3024 additions and 917 deletions
--- a/internal/filesystem/fs.go
+++ b/internal/filesystem/fs.go
@@ -2,246 +2,101 @@ package filesystem

 import (
 	"fmt"
-	"os"
 	"os/exec"
 	"path/filepath"
 	"runtime"
 	"time"
 )

-// 在包级别存储审计日志记录器
-var auditLogger *AuditLogger
+// ========== 向后兼容的全局函数包装器 ==========
+// 这些函数提供向后兼容性，内部委托给 FileSystemService
+// 新代码应该使用 FileSystemService 而不是这些全局函数

-// InitAudit 初始化文件系统模块（包括审计日志）
-func InitAudit(logDir string) error {
-	logger, err := NewAuditLogger(logDir)
-	if err != nil {
-		return err
-	}
-	auditLogger = logger
-	return nil
-}
-
-// CloseAudit 关闭审计日志
-func CloseAudit() error {
-	if auditLogger != nil {
-		return auditLogger.Close()
-	}
-	return nil
-}
-
-// formatBytes 格式化字节大小为人类可读格式
-func formatBytes(bytes int64) string {
-	const unit = 1024
-	if bytes < unit {
-		return fmt.Sprintf("%d B", bytes)
-	}
-	div, exp := int64(unit), 0
-	for n := bytes / unit; n >= unit; n /= unit {
-		div *= unit
-		exp++
-	}
-	return fmt.Sprintf("%.2f %cB", float64(bytes)/float64(div), "KMGTPE"[exp])
-}
-
-// ReadFile 读取文件内容
+// ReadFile 读取文件内容（向后兼容包装器）
 func ReadFile(path string) (string, error) {
-	if !isSafePath(path) {
-		return "", fmt.Errorf("路径不安全")
-	}
-
-	data, err := os.ReadFile(path)
+	service, err := GetGlobalService()
 	if err != nil {
-		return "", fmt.Errorf("读取文件失败: %v", err)
+		return "", fmt.Errorf("服务未初始化: %v", err)
 	}
-
-	return string(data), nil
+	return service.ReadFile(path)
 }

-// WriteFile 写入文件
+// WriteFile 写入文件（向后兼容包装器）
 func WriteFile(path, content string) error {
-	if !isSafePath(path) {
-		return fmt.Errorf("路径不安全")
+	service, err := GetGlobalService()
+	if err != nil {
+		return fmt.Errorf("服务未初始化: %v", err)
 	}
-
-	dir := filepath.Dir(path)
-	if err := os.MkdirAll(dir, 0755); err != nil {
-		return fmt.Errorf("创建目录失败: %v", err)
-	}
-
-	if err := os.WriteFile(path, []byte(content), 0644); err != nil {
-		return fmt.Errorf("写入文件失败: %v", err)
-	}
-
-	return nil
+	return service.WriteFile(path, content)
 }

-// ListDir 列出目录内容
+// ListDir 列出目录内容（向后兼容包装器）
 func ListDir(path string) ([]map[string]interface{}, error) {
-	if !isSafePath(path) {
-		return nil, fmt.Errorf("路径不安全")
-	}
-
-	entries, err := os.ReadDir(path)
+	service, err := GetGlobalService()
 	if err != nil {
-		return nil, fmt.Errorf("读取目录失败: %v", err)
+		return nil, fmt.Errorf("服务未初始化: %v", err)
 	}
-
-	result := []map[string]interface{}{}
-	for _, entry := range entries {
-		info, err := entry.Info()
-		if err != nil {
-			continue
-		}
-
-		fullPath := filepath.Join(path, entry.Name())
-		result = append(result, map[string]interface{}{
-			"name":     entry.Name(),
-			"path":     fullPath,
-			"is_dir":   entry.IsDir(),
-			"size":     info.Size(),
-			"mod_time": info.ModTime().Format("2006-01-02 15:04:05"),
-		})
-	}
-
-	return result, nil
+	return service.ListDir(path)
 }

-// CreateDir 创建目录
+// CreateDir 创建目录（向后兼容包装器）
 func CreateDir(path string) error {
-	if !isSafePath(path) {
-		return fmt.Errorf("路径不安全")
+	service, err := GetGlobalService()
+	if err != nil {
+		return fmt.Errorf("服务未初始化: %v", err)
 	}
-
-	if err := os.MkdirAll(path, 0755); err != nil {
-		return fmt.Errorf("创建目录失败: %v", err)
-	}
-
-	return nil
+	return service.CreateDir(path)
 }

-// CreateFile 创建空文件
+// CreateFile 创建空文件（向后兼容包装器）
 func CreateFile(path string) error {
-	if !isSafePath(path) {
-		return fmt.Errorf("路径不安全")
-	}
-
-	// 检查文件是否已存在
-	if _, err := os.Stat(path); err == nil {
-		return fmt.Errorf("文件已存在")
-	}
-
-	// 创建文件（如果父目录不存在，会自动创建）
-	file, err := os.Create(path)
+	service, err := GetGlobalService()
 	if err != nil {
-		return fmt.Errorf("创建文件失败: %v", err)
+		return fmt.Errorf("服务未初始化: %v", err)
 	}
-	file.Close()
-
-	return nil
+	return service.CreateFile(path)
 }

-// DeletePath 删除文件或目录
-// 优化：使用配置驱动的安全检查，支持确认机制
+// DeletePath 删除文件或目录（向后兼容包装器）
 func DeletePath(path string) error {
-	// 使用默认配置
-	return DeletePathWithConfig(path, DefaultConfig())
+	service, err := GetGlobalService()
+	if err != nil {
+		return fmt.Errorf("服务未初始化: %v", err)
+	}
+	return service.DeletePath(path)
 }

-// DeletePathWithConfig 使用指定配置删除文件或目录
-// 支持配置化的安全策略和确认机制
+// DeletePathWithConfig 使用指定配置删除文件或目录（向后兼容包装器）
 func DeletePathWithConfig(path string, config *Config) error {
-	// 1. 路径安全检查
-	validator := NewPathValidator(config)
-	if err := validator.Validate(path); err != nil && err.IsError {
-		return fmt.Errorf("路径验证失败: %w", err)
-	}
-
-	// 2. 获取文件信息
-	info, err := os.Stat(path)
+	service, err := GetGlobalService()
 	if err != nil {
-		if os.IsNotExist(err) {
-			return fmt.Errorf("文件或目录不存在")
-		}
-		return fmt.Errorf("获取文件信息失败: %v", err)
+		return fmt.Errorf("服务未初始化: %v", err)
 	}

-	// 3. 检查删除限制（配置驱动）
-	exceeds, details, checkErr := CheckDeleteRestrictions(path, info, config)
-	if checkErr != nil {
-		return checkErr
-	}
+	// 临时替换服务的配置
+	originalConfig := service.config
+	service.config = config
+	defer func() { service.config = originalConfig }()

-	if exceeds {
-		// 根据配置决定是拒绝还是需要确认
-		if config.Security.DeleteRestrictions.RequireConfirm {
-			// TODO: 这里应该触发前端确认对话框
-			// 目前暂时返回警告信息，由前端处理
-			return &DeleteRestrictionWarning{
-				Path:    path,
-				Details: details,
-				Info:    info,
-			}
-		}
-		// 不需要确认，直接拒绝
-		return fmt.Errorf("删除限制: %s", details)
-	}
-
-	// 4. 执行删除操作
-	if info.IsDir() {
-		if err := os.RemoveAll(path); err != nil {
-			return fmt.Errorf("删除目录失败: %v", err)
-		}
-	} else {
-		if err := os.Remove(path); err != nil {
-			return fmt.Errorf("删除文件失败: %v", err)
-		}
-	}
-
-	return nil
+	return service.DeletePath(path)
 }

-// DeleteRestrictionWarning 删除限制警告
-// 用于前端显示确认对话框
-type DeleteRestrictionWarning struct {
-	Path    string
-	Details string
-	Info    os.FileInfo
-}
-
-func (w *DeleteRestrictionWarning) Error() string {
-	return fmt.Sprintf("删除限制警告: %s\n%s", w.Path, w.Details)
-}
-
-// GetFileInfo 获取文件信息
+// GetFileInfo 获取文件信息（向后兼容包装器）
 func GetFileInfo(path string) (map[string]interface{}, error) {
-	if !isSafePath(path) {
-		return nil, fmt.Errorf("路径不安全")
-	}
-
-	info, err := os.Stat(path)
+	service, err := GetGlobalService()
 	if err != nil {
-		if os.IsNotExist(err) {
-			return nil, fmt.Errorf("文件或目录不存在")
-		}
-		return nil, fmt.Errorf("获取文件信息失败: %v", err)
+		return nil, fmt.Errorf("服务未初始化: %v", err)
 	}
-
-	return map[string]interface{}{
-		"name":     info.Name(),
-		"path":     path,
-		"size":     info.Size(),
-		"size_str": formatBytes(info.Size()),
-		"is_dir":   info.IsDir(),
-		"mod_time": info.ModTime().Format("2006-01-02 15:04:05"),
-		"mode":     info.Mode().String(),
-	}, nil
+	return service.GetFileInfo(path)
 }

 // OpenPath 打开文件或目录（使用系统默认程序）
+// 这是一个核心工具函数，保留为独立函数
 func OpenPath(path string) error {
-	if !isSafePath(path) {
-		return fmt.Errorf("路径不安全")
+	// 使用 path.validator 进行验证
+	validator := NewPathValidator(DefaultConfig())
+	if err := validator.Validate(path); err != nil && err.IsError {
+		return fmt.Errorf("路径不安全: %w", err)
 	}

 	path = filepath.Clean(path)
@@ -276,3 +131,28 @@ func OpenPath(path string) error {

 	return nil
 }
+
+// RenamePath 重命名文件或目录（向后兼容包装器）
+func RenamePath(oldPath, newPath string) error {
+	service, err := GetGlobalService()
+	if err != nil {
+		return fmt.Errorf("服务未初始化: %v", err)
+	}
+	return service.RenamePath(oldPath, newPath)
+}
+
+// ========== 辅助函数 ==========
+
+// formatBytes 格式化字节大小为人类可读格式
+func formatBytes(bytes int64) string {
+	const unit = 1024
+	if bytes < unit {
+		return fmt.Sprintf("%d B", bytes)
+	}
+	div, exp := int64(unit), 0
+	for n := bytes / unit; n >= unit; n /= unit {
+		div *= unit
+		exp++
+	}
+	return fmt.Sprintf("%.2f %cB", float64(bytes)/float64(div), "KMGTPE"[exp])
+}