feat: 新增报告协作页,并强化 Deep Research 运行诊断与报告兜底
支持浏览器侧素材快照撰写、拒绝报告读时修复、Mermaid PNG 导出与 Word 导出加固。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
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}
|
||||
/>
|
||||
</>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user