refactor(core): 统一使用ErrorCode并添加错误日志记录

- 将path_manager和import_export模块的返回值从int/void改为ErrorCode
- 在关键操作中添加日志记录，便于调试和错误追踪
- 更新调用代码以检查错误码并记录错误
- 修改运行命令以管理员权限启动程序

CMakeLists.txt

@@ -0,0 +1,94 @@
+cmake_minimum_required(VERSION 3.10)
+project(PathEditor VERSION 3.0 LANGUAGES C)
+
+# 启用资源编译器以处理 .rc 文件
+enable_language(RC)
+
+# 设置 C 标准
+set(CMAKE_C_STANDARD 17)
+set(CMAKE_C_STANDARD_REQUIRED ON)
+set(CMAKE_C_EXTENSIONS OFF) # 禁用特定编译器的扩展（如 gnu17），强制使用标准 C17
+
+# 定义源文件
+set(SOURCES
+    src/main.c
+    src/utils/string_ext.c
+    src/utils/os_env.c
+    src/utils/safe_string.c
+    src/utils/logger.c
+    src/ui/ui_utils.c
+    src/ui/dialogs.c
+    src/ui/main_window.c
+    src/core/registry_service.c
+    src/core/path_manager.c
+    src/core/app_context.c
+    src/core/lua_config.c
+    src/core/import_export.c
+    src/controller/callbacks.c
+    ico/resources.rc
+)
+
+# 创建 GUI 可执行文件（WIN32 属性会自动添加 -mwindows 参数）
+add_executable(${PROJECT_NAME} WIN32 ${SOURCES})
+
+# 添加宏定义
+target_compile_definitions(${PROJECT_NAME} PRIVATE
+    _WIN32
+    UNICODE
+    _UNICODE
+)
+
+# 添加编译选项
+if(CMAKE_C_COMPILER_ID MATCHES "GNU|Clang")
+    target_compile_options(${PROJECT_NAME} PRIVATE
+        -Wall
+        -O2
+        -fexec-charset=UTF-8
+    )
+endif()
+
+# 设置头文件搜索路径
+target_include_directories(${PROJECT_NAME} PRIVATE
+    ${CMAKE_SOURCE_DIR}/include
+    ${CMAKE_SOURCE_DIR}/include/core
+    ${CMAKE_SOURCE_DIR}/include/ui
+    ${CMAKE_SOURCE_DIR}/include/controller
+    ${CMAKE_SOURCE_DIR}/include/utils
+    ${CMAKE_SOURCE_DIR}/libs/IUP/include
+    ${CMAKE_SOURCE_DIR}/libs/lua/include
+)
+
+# 设置库文件搜索路径
+target_link_directories(${PROJECT_NAME} PRIVATE
+    ${CMAKE_SOURCE_DIR}/libs/IUP
+    ${CMAKE_SOURCE_DIR}/libs/lua
+)
+
+# 链接所需库
+target_link_libraries(${PROJECT_NAME} PRIVATE
+    lua55
+    iup
+    iupcd
+    gdi32
+    comdlg32
+    comctl32
+    uuid
+    ole32
+    advapi32
+)
+
+# 编译完成后，复制程序实际需要的核心 DLL 文件到构建输出目录
+set(IUP_REQUIRED_DLLS "${CMAKE_CURRENT_SOURCE_DIR}/libs/IUP/iup.dll")
+set(LUA_REQUIRED_DLLS "${CMAKE_CURRENT_SOURCE_DIR}/libs/lua/lua55.dll")
+add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different
+    ${IUP_REQUIRED_DLLS}
+    "$<TARGET_FILE_DIR:${PROJECT_NAME}>"
+    COMMENT "Copying required DLLs to build directory..."
+)
+add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different
+    ${LUA_REQUIRED_DLLS}
+    "$<TARGET_FILE_DIR:${PROJECT_NAME}>"
+    COMMENT "Copying Lua DLL to build directory..."
+)

