fix: 大盘复盘结果区滚动锁定问题 (ZhuLinsen#1266) (ZhuLinsen#1270)

* fix(issue-1266): [bug]-新版本大盘复盘后，下面的界面滑不上去了

* fix(review-feedback-1270): address latest review comments

Author: ZhuLinsen

apps/dsa-web/src/pages/HomePage.tsx

@@ -31,6 +31,7 @@ const HomePage: React.FC = () => {
   const [marketReviewReport, setMarketReviewReport] = useState<string | null>(null);
   const [marketReviewReportCopied, setMarketReviewReportCopied] = useState(false);
   const marketReviewPollTimer = useRef<number | null>(null);
+  const dashboardScrollRef = useRef<HTMLElement | null>(null);
 
   const stopMarketReviewPolling = useCallback(() => {
     if (marketReviewPollTimer.current !== null) {
@@ -39,6 +40,20 @@ const HomePage: React.FC = () => {
     }
   }, []);
 
+  const scrollMarketReviewFeedbackIntoView = useCallback(() => {
+    const scrollContainer = dashboardScrollRef.current;
+    if (!scrollContainer) {
+      return;
+    }
+
+    if (typeof scrollContainer.scrollTo === 'function') {
+      scrollContainer.scrollTo({ top: 0, behavior: 'smooth' });
+      return;
+    }
+
+    scrollContainer.scrollTop = 0;
+  }, []);
+
   useEffect(() => stopMarketReviewPolling, [stopMarketReviewPolling]);
   const [setupStatus, setSetupStatus] = useState<SetupStatusResponse | null>(null);
 
@@ -187,6 +202,7 @@ const HomePage: React.FC = () => {
             title: '大盘复盘已超时',
             message: '任务长时间未返回最终结果，请在任务列表/历史中查看。',
           });
+          scrollMarketReviewFeedbackIntoView();
           return false;
         }
 
@@ -219,6 +235,7 @@ const HomePage: React.FC = () => {
               message: marketReviewText ? '大盘复盘任务已完成，结果如下：' : '大盘复盘任务已完成，结果已生成并按配置推送。',
             });
             setMarketReviewError(null);
+            scrollMarketReviewFeedbackIntoView();
             return false;
           }
 
@@ -237,6 +254,7 @@ const HomePage: React.FC = () => {
               }),
             );
             setMarketReviewNotice(null);
+            scrollMarketReviewFeedbackIntoView();
             return false;
           }
 
@@ -247,6 +265,7 @@ const HomePage: React.FC = () => {
             title: '大盘复盘状态异常',
             message: `收到未知任务状态：${status.status}`,
           });
+          scrollMarketReviewFeedbackIntoView();
           return false;
         } catch (err: unknown) {
           const parsed = getParsedApiError(err);
@@ -255,6 +274,7 @@ const HomePage: React.FC = () => {
             setMarketReviewReport(null);
             setMarketReviewError(parsed);
             setMarketReviewNotice(null);
+            scrollMarketReviewFeedbackIntoView();
             return false;
           }
           return true;
@@ -273,32 +293,35 @@ const HomePage: React.FC = () => {
         }, intervalMs);
       }
     },
