ErisPulse 1.1.12__py3-none-any.whl → 1.1.14.dev1__py3-none-any.whl

ErisPulse/__init__.py

@@ -1,3 +1,40 @@
+"""
+# SDK 核心初始化
+
+提供SDK全局对象构建和初始化功能。
+
+## 主要功能
+- 构建全局sdk对象
+- 预注册核心错误类型
+- 提供SDK初始化入口
+- 集成各核心模块
+
+## API 文档
+### 核心对象：
+    - sdk: 全局SDK命名空间对象
+    - sdk.init(): SDK初始化入口函数
+
+### 预注册错误类型：
+    - CaughtExternalError: 外部捕获异常
+    - InitError: 初始化错误
+    - MissingDependencyError: 缺少依赖错误  
+    - InvalidDependencyError: 无效依赖错误
+    - CycleDependencyError: 循环依赖错误
+    - ModuleLoadError: 模块加载错误
+
+### 示例用法：
+
+```
+from ErisPulse import sdk
+
+# 初始化SDK
+sdk.init()
+
+# 访问各模块功能
+sdk.logger.info("SDK已初始化")
+```
+
+"""
 
 import types
 sdk = types.SimpleNamespace()
@@ -35,7 +72,8 @@ def init() -> None:
         logger.info("[Init] SDK 正在初始化...")
         if env.create_env_file_if_not_exists():
             logger.info("[Init] 项目首次初始化，建议先配置环境变量")
-            sys.exit(0)
+            if input("是否立即退出？(y/n): ").strip().lower() == "y":
+                sys.exit(0)
         env.load_env_file()
 
         sdkModulePath = os.path.join(os.path.dirname(__file__), "modules")
@@ -185,4 +223,4 @@ def init() -> None:
         raiserr.InitError(f"sdk初始化失败: {e}", exit=True)
 
 
-sdk.init = init
+sdk.init = init

ErisPulse/__main__.py

@@ -1,3 +1,48 @@
+"""
+# CLI 入口
+
+提供命令行界面(CLI)用于模块管理、源管理和开发调试。
+
+## 主要功能
+- 模块管理: 安装/卸载/启用/禁用
+- 源管理: 添加/删除/更新源
+- 热重载: 开发时自动重启
+- 彩色终端输出
+
+## 主要命令
+### 模块管理:
+    install: 安装模块
+    uninstall: 卸载模块
+    enable: 启用模块
+    disable: 禁用模块
+    list: 列出模块
+    update: 更新模块列表
+    upgrade: 升级模块
+
+### 源管理:
+    origin add: 添加源
+    origin del: 删除源  
+    origin list: 列出源
+
+### 开发调试:
+    run: 运行脚本
+    --reload: 启用热重载
+
+### 示例用法:
+
+```
+# 安装模块
+epsdk install MyModule
+
+# 启用热重载
+epsdk run main.py --reload
+
+# 管理源
+epsdk origin add https://example.com/map.json
+```
+
+"""
+
 import argparse
 import os
 import sys
@@ -9,6 +54,7 @@ import fnmatch
 import asyncio
 import subprocess
 import json
+import json
 from .db import env
 from .mods import mods
 from watchdog.observers import Observer
@@ -37,7 +83,6 @@ class Shell_Printer:
 
     @classmethod
     def _get_color(cls, level):