Makefile

@@ -1,54 +0,0 @@
-CC = gcc
-WINDRES = windres
-
-# Paths - specific to user environment
-IUP_DIR = libs/iup-3.31_Win64_dllw6_lib
-INCLUDE_DIR = $(IUP_DIR)/include
-LIB_DIR = $(IUP_DIR)
-LOCAL_INCLUDE_DIR = include
-
-# Output Directories
-OBJ_DIR = obj
-BIN_DIR = bin
-
-# Flags
-# -mwindows: Create GUI app (no console)
-# -DUNICODE -D_UNICODE: Use Wide Character API
-CFLAGS = -Wall -O2 -I$(INCLUDE_DIR) -I$(LOCAL_INCLUDE_DIR) -D_WIN32 -DUNICODE -D_UNICODE -fexec-charset=UTF-8
-LDFLAGS = -L$(LIB_DIR) -liup -liupcd -lgdi32 -lcomdlg32 -lcomctl32 -luuid -lole32 -ladvapi32 -mwindows
-
-# Source
-SRC = src/main.c src/utils.c src/registry.c src/callbacks.c
-RES = ico/resources.rc
-OBJ = $(OBJ_DIR)/main.o $(OBJ_DIR)/utils.o $(OBJ_DIR)/registry.o $(OBJ_DIR)/callbacks.o $(OBJ_DIR)/resources.o
-EXE = $(BIN_DIR)/PathEditor.exe
-
-all: $(BIN_DIR) $(OBJ_DIR) $(EXE)
-
-$(BIN_DIR):
-	if not exist $(BIN_DIR) mkdir $(BIN_DIR)
-
-$(OBJ_DIR):
-	if not exist $(OBJ_DIR) mkdir $(OBJ_DIR)
-
-$(EXE): $(OBJ)
-	$(CC) -o $@ $^ $(LDFLAGS)
-
-$(OBJ_DIR)/main.o: src/main.c
-	$(CC) $(CFLAGS) -c -o $@ $<
-
-$(OBJ_DIR)/utils.o: src/utils.c
-	$(CC) $(CFLAGS) -c -o $@ $<
-
-$(OBJ_DIR)/registry.o: src/registry.c
-	$(CC) $(CFLAGS) -c -o $@ $<
-
-$(OBJ_DIR)/callbacks.o: src/callbacks.c
-	$(CC) $(CFLAGS) -c -o $@ $<
-
-$(OBJ_DIR)/resources.o: ico/resources.rc
-	$(WINDRES) -i $< -o $@
-
-clean:
-	if exist $(OBJ_DIR)\*.o del /Q $(OBJ_DIR)\*.o
-	if exist $(BIN_DIR)\*.exe del /Q $(BIN_DIR)\*.exe

README.md

@@ -1,18 +1,58 @@
 # Path Editor (系统环境变量编辑器)
 
-一个简单、轻量级的 Windows 系统环境变量（PATH）编辑器，基于 C 语言和 IUP 图形库开发。
+* Path Editor 是一个专为 Windows 用户设计的系统环境变量（PATH）管理工具。它基于原生 C 语言和 IUP 图形库开发，旨在替代 Windows 自带的简陋编辑界面。
+* 相比系统自带的编辑器，Path Editor 提供了更加直观的双视图（系统/用户变量）界面、智能的路径有效性检测、自动备份机制以及便捷的拖拽操作，让环境变量的管理变得安全、高效且轻松。无论您是开发者还是系统管理员，它都是您配置开发环境的得力助手。
 
 ## ✨ 功能特点
 
