From 891a09e667e6be2fe9e9f73421cf31a0d202289e Mon Sep 17 00:00:00 2001
From: Color2333 <1552429809@qq.com>
Date: Thu, 19 Mar 2026 17:51:14 +0800
Subject: [PATCH 1/4] =?UTF-8?q?chore:=20=E5=88=A0=E9=99=A4=E5=AD=A4?=
 =?UTF-8?q?=E7=AB=8B=E7=9A=84=20Chat.tsx=20=E9=A1=B5=E9=9D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/src/pages/Chat.tsx | 254 ------------------------------------
 1 file changed, 254 deletions(-)
 delete mode 100644 frontend/src/pages/Chat.tsx

diff --git a/frontend/src/pages/Chat.tsx b/frontend/src/pages/Chat.tsx
deleted file mode 100644
index 8b4cbc9..0000000
--- a/frontend/src/pages/Chat.tsx
+++ /dev/null
@@ -1,254 +0,0 @@
-/**
- * AI Chat - RAG 问答 (Claude 对话风格)
- * 覆盖 API: POST /rag/ask
- * @author Color2333
- */
-import { useState, useRef, useEffect } from "react";
-import { Card, Button } from "@/components/ui";
-import { ragApi } from "@/services/api";
-import type { ChatMessage } from "@/types";
-import { uid } from "@/lib/utils";
-import { Send, Sparkles, User, BookOpen, Trash2 } from "lucide-react";
-
-export default function Chat() {
-  const [messages, setMessages] = useState<ChatMessage[]>([]);
-  const [input, setInput] = useState("");
-  const [loading, setLoading] = useState(false);
-  const scrollRef = useRef<HTMLDivElement>(null);
-  const inputRef = useRef<HTMLTextAreaElement>(null);
-
-  useEffect(() => {
-    if (scrollRef.current) {
-      scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
-    }
-  }, [messages]);
-
-  const handleSend = async () => {
-    const question = input.trim();
-    if (!question || loading) return;
-
-    const userMsg: ChatMessage = {
-      id: uid(),
-      role: "user",
-      content: question,
-      timestamp: new Date(),
-    };
-    setMessages((prev) => [...prev, userMsg]);
-    setInput("");
-    setLoading(true);
-
-    try {
-      const res = await ragApi.ask({ question, top_k: 5 });
-      const botMsg: ChatMessage = {
-        id: uid(),
-        role: "assistant",
-        content: res.answer,
-        cited_paper_ids: res.cited_paper_ids,
-        evidence: res.evidence,
-        timestamp: new Date(),
-      };
-      setMessages((prev) => [...prev, botMsg]);
-    } catch (err) {
-      const errorMsg: ChatMessage = {
-        id: uid(),
-        role: "assistant",
-        content: `抱歉，查询时出现错误: ${err instanceof Error ? err.message : "未知错误"}`,
-        timestamp: new Date(),
-      };
-      setMessages((prev) => [...prev, errorMsg]);
-    } finally {
-      setLoading(false);
-      inputRef.current?.focus();
-    }
-  };
-
-  const handleKeyDown = (e: React.KeyboardEvent) => {
-    if (e.key === "Enter" && !e.shiftKey) {
-      e.preventDefault();
-      handleSend();
-    }
-  };
-
-  const clearChat = () => {
-    setMessages([]);
-  };
-
-  return (
-    <div className="animate-fade-in flex h-[calc(100vh-8rem)] flex-col">
-      {/* 标题栏 */}
-      <div className="mb-4 flex items-center justify-between">
-        <div>
-          <h1 className="text-ink text-2xl font-bold">AI Chat</h1>
-          <p className="text-ink-secondary mt-1 text-sm">基于 RAG 的跨论文智能问答</p>
-        </div>
-        {messages.length > 0 && (
-          <Button
-            variant="ghost"
-            size="sm"
-            icon={<Trash2 className="h-3.5 w-3.5" />}
-            onClick={clearChat}
-          >
-            清空对话
-          </Button>
-        )}
-      </div>
-
-      {/* 消息区域 */}
-      <div
-        ref={scrollRef}
-        className="border-border bg-surface flex-1 space-y-4 overflow-y-auto rounded-2xl border p-6"
-      >
-        {messages.length === 0 ? (
-          <div className="flex h-full flex-col items-center justify-center">
-            <div className="bg-primary-light rounded-2xl p-4">
-              <Sparkles className="text-primary h-8 w-8" />
-            </div>
-            <h2 className="text-ink mt-4 text-lg font-semibold">PaperMind AI</h2>
-            <p className="text-ink-secondary mt-2 max-w-md text-center text-sm">
-              基于你收录的论文进行智能问答。 支持跨文档检索，自动引用来源论文。
-            </p>
-            <div className="mt-6 grid max-w-lg gap-2">
-              {[
-                "这些论文中关于 Transformer 的主要创新是什么？",
-                "有哪些论文讨论了模型压缩的方法？",
-                "总结一下近期在多模态学习方面的进展",
-              ].map((q) => (
-                <button
-                  key={q}
-                  onClick={() => setInput(q)}
-                  className="border-border bg-page text-ink-secondary hover:border-primary/30 hover:bg-hover hover:text-ink rounded-xl border px-4 py-3 text-left text-sm transition-colors"
-                >
-                  {q}
-                </button>
-              ))}
-            </div>
-          </div>
-        ) : (
-          messages.map((msg) => (
-            <div
-              key={msg.id}
-              className={`animate-fade-in flex gap-3 ${msg.role === "user" ? "justify-end" : ""}`}
-            >
-              {msg.role === "assistant" && (
-                <div className="bg-primary-light mt-1 flex h-8 w-8 shrink-0 items-center justify-center rounded-full">
-                  <Sparkles className="text-primary h-4 w-4" />
-                </div>
-              )}
-              <div
-                className={`max-w-[75%] ${
-                  msg.role === "user"
-                    ? "bg-primary rounded-2xl rounded-br-md px-4 py-3 text-white"
-                    : "space-y-2"
-                }`}
-              >
-                {msg.role === "user" ? (
-                  <p className="text-sm leading-relaxed">{msg.content}</p>
-                ) : (
-                  <>
-                    <div className="bg-page rounded-2xl rounded-bl-md px-4 py-3">
-                      <p className="text-ink text-sm leading-relaxed whitespace-pre-wrap">
-                        {msg.content}
-                      </p>
-                    </div>
-                    {/* 引用论文 */}
-                    {msg.cited_paper_ids && msg.cited_paper_ids.length > 0 && (
-                      <div className="flex flex-wrap gap-1.5 px-1">
-                        {msg.cited_paper_ids.map((cid) => (
-                          <span
-                            key={cid}
-                            className="bg-info-light text-info inline-flex items-center gap-1 rounded-full px-2.5 py-1 text-xs"
-                          >
-                            <BookOpen className="h-3 w-3" />
-                            {cid.slice(0, 8)}...
-                          </span>
-                        ))}
-                      </div>
-                    )}
-                    {/* Evidence */}
-                    {msg.evidence && msg.evidence.length > 0 && (
-                      <details className="px-1">
-                        <summary className="text-ink-tertiary hover:text-ink-secondary cursor-pointer text-xs">
-                          查看 {msg.evidence.length} 条证据
-                        </summary>
-                        <div className="mt-2 space-y-1.5">
-                          {msg.evidence.map((ev, i) => (
-                            <div
-                              key={i}
-                              className="bg-hover text-ink-secondary rounded-lg p-2.5 text-xs"
-                            >
-                              {JSON.stringify(ev, null, 2)}
-                            </div>
-                          ))}
-                        </div>
-                      </details>
-                    )}
-                  </>
-                )}
-              </div>
-              {msg.role === "user" && (
-                <div className="bg-hover mt-1 flex h-8 w-8 shrink-0 items-center justify-center rounded-full">
-                  <User className="text-ink-secondary h-4 w-4" />
-                </div>
-              )}
-            </div>
-          ))
-        )}
-
-        {/* 加载中提示 */}
-        {loading && (
-          <div className="animate-fade-in flex gap-3">
-            <div className="bg-primary-light flex h-8 w-8 shrink-0 items-center justify-center rounded-full">
-              <Sparkles className="text-primary h-4 w-4" />
-            </div>
-            <div className="bg-page rounded-2xl rounded-bl-md px-4 py-3">
-              <div className="flex items-center gap-2">
-                <div className="flex gap-1">
-                  <span className="animate-pulse-soft bg-primary h-2 w-2 rounded-full" />
-                  <span className="animate-pulse-soft bg-primary h-2 w-2 rounded-full [animation-delay:0.2s]" />
-                  <span className="animate-pulse-soft bg-primary h-2 w-2 rounded-full [animation-delay:0.4s]" />
-                </div>
-                <span className="text-ink-secondary text-sm">正在思考...</span>
-              </div>
-            </div>
-          </div>
-        )}
-      </div>
-
-      {/* 输入区域 */}
-      <div className="mt-4">
-        <div className="border-border bg-surface focus-within:border-primary/40 focus-within:ring-primary/10 flex items-end gap-3 rounded-2xl border p-3 shadow-sm transition-colors focus-within:ring-2">
-          <textarea
-            ref={inputRef}
-            value={input}
-            onChange={(e) => setInput(e.target.value)}
-            onKeyDown={handleKeyDown}
-            placeholder="输入你的问题..."
-            rows={1}
-            className="text-ink placeholder:text-ink-placeholder max-h-32 flex-1 resize-none bg-transparent text-sm focus:outline-none"
-            style={{
-              height: "auto",
-              minHeight: "24px",
-            }}
-            onInput={(e) => {
-              const target = e.target as HTMLTextAreaElement;
-              target.style.height = "auto";
-              target.style.height = `${Math.min(target.scrollHeight, 128)}px`;
-            }}
-          />
-          <Button
-            size="sm"
-            onClick={handleSend}
-            loading={loading}
-            disabled={!input.trim()}
-            className="shrink-0 rounded-xl"
-          >
-            <Send className="h-4 w-4" />
-          </Button>
-        </div>
-        <p className="text-ink-tertiary mt-2 text-center text-xs">
-          基于 RAG 检索增强生成，回答可能不完全准确，请以原始论文为准
-        </p>
-      </div>
-    </div>
-  );
-}

From 6b1ef01042e129db5951ad68e3afe237e73ebb11 Mon Sep 17 00:00:00 2001
From: Color2333 <1552429809@qq.com>
Date: Thu, 19 Mar 2026 19:17:49 +0800
Subject: [PATCH 2/4] =?UTF-8?q?feat(agent):=20=E4=BC=98=E5=8C=96=20Agent?=
 =?UTF-8?q?=20=E5=AF=B9=E8=AF=9D=E4=BD=93=E9=AA=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 移除 max_tokens 截断限制 (4096->8192)
- 移除 artifact 内容 500 字符截断
- 添加 Markdown 渲染缓存优化性能
- 新增对话导航条(用户消息点+悬停预览+点击跳转)
- 修复上下文处理逻辑
---
 frontend/src/contexts/AgentSessionContext.tsx | 413 +++++++++---
 frontend/src/hooks/useMessageHistory.ts       |   5 +-
 frontend/src/pages/AgentMessages.tsx          | 231 +++++++
 frontend/src/pages/AgentSteps.tsx             | 594 ++++++++++++++++++
 frontend/src/pages/ChatNavBar.tsx             | 136 ++++
 packages/ai/agent_service.py                  |   2 +-
 6 files changed, 1282 insertions(+), 99 deletions(-)
 create mode 100644 frontend/src/pages/AgentMessages.tsx
 create mode 100644 frontend/src/pages/AgentSteps.tsx
 create mode 100644 frontend/src/pages/ChatNavBar.tsx

diff --git a/frontend/src/contexts/AgentSessionContext.tsx b/frontend/src/contexts/AgentSessionContext.tsx
index 3bf6056..0269da3 100644
--- a/frontend/src/contexts/AgentSessionContext.tsx
+++ b/frontend/src/contexts/AgentSessionContext.tsx
@@ -2,7 +2,15 @@
  * Agent 会话全局上下文 - SSE 流和对话状态在页面切换时保持存活
  * @author Color2333
  */
-import { createContext, useContext, useState, useRef, useEffect, useCallback, useMemo } from "react";
+import {
+  createContext,
+  useContext,
+  useState,
+  useRef,
+  useEffect,
+  useCallback,
+  useMemo,
+} from "react";
 import { agentApi } from "@/services/api";
 import type { AgentMessage, SSEEvent, SSEEventType } from "@/types";
 import { parseSSEStream } from "@/types";
@@ -119,7 +127,13 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
       }
       return [
         ...prev,
-        { id: `asst_${uid()}`, type: "assistant" as const, content: text, streaming: true, timestamp: new Date() },
+        {
+          id: `asst_${uid()}`,
+          type: "assistant" as const,
+          content: text,
+          streaming: true,
+          timestamp: new Date(),
+        },
       ];
     });
   }, []);
@@ -140,21 +154,25 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
     }
     const conv = activeId ? loadConversation(activeId) : null;
     if (conv && conv.messages.length > 0) {
-      setItems(conv.messages.map((m): ChatItem => ({
-        id: m.id,
-        type: m.type,
-        content: m.content,
-        timestamp: new Date(m.timestamp),
-        streaming: false,
-        steps: m.steps,
-        actionId: m.actionId,
-        actionDescription: m.actionDescription,
-        actionTool: m.actionTool,
-        toolArgs: m.toolArgs,
-        artifactTitle: m.artifactTitle,
-        artifactContent: m.artifactContent,
-        artifactIsHtml: m.artifactIsHtml,
-      })));
+      setItems(
+        conv.messages.map(
+          (m): ChatItem => ({
+            id: m.id,
+            type: m.type,
+            content: m.content,
+            timestamp: new Date(m.timestamp),
+            streaming: false,
+            steps: m.steps,
+            actionId: m.actionId,
+            actionDescription: m.actionDescription,
+            actionTool: m.actionTool,
+            toolArgs: m.toolArgs,
+            artifactTitle: m.artifactTitle,
+            artifactContent: m.artifactContent,
+            artifactIsHtml: m.artifactIsHtml,
+          })
+        )
+      );
     } else {
       setItems([]);
     }
@@ -164,28 +182,27 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
 
   /* ---- 保存对话到 localStorage ---- */
   const buildSavePayload = useCallback((snapshot: ChatItem[]): ConversationMessage[] => {
-    return snapshot
-      .map((it) => {
-        const base: ConversationMessage = {
-          id: it.id,
-          type: it.type,
-          content: it.streaming ? it.content + streamBufRef.current : it.content,
-          timestamp: it.timestamp.toISOString(),
-        };
-        if (it.type === "step_group" && it.steps) base.steps = it.steps;
-        if (it.type === "action_confirm") {
-          base.actionId = it.actionId;
-          base.actionDescription = it.actionDescription;
-          base.actionTool = it.actionTool;
-          base.toolArgs = it.toolArgs;
-        }
-        if (it.type === "artifact") {
-          base.artifactTitle = it.artifactTitle;
-          base.artifactContent = it.artifactContent;
-          base.artifactIsHtml = it.artifactIsHtml;
-        }
-        return base;
-      });
+    return snapshot.map((it) => {
+      const base: ConversationMessage = {
+        id: it.id,
+        type: it.type,
+        content: it.streaming ? it.content + streamBufRef.current : it.content,
+        timestamp: it.timestamp.toISOString(),
+      };
+      if (it.type === "step_group" && it.steps) base.steps = it.steps;
+      if (it.type === "action_confirm") {
+        base.actionId = it.actionId;
+        base.actionDescription = it.actionDescription;
+        base.actionTool = it.actionTool;
+        base.toolArgs = it.toolArgs;
+      }
+      if (it.type === "artifact") {
+        base.artifactTitle = it.artifactTitle;
+        base.artifactContent = it.artifactContent;
+        base.artifactIsHtml = it.artifactIsHtml;
+      }
+      return base;
+    });
   }, []);
 
   /* 防抖保存 */
@@ -214,7 +231,13 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
     const lastIdx = copy.length - 1;
     if (lastIdx < 0) {
       if (pendingText) {
-        copy.push({ id: `asst_${uid()}`, type: "assistant" as const, content: pendingText, streaming: false, timestamp: new Date() });
+        copy.push({
+          id: `asst_${uid()}`,
+          type: "assistant" as const,
+          content: pendingText,
+          streaming: false,
+          timestamp: new Date(),
+        });
       }
       return;
     }
@@ -222,7 +245,13 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
     if (last.type === "assistant" && last.streaming) {
       copy[lastIdx] = { ...last, content: last.content + pendingText, streaming: false };
     } else if (pendingText) {
-      copy.push({ id: `asst_${uid()}`, type: "assistant" as const, content: pendingText, streaming: false, timestamp: new Date() });
+      copy.push({
+        id: `asst_${uid()}`,
+        type: "assistant" as const,
+        content: pendingText,
+        streaming: false,
+        timestamp: new Date(),
+      });
     }
   };
 
@@ -253,7 +282,16 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
               copy[copy.length - 1] = { ...last, steps };
               return copy;
             }
-            return [...copy, { id, type: "step_group" as const, content: "", steps: [{ id: stepId, status: "running", toolName, toolArgs }], timestamp: new Date() }];
+            return [
+              ...copy,
+              {
+                id,
+                type: "step_group" as const,
+                content: "",
+                steps: [{ id: stepId, status: "running", toolName, toolArgs }],
+                timestamp: new Date(),
+              },
+            ];
           });
           break;
         }