-        """根据消息级别返回颜色"""
         return {
             "info": cls.CYAN,
             "success": cls.GREEN,
@@ -49,77 +94,87 @@ class Shell_Printer:
 
     @classmethod
     def panel(cls, msg: str, title: str = None, level: str = "info") -> None:
-        """带标题和边框的面板，支持颜色编码"""
         color = cls._get_color(level)
-        border_char = "═" * 60
+        width = 70
+        border_char = "─" * width
+        
+        if level == "error":
+            border_char = "═" * width
+            msg = f"{cls.RED}✗ {msg}{cls.RESET}"
+        elif level == "warning":
+            border_char = "─" * width
+            msg = f"{cls.YELLOW}⚠ {msg}{cls.RESET}"
         
-        # 标题行
         title_line = ""
         if title:
             title = f" {title.upper()} "
-            title_padding = (60 - len(title) - 4) // 2
+            title_padding = (width - len(title)) // 2
             left_pad = " " * title_padding
-            right_pad = " " * (60 - len(title) - title_padding - 4)
-            title_line = f"{cls.DIM}╔{left_pad}{cls.BOLD}{color}{title}{cls.RESET}{cls.DIM}{right_pad}╗{cls.RESET}\n"
+            right_pad = " " * (width - len(title) - title_padding)
+            title_line = f"{cls.DIM}┌{left_pad}{cls.BOLD}{color}{title}{cls.RESET}{cls.DIM}{right_pad}┐{cls.RESET}\n"
         
-        # 内容行
         lines = []
         for line in msg.split("\n"):
-            padding = (60 - len(line) - 4) // 2
-            left_pad = " " * padding
-            right_pad = " " * (60 - len(line) - padding - 4)
-            lines.append(f"{cls.DIM}║{cls.RESET}{left_pad}{line}{right_pad}{cls.DIM}║{cls.RESET}")
+            if len(line) > width - 4:
+                words = line.split()
+                current_line = ""
+                for word in words:
+                    if len(current_line) + len(word) + 1 > width - 4:
+                        lines.append(f"{cls.DIM}│{cls.RESET} {current_line.ljust(width-4)} {cls.DIM}│{cls.RESET}")
+                        current_line = word
+                    else:
+                        current_line += (" " + word) if current_line else word
+                if current_line:
+                    lines.append(f"{cls.DIM}│{cls.RESET} {current_line.ljust(width-4)} {cls.DIM}│{cls.RESET}")
+            else:
+                lines.append(f"{cls.DIM}│{cls.RESET} {line.ljust(width-4)} {cls.DIM}│{cls.RESET}")
         
-        # 底部边框
-        bottom_border = f"{cls.DIM}╚{border_char}╝{cls.RESET}"
+        if level == "error":
+            border_style = "╘"
+        elif level == "warning":
+            border_style = "╧"
+        else:
+            border_style = "└"
+        bottom_border = f"{cls.DIM}{border_style}{border_char}┘{cls.RESET}"
         
-        # 组合所有部分
-        panel = f"{title_line}{border_char}\n"
+        panel = f"{title_line}"
+        panel += f"{cls.DIM}├{border_char}┤{cls.RESET}\n"
         panel += "\n".join(lines) + "\n"
-        panel += f"{border_char}\n{bottom_border}\n"
+        panel += f"{bottom_border}\n"
         
         print(panel)
 
     @classmethod
     def table(cls, headers, rows, title=None, level="info") -> None:
-        """改进的表格输出，带有颜色和分隔线"""
         color = cls._get_color(level)
         if title:
             print(f"{cls.BOLD}{color}== {title} =={cls.RESET}")
         
-        # 计算列宽
         col_widths = [len(h) for h in headers]
         for row in rows:
             for i, cell in enumerate(row):
                 col_widths[i] = max(col_widths[i], len(str(cell)))
         
-        # 构建标题格式
         fmt = "│".join(f" {{:<{w}}} " for w in col_widths)
         
-        # 顶部边框
         top_border = "┌" + "┬".join("─" * (w+2) for w in col_widths) + "┐"
         print(f"{cls.DIM}{top_border}{cls.RESET}")
         
-        # 表头
         header_line = fmt.format(*headers)
         print(f"{cls.BOLD}{color}│{header_line}│{cls.RESET}")
         
-        # 表头分隔线
         separator = "├" + "┼".join("─" * (w+2) for w in col_widths) + "┤"
         print(f"{cls.DIM}{separator}{cls.RESET}")
         
-        # 表格内容
         for row in rows:
             row_line = fmt.format(*row)
             print(f"│{row_line}│")
         
-        # 底部边框
         bottom_border = "└" + "┴".join("─" * (w+2) for w in col_widths) + "┘"
         print(f"{cls.DIM}{bottom_border}{cls.RESET}")
 
     @classmethod
     def progress_bar(cls, current, total, prefix="", suffix="", length=50):
-        """显示进度条"""
         filled_length = int(length * current // total)
         percent = min(100.0, 100 * (current / float(total)))
         bar = f"{cls.GREEN}{'█' * filled_length}{cls.WHITE}{'░' * (length - filled_length)}{cls.RESET}"
@@ -130,7 +185,6 @@ class Shell_Printer:
 
     @classmethod
     def confirm(cls, msg, default=False) -> bool:
-        """带颜色和默认选择的确认对话框"""
         yes_options = {'y', 'yes'}
         no_options = {'n', 'no'}
         default_str = "Y/n" if default else "y/N"
@@ -148,7 +202,6 @@ class Shell_Printer:
 
     @classmethod
     def ask(cls, msg, choices=None, default=None) -> str | None:
-        """带颜色和选择的提问"""
         prompt = f"{cls.BOLD}{msg}{cls.RESET}"
         if choices:
             prompt += f" ({cls.CYAN}{'/'.join(choices)}{cls.RESET})"
@@ -166,7 +219,6 @@ class Shell_Printer:
 
     @classmethod
     def status(cls, msg, success=True):
-        """显示状态指示器"""
         symbol = f"{cls.GREEN}✓" if success else f"{cls.RED}✗"
         print(f"\r{symbol}{cls.RESET} {msg}")
 
@@ -179,10 +231,29 @@ class SourceManager:
     def _init_sources(self):
         if not env.get('origins'):
             env.set('origins', [])
+            
+            primary_source = "https://erisdev.com/map.json"
+            secondary_source = "https://raw.githubusercontent.com/ErisPulse/ErisPulse-ModuleRepo/refs/heads/main/map.json"
+            
+            shellprint.status("正在验证主源...")
+            validated_url = asyncio.run(self._validate_url(primary_source))
+            
+            if validated_url:
+                env.set('origins', [validated_url])
+                shellprint.status(f"主源 {validated_url} 已成功添加")
+            else:
+                if secondary_source not in env.get('origins', []):
+                    env.set('origins', [secondary_source])
+                    shellprint.panel(
+                        f"主源不可用，已添加备用源 {secondary_source}\n\n"
+                        f"{Shell_Printer.YELLOW}提示:{Shell_Printer.RESET} 建议尽快升级 ErisPulse SDK 版本",
+                        "源初始化", 
+                        "warning"
+                    )
 
     async def _validate_url(self, url):
         if not url.startswith(('http://', 'https://')):
-            protocol = shellprint.confirm("未指定协议，请输入使用的协议", choices=['http', 'https'], default="https")
+            protocol = shellprint.ask("未指定协议，请输入使用的协议", choices=['http', 'https'], default="https")
             url = f"{protocol}://{url}"
         if not url.endswith('.json'):
             url = f"{url}/map.json"
@@ -190,10 +261,12 @@ class SourceManager:
             async with aiohttp.ClientSession() as session:
                 async with session.get(url) as response:
                     response.raise_for_status()
-                    if response.headers.get('Content-Type', '').startswith('application/json'):
+                    try:
+                        content = await response.text()
+                        json.loads(content)
                         return url
-                    else:
-                        shellprint.panel(f"源 {url} 返回的内容不是有效的 JSON 格式", "错误", "error")
+                    except (ValueError, json.JSONDecodeError) as e:
+                        shellprint.panel(f"源 {url} 返回的内容不是有效的 JSON 格式: {e}", "错误", "error")
                         return None
         except Exception as e:
             shellprint.panel(f"访问源 {url} 失败: {e}", "错误", "error")
@@ -230,8 +303,9 @@ class SourceManager:
                     async with aiohttp.ClientSession() as session:
                         async with session.get(origin) as response:
                             response.raise_for_status()
-                            if response.headers.get('Content-Type', '').startswith('application/json'):
-                                content = await response.json()
+                            try:
+                                text = await response.text()
+                                content = json.loads(text)
                                 providers[content["name"]] = content["base"]
                                 for module in content["modules"].keys():
                                     module_content = content["modules"][module]
@@ -244,8 +318,8 @@ class SourceManager:
                                         module,
                                         f"{providers[content['name']]}{module_origin_name}"
                                     ])