-* **可视化编辑**：直观地查看和管理系统 PATH 环境变量。
+* **🛡️ 安全第一**：
-* **安全操作**：必须以管理员身份运行才能保存更改，防止误操作。
+  * **自动备份**：每次保存前自动备份注册表，防止意外。
+  * **只读模式**：非管理员运行时自动切换到只读模式，防止误操作。
+  * **权限检测**：智能检测当前运行权限。
+
+* **📑 双视图管理**：
+  * 完美支持 **System (系统变量)** 和 **User (用户变量)** 的分离查看与编辑。
+  * 清晰的 Tab 标签页切换。
+
+* **🔴 智能诊断与维护**：
+  * **无效路径高亮**：自动检测路径是否存在，不存在的显示为红色。
+  * **重复路径高亮**：自动检测重复项，重复的显示为橙色。
+  * **一键清理**：智能移除所有无效和重复的路径，保持环境整洁。
+
+* **📂 高效交互**：
+  * **拖拽支持**：直接将文件夹拖入窗口即可添加（支持管理员模式下的 UIPI 穿透）。
+  * **实时搜索**：顶部搜索框支持不区分大小写的实时过滤查找。
+  * **快捷键**：支持 Delete 键快速删除选中项。
+
+* **🔄 导入导出**：
+  * **导出备份**：将 PATH 导出为 JSON 文件，方便备份和迁移。
+  * **导入恢复**：从 JSON 文件导入路径配置。
+  * **格式兼容**：支持旧版 TXT 格式导入。
+
 * **便捷管理**：
   * ➕ **新建**：添加新路径到列表。
   * 📂 **浏览**：直接从文件资源管理器选择目录添加。
-  * ✏️ **编辑**：修改现有路径。
+  * ✏️ **编辑**：双击或点击按钮修改现有路径。
   * 🗑️ **删除**：移除不需要的路径。
   * ⬆️⬇️ **排序**：上移/下移调整路径优先级。
-* **轻量级**：原生 C 语言编写，运行速度快，占用资源少。
+
+* **轻量级**：原生 C 语言编写，无臃肿依赖，运行速度极快。
+
+## 🛠️ 架构与二次开发
+
+本项目注重代码的模块化和可维护性，采用了经典的 **MVC 分层架构**，非常适合作为 C 语言桌面程序开发的参考：
+
+* **分层设计**：
+  * `src/core/` (Model): 核心数据与业务逻辑，完全脱离 UI 框架（无任何 `<iup.h>` 依赖）。
+  * `src/ui/` (View): 负责界面布局与组件的纯视觉展示。
+  * `src/controller/` (Controller): 负责连接用户交互与底层数据。
+  * `src/utils/` (Utils): 纯粹的底层工具类封装（系统级调用、字符串处理）。
+* **热配置系统**：所有 UI 参数（窗口大小、按钮文本、布局间距等）均通过 `lua/config.lua` 配置，修改无需重新编译即可生效。
+* **清晰的应用状态**：摒弃了脆弱的全局变量模式，采用 `AppContext` 统一管理应用运行时的上下文状态，通过指针传递，安全可靠。
+* **开发工具库**：
+  * 统一错误码系统 (`utils/error_code.h`)
+  * 安全字符串函数 (`utils/safe_string.h`)
+  * 日志系统 (`utils/logger.h`)
 
 ## 📦 下载与安装
 
@@ -28,10 +68,13 @@
 
 * Windows 操作系统
 * GCC 编译器 (推荐 MinGW-w64)
-* Make 工具
+* CMake 工具 (推荐使用 CMake 构建)
 * IUP 库 (已包含在 `libs` 目录下)
+* Inno Setup 6 (仅打包需要)
 
-### 编译步骤
+### 编译步骤 (推荐使用 CMake)
+
+本项目已迁移至 CMake 构建系统，支持生成更标准的构建文件并集成到各大 IDE。
 
 1. 克隆仓库：
 
@@ -40,30 +83,40 @@
    cd PathEditor
    ```
 
-2. 编译项目：
+2. 使用 CMake 配置和编译：
 
    ```bash
