# MinizExtension.hpp 说明文档

## 文件概述
对miniz压缩库的C++封装扩展，提供ZIP文件读写的高级接口。主要特性包括：
- 面向对象的ZIP存档管理
- UTF-8文件名支持
- 错误状态追踪机制
- 安全的资源生命周期管理

## 核心组件

### 全局函数
```cpp
bool open_zip_reader(mz_zip_archive*, const std::string& fname_utf8);   // 打开ZIP读取器
bool open_zip_writer(mz_zip_archive*, const std::string& fname_utf8);   // 打开ZIP写入器
bool close_zip_reader(mz_zip_archive*);                                // 关闭读取器
bool close_zip_writer(mz_zip_archive*);                                // 关闭写入器

class MZ_Archive {
public:
    mz_zip_archive arch;  // 底层miniz存档对象
    
    // 构造函数：初始化存档结构
    MZ_Archive();
    
    // 静态错误代码转换
    static std::string get_errorstr(mz_zip_error mz_err);
    
    // 获取当前错误描述
    std::string get_errorstr() const;
    
    // 检查存档可用状态
    bool is_alive() const;
};

Slic3r::MZ_Archive reader;
if (Slic3r::open_zip_reader(&reader.arch, "input.zip")) {
    // 执行读取操作...
    Slic3r::close_zip_reader(&reader.arch);
} else {
    std::cerr << "打开失败: " << reader.get_errorstr();
}

Slic3r::MZ_Archive writer;
if (Slic3r::open_zip_writer(&writer.arch, "output.zip")) {
    // 添加文件到压缩包...
    if (!Slic3r::close_zip_writer(&writer.arch)) {
        std::cerr << "写入失败: " << writer.get_errorstr();
    }
} else {
    std::cerr << "创建失败: " << writer.get_errorstr();
}

mz_zip_error err = MZ_ZIP_FILE_OPEN_FAILED;
std::string msg = MZ_Archive::get_errorstr(err); // 返回"MZ_ZIP_FILE_OPEN_FAILED"