feat: 新增报告协作页,并强化 Deep Research 运行诊断与报告兜底

支持浏览器侧素材快照撰写、拒绝报告读时修复、Mermaid PNG 导出与 Word 导出加固。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
董宏凯andCursor committed 2026-09-03 11:16:50 +08:00
1 parent 65d6b61d5d
commit f109a95535
65 files changed
+10342 -245

No files matched your search

@@ -0,0 +1,508 @@
"use client";
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { useLocation, useNavigate, useParams } from "react-router-dom";
import type { Message } from "@langchain/langgraph-sdk";
import { toast } from "sonner";
import { FileText, Sparkles } from "lucide-react";
import { getReportCollaborationDriver } from "@/report-collaboration/api/driver";
import { AgentStageSelector } from "@/report-collaboration/components/AgentStageSelector";
import { ConnectionStatusBar } from "@/report-collaboration/components/ConnectionStatusBar";
import { InterventionCard } from "@/report-collaboration/components/InterventionCard";
import { NodeInspectorDrawer } from "@/report-collaboration/components/NodeInspectorDrawer";
import { ReportCollaborationHeader } from "@/report-collaboration/components/ReportCollaborationHeader";
import { ReportCollaborationLayout, NarrowSwitch } from "@/report-collaboration/components/ReportCollaborationLayout";
import { ReportComposer, type ComposerTarget } from "@/report-collaboration/components/ReportComposer";
import { ReportConversationPanel } from "@/report-collaboration/components/ReportConversationPanel";
import { ReportFlowCanvas } from "@/report-collaboration/components/ReportFlowCanvas";
import { ReportPlanCards } from "@/report-collaboration/components/ReportPlanCards";
import {
ReportAvailableCard,
ReportPreviewDialog,
} from "@/report-collaboration/components/ReportPreviewDialog";
import { SessionHistoryPanel } from "@/report-collaboration/components/SessionHistoryPanel";
import { useReportPanelLayout } from "@/report-collaboration/hooks/useReportPanelLayout";
import { useReportCollaborationMessages } from "@/report-collaboration/hooks/useReportCollaborationMessages";
import { useReportCollaborationSession, isRunActive } from "@/report-collaboration/hooks/useReportCollaborationSession";
import { useReportPlanSelection } from "@/report-collaboration/hooks/useReportPlanSelection";
import {
buildCommandConfirmCard,
buildPlanGroupCard,
buildReportAvailableCard,
readReportCollaborationCard,
} from "@/report-collaboration/state/message-adapter";
import {
derivePagePhase,
selectAgentTabs,
selectAwaitingInputNodes,
selectHeadReportVersion,
selectNodeStatusMap,
selectParallelMembers,
selectPendingConfirmationCommands,
selectPlanForCanvas,
selectStreamingAgentRunIds,
} from "@/report-collaboration/state/selectors";
import { buildBaseStreamFacade } from "@/report-collaboration/state/message-adapter";
const NEW_SESSION_THREAD = buildBaseStreamFacade([], false);
/** 左侧 Tab:对话 / 历史。 */
function ConversationSidebarTabs({
conversation,
history,
}: {
conversation: React.ReactNode;
history: React.ReactNode;
}) {
const [tab, setTab] = useState<"conversation" | "history">("conversation");
return (
<div className="flex min-h-0 flex-1 flex-col">
<div className="rc-tabs" role="tablist" aria-label="左侧面板">
<button type="button" role="tab" className="rc-tab" data-active={tab === "conversation"} onClick={() => setTab("conversation")}>
对话
</button>
<button type="button" role="tab" className="rc-tab" data-active={tab === "history"} onClick={() => setTab("history")}>
历史
</button>
</div>
{tab === "conversation" ? conversation : history}
</div>
);
}
/**
* 新会话入口页(无 sessionId):空态 + 输入需求后创建会话并跳转,
* 首条消息通过 location.state 传递,由会话页发送(避免竞态)。
*/
export default function ReportCollaborationPage() {
const navigate = useNavigate();
const layout = useReportPanelLayout();
const [starting, setStarting] = useState(false);
const [error, setError] = useState<string | null>(null);
const start = useCallback(
async (text: string) => {
setStarting(true);
setError(null);
try {
const created = await getReportCollaborationDriver().createSession();
navigate(`/page/workspace/report-collaboration/${created.id}`, {
state: { rcInitialMessage: text },
});
} catch (err) {
setError(err instanceof Error ? err.message : String(err));
} finally {
setStarting(false);
}
},
[navigate],
);
return (
<ReportCollaborationLayout
layout={layout}
header={
<ReportCollaborationHeader
title="新会话"
phase="empty"
onBack={() => navigate("/page/workspace/chats/new")}
onNewSession={() => navigate("/page/workspace/report-collaboration")}
onOpenReport={() => undefined}
hasReport={false}
running={false}
onCancelRun={() => undefined}
/>
}
conversation={
<ReportConversationPanel
sessionId="rc-new"
thread={NEW_SESSION_THREAD}
businessCardSlot={() => null}
loading={false}
emptyHint={
<div className="flex flex-col items-center gap-3">
<Sparkles className="size-10 opacity-40" style={{ color: "var(--rc-accent)" }} aria-hidden />
<p className="text-[14px] font-semibold">描述你的报告需求</p>
<p className="max-w-72 text-[12px] leading-5">
系统会先澄清关键信息,然后给出 2~3 个候选协作方案;
确认方案后多智能体团队开始检索、核验、分析与写作,全过程可在对话中干预。
</p>
{error ? (
<p className="text-[12px]" style={{ color: "var(--rc-danger)" }}>
{error}
</p>
) : null}
</div>
}
composer={
<ReportComposer
phase="empty"
busy={starting}
target={null}
onClearTarget={() => undefined}
onSend={(text) => void start(text)}
focusSignal={0}
/>
}
/>
}
canvas={<ReportFlowCanvas plan={null} nodeStates={{}} selectedNodeId={null} onSelectNode={() => undefined} />}
statusBar={<ConnectionStatusBar status="idle" runId={null} lastSeq={0} />}
/>
);
}
/** 会话页:左对话(复用 MessageList)/ 右画布 / 节点抽屉 / 报告预览。 */
export function ReportCollaborationSessionPage({ sessionId }: { sessionId: string }) {
const navigate = useNavigate();
const location = useLocation();
const session = useReportCollaborationSession(sessionId);
const { state } = session;
const layout = useReportPanelLayout();
const phase = useMemo(() => derivePagePhase(state), [state]);
const agentTabs = useMemo(() => selectAgentTabs(state), [state]);
const [focusedAgentRunId, setFocusedAgentRunId] = useState<string | null>(null);
const [focusPinned, setFocusPinned] = useState(false);
const effectiveFocus = agentTabs.length > 0 ? (focusedAgentRunId ?? agentTabs[0].agent_run_id) : null;
const { previewPlanId, previewPlan, effectivePlanId } = useReportPlanSelection(
state.plans,
state.selectedPlanId,
);
const canvasPlan = useMemo(
() => selectPlanForCanvas(state, previewPlanId),
// eslint-disable-next-line react-hooks/exhaustive-deps
[state.plans, state.planMap, state.selectedPlanId, previewPlanId],
);
void effectivePlanId;
const [selectedNodeId, setSelectedNodeId] = useState<string | null>(null);
const [drawerOpen, setDrawerOpen] = useState(false);
const [composerTarget, setComposerTarget] = useState<ComposerTarget | null>(null);
const [focusSignal, setFocusSignal] = useState(0);
const [previewOpen, setPreviewOpen] = useState(false);
const [previewVersionId, setPreviewVersionId] = useState<string | null>(null);
const [restoreBusy, setRestoreBusy] = useState(false);
// 新会话首条消息(location.state.rcInitialMessage),快照就绪且时间线为空时发送一次。
const initialSentRef = useRef(false);
useEffect(() => {
if (initialSentRef.current || !state.snapshotLoaded) return;
initialSentRef.current = true;
const initial = (location.state as { rcInitialMessage?: unknown } | null)?.rcInitialMessage;
if (typeof initial === "string" && initial.trim() && state.messageOrder.length === 0) {
void session.send(initial);
}
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [state.snapshotLoaded]);
// 动作错误 → toast。
useEffect(() => {
if (session.actionError) {
toast.error(session.actionError, { description: "操作未生效,可重试或刷新快照" });
session.clearActionError();
}
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [session.actionError]);
// 虚拟业务卡:方案组(已出方案且 run 未开始)/ 命令确认 / 报告入口。
// 采用方案后卡片保留,「开始协作」按钮随选定态启用;run 开始后消失。
const runStarted = Boolean(state.run && state.run.plan_id);
const extraCards = useMemo<Message[]>(() => {
const cards: Message[] = [];
if (
state.plans.length > 0 &&
!runStarted &&
(phase === "proposal_ready" || phase === "planning")
) {
cards.push(
buildPlanGroupCard(state.plans, state.selectedPlanId, state.session?.requirement_revision ?? 1),
);
}
for (const command of selectPendingConfirmationCommands(state)) {
cards.push(buildCommandConfirmCard(command));
}
const head = selectHeadReportVersion(state);
if (head && (phase === "completed" || phase === "reviewing" || phase === "cancelled")) {
cards.push(buildReportAvailableCard(head, state.reportVersions.length));
}
return cards;
}, [phase, runStarted, state]);
const { displayThread } = useReportCollaborationMessages(
state,
effectiveFocus,
extraCards,
session.sendBusy,
);
const streamingIds = useMemo(() => selectStreamingAgentRunIds(state), [state]);
const awaitingIds = useMemo(() => {
const ids = new Set<string>();
for (const node of selectAwaitingInputNodes(state)) {
for (const agentRun of Object.values(state.agentRuns)) {
if (agentRun.node_run_id?.startsWith(`${node.node_id}-`)) {
ids.add(agentRun.agent_run_id);
}
}
}
return ids;
}, [state]);
const findMemberOfNode = useCallback(
(nodeId: string) => {
const members = selectParallelMembers(state);
return (
members.find((member) => member.node_run_id?.startsWith(`${nodeId}-`)) ??
Object.values(state.agentRuns).find(
(agentRun) =>
agentRun.role !== "协调者" && agentRun.node_run_id?.startsWith(`${nodeId}-`),
) ??
null
);
},
[state],
);
const handleSelectNode = useCallback(
(nodeId: string | null) => {
setSelectedNodeId(nodeId);
setDrawerOpen(Boolean(nodeId));
// 打开并行成员节点时同步聚焦对应标签(用户发送前先看到该成员的真实对话)。
if (nodeId) {
const member = findMemberOfNode(nodeId);
if (member) {
setFocusedAgentRunId(member.agent_run_id);
setFocusPinned(true);
}
}
},
[findMemberOfNode],
);
const handleNodeComment = useCallback(
(nodeId: string, nodeName: string) => {
const member = findMemberOfNode(nodeId);
setComposerTarget({ nodeId, nodeName, agentRunId: member?.agent_run_id ?? null });
if (member) {
setFocusedAgentRunId(member.agent_run_id);
setFocusPinned(true);
}
setDrawerOpen(false);
setFocusSignal((signal) => signal + 1);
},
[findMemberOfNode],
);
const handleRestore = useCallback(
async (versionId: string) => {
setRestoreBusy(true);
try {
await getReportCollaborationDriver().restoreReportVersion(sessionId, versionId);
session.refreshSnapshot();
toast.success("已恢复为新的头版本");
} catch (err) {
toast.error(err instanceof Error ? err.message : String(err));
} finally {
setRestoreBusy(false);
}
},
[sessionId, session],
);
const businessCardSlot = useCallback(
(message: Message) => {
const card = readReportCollaborationCard(message);
if (!card) return null;
if (card.kind === "plan_group") {
return (
<ReportPlanCards
plans={card.plans}
selectedPlanId={card.selectedPlanId}
previewPlanId={previewPlanId}
onPreview={previewPlan}
onSelect={(planId) => void session.selectPlan(planId)}
onStart={(planId) => void session.startRun(planId)}
onRegenerate={() => void session.requestPlans()}
selectBusy={session.sendBusy}
startBusy={session.sendBusy}
regenerateBusy={false}
/>
);
}
if (card.kind === "command_confirm") {
return (
<InterventionCard
command={card.command}
busy={session.sendBusy}
onConfirm={(commandId) => void session.confirmCommand(commandId)}
onCancel={(commandId) => void session.cancelCommand(commandId)}
/>
);
}
if (card.kind === "report_available") {
return (
<ReportAvailableCard
version={card.version}
versionCount={card.versionCount}
onOpen={(versionId) => {
setPreviewVersionId(versionId);
setPreviewOpen(true);
}}
/>
);
}
return null;
},
[previewPlan, previewPlanId, session],
);
const runActive = isRunActive(state.run?.status);
const headVersion = selectHeadReportVersion(state);
const nodeStates = selectNodeStatusMap(state);
const drawerFallback = selectedNodeId
? {
label: state.nodes[selectedNodeId]?.label ?? canvasPlan?.nodes.find((n) => n.id === selectedNodeId)?.label ?? selectedNodeId,
status: state.nodes[selectedNodeId]?.status ?? "planned",
}
: null;
if (session.snapshotError && !state.snapshotLoaded) {
return (
<ReportCollaborationLayout
layout={layout}
header={
<ReportCollaborationHeader
title="会话不可用"
phase="empty"
onBack={() => navigate("/page/workspace/report-collaboration")}
onNewSession={() => navigate("/page/workspace/report-collaboration")}
onOpenReport={() => undefined}
hasReport={false}
running={false}
onCancelRun={() => undefined}
/>
}
conversation={
<div className="rc-empty">
<FileText className="size-8 opacity-30" aria-hidden />
<p>{session.snapshotError}</p>
<button type="button" className="rc-btn" onClick={() => navigate("/page/workspace/report-collaboration")}>
返回新建会话
</button>
</div>
}
canvas={<ReportFlowCanvas plan={null} nodeStates={{}} selectedNodeId={null} onSelectNode={() => undefined} />}
statusBar={<ConnectionStatusBar status="idle" runId={null} lastSeq={0} />}
/>
);
}
return (
<>
<ReportCollaborationLayout
layout={layout}
header={
<ReportCollaborationHeader
title={state.session?.title ?? "报告协作"}
phase={phase}
onBack={() => navigate("/page/workspace/chats/new")}
onNewSession={() => navigate("/page/workspace/report-collaboration")}
onOpenReport={() => {
if (headVersion) {
setPreviewVersionId(headVersion.id);
setPreviewOpen(true);
}
}}
hasReport={Boolean(headVersion)}
running={runActive}
onCancelRun={() => void session.cancelRun()}
extra={
layout.isNarrow ? (
<NarrowSwitch narrowView={layout.narrowView} setNarrowView={layout.setNarrowView} />
) : null
}
/>
}
conversation={
<ConversationSidebarTabs
conversation={
<ReportConversationPanel
sessionId={sessionId}
thread={displayThread}
businessCardSlot={businessCardSlot}
loading={session.snapshotLoading}
stageSelector={
<AgentStageSelector
tabs={agentTabs}
focusedAgentRunId={effectiveFocus}
onFocus={(agentRunId) => {
setFocusedAgentRunId(agentRunId);
setFocusPinned(true);
}}
streamingAgentRunIds={streamingIds}
awaitingAgentRunIds={awaitingIds}
/>
}
composer={
<ReportComposer
phase={phase}
busy={session.sendBusy}
target={composerTarget}
onClearTarget={() => setComposerTarget(null)}
onSend={(text) =>
void session.send(text, {
nodeId: composerTarget?.nodeId ?? null,
agentRunId: composerTarget?.agentRunId ?? null,
})
}
focusSignal={focusSignal}
/>
}
/>
}
history={<SessionHistoryPanel activeSessionId={sessionId} />}
/>
}
canvas={
<>
<ReportFlowCanvas
plan={canvasPlan}
nodeStates={nodeStates}
selectedNodeId={selectedNodeId}
onSelectNode={handleSelectNode}
/>
<NodeInspectorDrawer
open={drawerOpen}
nodeId={selectedNodeId}
runId={state.run?.id ?? state.session?.active_run_id ?? null}
fallback={drawerFallback}
onClose={() => setDrawerOpen(false)}
onComment={handleNodeComment}
/>
</>
}
statusBar={
<ConnectionStatusBar
status={session.streamStatus.status}
runId={state.run?.id ?? null}
lastSeq={state.lastSeq}
message={session.streamStatus.message}
/>
}
/>
<ReportPreviewDialog
open={previewOpen}
onClose={() => setPreviewOpen(false)}
versions={state.reportVersions}
activeVersionId={previewVersionId}
onSelectVersion={setPreviewVersionId}
onRestore={(versionId) => void handleRestore(versionId)}
restoreBusy={restoreBusy}
/>
</>
);
}