-   mingw32-make
+   # 生成构建系统 (以 MinGW 为例)
+   cmake -B build -G "MinGW Makefiles"
+   
+   # 编译项目
+   cmake --build build
    ```
 
 3. 运行：
-   编译成功后，可执行文件位于 `bin/PathEditor.exe`。
+   编译成功后，可执行文件位于 `build/PathEditor.exe`。
 
 ### 打包 (可选)
 
 本项目使用 Inno Setup 生成安装包。
 
 1. 确保已安装 [Inno Setup 6](https://jrsoftware.org/isdl.php)。
-2. 编译项目生成 exe 文件。
+2. 运行根目录下的 `build_installer.bat` 脚本。
-3. 使用 Inno Setup 编译 `dist/installer.iss` 脚本。
+3. 生成的安装包将位于 `dist/dist/PathEditorSetup.exe`。
 
 ## 📝 使用说明
 
 1. **启动**：右键点击程序图标，选择“以管理员身份运行”。
 2. **查看**：程序启动后会自动加载当前的系统 PATH 变量。
-3. **修改**：使用右侧按钮栏进行添加、删除、移动等操作。
+   * **红色**条目表示路径不存在。
-4. **保存**：操作完成后，务必点击底部的【确定】按钮保存更改。
+   * **橙色**条目表示路径重复。
-5. **生效**：保存后，某些正在运行的程序可能需要重启才能识别新的环境变量。CMD 或 PowerShell 窗口需要重新打开。
+3. **搜索**：在顶部输入关键词可快速筛选。
+4. **修改**：
+   * 拖拽文件夹到列表可直接添加。
+   * 使用右侧按钮栏进行常规操作。
+   * 点击“一键清理”可自动删除无效和重复项。
+5. **保存**：操作完成后，务必点击底部的【确定】按钮保存更改。
+6. **生效**：保存后，某些正在运行的程序可能需要重启才能识别新的环境变量。CMD 或 PowerShell 窗口需要重新打开。
 
 ## 👤 作者信息
 

build_installer.bat

@@ -0,0 +1,12 @@
+@echo off
+
+echo Building Installer...
+"D:\Program Files (x86)\Inno Setup 6\ISCC.exe" "dist\installer.iss"
+
+if %ERRORLEVEL% NEQ 0 (
+    echo Installer build failed!
+    exit /b %ERRORLEVEL%
+)
+
+echo Done! Installer is in dist\dist\
+pause

dist/installer.iss

@@ -37,8 +37,8 @@ Name: "english"; MessagesFile: "compiler:Default.isl"
 Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
 
 [Files]
-Source: "d:\Code\doing_exercises\programs\PathEditor\bin\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
+Source: "d:\Code\doing_exercises\programs\PathEditor\build\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
-Source: "d:\Code\doing_exercises\programs\PathEditor\bin\*.dll"; DestDir: "{app}"; Flags: ignoreversion
+Source: "d:\Code\doing_exercises\programs\PathEditor\build\*.dll"; DestDir: "{app}"; Flags: ignoreversion
 ; NOTE: Don't use "Flags: ignoreversion" on any shared system files
 
 [Icons]

include/callbacks.h

@@ -1,20 +0,0 @@
-#ifndef CALLBACKS_H
-#define CALLBACKS_H
-
-#include <iup.h>
-
-// 按钮回调
-int btn_new_cb(Ihandle* self);
-int btn_edit_cb(Ihandle* self);
-int btn_browse_cb(Ihandle* self);
-int btn_del_cb(Ihandle* self);
-int btn_up_cb(Ihandle* self);
-int btn_down_cb(Ihandle* self);
-int btn_ok_cb(Ihandle* self);
-int btn_cancel_cb(Ihandle* self);
-int btn_help_cb(Ihandle* self);
-
-// 双击回调
-int list_dblclick_cb(Ihandle* self, int item, char* text);
-
-#endif // CALLBACKS_H

include/controller/callbacks.h

@@ -0,0 +1,35 @@
+#ifndef CALLBACKS_H
+#define CALLBACKS_H
+
+#include <iup.h>
+
+// 按钮回调
+int btn_new_cb(Ihandle *self);
+int btn_edit_cb(Ihandle *self);
+int btn_browse_cb(Ihandle *self);
+int btn_del_cb(Ihandle *self);
+int btn_up_cb(Ihandle *self);
+int btn_down_cb(Ihandle *self);
+int btn_clean_cb(Ihandle *self);
+int btn_import_cb(Ihandle *self);
+int btn_export_cb(Ihandle *self);
+int btn_ok_cb(Ihandle *self);
+int btn_cancel_cb(Ihandle *self);
+int btn_help_cb(Ihandle *self);
+
+// 搜索回调
+int txt_search_cb(Ihandle *self);
+
+// 双击回调
+int list_dblclick_cb(Ihandle *self, int item, char *text);
+
+// 拖拽回调
+int list_dropfiles_cb(Ihandle *self, const char *filename, int num, int x, int y);
+
+// 键盘按键回调
+int list_k_any_cb(Ihandle *self, int c);
+
+// 载入数据与更新UI
+void load_all_paths(void);
+
+#endif // CALLBACKS_H

include/core/app_context.h

@@ -0,0 +1,22 @@
+#ifndef APP_CONTEXT_H
+#define APP_CONTEXT_H
+
+#include "utils/string_ext.h"
+#include <iup.h>
+
+// 应用上下文结构体,用于存储应用运行时的状态
+typedef struct {
+    StringList sys_paths;
+    StringList user_paths;
+} AppContext;
+
+// 创建应用上下文
+AppContext* create_app_context(void);
+
+// 销毁应用上下文
+void destroy_app_context(AppContext* ctx);
+
+// 获取应用上下文
+AppContext* get_app_context(Ihandle *ih);
+
+#endif // APP_CONTEXT_H

include/core/import_export.h

@@ -0,0 +1,20 @@
+#ifndef IMPORT_EXPORT_H
+#define IMPORT_EXPORT_H
+
+#include "utils/string_ext.h"
+#include "utils/error_code.h"
+
+#define EXPORT_VERSION "1.0"
+
+typedef struct {
+    StringList system;
+    StringList user;
+} ExportData;
+
+// 导出 PATH 到文件
+ErrorCode export_paths_to_file(const ExportData *data, const char *filepath);
+
+// 从文件导入 PATH
+ErrorCode import_paths_from_file(const char *filepath, ExportData *data);
+
+#endif // IMPORT_EXPORT_H

include/core/lua_config.h

@@ -0,0 +1,34 @@
+#ifndef LUA_CONFIG_H
+#define LUA_CONFIG_H
+
+#include <lua.h>
+
+// 初始化 Lua 配置系统
+// 返回值: 0 成功, -1 失败
+int lua_config_init(void);
+
+// 销毁 Lua 配置系统
+void lua_config_destroy(void);
+
+// 获取字符串配置值
+// section: 配置章节名 (如 "app", "dialog", "button")
+// key: 配置键名 (如 "name", "size", "rastersize")
+// 返回值: 配置值字符串, 失败时返回 NULL
+const char* lua_config_get_string(const char* section, const char* key);
+
+// 获取整型配置值
+// section: 配置章节名
+// key: 配置键名
+// default_value: 默认值 (当配置不存在或转换失败时返回)
+// 返回值: 配置值或默认值
+int lua_config_get_int(const char* section, const char* key, int default_value);
+
+// 重新加载配置文件
+// 返回值: 0 成功, -1 失败
+int lua_config_reload(void);
+
+// 获取配置加载状态
+// 返回值: 1 已加载, 0 未加载
+int lua_config_is_loaded(void);
+
+#endif // LUA_CONFIG_H

include/core/path_manager.h

@@ -0,0 +1,19 @@
+#ifndef PATH_MANAGER_H
+#define PATH_MANAGER_H
+
+#include "utils/string_ext.h"
+#include "utils/error_code.h"
+
+// 移除列表中指定索引的项
+ErrorCode path_manager_remove_at(StringList *list, int index);
+
+// 上移指定索引的项
+ErrorCode path_manager_move_up(StringList *list, int index);
+
+// 下移指定索引的项
+ErrorCode path_manager_move_down(StringList *list, int index);
+
+// 清理无效和重复的路径
+ErrorCode path_manager_clean(StringList *list);
+
+#endif // PATH_MANAGER_H

include/core/registry_service.h

@@ -0,0 +1,15 @@
+#ifndef REGISTRY_SERVICE_H
+#define REGISTRY_SERVICE_H
+
+#include "utils/string_ext.h"
+#include "utils/error_code.h"
+
+// 加载系统变量和用户变量到字符串列表
+ErrorCode load_system_paths(StringList *list);
+ErrorCode load_user_paths(StringList *list);
+
+// 从字符串列表保存系统变量和用户变量
+ErrorCode save_system_paths(const StringList *list);
+ErrorCode save_user_paths(const StringList *list);
+
+#endif // REGISTRY_SERVICE_H

include/globals.h

@@ -1,24 +0,0 @@
-#ifndef GLOBALS_H
-#define GLOBALS_H
-
-#include <iup.h>
-
-// 注册表路径常量
-#define REG_PATH L"SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment"
-#define REG_VALUE L"Path"
-
-// 全局控件句柄声明
-extern Ihandle *dlg;        // 主对话框句柄
-extern Ihandle *list_path;  // 路径列表控件句柄
-extern Ihandle *lbl_status; // 状态标签句柄
-extern Ihandle *btn_new;    // 新增按钮句柄
-extern Ihandle *btn_edit;   // 编辑按钮句柄
-extern Ihandle *btn_browse; // 浏览按钮句柄
-extern Ihandle *btn_del;    // 删除按钮句柄
-extern Ihandle *btn_up;     // 上移按钮句柄
-extern Ihandle *btn_down;   // 下移按钮句柄
-extern Ihandle *btn_ok;     // 确认按钮句柄
-extern Ihandle *btn_cancel; // 取消按钮句柄
-extern Ihandle *btn_help;   // 帮助按钮句柄
-
-#endif // GLOBALS_H

include/registry.h

@@ -1,10 +0,0 @@
-#ifndef REGISTRY_H
-#define REGISTRY_H
-
-// 从注册表加载PATH到列表控件
-void load_path();
-
-// 将列表控件中的PATH保存回注册表
-void save_path();
-
-#endif // REGISTRY_H

include/ui/dialogs.h

@@ -0,0 +1,8 @@
+#ifndef DIALOGS_H
+#define DIALOGS_H
+
+// 自定义输入对话框
+// 返回值：0-取消，1-确认
+int custom_input_dialog(const char *title, const char *label_text, char *buffer, int buffer_size);
+
+#endif // DIALOGS_H

include/ui/main_window.h

@@ -0,0 +1,9 @@
+#ifndef MAIN_WINDOW_H
+#define MAIN_WINDOW_H
+
+#include <iup.h>
+
+// 创建主窗口
+Ihandle* create_main_window(void);
+
+#endif // MAIN_WINDOW_H

include/ui/ui_utils.h

@@ -0,0 +1,13 @@
+#ifndef UI_UTILS_H
+#define UI_UTILS_H
+
+#include <iup.h>
+#include "utils/string_ext.h"
+
+// 刷新单个列表框样式
+void refresh_single_list_style(Ihandle *list);
+
+// 同步字符串列表到 UI 列表框
+void sync_string_list_to_ui(Ihandle *list_ui, const StringList *str_list);
+
+#endif // UI_UTILS_H

include/utils.h

@@ -1,19 +0,0 @@
-#ifndef UTILS_H
-#define UTILS_H
-
-#include <windows.h>
-#include <wchar.h>
-
-// 宽字符转UTF-8
-char* wide_to_utf8(const wchar_t* wstr);
-
-// UTF-8转宽字符
-wchar_t* utf8_to_wide(const char* str);
-
-// 检查管理员权限
-int check_admin();
-
-// 刷新列表样式（斑马纹）
-void refresh_list_style();
-
-#endif // UTILS_H

include/utils/error_code.h

@@ -0,0 +1,19 @@
+#ifndef ERROR_CODE_H
+#define ERROR_CODE_H
+
+typedef enum {
+    ERR_OK = 0,                 // 成功
+    ERR_FAILED = -1,            // 失败
+    ERR_NULL_PTR = -2,          // 空指针
+    ERR_OUT_OF_MEMORY = -3,     // 内存不足
+    ERR_FILE_NOT_FOUND = -4,    // 文件不存在
+    ERR_PERMISSION_DENIED = -5, // 权限拒绝
+    ERR_INVALID_FORMAT = -6,    // 无效格式
+    ERR_REGISTRY_FAILED = -7,   // 注册表操作失败
+    ERR_NOT_FOUND = -8,         // 未找到
+    ERR_EXISTS = -9             // 已存在
+} ErrorCode;
+
+const char* error_code_to_string(ErrorCode code);
+
+#endif // ERROR_CODE_H

include/utils/logger.h

@@ -0,0 +1,33 @@
+#ifndef LOGGER_H
+#define LOGGER_H
+
+// 日志级别
+typedef enum {
+    LOG_LEVEL_DEBUG,    // 调试日志级别
+    LOG_LEVEL_INFO,     // 信息日志级别
+    LOG_LEVEL_WARN,     // 警告日志级别
+    LOG_LEVEL_ERROR     // 错误日志级别
+} LogLevel;
+
+// 初始化日志系统
+void log_init(const char *log_file, LogLevel level);
+
+// 销毁日志系统
+void log_destroy(void);
+
+// 日志函数
+void log_debug(const char *fmt, ...);
+
+// 信息日志函数
+void log_info(const char *fmt, ...);
+
+// 警告日志函数
+void log_warn(const char *fmt, ...);
+
+// 错误日志函数
+void log_error(const char *fmt, ...);
+
+// 设置日志级别
+void log_set_level(LogLevel level);
+
+#endif // LOGGER_H

include/utils/os_env.h

@@ -0,0 +1,13 @@
+#ifndef OS_ENV_H
+#define OS_ENV_H
+
+// 检查是否以管理员权限运行
+int check_admin(void);
+
+// 检查路径是否有效
+int is_path_valid(const char *path);
+
+// 备份注册表
+void backup_registry(void);
+
+#endif // OS_ENV_H

include/utils/safe_string.h

@@ -0,0 +1,15 @@
+#ifndef SAFE_STRING_H
+#define SAFE_STRING_H
+
+#include <stddef.h>
+
+// 安全字符串操作函数
+char* safe_strcpy(char *dst, size_t dst_size, const char *src);
+
+// 安全字符串拼接函数
+char* safe_strcat(char *dst, size_t dst_size, const char *src);
+
+// 安全字符串复制函数
+char* safe_strdup(const char *src);
+
+#endif // SAFE_STRING_H

include/utils/string_ext.h

@@ -0,0 +1,24 @@
+#ifndef STRING_EXT_H
+#define STRING_EXT_H
+
+#include <wchar.h>
+
+// 简单字符串列表结构
+typedef struct
+{
+    char **items;
+    int count;
+    int capacity;
+} StringList;
+
+// 字符串列表
+void init_string_list(StringList *list);
+void add_string_list(StringList *list, const char *str);
+void clear_string_list(StringList *list);
+
+// 字符串转换函数
+char *wide_to_utf8(const wchar_t *wstr);
+wchar_t *utf8_to_wide(const char *str);
+char *stristr(const char *haystack, const char *needle);
+
+#endif // STRING_EXT_H