🐱 SenSu

一个功能强大的Python后端框架，具有插件化架构和丰富的功能集。

✨ 特性

• 🎨 TUI界面: 基于Textual的终端用户界面
• 📝 强大日志系统: 多输出、文件切割、实时日志流
• 🔌 插件化架构: 热加载、权限管理、插件隔离
• 🌐 网络服务: WebSocket、HTTP API、反向代理
• 🔐 认证系统: 用户认证、令牌管理、权限验证
• 🔄 消息桥接: 模块间通信、插件间通信
• ⚡ 高性能: 异步架构、协程支持
• 🛡️ 安全: 权限验证、输入验证、错误隔离

🚀 快速开始

安装依赖

pip install -r requirements.txt

运行框架

python main.py

基本命令

在TUI底部输入框中输入命令：

• help - 显示帮助信息
• status - 显示框架状态
• history - 显示命令历史

📁 项目结构

project_root/
├── main.py                 # 框架主入口
├── service_manager.py      # 服务管理器
├── requirements.txt        # 依赖包列表
├── README.md              # 项目说明
│
├── config/                # 运行时生成的配置文件
│   ├── framework/         # 框架核心配置
│   ├── plugins/           # 插件配置
│   ├── services/          # 服务配置
│   └── permissions/       # 权限配置
│
├── logs/                  # 日志文件目录
│   ├── debug/             # debug级别日志
│   └── runtime/           # 运行时日志
│
├── services/              # 核心服务模块
│   ├── init_service.py    # 初始化服务
│   ├── log_service.py     # 日志服务
│   ├── tui_service.py     # TUI服务
│   ├── command_service.py # 指令服务
│   ├── auth_service.py    # 认证服务
│   ├── internet_service.py # 互联网服务
│   ├── plugin_service.py  # 插件服务
│   ├── permission_service.py # 权限服务
│   ├── api_service.py     # API服务
│   └── shutdown_service.py # 关闭服务
│
├── bridges/               # 桥接模块
│   ├── core_bridge.py     # 核心桥接
│   └── plugin_bridge.py   # 插件桥接
│
├── core/               # 框架功能集
│   ├── file_utils.py      # 文件操作工具
│   ├── config_utils.py    # 配置工具
│   ├── validation_utils.py # 验证工具
│   ├── network_utils.py   # 网络工具
│   └── plugin_utils.py    # 插件工具
│
├── plugins/               # 插件目录
│   └── example_plugin/    # 示例插件
│
└── gui/                   # GUI接口
    └── api.py             # GUI操作接口

🔌 插件开发

创建插件

1. 在 plugins/ 目录下创建插件文件夹
2. 创建必要的配置文件：
   • __init__.py - 插件主模块
   • config.yaml - 插件配置
   • permissions.yaml - 权限申请

插件示例

参考 plugins/example_plugin/ 目录中的示例插件。

🔧 配置说明

框架配置位于 config/framework/ 目录：

• base_config.yaml - 基础框架配置
• permission_rules.yaml - 权限规则配置

📡 API接口

框架提供以下API接口：

• WebSocket服务: ws://localhost:8765
• HTTP API服务: http://localhost:8000
• GUI API服务: http://localhost:8080

🐛 问题排查

查看 logs/ 目录中的日志文件获取详细错误信息。

📄 许可证

Apache License 2.0

🤝 贡献

欢迎提交Issue和Pull Request！

这个完整的Python后端框架包含了这些功能：

- ✅ TUI渲染界面（三部分布局）
- ✅ 强大的日志处理模块
- ✅ 初始化系统和指令模块
- ✅ 核心桥接和插件桥接
- ✅ 互联网模块集（WebSocket、HTTP API）
- ✅ 插件管理器（热加载、错误隔离）
- ✅ 权限管理器（权限申请和验证）
- ✅ API管理器
- ✅ 优雅的关闭方法
- ✅ 丰富的debug日志
- ✅ GUI API接口
- ✅ 清晰的目录结构

每个文件都有完整的错误处理和详细的日志记录 可以直接运行 `python main.py` 来启动框架