-                            else:
-                                shellprint.panel(f"源 {origin} 返回的内容不是有效的 JSON 格式", "错误", "error")
+                            except (ValueError, json.JSONDecodeError) as e:
+                                shellprint.panel(f"源 {origin} 返回的内容不是有效的 JSON 格式: {e}", "错误", "error")
                 except Exception as e:
                     shellprint.panel(f"获取 {origin} 时出错: {e}", "错误", "error")
                     
@@ -1090,7 +1164,6 @@ def main():
         else:
             origin_parser.print_help()
     else:
-        # 如果没有提供命令，显示帮助信息
         parser.print_help()
 
 if __name__ == "__main__":

ErisPulse/adapter.py

@@ -1,3 +1,50 @@
+"""
+# 适配器系统
+
+提供平台适配器基类、消息发送DSL和适配器管理功能。
+
+## 主要功能
+- BaseAdapter: 适配器基类
+- SendDSL: 链式消息发送接口
+- AdapterManager: 适配器管理
+- 适配器注册和生命周期管理
+
+## API 文档
+### 适配器基类 (BaseAdapter):
+    - call_api(): 必须实现的API调用方法
+    - start(): 启动适配器
+    - shutdown(): 关闭适配器
+    - on(): 事件监听装饰器
+    - emit(): 触发事件
+
+### 消息发送DSL (SendDSL):
+    - To(): 设置消息目标
+    - Text(): 发送文本消息
+    - 可扩展其他消息类型
+
+### 适配器管理 (AdapterManager):
+    - register(): 注册适配器
+    - startup(): 启动适配器
+    - shutdown(): 关闭所有适配器
+    - get(): 获取适配器实例
+
+### 示例用法：
+
+```
+from ErisPulse import sdk
+
+# 注册适配器
+sdk.adapter.register("MyPlatform", MyAdapter)
+
+# 发送消息
+sdk.adapter.MyPlatform.Send.To("user", "123").Text("Hello")
+
+# 启动适配器
+await sdk.adapter.startup()
+```
+
+"""
+
 import functools
 import asyncio
 from typing import Callable, Any, Dict, List, Type, Optional, Set

ErisPulse/db.py

@@ -1,12 +1,75 @@
+"""
+# 环境配置
+
+提供键值存储、事务支持、快照和恢复功能，用于管理框架配置数据。
+
+## API 文档
+### 基本操作：
+    - get(key, default=None) -> any: 获取配置项
+    - set(key, value) -> bool: 设置配置项
+    - delete(key) -> bool: 删除配置项
+    - get_all_keys() -> list[str]: 获取所有键名
+
+### 批量操作：
+    - get_multi(keys) -> dict: 批量获取键值
+    - set_multi(items) -> bool: 批量设置键值
+    - delete_multi(keys) -> bool: 批量删除键值
+
+### 事务管理：
+    - transaction() -> contextmanager: 创建事务上下文
+
+### 快照管理：
+    - snapshot(name=None) -> str: 创建数据库快照
+    - restore(snapshot_name) -> bool: 从快照恢复
+    - list_snapshots() -> list: 列出所有快照
+    - delete_snapshot(name) -> bool: 删除指定快照
+    - set_snapshot_interval(seconds): 设置自动快照间隔
+
+### 其他功能：
+    - clear(): 清空所有配置
+    - load_env_file(): 从env.py加载配置(SDK自动)
+
+### 示例用法：
+
+```
+from ErisPulse import sdk
+
+env = sdk.env
+
+# 基本操作
+env.set('config_key', 'value')
+value = env.get('config_key')
+value_another = env.config_key  # 通过属性访问
+env.config_key = 'value'        # 通过属性赋值
+
+# 事务使用
+with env.transaction():
+    env.set('key1', 'value1')
+    env.set('key2', 'value2')
+    
+# 快照管理
+snapshot_path = env.snapshot()
+env.restore('snapshot_name')
+```
+
+"""
+
 import os
 import json
 import sqlite3
 import importlib.util
