Feat: 历史分析记录批量删除功能 (Batch Deletion) (ZhuLinsen#636)

* feat: implement batch deletion of analysis history with UI/UX improvements

- Backend: Added DELETE /api/v1/history endpoint for bulk deletion by IDs.
- Storage: Implemented DatabaseManager.delete_analysis_history_records with cascade cleanup of BacktestResult to prevent foreign key constraints.
- Frontend:
    - Added checkbox-based multi-selection to HistoryList component.
    - Implemented batch delete logic in HomePage with automatic selection fallback.
    - Extracted and standardized ConfirmDialog component for consistent design across the app.
    - Updated ChatPage to use the new standardized ConfirmDialog.
- Tests: Added unit tests for database cascade deletion and API endpoint functionality.

* docs: update README and CHANGELOG for batch history deletion

* feat: Implement the main HomePage for stock analysis and history management, supported by a new history service.

---------

Co-authored-by: mumu <42829555+ZhuLinsen@users.noreply.github.com>

Author: Activer007

README.md

@@ -37,6 +37,7 @@
 | 策略 | 市场策略系统 | 内置 A股「三段式复盘策略」与美股「Regime Strategy」，输出进攻/均衡/防守或 risk-on/neutral/risk-off 计划，并附“仅供参考，不构成投资建议”提示 |
 | 复盘 | 大盘复盘 | 每日市场概览、板块涨跌；支持 cn(A股)/us(美股)/both(两者) 切换 |
 | 智能导入 | 多源导入 | 支持图片、CSV/Excel 文件、剪贴板粘贴；Vision LLM 提取代码+名称；置信度分层确认；名称→代码解析（本地+拼音+AkShare） |
+| 历史记录 | 批量管理 | 支持多选、全选及批量删除历史分析记录，优化管理效率与 UI/UX 体验 |
 | 回测 | AI 回测验证 | 自动评估历史分析准确率，方向胜率、止盈止损命中率 |
 | **Agent 问股** | **策略对话** | **多轮策略问答，支持均线金叉/缠论/波浪等 11 种内置策略，Web/Bot/API 全链路** |
 | 推送 | 多渠道通知 | 企业微信、飞书、Telegram、钉钉、邮件、Pushover |

api/v1/endpoints/history.py

@@ -12,12 +12,14 @@
 import logging
 from typing import Optional
 
-from fastapi import APIRouter, HTTPException, Query, Depends
+from fastapi import APIRouter, HTTPException, Query, Depends, Body
 
 from api.deps import get_database_manager
 from api.v1.schemas.history import (
     HistoryListResponse,
     HistoryItem,
+    DeleteHistoryRequest,
+    DeleteHistoryResponse,
     NewsIntelItem,
     NewsIntelResponse,
     AnalysisReport,
@@ -116,6 +118,51 @@ def get_history_list(
         )
 
 
+@router.delete(
+    "",
+    response_model=DeleteHistoryResponse,
+    responses={
+        200: {"description": "删除成功"},
+        400: {"description": "请求参数错误", "model": ErrorResponse},
+        500: {"description": "服务器错误", "model": ErrorResponse},
+    },
+    summary="删除历史分析记录",
+    description="按历史记录主键 ID 批量删除分析历史"
+)
+def delete_history_records(
+    request: DeleteHistoryRequest = Body(...),
+    db_manager: DatabaseManager = Depends(get_database_manager)
+) -> DeleteHistoryResponse:
+    """
+    按主键 ID 批量删除历史分析记录。
+    """
+    record_ids = sorted({record_id for record_id in request.record_ids if record_id is not None})
+    if not record_ids:
+        raise HTTPException(
+            status_code=400,
+            detail={
+                "error": "invalid_request",
+                "message": "record_ids 不能为空"
+            }
+        )
+
+    try:
+        service = HistoryService(db_manager)
+        deleted = service.delete_history_records(record_ids)
+        return DeleteHistoryResponse(deleted=deleted)
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"删除历史记录失败: {e}", exc_info=True)
+        raise HTTPException(
+            status_code=500,
+            detail={
+                "error": "internal_error",
+                "message": f"删除历史记录失败: {str(e)}"
+            }
+        )
+
+
 @router.get(
     "/{record_id}",
     response_model=AnalysisReport,

api/v1/schemas/__init__.py

@@ -23,6 +23,8 @@
 from api.v1.schemas.history import (
     HistoryItem,
     HistoryListResponse,
+    DeleteHistoryRequest,
+    DeleteHistoryResponse,
     NewsIntelItem,
     NewsIntelResponse,
     AnalysisReport,
@@ -75,6 +77,8 @@
     # history
     "HistoryItem",
     "HistoryListResponse",
+    "DeleteHistoryRequest",
+    "DeleteHistoryResponse",
     "NewsIntelItem",
     "NewsIntelResponse",
     "AnalysisReport",

api/v1/schemas/history.py

@@ -65,6 +65,18 @@ class Config:
         }
 
 
+class DeleteHistoryRequest(BaseModel):
+    """删除历史记录请求"""
+
+    record_ids: List[int] = Field(default_factory=list, description="要删除的历史记录主键 ID 列表")
+
+
+class DeleteHistoryResponse(BaseModel):
+    """删除历史记录响应"""
+
+    deleted: int = Field(..., description="实际删除的历史记录数量")
+
+
 class NewsIntelItem(BaseModel):
     """新闻情报条目"""
 

apps/dsa-web/package-lock.json

@@ -77,4 +77,16 @@ export const historyApi = {
     const response = await apiClient.get<{ content: string }>(`/api/v1/history/${recordId}/markdown`);
     return response.data.content;
   },
+
+  /**
+   * 批量删除历史记录
+   * @param recordIds 分析历史记录主键 ID 列表
+   */
+  deleteRecords: async (recordIds: number[]): Promise<{ deleted: number }> => {
+    const response = await apiClient.delete<Record<string, unknown>>('/api/v1/history', {
+      data: { record_ids: recordIds },
+    });
+
+    return toCamelCase<{ deleted: number }>(response.data);
+  },
 };

apps/dsa-web/src/api/history.ts

@@ -0,0 +1,64 @@
+import type React from 'react';
+
+interface ConfirmDialogProps {
+  isOpen: boolean;
+  title: string;
+  message: string;
+  confirmText?: string;
+  cancelText?: string;
+  isDanger?: boolean;
+  onConfirm: () => void;
+  onCancel: () => void;
+}
+
+/**
+ * Generic confirmation dialog component.
+ * Style is consistent with ChatPage.
+ */
+export const ConfirmDialog: React.FC<ConfirmDialogProps> = ({
+  isOpen,
+  title,
+  message,
+  confirmText = '确定',
+  cancelText = '取消',
+  isDanger = false,
+  onConfirm,
+  onCancel,
+}) => {
+  if (!isOpen) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 backdrop-blur-sm transition-all"
+      onClick={onCancel}
+    >
+      <div
+        className="bg-elevated border border-white/10 rounded-xl p-6 max-w-sm w-full mx-4 shadow-2xl animate-in fade-in zoom-in duration-200"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <h3 className="text-white font-medium mb-2 text-lg">{title}</h3>
+        <p className="text-sm text-secondary mb-6 leading-relaxed">
+          {message}
+        </p>
+        <div className="flex justify-end gap-3">
+          <button
+            onClick={onCancel}
+            className="px-4 py-2 rounded-lg text-sm font-medium text-secondary hover:text-white hover:bg-white/5 border border-white/10 transition-colors"
+          >
+            {cancelText}
+          </button>
+          <button
+            onClick={onConfirm}
+            className={`px-4 py-2 rounded-lg text-sm font-medium text-white transition-colors ${
+              isDanger
+                ? 'bg-red-500/80 hover:bg-red-500 shadow-lg shadow-red-500/20'
+                : 'bg-cyan/80 hover:bg-cyan shadow-lg shadow-cyan/20'
+            }`}
+          >
+            {confirmText}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+};

apps/dsa-web/src/components/common/ConfirmDialog.tsx

@@ -10,3 +10,4 @@ export * from './JsonViewer';
 export * from './Select';
 export * from './Badge';
 export * from './Pagination';
+export * from './ConfirmDialog';