@@ -271,7 +309,12 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
                   ? steps.findIndex((s) => s.id === progId)
                   : steps.findIndex((s) => s.status === "running");
                 if (idx >= 0) {
-                  steps[idx] = { ...steps[idx], progressMessage: progMsg, progressCurrent: progCur, progressTotal: progTotal };
+                  steps[idx] = {
+                    ...steps[idx],
+                    progressMessage: progMsg,
+                    progressCurrent: progCur,
+                    progressTotal: progTotal,
+                  };
                   copy[i] = { ...copy[i], steps };
                   return copy;
                 }
@@ -293,7 +336,13 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
                   ? steps.findIndex((s) => s.id === toolId)
                   : steps.findIndex((s) => s.toolName === toolName && s.status === "running");
                 if (idx >= 0) {
-                  steps[idx] = { ...steps[idx], status: (data.success as boolean) ? "done" : "error", success: data.success as boolean, summary: data.summary as string, data: data.data as Record<string, unknown> };
+                  steps[idx] = {
+                    ...steps[idx],
+                    status: (data.success as boolean) ? "done" : "error",
+                    success: data.success as boolean,
+                    summary: data.summary as string,
+                    data: data.data as Record<string, unknown>,
+                  };
                   copy[i] = { ...copy[i], steps };
                   return copy;
                 }
@@ -307,21 +356,35 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
               // HTML 类 artifact（简报等）
               const artTitle = String(d.title || "Daily Brief");
               const artContent = String(d.html);
-              setItems((prev) => [...prev, {
-                id: `art_${uid()}`, type: "artifact" as const, content: "",
-                artifactTitle: artTitle, artifactContent: artContent, artifactIsHtml: true,
-                timestamp: new Date(),
-              }]);
+              setItems((prev) => [
+                ...prev,
+                {
+                  id: `art_${uid()}`,
+                  type: "artifact" as const,
+                  content: "",
+                  artifactTitle: artTitle,
+                  artifactContent: artContent,
+                  artifactIsHtml: true,
+                  timestamp: new Date(),
+                },
+              ]);
               setCanvas({ title: artTitle, markdown: artContent, isHtml: true });
             } else if (d.markdown) {
               // Markdown 类 artifact（Wiki、RAG 问答报告等）
               const artTitle = String(d.title || "报告");
               const artContent = String(d.markdown);
-              setItems((prev) => [...prev, {
-                id: `art_${uid()}`, type: "artifact" as const, content: "",
-                artifactTitle: artTitle, artifactContent: artContent, artifactIsHtml: false,
-                timestamp: new Date(),
-              }]);
+              setItems((prev) => [
+                ...prev,
+                {
+                  id: `art_${uid()}`,
+                  type: "artifact" as const,
+                  content: "",
+                  artifactTitle: artTitle,
+                  artifactContent: artContent,
+                  artifactIsHtml: false,
+                  timestamp: new Date(),
+                },
+              ]);
               setCanvas({ title: artTitle, markdown: artContent });
             }
           }
@@ -334,7 +397,19 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
           setItems((prev) => {
             const copy = [...prev];
             applyPendingText(copy, pending);
-            return [...copy, { id, type: "action_confirm" as const, content: "", actionId, actionDescription: data.description as string, actionTool: data.tool as string, toolArgs: data.args as Record<string, unknown>, timestamp: new Date() }];
+            return [
+              ...copy,
+              {
+                id,
+                type: "action_confirm" as const,
+                content: "",
+                actionId,
+                actionDescription: data.description as string,
+                actionTool: data.tool as string,
+                toolArgs: data.args as Record<string, unknown>,
+                timestamp: new Date(),
+              },
+            ];
           });
           setLoading(false);
           break;
@@ -348,7 +423,13 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
                 const steps = [...copy[i].steps!];
                 const running = steps.findIndex((s) => s.status === "running");
                 if (running >= 0) {
-                  steps[running] = { ...steps[running], status: (data.success as boolean) ? "done" : "error", success: data.success as boolean, summary: data.summary as string, data: data.data as Record<string, unknown> };
+                  steps[running] = {
+                    ...steps[running],
+                    status: (data.success as boolean) ? "done" : "error",
+                    success: data.success as boolean,
+                    summary: data.summary as string,
+                    data: data.data as Record<string, unknown>,
+                  };
                   copy[i] = { ...copy[i], steps };
                   return copy;
                 }
@@ -357,31 +438,70 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
             const last = copy[copy.length - 1];
             if (last && last.type === "step_group") {
               const steps = [...(last.steps || [])];
-              steps.push({ id: arId, status: ((data.success as boolean) ? "done" : "error") as "done" | "error", toolName: "操作执行", success: data.success as boolean, summary: data.summary as string, data: data.data as Record<string, unknown> });
+              steps.push({
+                id: arId,
+                status: ((data.success as boolean) ? "done" : "error") as "done" | "error",
+                toolName: "操作执行",
+                success: data.success as boolean,
+                summary: data.summary as string,
+                data: data.data as Record<string, unknown>,
+              });
               copy[copy.length - 1] = { ...last, steps };
               return copy;
             }
-            return [...prev, { id: `sg_${uid()}`, type: "step_group" as const, content: "", steps: [{ id: arId, status: ((data.success as boolean) ? "done" : "error") as "done" | "error", toolName: "操作执行", success: data.success as boolean, summary: data.summary as string, data: data.data as Record<string, unknown> }], timestamp: new Date() }];
+            return [
+              ...prev,
+              {
+                id: `sg_${uid()}`,
+                type: "step_group" as const,
+                content: "",
+                steps: [
+                  {
+                    id: arId,
+                    status: ((data.success as boolean) ? "done" : "error") as "done" | "error",
+                    toolName: "操作执行",
+                    success: data.success as boolean,
+                    summary: data.summary as string,
+                    data: data.data as Record<string, unknown>,
+                  },
+                ],
+                timestamp: new Date(),
+              },
+            ];
           });
           if (data.success && data.data) {
             const d = data.data as Record<string, unknown>;
             if (d.markdown) {
               const artTitle = String(d.title || "Wiki");
               const artContent = String(d.markdown);
-              setItems((prev) => [...prev, {
-                id: `art_${uid()}`, type: "artifact" as const, content: "",
-                artifactTitle: artTitle, artifactContent: artContent, artifactIsHtml: false,
-                timestamp: new Date(),
-              }]);
+              setItems((prev) => [
+                ...prev,
+                {
+                  id: `art_${uid()}`,
+                  type: "artifact" as const,
+                  content: "",
+                  artifactTitle: artTitle,
+                  artifactContent: artContent,
+                  artifactIsHtml: false,
+                  timestamp: new Date(),
+                },
+              ]);
               setCanvas({ title: artTitle, markdown: artContent });
             } else if (d.html) {
               const artTitle = String(d.title || "Daily Brief");
               const artContent = String(d.html);
-              setItems((prev) => [...prev, {
-                id: `art_${uid()}`, type: "artifact" as const, content: "",
-                artifactTitle: artTitle, artifactContent: artContent, artifactIsHtml: true,
-                timestamp: new Date(),
-              }]);
+              setItems((prev) => [
+                ...prev,
+                {
+                  id: `art_${uid()}`,
+                  type: "artifact" as const,
+                  content: "",
+                  artifactTitle: artTitle,
+                  artifactContent: artContent,
+                  artifactIsHtml: true,
+                  timestamp: new Date(),
+                },
+              ]);
               setCanvas({ title: artTitle, markdown: artContent, isHtml: true });
             }
           }
@@ -392,7 +512,15 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
           setItems((prev) => {
             const copy = [...prev];
             applyPendingText(copy, pending);
-            return [...copy, { id, type: "error" as const, content: (data.message as string) || "未知错误", timestamp: new Date() }];
+            return [
+              ...copy,
+              {
+                id,
+                type: "error" as const,
+                content: (data.message as string) || "未知错误",
+                timestamp: new Date(),
+              },
+            ];
           });
           break;
         }
@@ -404,11 +532,20 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
               return prev.map((item) =>
                 item.type === "assistant" && item.streaming
                   ? { ...item, content: item.content + pending, streaming: false }
-                  : item,
+                  : item
               );
             }
             if (pending) {
-              return [...prev, { id: `asst_done_${uid()}`, type: "assistant" as const, content: pending, streaming: false, timestamp: new Date() }];
+              return [
+                ...prev,
+                {
+                  id: `asst_done_${uid()}`,
+                  type: "assistant" as const,
+                  content: pending,
+                  streaming: false,
+                  timestamp: new Date(),
+                },
+              ];
             }
             return prev;
           });
@@ -417,7 +554,7 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
         }
       }
     },
-    [scheduleFlush, drainBuffer],
+    [scheduleFlush, drainBuffer]
   );
 
   /**
@@ -437,10 +574,20 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
                 return prev.map((item) =>
                   item.type === "assistant" && item.streaming
                     ? { ...item, content: item.content + pending, streaming: false }
-                    : item,
+                    : item
                 );
               }
-              if (pending) return [...prev, { id: `asst_fallback_${uid()}`, type: "assistant" as const, content: pending, streaming: false, timestamp: new Date() }];
+              if (pending)
+                return [
+                  ...prev,
+                  {
+                    id: `asst_fallback_${uid()}`,
+                    type: "assistant" as const,
+                    content: pending,
+                    streaming: false,
+                    timestamp: new Date(),
+                  },
+                ];
               return prev;
             });
           }
@@ -455,7 +602,7 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
         });
       }
     },
-    [processSSE, drainBuffer],
+    [processSSE, drainBuffer]
   );
 
   /* ---- 发送消息 ---- */
@@ -474,7 +621,10 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
         convId = createConversation(); // 返回新创建的 ID
       }
       setLoading(true);
-      setItems((prev) => [...prev, { id: `user_${uid()}`, type: "user" as const, content: text.trim(), timestamp: new Date() }]);
+      setItems((prev) => [
+        ...prev,
+        { id: `user_${uid()}`, type: "user" as const, content: text.trim(), timestamp: new Date() },
+      ]);
       // 使用 ref 获取最新 items，避免闭包过时
       const currentItems = itemsRef.current;
       const msgs: AgentMessage[] = [];
@@ -492,9 +642,15 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
             msgs.push({ role: "assistant", content: `执行了以下操作:\n${summaries}` });
           }
         } else if (it.type === "action_confirm") {
-          msgs.push({ role: "assistant", content: `[等待确认] ${it.actionDescription || it.actionTool || ""}` });
+          msgs.push({
+            role: "assistant",
+            content: `[等待确认] ${it.actionDescription || it.actionTool || ""}`,
+          });
         } else if (it.type === "artifact") {
-          msgs.push({ role: "assistant", content: `[已生成内容: ${it.artifactTitle || "未命名"}]\n${(it.artifactContent || "").slice(0, 500)}` });
+          msgs.push({
+            role: "assistant",
+            content: `[已生成内容: ${it.artifactTitle || "未命名"}]\n${it.artifactContent || ""}`,
+          });
         } else if (it.type === "error") {
           msgs.push({ role: "assistant", content: `[错误: ${it.content}]` });
         }
@@ -506,24 +662,44 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
         // 传递 conversationId 给后端
         const resp = await agentApi.chat(msgs, convId);
         if (!resp.body) {
-          setItems((p) => [...p, { id: `e_${uid()}`, type: "error" as const, content: "无响应流", timestamp: new Date() }]);
+          setItems((p) => [
+            ...p,
+            {
+              id: `e_${uid()}`,
+              type: "error" as const,
+              content: "无响应流",
+              timestamp: new Date(),
+            },
+          ]);
           setLoading(false);
           return;
         }
         startStream(resp.body.getReader(), ac.signal);
       } catch (err) {
-        setItems((p) => [...p, { id: `e_${uid()}`, type: "error" as const, content: err instanceof Error ? err.message : "请求失败", timestamp: new Date() }]);
+        setItems((p) => [
+          ...p,
+          {
+            id: `e_${uid()}`,
+            type: "error" as const,
+            content: err instanceof Error ? err.message : "请求失败",
+            timestamp: new Date(),
+          },
+        ]);
         setLoading(false);
       }
     },
-    [loading, pendingActions, cancelStream, createConversation, startStream],
+    [loading, pendingActions, cancelStream, createConversation, startStream]
   );
 
   /* ---- 确认/拒绝操作 ---- */
   const handleConfirm = useCallback(
     async (actionId: string) => {
       setConfirmingActions((prev) => new Set(prev).add(actionId));
-      setPendingActions((prev) => { const n = new Set(prev); n.delete(actionId); return n; });
+      setPendingActions((prev) => {
+        const n = new Set(prev);
+        n.delete(actionId);
+        return n;
+      });
       cancelStream();
       setLoading(true);
       try {
@@ -533,18 +709,34 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
         if (resp.body) startStream(resp.body.getReader(), ac.signal);
         else setLoading(false);
       } catch (err) {
-        setItems((p) => [...p, { id: `e_${uid()}`, type: "error" as const, content: err instanceof Error ? err.message : "确认失败", timestamp: new Date() }]);
+        setItems((p) => [
+          ...p,
+          {
+            id: `e_${uid()}`,
+            type: "error" as const,
+            content: err instanceof Error ? err.message : "确认失败",
+            timestamp: new Date(),
+          },
+        ]);
         setLoading(false);
       } finally {
-        setConfirmingActions((prev) => { const n = new Set(prev); n.delete(actionId); return n; });
+        setConfirmingActions((prev) => {
+          const n = new Set(prev);
+          n.delete(actionId);
+          return n;
+        });
       }
     },
-    [startStream, cancelStream],
+    [startStream, cancelStream]
   );
 
   const handleReject = useCallback(
     async (actionId: string) => {
-      setPendingActions((prev) => { const n = new Set(prev); n.delete(actionId); return n; });
+      setPendingActions((prev) => {
+        const n = new Set(prev);
+        n.delete(actionId);
+        return n;
+      });
       cancelStream();
       setLoading(true);
       try {
@@ -557,11 +749,19 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
           setLoading(false);
         }
       } catch (err) {
-        setItems((p) => [...p, { id: `e_${uid()}`, type: "error" as const, content: err instanceof Error ? err.message : "拒绝操作失败", timestamp: new Date() }]);
+        setItems((p) => [
+          ...p,
+          {
+            id: `e_${uid()}`,
+            type: "error" as const,
+            content: err instanceof Error ? err.message : "拒绝操作失败",
+            timestamp: new Date(),
+          },
+        ]);
         setLoading(false);
       }
     },
-    [startStream, cancelStream],
+    [startStream, cancelStream]
   );
 
   const hasPendingConfirm = pendingActions.size > 0;
@@ -574,16 +774,39 @@ export function AgentSessionProvider({ children }: { children: React.ReactNode }
       prev.map((item) =>
         item.type === "assistant" && item.streaming
           ? { ...item, content: item.content + pending, streaming: false }
-          : item,
-      ),
+          : item
+      )
     );
   }, [cancelStream, drainBuffer]);
 
-  const value: AgentSessionCtx = useMemo(() => ({
-    items, loading, pendingActions, confirmingActions, canvas, hasPendingConfirm,
-    setCanvas, sendMessage, handleConfirm, handleReject, stopGeneration,
-  }), [items, loading, pendingActions, confirmingActions, canvas, hasPendingConfirm,
-    setCanvas, sendMessage, handleConfirm, handleReject, stopGeneration]);
+  const value: AgentSessionCtx = useMemo(
+    () => ({
+      items,
+      loading,
+      pendingActions,
+      confirmingActions,
+      canvas,
+      hasPendingConfirm,
+      setCanvas,
+      sendMessage,
+      handleConfirm,
+      handleReject,
+      stopGeneration,
+    }),
+    [
+      items,
+      loading,
+      pendingActions,
+      confirmingActions,
+      canvas,
+      hasPendingConfirm,
+      setCanvas,
+      sendMessage,
+      handleConfirm,
+      handleReject,
+      stopGeneration,
+    ]
+  );
 
   return <Ctx.Provider value={value}>{children}</Ctx.Provider>;
 }