+import shutil
+import time
+import threading
 from pathlib import Path
+from datetime import datetime
+from functools import lru_cache
+from .raiserr import raiserr
 
 class EnvManager:
     _instance = None
     db_path = os.path.join(os.path.dirname(__file__), "config.db")
+    SNAPSHOT_DIR = os.path.join(os.path.dirname(__file__), "snapshots")
 
     def __new__(cls, *args, **kwargs):
         if not cls._instance:
@@ -15,12 +78,21 @@ class EnvManager:
 
     def __init__(self):
         if not hasattr(self, "_initialized"):
+            # 确保关键属性在初始化时都有默认值
+            self._last_snapshot_time = time.time()
+            self._snapshot_interval = 3600
             self._init_db()
             self._initialized = True
 
     def _init_db(self):
         os.makedirs(os.path.dirname(self.db_path), exist_ok=True)
+        os.makedirs(self.SNAPSHOT_DIR, exist_ok=True)
         conn = sqlite3.connect(self.db_path)
+        
+        # 启用WAL模式提高并发性能
+        conn.execute("PRAGMA journal_mode=WAL")
+        conn.execute("PRAGMA synchronous=NORMAL")
+        
         cursor = conn.cursor()
         cursor.execute("""
         CREATE TABLE IF NOT EXISTS config (
@@ -30,6 +102,10 @@ class EnvManager:
         """)
         conn.commit()
         conn.close()
+        
+        # 初始化自动快照调度器
+        self._last_snapshot_time = time.time()  # 初始化为当前时间
+        self._snapshot_interval = 3600  # 默认每小时自动快照
 
     def get(self, key, default=None):
         try:
@@ -59,18 +135,128 @@ class EnvManager:
 
     def set(self, key, value):
         serialized_value = json.dumps(value) if isinstance(value, (dict, list)) else str(value)
-        conn = sqlite3.connect(self.db_path)
-        cursor = conn.cursor()
-        cursor.execute("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)", (key, serialized_value))
-        conn.commit()
-        conn.close()
+        with self.transaction():
+            conn = sqlite3.connect(self.db_path)
+            cursor = conn.cursor()
+            cursor.execute("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)", (key, serialized_value))
+            conn.commit()
+            conn.close()
+        
+        self._check_auto_snapshot()
+        return True
+
+    def set_multi(self, items):
+        with self.transaction():
+            conn = sqlite3.connect(self.db_path)
+            cursor = conn.cursor()
+            for key, value in items.items():
+                serialized_value = json.dumps(value) if isinstance(value, (dict, list)) else str(value)
+                cursor.execute("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)", 
+                    (key, serialized_value))
+            conn.commit()
+            conn.close()
+        
+        self._check_auto_snapshot()
+        return True
 
     def delete(self, key):
+        with self.transaction():
+            conn = sqlite3.connect(self.db_path)
+            cursor = conn.cursor()
+            cursor.execute("DELETE FROM config WHERE key = ?", (key,))
+            conn.commit()
+            conn.close()
+        
+        self._check_auto_snapshot()
+        return True
+
+    def delete_multi(self, keys):
+        with self.transaction():
+            conn = sqlite3.connect(self.db_path)
+            cursor = conn.cursor()
+            cursor.executemany("DELETE FROM config WHERE key = ?", [(k,) for k in keys])
+            conn.commit()
+            conn.close()
+        
+        self._check_auto_snapshot()
+        return True
+
+    def get_multi(self, keys):
         conn = sqlite3.connect(self.db_path)
         cursor = conn.cursor()
-        cursor.execute("DELETE FROM config WHERE key = ?", (key,))
-        conn.commit()
+        placeholders = ','.join(['?'] * len(keys))
+        cursor.execute(f"SELECT key, value FROM config WHERE key IN ({placeholders})", keys)
+        results = {row[0]: json.loads(row[1]) if row[1].startswith(('{', '[')) else row[1] 
+                    for row in cursor.fetchall()}
         conn.close()
