import { useCallback, useEffect, useMemo, useRef, useState } from "react"; import { AlertTriangle, Check, CircleDot, Download, Loader2, Maximize, Minimize, PanelRightClose, PanelRightOpen, Redo2, Sparkles, Undo2, X, } from "lucide-react"; import type { ProjectAsset, ProjectDetail, ShotArtifact } from "@/services/api/projects"; import { linkProjectAsset, listProjectAssets } from "@/services/api/projects"; import { useEditorSlots, type EditorSlotRegistration } from "@/lib/plugins/editor-slot-registry"; import { pluginMayRenderEditorSlot } from "@/lib/plugins/plugin-permission-check"; import { EditorStoreProvider } from "@/components/editor/editor-context"; import { createEditorStore } from "@/stores/editor/editor-store"; import { localForageStorageForScope } from "@/lib/localforage-storage"; import { getActiveUserScope } from "@/lib/user-scope"; import { normalizeTimelineProject } from "@/lib/timeline/timeline-tracks"; import { formatTimelineTime } from "@/lib/timeline/timeline-view"; import { useEditorStoreContext } from "@/components/editor/editor-context"; import type { TimelineProject } from "@/types/timeline"; const EDITOR_TIMELINE_KEY = "editor-timeline"; /** * 为尚未产生本地时间线的项目建立一个可编辑的初始时间线。 * 该时间线只写入当前用户与项目作用域的本地存储,不代表服务端已有成片数据。 */ function createEmptyEditorTimeline(): TimelineProject { // 没有真实素材时返回空时间线,避免把不存在的 demo node 当成可剪辑资产。 // 用户添加素材后由编辑器命令创建轨道和片段;空项目不应被伪造为已有成片。 return normalizeTimelineProject({ version: 2, tracks: [], clips: [], durationMs: 0 }); } /** 插槽堆叠:只渲染通过权限检查的插件贡献;无可用插件时显示明确的缺失能力提示。 * 缺权限插件不渲染,改为一行诊断提示;无贡献时显示空态(停用插件可见)。 */ function SlotStack({ slots, emptyHint }: { slots: EditorSlotRegistration[]; emptyHint: string }) { const allowed = slots.filter((slot) => pluginMayRenderEditorSlot(slot.pluginId, slot.slot).allowed); const denied = slots.filter((slot) => !pluginMayRenderEditorSlot(slot.pluginId, slot.slot).allowed); if (allowed.length === 0 && denied.length === 0) { return (

{emptyHint}

); } return ( <> {allowed.map((slot) => (
{slot.render({ pluginId: slot.pluginId })}
))} {denied.map((slot) => { const verdict = pluginMayRenderEditorSlot(slot.pluginId, slot.slot); const missing = verdict.allowed === false && verdict.reason === "missing-permission" ? verdict.missing : null; return (
{missing ? `插件 ${slot.pluginId} 缺少 ${missing} 权限,已停用该面板。` : `插件 ${slot.pluginId} 未注册,已停用该面板。`}
); })} ); } /** 面板 Tab 条(Concat 式分类/属性切换):只渲染激活槽,全部槽始终注册。 */ function PanelTabs({ tabs, active, onChange, trailing, }: { tabs: { id: string; label: string }[]; active: string; onChange: (id: string) => void; trailing?: React.ReactNode; }) { return (
{tabs.map((tab) => ( ))}
{trailing}
); } /** 顶部工具栏(Concat 主菜单区):项目名 + 全局撤销/重做 + 保存状态 + 导出主按钮。 */ function EditorTopBar({ onExport, isFullscreen, onToggleFullscreen, aiOpen, onToggleAi, }: { onExport: () => void; isFullscreen: boolean; onToggleFullscreen: () => void; aiOpen: boolean; onToggleAi: () => void; }) { const { project, history, isDirty, saving, saveError, undo, redo } = useEditorStoreContext(); const canUndo = (history?.undoStack.length ?? 0) > 0; const canRedo = (history?.redoStack.length ?? 0) > 0; return (
{saveError ? ( ) : saving ? ( ) : isDirty ? ( ) : ( )}
); } /** 底部状态栏:时长 / 片段数 / 轨道数 / 快捷键提示。 */ function EditorStatusBar({ projectName }: { projectName: string }) { const { project } = useEditorStoreContext(); const clipCount = project?.clips.length ?? 0; const trackCount = project?.tracks.length ?? 0; const durationMs = project?.durationMs ?? 0; return ( ); } export default function ProjectEditorView({ detail }: { detail: ProjectDetail }) { // 插槽注册(全部 8 种始终注册;左/右栏 Tab 决定当前渲染哪个)。 const previewSlots = useEditorSlots("preview-renderer"); const timelineSlots = useEditorSlots("timeline-panel"); const assetSlots = useEditorSlots("asset-ingest"); const transcriptionSlots = useEditorSlots("transcription-provider"); const inspectorSlots = useEditorSlots("inspector"); const subtitleSlots = useEditorSlots("subtitle-tool"); const exportSlots = useEditorSlots("export-renderer"); const aiSlots = useEditorSlots("ai-assistant"); const [leftTab, setLeftTab] = useState("asset"); const [rightTab, setRightTab] = useState("inspector"); const [rightCollapsed, setRightCollapsed] = useState(false); const [assets, setAssets] = useState(detail.assets); const workbenchRef = useRef(null); const [isFullscreen, setIsFullscreen] = useState(false); // AI 助手浮层由顶栏按钮打开,支持 Esc 和遮罩点击关闭,避免长期遮挡编辑区。 const [aiOpen, setAiOpen] = useState(false); useEffect(() => { if (!aiOpen) return; const onKey = (e: KeyboardEvent) => { if (e.key === "Escape") setAiOpen(false); }; window.addEventListener("keydown", onKey); return () => window.removeEventListener("keydown", onKey); }, [aiOpen]); // 底部时间线高度(px):分隔条拖拽调整(120–480)。 const [timelineH, setTimelineH] = useState(240); const splitterRef = useRef<{ startY: number; startH: number } | null>(null); const scope = getActiveUserScope(); const projectId = detail.project.id; const assetOwnerKey = JSON.stringify([scope, projectId]); const activeAssetOwnerKeyRef = useRef(assetOwnerKey); const assetRefreshSequenceRef = useRef(0); activeAssetOwnerKeyRef.current = assetOwnerKey; const refreshAssets = useCallback(async (): Promise => { const requestedOwnerKey = assetOwnerKey; const requestSequence = assetRefreshSequenceRef.current + 1; assetRefreshSequenceRef.current = requestSequence; try { const list = (await listProjectAssets(projectId)).assets; // 项目、账号或刷新序号变化都说明当前响应已经过期;旧响应不得覆盖新上下文的素材快照。 if ( activeAssetOwnerKeyRef.current !== requestedOwnerKey || assetRefreshSequenceRef.current !== requestSequence ) { return null; } setAssets(list); return list; } catch (error) { // 过期请求的错误不属于当前编辑器上下文,也不应产生误导性告警。 if (activeAssetOwnerKeyRef.current !== requestedOwnerKey) return null; // 资产列表属于读展示路径:保留当前快照,避免网络抖动让编辑器清空素材。 // 但不能把快照当成同步成功;记录项目上下文,便于定位并在下次进入时重试。 console.warn("刷新项目素材列表失败,已保留当前快照", { projectId, scope, error }); return null; } }, [assetOwnerKey, projectId, scope]); useEffect(() => { const onFsChange = () => setIsFullscreen(document.fullscreenElement === workbenchRef.current); document.addEventListener("fullscreenchange", onFsChange); return () => document.removeEventListener("fullscreenchange", onFsChange); }, []); const toggleFullscreen = () => { const operation = document.fullscreenElement ? document.exitFullscreen() : workbenchRef.current?.requestFullscreen(); void operation?.catch((error) => { console.warn("切换编辑器全屏状态失败", { projectId, error }); }); }; const detailAssetsRef = useRef(detail.assets); detailAssetsRef.current = detail.assets; // 挂载、切换项目或切换账号时先恢复详情快照,再以服务端列表校准。 // detail.assets 只用于切换瞬间占位;refreshAssets 内部负责丢弃过期和乱序响应。 useEffect(() => { setAssets(detailAssetsRef.current); void refreshAssets(); return () => { // 使当前 owner 下仍在途的请求失效,避免组件卸载后提交 state。 assetRefreshSequenceRef.current += 1; }; }, [assetOwnerKey, refreshAssets]); const store = useMemo( () => createEditorStore({ saveTimeline: async (project: TimelineProject) => { await localForageStorageForScope(scope).setItem(`${EDITOR_TIMELINE_KEY}:${projectId}`, JSON.stringify(project)); }, }), [projectId, scope], ); // 进入编辑器时只加载当前用户和项目作用域的本地时间线;没有真实数据时保持空时间线,禁止注入虚构片段。 useEffect(() => { let cancelled = false; void (async () => { try { const storage = localForageStorageForScope(scope); const raw = await storage.getItem(`${EDITOR_TIMELINE_KEY}:${projectId}`); let loaded = createEmptyEditorTimeline(); if (raw) { try { loaded = normalizeTimelineProject(JSON.parse(raw)); } catch (error) { // 本地历史数据属于读展示路径:坏记录不能阻塞编辑器启动, // 但必须记录项目和存储键,后续可按键清理或迁移,而不是把坏数据伪装成有效时间线。 console.warn("读取编辑器本地时间线失败,已使用空时间线", { projectId, storageKey: `${EDITOR_TIMELINE_KEY}:${projectId}`, error, }); } } if (!cancelled) store.getState().load(loaded); } catch (error) { // IndexedDB/localforage 不可用时不写入空时间线,避免覆盖可能仍可恢复的本地数据。 console.error("读取编辑器本地时间线存储失败,保留编辑器初始状态", { projectId, error }); } })(); return () => { cancelled = true; // 卸载前冲刷尚未落盘的改动(如切页发生在防抖窗口内),避免最后几次操作丢失。 // flushSave 失败时 editor-store 会保留 isDirty;这里必须留下错误证据,不能假装已保存。 const flushSave = store.getState().flushSave; if (flushSave) { void flushSave().catch((error) => { console.error("编辑器卸载前保存时间线失败,待下次操作重试", { projectId, error }); }); } }; }, [scope, projectId, store]); // 画布产物自动同步:detail.shotArtifacts 中当前采用(storyboard/action_board/ // 分镜/导出成片,且 ready + 有资源)尚未作为素材进本项目时,自动 // linkProjectAsset(source=canvas) 并入素材库 —— 剪辑器“素材选项”直接可用画布产物。 // 后端幂等(已链接直接返回);单个失败不阻塞其余资源,但会记录告警, // 下次进入编辑器时再次尝试补同步。 // 该集合只表示“当前用户、当前项目会话已处理过”,切换账号或项目时必须清空,避免跨作用域复用 resource ID。 const syncedCanvasResourcesRef = useRef>(new Set()); const syncedAssetOwnerKeyRef = useRef(assetOwnerKey); useEffect(() => { if (syncedAssetOwnerKeyRef.current === assetOwnerKey) return; syncedAssetOwnerKeyRef.current = assetOwnerKey; syncedCanvasResourcesRef.current.clear(); }, [assetOwnerKey]); const canvasSyncKeys = detail.shotArtifacts .filter( (a): a is ShotArtifact & { resourceId: string } => a.selected && a.status === "ready" && !!a.resourceId && ["storyboard", "action_board", "start_frame", "end_frame", "video", "delivery"].includes(a.type), ) .map((a) => `resource:${a.resourceId}`) .join(","); useEffect(() => { if (!canvasSyncKeys) return; const keys = canvasSyncKeys.split(","); // 已同步过的(本会话 ref)或已存在于项目素材的(storageKey 命中)均跳过 —— // storageKey 与 assetFromUploadedResource 合成格式一致(resource:)。 const existing = new Set(assets.map((a) => a.storageKey)); const pending = keys.filter((key) => !syncedCanvasResourcesRef.current.has(key) && !existing.has(key)); if (!pending.length) return; let cancelled = false; void (async () => { for (const key of pending) { if (cancelled) break; const resourceId = key.slice("resource:".length); try { await linkProjectAsset(projectId, { assetId: resourceId, category: "material", source: "canvas" }); // 请求返回时组件可能已经切换项目;旧请求不能把结果记入新项目的会话集合。 if (cancelled) break; syncedCanvasResourcesRef.current.add(key); } catch (error) { // 单个资源同步失败不阻塞其他资源;失败项不加入已完成集合, // 这样下次进入编辑器仍会重试,而不是把未同步伪装成成功。 console.warn("画布产物同步到项目素材失败", { projectId, resourceId, error }); } } if (!cancelled) { // 统一经过带 owner 与请求序号校验的刷新入口,防止同步后的旧请求覆盖新项目快照。 await refreshAssets(); } })(); return () => { cancelled = true; }; }, [assets, canvasSyncKeys, projectId, refreshAssets]); return (
setRightTab("export")} isFullscreen={isFullscreen} onToggleFullscreen={toggleFullscreen} aiOpen={aiOpen} onToggleAi={() => setAiOpen((v) => !v)} /> {/* AI 助手浮层:常驻挂载、随开关显隐,关闭再开保留会话与输入(状态在 SlotStack 内)。 */}
{/* 上区:左栏 + 预览 + 右栏 */}
{/* 左栏:素材 / 转写(Tab 化) */} {/* 中栏:预览(占满剩余高度) */}
{/* 右栏:检查 / 字幕 / 导出(Tab 化,可折叠为窄条;AI 助手已移至顶栏浮层) */} {rightCollapsed ? ( ) : ( )}
{/* 预览/时间线拖拽分隔条(pointer capture,data-canvas-no-zoom 防画布缩放) */}
{ splitterRef.current = { startY: e.clientY, startH: timelineH }; e.currentTarget.setPointerCapture(e.pointerId); }} onPointerMove={(e) => { const drag = splitterRef.current; if (!drag) return; const next = drag.startH - (e.clientY - drag.startY); setTimelineH(Math.min(480, Math.max(120, next))); }} onPointerUp={() => { splitterRef.current = null; }} onPointerCancel={() => { splitterRef.current = null; }} >
{/* 时间线:横跨编辑面板全宽(左栏到右栏) */}
); }