diff --git a/frontend/src/hooks/useMessageHistory.ts b/frontend/src/hooks/useMessageHistory.ts
index fb8507e..cdfa72a 100644
--- a/frontend/src/hooks/useMessageHistory.ts
+++ b/frontend/src/hooks/useMessageHistory.ts
@@ -31,8 +31,7 @@ export function useMessageHistory() {
             const summaries = item.steps
               .filter((s) => s.status === "done" || s.status === "error")
               .map(
-                (s) =>
-                  `[工具: ${s.toolName}] ${s.success ? "成功" : "失败"}: ${s.summary || ""}`,
+                (s) => `[工具: ${s.toolName}] ${s.success ? "成功" : "失败"}: ${s.summary || ""}`
               )
               .join("\n");
             if (summaries) {
@@ -54,7 +53,7 @@ export function useMessageHistory() {
         case "artifact":
           messages.push({
             role: "assistant",
-            content: `[已生成内容: ${item.artifactTitle || "未命名"}]\n${(item.artifactContent || "").slice(0, 500)}`,
+            content: `[已生成内容: ${item.artifactTitle || "未命名"}]\n${item.artifactContent || ""}`,
           });
           break;
 
diff --git a/frontend/src/pages/AgentMessages.tsx b/frontend/src/pages/AgentMessages.tsx
new file mode 100644
index 0000000..e1464ce
--- /dev/null
+++ b/frontend/src/pages/AgentMessages.tsx
@@ -0,0 +1,231 @@
+import { memo, useState, useCallback, useRef, useEffect, useMemo } from "react";
+import { useNavigate } from "react-router-dom";
+import { cn } from "@/lib/utils";
+import { CheckCircle2, XCircle, Loader2, Play, ChevronDown, ChevronRight } from "lucide-react";
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import remarkMath from "remark-math";
+import rehypeKatex from "rehype-katex";
+import "katex/dist/katex.min.css";
+import { type StepItem } from "@/contexts/AgentSessionContext";
+import { getToolMeta, StepDataView } from "./AgentSteps";
+
+const UserMessage = memo(function UserMessage({
+  content,
+  messageId,
+}: {
+  content: string;
+  messageId?: string;
+}) {
+  return (
+    <div className="flex justify-end py-2" data-message-id={messageId}>
+      <div className="bg-primary/10 text-ink max-w-[80%] rounded-2xl rounded-tr-sm px-4 py-3 text-sm leading-relaxed">
+        {content}
+      </div>
+    </div>
+  );
+});
+
+const AssistantMessage = memo(function AssistantMessage({
+  content,
+  streaming,
+}: {
+  content: string;
+  streaming: boolean;
+}) {
+  const [copied, setCopied] = useState(false);
+  const contentRef = useRef(content);
+
+  useEffect(() => {
+    contentRef.current = content;
+  }, [content]);
+
+  const handleCopy = useCallback(() => {
+    navigator.clipboard.writeText(contentRef.current).then(() => {
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1500);
+    });
+  }, []);
+
+  const markdownKey = streaming ? content : `static_${content}`;
+  const markdownContent = useMemo(() => content, [markdownKey]);
+
+  return (
+    <div className="group py-2">
+      <div className="prose-custom text-ink text-sm leading-relaxed">
+        <ReactMarkdown remarkPlugins={[remarkGfm, remarkMath]} rehypePlugins={[rehypeKatex]}>
+          {markdownContent}
+        </ReactMarkdown>
+      </div>
+      {streaming && (
+        <span className="bg-primary ml-0.5 inline-block h-4 w-[2px] animate-pulse rounded-full" />
+      )}
+      {!streaming && (
+        <div className="mt-1 flex opacity-0 transition-opacity group-hover:opacity-100">
+          <button
+            type="button"
+            onClick={handleCopy}
+            className="text-ink-tertiary hover:bg-hover hover:text-ink-secondary flex items-center gap-1 rounded-md px-2 py-1 text-[11px] transition-colors"
+          >
+            {copied ? "已复制" : "复制"}
+          </button>
+        </div>
+      )}
+    </div>
+  );
+});
+
+const StepGroupCard = memo(function StepGroupCard({ steps }: { steps: StepItem[] }) {
+  return (
+    <div className="py-2">
+      <div className="border-border bg-surface overflow-hidden rounded-xl border">
+        <div className="border-border-light bg-page flex items-center gap-2 border-b px-3.5 py-2">
+          <Play className="text-primary h-3 w-3" />
+          <span className="text-ink-secondary text-xs font-medium">执行步骤</span>
+          <span className="text-ink-tertiary ml-auto text-[11px]">
+            {steps.filter((s) => s.status === "done").length}/{steps.length}
+          </span>
+        </div>
+        <div className="divide-border-light divide-y">
+          {steps.map((step, idx) => (
+            <StepRow key={step.id || idx} step={step} />
+          ))}
+        </div>
+      </div>
+    </div>
+  );
+});
+
+function StepRow({ step }: { step: StepItem }) {
+  const isIngest = step.toolName === "ingest_arxiv";
+  const autoExpand = isIngest && step.status === "running";
+  const [expanded, setExpanded] = useState(false);
+  const meta = getToolMeta(step.toolName);
+  const Icon = meta.icon;
+  const hasData = step.data && Object.keys(step.data).length > 0;
+  const hasProgress = step.status === "running" && step.progressTotal && step.progressTotal > 0;
+  const progressPct = hasProgress
+    ? Math.round(((step.progressCurrent || 0) / step.progressTotal!) * 100)
+    : 0;
+  const showExpanded = expanded || autoExpand;
+
+  const statusIcon =
+    step.status === "running" ? (
+      <Loader2 className="text-primary h-3.5 w-3.5 animate-spin" />
+    ) : step.status === "done" ? (
+      <CheckCircle2 className="text-success h-3.5 w-3.5" />
+    ) : (
+      <XCircle className="text-error h-3.5 w-3.5" />
+    );
+
+  return (
+    <div>
+      <button
+        type="button"
+        onClick={() => hasData && setExpanded(!expanded)}
+        className={cn(
+          "flex w-full items-center gap-2.5 px-3.5 py-2.5 text-left text-xs transition-colors",
+          hasData && "hover:bg-hover"
+        )}
+      >
+        {statusIcon}
+        <Icon className="text-ink-tertiary h-3.5 w-3.5 shrink-0" />
+        <span className="text-ink font-medium">{meta.label}</span>
+        {step.toolArgs && Object.keys(step.toolArgs).length > 0 && !hasProgress && (
+          <span className="text-ink-tertiary truncate">
+            {Object.entries(step.toolArgs)
+              .slice(0, 2)
+              .map(([k, v]) => `${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`)
+              .join(" · ")}
+          </span>
+        )}
+        {hasProgress && !isIngest && (
+          <span className="text-ink-secondary truncate">{step.progressMessage}</span>
+        )}
+        {step.summary && (
+          <span
+            className={cn(
+              "ml-auto shrink-0 font-medium",
+              step.success ? "text-success" : "text-error"
+            )}
+          >
+            {step.summary}
+          </span>
+        )}
+        {hasData && (
+          <span className="text-ink-tertiary ml-1 shrink-0">
+            {showExpanded ? (
+              <ChevronDown className="h-3 w-3" />
+            ) : (
+              <ChevronRight className="h-3 w-3" />
+            )}
+          </span>
+        )}
+      </button>
+
+      {isIngest && hasProgress && (
+        <div className="border-primary/20 bg-primary/5 mx-3.5 mb-2.5 overflow-hidden rounded-lg border">
+          <div className="flex items-center gap-2 px-3 py-2">
+            <div className="relative h-8 w-8 shrink-0">
+              <svg className="h-8 w-8 -rotate-90" viewBox="0 0 32 32">
+                <circle
+                  cx="16"
+                  cy="16"
+                  r="13"
+                  fill="none"
+                  stroke="currentColor"
+                  strokeWidth="3"
+                  className="text-border"
+                />
+                <circle
+                  cx="16"
+                  cy="16"
+                  r="13"
+                  fill="none"
+                  stroke="currentColor"
+                  strokeWidth="3"
+                  className="text-primary transition-all duration-500"
+                  strokeDasharray={`${progressPct * 0.8168} 81.68`}
+                  strokeLinecap="round"
+                />
+              </svg>
+              <span className="text-primary absolute inset-0 flex items-center justify-center text-[9px] font-bold">
+                {progressPct}%
+              </span>
+            </div>
+            <div className="min-w-0 flex-1">
+              <p className="text-ink truncate text-[11px] font-medium">{step.progressMessage}</p>
+              <p className="text-ink-tertiary text-[10px]">
+                {step.progressCurrent ?? 0} / {step.progressTotal ?? 0} 篇
+              </p>
+            </div>
+            <Loader2 className="text-primary/60 h-4 w-4 animate-spin" />
+          </div>
+          <div className="bg-border/50 h-1">
+            <div
+              className="bg-primary h-full transition-all duration-500 ease-out"
+              style={{ width: `${progressPct}%` }}
+            />
+          </div>
+        </div>
+      )}
+
+      {!isIngest && hasProgress && (
+        <div className="bg-border mx-3.5 mb-2 h-1.5 overflow-hidden rounded-full">
+          <div
+            className="bg-primary h-full rounded-full transition-all duration-300 ease-out"
+            style={{ width: `${progressPct}%` }}
+          />
+        </div>
+      )}
+
+      {showExpanded && step.data && (
+        <div className="border-border-light bg-page border-t px-3.5 py-2.5">
+          <StepDataView data={step.data} toolName={step.toolName} />
+        </div>
+      )}
+    </div>
+  );
+}
+
+export { UserMessage, AssistantMessage, StepGroupCard, StepRow };
diff --git a/frontend/src/pages/AgentSteps.tsx b/frontend/src/pages/AgentSteps.tsx
new file mode 100644
index 0000000..3b33b85
--- /dev/null
+++ b/frontend/src/pages/AgentSteps.tsx
@@ -0,0 +1,594 @@
+import { memo, useState, Suspense } from "react";
+import { useNavigate } from "react-router-dom";
+import { cn } from "@/lib/utils";
+import {
+  CheckCircle2,
+  XCircle,
+  Loader2,
+  Download,
+  Search,
+  BookOpen,
+  FileText,
+  Brain,
+  Newspaper,
+  Star,
+  Hash,
+  TrendingUp,
+  AlertTriangle,
+} from "lucide-react";
+import { useAgentSession, type StepItem } from "@/contexts/AgentSessionContext";
+import { lazy } from "react";
+const Markdown = lazy(() => import("@/components/Markdown"));
+
+interface ToolMeta {
+  icon: typeof Search;
+  label: string;
+}
+
+function getToolMeta(name: string): ToolMeta {
+  const META: Record<string, ToolMeta> = {
+    search_arxiv: { icon: Search, label: "搜索 arXiv" },
+    search_papers: { icon: Search, label: "搜索论文库" },
+    ingest_arxiv: { icon: Download, label: "下载入库" },
+    get_system_status: { icon: Brain, label: "系统状态" },
+    list_topics: { icon: Hash, label: "主题列表" },
+    get_timeline: { icon: TrendingUp, label: "时间线" },
+    get_similar_papers: { icon: Star, label: "相似论文" },
+    get_citation_tree: { icon: BookOpen, label: "引用树" },
+    suggest_keywords: { icon: Hash, label: "关键词建议" },
+    ask_knowledge_base: { icon: Brain, label: "知识库问答" },
+    skim_paper: { icon: FileText, label: "粗读论文" },
+    deep_read_paper: { icon: BookOpen, label: "精读论文" },
+    reasoning_analysis: { icon: Brain, label: "推理链分析" },
+    analyze_figures: { icon: FileText, label: "图表解读" },
+    identify_research_gaps: { icon: Search, label: "研究空白" },
+    get_paper_detail: { icon: FileText, label: "论文详情" },
+    writing_assist: { icon: Newspaper, label: "写作助手" },
+  };
+  return META[name] || { icon: FileText, label: name };
+}
+
+function PaperListView({ papers, label }: { papers: Array<Record<string, unknown>>; label: string }) {
+  const navigate = useNavigate();
+  return (
+    <div className="space-y-1">
+      <p className="text-ink-secondary px-2 py-1 text-[11px]">{label}</p>
+      {papers.slice(0, 5).map((p, i) => (
+        <button
+          type="button"
+          key={i}
+          onClick={() => p.id && navigate(`/papers/${String(p.id)}`)}
+          className="bg-surface hover:bg-hover flex w-full items-center gap-2 rounded-lg px-2.5 py-1.5 text-left text-[11px] transition-colors"
+        >
+          <FileText className="text-primary h-3 w-3 shrink-0" />
+          <span className="text-ink truncate">{String(p.title ?? "")}</span>
+        </button>
+      ))}
+    </div>
+  );
+}
+
+function IngestResultView({ data }: { data: Record<string, unknown> }) {
+  const navigate = useNavigate();
+  return (
+    <div className="space-y-2 px-2 py-1.5">
+      <div className="flex items-center gap-3 text-[11px]">
+        <span className="text-ink font-medium">已入库 {String(data.total ?? 0)} 篇</span>
+        {data.skipped !== undefined && <span className="text-ink-tertiary">（{String(data.skipped)} 篇跳过）</span>}
+      </div>
+      {Array.isArray(data.papers) && (data.papers as Array<Record<string, unknown>>).length > 0 && (
+        <div className="space-y-1">
+          {(data.papers as Array<Record<string, unknown>>).slice(0, 3).map((p, i) => (
+            <button
+              type="button"
+              key={i}
+              onClick={() => p.id && navigate(`/papers/${String(p.id)}`)}
+              className="bg-surface hover:bg-hover flex w-full items-center gap-2 rounded-lg px-2 py-1 text-left text-[10px] transition-colors"
+            >
+              <CheckCircle2 className="text-success h-3 w-3 shrink-0" />
+              <span className="text-ink truncate">{String(p.title ?? "")}</span>
+            </button>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}
+
+function inferRelevantCategories(query: string): Set<string> {
+  const cats: string[] = [];
+  const LOWER = query.toLowerCase();
+  const ALIASES: Record<string, string[]> = {
+    "cs.AI": ["artificial intelligence", "ai", "machine learning", "ml", "deep learning", "neural", "gpt", "llm", "transformer", "reinforcement learning", "nlp", "natural language"],
+    "cs.CV": ["computer vision", "cv", "image", "video", "object detection", "segmentation", "recognition", "gan", "diffusion", "stable diffusion", "dino"],
+    "cs.LG": ["machine learning", "ml", "deep learning", "neural network", "representation", "self-supervised", "contrastive"],
+    "cs.CL": ["computational linguistics", "nlp", "natural language", "text", "language model", "translation", "parsing", "word2vec", "bert", "embedding"],
+    "cs.IR": ["information retrieval", "search", "ranking", "recommender", "recommendation"],
+    "cs.KR": ["knowledge representation", "reasoning", "logic", "knowledge graph"],
+    "cs.Robotics": ["robotics", "robot", "autonomous", "manipulation", "navigation"],
+    "cs.NE": ["neural evolution", "evolutionary", "genetic algorithm"],
+    "cs.SE": ["software engineering", "program synthesis", "code generation"],
+    "cs.CR": ["cryptography", "security", "privacy"],
+    "cs.CY": ["cybersecurity", "security", "privacy", "attack", "defense"],
+    "cs.DC": ["distributed computing", "parallel", "grid", "cluster"],
+    "cs.DS": ["data science", "analytics", "data mining", "big data"],
+    "cs.DB": ["database", "sql", "nosql", "query"],
+    "cs.PL": ["programming language", "compiler", "type system", "parser"],
+    "cs.HCI": ["human computer interaction", "ux", "ui", "interface", "vr", "ar", "virtual reality", "augmented reality"],
+    "cs.GR": ["graphics", "rendering", "3d", "geometry", "animation"],
+    "cs.MM": ["multimedia", "video", "audio", "speech"],
+    "cs.SD": ["sound", "audio", "speech", "music"],
+    "cs.LO": ["logic", "formal", "theorem proving", "coq", "lean"],
+    "cs.MA": ["mathematics", "algebra", "geometry", "calculus", "optimization"],
+    "cs.RO": ["optimization", "operations research", "linear programming", "integer programming"],
+    "cs.ET": ["emerging technology", "blockchain", "web3", "metaverse"],
+    "cs.CG": ["computational geometry", "geometry", "mesh", "voronoi"],
+    "cs.AP": ["applied computing", "e-commerce", "finance", "health", "medicine", "biology", "bioinformatics"],
+  };
+  for (const [cat, kwList] of Object.entries(ALIASES)) {
+    if (kwList.some((kw) => LOWER.includes(kw))) {
+      cats.push(cat);
+    }
+  }
+  return new Set(cats);
+}
+
+function isRelevantCandidate(cats: string[], relevantCats: Set<string>): boolean {
+  if (relevantCats.size === 0) return true;
+  return cats.some((c) => relevantCats.has(c));
+}
+
+const ArxivCandidateSelector = memo(function ArxivCandidateSelector({
+  candidates,
+  query,
+}: {
+  candidates: Array<Record<string, unknown>>;
+  query: string;
+}) {
+  const { sendMessage, loading } = useAgentSession();
+  const relevantCats = inferRelevantCategories(query);
+
+  const [selected, setSelected] = useState<Set<string>>(() => {
+    if (relevantCats.size === 0) return new Set(candidates.map((c) => String(c.arxiv_id ?? "")));
+    const relevant = new Set<string>();
+    for (const c of candidates) {
+      const cats = Array.isArray(c.categories) ? (c.categories as string[]) : [];
+      if (isRelevantCandidate(cats, relevantCats)) relevant.add(String(c.arxiv_id ?? ""));
+    }
+    return relevant.size > 0 ? relevant : new Set(candidates.map((c) => String(c.arxiv_id ?? "")));
+  });
+  const [submitted, setSubmitted] = useState(false);
+  const allSelected = selected.size === candidates.length;
+  const relevantCount =
+    relevantCats.size > 0
+      ? candidates.filter((c) => isRelevantCandidate(Array.isArray(c.categories) ? (c.categories as string[]) : [], relevantCats)).length
+      : candidates.length;
+
+  const toggle = (id: string) => {
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      return next;
+    });
+  };
+
+  const selectRelevant = () => {
+    const relevant = new Set<string>();
+    for (const c of candidates) {
+      const cats = Array.isArray(c.categories) ? (c.categories as string[]) : [];
+      if (isRelevantCandidate(cats, relevantCats)) relevant.add(String(c.arxiv_id ?? ""));
+    }
+    setSelected(relevant);
+  };
+
+  const handleSubmit = () => {
+    if (selected.size === 0 || submitted) return;
+    setSubmitted(true);
+    const ids = Array.from(selected).join(", ");
+    sendMessage(`请将以下论文入库：${ids}`).catch(() => {
+      setSubmitted(false);
+    });
+  };
+
+  return (
+    <div className="space-y-2">
+      <div className="flex items-center justify-between">
+        <p className="text-ink-secondary text-[11px] font-medium">
+          {candidates.length} 篇候选论文
+          {relevantCats.size > 0 && relevantCount < candidates.length && (
+            <span className="text-success ml-1">（{relevantCount} 篇高相关）</span>
+          )}
+        </p>
+        <div className="flex items-center gap-1.5">
+          {relevantCats.size > 0 && relevantCount < candidates.length && (
+            <button type="button" onClick={selectRelevant} className="text-success hover:bg-success/10 rounded-md px-2 py-0.5 text-[10px] font-medium transition-colors">
+              仅选相关
+            </button>
+          )}
+          <button
+            type="button"
+            onClick={() => setSelected(allSelected ? new Set() : new Set(candidates.map((c) => String(c.arxiv_id ?? ""))))}
+            className="text-primary hover:bg-primary/10 rounded-md px-2 py-0.5 text-[10px] font-medium transition-colors"
+          >
+            {allSelected ? "取消全选" : "全选"}
+          </button>
+          <span className="text-ink-tertiary text-[10px]">已选 {selected.size}/{candidates.length}</span>
+        </div>
+      </div>
+      <div className="max-h-64 space-y-1 overflow-y-auto">
+        {candidates.map((p, i) => {
+          const aid = String(p.arxiv_id ?? "");
+          const isChecked = selected.has(aid);
+          const cats = Array.isArray(p.categories) ? (p.categories as string[]) : [];
+          const isRelevant = isRelevantCandidate(cats, relevantCats);
+          return (
+            <label
+              key={aid || i}
+              className={cn(
+                "flex cursor-pointer items-start gap-2.5 rounded-lg px-2.5 py-2 text-[11px] transition-colors",
+                isChecked ? "bg-primary/5 border border-primary/20" : "bg-surface hover:bg-hover border border-transparent",
+                !isRelevant && relevantCats.size > 0 && "opacity-60"
+              )}
+            >
+              <input
+                type="checkbox"
+                checked={isChecked}
+                onChange={() => toggle(aid)}
+                disabled={submitted}
+                className="border-border text-primary focus:ring-primary/20 mt-1 h-3.5 w-3.5 shrink-0 rounded"
+              />
+              <div className="min-w-0 flex-1">
+                <div className="flex items-start gap-1.5">
+                  <p className="text-ink flex-1 leading-snug font-medium">{String(p.title ?? "")}</p>
+                  {isRelevant && relevantCats.size > 0 && (
+                    <span className="bg-success/10 text-success shrink-0 rounded px-1.5 py-0.5 text-[9px] font-medium">相关</span>
+                  )}
+                </div>
+                <div className="text-ink-tertiary mt-0.5 flex flex-wrap items-center gap-1.5 text-[10px]">
+                  {p.arxiv_id ? <span className="font-mono">{aid}</span> : null}
+                  {p.publication_date ? <span>{String(p.publication_date)}</span> : null}
+                  {cats.slice(0, 3).map((c) => (
+                    <span key={c} className={cn("rounded px-1 py-px font-mono text-[9px]", relevantCats.has(c) ? "bg-primary/10 text-primary" : "bg-ink/5 text-ink-tertiary")}>
+                      {c}
+                    </span>
+                  ))}
+                </div>
+                {Array.isArray(p.authors) && (p.authors as string[]).length > 0 && (
+                  <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">{(p.authors as string[]).slice(0, 3).join(", ")}</p>
+                )}
+              </div>
+            </label>
+          );
+        })}
+      </div>
+      {!submitted ? (
+        <button
+          type="button"
+          onClick={handleSubmit}
+          disabled={selected.size === 0 || loading}
+          className="bg-primary hover:bg-primary-hover flex w-full items-center justify-center gap-2 rounded-xl px-4 py-2.5 text-sm font-medium text-white transition-all disabled:opacity-50"
+        >
+          <Download className="h-4 w-4" />
+          入库选中 ({selected.size} 篇)
+        </button>
+      ) : (
+        <div className="bg-primary/10 text-primary flex items-center justify-center gap-2 rounded-xl px-4 py-2.5 text-sm font-medium">
+          <Loader2 className="h-4 w-4 animate-spin" />
+          已发送请求，等待确认后开始入库…
+        </div>
+      )}
+    </div>
+  );
+});
+
+const StepDataView = memo(function StepDataView({ data, toolName }: { data: Record<string, unknown>; toolName: string }) {
+  const navigate = useNavigate();
+
+  if (toolName === "search_papers" && Array.isArray(data.papers)) {
+    return <PaperListView papers={data.papers as Array<Record<string, unknown>>} label={`找到 ${(data.papers as unknown[]).length} 篇论文`} />;
+  }
+  if (toolName === "search_arxiv" && Array.isArray(data.candidates)) {
+    return <ArxivCandidateSelector candidates={data.candidates as Array<Record<string, unknown>>} query={String(data.query ?? "")} />;
+  }
+  if (toolName === "ingest_arxiv" && data.total !== undefined) {
+    return <IngestResultView data={data} />;
+  }
+  if (toolName === "get_system_status") {
+    return (
+      <div className="grid grid-cols-3 gap-2">
+        {[
+          { label: "论文", value: data.paper_count, color: "text-primary" },
+          { label: "已向量化", value: data.embedded_count, color: "text-success" },
+          { label: "主题", value: data.topic_count, color: "text-blue-600 dark:text-blue-400" },
+        ].map((s) => (
+          <div key={s.label} className="bg-surface flex flex-col items-center rounded-lg py-2">
+            <span className={cn("text-base font-bold", s.color)}>{String(s.value ?? 0)}</span>
+            <span className="text-ink-tertiary text-[10px]">{s.label}</span>
+          </div>
+        ))}
+      </div>
+    );
+  }
+  if (toolName === "ask_knowledge_base" && data.markdown) {
+    const evidence = Array.isArray(data.evidence) ? (data.evidence as Array<Record<string, unknown>>) : [];
+    const rounds = data.rounds as number | undefined;
+    return (
+      <div className="space-y-2">
+        {rounds && rounds > 1 && (
+          <div className="text-primary flex items-center gap-1.5 text-[10px]">
+            <TrendingUp className="h-3 w-3" />
+            <span>经过 {rounds} 轮迭代检索优化</span>
+          </div>
+        )}
+        <div className="prose prose-sm dark:prose-invert max-w-none text-[12px] leading-relaxed">
+          <Suspense fallback={<div className="bg-surface h-4 animate-pulse rounded" />}><Markdown>{String(data.markdown)}</Markdown></Suspense>
+        </div>
+        {evidence.length > 0 && (
+          <div className="border-border-light border-t pt-2">
+            <p className="text-ink-tertiary mb-1 text-[10px] font-medium">引用 {evidence.length} 篇论文</p>
+            <div className="flex flex-wrap gap-1">
+              {evidence.slice(0, 8).map((e, i) => (
+                <button type="button" key={i} onClick={() => e.paper_id && navigate(`/papers/${String(e.paper_id)}`)} className="bg-surface text-ink-secondary hover:bg-hover hover:text-primary max-w-[200px] truncate rounded px-1.5 py-0.5 text-[9px] transition-colors" title={String(e.title ?? "")}>
+                  {String(e.title ?? "").slice(0, 40)}{String(e.title ?? "").length > 40 ? "..." : ""}
+                </button>
+              ))}
+            </div>
+          </div>
+        )}
+      </div>
+    );
+  }
+  if (toolName === "list_topics" && Array.isArray(data.topics)) {
+    const topics = data.topics as Array<Record<string, unknown>>;
+    return (
+      <div className="space-y-1">
+        {topics.map((t, i) => (
+          <div key={i} className="bg-surface flex items-center gap-2 rounded-lg px-2.5 py-1.5 text-[11px]">
+            <Hash className="text-primary h-3 w-3 shrink-0" />
+            <span className="text-ink font-medium">{String(t.name ?? "")}</span>
+            {t.paper_count !== undefined && <span className="text-ink-tertiary">{String(t.paper_count)} 篇</span>}
+            {t.enabled !== undefined && (
+              <span className={cn("ml-auto rounded px-1.5 py-0.5 text-[9px]", t.enabled ? "bg-success/10 text-success" : "bg-ink/5 text-ink-tertiary")}>
+                {t.enabled ? "已订阅" : "未订阅"}
+              </span>
+            )}
+          </div>
+        ))}
+      </div>
+    );
+  }
+  if (toolName === "get_timeline" && Array.isArray(data.timeline)) {
+    const items = data.timeline as Array<Record<string, unknown>>;
+    return (
+      <div className="max-h-48 space-y-1 overflow-y-auto">
+        {items.map((p, i) => (
+          <button type="button" key={i} onClick={() => p.paper_id && navigate(`/papers/${String(p.paper_id)}`)} className="bg-surface hover:bg-hover flex w-full items-center gap-2 rounded-lg px-2.5 py-1.5 text-left text-[11px] transition-colors">
+            <span className="text-primary shrink-0 font-mono text-[10px]">{String(p.year ?? "?")}</span>
+            <span className="text-ink truncate">{String(p.title ?? "")}</span>
+          </button>
+        ))}
+      </div>
+    );
+  }
+  if (toolName === "get_similar_papers") {
+    const items = Array.isArray(data.items) ? (data.items as Array<Record<string, unknown>>) : [];
+    const ids = Array.isArray(data.similar_ids) ? (data.similar_ids as string[]) : [];
+    if (items.length > 0) {
+      return (
+        <div className="space-y-1">
+          {items.map((p, i) => (
+            <button type="button" key={i} onClick={() => p.id && navigate(`/papers/${String(p.id)}`)} className="bg-surface hover:bg-hover flex w-full items-center gap-2 rounded-lg px-2.5 py-1.5 text-left text-[11px] transition-colors">
+              <Star className="h-3 w-3 shrink-0 text-amber-500" />
+              <span className="text-ink truncate">{String(p.title ?? "")}</span>
+            </button>
+          ))}
+        </div>
+      );
+    }
+    if (ids.length > 0) return <p className="text-ink-secondary text-[11px]">找到 {ids.length} 篇相似论文</p>;
+  }
+  if (toolName === "get_citation_tree" && data.nodes) {
+    const nodes = Array.isArray(data.nodes) ? data.nodes.length : 0;
+    const edges = Array.isArray(data.edges) ? data.edges.length : 0;
+    return (
+      <div className="flex items-center gap-3 text-[11px]">
+        <span className="text-ink font-medium">{nodes} 个节点</span>
+        <span className="text-ink-tertiary">{edges} 条引用关系</span>
+      </div>
+    );
+  }
+  if (toolName === "suggest_keywords" && Array.isArray(data.suggestions)) {
+    const suggestions = data.suggestions as Array<Record<string, unknown>>;
+    return (
+      <div className="space-y-1.5">
+        {suggestions.map((s, i) => (
+          <div key={i} className="bg-surface rounded-lg px-2.5 py-2 text-[11px]">
+            <p className="text-ink font-medium">{String(s.name ?? "")}</p>
+            <p className="text-primary mt-0.5 font-mono text-[10px]">{String(s.query ?? "")}</p>
+            {s.reason !== undefined && <p className="text-ink-tertiary mt-0.5 text-[10px]">{String(s.reason)}</p>}
+          </div>
+        ))}
+      </div>
+    );
+  }
+  if ((toolName === "skim_paper" || toolName === "deep_read_paper") && data.one_liner) {
+    return (
+      <div className="text-[11px]">
+        <p className="text-ink font-medium">{String(data.one_liner)}</p>
+        {data.novelty !== undefined && <p className="text-ink-secondary mt-1"><span className="font-medium">创新点:</span> {String(data.novelty)}</p>}
+        {data.methodology !== undefined && <p className="text-ink-secondary mt-0.5"><span className="font-medium">方法:</span> {String(data.methodology)}</p>}
+      </div>
+    );
+  }
+  if (toolName === "reasoning_analysis" && data.reasoning_steps) {
+    const steps = Array.isArray(data.reasoning_steps) ? (data.reasoning_steps as Array<Record<string, unknown>>) : [];
+    return (
+      <div className="max-h-48 space-y-1.5 overflow-y-auto">
+        {steps.slice(0, 6).map((s, i) => (
+          <div key={i} className="bg-surface rounded-lg px-2.5 py-1.5 text-[11px]">
+            <p className="text-ink font-medium">{String(s.step_name ?? s.claim ?? `步骤 ${i + 1}`)}</p>
+            {s.evidence !== undefined && <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">{String(s.evidence)}</p>}
+          </div>
+        ))}
+      </div>
+    );
+  }
+  if (toolName === "analyze_figures" && Array.isArray(data.figures)) {
+    const figs = data.figures as Array<Record<string, unknown>>;
+    return (
+      <div className="space-y-1">
+        {figs.map((f, i) => (
+          <div key={i} className="bg-surface rounded-lg px-2.5 py-1.5 text-[11px]">
+            <p className="text-ink font-medium">{String(f.figure_type ?? "图表")} — p.{String(f.page ?? "?")}</p>
+            <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">{String(f.description ?? f.analysis ?? "")}</p>
+          </div>
+        ))}
+      </div>
+    );
+  }
+  if (toolName === "identify_research_gaps" && data.analysis) {
+    const analysis = data.analysis as Record<string, unknown>;
+    const gaps = Array.isArray(analysis.research_gaps) ? (analysis.research_gaps as Array<Record<string, unknown>>) : [];
+    return (
+      <div className="space-y-1.5">
+        {gaps.slice(0, 5).map((g, i) => (
+          <div key={i} className="bg-surface rounded-lg px-2.5 py-1.5 text-[11px]">
+            <p className="text-ink font-medium">{String(g.gap_title ?? g.title ?? `空白 ${i + 1}`)}</p>
+            <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">{String(g.description ?? g.evidence ?? "")}</p>
+          </div>
+        ))}
+      </div>
+    );
+  }
+  if (toolName === "get_paper_detail" && data.title) {
+    return (
+      <div className="text-[11px]">
+        <button type="button" onClick={() => data.id && navigate(`/papers/${String(data.id)}`)} className="text-primary font-medium hover:underline">
+          {String(data.title)}
+        </button>
+        {data.abstract_zh !== undefined && <p className="text-ink-secondary mt-1 line-clamp-3">{String(data.abstract_zh)}</p>}
+        <div className="text-ink-tertiary mt-1 flex flex-wrap gap-1.5 text-[10px]">
+          {data.arxiv_id ? <span className="font-mono">{String(data.arxiv_id)}</span> : null}
+          {data.read_status ? <span>{String(data.read_status)}</span> : null}
+        </div>
+      </div>
+    );
+  }
+  if (toolName === "writing_assist" && data.content) {
+    return (
+      <div className="prose prose-sm dark:prose-invert max-h-48 max-w-none overflow-y-auto text-[12px]">
+        <Suspense fallback={<div className="bg-surface h-4 animate-pulse rounded" />}><Markdown>{String(data.content)}</Markdown></Suspense>
+      </div>
+    );
+  }
+  return <pre className="bg-surface text-ink-secondary max-h-40 overflow-auto rounded-lg p-2.5 text-[11px]">{JSON.stringify(data, null, 2)}</pre>;
+});
+
+export { getToolMeta, ArxivCandidateSelector, StepDataView, ActionConfirmCard };
+
+const ActionConfirmCard = memo(function ActionConfirmCard({
+  actionId,
+  description,
+  tool,
+  args,
+  isPending,
+  isConfirming,
+  onConfirm,
+  onReject,
+}: {
+  actionId: string;
+  description: string;
+  tool: string;
+  args?: Record<string, unknown>;
+  isPending: boolean;
+  isConfirming: boolean;
+  onConfirm: (id: string) => void;
+  onReject: (id: string) => void;
+}) {
+  const meta = getToolMeta(tool);
+  const Icon = meta.icon;
+  return (
+    <div className="py-2">
+      <div
+        className={cn(
+          "bg-surface overflow-hidden rounded-xl border transition-all",
+          isPending
+            ? "border-warning/60 shadow-warning/10 animate-[confirm-glow_2s_ease-in-out_infinite] shadow-md"
+            : "border-border"
+        )}
+      >
+        <div
+          className={cn(
+            "flex items-center gap-2 px-3.5 py-2.5",
+            isPending ? "bg-warning-light" : "bg-page"
+          )}
+        >
+          <AlertTriangle
+            className={cn(
+              "h-3.5 w-3.5",
+              isPending ? "text-warning animate-pulse" : "text-ink-tertiary"
+            )}
+          />
+          <span className="text-ink text-xs font-semibold">
+            {isPending ? "⚠️ 需要你的确认" : "已处理"}
+          </span>
+        </div>
+        <div className="space-y-3 px-3.5 py-3">
+          <div className="flex items-start gap-2.5">
+            <div className="bg-warning-light flex h-8 w-8 shrink-0 items-center justify-center rounded-lg">
+              <Icon className="text-warning h-4 w-4" />
+            </div>
+            <div>
+              <p className="text-ink text-sm font-medium">{description}</p>
+              {args && Object.keys(args).length > 0 && (
+                <div className="bg-page mt-1.5 rounded-lg px-2.5 py-1.5">
+                  {Object.entries(args).map(([k, v]) => (
+                    <div key={k} className="flex gap-1.5 text-[11px]">
+                      <span className="text-ink-secondary font-medium">{k}:</span>
+                      <span className="text-ink-tertiary">
+                        {typeof v === "string" ? v : JSON.stringify(v)}
+                      </span>
+                    </div>
+                  ))}
+                </div>
+              )}
+            </div>
+          </div>
+          {isPending && (
+            <div className="flex gap-2">
+              <button
+                type="button"
+                onClick={() => onConfirm(actionId)}
+                disabled={isConfirming}
+                className="bg-primary hover:bg-primary-hover flex flex-1 items-center justify-center gap-1.5 rounded-lg py-2 text-xs font-medium text-white transition-all disabled:opacity-50"
+              >
+                {isConfirming ? (
+                  <Loader2 className="h-3.5 w-3.5 animate-spin" />
+                ) : (
+                  <CheckCircle2 className="h-3.5 w-3.5" />
+                )}
+                确认执行
+              </button>
+              <button
+                type="button"
+                onClick={() => onReject(actionId)}
+                disabled={isConfirming}
+                className="border-border bg-surface text-ink-secondary hover:bg-hover flex flex-1 items-center justify-center gap-1.5 rounded-lg border py-2 text-xs font-medium transition-all disabled:opacity-50"
+              >
+                <XCircle className="h-3.5 w-3.5" />
+                跳过
+              </button>
+            </div>
+          )}
+          {!isPending && (
+            <div className="text-success flex items-center gap-1 text-[11px]">
+              <CheckCircle2 className="h-3 w-3" />
+              已处理
+            </div>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+});
diff --git a/frontend/src/pages/ChatNavBar.tsx b/frontend/src/pages/ChatNavBar.tsx
new file mode 100644
index 0000000..56102c8
--- /dev/null
+++ b/frontend/src/pages/ChatNavBar.tsx
@@ -0,0 +1,136 @@
+import { memo, useState, useCallback, useRef, useEffect } from "react";
+import { cn } from "@/lib/utils";
+import type { ChatItem } from "@/contexts/AgentSessionContext";
+
+interface ChatNavBarProps {
+  items: ChatItem[];
+  scrollAreaRef: React.RefObject<HTMLDivElement | null>;
+}
+
+interface UserMessageMarker {
+  id: string;
+  content: string;
+  top: number;
+  height: number;
+}
+
+const ChatNavBar = memo(function ChatNavBar({ items, scrollAreaRef }: ChatNavBarProps) {
+  const [hoveredId, setHoveredId] = useState<string | null>(null);
+  const [markers, setMarkers] = useState<UserMessageMarker[]>([]);
+  const rafRef = useRef<number | null>(null);
+
+  const updateMarkers = useCallback(() => {
+    const scrollEl = scrollAreaRef.current;
+    if (!scrollEl) return;
+
+    const userMessages = items.filter((item) => item.type === "user");
+    if (userMessages.length === 0) {
+      setMarkers([]);
+      return;
+    }
+
+    const scrollRect = scrollEl.getBoundingClientRect();
+
+    const newMarkers: UserMessageMarker[] = [];
+    for (const item of userMessages) {
+      const msgEl = scrollEl.querySelector(`[data-message-id="${item.id}"]`);
+      if (msgEl) {
+        const rect = msgEl.getBoundingClientRect();
+        newMarkers.push({
+          id: item.id,
+          content: item.content.slice(0, 300) + (item.content.length > 300 ? "..." : ""),
+          top: rect.top - scrollRect.top,
+          height: rect.height,
+        });
+      }
+    }
+    setMarkers(newMarkers);
+  }, [items, scrollAreaRef]);
+
+  useEffect(() => {
+    const scrollEl = scrollAreaRef.current;
+    if (!scrollEl) return;
+
+    const handleScroll = () => {
+      if (rafRef.current) return;
+      rafRef.current = requestAnimationFrame(() => {
+        rafRef.current = null;
+        updateMarkers();
+      });
+    };
+
+    updateMarkers();
+    scrollEl.addEventListener("scroll", handleScroll, { passive: true });
+    return () => scrollEl.removeEventListener("scroll", handleScroll);
+  }, [items, scrollAreaRef, updateMarkers]);
+
+  const jumpToMessage = useCallback(
+    (msgId: string) => {
+      const scrollEl = scrollAreaRef.current;
+      if (!scrollEl) return;
+      const msgEl = scrollEl.querySelector(`[data-message-id="${msgId}"]`);
+      if (msgEl) {
+        msgEl.scrollIntoView({ behavior: "smooth", block: "start" });
+      }
+    },
+    [scrollAreaRef]
+  );
+
+  if (markers.length === 0) return null;
+
+  return (
+    <div
+      className="pointer-events-none fixed top-[120px] right-4 z-20 flex w-6 flex-col items-center"
+      style={{ height: "calc(100vh - 200px)" }}
+      onMouseLeave={() => setHoveredId(null)}
+    >
+      <div className="pointer-events-auto relative w-full flex-1">
+        <div className="bg-border/30 absolute top-0 left-1/2 h-full w-0.5 -translate-x-1/2 rounded-full" />
+        {markers.map((marker) => {
+          return (
+            <div
+              key={marker.id}
+              className="group absolute left-1/2 -translate-x-1/2"
+              style={{ top: `${marker.top}px` }}
+            >
+              <button
+                type="button"
+                onClick={() => jumpToMessage(marker.id)}
+                onMouseEnter={() => setHoveredId(marker.id)}
+                onMouseLeave={() => setHoveredId(null)}
+                className={cn(
+                  "border-primary h-2.5 w-2.5 rounded-full border-2 bg-white transition-all duration-200",
+                  "hover:h-3.5 hover:w-3.5 hover:shadow-md",
+                  "focus:ring-primary/50 focus:ring-2 focus:outline-none"
+                )}
+              />
+
+              {hoveredId === marker.id && (
+                <div
+                  className={cn(
+                    "absolute top-1/2 right-7 -translate-y-1/2",
+                    "bg-surface border-border rounded-lg border shadow-lg",
+                    "text-ink w-72 px-3 py-2 text-xs",
+                    "animate-in fade-in slide-in-from-right-2 duration-200"
+                  )}
+                >
+                  <span className="bg-primary/10 text-primary rounded px-1.5 py-0.5 text-[10px] font-medium">
+                    用户
+                  </span>
+                  <p className="text-ink-secondary mt-1 max-h-32 overflow-y-auto leading-relaxed break-words whitespace-pre-wrap">
+                    {marker.content}
+                  </p>
+                  <div className="absolute top-1/2 right-0 translate-x-2 -translate-y-1/2">
+                    <div className="border-l-surface border-4 border-transparent" />
+                  </div>
+                </div>
+              )}
+            </div>
+          );
+        })}
+      </div>
+    </div>
+  );
+});
+
+export { ChatNavBar };
diff --git a/packages/ai/agent_service.py b/packages/ai/agent_service.py
index c6861a3..d6fa7e5 100644
--- a/packages/ai/agent_service.py
+++ b/packages/ai/agent_service.py
@@ -303,7 +303,7 @@ def _llm_loop(
         text_buf = ""
         tool_calls: list[StreamEvent] = []
 
-        for event in llm.chat_stream(openai_msgs, tools=tools, max_tokens=4096):
+        for event in llm.chat_stream(openai_msgs, tools=tools, max_tokens=8192):
             if event.type == "text_delta":
                 text_buf += event.content
                 yield _make_sse("text_delta", {"content": event.content})

From 65f6e8e02d32d54fc948b41c13be481a23e2aacd Mon Sep 17 00:00:00 2001
From: Color2333 <1552429809@qq.com>
Date: Thu, 19 Mar 2026 19:18:02 +0800
Subject: [PATCH 3/4] =?UTF-8?q?chore(frontend):=20=E6=B7=BB=E5=8A=A0=20@ta?=
 =?UTF-8?q?nstack/react-virtual=20=E4=BE=9D=E8=B5=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .pre-commit-config.yaml | 9 ++-------
 frontend/package.json   | 1 +
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 12f0893..362691b 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -11,13 +11,8 @@ repos:
         args: [--fix, --exit-non-zero-on-fix]
       - id: ruff-format
 
-  # TypeScript/JavaScript - Prettier
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v3.4.2
-    hooks:
-      - id: prettier
-        files: \.(ts|tsx|js|jsx|json|css|md)$
-        exclude: ^frontend/node_modules/
+  # TypeScript/JavaScript - 通过 npm scripts 格式化 (prettier 在 node_modules 中)
+  # 运行 npm run format 格式化前端代码
 
   # 通用检查
   - repo: https://github.com/pre-commit/pre-commit-hooks
diff --git a/frontend/package.json b/frontend/package.json
index bc64529..392a7c5 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -13,6 +13,7 @@
     "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix"
   },
   "dependencies": {
+    "@tanstack/react-virtual": "^3.13.23",
     "@tauri-apps/api": "^2.10.1",
     "@tauri-apps/plugin-dialog": "^2.6.0",
     "@tauri-apps/plugin-fs": "^2.4.5",

From 4103a7d0302b33d93e846067ed6771f4fcadb695 Mon Sep 17 00:00:00 2001
From: Color2333 <1552429809@qq.com>
Date: Thu, 19 Mar 2026 19:21:14 +0800
Subject: [PATCH 4/4] style: pre-commit fixes

---
 .env.example                         |   4 +-
 .github/workflows/opencode.yml       |   2 +-
 .github/workflows/pr-review-gate.yml |   4 +-
 README.md                            |   2 +-
 apps/api/routers/pipelines.py        |   3 -
 apps/desktop/__init__.py             |   1 -
 docker-compose.yml                   |   1 -
 docs/PaperMind.md                    |   6 +-
 docs/deployment/DOCKER_DEPLOYMENT.md |  10 +-
 docs/deployment/DOCKER_FIXES.md      |  18 +-
 docs/deployment/WIKI_DEPLOYMENT.md   |  16 +-
 frontend/index.html                  |   8 +-
 frontend/public/manifest.json        |   2 +-
 frontend/public/papermind-icon.svg   |  10 +-
 frontend/src/assets/logo-icon.svg    |  10 +-
 frontend/src/lib/tauri.ts            |   6 +-
 frontend/src/pages/Agent.tsx         | 855 +--------------------------
 logs/frontend.log                    |  12 +-
 packages/ai/brief_service.py         |  30 +-
 scripts/cleanup_unread.py            |   8 +-
 20 files changed, 80 insertions(+), 928 deletions(-)

diff --git a/.env.example b/.env.example
index 367af2f..8f74aab 100644
--- a/.env.example
+++ b/.env.example
@@ -1,11 +1,11 @@
 # ==========================================
 # PaperMind 环境配置示例
 # ==========================================
-# 
+#
 # 使用说明：
 # - 本地开发：复制为 .env（根目录）
 # - Docker部署：复制为 .env（根目录）
-# 
+#
 # 必须配置项：至少填写一个 LLM API Key
 # ==========================================
 
diff --git a/.github/workflows/opencode.yml b/.github/workflows/opencode.yml
index b767381..a60216c 100644
--- a/.github/workflows/opencode.yml
+++ b/.github/workflows/opencode.yml
@@ -30,4 +30,4 @@ jobs:
         env:
           ALIBABA_CODING_PLAN_API_KEY: ${{ secrets.ALIBABA_CODING_PLAN_API_KEY }}
         with:
-          model: alibaba-coding-plan-cn/qwen3.5-plus
\ No newline at end of file
+          model: alibaba-coding-plan-cn/qwen3.5-plus
diff --git a/.github/workflows/pr-review-gate.yml b/.github/workflows/pr-review-gate.yml
index 32cd330..1ef74c1 100644
--- a/.github/workflows/pr-review-gate.yml
+++ b/.github/workflows/pr-review-gate.yml
@@ -35,7 +35,7 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           PR_NUM="${{ steps.pr.outputs.pr_number }}"
-          
+
           BODY='## 🔍 OpenCode PR Review Required
 
           这是一个受保护的分支，merge 前需要进行 code review。
@@ -50,7 +50,7 @@ jobs:
           ---
 
           *This is an automated reminder from PR Review Gate.*'
-          
+
           gh pr comment $PR_NUM --body "$BODY"
 
       - name: Set status check to success
diff --git a/README.md b/README.md
index dbb5d0d..614d931 100644
--- a/README.md
+++ b/README.md
@@ -452,4 +452,4 @@ alembic upgrade head
 
 [![Star](https://img.shields.io/github/stars/Color2333/PaperMind?style=social)](https://github.com/Color2333/PaperMind/stargazers)
 
-</div>
\ No newline at end of file
+</div>
diff --git a/apps/api/routers/pipelines.py b/apps/api/routers/pipelines.py
index 62922ce..93ad9da 100644
--- a/apps/api/routers/pipelines.py
+++ b/apps/api/routers/pipelines.py
@@ -24,7 +24,6 @@
 
 @router.post("/pipelines/skim/{paper_id}")
 def run_skim(paper_id: UUID) -> dict:
-
     tid = f"skim_{paper_id.hex[:8]}"
     title = get_paper_title(paper_id) or str(paper_id)[:8]
     global_tracker.start(tid, "skim", f"粗读: {title[:30]}", total=1)
@@ -39,7 +38,6 @@ def run_skim(paper_id: UUID) -> dict:
 
 @router.post("/pipelines/deep/{paper_id}")
 def run_deep(paper_id: UUID) -> dict:
-
     tid = f"deep_{paper_id.hex[:8]}"
     title = get_paper_title(paper_id) or str(paper_id)[:8]
     global_tracker.start(tid, "deep_read", f"精读: {title[:30]}", total=1)
@@ -54,7 +52,6 @@ def run_deep(paper_id: UUID) -> dict:
 
 @router.post("/pipelines/embed/{paper_id}")
 def run_embed(paper_id: UUID) -> dict:
-
     tid = f"embed_{paper_id.hex[:8]}"
     title = get_paper_title(paper_id) or str(paper_id)[:8]
     global_tracker.start(tid, "embed", f"嵌入: {title[:30]}", total=1)
diff --git a/apps/desktop/__init__.py b/apps/desktop/__init__.py
index 8b13789..e69de29 100644
--- a/apps/desktop/__init__.py
+++ b/apps/desktop/__init__.py
@@ -1 +0,0 @@
-
diff --git a/docker-compose.yml b/docker-compose.yml
index a7d659c..40b87ac 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -120,4 +120,3 @@ volumes:
   pm_logs:
     name: papermind_logs
   pm_pip_cache:
-
diff --git a/docs/PaperMind.md b/docs/PaperMind.md
index a6ea1c9..e81330b 100644
--- a/docs/PaperMind.md
+++ b/docs/PaperMind.md
@@ -1,8 +1,8 @@
 # PaperMind - AI 研究工作流平台
 
-**版本:** 2.8  
-**日期:** 2026-02-19  
-**作者:** color2333  
+**版本:** 2.8
+**日期:** 2026-02-19
+**作者:** color2333
 **核心愿景:** 从"搜索论文"进化为"理解领域"。通过自动化 Agent 和 LLM，将海量文献转化为结构化的知识图谱，辅助研究者完成从"每日追踪"到"深度调研"的全过程。
 
 ---
diff --git a/docs/deployment/DOCKER_DEPLOYMENT.md b/docs/deployment/DOCKER_DEPLOYMENT.md
index d90381c..8a48326 100644
--- a/docs/deployment/DOCKER_DEPLOYMENT.md
+++ b/docs/deployment/DOCKER_DEPLOYMENT.md
@@ -1,7 +1,7 @@
 # PaperMind Docker 部署指南 - 端口预留版
 
 > 适用于已有项目占用 3001 和 8001 端口的场景
-> 
+>
 > **端口规划**:
 > - 现有项目：3001(前端) + 8001(后端)
 > - PaperMind：**3002(前端) + 8002(后端)**
@@ -346,14 +346,14 @@ ufw allow from 192.168.1.0/24 to any port 8002
 server {
     listen 443 ssl;
     server_name your-domain.com;
-    
+
     ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
     ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
-    
+
     location / {
         proxy_pass http://localhost:3002;
     }
-    
+
     location /api/ {
         proxy_pass http://localhost:8002;
     }
@@ -414,7 +414,7 @@ services:
     image: prom/prometheus
     ports:
       - "9090:9090"
-  
+
   grafana:
     image: grafana/grafana
     ports:
diff --git a/docs/deployment/DOCKER_FIXES.md b/docs/deployment/DOCKER_FIXES.md
index 7766304..0ab248b 100644
--- a/docs/deployment/DOCKER_FIXES.md
+++ b/docs/deployment/DOCKER_FIXES.md
@@ -1,7 +1,7 @@
 # PaperMind Docker 部署问题修复报告
 
 > 修复日期：2026-02-26
-> 
+>
 > 修复目标：确保 Docker 部署顺利，解决前后端配置问题
 
 ---
@@ -23,11 +23,11 @@
 export function resolveApiBase(): string {
   if (!isTauri()) {
     if (import.meta.env.VITE_API_BASE) return import.meta.env.VITE_API_BASE;
-    
+
     if (import.meta.env.DEV) {
       return "http://localhost:8000";
     }
-    
+
     // Docker 生产环境使用相对路径
     return "/api";
   }
@@ -66,19 +66,19 @@ cors_allow_origins: str = (
 location /api/ {
     # 去掉 /api 前缀，转发到后端
     rewrite ^/api/(.*) /$1 break;
-    
+
     # 后端服务地址（Docker 内部网络）
     proxy_pass http://backend:8000;
-    
+
     # WebSocket/SSE 支持
     proxy_http_version 1.1;
     proxy_set_header Upgrade $http_upgrade;
     proxy_set_header Connection "upgrade";
-    
+
     # 关闭缓冲（SSE 需要）
     proxy_buffering off;
     proxy_cache off;
-    
+
     # 超时设置
     proxy_read_timeout 120s;
 }
@@ -197,7 +197,7 @@ src/pages/Agent.tsx(346,42): error TS2552
 ...
 ```
 
-**影响**: 
+**影响**:
 - ❌ 不影响 Docker 构建（Dockerfile 使用 `npm run build` 会跳过类型检查）
 - ⚠️ 建议后续修复这些类型错误
 
@@ -221,7 +221,7 @@ result.get("saved_path", "N/A")  # Pylance 报错，但运行时正确
 
 **原因**: `result` 可能为 `None`，但实际逻辑中不会为 `None`
 
-**影响**: 
+**影响**:
 - ✅ 不影响运行
 - ✅ 不影响 Docker 构建
 
diff --git a/docs/deployment/WIKI_DEPLOYMENT.md b/docs/deployment/WIKI_DEPLOYMENT.md
index cf89504..a57febd 100644
--- a/docs/deployment/WIKI_DEPLOYMENT.md
+++ b/docs/deployment/WIKI_DEPLOYMENT.md
@@ -1,6 +1,6 @@
 # PaperMind 部署 Wiki
 
-> 📚 **完整的部署指南** - 从本地开发到生产环境，一站式搞定！  
+> 📚 **完整的部署指南** - 从本地开发到生产环境，一站式搞定！
 > 📅 最后更新：2026-03-02 | 版本：v3.1
 
 ---
@@ -216,7 +216,7 @@ docker compose ps
 # 预期输出：
 # NAME                  STATUS              PORTS
 # papermind-backend     Up (healthy)        0.0.0.0:8002->8000/tcp
-# papermind-worker      Up (healthy)        
+# papermind-worker      Up (healthy)
 # papermind-frontend    Up (healthy)        0.0.0.0:3002->80/tcp
 
 # 检查服务健康状态
@@ -255,14 +255,14 @@ services:
         reservations:
           cpus: '0.5'    # 预留 0.5 核
           memory: 512M   # 预留 512MB
-  
+
   worker:
     deploy:
       resources:
         limits:
           cpus: '2.0'
           memory: 2G
-  
+
   frontend:
     deploy:
       resources:
@@ -819,14 +819,14 @@ ufw allow from 192.168.1.0/24 to any port 8002
 server {
     listen 443 ssl;
     server_name your-domain.com;
-    
+
     ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
     ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
-    
+
     location / {
         proxy_pass http://localhost:3002;
     }
-    
+
     location /api/ {
         proxy_pass http://localhost:8002;
     }
@@ -893,7 +893,7 @@ services:
       - "9090:9090"
     volumes:
       - ./monitoring/prometheus.yml:/etc/prometheus/prometheus.yml
-  
+
   grafana:
     image: grafana/grafana
     ports:
diff --git a/frontend/index.html b/frontend/index.html
index 5274873..c746dcf 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -5,20 +5,20 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content="PaperMind - AI 驱动的学术论文研究平台，从搜索论文进化为理解领域" />
     <meta name="theme-color" content="#C4663C" />
-    
+
     <!-- Favicon -->
     <link rel="icon" type="image/svg+xml" href="/papermind-icon.svg" />
     <link rel="apple-touch-icon" href="/papermind-icon.svg" />
-    
+
     <!-- Open Graph -->
     <meta property="og:title" content="PaperMind - AI 论文研究平台" />
     <meta property="og:description" content="AI 驱动的学术论文研究平台，从搜索论文进化为理解领域" />
     <meta property="og:type" content="website" />
     <meta property="og:image" content="/papermind-icon.svg" />
-    
+
     <!-- PWA Manifest -->
     <link rel="manifest" href="/manifest.json" />
-    
+
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
diff --git a/frontend/public/manifest.json b/frontend/public/manifest.json
index e3fa586..3981924 100644
--- a/frontend/public/manifest.json
+++ b/frontend/public/manifest.json
@@ -14,4 +14,4 @@
       "purpose": "any maskable"
     }
   ]
-}
\ No newline at end of file
+}
diff --git a/frontend/public/papermind-icon.svg b/frontend/public/papermind-icon.svg
index bfaff16..eba0632 100644
--- a/frontend/public/papermind-icon.svg
+++ b/frontend/public/papermind-icon.svg
@@ -10,16 +10,16 @@
       }
     </style>
   </defs>
-  
+
   <g transform="translate(0, 2)">
     <line x1="50" y1="85" x2="50" y2="25" class="line" />
-    
+
     <path d="M 50 85 C 15 85, 10 65, 15 45 C 20 20, 40 15, 50 25" class="line" />
-    
+
     <path d="M 50 85 C 85 85, 90 65, 85 45 C 80 20, 60 15, 50 25" class="line" />
-    
+
     <path d="M 50 65 C 30 65, 25 50, 30 40 C 35 30, 45 25, 50 35" class="line" />
-    
+
     <path d="M 50 65 C 70 65, 75 50, 70 40 C 65 30, 55 25, 50 35" class="line" />
   </g>
 </svg>
diff --git a/frontend/src/assets/logo-icon.svg b/frontend/src/assets/logo-icon.svg
index bfaff16..eba0632 100644
--- a/frontend/src/assets/logo-icon.svg
+++ b/frontend/src/assets/logo-icon.svg
@@ -10,16 +10,16 @@
       }
     </style>
   </defs>
-  
+
   <g transform="translate(0, 2)">
     <line x1="50" y1="85" x2="50" y2="25" class="line" />
-    
+
     <path d="M 50 85 C 15 85, 10 65, 15 45 C 20 20, 40 15, 50 25" class="line" />
-    
+
     <path d="M 50 85 C 85 85, 90 65, 85 45 C 80 20, 60 15, 50 25" class="line" />
-    
+
     <path d="M 50 65 C 30 65, 25 50, 30 40 C 35 30, 45 25, 50 35" class="line" />
-    
+
     <path d="M 50 65 C 70 65, 75 50, 70 40 C 65 30, 55 25, 50 35" class="line" />
   </g>
 </svg>
diff --git a/frontend/src/lib/tauri.ts b/frontend/src/lib/tauri.ts
index d984600..5395763 100644
--- a/frontend/src/lib/tauri.ts
+++ b/frontend/src/lib/tauri.ts
@@ -104,18 +104,18 @@ export function resolveApiBase(): string {
   if (!isTauri()) {
     // 优先级：VITE_API_BASE > 环境变量推断 > 默认值
     if (import.meta.env.VITE_API_BASE) return import.meta.env.VITE_API_BASE;
-    
+
     // Docker 环境：使用相对路径（Nginx 反向代理）
     if (import.meta.env.DEV) {
       // 开发环境：localhost
       return "http://localhost:8000";
     }
-    
+
     // 生产环境：使用相对路径，由 Nginx 代理
     // Docker 中前端访问后端不需要完整 URL
     return "/api";
   }
-  
+
   // Tauri 桌面环境
   if (_resolvedPort) {
     return `http://127.0.0.1:${_resolvedPort}`;
diff --git a/frontend/src/pages/Agent.tsx b/frontend/src/pages/Agent.tsx
index 41479e5..462ca40 100644
--- a/frontend/src/pages/Agent.tsx
+++ b/frontend/src/pages/Agent.tsx
@@ -40,6 +40,9 @@ import {
 import { useAgentSession, type ChatItem, type StepItem } from "@/contexts/AgentSessionContext";
 import { todayApi } from "@/services/api";
 import type { TodaySummary } from "@/types";
+import { ActionConfirmCard } from "./AgentSteps";
+import { UserMessage, AssistantMessage, StepGroupCard, StepRow } from "./AgentMessages";
+import { ChatNavBar } from "./ChatNavBar";
 
 /* ========== 能力芯片（输入框上方始终显示） ========== */
 
@@ -313,6 +316,9 @@ export default function Agent() {
           )}
         </div>
 
+        {/* 对话导航条 - 固定在右侧 */}
+        <ChatNavBar items={items} scrollAreaRef={scrollAreaRef} />
+
         {/* 输入区域 */}
         <div className="border-border bg-surface border-t px-4 py-3">
           <div className="mx-auto max-w-3xl space-y-2">
@@ -587,7 +593,7 @@ const ChatBlock = memo(function ChatBlock({
 }) {
   switch (item.type) {
     case "user":
-      return <UserMessage content={item.content} />;
+      return <UserMessage content={item.content} messageId={item.id} />;
     case "assistant":
       return <AssistantMessage content={item.content} streaming={!!item.streaming} />;
     case "step_group":
@@ -627,223 +633,6 @@ const ChatBlock = memo(function ChatBlock({
   }
 });
 
-/**
- * 用户消息 - Claude 风格：无头像，右对齐浅色气泡
- */
-const UserMessage = memo(function UserMessage({ content }: { content: string }) {
-  return (
-    <div className="flex justify-end py-2">
-      <div className="bg-primary/10 text-ink max-w-[80%] rounded-2xl rounded-tr-sm px-4 py-3 text-sm leading-relaxed">
-        {content}
-      </div>
-    </div>
-  );
-});
-
-/**
- * Assistant 消息 - Claude 风格：无头像，无气泡背景，纯文字流
- */
-const AssistantMessage = memo(function AssistantMessage({
-  content,
-  streaming,
-}: {
-  content: string;
-  streaming: boolean;
-}) {
-  const [copied, setCopied] = useState(false);
-
-  const handleCopy = useCallback(() => {
-    navigator.clipboard.writeText(content).then(() => {
-      setCopied(true);
-      setTimeout(() => setCopied(false), 1500);
-    });
-  }, [content]);
-
-  return (
-    <div className="group py-2">
-      {streaming ? (
-        <p className="text-ink text-sm leading-relaxed whitespace-pre-wrap">
-          {content}
-          <span className="bg-primary ml-0.5 inline-block h-4 w-[2px] animate-pulse rounded-full" />
-        </p>
-      ) : (
-        <>
-          <div className="prose-custom text-ink text-sm leading-relaxed">
-            <Suspense fallback={<div className="bg-surface h-4 animate-pulse rounded" />}>
-              <Markdown>{content}</Markdown>
-            </Suspense>
-          </div>
-          <div className="mt-1 flex opacity-0 transition-opacity group-hover:opacity-100">
-            <button
-              onClick={handleCopy}
-              className="text-ink-tertiary hover:bg-hover hover:text-ink-secondary flex items-center gap-1 rounded-md px-2 py-1 text-[11px] transition-colors"
-            >
-              {copied ? <Check className="text-success h-3 w-3" /> : <Copy className="h-3 w-3" />}
-              {copied ? "已复制" : "复制"}
-            </button>
-          </div>
-        </>
-      )}
-    </div>
-  );
-});
-
-/* ========== 步骤组 ========== */
-
-const StepGroupCard = memo(function StepGroupCard({ steps }: { steps: StepItem[] }) {
-  return (
-    <div className="py-2">
-      <div className="border-border bg-surface overflow-hidden rounded-xl border">
-        <div className="border-border-light bg-page flex items-center gap-2 border-b px-3.5 py-2">
-          <Play className="text-primary h-3 w-3" />
-          <span className="text-ink-secondary text-xs font-medium">执行步骤</span>
-          <span className="text-ink-tertiary ml-auto text-[11px]">
-            {steps.filter((s) => s.status === "done").length}/{steps.length}
-          </span>
-        </div>
-        <div className="divide-border-light divide-y">
-          {steps.map((step, idx) => (
-            <StepRow key={step.id || idx} step={step} />
-          ))}
-        </div>
-      </div>
-    </div>
-  );
-});
-
-function StepRow({ step }: { step: StepItem }) {
-  const isIngest = step.toolName === "ingest_arxiv";
-  const autoExpand = isIngest && step.status === "running";
-  const [expanded, setExpanded] = useState(false);
-  const meta = getToolMeta(step.toolName);
-  const Icon = meta.icon;
-  const hasData = step.data && Object.keys(step.data).length > 0;
-  const hasProgress = step.status === "running" && step.progressTotal && step.progressTotal > 0;
-  const progressPct = hasProgress
-    ? Math.round(((step.progressCurrent || 0) / step.progressTotal!) * 100)
-    : 0;
-  const showExpanded = expanded || autoExpand;
-
-  const statusIcon =
-    step.status === "running" ? (
-      <Loader2 className="text-primary h-3.5 w-3.5 animate-spin" />
-    ) : step.status === "done" ? (
-      <CheckCircle2 className="text-success h-3.5 w-3.5" />
-    ) : (
-      <XCircle className="text-error h-3.5 w-3.5" />
-    );
-
-  return (
-    <div>
-      <button
-        onClick={() => hasData && setExpanded(!expanded)}
-        className={cn(
-          "flex w-full items-center gap-2.5 px-3.5 py-2.5 text-left text-xs transition-colors",
-          hasData && "hover:bg-hover"
-        )}
-      >
-        {statusIcon}
-        <Icon className="text-ink-tertiary h-3.5 w-3.5 shrink-0" />
-        <span className="text-ink font-medium">{meta.label}</span>
-        {step.toolArgs && Object.keys(step.toolArgs).length > 0 && !hasProgress && (
-          <span className="text-ink-tertiary truncate">
-            {Object.entries(step.toolArgs)
-              .slice(0, 2)
-              .map(([k, v]) => `${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`)
-              .join(" · ")}
-          </span>
-        )}
-        {hasProgress && !isIngest && (
-          <span className="text-ink-secondary truncate">{step.progressMessage}</span>
-        )}
-        {step.summary && (
-          <span
-            className={cn(
-              "ml-auto shrink-0 font-medium",
-              step.success ? "text-success" : "text-error"
-            )}
-          >
-            {step.summary}
-          </span>
-        )}
-        {hasData && (
-          <span className="text-ink-tertiary ml-1 shrink-0">
-            {showExpanded ? (
-              <ChevronDown className="h-3 w-3" />
-            ) : (
-              <ChevronRight className="h-3 w-3" />
-            )}
-          </span>
-        )}
-      </button>
-
-      {/* 入库进度面板 - 独立的可视化区域 */}
-      {isIngest && hasProgress && (
-        <div className="border-primary/20 bg-primary/5 mx-3.5 mb-2.5 overflow-hidden rounded-lg border">
-          <div className="flex items-center gap-2 px-3 py-2">
-            <div className="relative h-8 w-8 shrink-0">
-              <svg className="h-8 w-8 -rotate-90" viewBox="0 0 32 32">
-                <circle
-                  cx="16"
-                  cy="16"
-                  r="13"
-                  fill="none"
-                  stroke="currentColor"
-                  strokeWidth="3"
-                  className="text-border"
-                />
-                <circle
-                  cx="16"
-                  cy="16"
-                  r="13"
-                  fill="none"
-                  stroke="currentColor"
-                  strokeWidth="3"
-                  className="text-primary transition-all duration-500"
-                  strokeDasharray={`${progressPct * 0.8168} 81.68`}
-                  strokeLinecap="round"
-                />
-              </svg>
-              <span className="text-primary absolute inset-0 flex items-center justify-center text-[9px] font-bold">
-                {progressPct}%
-              </span>
-            </div>
-            <div className="min-w-0 flex-1">
-              <p className="text-ink truncate text-[11px] font-medium">{step.progressMessage}</p>
-              <p className="text-ink-tertiary text-[10px]">
-                {step.progressCurrent ?? 0} / {step.progressTotal ?? 0} 篇
-              </p>
-            </div>
-            <Loader2 className="text-primary/60 h-4 w-4 animate-spin" />
-          </div>
-          <div className="bg-border/50 h-1">
-            <div
-              className="bg-primary h-full transition-all duration-500 ease-out"
-              style={{ width: `${progressPct}%` }}
-            />
-          </div>
-        </div>
-      )}
-
-      {/* 非入库工具的简单进度条 */}
-      {!isIngest && hasProgress && (
-        <div className="bg-border mx-3.5 mb-2 h-1.5 overflow-hidden rounded-full">
-          <div
-            className="bg-primary h-full rounded-full transition-all duration-300 ease-out"
-            style={{ width: `${progressPct}%` }}
-          />
-        </div>
-      )}
-
-      {showExpanded && step.data && (
-        <div className="border-border-light bg-page border-t px-3.5 py-2.5">
-          <StepDataView data={step.data} toolName={step.toolName} />
-        </div>
-      )}
-    </div>
-  );
-}
-
 /**
  * 论文列表卡片（search_papers / search_arxiv 共用）
  */
@@ -1004,636 +793,6 @@ const IngestResultView = memo(function IngestResultView({
   );
 });
 
-/* ========== arXiv 候选论文选择器 ========== */
-
-const QUERY_TO_CATEGORIES: Record<string, string[]> = {
-  graphics: ["cs.GR"],
-  rendering: ["cs.GR", "cs.CV"],
-  vision: ["cs.CV"],
-  nlp: ["cs.CL"],
-  language: ["cs.CL"],
-  robot: ["cs.RO"],
-  learning: ["cs.LG", "cs.AI"],
-  neural: ["cs.LG", "cs.CV", "cs.AI"],
-  "3d": ["cs.GR", "cs.CV"],
-  image: ["cs.CV"],
-  audio: ["cs.SD", "eess.AS"],
-  speech: ["cs.CL", "cs.SD"],
-  security: ["cs.CR"],
-  network: ["cs.NI"],
-  database: ["cs.DB"],
-  attention: ["cs.LG", "cs.CL"],
-  transformer: ["cs.LG", "cs.CL"],
-  diffusion: ["cs.CV", "cs.LG"],
-  gaussian: ["cs.GR", "cs.CV"],
-  nerf: ["cs.GR", "cs.CV"],
-  reconstruction: ["cs.GR", "cs.CV"],
-  detection: ["cs.CV"],
-  segmentation: ["cs.CV"],
-  generation: ["cs.CV", "cs.LG"],
-  llm: ["cs.CL", "cs.AI"],
-  agent: ["cs.AI", "cs.CL"],
-  rl: ["cs.LG", "cs.AI"],
-  reinforcement: ["cs.LG", "cs.AI"],
-  optimization: ["math.OC", "cs.LG"],
-};
-
-function inferRelevantCategories(query: string): Set<string> {
-  const qLower = query.toLowerCase();
-  const cats = new Set<string>();
-  for (const [kw, kwCats] of Object.entries(QUERY_TO_CATEGORIES)) {
-    if (qLower.includes(kw)) kwCats.forEach((c) => cats.add(c));
-  }
-  return cats;
-}
-
-function isRelevantCandidate(cats: string[], relevantCats: Set<string>): boolean {
-  if (relevantCats.size === 0) return true;
-  return cats.some((c) => relevantCats.has(c));
-}
-
-function ArxivCandidateSelector({
-  candidates,
-  query,
-}: {
-  candidates: Array<Record<string, unknown>>;
-  query: string;
-}) {
-  const { sendMessage, loading } = useAgentSession();
-  const relevantCats = inferRelevantCategories(query);
-
-  const [selected, setSelected] = useState<Set<string>>(() => {
-    if (relevantCats.size === 0) return new Set(candidates.map((c) => String(c.arxiv_id ?? "")));
-    const relevant = new Set<string>();
-    for (const c of candidates) {
-      const cats = Array.isArray(c.categories) ? (c.categories as string[]) : [];
-      if (isRelevantCandidate(cats, relevantCats)) relevant.add(String(c.arxiv_id ?? ""));
-    }
-    return relevant.size > 0 ? relevant : new Set(candidates.map((c) => String(c.arxiv_id ?? "")));
-  });
-  const [submitted, setSubmitted] = useState(false);
-  const allSelected = selected.size === candidates.length;
-  const relevantCount =
-    relevantCats.size > 0
-      ? candidates.filter((c) =>
-          isRelevantCandidate(
-            Array.isArray(c.categories) ? (c.categories as string[]) : [],
-            relevantCats
-          )
-        ).length
-      : candidates.length;
-
-  const toggle = (id: string) => {
-    setSelected((prev) => {
-      const next = new Set(prev);
-      if (next.has(id)) next.delete(id);
-      else next.add(id);
-      return next;
-    });
-  };
-
-  const selectRelevant = () => {
-    const relevant = new Set<string>();
-    for (const c of candidates) {
-      const cats = Array.isArray(c.categories) ? (c.categories as string[]) : [];
-      if (isRelevantCandidate(cats, relevantCats)) relevant.add(String(c.arxiv_id ?? ""));
-    }
-    setSelected(relevant);
-  };
-
-  const handleSubmit = () => {
-    if (selected.size === 0 || submitted) return;
-    setSubmitted(true);
-    const ids = Array.from(selected).join(", ");
-    sendMessage(`请将以下论文入库：${ids}`).catch(() => {
-      setSubmitted(false);
-    });
-  };
-
-  return (
-    <div className="space-y-2">
-      <div className="flex items-center justify-between">
-        <p className="text-ink-secondary text-[11px] font-medium">
-          {candidates.length} 篇候选论文
-          {relevantCats.size > 0 && relevantCount < candidates.length && (
-            <span className="text-success ml-1">（{relevantCount} 篇高相关）</span>
-          )}
-        </p>
-        <div className="flex items-center gap-1.5">
-          {relevantCats.size > 0 && relevantCount < candidates.length && (
-            <button
-              onClick={selectRelevant}
-              className="text-success hover:bg-success/10 rounded-md px-2 py-0.5 text-[10px] font-medium transition-colors"
-            >
-              仅选相关
-            </button>
-          )}
-          <button
-            onClick={() =>
-              setSelected(
-                allSelected ? new Set() : new Set(candidates.map((c) => String(c.arxiv_id ?? "")))
-              )
-            }
-            className="text-primary hover:bg-primary/10 rounded-md px-2 py-0.5 text-[10px] font-medium transition-colors"
-          >
-            {allSelected ? "取消全选" : "全选"}
-          </button>
-          <span className="text-ink-tertiary text-[10px]">
-            已选 {selected.size}/{candidates.length}
-          </span>
-        </div>
-      </div>
-      <div className="max-h-64 space-y-1 overflow-y-auto">
-        {candidates.map((p, i) => {
-          const aid = String(p.arxiv_id ?? "");
-          const isChecked = selected.has(aid);
-          const cats = Array.isArray(p.categories) ? (p.categories as string[]) : [];
-          const isRelevant = isRelevantCandidate(cats, relevantCats);
-          return (
-            <label
-              key={aid || i}
-              className={cn(
-                "flex cursor-pointer items-start gap-2.5 rounded-lg px-2.5 py-2 text-[11px] transition-colors",
-                isChecked
-                  ? "bg-primary/5 border-primary/20 border"
-                  : "bg-surface hover:bg-hover border border-transparent",
-                !isRelevant && relevantCats.size > 0 && "opacity-60"
-              )}
-            >
-              <input
-                type="checkbox"
-                checked={isChecked}
-                onChange={() => toggle(aid)}
-                disabled={submitted}
-                className="border-border text-primary focus:ring-primary/20 mt-1 h-3.5 w-3.5 shrink-0 rounded"
-              />
-              <div className="min-w-0 flex-1">
-                <div className="flex items-start gap-1.5">
-                  <p className="text-ink flex-1 leading-snug font-medium">
-                    {String(p.title ?? "")}
-                  </p>
-                  {isRelevant && relevantCats.size > 0 && (
-                    <span className="bg-success/10 text-success shrink-0 rounded px-1.5 py-0.5 text-[9px] font-medium">
-                      相关
-                    </span>
-                  )}
-                </div>
-                <div className="text-ink-tertiary mt-0.5 flex flex-wrap items-center gap-1.5 text-[10px]">
-                  {p.arxiv_id ? <span className="font-mono">{aid}</span> : null}
-                  {p.publication_date ? <span>{String(p.publication_date)}</span> : null}
-                  {cats.length > 0 &&
-                    cats.slice(0, 3).map((c) => (
-                      <span
-                        key={c}
-                        className={cn(
-                          "rounded px-1 py-px font-mono text-[9px]",
-                          relevantCats.has(c)
-                            ? "bg-primary/10 text-primary"
-                            : "bg-ink/5 text-ink-tertiary"
-                        )}
-                      >
-                        {c}
-                      </span>
-                    ))}
-                </div>
-                {Array.isArray(p.authors) && (p.authors as string[]).length > 0 && (
-                  <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">
-                    {(p.authors as string[]).slice(0, 3).join(", ")}
-                  </p>
-                )}
-              </div>
-            </label>
-          );
-        })}
-      </div>
-      {!submitted ? (
-        <button
-          onClick={handleSubmit}
-          disabled={selected.size === 0 || loading}
-          className="bg-primary hover:bg-primary-hover flex w-full items-center justify-center gap-2 rounded-xl px-4 py-2.5 text-sm font-medium text-white transition-all disabled:opacity-50"
-        >
-          <Download className="h-4 w-4" />
-          入库选中 ({selected.size} 篇)
-        </button>
-      ) : (
-        <div className="bg-primary/10 text-primary flex items-center justify-center gap-2 rounded-xl px-4 py-2.5 text-sm font-medium">
-          <Loader2 className="h-4 w-4 animate-spin" />
-          已发送请求，等待确认后开始入库…
-        </div>
-      )}
-    </div>
-  );
-}
-
-const StepDataView = memo(function StepDataView({
-  data,
-  toolName,
-}: {
-  data: Record<string, unknown>;
-  toolName: string;
-}) {
-  const navigate = useNavigate();
-
-  if (toolName === "search_papers" && Array.isArray(data.papers)) {
-    return (
-      <PaperListView
-        papers={data.papers as Array<Record<string, unknown>>}
-        label={`找到 ${(data.papers as unknown[]).length} 篇论文`}
-      />
-    );
-  }
-  if (toolName === "search_arxiv" && Array.isArray(data.candidates)) {
-    return (
-      <ArxivCandidateSelector
-        candidates={data.candidates as Array<Record<string, unknown>>}
-        query={String(data.query ?? "")}
-      />
-    );
-  }
-  if (toolName === "ingest_arxiv" && data.total !== undefined) {
-    return <IngestResultView data={data} />;
-  }
-  if (toolName === "get_system_status") {
-    return (
-      <div className="grid grid-cols-3 gap-2">
-        {[
-          { label: "论文", value: data.paper_count, color: "text-primary" },
-          { label: "已向量化", value: data.embedded_count, color: "text-success" },
-          { label: "主题", value: data.topic_count, color: "text-blue-600 dark:text-blue-400" },
-        ].map((s) => (
-          <div key={s.label} className="bg-surface flex flex-col items-center rounded-lg py-2">
-            <span className={cn("text-base font-bold", s.color)}>{String(s.value ?? 0)}</span>
-            <span className="text-ink-tertiary text-[10px]">{s.label}</span>
-          </div>
-        ))}
-      </div>
-    );
-  }
-  /* ask_knowledge_base — Markdown 答案 + 引用论文 */
-  if (toolName === "ask_knowledge_base" && data.markdown) {
-    const evidence = Array.isArray(data.evidence)
-      ? (data.evidence as Array<Record<string, unknown>>)
-      : [];
-    const rounds = data.rounds as number | undefined;
-    return (
-      <div className="space-y-2">
-        {rounds && rounds > 1 && (
-          <div className="text-primary flex items-center gap-1.5 text-[10px]">
-            <TrendingUp className="h-3 w-3" />
-            <span>经过 {rounds} 轮迭代检索优化</span>
-          </div>
-        )}
-        <div className="prose prose-sm dark:prose-invert max-w-none text-[12px] leading-relaxed">
-          <Suspense fallback={<div className="bg-surface h-4 animate-pulse rounded" />}>
-            <Markdown>{String(data.markdown)}</Markdown>
-          </Suspense>
-        </div>
-        {evidence.length > 0 && (
-          <div className="border-border-light border-t pt-2">
-            <p className="text-ink-tertiary mb-1 text-[10px] font-medium">
-              引用 {evidence.length} 篇论文
-            </p>
-            <div className="flex flex-wrap gap-1">
-              {evidence.slice(0, 8).map((e, i) => (
-                <button
-                  key={i}
-                  onClick={() => e.paper_id && navigate(`/papers/${String(e.paper_id)}`)}
-                  className="bg-surface text-ink-secondary hover:bg-hover hover:text-primary max-w-[200px] truncate rounded px-1.5 py-0.5 text-[9px] transition-colors"
-                  title={String(e.title ?? "")}
-                >
-                  {String(e.title ?? "").slice(0, 40)}
-                  {String(e.title ?? "").length > 40 ? "..." : ""}
-                </button>
-              ))}
-            </div>
-          </div>
-        )}
-      </div>
-    );
-  }
-  /* list_topics — 主题列表 */
-  if (toolName === "list_topics" && Array.isArray(data.topics)) {
-    const topics = data.topics as Array<Record<string, unknown>>;
-    return (
-      <div className="space-y-1">
-        {topics.map((t, i) => (
-          <div
-            key={i}
-            className="bg-surface flex items-center gap-2 rounded-lg px-2.5 py-1.5 text-[11px]"
-          >
-            <Hash className="text-primary h-3 w-3 shrink-0" />
-            <span className="text-ink font-medium">{String(t.name ?? "")}</span>
-            {t.paper_count !== undefined && (
-              <span className="text-ink-tertiary">{String(t.paper_count)} 篇</span>
-            )}
-            {t.enabled !== undefined && (
-              <span
-                className={cn(
-                  "ml-auto rounded px-1.5 py-0.5 text-[9px]",
-                  t.enabled ? "bg-success/10 text-success" : "bg-ink/5 text-ink-tertiary"
-                )}
-              >
-                {t.enabled ? "已订阅" : "未订阅"}
-              </span>
-            )}
-          </div>
-        ))}
-      </div>
-    );
-  }
-  /* get_timeline — 时间线 */
-  if (toolName === "get_timeline" && Array.isArray(data.timeline)) {
-    const items = data.timeline as Array<Record<string, unknown>>;
-    return (
-      <div className="max-h-48 space-y-1 overflow-y-auto">
-        {items.map((p, i) => (
-          <button
-            key={i}
-            onClick={() => p.paper_id && navigate(`/papers/${String(p.paper_id)}`)}
-            className="bg-surface hover:bg-hover flex w-full items-center gap-2 rounded-lg px-2.5 py-1.5 text-left text-[11px] transition-colors"
-          >
-            <span className="text-primary shrink-0 font-mono text-[10px]">
-              {String(p.year ?? "?")}
-            </span>
-            <span className="text-ink truncate">{String(p.title ?? "")}</span>
-          </button>
-        ))}
-      </div>
-    );
-  }
-  /* get_similar_papers — 相似论文 */
-  if (toolName === "get_similar_papers") {
-    const items = Array.isArray(data.items) ? (data.items as Array<Record<string, unknown>>) : [];
-    const ids = Array.isArray(data.similar_ids) ? (data.similar_ids as string[]) : [];
-    if (items.length > 0) {
-      return (
-        <div className="space-y-1">
-          {items.map((p, i) => (
-            <button
-              key={i}
-              onClick={() => p.id && navigate(`/papers/${String(p.id)}`)}
-              className="bg-surface hover:bg-hover flex w-full items-center gap-2 rounded-lg px-2.5 py-1.5 text-left text-[11px] transition-colors"
-            >
-              <Star className="h-3 w-3 shrink-0 text-amber-500" />
-              <span className="text-ink truncate">{String(p.title ?? "")}</span>
-            </button>
-          ))}
-        </div>
-      );
-    }
-    if (ids.length > 0) {
-      return <p className="text-ink-secondary text-[11px]">找到 {ids.length} 篇相似论文</p>;
-    }
-  }
-  /* get_citation_tree — 引用树统计 */
-  if (toolName === "get_citation_tree" && data.nodes) {
-    const nodes = Array.isArray(data.nodes) ? data.nodes.length : 0;
-    const edges = Array.isArray(data.edges) ? data.edges.length : 0;
-    return (
-      <div className="flex items-center gap-3 text-[11px]">
-        <span className="text-ink font-medium">{nodes} 个节点</span>
-        <span className="text-ink-tertiary">{edges} 条引用关系</span>
-      </div>
-    );
-  }
-  /* suggest_keywords — 关键词建议 */
-  if (toolName === "suggest_keywords" && Array.isArray(data.suggestions)) {
-    const suggestions = data.suggestions as Array<Record<string, unknown>>;
-    return (
-      <div className="space-y-1.5">
-        {suggestions.map((s, i) => (
-          <div key={i} className="bg-surface rounded-lg px-2.5 py-2 text-[11px]">
-            <p className="text-ink font-medium">{String(s.name ?? "")}</p>
-            <p className="text-primary mt-0.5 font-mono text-[10px]">{String(s.query ?? "")}</p>
-            {s.reason !== undefined && (
-              <p className="text-ink-tertiary mt-0.5 text-[10px]">{String(s.reason)}</p>
-            )}
-          </div>
-        ))}
-      </div>
-    );
-  }
-  /* skim_paper / deep_read_paper — 报告摘要 */
-  if ((toolName === "skim_paper" || toolName === "deep_read_paper") && data.one_liner) {
-    return (
-      <div className="text-[11px]">
-        <p className="text-ink font-medium">{String(data.one_liner)}</p>
-        {data.novelty !== undefined && (
-          <p className="text-ink-secondary mt-1">
-            <span className="font-medium">创新点:</span> {String(data.novelty)}
-          </p>
-        )}
-        {data.methodology !== undefined && (
-          <p className="text-ink-secondary mt-0.5">
-            <span className="font-medium">方法:</span> {String(data.methodology)}
-          </p>
-        )}
-      </div>
-    );
-  }
-  /* reasoning_analysis — 推理链 */
-  if (toolName === "reasoning_analysis" && data.reasoning_steps) {
-    const steps = Array.isArray(data.reasoning_steps)
-      ? (data.reasoning_steps as Array<Record<string, unknown>>)
-      : [];
-    return (
-      <div className="max-h-48 space-y-1.5 overflow-y-auto">
-        {steps.slice(0, 6).map((s, i) => (
-          <div key={i} className="bg-surface rounded-lg px-2.5 py-1.5 text-[11px]">
-            <p className="text-ink font-medium">
-              {String(s.step_name ?? s.claim ?? `步骤 ${i + 1}`)}
-            </p>
-            {s.evidence !== undefined && (
-              <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">{String(s.evidence)}</p>
-            )}
-          </div>
-        ))}
-      </div>
-    );
-  }
-  /* analyze_figures — 图表列表 */
-  if (toolName === "analyze_figures" && Array.isArray(data.figures)) {
-    const figs = data.figures as Array<Record<string, unknown>>;
-    return (
-      <div className="space-y-1">
-        {figs.map((f, i) => (
-          <div key={i} className="bg-surface rounded-lg px-2.5 py-1.5 text-[11px]">
-            <p className="text-ink font-medium">
-              {String(f.figure_type ?? "图表")} — p.{String(f.page ?? "?")}
-            </p>
-            <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">
-              {String(f.description ?? f.analysis ?? "")}
-            </p>
-          </div>
-        ))}
-      </div>
-    );
-  }
-  /* identify_research_gaps — 研究空白 */
-  if (toolName === "identify_research_gaps" && data.analysis) {
-    const analysis = data.analysis as Record<string, unknown>;
-    const gaps = Array.isArray(analysis.research_gaps)
-      ? (analysis.research_gaps as Array<Record<string, unknown>>)
-      : [];
-    return (
-      <div className="space-y-1.5">
-        {gaps.slice(0, 5).map((g, i) => (
-          <div key={i} className="bg-surface rounded-lg px-2.5 py-1.5 text-[11px]">
-            <p className="text-ink font-medium">
-              {String(g.gap_title ?? g.title ?? `空白 ${i + 1}`)}
-            </p>
-            <p className="text-ink-tertiary mt-0.5 truncate text-[10px]">
-              {String(g.description ?? g.evidence ?? "")}
-            </p>
-          </div>
-        ))}
-      </div>
-    );
-  }
-  /* get_paper_detail — 论文详情卡片 */
-  if (toolName === "get_paper_detail" && data.title) {
-    return (
-      <div className="text-[11px]">
-        <button
-          onClick={() => data.id && navigate(`/papers/${String(data.id)}`)}
-          className="text-primary font-medium hover:underline"
-        >
-          {String(data.title)}
-        </button>
-        {data.abstract_zh !== undefined && (
-          <p className="text-ink-secondary mt-1 line-clamp-3">{String(data.abstract_zh)}</p>
-        )}
-        <div className="text-ink-tertiary mt-1 flex flex-wrap gap-1.5 text-[10px]">
-          {data.arxiv_id ? <span className="font-mono">{String(data.arxiv_id)}</span> : null}
-          {data.read_status ? <span>{String(data.read_status)}</span> : null}
-        </div>
-      </div>
-    );
-  }
-  /* writing_assist — 写作助手结果 */
-  if (toolName === "writing_assist" && data.content) {
-    return (
-      <div className="prose prose-sm dark:prose-invert max-h-48 max-w-none overflow-y-auto text-[12px]">
-        <Suspense fallback={<div className="bg-surface h-4 animate-pulse rounded" />}>
-          <Markdown>{String(data.content)}</Markdown>
-        </Suspense>
-      </div>
-    );
-  }
-  /* 兜底：原始 JSON */
-  return (
-    <pre className="bg-surface text-ink-secondary max-h-40 overflow-auto rounded-lg p-2.5 text-[11px]">
-      {JSON.stringify(data, null, 2)}
-    </pre>
-  );
-});
-
-/* ========== 确认卡片 ========== */
-
-const ActionConfirmCard = memo(function ActionConfirmCard({
-  actionId,
-  description,
-  tool,
-  args,
-  isPending,
-  isConfirming,
-  onConfirm,
-  onReject,
-}: {
-  actionId: string;
-  description: string;
-  tool: string;
-  args?: Record<string, unknown>;
-  isPending: boolean;
-  isConfirming: boolean;
-  onConfirm: (id: string) => void;
-  onReject: (id: string) => void;
-}) {
-  const meta = getToolMeta(tool);
-  const Icon = meta.icon;
-  return (
-    <div className="py-2">
-      <div
-        className={cn(
-          "bg-surface overflow-hidden rounded-xl border transition-all",
-          isPending
-            ? "border-warning/60 shadow-warning/10 animate-[confirm-glow_2s_ease-in-out_infinite] shadow-md"
-            : "border-border"
-        )}
-      >
-        <div
-          className={cn(
-            "flex items-center gap-2 px-3.5 py-2.5",
-            isPending ? "bg-warning-light" : "bg-page"
-          )}
-        >
-          <AlertTriangle
-            className={cn(
-              "h-3.5 w-3.5",
-              isPending ? "text-warning animate-pulse" : "text-ink-tertiary"
-            )}
-          />
-          <span className="text-ink text-xs font-semibold">
-            {isPending ? "⚠️ 需要你的确认" : "已处理"}
-          </span>
-        </div>
-        <div className="space-y-3 px-3.5 py-3">
-          <div className="flex items-start gap-2.5">
-            <div className="bg-warning-light flex h-8 w-8 shrink-0 items-center justify-center rounded-lg">
-              <Icon className="text-warning h-4 w-4" />
-            </div>
-            <div>
-              <p className="text-ink text-sm font-medium">{description}</p>
-              {args && Object.keys(args).length > 0 && (
-                <div className="bg-page mt-1.5 rounded-lg px-2.5 py-1.5">
-                  {Object.entries(args).map(([k, v]) => (
-                    <div key={k} className="flex gap-1.5 text-[11px]">
-                      <span className="text-ink-secondary font-medium">{k}:</span>
-                      <span className="text-ink-tertiary">
-                        {typeof v === "string" ? v : JSON.stringify(v)}
-                      </span>
-                    </div>
-                  ))}
-                </div>
-              )}
-            </div>
-          </div>
-          {isPending && (
-            <div className="flex gap-2">
-              <button
-                onClick={() => onConfirm(actionId)}
-                disabled={isConfirming}
-                className="bg-primary hover:bg-primary-hover flex flex-1 items-center justify-center gap-1.5 rounded-lg py-2 text-xs font-medium text-white transition-all disabled:opacity-50"
-              >
-                {isConfirming ? (
-                  <Loader2 className="h-3.5 w-3.5 animate-spin" />
-                ) : (
-                  <CheckCircle2 className="h-3.5 w-3.5" />
-                )}
-                确认执行
-              </button>
-              <button
-                onClick={() => onReject(actionId)}
-                disabled={isConfirming}
-                className="border-border bg-surface text-ink-secondary hover:bg-hover flex flex-1 items-center justify-center gap-1.5 rounded-lg border py-2 text-xs font-medium transition-all disabled:opacity-50"
-              >
-                <XCircle className="h-3.5 w-3.5" />
-                跳过
-              </button>
-            </div>
-          )}
-          {!isPending && (
-            <div className="text-success flex items-center gap-1 text-[11px]">
-              <CheckCircle2 className="h-3 w-3" />
-              已处理
-            </div>
-          )}
-        </div>
-      </div>
-    </div>
-  );
-});
-
 const ErrorCard = memo(function ErrorCard({
   content,
   onRetry,
diff --git a/logs/frontend.log b/logs/frontend.log
index 3746382..60440af 100644
--- a/logs/frontend.log
+++ b/logs/frontend.log
@@ -612,7 +612,7 @@
 /Users/haojiang/Documents/2026/PaperMind/frontend/src/components/SettingsDialog.tsx:1218:13: ERROR: The character "}" is not valid inside a JSX element
   Plugin: vite:esbuild
   File: /Users/haojiang/Documents/2026/PaperMind/frontend/src/components/SettingsDialog.tsx:1199:0
-  
+
   The character "}" is not valid inside a JSX element
   1216|                  </Button>
   1217|                </>
@@ -620,7 +620,7 @@
      |               ^
   1219|            </div>
   1220|          </div>
-  
+
       at failureErrorWithLog (/Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:1472:15)
       at /Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:755:50
       at responseCallbacks.<computed> (/Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:622:9)
@@ -635,7 +635,7 @@
 /Users/haojiang/Documents/2026/PaperMind/frontend/src/components/SettingsDialog.tsx:1218:13: ERROR: The character "}" is not valid inside a JSX element
   Plugin: vite:esbuild
   File: /Users/haojiang/Documents/2026/PaperMind/frontend/src/components/SettingsDialog.tsx:1199:0
-  
+
   The character "}" is not valid inside a JSX element
   1216|                  </Button>
   1217|                </>
@@ -643,7 +643,7 @@
      |               ^
   1219|            </div>
   1220|          </div>
-  
+
       at failureErrorWithLog (/Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:1472:15)
       at /Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:755:50
       at responseCallbacks.<computed> (/Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:622:9)
@@ -658,7 +658,7 @@
 /Users/haojiang/Documents/2026/PaperMind/frontend/src/components/SettingsDialog.tsx:1218:13: ERROR: The character "}" is not valid inside a JSX element
   Plugin: vite:esbuild
   File: /Users/haojiang/Documents/2026/PaperMind/frontend/src/components/SettingsDialog.tsx:1199:0
-  
+
   The character "}" is not valid inside a JSX element
   1216|                  </Button>
   1217|                </>
@@ -666,7 +666,7 @@
      |               ^
   1219|            </div>
   1220|          </div>
-  
+
       at failureErrorWithLog (/Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:1472:15)
       at /Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:755:50
       at responseCallbacks.<computed> (/Users/haojiang/Documents/2026/PaperMind/frontend/node_modules/esbuild/lib/main.js:622:9)
diff --git a/packages/ai/brief_service.py b/packages/ai/brief_service.py
index d0fb3e8..81eddec 100644
--- a/packages/ai/brief_service.py
+++ b/packages/ai/brief_service.py
@@ -68,19 +68,19 @@ def _parse_deep_dive(md: str) -> dict:
   .section { margin-bottom: 32px; }
   .section-title { font-size: 18px; font-weight: 700; margin-bottom: 16px; padding-bottom: 8px; border-bottom: 2px solid #e2e8f0; display: flex; align-items: center; gap: 8px; }
   .section-title::before { content: ""; display: inline-block; width: 8px; height: 8px; border-radius: 2px; background: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%); }
-  
+
   /* ===== 焦点区域 - 最高优先级 ===== */
   .focus-zone { background: linear-gradient(135deg, #f0fdf4 0%, #ecfdf5 100%); border: 2px solid #22c55e; border-radius: 16px; padding: 20px; margin-bottom: 32px; }
   .focus-title { font-size: 20px; font-weight: 800; color: #15803d; margin-bottom: 16px; display: flex; align-items: center; gap: 8px; }
   .focus-title::before { content: "🎯"; font-size: 24px; }
-  
+
   /* AI 洞察增强 */
   .ai-insight-box { background: #fff; border-radius: 12px; padding: 18px; border-left: 4px solid #22c55e; box-shadow: 0 2px 8px rgba(0,0,0,0.04); }
   .ai-insight-header { display: flex; align-items: center; gap: 8px; margin-bottom: 12px; }
   .ai-insight-icon { font-size: 20px; }
   .ai-insight-title { font-weight: 700; color: #15803d; font-size: 15px; }
   .ai-insight-content { font-size: 14px; line-height: 1.8; color: #374151; }
-  
+
   /* 精读精选卡片增强 */
   .deep-card { background: linear-gradient(135deg, #faf5ff 0%, #f3e8ff 100%); border: 2px solid #c084fc; border-left: 4px solid #a855f7; border-radius: 14px; padding: 18px; margin-bottom: 16px; transition: all 0.2s; cursor: pointer; }
   .deep-card:hover { transform: translateY(-2px); box-shadow: 0 6px 16px rgba(168, 85, 247, 0.15); border-color: #a855f7; }
@@ -91,24 +91,24 @@ def _parse_deep_dive(md: str) -> dict:
   .deep-text { font-size: 13px; color: #4b5563; line-height: 1.7; margin: 0; }
   .risk-list { margin: 6px 0 0 18px; padding: 0; font-size: 12px; color: #b45309; }
   .risk-list li { margin-bottom: 4px; line-height: 1.5; }
-  
+
   /* 推荐卡片 */
   .rec-card { background: linear-gradient(135deg, #eff6ff 0%, #dbeafe 100%); border: 1px solid #93c5fd; border-left: 3px solid #3b82f6; border-radius: 12px; padding: 16px; margin-bottom: 12px; transition: all 0.2s; cursor: pointer; }
   .rec-card:hover { transform: translateY(-1px); box-shadow: 0 4px 12px rgba(59, 130, 246, 0.15); border-color: #3b82f6; }
   .rec-title { font-weight: 600; font-size: 15px; color: #1a1a2e; line-height: 1.4; }
   .rec-meta { font-size: 12px; color: #6b7280; margin-top: 6px; display: flex; align-items: center; gap: 4px; }
   .rec-reason { font-size: 13px; color: #4b5563; margin-top: 8px; line-height: 1.6; font-style: italic; }
-  
+
   /* 热点标签增强 */
   .kw-tag { display: inline-flex !important; align-items: center; gap: 4px; background: linear-gradient(135deg, #fef3c7 0%, #fde68a 100%); color: #92400e; border-radius: 9999px; padding: 6px 14px !important; font-size: 13px !important; font-weight: 600; margin: 4px !important; border: 1px solid #f59e0b; transition: transform 0.2s; }
   .kw-tag:hover { transform: scale(1.05); }
   .kw-tag::before { content: "🔥"; font-size: 12px; }
-  
+
   /* 主题分组 */
   .topic-group { margin-bottom: 24px; background: #fff; border-radius: 12px; padding: 16px; border: 1px solid #e2e8f0; }
   .topic-name { font-size: 16px; font-weight: 700; color: #6366f1; margin-bottom: 12px; display: flex; align-items: center; gap: 8px; padding-bottom: 8px; border-bottom: 1px dashed #e2e8f0; }
   .topic-name::before { content: "📁"; font-size: 16px; }
-  
+
   /* 普通论文卡片 */
   .paper-item { background: #fff; border: 1px solid #e2e8f0; border-radius: 10px; padding: 14px; margin-bottom: 10px; transition: all 0.2s; cursor: pointer; }
   .paper-item:hover { border-color: #a5b4fc; box-shadow: 0 2px 8px rgba(99, 102, 241, 0.08); transform: translateY(-1px); }
@@ -117,31 +117,31 @@ def _parse_deep_dive(md: str) -> dict:
   .paper-summary { font-size: 13px; color: #6b7280; margin-top: 8px; line-height: 1.6; max-height: 60px; overflow: hidden; text-overflow: ellipsis; display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; transition: max-height 0.3s; }
   .paper-item:hover .paper-summary { max-height: 200px; }
   .paper-id { font-size: 11px; color: #9ca3af; font-family: ui-monospace, monospace; }
-  
+
   /* 按钮增强 */
   .btn { display: inline-block; padding: 8px 16px; background: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%); color: #fff !important; text-decoration: none; border-radius: 8px; font-size: 12px; font-weight: 600; margin-top: 8px; transition: all 0.2s; border: none; cursor: pointer; }
   .btn:hover { transform: translateY(-1px); box-shadow: 0 4px 12px rgba(99, 102, 241, 0.3); }
-  
+
   /* 分数徽章增强 */
   .score-badge { display: inline-flex !important; align-items: center; justify-content: center; border-radius: 9999px !important; font-weight: 800 !important; font-size: 11px !important; padding: 3px 8px !important; min-width: 48px; }
   .score-high { background: linear-gradient(135deg, #dcfce7 0%, #bbf7d0 100%) !important; color: #166534 !important; border: 1px solid #22c55e !important; }
   .score-mid { background: linear-gradient(135deg, #fef3c7 0%, #fde68a 100%) !important; color: #92400e !important; border: 1px solid #f59e0b !important; }
   .score-low { background: linear-gradient(135deg, #fee2e2 0%, #fecaca 100%) !important; color: #991b1b !important; border: 1px solid #ef4444 !important; }
-  
+
   /* 深度徽章 */
   .deep-badge { display: inline-flex !important; align-items: center; gap: 2px; background: linear-gradient(135deg, #ede9fe 0%, #ddd6fe 100%) !important; color: #6d28d9 !important; padding: 2px 8px !important; border-radius: 6px !important; font-size: 10px !important; font-weight: 700 !important; border: 1px solid #a855f7 !important; }
   .deep-badge::before { content: "✨"; font-size: 8px; }
-  
+
   /* 创新标签增强 */
   .innovation-tags { display: flex !important; flex-wrap: wrap !important; gap: 6px !important; margin-top: 8px !important; }
   .innovation-tag { display: inline-flex !important; align-items: center; gap: 4px; background: linear-gradient(135deg, #fef3c7 0%, #fde68a 100%) !important; color: #78350f !important; border-radius: 8px !important; padding: 4px 10px !important; font-size: 11px !important; font-weight: 600 !important; border: 1px solid #f59e0b !important; }
   .innovation-tag::before { content: "💡"; font-size: 10px; }
-  
+
   /* 页脚 */
   .footer { text-align: center; color: #9ca3af; font-size: 12px; margin-top: 48px; padding-top: 20px; border-top: 2px solid #e2e8f0; }
   .footer a { color: #6366f1; text-decoration: none; font-weight: 600; }
   .footer a:hover { text-decoration: underline; }
-  
+
   a { color: #6366f1; text-decoration: none; transition: color 0.2s; }
   a:hover { color: #4f46e5; }
 </style>
@@ -173,7 +173,7 @@ def _parse_deep_dive(md: str) -> dict:
 {% if ai_summary or deep_read_highlights %}
 <div class="focus-zone">
   <div class="focus-title">今日焦点</div>
-  
+
   {% if ai_summary %}
   <div class="ai-insight-box">
     <div class="ai-insight-header">
@@ -183,7 +183,7 @@ def _parse_deep_dive(md: str) -> dict:
     <div class="ai-insight-content">{{ ai_summary }}</div>
   </div>
   {% endif %}
-  
+
   {% if deep_read_highlights %}
   <div style="margin-top: 20px;">
     <div class="section-title" style="font-size: 16px; border-bottom: 1px dashed #c084fc;">
diff --git a/scripts/cleanup_unread.py b/scripts/cleanup_unread.py
index 1d42f0a..f6cd993 100755
--- a/scripts/cleanup_unread.py
+++ b/scripts/cleanup_unread.py
@@ -24,7 +24,7 @@
 from sqlalchemy import select
 
 from packages.ai.pipelines import PaperPipelines
-from packages.ai.rate_limiter import acquire_api, get_rate_limiter
+from packages.ai.rate_limiter import acquire_api
 from packages.storage.db import session_scope
 from packages.storage.models import AnalysisReport, Paper
 
@@ -125,10 +125,10 @@ def main():
 示例:
   # 处理 20 篇（默认）
   python scripts/cleanup_unread.py
-  
+
   # 处理 50 篇，并发 5 个
   python scripts/cleanup_unread.py --limit 50 --concurrency 5
-  
+
   # 添加到 crontab（每天 UTC 14 点执行）
   0 14 * * * cd /path/to/PaperMind && /path/to/venv/bin/python scripts/cleanup_unread.py --limit 30
         """,
@@ -172,8 +172,6 @@ def main():
     results = []
     start_time = datetime.now(UTC)
 
-    limiter = get_rate_limiter()
-
     with ThreadPoolExecutor(max_workers=args.concurrency) as executor:
         futures = {
             executor.submit(process_single_paper, pid, title, arxiv_id): pid