+        return results
+
+    def transaction(self):
+        return self._Transaction(self)
+
+    class _Transaction:
+        def __init__(self, env_manager):
+            self.env_manager = env_manager
+            self.conn = None
+            self.cursor = None
+
+        def __enter__(self):
+            self.conn = sqlite3.connect(self.env_manager.db_path)
+            self.cursor = self.conn.cursor()
+            self.cursor.execute("BEGIN TRANSACTION")
+            return self
+
+        def __exit__(self, exc_type, exc_val, exc_tb):
+            if exc_type is None:
+                self.conn.commit()
+            else:
+                self.conn.rollback()
+                from .logger import logger
+                logger.error(f"事务执行失败: {exc_val}")
+            self.conn.close()
+
+    def _check_auto_snapshot(self):
+        from .logger import logger
+        
+        if not hasattr(self, '_last_snapshot_time') or self._last_snapshot_time is None:
+            self._last_snapshot_time = time.time()
+            
+        if not hasattr(self, '_snapshot_interval') or self._snapshot_interval is None:
+            self._snapshot_interval = 3600
+            
+        current_time = time.time()
+        
+        try:
+            time_diff = current_time - self._last_snapshot_time
+            if not isinstance(time_diff, (int, float)):
+                raiserr.register(
+                    "ErisPulseEnvTimeDiffTypeError",
+                    doc = "时间差应为数值类型",
+                )
+                raiserr.ErisPulseEnvTimeDiffTypeError(
+                    f"时间差应为数值类型，实际为: {type(time_diff)}"
+                )
+
+            if not isinstance(self._snapshot_interval, (int, float)):
+                raiserr.register(
+                    "ErisPulseEnvSnapshotIntervalTypeError",
+                    doc = "快照间隔应为数值类型",
+                )
+                raiserr.ErisPulseEnvSnapshotIntervalTypeError(
+                    f"快照间隔应为数值类型，实际为: {type(self._snapshot_interval)}"
+                )
+                
+            if time_diff > self._snapshot_interval:
+                self._last_snapshot_time = current_time
+                self.snapshot(f"auto_{datetime.now().strftime('%Y%m%d_%H%M%S')}")
+                
+        except Exception as e:
+            logger.error(f"自动快照检查失败: {e}")
+            self._last_snapshot_time = current_time
+            self._snapshot_interval = 3600
+
+    def set_snapshot_interval(self, seconds):
+        self._snapshot_interval = seconds
 
     def clear(self):
         conn = sqlite3.connect(self.db_path)
@@ -127,4 +313,99 @@ from ErisPulse import sdk
             from .logger import logger
             logger.error(f"配置项 {key} 不存在")
 
-env = EnvManager()
+    def __setattr__(self, key, value):
+        try:
+            self.set(key, value)
+        except Exception as e:
+            from .logger import logger
+            logger.error(f"设置配置项 {key} 失败: {e}")
+
+    def snapshot(self, name=None):
+        if not name:
+            name = datetime.now().strftime("%Y%m%d_%H%M%S")
+        snapshot_path = os.path.join(self.SNAPSHOT_DIR, f"{name}.db")
+        
+        try:
+            # 快照目录
+            os.makedirs(self.SNAPSHOT_DIR, exist_ok=True)
+            
+            # 安全关闭连接
+            if hasattr(self, "_conn") and self._conn is not None:
+                try:
+                    self._conn.close()
+                except Exception as e:
+                    from .logger import logger
+                    logger.warning(f"关闭数据库连接时出错: {e}")
+            
+            # 创建快照
+            shutil.copy2(self.db_path, snapshot_path)
+            from .logger import logger
+            logger.info(f"数据库快照已创建: {snapshot_path}")
+            return snapshot_path
+        except Exception as e:
+            from .logger import logger
+            logger.error(f"创建快照失败: {e}")
+            raise
+
+    def restore(self, snapshot_name):
+        snapshot_path = os.path.join(self.SNAPSHOT_DIR, f"{snapshot_name}.db") \
+            if not snapshot_name.endswith('.db') else snapshot_name
+            
+        if not os.path.exists(snapshot_path):
+            from .logger import logger
+            logger.error(f"快照文件不存在: {snapshot_path}")
+            return False
+            
+        try:
+            # 安全关闭连接
+            if hasattr(self, "_conn") and self._conn is not None:
+                try:
+                    self._conn.close()
+                except Exception as e:
+                    from .logger import logger
+                    logger.warning(f"关闭数据库连接时出错: {e}")
+            
+            # 执行恢复操作
+            shutil.copy2(snapshot_path, self.db_path)
+            self._init_db()  # 恢复后重新初始化数据库连接
+            from .logger import logger
+            logger.info(f"数据库已从快照恢复: {snapshot_path}")
+            return True
+        except Exception as e:
+            from .logger import logger
+            logger.error(f"恢复快照失败: {e}")
+            return False
+
+    def list_snapshots(self):
+        snapshots = []
+        for f in os.listdir(self.SNAPSHOT_DIR):
+            if f.endswith('.db'):
+                path = os.path.join(self.SNAPSHOT_DIR, f)
+                stat = os.stat(path)
+                snapshots.append((
+                    f[:-3],  # 去掉.db后缀
+                    datetime.fromtimestamp(stat.st_ctime),
+                    stat.st_size
+                ))
+        return sorted(snapshots, key=lambda x: x[1], reverse=True)
+
+    def delete_snapshot(self, snapshot_name):
+        snapshot_path = os.path.join(self.SNAPSHOT_DIR, f"{snapshot_name}.db") \
+            if not snapshot_name.endswith('.db') else snapshot_name
+            
+        if not os.path.exists(snapshot_path):
+            from .logger import logger
+            logger.error(f"快照文件不存在: {snapshot_path}")
+            return False
+            
+        try:
+            os.remove(snapshot_path)
+            from .logger import logger
+            logger.info(f"快照已删除: {snapshot_path}")
+            return True
+        except Exception as e:
+            from .logger import logger
+            logger.error(f"删除快照失败: {e}")
+            return False
+
+env = EnvManager()

ErisPulse/logger.py

