feat(workspace): 工作区浏览器后退历史与离开守卫

src/app/layout.tsx

@@ -13,6 +13,7 @@ import { OverlayScrollbarsInit } from "@/components/overlay-scrollbars-init"
 import { ClipboardFallbackInit } from "@/components/clipboard-fallback-init"
 import { WebConnectionGuard } from "@/components/connection/web-connection-guard"
 import { WindowResizeGrips } from "@/components/layout/window-resize-grips"
+import { WorkspaceLeaveGuard } from "@/components/workspace/workspace-leave-guard"
 
 export const viewport: Viewport = {
   width: "device-width",
@@ -73,6 +74,7 @@ export default async function RootLayout({
                 <ClipboardFallbackInit />
                 <WebConnectionGuard />
                 <WindowResizeGrips />
+                <WorkspaceLeaveGuard />
                 {children}
               </AppearanceProvider>
             </ThemeProvider>

src/app/workspace/layout.tsx

@@ -35,6 +35,8 @@
   WorkbenchRouteProvider,
   useWorkbenchRoute,
 } from "@/contexts/workbench-route-context"
+import { WorkspaceWindowHistoryProvider } from "@/contexts/workspace-window-history"
+
 import {
   WorkbenchRoutePage,
   WorkbenchRouteStrip,
@@ -1267,18 +1269,19 @@
 
 function WorkspaceLayoutInner({ children }: { children: React.ReactNode }) {
   return (
-    <AppWorkspaceProvider>
-      <AlertProvider>
+    <WorkspaceWindowHistoryProvider>
+      <AppWorkspaceProvider>
+        <AlertProvider>
         <GitCredentialProvider>
           <TaskProvider>
             <AcpConnectionsProvider>
               <DelegationProvider>
                 <ConversationStatusEventBridge />
                 <ConversationRuntimeProvider>
                   <WorkspaceProvider>
                     <TabProvider>
                       <WorkspaceDocumentTitle />
                       <TabKeysSync />
                       <HeavyPluginsWarmup />
                       <DeepLinkBootstrap />
                       <PetFocusBridge />
@@ -1314,8 +1317,9 @@
             </AcpConnectionsProvider>
           </TaskProvider>
         </GitCredentialProvider>
-      </AlertProvider>
-    </AppWorkspaceProvider>
+        </AlertProvider>
+      </AppWorkspaceProvider>
+    </WorkspaceWindowHistoryProvider>
   )
 }
 

src/components/ui/drawer.tsx

@@ -9,6 +9,7 @@ import { attachRef } from "@/lib/attach-ref"
 import { cn } from "@/lib/utils"
 import { Button } from "@/components/ui/button"
 import { XIcon } from "lucide-react"
+import { useBrowserBackWindow } from "@/contexts/workspace-window-history"
 
 type DrawerContextProps = {
   hasSnapPoints: boolean
@@ -177,6 +178,20 @@ function Drawer({
   showSwipeHandle?: boolean
 }) {
   const hasSnapPoints = snapPoints != null && snapPoints.length > 0
+  useBrowserBackWindow({
+    open: props.open ?? false,
+    onClose: () =>
+      onOpenChange?.(false, {
+        reason: "none",
+        event: new Event("close"),
+        cancel: () => {},
+        allowPropagation: () => {},
+        isCanceled: false,
+        isPropagationAllowed: true,
+        trigger: undefined,
+        preventUnmountOnClose: () => {},
+      }),
+  })
   const contextValue = React.useMemo(
     () => ({ hasSnapPoints, modal, showSwipeHandle, swipeDirection }),
     [hasSnapPoints, modal, showSwipeHandle, swipeDirection]

src/components/workspace/workspace-leave-guard.tsx

@@ -0,0 +1,48 @@
+"use client"
+
+import { useEffect } from "react"
+import { usePathname, useRouter } from "next/navigation"
+import { useTranslations } from "next-intl"
+import { isDesktop } from "@/lib/platform"
+
+/**
+ * Confirms before a same-document back/forward traversal leaves /workspace,
+ * and before the page is closed or refreshed while the workspace is open.
+ * In-window navigation (drawers, in-memory routes) is handled by
+ * WorkspaceWindowHistoryProvider and never reaches this guard.
+ * Applies on every platform; only the beforeunload half skips the desktop
+ * client, where suppressing unload could block the app window from closing.
+ */
+export function WorkspaceLeaveGuard() {
+  const t = useTranslations("Folder.workspaceContext")
+  const pathname = usePathname()
+  const router = useRouter()
+
+  useEffect(() => {
+    const onPopState = () => {
+      if (
+        pathname !== "/workspace" ||
+        window.location.pathname === "/workspace"
+      ) {
+        return
+      }
+      if (!window.confirm(t("confirmLeaveWorkspace"))) {
+        router.replace("/workspace", { scroll: false })
+      }
+    }
+    window.addEventListener("popstate", onPopState)
+    return () => window.removeEventListener("popstate", onPopState)
+  }, [pathname, router, t])
+
+  useEffect(() => {
+    if (isDesktop() || pathname !== "/workspace") return
+    const onBeforeUnload = (event: BeforeUnloadEvent) => {
+      event.preventDefault()
+      event.returnValue = ""
+    }
+    window.addEventListener("beforeunload", onBeforeUnload)
+    return () => window.removeEventListener("beforeunload", onBeforeUnload)
+  }, [pathname])
+
+  return null
+}

src/contexts/workbench-route-context.tsx

@@ -8,6 +8,7 @@ import {
   useState,
   type ReactNode,
 } from "react"
+import { useBrowserBackWindow } from "@/contexts/workspace-window-history"
 
 /**
  * The view occupying the main content region. `"conversations"` is the default
@@ -77,6 +78,12 @@ export function WorkbenchRouteProvider({ children }: { children: ReactNode }) {
   const setRoute = useCallback((id: WorkbenchRouteId) => setRouteId(id), [])
   const openConversations = useCallback(() => setRouteId("conversations"), [])
 
+  useBrowserBackWindow({
+    open: routeId !== "conversations",
+    onClose: openConversations,
+    key: "workbench-route",
+  })
+
   const value = useMemo<WorkbenchRouteContextValue>(
     () => ({
       routeId,

src/contexts/workspace-context.tsx

@@ -12,6 +12,7 @@ import {
 } from "react"
 import { useTranslations } from "next-intl"
 import { useActiveFolder } from "@/contexts/active-folder-context"
+import { useBrowserBackWindow } from "@/contexts/workspace-window-history"
 import { useAppWorkspaceStore } from "@/stores/app-workspace-store"
 import { buildFileTabId } from "@/lib/file-tab-id"
 import {
@@ -111,7 +112,9 @@ interface WorkspaceActionsValue {
   switchFileTab: (tabId: string) => void
   closeFileTab: (tabId: string) => void
   closeOtherFileTabs: (tabId: string) => void
-  closeAllFileTabs: () => void
+  /** Returns false when the user vetoes the dirty-tabs confirm, so the
+   *  browser-back integration can restore the history entry it consumed. */
+  closeAllFileTabs: () => boolean
   reorderFileTabs: (tabs: FileWorkspaceTab[]) => void
   // Open a file tab. Accepts absolute paths, `~/` paths (expanded via the
   // backend home dir), and paths relative to a folder root. `folderId` is
@@ -2243,13 +2246,15 @@ export function WorkspaceProvider({ children }: WorkspaceProviderProps) {
     [activateFilePane, t]
   )
 
-  const closeAllFileTabs = useCallback(() => {
-    setFileTabs((prev) => {
-      if (prev.some(isDirtyFileTab)) {
-        const confirmed = window.confirm(t("confirmCloseAllDirtyTabs"))
-        if (!confirmed) return prev
-      }
+  const closeAllFileTabs = useCallback((): boolean => {
+    // Confirm outside the state updater: the browser-back handler needs the
+    // veto synchronously to decide whether to restore the history entry.
+    if (fileTabsRef.current.some(isDirtyFileTab)) {
+      const confirmed = window.confirm(t("confirmCloseAllDirtyTabs"))
+      if (!confirmed) return false
+    }
 
+    setFileTabs((prev) => {
       for (const tab of prev) {
         const closed = snapshotFileTab(tab)
         if (closed) pushClosedTab(closed)
@@ -2261,8 +2266,15 @@ export function WorkspaceProvider({ children }: WorkspaceProviderProps) {
       activateConversationPane()
       return []
     })
+    return true
   }, [activateConversationPane, t])
 
+  useBrowserBackWindow({
+    open: fileTabs.length > 0,
+    onClose: closeAllFileTabs,
+    key: "file-workspace",
+  })
+
   const reorderFileTabs = useCallback((tabs: FileWorkspaceTab[]) => {
     setFileTabs(tabs)
   }, [])