Files
ttstd-infinite-canvas/web/src/pages/canvas/canvas-version-history.tsx
T
ddcat666 080989ad5f fix(canvas): 画布同步 - 版本冲突先核对并合并,本地保存与云端状态分开展示
本地持久化记录保存时间和日志令牌,同步面板区分本地与云端,不再用提示打断编辑。冲突时先尝试合并,无法合并才保留草稿并暂停自动提交;未登录时生成结果留在本地,登录后再继续上传。
2026-10-09 17:17:38 +08:00

409 lines
19 KiB
TypeScript

import { AppDrawer } from "@/components/ui/product/app-drawer";
import { EmptyState } from "@/components/ui/product/empty-state";
import { App, Button, Grid, Spin } from "antd";
import { Check, ChevronDown, Cloud, FileClock, History, RefreshCw, X } from "lucide-react";
import { useCallback, useEffect, useRef, useState } from "react";
import { getCanvasHistoryEntry, listCanvasHistory, type CanvasHistoryEntry } from "@/services/api/user-data";
import { readCanvasSyncDrafts, type CanvasSyncDraft } from "@/services/canvas-sync-drafts";
import { getActiveUserScope } from "@/lib/user-scope";
import type { CanvasProject } from "@/stores/canvas/use-canvas-store";
import { useSyncProgressStore } from "@/stores/use-sync-progress-store";
import "./canvas-version-history.css";
export type CanvasVersionPreviewState = {
key: string;
label: string;
date: string;
kind: "cloud" | "draft";
snapshot?: CanvasHistoryEntry;
project?: CanvasProject;
error?: string;
};
export function useCanvasVersionHistory(projectId: string, onRestore: (snapshotId: string, revision: number) => Promise<void>) {
const { message, modal } = App.useApp();
const desktop = Boolean(Grid.useBreakpoint().lg);
const scope = getActiveUserScope();
const contextRef = useRef({ projectId, scope });
contextRef.current = { projectId, scope };
const isCurrentContext = () => contextRef.current.projectId === projectId && contextRef.current.scope === scope && getActiveUserScope() === scope;
const draftCount = useSyncProgressStore((state) => state.syncingProjects[projectId]?.draftCount);
const [open, setOpen] = useState(false);
const [listOpen, setListOpen] = useState(true);
const [tab, setTab] = useState<"cloud" | "draft">("cloud");
const [entries, setEntries] = useState<CanvasHistoryEntry[]>([]);
const [drafts, setDrafts] = useState<CanvasSyncDraft[]>([]);
const [currentRevision, setCurrentRevision] = useState<number>();
const [preview, setPreview] = useState<CanvasVersionPreviewState | null>(null);
const [loading, setLoading] = useState(false);
const [draftLoading, setDraftLoading] = useState(false);
const [restoring, setRestoring] = useState(false);
const [confirming, setConfirming] = useState(false);
const [error, setError] = useState("");
const [draftError, setDraftError] = useState("");
const [reload, setReload] = useState(0);
const previewRequest = useRef<AbortController | null>(null);
const returnToCurrent = useCallback(() => {
previewRequest.current?.abort();
setPreview(null);
}, []);
const close = useCallback(() => {
if (!restoring) {
setOpen(false);
returnToCurrent();
}
}, [restoring, returnToCurrent]);
useEffect(() => {
setOpen(false);
setTab("cloud");
returnToCurrent();
}, [projectId, scope, returnToCurrent]);
useEffect(() => {
if (!open) return;
const controller = new AbortController();
setLoading(true);
setError("");
setEntries([]);
setCurrentRevision(undefined);
void listCanvasHistory(projectId, controller.signal)
.then((result) => {
if (controller.signal.aborted || !isCurrentContext()) return;
setEntries(result.snapshots);
// Keep the revision observed with this list as the restore precondition.
setCurrentRevision(result.currentRevision);
})
.catch((cause) => {
if (!controller.signal.aborted && isCurrentContext()) setError(cause instanceof Error ? cause.message : "历史版本读取失败");
})
.finally(() => {
if (!controller.signal.aborted && isCurrentContext()) setLoading(false);
});
return () => controller.abort();
}, [open, projectId, reload, scope]);
useEffect(() => {
if (!open) return;
let active = true;
setDraftLoading(true);
setDraftError("");
setDrafts([]);
void readCanvasSyncDrafts(projectId, scope)
.then((items) => {
if (active && isCurrentContext()) setDrafts(items.sort((a, b) => b.savedAt.localeCompare(a.savedAt)));
})
.catch(() => {
if (active && isCurrentContext()) setDraftError("本地草稿读取失败,请刷新重试");
})
.finally(() => {
if (active && isCurrentContext()) setDraftLoading(false);
});
return () => {
active = false;
};
}, [open, projectId, reload, scope, draftCount]);
useEffect(
() => () => {
previewRequest.current?.abort();
},
[open, projectId, scope],
);
const selectVersion = (entry: CanvasHistoryEntry) => {
previewRequest.current?.abort();
const controller = new AbortController();
previewRequest.current = controller;
const selection: CanvasVersionPreviewState = { key: entry.id, label: `版本 ${entry.revision}`, date: entry.contentUpdatedAt, kind: "cloud", snapshot: entry };
setPreview(selection);
setListOpen(false);
void getCanvasHistoryEntry(projectId, entry.id, controller.signal)
.then(({ project }) => {
if (!controller.signal.aborted && previewRequest.current === controller && isCurrentContext()) setPreview({ ...selection, project });
})
.catch((cause) => {
if (!controller.signal.aborted && previewRequest.current === controller && isCurrentContext()) setPreview({ ...selection, error: cause instanceof Error ? cause.message : "预览读取失败,请重新选择版本" });
});
};
const restore = () => {
const selected = preview?.snapshot;
if (!selected || !preview.project || currentRevision === undefined || restoring) return;
setConfirming(true);
modal.confirm({
title: `恢复版本 ${selected.revision} 的内容?`,
content: "恢复前会备份当前云端内容,并保留本地草稿。恢复后会生成一个新版本,画布的项目归属保持当前设置。",
okText: "恢复此版本",
cancelText: "取消",
afterClose: () => setConfirming(false),
onOk: async () => {
if (!isCurrentContext()) {
message.error("画布或账号已切换,请重新打开版本记录");
return;
}
setRestoring(true);
try {
await onRestore(selected.id, currentRevision);
returnToCurrent();
setReload((value) => value + 1);
message.success("已恢复内容并保存为新版本");
} catch (cause) {
const detail = cause instanceof Error ? cause.message : "恢复失败,请重试";
setError(detail);
message.error(detail);
} finally {
setRestoring(false);
}
},
});
};
return {
open,
listOpen,
desktop,
tab,
entries,
drafts,
currentRevision,
preview,
loading,
draftLoading,
restoring,
confirming,
error,
draftError,
show: () => {
setOpen(true);
setListOpen(true);
},
toggle: () => {
if (open && (desktop || listOpen)) close();
else {
setOpen(true);
setListOpen(true);
}
},
hideList: () => {
if (!restoring) {
setListOpen(false);
if (!preview) setOpen(false);
}
},
close,
changeTab: (next: "cloud" | "draft") => {
setTab(next);
returnToCurrent();
},
refresh: () => {
returnToCurrent();
setReload((value) => value + 1);
},
selectVersion,
selectDraft: (draft: CanvasSyncDraft) => {
previewRequest.current?.abort();
setPreview({ key: draft.id, label: "本地草稿", date: draft.savedAt, kind: "draft", project: draft.project });
setListOpen(false);
},
returnToCurrent,
restore,
};
}
export type CanvasVersionHistoryController = ReturnType<typeof useCanvasVersionHistory>;
export function CanvasVersionHistory({ history }: { history: CanvasVersionHistoryController }) {
const { open, tab, entries, drafts, currentRevision, preview, loading, draftLoading, restoring, error, draftError } = history;
if (!open) return null;
const groups = new Map<string, CanvasHistoryEntry[]>();
for (const entry of entries) {
const day = new Date(entry.contentUpdatedAt).toLocaleDateString("zh-CN", { year: "numeric", month: "long", day: "numeric" });
groups.set(day, [...(groups.get(day) || []), entry]);
}
const content = (
<div className="canvas-version-panel" data-canvas-no-zoom data-canvas-wheel-scroll>
<header className="canvas-version-header">
<History size={17} />
<h2>版本记录</h2>
<Button type="text" size="small" aria-label="刷新版本记录" icon={<RefreshCw size={15} />} disabled={restoring || loading} onClick={history.refresh} />
<Button type="text" size="small" aria-label="关闭版本记录" icon={<X size={17} />} disabled={restoring} onClick={history.close} />
</header>
<div
className="canvas-version-tabs"
role="tablist"
aria-label="版本来源"
onKeyDown={(event) => {
if (restoring || !["ArrowLeft", "ArrowRight", "Home", "End"].includes(event.key)) return;
event.preventDefault();
const next = event.key === "Home" ? "cloud" : event.key === "End" ? "draft" : tab === "cloud" ? "draft" : "cloud";
history.changeTab(next);
event.currentTarget.querySelector<HTMLButtonElement>(`[data-tab="${next}"]`)?.focus();
}}
>
<button
type="button"
id="canvas-cloud-tab"
role="tab"
data-tab="cloud"
aria-selected={tab === "cloud"}
aria-controls="canvas-version-list"
tabIndex={tab === "cloud" ? 0 : -1}
disabled={restoring}
onClick={() => history.changeTab("cloud")}
>
<Cloud size={14} />
云端历史
</button>
<button
type="button"
id="canvas-draft-tab"
role="tab"
data-tab="draft"
aria-selected={tab === "draft"}
aria-controls="canvas-version-list"
tabIndex={tab === "draft" ? 0 : -1}
disabled={restoring}
onClick={() => history.changeTab("draft")}
>
<FileClock size={14} />
本地草稿 <span className="canvas-version-count">{drafts.length}</span>
</button>
</div>
<div id="canvas-version-list" role="tabpanel" aria-labelledby={tab === "cloud" ? "canvas-cloud-tab" : "canvas-draft-tab"} className="canvas-version-list">
{tab === "cloud" ? (
<>
<button type="button" className="canvas-version-current" aria-pressed={!preview} disabled={restoring} onClick={history.returnToCurrent}>
<span className="canvas-version-dot">
<Check size={12} />
</span>
<span>
<strong>当前画布</strong>
<small>{currentRevision === undefined ? "云端版本待确认" : `打开记录时云端为 v${currentRevision}`}</small>
</span>
{!preview ? <span className="canvas-version-tag">当前</span> : null}
</button>
<p className="canvas-version-hint">查看旧版不会修改当前画布</p>
{error ? (
<p role="alert" className="canvas-version-error">
{error}
</p>
) : null}
{loading ? (
<div className="canvas-version-empty">
<Spin size="small" />
</div>
) : !entries.length && !error ? (
<EmptyState size="compact" description="暂无历史版本,后续保存时会自动保留" />
) : null}
{[...groups].map(([day, items]) => (
<details className="canvas-version-group" key={day} open>
<summary>
<ChevronDown size={14} />
<span>{day}</span>
<span className="canvas-version-count">{items.length}</span>
</summary>
<div className="canvas-version-branches">
{items.map((entry) => (
<button type="button" key={entry.id} className="canvas-version-item" disabled={restoring} aria-pressed={preview?.key === entry.id} onClick={() => history.selectVersion(entry)}>
<span className="canvas-version-item-title">
<time dateTime={entry.contentUpdatedAt}>{formatTime(entry.contentUpdatedAt)}</time>
<span className="canvas-version-tag">v{entry.revision}</span>
</span>
<span className="canvas-version-reason">{entry.reason === "before_restore" ? "恢复前备份" : "自动保存"}</span>
<small>
{entry.nodeCount} 个节点 · {entry.connectionCount} 条连线
</small>
</button>
))}
</div>
</details>
))}
</>
) : (
<>
<p className="canvas-version-draft-note">发生冲突或恢复版本时,系统自动保留的本地内容,可在此查看。</p>
{draftError ? (
<p role="alert" className="canvas-version-error">
{draftError}
</p>
) : null}
{draftLoading ? (
<div className="canvas-version-empty">
<Spin size="small" />
</div>
) : !drafts.length && !draftError ? (
<EmptyState size="compact" description="暂无本地草稿" />
) : null}
{drafts.map((draft) => (
<button type="button" key={draft.id} className="canvas-version-item canvas-version-draft" disabled={restoring} aria-pressed={preview?.key === draft.id} onClick={() => history.selectDraft(draft)}>
<span className="canvas-version-item-title">
<FileClock size={15} />
<strong>本机备份</strong>
{draft.project.revision !== undefined ? <span className="canvas-version-tag">基于 v{draft.project.revision}</span> : null}
</span>
<time dateTime={draft.savedAt}>{new Date(draft.savedAt).toLocaleString("zh-CN")}</time>
<small>
{draft.project.nodes.length} 个节点 · {draft.project.connections.length} 条连线
</small>
</button>
))}
</>
)}
</div>
<footer className="canvas-version-footer">
{preview ? (
<>
<div className="canvas-version-item-title">
<strong>{preview.label}</strong>
<span className="canvas-version-tag">只读预览</span>
</div>
<small>{new Date(preview.date).toLocaleString("zh-CN")}</small>
{preview.project ? (
<small>
{preview.project.nodes.length} 个节点 · {preview.project.connections.length} 条连线
</small>
) : null}
{preview.project?.nodes.some((node) => node.type === "drawing") ? <p className="canvas-version-hint">绘图仅保留已上传的预览,不含本机历史笔画。</p> : null}
{preview.kind === "cloud" ? (
<div className="canvas-version-actions">
<Button block type="primary" loading={restoring} disabled={!preview.project || currentRevision === undefined || loading} onClick={history.restore}>
恢复此版本
</Button>
</div>
) : null}
</>
) : (
<p className="canvas-version-hint">{tab === "cloud" ? "内容变化时最多每 5 分钟保留一份,保留最近 20 份。恢复前额外备份。" : "草稿保存在此浏览器中,查看草稿不会修改当前画布。"}</p>
)}
</footer>
</div>
);
return history.desktop ? (
<aside className="canvas-version-sidebar" aria-label="版本记录">
{content}
</aside>
) : (
<AppDrawer
flush
open={history.listOpen}
focusable={{ trap: !history.confirming }}
placement="right"
title={null}
closable={false}
onClose={history.hideList}
maskClosable={!restoring}
keyboard={!restoring}
size="min(350px, 92vw)"
aria-label="版本记录"
>
{content}
</AppDrawer>
);
}
function formatTime(date: string) {
return new Date(date).toLocaleTimeString("zh-CN", { hour: "2-digit", minute: "2-digit", hour12: false });
}