@@ -1,3 +1,49 @@
+"""
+# 日志系统
+
+提供模块化、多级别的日志记录功能，支持内存存储和文件输出。
+
+## API 文档
+### 基本操作：
+    - debug(msg, *args, **kwargs):      调试信息
+    - info(msg, *args, **kwargs):       运行信息  
+    - warning(msg, *args, **kwargs):    警告信息
+    - error(msg, *args, **kwargs):      错误信息
+    - critical(msg, *args, **kwargs):   致命错误并终止程序
+
+### 日志控制：
+    - set_level(level):                     设置全局日志级别
+    - set_module_level(module_name, level): 设置模块日志级别
+
+### 日志存储：
+    - save_logs(path):          保存内存中的日志到文件
+    - set_output_file(path):    设置日志输出文件
+
+### 示例用法：
+
+```
+from ErisPulse import sdk
+
+# 基本日志记录
+sdk.logger.debug("调试信息")
+sdk.logger.info("运行状态")
+
+# 模块级日志控制
+sdk.logger.set_module_level("MyModule", "DEBUG")
+
+# 异常捕获
+@sdk.logger.catch
+def risky_function():
+    raise Exception("出错了")
+```
+
+## 准备弃用
+
+catch(func_or_level=None, level="error"): 异常捕获装饰器
+- 原因: 异常捕获功能已集成到 raiserr 模块中，建议使用 raiserr 进行异常处理。
+
+"""
+
 import logging
 import inspect
 import datetime
@@ -152,4 +198,4 @@ class Logger:
             raiserr.register("CriticalError", doc="发生致命错误")
             raiserr.CriticalError(f"程序发生致命错误：{msg}", exit=True)
 
-logger = Logger()
+logger = Logger()

ErisPulse/mods.py

@@ -1,3 +1,41 @@
+"""
+# 模块管理系统
+
+提供模块的注册、状态管理和依赖解析功能。
+
+## API 文档
+### 模块状态：
+    - set_module_status(module_name, status):   设置模块启用状态
+    - get_module_status(module_name):           获取模块状态
+
+### 模块信息：
+    - set_module(module_name, module_info): 设置模块信息
+    - get_module(module_name):              获取模块信息
+    - get_all_modules():                    获取所有模块信息
+    - remove_module(module_name):           删除模块
+
+### 前缀管理：
+    - update_prefixes(module_prefix, status_prefix): 更新存储前缀
+    - module_prefix: 模块存储前缀属性
+    - status_prefix: 状态存储前缀属性
+
+### 示例用法：
+
+```
+from ErisPulse import sdk
+
+# 设置模块状态
+sdk.mods.set_module_status("MyModule", True)
+
+# 获取模块信息
+module_info = sdk.mods.get_module("MyModule")
+
+# 批量操作
+sdk.mods.set_all_modules({"Module1": {...}, "Module2": {...}})
+```
+
+"""
+
 import json
 from typing import Dict, Optional
 

ErisPulse/raiserr.py

@@ -1,3 +1,38 @@
+"""
+# 错误管理系统
+
+提供错误类型注册、抛出和管理功能，集成全局异常处理。
+
+## API 文档
+### 错误注册：
+    - register(name, doc="", base=Exception): 注册新的错误类型
+    - info(name: str = None): 获取错误类型信息
+
+### 错误抛出：
+    - __getattr__(name): 动态获取错误抛出函数
+    - ErrorType(msg, exit=False): 抛出注册的错误类型
+
+### 全局处理：
+    - global_exception_handler: 全局同步异常处理器
+    - async_exception_handler: 全局异步异常处理器
+
+### 示例用法：
+
+```
+from ErisPulse import sdk
+
+# 注册自定义错误
+sdk.raiserr.register("MyError", doc="自定义错误描述")
+
+# 抛出错误
+sdk.raiserr.MyError("发生了错误", exit=False)
+
+# 获取错误信息
+error_info = sdk.raiserr.info("MyError")
+```
+
+"""
+
 import sys
 import traceback
 import asyncio
@@ -71,4 +106,4 @@ def async_exception_handler(loop, context):
         )
     else:
         logger.warning(f"异步任务警告: {message}")
-asyncio.get_event_loop().set_exception_handler(async_exception_handler)
+asyncio.get_event_loop().set_exception_handler(async_exception_handler)

ErisPulse/util.py

@@ -1,3 +1,47 @@
+"""
+# 工具函数集合
+
+提供各种实用工具函数和装饰器，简化开发流程。
+
+## API 文档
+### 拓扑排序：
+    - topological_sort(elements, dependencies, error): 拓扑排序依赖关系
+    - show_topology(): 可视化模块依赖关系
+
+### 装饰器：
+    - @cache: 缓存函数结果
+    - @run_in_executor: 将同步函数转为异步
+    - @retry(max_attempts=3, delay=1): 失败自动重试
+
+### 异步执行：
+    - ExecAsync(async_func, *args, **kwargs): 异步执行函数
+
+### 示例用法：
+
+```
+from ErisPulse import sdk
+
+# 拓扑排序
+sorted_modules = sdk.util.topological_sort(modules, dependencies, error)
+
+# 缓存装饰器
+@sdk.util.cache
+def expensive_operation(param):
+    return heavy_computation(param)
+    
+# 异步执行
+@sdk.util.run_in_executor
+def sync_task():
+    pass
+    
+# 重试机制
+@sdk.util.retry(max_attempts=3, delay=1)
+def unreliable_operation():
+    pass
+```
+
+"""
+
 import time
 import asyncio
 import functools
@@ -96,4 +140,4 @@ def retry(max_attempts=3, delay=1):
                         raise
                     time.sleep(delay)
         return wrapper
