logger reduce

Html/apps/_docs/ase_engine_data_sync.md

@@ -16,7 +16,7 @@
 ### 2.2 扩展场景
 
 - **离线数据同步**：支持在网络恢复后进行数据同步
-- **数据备份与恢复**：通过上传/下载机制实现数据备份和恢复
+- **数据备份与恢复**：通过上传/下载机制实现数据备份和恢复。
 - **多租户数据隔离**：通过 namespace_token 实现不同租户数据隔离
 
 ## 3. 实现原理
@@ -36,12 +36,13 @@
 ### 3.2 数据流向
 
 1. **数据下载流程**：
+
    - 客户端调用 `get_multiagents_dialog_list()` 方法
    - 发送 POST 请求到 ASEngine 的 `/api/sync/download` 接口
    - 获取用户对话历史数据
    - 数据用于本地处理或存储
-
 2. **数据上传流程**：
+
    - 客户端调用 `upload_learning_progress_to_cloud()` 方法
    - 序列化待上传的数据（处理特殊类型如 datetime）
    - 发送 POST 请求到 ASEngine 的 `/api/sync/upload` 接口
@@ -55,10 +56,10 @@
 def get_multiagents_dialog_list(user_id: str) -> List[Dict]:
     """
     从 MultiAgents 框架获取用户对话列表
-    
+  
     参数：
     - user_id: 用户ID
-    
+  
     返回：
     - Dict[List]: 对话列表(key 为 History database)
     """
@@ -66,6 +67,7 @@ def get_multiagents_dialog_list(user_id: str) -> List[Dict]:
 ```
 
 **功能特点**：
+
 - 从配置中动态获取 ASEngine URL 和认证信息
 - 支持超时控制（10秒）
 - 完善的错误处理和日志记录
@@ -77,10 +79,10 @@ def get_multiagents_dialog_list(user_id: str) -> List[Dict]:
 def upload_learning_progress_to_cloud(progress: Dict) -> Dict:
     """
     将学习进度上传到云服务
-    
+  
     参数：
     - progress: 学习进度数据字典
-    
+  
     返回：
     - Dict: 上传结果，包含success和message字段
     """
@@ -88,6 +90,7 @@ def upload_learning_progress_to_cloud(progress: Dict) -> Dict:
 ```
 
 **功能特点**：
+
 - 自动处理数据序列化，支持复杂数据类型
 - 完善的错误处理机制
 - 详细的日志记录，便于问题排查
@@ -212,15 +215,16 @@ if progress["exists"]:
 
 ### 7.1 核心模块
 
-| 模块 | 功能描述 | 文件位置 |
-|------|----------|----------|
-| 数据同步服务 | 处理与 ASEngine 的数据交互 | `apps/services/course_services/learning_progess_process.py` |
-| JSON 序列化工具 | 处理复杂数据类型序列化 | `apps/utils/json_serializer.py` |
-| 配置管理 | 管理 ASEngine 连接配置 | `apps/config.py` |
+| 模块            | 功能描述                   | 文件位置                                                      |
+| --------------- | -------------------------- | ------------------------------------------------------------- |
+| 数据同步服务    | 处理与 ASEngine 的数据交互 | `apps/services/course_services/learning_progess_process.py` |
+| JSON 序列化工具 | 处理复杂数据类型序列化     | `apps/utils/json_serializer.py`                             |
+| 配置管理        | 管理 ASEngine 连接配置     | `apps/config.py`                                            |
 
 ### 7.2 扩展建议
 
 1. **添加重试机制**：
+
    ```python
    def upload_with_retry(progress: Dict, max_retries: int = 3) -> Dict:
        for i in range(max_retries):
@@ -230,8 +234,8 @@ if progress["exists"]:
            time.sleep(1)  # 指数退避算法可进一步优化
        return {"success": False, "message": f"上传失败，已重试{max_retries}次"}
    ```
-
 2. **添加数据校验**：
+
    ```python
    def validate_progress_data(progress: Dict) -> bool:
        """验证进度数据格式"""
@@ -241,12 +245,12 @@ if progress["exists"]:
                return False
        return True
    ```
-
 3. **支持异步操作**：
+
    ```python
    import asyncio
    import aiohttp
-   
+
    async def async_upload_learning_progress(progress: Dict) -> Dict:
        """异步上传学习进度"""
        # 异步实现
@@ -309,11 +313,11 @@ if progress["exists"]:
 
 ## 11. 版本历史
 
-| 版本 | 日期 | 描述 | 作者 |
-|------|------|------|------|
-| v1.0 | 2025-12-10 | 初始版本 | 系统自动生成 |
-| v1.1 | YYYY-MM-DD | 添加异步支持 | XXX |
-| v1.2 | YYYY-MM-DD | 实现增量同步 | XXX |
+| 版本 | 日期       | 描述         | 作者         |
+| ---- | ---------- | ------------ | ------------ |
+| v1.0 | 2025-12-10 | 初始版本     | 系统自动生成 |
+| v1.1 | YYYY-MM-DD | 添加异步支持 | XXX          |
+| v1.2 | YYYY-MM-DD | 实现增量同步 | XXX          |
 
 ## 12. 参考资料