docs: 更新README+架构文档 反映v0.6.0文件管理器/WS推送/WebUI重构
- README: 新增文件管理器特性/Web面板路由/架构更新 - 框架架构文档: 新增第十章 v0.6.0 WebUI重构+文件管理器+WS推送+MD3主题 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -11,28 +11,29 @@
|
||||
|
||||
- 🎨 **Textual TUI** — 系统监控面板 + 命令补全 + CLI 回退
|
||||
- 🔌 **插件系统** — 热加载、权限隔离、依赖解析、进程隔离
|
||||
- 📁 **文件管理器** — 全文件系统浏览、编辑、上传、右键菜单,Windows/Linux/macOS 兼容
|
||||
- 🗄️ **项目引擎** — 接管任何 Python/命令行项目 (subprocess + 日志 + stdin)
|
||||
- 🔀 **反向代理** — HTTP/WS 代理,本地/局域网/公网端口映射
|
||||
- 📊 **SQLite 持久化** — 插件状态、权限、审计日志统一存储
|
||||
- 🌐 **Web 管理面板** — aiohttp + SSE,项目管理/代理/插件控制页
|
||||
- 🌐 **Web 管理面板** — aiohttp MD3 WebUI,日夜主题切换,WebSocket 实时推送
|
||||
- 🔐 **安全认证** — PBKDF2-SHA256、环境变量密码
|
||||
- 🐳 **Docker 部署** — Alpine 镜像,systemd 服务文件
|
||||
- 🧪 **28 个回归测试** — pytest,零失败
|
||||
- 🛠️ **插件 SDK** — 命令装饰器 + Web 面板 + API + SSE 推送
|
||||
- 🛠️ **插件 SDK** — 命令装饰器 + Web 面板 + API + SSE 推送 + 文件选择器
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
python main.py # TUI 模式
|
||||
python main.py --headless # 后台模式
|
||||
python main.py --headless # 后台模式 (Web 面板 :4200)
|
||||
python -m pytest tests/ -v # 运行测试
|
||||
```
|
||||
|
||||
## 🏗️ 架构
|
||||
|
||||
```
|
||||
main.py → SenSuFramework (15 服务)
|
||||
main.py → SenSuFramework (15+ 服务)
|
||||
├── ProjectEngine ← 接管任何项目 (subprocess + 日志)
|
||||
├── ProxyService ← 反向代理 (HTTP+WS)
|
||||
├── PyEnvManager ← Python 版本 + venv + git clone
|
||||
@@ -41,18 +42,19 @@ main.py → SenSuFramework (15 服务)
|
||||
├── SenSuDB ← SQLite 5 表
|
||||
├── TuiService ← Textual + 系统监控
|
||||
├── InternetService ← HTTP :4200 + WS :4240
|
||||
└── WebPanelManager ← /SenSu 管理面板
|
||||
└── WebPanelManager ← /SenSu 管理面板 (路由 + WS + 文件管理)
|
||||
```
|
||||
|
||||
## 📁 目录
|
||||
|
||||
```
|
||||
SenSu-Alpha/
|
||||
SenSu/
|
||||
├── main.py, service_manager.py
|
||||
├── sdk/ plugin_command, plugin_status, plugin_error, plugin_web
|
||||
├── services/ 15 个核心服务
|
||||
├── bridges/ CoreBridge + PluginBridge + NetworkBridge
|
||||
├── plugins/ 插件目录 + example_plugin (含 Web 面板)
|
||||
├── services/ 15+ 核心服务 + web_panel/ (路由 + 工具)
|
||||
├── bridges/ CoreBridge + PluginBridge
|
||||
├── plugins/ 插件目录 + example_plugin
|
||||
├── static/ MD3 CSS + JS + 页面
|
||||
├── deploy/ systemd + Dockerfile
|
||||
├── tests/ 28 个测试
|
||||
└── docs/ 开发文档
|
||||
@@ -62,13 +64,14 @@ SenSu-Alpha/
|
||||
|
||||
```
|
||||
http://0.0.0.0:4200/SenSu/
|
||||
├── /dashboard 仪表盘
|
||||
├── /pages/projects 项目管理 (添加/启动/Git部署) ← NEW
|
||||
├── /pages/proxy 反向代理管理 ← NEW
|
||||
├── /plugin/{name} 插件控制面板 ← NEW
|
||||
├── /console Web 终端
|
||||
├── /logs 实时日志
|
||||
└── /plugins 插件列表
|
||||
├── /dashboard 仪表盘 (WS 实时推送 CPU/内存/网速双线图)
|
||||
├── /pages/files 文件管理器 (全系统浏览/编辑/上传/右键菜单)
|
||||
├── /pages/projects 项目管理 (添加/启动/Git部署)
|
||||
├── /pages/proxy 反向代理管理
|
||||
├── /pages/plugins 插件管理 (启用/停用/重载)
|
||||
├── /pages/logs 实时日志 (WS 推送/500行上限/批量渲染)
|
||||
├── /pages/console Web 终端
|
||||
└── /plugin/{name} 插件控制面板
|
||||
```
|
||||
|
||||
## 🔌 插件开发
|
||||
|
||||
Reference in New Issue
Block a user