-    return decorator
+    return decorator

erispulse-1.1.14.dev1.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: ErisPulse
+Version: 1.1.14.dev1
+Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
+Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 ErisPulse
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: aiohttp
+Requires-Dist: watchdog
+Description-Content-Type: text/markdown
+
+![](./.github/assets/erispulse_logo.png)
+**ErisPulse** 是基于 [Framer](https://github.com/FramerOrg/Framer) 构建的异步机器人开发框架。
+
+[![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
+[![License](https://img.shields.io/github/license/ErisPulse/ErisPulse?style=flat-square)](https://github.com/ErisPulse/ErisPulse/blob/main/LICENSE)
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
+
+> 文档站:
+
+[![Docs-Main](https://img.shields.io/badge/docs-main_site-blue?style=flat-square)](https://www.erisdev.com/docs.html)
+[![Docs-CF Pages](https://img.shields.io/badge/docs-cloudflare-blue?style=flat-square)](https://erispulse.pages.dev/docs.html)
+[![Docs-GitHub](https://img.shields.io/badge/docs-github-blue?style=flat-square)](https://erispulse.github.io/docs.html)
+[![Docs-Netlify](https://img.shields.io/badge/docs-netlify-blue?style=flat-square)](https://erispulse.netlify.app/docs.htm)
+
+- [GitHub 社区讨论](https://github.com/ErisPulse/ErisPulse/discussions)
+
+### 框架选型指南
+| 需求          | 推荐框架       | 理由                          |
+|-------------------|----------------|-----------------------------|
+| 轻量化/底层模块化 | [Framer](https://github.com/FramerOrg/Framer) | 高度解耦的模块化设计          |
+| 全功能机器人开发  | ErisPulse      | 开箱即用的完整解决方案        |
+
+## ✨ 核心特性
+- ⚡ 完全异步架构设计（async/await）
+- 🧩 模块化插件系统
+- 🔁 支持python热重载
+- 🛑 统一的错误管理
+- 🛠️ 灵活的配置管理
+
+## 📦 安装
+
+```bash
+pip install ErisPulse --upgrade
+```
+
+---
+
+## 开发者快速入门
+
+ErisPulse SDK 支持使用 [`uv`](https://github.com/astral-sh/uv) 进行完整的开发环境管理。你可以**无需手动安装 Python**，直接通过 `uv` 下载 Python、创建虚拟环境并开始开发。
+
+### 安装 `uv`
+
+#### macOS / Linux:
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+#### Windows (PowerShell):
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+验证是否安装成功：
+```bash
+uv --version
+```
+
+### 克隆项目并进入目录
+
+```bash
+git clone https://github.com/ErisPulse/ErisPulse.git
+cd ErisPulse
+```
+
+### 使用 `uv` 自动下载 Python 并创建虚拟环境
+
+```bash
+uv python install 3.12          # 自动下载并安装 Python 3.12
+uv venv                         # 创建默认 .venv 虚拟环境
+source .venv/bin/activate    
+# Windows: .venv\Scripts\activate
+```
+
+> ✅ 如果你切换分支或需要不同 Python 版本，只需替换 `3.12` 为其他版本即可。
+
+### 安装依赖并开始开发
+
+```bash
+uv pip install -e .
+```
+
+这将以“开发模式”安装 SDK，所有本地修改都会立即生效。
+
+### 验证安装
+
+运行以下命令确认 SDK 正常加载：
+
+```bash
+python -c "from ErisPulse import sdk; sdk.init()"
+```
+
+### 运行测试
+
+我们提供了一个交互式测试脚本，可以帮助您快速验证SDK功能：
+
+```bash
+uv run devs/test.py
+```
+
+测试脚本提供以下功能：
+- 日志功能测试
+- 环境配置测试  
+- 错误管理测试
+- 工具函数测试
+- 适配器功能测试
+- 版本信息查看
+
+### 开始开发
+
+你可以通过 CLI 工具进行模块调试、热重载开发等操作：
+
+```bash
+epsdk run your_script.py --reload
+```
+
+---
+
+## 🤝 贡献
+
+欢迎任何形式的贡献！无论是报告 bug、提出新功能请求，还是直接提交代码，都非常感谢。

erispulse-1.1.14.dev1.dist-info/RECORD

@@ -0,0 +1,13 @@
+ErisPulse/__init__.py,sha256=k-X8WV9sIrYeYDNb8qZyBZ8s8yNL2bKWhZdkPbzRWII,8936
+ErisPulse/__main__.py,sha256=aZK7FdvFTgsKgHPYpaeKpA_l2JFhEy9TNy3vndkONFk,50001
+ErisPulse/adapter.py,sha256=g5npw-RAmGKXY3gTO8oNA63DRJ3Z9xVrl9BWuus-EQs,9837
+ErisPulse/db.py,sha256=rXxpTug5NMZQTJ_07lJTe-PWdoePNPAkYoQDfazFapY,14411
+ErisPulse/logger.py,sha256=832gGOiRUfXhYjz9JZ3DfVzB6ttqIimyLU0xk5k7lZ0,7319
+ErisPulse/mods.py,sha256=lBCWM0VfsCJehnMgpswKYuHitg30JERg0H4WN6kqgbA,4509
+ErisPulse/raiserr.py,sha256=2dJA3g6aje4yxhr1JPeZsrxudblKAOq6T_LMHeRjQ24,3438
+ErisPulse/util.py,sha256=tmmZA4Ef5ElB01KZg2fTZLrkZOJbORjnkAd8sXj7xqw,4335
+erispulse-1.1.14.dev1.dist-info/METADATA,sha256=I03H-qlpVtNAxuX_H60HgnTaMqLrKGpPfe5zIq9EhfE,5882
+erispulse-1.1.14.dev1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+erispulse-1.1.14.dev1.dist-info/entry_points.txt,sha256=AjKvOdYR7QGXVpEJhjUYUwV2JluE4lm9vNbknC3hjOM,155
+erispulse-1.1.14.dev1.dist-info/licenses/LICENSE,sha256=plj4EYVfKAzc0ZWoC5T2vsQ86u0yLpu17NdAPeIcgVo,1066
+erispulse-1.1.14.dev1.dist-info/RECORD,,

{erispulse-1.1.12.dist-info → erispulse-1.1.14.dev1.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

erispulse-1.1.12.dist-info/METADATA

@@ -1,79 +0,0 @@
-Metadata-Version: 2.4
-Name: ErisPulse
-Version: 1.1.12
-Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
-Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp
-Requires-Dist: watchdog
-Dynamic: license-file
-
-![](./.github/assets/erispulse_logo.png)
-**ErisPulse** 是基于 [Framer](https://github.com/FramerOrg/Framer) 构建的异步机器人开发框架。
-
-## 合作伙伴
-[![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
-
-### 框架选型指南
-| 需求          | 推荐框架       | 理由                          |
-|-------------------|----------------|-----------------------------|
-| 轻量化/底层模块化 | [Framer](https://github.com/FramerOrg/Framer) | 高度解耦的模块化设计          |
-| 全功能机器人开发  | ErisPulse      | 开箱即用的完整解决方案        |
-
-
-## ✨ 核心特性
-- ⚡ 完全异步架构设计（async/await）
-- 🧩 模块化插件系统
-- 📜 内置日志系统
-- 🛑 统一的错误管理
-- 🛠️ 灵活的配置管理
-
-## 📦 安装
-
-```bash
-pip install ErisPulse --upgrade
-```
-
-**要求**：Python ≥ 3.7，pip ≥ 20.0
-
-## 🚀 快速开始
-
-```python
-import asyncio
-from ErisPulse import sdk, logger
-
-async def main():
-    sdk.init()
-    logger.info("ErisPulse 已启动")
-    # 这里可以添加自定义逻辑
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## 导航
-- [开发者指南](docs/DEVELOPMENT.md)
-- [底层方法与接口](docs/REFERENCE.md)
-- [命令行工具](docs/CLI.md)
-- [源配置指南](docs/ORIGIN.md)
-- [更新日志](docs/CHANGELOG.md)
-> [GitHub 社区](https://github.com/ErisPulse/ErisPulse/discussions)
-
-## 🤝 贡献
-
-欢迎任何形式的贡献！无论是报告 bug、提出新功能请求，还是直接提交代码，都非常感谢。

erispulse-1.1.12.dist-info/RECORD

@@ -1,14 +0,0 @@
-ErisPulse/__init__.py,sha256=tCgjl-0rUeiHV_2rdFlQ-CVTFzbKdjdqXvUApRc6Avk,8095
-ErisPulse/__main__.py,sha256=ZdrOqsZU1C5wJ4CycTge9l7IUldVUDtak17yWRxnxhs,47728
-ErisPulse/adapter.py,sha256=5ntqm5Xrzdi1F6N4kWhqiRzMavSO92Fj9WZ-d3-V2VM,8798
-ErisPulse/db.py,sha256=DuIc19GbCQMi17BWfLjaDHnthIbdysTSRxaYVFur07w,4424
-ErisPulse/logger.py,sha256=sMA1mUZvwJ8wHwdyCrgIf_VRICv_uBCkx3tmd1stF3E,6094
-ErisPulse/mods.py,sha256=lNiZP2EcfUhYRnOQwROyVnmhsfmk8JAZhmbhxfC2-VQ,3513
-ErisPulse/raiserr.py,sha256=z8BigWkVrBE9dD_dJa5np2YYREwdugyWXKE4_-LEO_Q,2616
-ErisPulse/util.py,sha256=ux3-QRT0_JjabL6S9KChhyR1E_CSRiVYEFYV5txML1M,3406
-erispulse-1.1.12.dist-info/licenses/LICENSE,sha256=plj4EYVfKAzc0ZWoC5T2vsQ86u0yLpu17NdAPeIcgVo,1066
-erispulse-1.1.12.dist-info/METADATA,sha256=BDRDFwkbWqz7WsebH1cKCbyLaCPBPumDkwFiMG2LJq4,2751
-erispulse-1.1.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-erispulse-1.1.12.dist-info/entry_points.txt,sha256=AjKvOdYR7QGXVpEJhjUYUwV2JluE4lm9vNbknC3hjOM,155
-erispulse-1.1.12.dist-info/top_level.txt,sha256=Lm_qtkVvNJR8_dXh_qEDdl_12cZGpic-i4HUlVVUMZc,10
-erispulse-1.1.12.dist-info/RECORD,,

erispulse-1.1.12.dist-info/top_level.txt

@@ -1 +0,0 @@
-ErisPulse