BS 0.1.0 开始构建Config内容

Convention/Runtime/EasySave.md

@@ -0,0 +1,111 @@
+[返回](./Runtime-README.md)
+
+# /Convention/Runtime/EasySave
+
+---
+
+完整的序列化和数据持久化系统，提供易用的数据存储和读取功能
+
+## 核心特性
+
+### 支持的数据格式
+- **EasySave - JSON** 支持多态的json格式
+- **Binary** 紧凑的二进制格式
+
+## EasySave主类
+
+### 基本保存操作
+
+#### 泛型保存
+- `Save<T>(string key, T value)` 保存到默认文件
+- `Save<T>(string key, T value, string filePath)` 保存到指定文件
+- `Save<T>(string key, T value, EasySaveSettings settings)` 使用自定义设置
+
+#### 原始数据保存
+- `SaveRaw(byte[] bytes)` / `SaveRaw(string str)` 保存原始数据
+- `AppendRaw(byte[] bytes)` / `AppendRaw(string str)` 追加原始数据
+
+### 基本加载操作
+
+#### 泛型加载
+- `Load<T>(string key)` 从默认文件加载
+- `Load<T>(string key, string filePath)` 从指定文件加载
+- `Load<T>(string key, T defaultValue)` 带默认值的安全加载
+
+#### 原始数据加载
+- `LoadRawBytes()` / `LoadRawString()` 加载原始数据
+- `LoadString(string key, string defaultValue)` 加载字符串
+
+#### 加载到现有对象
+- `LoadInto<T>(string key, T obj)` 将数据加载到现有对象
+- `LoadInto(string key, string filePath, object obj)` 从指定文件加载到对象
+
+### 序列化操作
+
+#### 内存序列化
+- `Serialize<T>(T value, EasySaveSettings settings = null)` 序列化为字节数组
+- `Deserialize<T>(byte[] bytes, EasySaveSettings settings = null)` 从字节数组反序列化
+- `DeserializeInto<T>(byte[] bytes, T obj)` 反序列化到现有对象
+
+### 加密和压缩
+
+#### 加密操作
+- `EncryptBytes(byte[] bytes, string password = null)` 加密字节数组
+- `DecryptBytes(byte[] bytes, string password = null)` 解密字节数组
+- `EncryptString(string str, string password = null)` 加密字符串
+- `DecryptString(string str, string password = null)` 解密字符串
+
+#### 压缩操作
+- `CompressBytes(byte[] bytes)` 压缩字节数组
+- `DecompressBytes(byte[] bytes)` 解压字节数组
+- `CompressString(string str)` 压缩字符串
+- `DecompressString(string str)` 解压字符串
+
+### 备份系统
+
+#### 备份操作
+- `CreateBackup()` / `CreateBackup(string filePath)` 创建备份
+- `RestoreBackup(string filePath)` 恢复备份
+
+#### 时间戳
+- `GetTimestamp()` / `GetTimestamp(string filePath)` 获取文件时间戳
+
+### 缓存系统
+
+#### 缓存操作
+- `StoreCachedFile()` / `StoreCachedFile(string filePath)` 存储缓存文件
+- `CacheFile()` / `CacheFile(string filePath)` 缓存文件
+
+## EasySaveSettings配置
+
+### 枚举类型定义
+
+#### 存储位置
+```csharp
+public enum Location { File, InternalMS, Cache }
+```
+
+#### 目录类型
+```csharp
+public enum Directory { PersistentDataPath, DataPath }
+```
+
+#### 加密类型
+```csharp
+public enum EncryptionType { None, AES }
+```
+
+#### 压缩类型
+```csharp
+public enum CompressionType { None, Gzip }
+```
+
+#### 数据格式
+```csharp
+public enum Format { JSON }
+```
+
+#### 引用模式
+```csharp
+public enum ReferenceMode { ByRef, ByValue, ByRefAndValue }
+```