@jetcrab/pi-desk 1.1.28-dev → 1.1.30-dev

package/docs/plugins.md

@@ -180,10 +180,10 @@ plugin.registerSessionHeaderItem('session-info', {
 ```
 
 - `action` 只接受固定 `icon`、`label`、`onSelect({ source, host, signal })`，不提供动态图标、文字或状态订阅。宿主显示图标加文字，异步操作期间防止重复点击；失败记录局部错误，失效后的回调不得继续使用旧 Host。信号属于该展示生命周期，不会回滚服务端已经产生的副作用。
-- `custom` 只提供 `load()`，宿主不包装点击回调。inline custom 必须额外声明正数 `minWidthRem`，单位为 `rem`；宿主按此预留可用宽度，不通过重复挂载业务视图测量。自定义内容应适应获得的容器，不能靠超宽 DOM 挤占标题。overflow custom 不声明宽度。
+- `custom` 只提供 `load()`，宿主不包装点击回调。inline custom 必须额外声明正数 `minWidthRem`，单位为 `rem`；有内容时才按此分配宽度。加载中和空内容不占宽度或间距，宿主只观察当前真实挂载，不复制业务视图测量。自定义内容应适应获得的容器，不能靠超宽 DOM 挤占标题。overflow custom 不声明宽度，加载中和空内容也不预留空行。
 - 自定义 Target 为 `{ kind: 'session-header-item', source, presentation: 'inline' | 'overflow' }`。两种表现可以使用不同模块，也可以复用同一个 `{ mount }`；loader 分别按表现缓存和重试。可复用上面的 `session-info.js`，或使用公共 React/UI 构建交互视图。
 - 标题项按插件名和注册名稳定排列；宽度不足时从末尾收进更多，宿主保留标题及必要操作。普通按钮选择后关闭更多；自定义区域内点击不会被转发，也不会自动关闭更多。Escape 或外部点击关闭浮层，键盘与触控均可操作。
-- 收纳会卸载 inline 自定义视图；只有更多打开时才挂载 overflow 自定义视图，关闭后释放。动态状态与运行/停止等复杂交互由自定义视图自行实现；业务状态归插件运行态，不归 mount，也不能只存于会被卸载的组件局部状态。卸载只清理视图资源，不停止项目进程。
+- inline 自定义视图先静默挂载，内容出现后参与宽度计算；收纳会卸载该视图。只有更多打开时才挂载 overflow 自定义视图，关闭后释放。动态状态与运行/停止等复杂交互由自定义视图自行实现；业务状态归插件运行态，不归 mount，也不能只存于会被卸载的组件局部状态。卸载只清理视图资源，不停止项目进程。
 
 两种注册均限定 Browser Entry 同步阶段，名称规则与其他贡献相同。它们需要支持对应方法的宿主和 SDK；旧宿主缺少能力时禁用这项入口，不使用 `registerContribution` 别名或访问宿主 DOM 代替。现有 `composer-panel` 仍是人工打开的会话弹窗，不是上下方挂件。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetcrab/pi-desk",
-  "version": "1.1.28-dev",
+  "version": "1.1.30-dev",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/src/app/api/work-sessions/search/route.ts

@@ -0,0 +1 @@
+export { POST } from '@server/l1_entry/api/l1-work-session-search-route'

package/src/app/project-preview/page.tsx

@@ -2,7 +2,6 @@ import { Suspense } from 'react'
 import type { Metadata } from 'next'
 import { L1ProjectPreviewPage } from '@client/l1_entry/pages/l1-project-preview-page'
 import { buildL2ProjectPreviewTitle } from '@common/l2_biz/project-preview/l2-project-preview-navigation'
-import { getL4HostSettingsStore } from '@server/l4_foundation/l4-host-settings-store'
 
 export async function generateMetadata({
   searchParams
@@ -10,8 +9,7 @@ export async function generateMetadata({
   searchParams: Promise<{ cwd?: string | string[] }>
 }): Promise<Metadata> {
   const { cwd } = await searchParams
-  const { region } = getL4HostSettingsStore().getSnapshot()
-  return { title: buildL2ProjectPreviewTitle(Array.isArray(cwd) ? cwd[0] : cwd, region.locale) }
+  return { title: buildL2ProjectPreviewTitle(Array.isArray(cwd) ? cwd[0] : cwd) }
 }
 
 export default function ProjectPreview(): React.JSX.Element {

package/src/client/l1_entry/pages/l1-error-page.tsx

@@ -13,7 +13,7 @@ export function L1ErrorPage({
 }): React.JSX.Element {
   const { t } = useTranslation('common')
   return (
-    <main className="flex min-h-dvh items-center justify-center bg-background p-4 text-foreground">
+    <main className="flex min-h-[var(--pi-desk-content-height)] items-center justify-center bg-background p-4 text-foreground">
       <div className="w-full max-w-md space-y-4 text-center">
         <h1 className="text-xl font-semibold">{t(notFound ? 'notFound' : 'pageError')}</h1>
         <div className="flex flex-wrap items-center justify-center gap-2">

package/src/client/l1_entry/providers/l1-app-providers.tsx

@@ -24,6 +24,7 @@ import { L4AppToastProvider } from '@client/l4_foundation/ui/l4-app-toast'
 import { TooltipProvider } from '@client/l4_foundation/ui/shadcn/tooltip'
 import { createL4BrowserUuid } from '@client/l4_foundation/lib/l4-browser-uuid'
 import { L4ClientIdContext } from '@client/l4_foundation/lib/l4-client-id'
+import { L4DesktopTitlebar } from '@client/l4_foundation/desktop-window/l4-desktop-titlebar'
 
 const resources = {
   en: {
@@ -76,6 +77,7 @@ export function L1AppProviders({
           <L4CodePreferencesProvider>
             <L4RegionProvider resources={resources} initialSettings={initialSettings}>
               <L4AppToastProvider>
+                <L4DesktopTitlebar />
                 <L4RegionNotice />
                 <TooltipProvider>{children}</TooltipProvider>
               </L4AppToastProvider>

package/src/client/l2_biz/auth/l2-login.module.css

@@ -1,7 +1,7 @@
 .page {
   display: grid;
   grid-template-rows: auto 1fr;
-  min-height: 100dvh;
+  min-height: var(--pi-desk-content-height, 100dvh);
   padding: max(24px, env(safe-area-inset-top)) max(24px, env(safe-area-inset-right))
     max(24px, env(safe-area-inset-bottom)) max(24px, env(safe-area-inset-left));
   background: var(--background);

package/src/client/l2_biz/plugin-host/l2-plugin-composer-panel.tsx

@@ -35,7 +35,7 @@ export function L2PluginComposerPanel({
     <L4AppDialogRoot open onOpenChange={(open) => !open && onClose()}>
       <L4AppDialogContent
         finalFocus={false}
-        className="h-[min(720px,calc(100dvh-2rem))] max-w-4xl max-sm:h-dvh max-sm:max-h-dvh max-sm:w-full max-sm:max-w-none max-sm:rounded-none max-sm:border-0"
+        className="h-[min(720px,calc(100dvh-2rem))] max-w-4xl max-sm:h-[var(--pi-desk-content-height)] max-sm:max-h-[var(--pi-desk-content-height)] max-sm:w-full max-sm:max-w-none max-sm:rounded-none max-sm:border-0"
       >
         <L4AppDialogHeader className="border-b px-4 py-3 pr-12">
           <div className="flex min-w-0 items-center gap-3">

package/src/client/l2_biz/plugin-host/l2-plugin-contribution-host.tsx

@@ -237,7 +237,7 @@ export function L2PluginContributionHost({
           state.status === 'error' && 'hidden'
         )}
       />
-      {state.status === 'loading' ? (
+      {state.status === 'loading' && kind !== 'widget' && kind !== 'session-header-item' ? (
         <div
           role="status"
           className={cn(

package/src/client/l2_biz/plugin-host/l2-plugin-session-header-layout.ts

@@ -4,14 +4,17 @@ export function calculateL2PluginSessionHeaderInlineCount(
   moreWidth: number,
   gap: number
 ): number {
-  const total = widths.reduce((sum, width) => sum + width, 0) + Math.max(0, widths.length - 1) * gap
+  const occupiedCount = widths.filter((width) => width > 0).length
+  const total = widths.reduce((sum, width) => sum + width, 0) + Math.max(0, occupiedCount - 1) * gap
   if (total <= availableWidth) return widths.length
 
   let used = moreWidth
   let count = 0
   for (const width of widths) {
-    if (used + gap + width > availableWidth) break
-    used += gap + width
+    if (width > 0) {
+      if (used + gap + width > availableWidth) break
+      used += gap + width
+    }
     count += 1
   }
   return count

package/src/client/l2_biz/plugin-host/l2-plugin-session-header.tsx

@@ -1,7 +1,7 @@
 'use client'
 
 import { EllipsisIcon } from 'lucide-react'
-import { useLayoutEffect, useMemo, useRef, useState, type ReactNode } from 'react'
+import { useCallback, useLayoutEffect, useMemo, useRef, useState, type ReactNode } from 'react'
 import { useTranslation } from 'react-i18next'
 import type { BrowserSessionHeaderItemTarget, PluginSource } from '@jetcrab/pi-desk-sdk/browser'
 import { useL4PluginRegistry } from '@client/l4_foundation/plugin-host/l4-plugin-host-context'
@@ -14,6 +14,7 @@ import {
   PopoverTitle,
   PopoverTrigger
 } from '@client/l4_foundation/ui/shadcn/popover'
+import { cn } from '@client/l4_foundation/lib/l4-utils'
 import { L2PluginContributionHost } from './l2-plugin-contribution-host'
 import { calculateL2PluginSessionHeaderInlineCount } from './l2-plugin-session-header-layout'
 import { L2PluginSessionHeaderAction } from './views/l2-plugin-session-header-action'
@@ -36,12 +37,14 @@ function HeaderItemView({
   item,
   source,
   presentation,
-  onSelected
+  onSelected,
+  onContentChange
 }: {
   item: HeaderItem
   source: PluginSource
   presentation: 'inline' | 'overflow'
   onSelected?: () => void
+  onContentChange?: (item: HeaderItem, hasContent: boolean) => void
 }): React.JSX.Element {
   const definition = item.descriptor[presentation]
   const target = useMemo<BrowserSessionHeaderItemTarget>(
@@ -49,6 +52,22 @@ function HeaderItemView({
     [presentation, source]
   )
   const sourceKey = JSON.stringify([source.workId, source.sessionId, source.branchId, presentation])
+  const contentRef = useRef<HTMLDivElement>(null)
+  const [hasContent, setHasContent] = useState(false)
+
+  useLayoutEffect(() => {
+    const content = contentRef.current
+    if (!content) return
+    const measure = (): void => {
+      const visible = content.getBoundingClientRect().height > 0
+      setHasContent(visible)
+      onContentChange?.(item, visible)
+    }
+    const observer = new ResizeObserver(measure)
+    observer.observe(content)
+    return () => observer.disconnect()
+  }, [item, onContentChange, sourceKey])
+
   if (definition.type === 'action') {
     return (
       <L2PluginSessionHeaderAction
@@ -68,21 +87,29 @@ function HeaderItemView({
       data-plugin-name={item.pluginName}
       data-contribution-name={item.descriptor.contributionName}
       data-presentation={presentation}
-      className="min-w-0 shrink-0"
+      className={cn(
+        'min-w-0 shrink-0',
+        presentation === 'overflow' && 'w-full',
+        !hasContent && 'pointer-events-none invisible absolute'
+      )}
+      aria-hidden={!hasContent}
+      inert={!hasContent}
       style={
         presentation === 'inline' && item.descriptor.inline.type === 'custom'
           ? { width: `${item.descriptor.inline.minWidthRem}rem` }
           : undefined
       }
     >
-      <L2PluginContributionHost
-        pluginName={item.pluginName}
-        kind="session-header-item"
-        contributionName={item.descriptor.contributionName}
-        target={target}
-        targetKey={sourceKey}
-        layout="inline"
-      />
+      <div ref={contentRef}>
+        <L2PluginContributionHost
+          pluginName={item.pluginName}
+          kind="session-header-item"
+          contributionName={item.descriptor.contributionName}
+          target={target}
+          targetKey={sourceKey}
+          layout="inline"
+        />
+      </div>
     </div>
   )
 }
@@ -106,16 +133,31 @@ export function L2PluginSessionHeader({
   )
   const rootRef = useRef<HTMLDivElement>(null)
   const measurementsRef = useRef<HTMLDivElement>(null)
+  const customContentRef = useRef(new Map<HeaderItem, boolean>())
+  const measureRef = useRef<(() => void) | null>(null)
+  const onContentChange = useCallback((item: HeaderItem, hasContent: boolean): void => {
+    if (customContentRef.current.get(item) === hasContent) return
+    customContentRef.current.set(item, hasContent)
+    measureRef.current?.()
+  }, [])
   const [measurement, setMeasurement] = useState<{
     items: readonly HeaderItem[]
     count: number
+    occupied: boolean
   } | null>(null)
   const [open, setOpen] = useState(false)
-  const count = measurement?.items === items ? measurement.count : 0
+  const count = measurement?.items === items ? measurement.count : items.length
+  const occupied =
+    measurement?.items === items
+      ? measurement.occupied
+      : items.some((item) => item.descriptor.inline.type === 'action')
   const inlineItems = items.slice(0, count)
   const overflowItems = items.slice(count)
 
   useLayoutEffect(() => {
+    for (const item of customContentRef.current.keys()) {
+      if (!items.includes(item)) customContentRef.current.delete(item)
+    }
     const root = rootRef.current
     const measurements = measurementsRef.current
     if (!root || !measurements || items.length === 0) return
@@ -127,42 +169,57 @@ export function L2PluginSessionHeader({
       const gap = gapProbe.getBoundingClientRect().width
       const available =
         root.getBoundingClientRect().width - titleProbe.getBoundingClientRect().width - gap
+      const widths = probes.map((probe, index) =>
+        items[index].descriptor.inline.type === 'custom' &&
+        !customContentRef.current.get(items[index])
+          ? 0
+          : probe.getBoundingClientRect().width
+      )
       const nextCount = calculateL2PluginSessionHeaderInlineCount(
-        probes.map((probe) => probe.getBoundingClientRect().width),
+        widths,
         available,
         moreProbe.getBoundingClientRect().width,
         gap
       )
+      const nextOccupied = widths.some((width) => width > 0)
       if (nextCount === items.length) setOpen(false)
       setMeasurement((current) =>
-        current?.items === items && current.count === nextCount
+        current?.items === items && current.count === nextCount && current.occupied === nextOccupied
           ? current
-          : { items, count: nextCount }
+          : { items, count: nextCount, occupied: nextOccupied }
       )
     }
+    measureRef.current = measure
     const observer = new ResizeObserver(measure)
     observer.observe(root)
     for (const probe of [...probes, titleProbe, moreProbe, gapProbe]) observer.observe(probe)
     measure()
-    return () => observer.disconnect()
+    return () => {
+      measureRef.current = null
+      observer.disconnect()
+    }
   }, [items])
 
   return (
     <div
       ref={rootRef}
-      className="relative flex min-w-0 flex-1 items-center gap-1"
+      className="relative flex min-w-0 flex-1 items-center"
       data-testid="plugin-session-header"
     >
       <div className="min-w-[3rem] flex-1">{title}</div>
       {items.length > 0 ? (
         <>
-          <div className="flex shrink-0 items-center gap-1" data-testid="session-header-items">
+          <div
+            className={cn('flex shrink-0 items-center gap-1', occupied && 'ml-1')}
+            data-testid="session-header-items"
+          >
             {inlineItems.map((item) => (
               <HeaderItemView
                 key={itemKey(item)}
                 item={item}
                 source={source}
                 presentation="inline"
+                onContentChange={onContentChange}
               />
             ))}
             {overflowItems.length > 0 ? (

package/src/client/l2_biz/project-preview/hooks/l2-use-project-preview.ts

@@ -45,7 +45,6 @@ interface PreviewState extends Pick<L2ProjectPreviewOwner, 'files' | 'git' | 'hi
 export function useL2ProjectPreview(
   clientId: string,
   cwd: string,
-  refreshOnFocus: boolean,
   onUnauthorized?: () => void
 ): PreviewState {
   const toast = useL4AppToast()
@@ -63,7 +62,7 @@ export function useL2ProjectPreview(
       (text) => toast.show({ level: 'info', title: text }),
       saved,
       initialGlobal,
-      { lazyHistory: !refreshOnFocus, onUnauthorized }
+      { lazyHistory: true, onUnauthorized }
     )
   )
   const { files, git, history } = owner
@@ -155,18 +154,6 @@ export function useL2ProjectPreview(
     }
   }, [cwd, files, git, owner])
 
-  useEffect(() => {
-    if (!refreshOnFocus) return
-    let lastFocus = Date.now()
-    const focus = (): void => {
-      if (Date.now() - lastFocus < 5000) return
-      lastFocus = Date.now()
-      void git.refreshSnapshot(cwd)
-    }
-    window.addEventListener('focus', focus)
-    return () => window.removeEventListener('focus', focus)
-  }, [cwd, git, refreshOnFocus])
-
   useEffect(() => {
     if (!container) return
     const measure = (): void =>

package/src/client/l2_biz/project-preview/l2-project-preview-dialog.tsx

@@ -41,8 +41,8 @@ export function L2ProjectPreviewDialog({
         data-testid="project-preview-dialog"
         className={cn(
           'h-[min(94dvh,1080px)] w-[min(96dvw,1600px)] max-w-none gap-0 p-0',
-          maximized && 'h-dvh max-h-none w-dvw rounded-none',
-          'max-sm:h-dvh max-sm:max-h-none max-sm:w-dvw max-sm:rounded-none'
+          maximized && 'h-[var(--pi-desk-content-height)] max-h-none w-dvw rounded-none',
+          'max-sm:h-[var(--pi-desk-content-height)] max-sm:max-h-none max-sm:w-dvw max-sm:rounded-none'
         )}
       >
         <L4AppDialogDescription className="sr-only">
@@ -51,7 +51,6 @@ export function L2ProjectPreviewDialog({
         <L2ProjectPreview
           clientId={clientId}
           cwd={cwd}
-          refreshOnFocus
           onEscape={onClose}
           title={
             <L4AppDialogTitle className="truncate text-sm" title={cwd}>

package/src/client/l2_biz/project-preview/l2-project-preview-page.tsx

@@ -34,7 +34,7 @@ export function L2ProjectPreviewPage({
   const { t } = useTranslation('projectHistory')
   return (
     <main
-      className="flex h-dvh min-w-0 flex-col overflow-hidden bg-background text-foreground"
+      className="flex h-[var(--pi-desk-content-height)] min-w-0 flex-col overflow-hidden bg-background text-foreground"
       data-testid="project-preview-page"
     >
       {cwd ? (
@@ -42,7 +42,6 @@ export function L2ProjectPreviewPage({
           key={cwd}
           clientId={clientId}
           cwd={cwd}
-          refreshOnFocus={false}
           onUnauthorized={onUnauthorized}
           actions={
             <Button size="sm" variant="ghost" onClick={() => onSelect(null)}>

package/src/client/l2_biz/project-preview/l2-project-preview.tsx

@@ -33,7 +33,6 @@ const ignoreEscape = (): void => {}
 export function L2ProjectPreview({
   clientId,
   cwd,
-  refreshOnFocus,
   title,
   actions,
   onEscape = ignoreEscape,
@@ -41,7 +40,6 @@ export function L2ProjectPreview({
 }: {
   clientId: string
   cwd: string
-  refreshOnFocus: boolean
   title?: ReactNode
   actions?: ReactNode
   onEscape?: () => void
@@ -66,7 +64,7 @@ export function L2ProjectPreview({
     changeRowHeight,
     openGit,
     refresh
-  } = useL2ProjectPreview(clientId, cwd, refreshOnFocus, onUnauthorized)
+  } = useL2ProjectPreview(clientId, cwd, onUnauthorized)
   const { directoryOpen, gitOpen, gitMaximized } = global
   const projectName = cwd.replaceAll('\\', '/').split('/').filter(Boolean).at(-1) ?? cwd
   const gitState = git.getWorkspace(cwd)!
@@ -88,7 +86,6 @@ export function L2ProjectPreview({
       runtime={files}
       gitRuntime={git}
       compact={width < 1100}
-      refreshOnFocus={refreshOnFocus}
       onEscape={onEscape}
       renderHeader={(actions) => (
         <L3ProjectFileTabs

package/src/client/l2_biz/project-preview/views/l2-project-branch-select.tsx

@@ -2,7 +2,16 @@
 
 import { useId, useMemo, useRef, useState, type KeyboardEvent } from 'react'
 import { useTranslation } from 'react-i18next'
-import { CheckIcon, ChevronDownIcon, ChevronRightIcon, ChevronsUpDownIcon } from 'lucide-react'
+import {
+  CheckIcon,
+  ChevronDownIcon,
+  ChevronRightIcon,
+  ChevronsUpDownIcon,
+  FolderIcon,
+  FolderOpenIcon,
+  GitBranchIcon,
+  GitCommitHorizontalIcon
+} from 'lucide-react'
 import type { L4GitReadBranches } from '@common/l4_foundation/git/l4-git-history-contract'
 import {
   buildL3GitBranchTree,
@@ -239,8 +248,26 @@ export function L2ProjectBranchSelect({
               className
             )}
           >
-            <span className={cn('min-w-0 truncate', !value && 'text-muted-foreground')}>
-              {selectedLabel || placeholder || common('selectPlaceholder')}
+            <span
+              className={cn(
+                'flex min-w-0 flex-1 items-center gap-2',
+                !value && 'text-muted-foreground'
+              )}
+            >
+              {value === 'HEAD' ? (
+                <GitCommitHorizontalIcon
+                  aria-hidden="true"
+                  className="size-4 shrink-0 text-muted-foreground"
+                />
+              ) : (
+                <GitBranchIcon
+                  aria-hidden="true"
+                  className="size-4 shrink-0 text-muted-foreground"
+                />
+              )}
+              <span className="min-w-0 truncate">
+                {selectedLabel || placeholder || common('selectPlaceholder')}
+              </span>
             </span>
             <ChevronsUpDownIcon className="text-muted-foreground" />
           </Button>
@@ -282,6 +309,15 @@ export function L2ProjectBranchSelect({
           {rows.map((row) => {
             const selected = !row.expandable && row.key === value
             const expandedRow = row.expandable ? expanded.has(row.key) : undefined
+            const RowIcon = row.expandable
+              ? row.level === 1
+                ? null
+                : expandedRow
+                  ? FolderOpenIcon
+                  : FolderIcon
+              : row.key === 'HEAD'
+                ? GitCommitHorizontalIcon
+                : GitBranchIcon
             return (
               <button
                 key={row.key}
@@ -325,6 +361,9 @@ export function L2ProjectBranchSelect({
                 ) : (
                   <span aria-hidden="true" className="size-3.5 shrink-0" />
                 )}
+                {RowIcon ? (
+                  <RowIcon aria-hidden="true" className="size-4 shrink-0 text-muted-foreground" />
+                ) : null}
                 <span className="min-w-0 flex-1 break-all">{row.label}</span>
                 {selected ? <CheckIcon aria-hidden="true" className="size-3.5 shrink-0" /> : null}
               </button>

package/src/client/l2_biz/settings/l2-settings.tsx

@@ -281,7 +281,7 @@ export function L2Settings({
       }}
     >
       <L4AppDialogContent
-        className="h-[min(48rem,calc(100dvh-2rem))] max-w-6xl max-sm:h-dvh max-sm:max-h-dvh max-sm:w-dvw max-sm:max-w-none max-sm:rounded-none max-sm:border-0"
+        className="h-[min(48rem,calc(100dvh-2rem))] max-w-6xl max-sm:h-[var(--pi-desk-content-height)] max-sm:max-h-[var(--pi-desk-content-height)] max-sm:w-dvw max-sm:max-w-none max-sm:rounded-none max-sm:border-0"
         finalFocus={false}
         showCloseButton={!guardPending}
       >

package/src/client/l2_biz/settings/l2-skills-settings.tsx

@@ -209,7 +209,7 @@ export function L2SkillsSettings({
       </div>
       <L4AppDialogRoot open={drawerOpen} onOpenChange={setDrawerOpen}>
         <L4AppDialogContent
-          className="left-0 top-0 z-[130] h-dvh max-h-dvh w-[min(360px,calc(100dvw-2rem))] max-w-none translate-x-0 translate-y-0 rounded-l-none"
+          className="left-0 top-[var(--pi-desk-window-inset)] z-[130] h-[var(--pi-desk-content-height)] max-h-[var(--pi-desk-content-height)] w-[min(360px,calc(100dvw-2rem))] max-w-none translate-x-0 translate-y-0 rounded-l-none"
           finalFocus={false}
         >
           <L4AppDialogHeader className="shrink-0 border-b px-4 py-3 pr-12">

package/src/client/l2_biz/task-center/l2-task-center.tsx

@@ -468,7 +468,7 @@ function TaskCenterPanel({
       <L4AppDialogContent
         aria-label={t('title')}
         showCloseButton={false}
-        className="h-[calc(100dvh-2rem)] max-w-[70rem] flex-row bg-background max-lg:h-dvh max-lg:max-h-dvh max-lg:w-dvw max-lg:max-w-none max-lg:rounded-none max-lg:border-0"
+        className="h-[calc(100dvh-2rem)] max-w-[70rem] flex-row bg-background max-lg:h-[var(--pi-desk-content-height)] max-lg:max-h-[var(--pi-desk-content-height)] max-lg:w-dvw max-lg:max-w-none max-lg:rounded-none max-lg:border-0"
       >
         <div
           className={cn(

package/src/client/l2_biz/workbench/file-workspace/l2-plugin-standalone-file-preview.tsx

@@ -152,7 +152,7 @@ export function L2PluginStandaloneFilePreview({
       <L4AppDialogContent
         className={
           mobile
-            ? 'inset-0 h-dvh max-h-none w-dvw max-w-none translate-x-0 translate-y-0 rounded-none border-0 ring-0'
+            ? 'inset-x-0 top-[var(--pi-desk-window-inset)] bottom-0 h-[var(--pi-desk-content-height)] max-h-none w-dvw max-w-none translate-x-0 translate-y-0 rounded-none border-0 ring-0'
             : 'h-[min(94dvh,1080px)] w-[min(96dvw,1600px)] max-w-none'
         }
       >

package/src/client/l2_biz/workbench/file-workspace/l2-work-session-file-preview.tsx

@@ -75,7 +75,7 @@ export function L2WorkSessionFilePreview({
         }}
         className={
           mobile
-            ? 'inset-0 h-dvh max-h-none w-dvw max-w-none translate-x-0 translate-y-0 rounded-none border-0 ring-0'
+            ? 'inset-x-0 top-[var(--pi-desk-window-inset)] bottom-0 h-[var(--pi-desk-content-height)] max-h-none w-dvw max-w-none translate-x-0 translate-y-0 rounded-none border-0 ring-0'
             : 'h-[min(94dvh,1080px)] w-[min(96dvw,1600px)] max-w-none'
         }
         finalFocus={() => {

package/src/client/l2_biz/workbench/git-workspace/l2-git-workspace-runtime.ts

@@ -147,11 +147,11 @@ export class L2GitWorkspaceRuntime {
     if (workspace.snapshot.status === 'ready' || workspace.snapshot.status === 'loading') {
       return Promise.resolve()
     }
-    return this.loadSnapshot(cwd, false)
+    return this.loadSnapshot(cwd)
   }
 
   refreshSnapshot(cwd: string): Promise<void> {
-    return this.loadSnapshot(cwd, true)
+    return this.loadSnapshot(cwd)
   }
 
   async refreshHeads(cwd: string): Promise<void> {
@@ -332,9 +332,9 @@ export class L2GitWorkspaceRuntime {
     this.listeners.clear()
   }
 
-  private async loadSnapshot(cwd: string, force: boolean): Promise<void> {
+  private async loadSnapshot(cwd: string): Promise<void> {
     const workspace = this.workspaceFor(cwd)
-    if (workspace.snapshotRequest && !force) return
+    if (workspace.snapshotRequest) return
     const project = this.projectRefs.get(cwd)
     if (!project) {
       workspace.snapshot = {
@@ -346,16 +346,17 @@ export class L2GitWorkspaceRuntime {
       return
     }
 
-    workspace.snapshotRequest?.controller.abort()
     const controller = new AbortController()
     const token = {}
     workspace.snapshotRequest = { controller, token }
-    workspace.snapshot = {
-      status: 'loading',
-      repositories: workspace.snapshot.repositories,
-      error: null
+    if (workspace.snapshot.status !== 'ready') {
+      workspace.snapshot = {
+        status: 'loading',
+        repositories: workspace.snapshot.repositories,
+        error: null
+      }
+      this.publish()
     }
-    this.publish()
 
     try {
       const result = await this.biz.get({ workId: project.workId, cwd }, controller.signal)

package/src/client/l2_biz/workbench/hooks/l2-work-session-search.ts

@@ -0,0 +1,52 @@
+'use client'
+
+import { useCallback, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+import type { L2WorkSessionListItem } from '@common/l2_biz/work-session/l2-work-session-contract'
+import type { L2WorkSessionSearchResponse } from '@common/l2_biz/work-session/l2-work-session-search-contract'
+import type {
+  L3PiSessionSearchQuery,
+  L3PiSessionSearchScope
+} from '@common/l3_modules/pi/l3-pi-session-search-contract'
+import type { L2WorkbenchBiz } from '../l2-workbench-biz'
+import {
+  L2_WORKBENCH_DEFAULT_SEARCH_IN,
+  useL2WorkbenchSessionSearch,
+  type L2WorkbenchSessionSearchResult
+} from './l2-workbench-session-search'
+
+export interface L2WorkSessionSearch extends L2WorkbenchSessionSearchResult<L2WorkSessionSearchResponse> {
+  query: string
+  searchIn: readonly L3PiSessionSearchScope[]
+  setQuery: (query: string) => void
+  setSearchIn: (searchIn: readonly L3PiSessionSearchScope[]) => void
+}
+
+export function useL2WorkSessionSearch({
+  active,
+  workSessions,
+  searchWorkSessions
+}: {
+  active: boolean
+  workSessions: readonly L2WorkSessionListItem[]
+  searchWorkSessions: L2WorkbenchBiz['searchWorkSessions']
+}): L2WorkSessionSearch {
+  const { t } = useTranslation('workbench')
+  const [query, setQuery] = useState('')
+  const [searchIn, setSearchIn] = useState<readonly L3PiSessionSearchScope[]>(
+    L2_WORKBENCH_DEFAULT_SEARCH_IN
+  )
+  const request = useCallback(
+    (input: L3PiSessionSearchQuery, signal: AbortSignal) => searchWorkSessions(input, signal),
+    [searchWorkSessions]
+  )
+  const search = useL2WorkbenchSessionSearch({
+    active: active && query.trim().length > 0,
+    scope: workSessions,
+    query,
+    searchIn,
+    request,
+    failureMessage: t('sessionSearchFailed')
+  })
+  return { ...search, query, searchIn, setQuery, setSearchIn }
+}