From 2bc00f8207b4f7ad4e4f535693428f9322a883e2 Mon Sep 17 00:00:00 2001 From: AskaEth Date: Wed, 10 Jun 2026 18:17:21 +0800 Subject: [PATCH] Rename fmfuncs -> core (cleaner, semantic) --- README.md | 2 +- {fmfuncs => core}/plugin_command_decorator.py | 0 {fmfuncs => core}/plugin_error.py | 0 {fmfuncs => core}/plugin_status.py | 0 docs/SenSu 插件开发详细指南.md | 6 +++--- docs/SenSu 框架基本架构.md | 8 ++++---- plugins/example_plugin/__init__.py | 2 +- services/plugin_service.py | 6 +++--- tests/test_plugin_enhancements.py | 4 ++-- 9 files changed, 14 insertions(+), 14 deletions(-) rename {fmfuncs => core}/plugin_command_decorator.py (100%) rename {fmfuncs => core}/plugin_error.py (100%) rename {fmfuncs => core}/plugin_status.py (100%) diff --git a/README.md b/README.md index 31c7a15..1c96748 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ project_root/ │ ├── core_bridge.py # 核心桥接 │ └── plugin_bridge.py # 插件桥接 │ -├── fmfuncs/ # 框架功能集 +├── core/ # 框架功能集 │ ├── file_utils.py # 文件操作工具 │ ├── config_utils.py # 配置工具 │ ├── validation_utils.py # 验证工具 diff --git a/fmfuncs/plugin_command_decorator.py b/core/plugin_command_decorator.py similarity index 100% rename from fmfuncs/plugin_command_decorator.py rename to core/plugin_command_decorator.py diff --git a/fmfuncs/plugin_error.py b/core/plugin_error.py similarity index 100% rename from fmfuncs/plugin_error.py rename to core/plugin_error.py diff --git a/fmfuncs/plugin_status.py b/core/plugin_status.py similarity index 100% rename from fmfuncs/plugin_status.py rename to core/plugin_status.py diff --git a/docs/SenSu 插件开发详细指南.md b/docs/SenSu 插件开发详细指南.md index 2a86732..ce5bc3e 100644 --- a/docs/SenSu 插件开发详细指南.md +++ b/docs/SenSu 插件开发详细指南.md @@ -542,7 +542,7 @@ import traceback # 导入框架装饰器 try: - from fmfuncs.plugin_command_decorator import plugin_command, command + from core.plugin_command_decorator import plugin_command, command except ImportError: # 回退方案 - 本地定义装饰器 def plugin_command(name=None, description=None, permissions=None): @@ -5083,7 +5083,7 @@ logger.error("错误信息", exc_info=True) ### 9.1 PluginStatus 状态枚举 ```python -from fmfuncs.plugin_status import PluginStatus +from core.plugin_status import PluginStatus # 插件生命周期状态 PluginStatus.UNLOADED # "unloaded" @@ -5100,7 +5100,7 @@ PluginStatus.STOPPED # "stopped" ### 9.2 PluginError 异常层级 ```python -from fmfuncs.plugin_error import ( +from core.plugin_error import ( PluginError, # 基础异常 PluginLoadError, # 加载失败 PluginConfigError, # 配置错误 diff --git a/docs/SenSu 框架基本架构.md b/docs/SenSu 框架基本架构.md index 7e51f3a..c2642a2 100644 --- a/docs/SenSu 框架基本架构.md +++ b/docs/SenSu 框架基本架构.md @@ -59,7 +59,7 @@ SenSu-Alpha0.2/ │ ├── api_service.py # API端点管理 │ └── shutdown_service.py # 优雅关闭 │ -├── fmfuncs/ # 框架功能集（工具函数） +├── core/ # 框架功能集（工具函数） │ └── plugin_command_decorator.py # 插件命令装饰器 │ ├── utils/ # 通用工具类 @@ -253,7 +253,7 @@ features: 框架提供了`@plugin_command`装饰器： ```python -from fmfuncs.plugin_command_decorator import plugin_command +from core.plugin_command_decorator import plugin_command @plugin_command(name="echo", description="回显消息") async def cmd_echo(self, *args): @@ -400,12 +400,12 @@ SenSu框架是一个设计精良、功能完整的Python后端框架，具有以 ## 九、v0.2.1 新增：插件系统增强 -### 9.1 PluginStatus 枚举 (`fmfuncs/plugin_status.py`) +### 9.1 PluginStatus 枚举 (`core/plugin_status.py`) 统一的插件生命周期状态： - `UNLOADED` → `LOADING` → `LOADED` → `INITIALIZING` → `RUNNING` - 异常路径: `ERROR`, `STOPPING`, `STOPPED`, `UNLOADING` -### 9.2 PluginError 异常层级 (`fmfuncs/plugin_error.py`) +### 9.2 PluginError 异常层级 (`core/plugin_error.py`) ``` PluginError (基础) ├── PluginLoadError (加载失败) diff --git a/plugins/example_plugin/__init__.py b/plugins/example_plugin/__init__.py index c32ed9a..8d41b6c 100644 --- a/plugins/example_plugin/__init__.py +++ b/plugins/example_plugin/__init__.py @@ -9,7 +9,7 @@ import json # 导入命令装饰器 try: - from fmfuncs.plugin_command_decorator import plugin_command, command + from core.plugin_command_decorator import plugin_command, command except ImportError: # 回退方案 def plugin_command(name=None, description=None, permissions=None): diff --git a/services/plugin_service.py b/services/plugin_service.py index 781e512..bb231dd 100644 --- a/services/plugin_service.py +++ b/services/plugin_service.py @@ -11,9 +11,9 @@ from typing import Dict, List, Any, Optional, Callable from dataclasses import dataclass import yaml import traceback -from fmfuncs.plugin_command_decorator import plugin_command, command -from fmfuncs.plugin_status import PluginStatus -from fmfuncs.plugin_error import PluginConfigError, PluginLoadError +from core.plugin_command_decorator import plugin_command, command +from core.plugin_status import PluginStatus +from core.plugin_error import PluginConfigError, PluginLoadError logger = logging.getLogger(__name__) diff --git a/tests/test_plugin_enhancements.py b/tests/test_plugin_enhancements.py index 3b64ceb..e9e030c 100644 --- a/tests/test_plugin_enhancements.py +++ b/tests/test_plugin_enhancements.py @@ -2,8 +2,8 @@ import pytest, asyncio, os, sys sys.path.insert(0, os.path.dirname(os.path.dirname(__file__))) -from fmfuncs.plugin_status import PluginStatus -from fmfuncs.plugin_error import ( +from core.plugin_status import PluginStatus +from core.plugin_error import ( PluginError, PluginLoadError, PluginConfigError, PluginPermissionError, PluginCommandError )