docs: 更新项目文档至 v1.8.0，添加 WebSocket 通知和线程安全说明

Author: lanshuizhiyue

AGENTS.md

@@ -91,6 +91,8 @@ sqlmapWebUI/
 - Sorting by multiple fields
 - Summary statistics row in task list
 - Smart polling (adjusts refresh rate based on task status)
+- WebSocket real-time notifications for task status changes
+- Confirmation dialogs for delete/stop operations
 
 ### Scan Configuration Management
 - **Default Configuration**: Global default scan parameters
@@ -316,6 +318,12 @@ Backend allows CORS from:
 - Header rules stored in SQLite (`header_rules.db`)
 - Automatic database migration for schema changes
 
+### Thread Safety (Important)
+- `DataStore.tasks_lock` is a `threading.Lock` (synchronous)
+- In async functions, use `run_in_executor` with `ThreadPoolExecutor` to avoid blocking event loop
+- Never use `with tasks_lock:` directly in async functions
+- Task operations use thread pool pattern for safe concurrent access
+
 ## File Dependencies
 
 ### Backend Entry Point

README.md

@@ -5,11 +5,11 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/Python-3.13+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/Python-3.10+-blue.svg" alt="Python">
   <img src="https://img.shields.io/badge/Vue-3.x-green.svg" alt="Vue">
   <img src="https://img.shields.io/badge/FastAPI-0.100+-red.svg" alt="FastAPI">
   <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
-  <img src="https://img.shields.io/badge/Version-1.7.9-orange.svg" alt="Version">
+  <img src="https://img.shields.io/badge/Version-1.8.0-orange.svg" alt="Version">
 </p>
 
 <p align="center">
@@ -271,16 +271,26 @@ sqlmapWebUI/
 ## 📝 更新日志
 
 ### v1.8.0 (2025-12)
+
+**新功能**
 - 新增后端服务启动脚本（Windows/Linux/macOS）
 - 支持自动创建和复用虚拟环境
 - 支持配置 PyPI 镜像（清华/阿里/中科大等）
 - 支持内网私域镜像配置
 - 支持完全离线环境部署
-- 解决 Windows/Linux 命令行中文乱码问题
-- Python 最低版本要求调整为 3.10+
-- 新增后端服务免责声明文档
+- 新增 WebSocket 实时通知机制，后端可主动推送任务状态变更
+- 任务列表页删除和停止操作添加确认对话框
+
+**优化**
+- 优化任务操作线程安全，将同步锁操作移至线程池避免阻塞事件循环
 - 优化扫描配置预设选择UI
 - 完善提交按钮禁用逻辑和提示信息
+- Python 最低版本要求调整为 3.10+
+
+**修复**
+- 解决 Windows/Linux 命令行中文乱码问题
+- 修复刷新间隔 API 响应数据结构处理错误
+- 新增后端服务免责声明文档
 
 ### v1.7.9 (2025-12)
 - 新增项目 Logo 设计（盾牌+注入针头概念）

README_EN.md

@@ -5,11 +5,11 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/Python-3.13+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/Python-3.10+-blue.svg" alt="Python">
   <img src="https://img.shields.io/badge/Vue-3.x-green.svg" alt="Vue">
   <img src="https://img.shields.io/badge/FastAPI-0.100+-red.svg" alt="FastAPI">
   <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
-  <img src="https://img.shields.io/badge/Version-1.7.9-orange.svg" alt="Version">
+  <img src="https://img.shields.io/badge/Version-1.8.0-orange.svg" alt="Version">
 </p>
 
 <p align="center">
@@ -278,16 +278,26 @@ Please read the [Disclaimer](DISCLAIMER.md) before use.
 ## Changelog
 
 ### v1.8.0 (2025-12)
+
+**New Features**
 - Added backend service startup scripts (Windows/Linux/macOS)
 - Support for auto-creating and reusing virtual environments
 - Support for PyPI mirror configuration (Tsinghua/Aliyun/USTC, etc.)
 - Support for intranet private mirror configuration
 - Support for fully offline environment deployment
-- Fixed Windows/Linux command line encoding issues
-- Lowered Python minimum version requirement to 3.10+
-- Added backend service disclaimer document
+- Added WebSocket real-time notification mechanism, backend can actively push task status changes
+- Added confirmation dialogs for delete and stop operations on task list page
+
+**Improvements**
+- Optimized task operation thread safety, moved sync lock operations to thread pool to avoid blocking event loop
 - Improved scan configuration preset selection UI
 - Enhanced submit button disable logic and hints
+- Lowered Python minimum version requirement to 3.10+
+
+**Fixes**
+- Fixed Windows/Linux command line encoding issues
+- Fixed refresh interval API response data structure handling error
+- Added backend service disclaimer document
 
 ### v1.7.9 (2025-12)
 - Added project Logo design (shield + injection syringe concept)

doc/FEATURE_UPDATES.md

@@ -137,6 +137,30 @@
 - 页面显示时恢复轮询
 - 防止重复请求
 
+### 9. WebSocket 实时通知 ✅ (v1.8.0 新增)
+
+#### 通知机制
+- 后端通过 WebSocket 主动推送任务状态变更
+- 新任务创建时自动通知前端刷新
+- 任务完成/失败时即时推送结果
+
+#### 线程安全优化
+- 使用线程池执行同步锁操作，避免阻塞事件循环
+- 解决后端卡死导致通知失败问题
+- 确保高并发场景下的稳定性
+
+### 10. 操作确认对话框 ✅ (v1.8.0 新增)
+
+#### 防误操作保护
+- 删除单个任务需确认
+- 停止单个任务需确认
+- 批量操作需确认
+- 删除全部需二次确认
+
+#### 用户反馈
+- 操作成功/失败 Toast 提示
+- 详细的操作结果信息
+
 ### 8. 响应式布局优化 ✅
 
 #### 断点定义
@@ -229,7 +253,7 @@
 
 ## 更新日期
 
-2025-01-XX
+2025-12-23 (v1.8.0)
 
 ## 开发者
 

doc/USAGE_GUIDE.md

@@ -208,7 +208,23 @@ python server.py
 - **扫描结果**: 发现的注入点和 Payload 详情
 - **实时日志**: 任务执行日志，支持刷新
 
-### 3.5 智能轮询
+### 3.5 实时通知
+
+系统采用 WebSocket 实时通知机制：
+- 后端主动推送任务状态变更
+- 新任务创建时自动通知前端刷新
+- 配合智能轮询策略，减少不必要的请求
+
+### 3.6 操作确认
+
+为防止误操作，以下操作需要确认：
+- 删除单个任务
+- 停止单个任务
+- 批量删除任务
+- 批量停止任务
+- 删除全部任务
+
+### 3.7 智能轮询
 
 系统采用智能轮询策略：
 - 当有运行中任务时，自动启动定时刷新
@@ -588,7 +604,7 @@ mvn clean package -DskipTests
 ## 9. 常见问题
 
 ### Q: 后端服务启动失败？
-A: 检查 Python 版本（需要 3.13+），确保依赖安装完整。使用 `uv sync --extra thirdparty` 安装依赖。
+A: 检查 Python 版本（需要 3.10+），确保依赖安装完整。使用 `uv sync --extra thirdparty` 安装依赖。
 
 ### Q: 前端无法连接后端？
 A: 检查跨域配置，确保后端服务正在运行。后端默认监听 8775 端口。