-    [stopMarketReviewPolling],
+    [scrollMarketReviewFeedbackIntoView, stopMarketReviewPolling],
   );
 
   const handleTriggerMarketReview = useCallback(async () => {
     setIsSubmittingMarketReview(true);
     setMarketReviewNotice(null);
     setMarketReviewError(null);
     setMarketReviewReport(null);
+    scrollMarketReviewFeedbackIntoView();
     try {
       const result = await analysisApi.triggerMarketReview({ sendNotification: notify });
       setMarketReviewNotice({
         variant: 'success',
         title: '大盘复盘已提交',
         message: result.message,
       });
+      scrollMarketReviewFeedbackIntoView();
 
       if (result.taskId) {
         await pollMarketReviewStatus(result.taskId);
       }
     } catch (err: unknown) {
       setMarketReviewError(getParsedApiError(err));
       setMarketReviewNotice(null);
+      scrollMarketReviewFeedbackIntoView();
     } finally {
       setIsSubmittingMarketReview(false);
     }
-  }, [notify, pollMarketReviewStatus]);
+  }, [notify, pollMarketReviewStatus, scrollMarketReviewFeedbackIntoView]);
 
   const handleCopyMarketReviewReport = useCallback(() => {
     if (!marketReviewReport) {
@@ -479,48 +502,6 @@ const HomePage: React.FC = () => {
           </div>
         ) : null}
 
-        {marketReviewNotice ? (
-          <div className="px-3 pb-2 md:px-4">
-            <InlineAlert
-              variant={marketReviewNotice.variant}
-              title={marketReviewNotice.title}
-              message={marketReviewNotice.message}
-              className="rounded-xl px-3 py-2 text-xs shadow-none"
-            />
-          </div>
-        ) : null}
-
-        {marketReviewError ? (
-          <div className="px-3 pb-2 md:px-4">
-            <ApiErrorAlert
-              error={marketReviewError}
-              className="mb-1"
-              onDismiss={() => setMarketReviewError(null)}
-            />
-          </div>
-        ) : null}
-
-        {marketReviewReport ? (
-          <div className="px-3 pb-2 md:px-4">
-            <div className="rounded-xl border border-subtle bg-surface/70 px-3 py-3 text-xs text-secondary-text shadow-sm">
-              <div className="mb-2 flex items-center justify-between gap-2">
-                <p className="font-semibold text-foreground">大盘复盘报告</p>
-                <button
-                  type="button"
-                  className="home-surface-button h-7 rounded-md px-3 py-1 text-xs text-foreground"
-                  disabled={marketReviewReportCopied}
-                  onClick={() => void handleCopyMarketReviewReport()}
-                >
-                  {marketReviewReportCopied ? '已复制' : '复制'}
-                </button>
-              </div>
-              <pre className="max-h-64 overflow-x-auto overflow-y-auto whitespace-pre-wrap break-words rounded-lg bg-background px-3 py-2 leading-relaxed">
-                {marketReviewReport}
-              </pre>
-            </div>
-          </div>
-        ) : null}
-
         <div className="flex-1 flex min-h-0 overflow-hidden">
           <div className="hidden min-h-0 w-64 shrink-0 flex-col overflow-hidden pl-4 pb-4 md:flex lg:w-72">
             {sidebarContent}
@@ -538,7 +519,54 @@ const HomePage: React.FC = () => {
             </div>
           ) : null}
 
-          <section className="flex-1 min-w-0 min-h-0 overflow-x-auto overflow-y-auto px-3 pb-4 md:px-6 touch-pan-y">
+          <section
+            ref={dashboardScrollRef}
+            data-testid="home-dashboard-scroll"
+            className="flex-1 min-w-0 min-h-0 overflow-x-auto overflow-y-auto px-3 pb-4 md:px-6 touch-pan-y"
+          >
+            {marketReviewNotice ? (
+              <div className="mb-3">
+                <InlineAlert
+                  variant={marketReviewNotice.variant}
+                  title={marketReviewNotice.title}
+                  message={marketReviewNotice.message}
+                  className="rounded-xl px-3 py-2 text-xs shadow-none"
+                />
+              </div>
+            ) : null}
+
+            {marketReviewError ? (
+              <div className="mb-3">
+                <ApiErrorAlert
+                  error={marketReviewError}
+                  className="mb-1"
+                  onDismiss={() => setMarketReviewError(null)}
+                />
+              </div>
+            ) : null}
+
+            {marketReviewReport ? (
+              <div className="mb-3 rounded-xl border border-subtle bg-surface/70 px-3 py-3 text-xs text-secondary-text shadow-sm">
+                <div className="mb-2 flex items-center justify-between gap-2">
+                  <p className="font-semibold text-foreground">大盘复盘报告</p>
+                  <button
+                    type="button"
+                    className="home-surface-button h-7 rounded-md px-3 py-1 text-xs text-foreground"
+                    disabled={marketReviewReportCopied}
+                    onClick={() => void handleCopyMarketReviewReport()}
+                  >
+                    {marketReviewReportCopied ? '已复制' : '复制'}
+                  </button>
+                </div>
+                <pre
+                  data-testid="market-review-report"
+                  className="overflow-x-auto whitespace-pre-wrap break-words rounded-lg bg-background px-3 py-2 leading-relaxed"
+                >
+                  {marketReviewReport}
+                </pre>
+              </div>
+            ) : null}
+
             {error ? (
               <ApiErrorAlert
                 error={error}

apps/dsa-web/src/pages/__tests__/HomePage.test.tsx

@@ -117,6 +117,7 @@ describe('HomePage', () => {
     expect(dashboard.className).toContain('lg:h-[calc(100vh-2rem)]');
     expect(dashboard.firstElementChild?.className).toContain('min-h-0');
     expect(dashboard.querySelector('.flex-1.flex.min-h-0.overflow-hidden')).toBeTruthy();
+    expect(screen.getByTestId('home-dashboard-scroll')).toBeInTheDocument();
     expect(screen.getByPlaceholderText('输入股票代码或名称，如 600519、贵州茅台、AAPL')).toBeInTheDocument();
     expect(await screen.findByText('趋势维持强势')).toBeInTheDocument();
     expect(
@@ -208,6 +209,89 @@ describe('HomePage', () => {
     expect(analysisApi.getStatus).toHaveBeenCalledWith('task-1');
   });
 
+  it('scrolls the dashboard to market review feedback after toolbar clicks', async () => {
+    vi.mocked(historyApi.getList).mockResolvedValue({
+      total: 1,
+      page: 1,
+      limit: 20,
+      items: [historyItem],
+    });
+    vi.mocked(historyApi.getDetail).mockResolvedValue(historyReport);
+    vi.mocked(analysisApi.triggerMarketReview).mockResolvedValue({
+      status: 'accepted',
+      sendNotification: true,
+      message: '大盘复盘任务已提交',
+      taskId: 'task-1',
+    });
+    vi.mocked(analysisApi.getStatus).mockResolvedValue({
+      taskId: 'task-1',
+      status: 'completed',
+      marketReviewReport: '市场复盘报告示例文本',
+    });
+
+    render(
+      <MemoryRouter>
+        <HomePage />
+      </MemoryRouter>,
+    );
+
+    await screen.findByText('趋势维持强势');
+    const dashboardScroll = screen.getByTestId('home-dashboard-scroll');
+    const scrollToMock = vi.fn(function scrollTo(this: HTMLElement, options?: ScrollToOptions) {
+      if (typeof options?.top === 'number') {
+        this.scrollTop = options.top;
+      }
+    });
+    Object.defineProperty(dashboardScroll, 'scrollTo', {
+      configurable: true,
+      value: scrollToMock,
+    });
+    dashboardScroll.scrollTop = 480;
+
+    fireEvent.click(screen.getByRole('button', { name: '大盘复盘' }));
+
+    await waitFor(() => {
+      expect(scrollToMock).toHaveBeenCalledWith({ top: 0, behavior: 'smooth' });
+    });
+    expect(dashboardScroll.scrollTop).toBe(0);
+    expect(await screen.findByText('大盘复盘已完成')).toBeInTheDocument();
+  });
+
+  it('keeps market review results in the main dashboard scroll area', async () => {
+    vi.mocked(historyApi.getList).mockResolvedValue({
+      total: 0,
+      page: 1,
+      limit: 20,
+      items: [],
+    });
+    vi.mocked(analysisApi.triggerMarketReview).mockResolvedValue({
+      status: 'accepted',
+      sendNotification: true,
+      message: '大盘复盘任务已提交',
+      taskId: 'task-1',
+    });
+    vi.mocked(analysisApi.getStatus).mockResolvedValue({
+      taskId: 'task-1',
+      status: 'completed',
+      marketReviewReport: Array.from({ length: 30 }, (_, index) => `第 ${index + 1} 行复盘内容`).join('\n'),
+    });
+
+    render(
+      <MemoryRouter>
+        <HomePage />
+      </MemoryRouter>,
+    );
+
+    fireEvent.click(await screen.findByRole('button', { name: '大盘复盘' }));
+
+    const dashboardScroll = screen.getByTestId('home-dashboard-scroll');
+    const marketReviewReport = await screen.findByTestId('market-review-report');
+    expect(dashboardScroll).toContainElement(marketReviewReport);
+    expect(marketReviewReport.className).not.toContain('max-h-64');
+    expect(marketReviewReport.className).not.toContain('overflow-y-auto');
+    expect(await screen.findByText('开始分析')).toBeInTheDocument();
+  });
+
   it('shows first-run setup gaps and links to settings', async () => {
     vi.mocked(historyApi.getList).mockResolvedValue({
       total: 0,

docs/CHANGELOG.md

@@ -67,7 +67,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 - [修复] Windows NSIS 自动更新在安装尝试未切换桌面端版本时跳过自动恢复，避免失败或取消安装后误回滚用户运行时数据。
 - [修复] 同版本启动时清理未生效的自动更新备份目录，避免后续升级误将旧 `.dsa-desktop-update-backup/runtime-state.json` 的运行时文件再次恢复到新版本。
 - [修复] 清理提交中的临时探测文件（`node_modules_exists.txt` 与 `node_modules_ls_check.txt`），避免污染桌面/前端改动范围。
-
 - [新功能] Web 系统设置页开放 `.env` 配置备份导入/导出，复用键级覆盖、配置版本冲突保护和重载链路；Web 端在 `ADMIN_AUTH_ENABLED=false` 时该入口为禁用状态。
 - [chore] 精简仓库根目录：将文档图片资源迁入 `docs/assets/`，将东方财富请求补丁迁入 `src/patches/`，并下移 CI 专用依赖文件与技能适配服务。
 - [文档] 更新多语言 README 首页浅色工作台 GIF，并精简功能特性表，保留原有赞助商、快速开始和推送效果结构。
@@ -76,6 +75,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 - [修复] Docker 挂载的 `logs` 目录不可写时启动日志自动降级到控制台输出，并补充非 root 容器目录权限说明。
 - [修复] 修正分析报告 API 构建策略点位时数值字段未归一为字符串的问题，避免策略价格触发响应 DTO 类型校验失败。
 - [修复] Docker 启动入口自动修复 `data` / `logs` / `reports` 挂载目录权限并降权运行，文档化的 Compose `exec` 手动命令显式使用 `dsa` 用户，避免普通部署需要手动 `chown` / `chmod`。
+- [修复] Web 首页大盘复盘结果改由主内容滚动区承载，避免 loading 切换到长结果后下方报告区域被截断或无法继续滚动。
 
 ## [3.16.0] - 2026-05-10