chore: 移除临时开发文档 (进度/踩坑/备份/结构) — docs/ gitignore + 白名单

2026-06-13 20:59:05 +08:00
parent ff693465f6
commit ead7d2056b
6 changed files with 3 additions and 5161 deletions
@@ -20,3 +20,6 @@ config/framework/permission_rules.yaml
 config/permissions/
 config/plugins/
 config/services/
+!docs/API_Auth_Flow.md
+!docs/SenSu 插件开发详细指南.md
+!docs/SenSu 框架基本架构.md
@@ -1,28 +0,0 @@
-# Phase 1 开发进度总结
-
-> 完成时间: 2026-06-10 20:40
-> 测试: 28/28 通过
-> 集成: API 正常，WebUI 正常
-
-## 新增文件
- `services/project_engine.py` (160行) — 异步子进程项目管理
- `services/pyenv_manager.py` (100行) — Python 版本 + venv + Git clone
- `services/web_panel/routes/projects.py` (60行) — 项目管理 API 路由
- `static/web_panel/pages/projects.html` (120行) — 项目管理 WebUI
- `tests/test_phase1.py` (5 测试)
-
-## 修改文件
- `main.py` — 添加 ProjectEngine + PyEnvManager 初始化 (step 11.7)
- `services/web_panel/manager.py` — 注册项目管理路由
-
-## 功能验证
- [x] 项目列表 API: GET /api/projects → {"projects": []}
- [x] 启动项目: POST /api/projects/run {name, cmd, cwd, port}
- [x] 停止项目: POST /api/projects/{name}/stop
- [x] 项目日志: GET /api/projects/{name}/logs?tail=50
- [x] 发送命令: POST /api/projects/{name}/stdin {text}
- [x] WebUI: /pages/projects (项目列表、添加、Git部署)
-
-## 已知问题
- Python版本管理依赖系统 pkg/pyenv，Termux 外环境可能需要调整
- Git clone 超时时间固定 300s
@@ -1,13 +0,0 @@
-# Phase 2 开发进度总结
-
-> 完成: 2026-06-10
-> 测试: 28/28 通过
-
-## 新增
- `services/proxy_service.py` (160行) — 反向代理 (HTTP+WS转发)
- `services/web_panel/routes/proxy.py` — 代理管理 API
- `static/web_panel/pages/proxy.html` — 代理管理 WebUI
-
-## 集成
- Web panel manager 自动加载 proxy 路由
- main.py 初始化 ProxyService (step 11.8)
@@ -1,20 +0,0 @@
-# Phase 3 开发进度总结
-
-> 完成: 2026-06-10
-> 测试: 28/28 通过
-
-## 新增
- `sdk/plugin_web.py` — PluginWebMixin (Web页面注册+API+SSE)
- `services/web_panel/routes/plugin_web.py` — 插件面板路由
- `plugins/example_plugin/dashboard.html` — 示例仪表盘 (计数器+SSE)
-
-## SDK API
- `register_web_page(path, title, html, icon)` — 注册控制页面
- `register_api_route(method, path, handler)` — 注册 REST 端点
- `push_sse_event(type, data)` — SSE 实时推送
- `handle_sse(request)` — SSE 连接处理
-
-## 端点
- GET /SenSu/plugin/{name} — 插件控制面板
- GET /SenSu/plugin/{name}/sse — SSE 事件流
- POST /SenSu/plugin/{name}/event — 触发事件
@@ -1,56 +0,0 @@
-SenSu/
-├── main.py                    # 框架主入口 (--headless 参数)
-├── service_manager.py         # 服务管理器 (健康检查 + 启动顺序)
-├── requirements.txt           # Python 依赖
-├── README.md                  # 项目说明
-├── ROADMAP.md                 # 开发路线图 (本地)
-├── LICENSE                    # Apache 2.0
-│
-├── sdk/                       # 插件开发工具包
-│   ├── plugin_command_decorator.py
-│   ├── plugin_status.py       # 9 状态枚举
-│   ├── plugin_error.py        # 6 异常层级
-│   └── plugin_web.py          # Web 控制面板 Mixin (NEW v0.6)
-│
-├── services/                  # 核心服务 (17 个)
-│   ├── init_service.py
-│   ├── log_service.py
-│   ├── tui_service.py         # TUI + 系统监控 + Tab补全
-│   ├── command_service.py
-│   ├── auth_service.py        # PBKDF2-SHA256
-│   ├── internet_service.py    # HTTP :4200 + WS :4240
-│   ├── plugin_service.py      # 热加载 + 状态追踪
-│   ├── permission_service.py
-│   ├── api_service.py
-│   ├── shutdown_service.py
-│   ├── sensu_db.py            # SQLite 5 表 (NEW v0.3)
-│   ├── project_engine.py      # 异步子进程管理 (NEW v0.6)
-│   ├── project_service.py     # 项目注册表 + 依赖解析 (NEW v0.3)
-│   ├── proxy_service.py       # 反向代理 HTTP+WS (NEW v0.6)
-│   ├── pyenv_manager.py       # Python版本+venv+git (NEW v0.6)
-│   ├── process_isolated.py    # 插件进程隔离 (NEW v0.5)
-│   ├── sysmon_widget.py       # TUI 系统监控 (NEW v0.4)
-│   └── web_panel/             # Web 管理面板
-│       ├── manager.py
-│       ├── auth.py
-│       └── routes/            # API 路由 (8 个模块)
-│           ├── auth.py, status.py, plugins.py, commands.py, logs.py
-│           ├── projects.py    # 项目管理 (NEW v0.6)
-│           ├── proxy.py       # 反向代理 (NEW v0.6)
-│           └── plugin_web.py  # 插件面板 (NEW v0.6)
-│
-├── bridges/                   # 消息桥接
-│   ├── core_bridge.py
-│   ├── plugin_bridge.py       # subscribe_plugin
-│   └── plugin_network_bridge.py
-│
-├── plugins/
-│   └── example_plugin/        # 示例插件 (命令+Web面板+SSE)
-│
-├── tests/                     # 28 个测试
-├── deploy/                    # systemd + Dockerfile
-├── docs/                      # 开发文档 + Phase 报告
-├── static/web_panel/          # 前端 (HTML/CSS/JS)
-│   └── pages/                 # 6 个 WebUI 页面
-├── utils/, templates/, gui/
-└── config/                    # 运行时配置