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

package/src/client/l3_modules/project-files/l3-project-file-runtime.ts

@@ -50,7 +50,13 @@ export type L3FileDocument =
       previewScrollTop: number
       comparison?: L3FileComparison
     }
-  | { status: 'image'; mimeType: L4ProjectFileImageMimeType; size: number; objectUrl: string }
+  | {
+      status: 'image'
+      mimeType: L4ProjectFileImageMimeType
+      size: number
+      objectUrl: string
+      blob: Blob
+    }
   | { status: 'error'; error: string }
 export interface L3FileSearch extends L4ProjectSearchInput, L4ProjectFileSearch {
   status: 'idle' | 'loading' | 'ready' | 'error'
@@ -157,6 +163,13 @@ function normalizePath(cwd: string, path: string): string {
   return inside ? normalized.slice(prefix.length) : normalized
 }
 
+async function sameImage(left: Blob, right: Blob): Promise<boolean> {
+  if (left.type !== right.type || left.size !== right.size) return false
+  const [before, after] = await Promise.all([left.arrayBuffer(), right.arrayBuffer()])
+  const bytes = new Uint8Array(after)
+  return new Uint8Array(before).every((value, index) => value === bytes[index])
+}
+
 // 单个目录阅读实例；会话身份、窗口和聊天布局由调用方拥有。
 export class L3ProjectFileRuntime {
   readonly state: L3ProjectFileState = {
@@ -286,9 +299,9 @@ export class L3ProjectFileRuntime {
   ensureRoot(): Promise<void> {
     return this.ensureDirectory('')
   }
-  ensureDirectory(path: string): Promise<void> {
-    if (this.disposed || this.state.directories.get(path)?.status === 'ready')
-      return Promise.resolve()
+  ensureDirectory(path: string, refresh = false): Promise<void> {
+    const current = this.state.directories.get(path)
+    if (this.disposed || (!refresh && current?.status === 'ready')) return Promise.resolve()
     const existing = this.directoryRequests.get(path)
     if (existing) return existing.promise
     const controller = new AbortController()
@@ -307,10 +320,15 @@ export class L3ProjectFileRuntime {
       this.publish()
     })
     this.directoryRequests.set(path, { controller, promise })
-    this.state.directories.set(path, { status: 'loading' })
-    this.publish()
+    if (current?.status !== 'ready') {
+      this.state.directories.set(path, { status: 'loading' })
+      this.publish()
+    }
     return promise
   }
+  refreshDirectories(paths: Iterable<string>): void {
+    for (const path of new Set(paths)) void this.ensureDirectory(path, true)
+  }
   setExpandedPaths(paths: Set<string>, load = true): void {
     const closed = [...this.state.expandedPaths].filter((path) => !paths.has(path))
     this.state.expandedPaths = new Set(paths)
@@ -319,7 +337,7 @@ export class L3ProjectFileRuntime {
         this.compactRequests.delete(path)
     }
     this.publish()
-    if (load) for (const path of paths) void this.ensureDirectory(path)
+    if (load) for (const path of paths) void this.ensureDirectory(path, true)
   }
   cancelDirectoryExpansion(root = ''): void {
     for (const path of this.compactRequests.keys()) {
@@ -553,20 +571,25 @@ export class L3ProjectFileRuntime {
     if (!refresh && current && ['loading', 'text', 'image'].includes(current.status)) return
     const request = new AbortController()
     this.documentRequests.set(path, request)
-    // 搜索定位刷新正文时保留已挂载的代码视图，内容未变时不重建编辑器。
-    if (current?.status !== 'text') this.state.documents.set(path, { status: 'loading' })
-    this.publish()
+    // 自动重读保留已挂载的视图，文本或图片未变时不重建阅读实例。
+    if (current?.status !== 'text' && current?.status !== 'image') {
+      this.state.documents.set(path, { status: 'loading' })
+      this.publish()
+    }
     try {
       const result = await this.reader.get(path, this.options.imagePreviewMode(), request.signal)
       if (this.documentRequests.get(path) !== request) return
+      const blob = result.kind === 'image' ? createL4Base64ImageBlob(result) : null
+      const unchanged =
+        (current?.status === 'text' &&
+          result.kind === 'text' &&
+          current.content === result.content &&
+          current.size === result.size) ||
+        (current?.status === 'image' && blob !== null && (await sameImage(current.blob, blob)))
+      if (this.documentRequests.get(path) !== request) return
       this.documentRequests.delete(path)
       this.closeMissing.delete(path)
       this.restoredTabs.delete(path)
-      const unchanged =
-        current?.status === 'text' &&
-        result.kind === 'text' &&
-        current.content === result.content &&
-        current.size === result.size
       if (!unchanged)
         this.state.documents.set(
           path,
@@ -598,11 +621,12 @@ export class L3ProjectFileRuntime {
                 status: 'image',
                 mimeType: result.mimeType,
                 size: result.size,
-                objectUrl: URL.createObjectURL(createL4Base64ImageBlob(result))
+                objectUrl: URL.createObjectURL(blob!),
+                blob: blob!
               }
         )
       if (this.state.activePath === path && result.kind !== 'text') this.navigation = null
-      this.releaseDocument(current)
+      if (!unchanged) this.releaseDocument(current)
     } catch (cause) {
       if (this.documentRequests.get(path) !== request) return
       this.documentRequests.delete(path)
@@ -741,6 +765,10 @@ export class L3ProjectFileRuntime {
     this.publish()
     void this.ensureDiff(diff)
   }
+  refreshDiff(): void {
+    const diff = this.state.activeDiff
+    if (diff && !diff.comparison) void this.ensureDiff(diff, true)
+  }
   saveDiffState(expected: L3FileDiff, state: L4CodeDiffState | null): void {
     // 卸载回调仍属于原标签；尚未创建编辑器时的空状态不能抹掉已有位置。
     if (this.disposed || !this.state.diffs.includes(expected) || !state) return
@@ -805,13 +833,16 @@ export class L3ProjectFileRuntime {
     this.restoredPreviewScrollTops.clear()
     this.listeners.clear()
   }
-  private async ensureDiff(diff: L3FileDiff): Promise<void> {
+  private async ensureDiff(diff: L3FileDiff, refresh = false): Promise<void> {
     const key = getL3FileDiffKey(diff)
-    if (this.disposed || diff.status !== 'unloaded' || this.diffRequests.has(key)) return
+    if (this.disposed || (!refresh && diff.status !== 'unloaded') || this.diffRequests.has(key))
+      return
     const request = new AbortController()
     this.diffRequests.set(key, request)
-    Object.assign(diff, { status: 'loading' })
-    this.publish()
+    if (diff.status !== 'text' && diff.status !== 'metadata') {
+      Object.assign(diff, { status: 'loading' })
+      this.publish()
+    }
     try {
       const result = await this.reader.diff(
         diff.repositoryRoot,

package/src/client/l3_modules/project-files/l3-project-file-tabs.tsx

@@ -1,10 +1,11 @@
 'use client'
 
-import { ChevronDownIcon, ChevronUpIcon, FileCode2Icon, XIcon } from 'lucide-react'
-import { useLayoutEffect, useRef, useState, useSyncExternalStore, type ReactNode } from 'react'
+import { XIcon } from 'lucide-react'
+import { useLayoutEffect, useRef, useSyncExternalStore, type ReactNode } from 'react'
 import { useTranslation } from 'react-i18next'
 import { cn } from '@client/l4_foundation/lib/l4-utils'
 import { Button } from '@client/l4_foundation/ui/shadcn/button'
+import { L4FileIcon } from '@client/l4_foundation/ui/file-icons/l4-file-icon'
 import {
   ContextMenu,
   ContextMenuItem,
@@ -44,9 +45,21 @@ const CLOSE_ACTIONS: readonly { scope: L3FileTabCloseScope; label: string }[] =
 
 function fileLabel(path: string, paths: readonly string[]): string {
   const segments = path.replaceAll('\\', '/').split('/')
-  const name = segments.at(-1) ?? path
-  const sameName = paths.some((other) => other !== path && other.split('/').at(-1) === name)
-  return sameName && segments.length > 1 ? segments.slice(-2).join('/') : name
+  const others = paths
+    .map((other) => other.replaceAll('\\', '/'))
+    .filter((other) => other !== segments.join('/'))
+  for (let length = 1; length < segments.length; length++) {
+    const label = segments.slice(-length).join('/')
+    if (!others.some((other) => other.split('/').slice(-length).join('/') === label)) return label
+  }
+  return segments.join('/')
+}
+
+function revealTab(rows: HTMLDivElement, tab: HTMLElement): void {
+  const left = tab.offsetLeft
+  const right = left + tab.offsetWidth
+  if (left < rows.scrollLeft) rows.scrollLeft = left
+  else if (right > rows.scrollLeft + rows.clientWidth) rows.scrollLeft = right - rows.clientWidth
 }
 
 export function L3ProjectFileTabs({
@@ -66,12 +79,6 @@ export function L3ProjectFileTabs({
   const snapshot = gitRuntime.getWorkspace(cwd)?.snapshot
   const rowsRef = useRef<HTMLDivElement>(null)
   const suppressTouchClickRef = useRef(false)
-  const [expanded, setExpanded] = useState(false)
-  const [overflow, setOverflow] = useState(false)
-  const [clippedIndexes, setClippedIndexes] = useState<readonly number[]>([])
-  const merged = actions !== undefined
-  const rowHeight = merged && !mobile ? 32 : 36
-  const maxHeight = (mobile ? 2 : 3) * rowHeight
   const allPaths = [
     ...paths,
     ...diffs.map((diff) => [diff.repositoryRoot, diff.path].filter(Boolean).join('/'))
@@ -121,43 +128,32 @@ export function L3ProjectFileTabs({
     const rows = rowsRef.current
     if (!rows) return
     const inspect = (): void => {
-      const items = Array.from(rows.children).filter(
-        (child): child is HTMLElement => child instanceof HTMLElement
-      )
-      const clipped = items.flatMap((item, index) => (item.offsetTop >= maxHeight ? [index] : []))
-      setClippedIndexes((previous) =>
-        previous.join(',') === clipped.join(',') ? previous : clipped
-      )
-      setOverflow(rows.scrollHeight > maxHeight)
       const selected = rows
         .querySelector<HTMLElement>('[aria-selected="true"]')
         ?.closest<HTMLElement>('[data-file-tab]')
-      if (selected && selected.offsetTop >= maxHeight) setExpanded(true)
+      if (selected) revealTab(rows, selected)
     }
     inspect()
     const observer = new ResizeObserver(inspect)
     observer.observe(rows)
     return () => observer.disconnect()
-  }, [active, diffs, maxHeight, paths])
+  }, [active, diffs, paths])
 
   if (tabs.length === 0) return null
   return (
     <div
-      className={cn('shrink-0 bg-muted', merged ? 'flex flex-wrap items-start' : 'border-b')}
+      className="flex min-w-0 max-w-full shrink-0 flex-col border-b bg-muted"
       data-testid="file-tabs"
     >
-      <div
-        className={cn('overflow-hidden', merged && 'min-w-0 flex-[1_1_12rem]')}
-        style={{ maxHeight: expanded ? undefined : maxHeight }}
-      >
+      <div className="min-w-0 max-w-full">
         <div
           ref={rowsRef}
           role="tablist"
           aria-label={t('openFiles')}
-          className="relative flex flex-wrap content-start items-start"
+          aria-orientation="horizontal"
+          className="relative flex min-w-0 flex-nowrap items-stretch overflow-x-auto overflow-y-hidden overscroll-x-contain [scrollbar-color:var(--border)_transparent] [scrollbar-width:thin]"
         >
           {tabs.map((tab, index) => {
-            const clipped = !expanded && clippedIndexes.includes(index)
             const selected = tab.key === active
             const isDiff = typeof tab.target !== 'string'
             const change =
@@ -186,23 +182,14 @@ export function L3ProjectFileTabs({
                     <div
                       data-file-tab
                       data-testid={tab.testId}
-                      aria-hidden={clipped || undefined}
-                      inert={clipped || undefined}
                       title={tab.title}
                       className={cn(
-                        'flex max-w-full items-center text-sm',
-                        merged ? (mobile ? 'h-9' : 'h-8') : 'h-9 border-r border-b',
-                        mobile
-                          ? tab.revisions
-                            ? 'w-full'
-                            : 'w-[min(50%,12rem)]'
-                          : tab.revisions
-                            ? 'max-w-80'
-                            : 'max-w-60',
-                        clipped && 'invisible',
+                        'flex shrink-0 items-center border-r text-sm transition-colors',
+                        mobile ? 'h-9' : 'h-8',
+                        tab.revisions ? 'max-w-[min(100%,20rem)]' : 'max-w-[min(100%,15rem)]',
                         selected
-                          ? 'bg-background text-foreground shadow-[inset_0_-2px_0_var(--primary)]'
-                          : 'text-muted-foreground'
+                          ? 'bg-background text-foreground shadow-[inset_0_-2px_0_var(--foreground)]'
+                          : 'text-muted-foreground hover:bg-accent hover:text-accent-foreground'
                       )}
                       onPointerDown={(event) => {
                         if (event.pointerType === 'touch') suppressTouchClickRef.current = false
@@ -215,6 +202,10 @@ export function L3ProjectFileTabs({
                     role="tab"
                     aria-selected={selected}
                     className="flex h-full min-w-0 flex-1 cursor-pointer items-center gap-2 pl-3 pr-1 outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring"
+                    onFocus={(event) => {
+                      const tab = event.currentTarget.closest<HTMLElement>('[data-file-tab]')
+                      if (rowsRef.current && tab) revealTab(rowsRef.current, tab)
+                    }}
                     onClick={() => {
                       if (suppressTouchClickRef.current) {
                         suppressTouchClickRef.current = false
@@ -251,18 +242,17 @@ export function L3ProjectFileTabs({
                       if (!direction) return
                       event.preventDefault()
                       const next = (index + direction + tabs.length) % tabs.length
-                      setExpanded(true)
                       const buttons =
                         rowsRef.current?.querySelectorAll<HTMLButtonElement>('[role="tab"]')
                       buttons?.[next]?.focus({ preventScroll: true })
                     }}
                   >
-                    <FileCode2Icon className="size-3.5 shrink-0" />
+                    <L4FileIcon path={tab.path} className="size-4 shrink-0" />
                     <span className={cn('truncate', change && getL3GitChangeClass(change))}>
                       {tab.label}
                     </span>
                     {tab.revisions ? (
-                      <span className="shrink-0 font-mono text-xs">{tab.revisions}</span>
+                      <span className="max-w-36 truncate font-mono text-xs">{tab.revisions}</span>
                     ) : null}
                     {change ? (
                       <span
@@ -276,6 +266,7 @@ export function L3ProjectFileTabs({
                   <Button
                     variant="ghost"
                     size="icon"
+                    className={cn('shrink-0 rounded-none', mobile && 'size-9')}
                     data-testid={
                       isDiff
                         ? tab.testId.replace('file-diff-tab-', 'file-diff-tab-close-')
@@ -323,30 +314,18 @@ export function L3ProjectFileTabs({
           })}
         </div>
       </div>
-      {merged && actions ? (
+      {actions ? (
         <div
-          className="ml-auto flex min-h-8 max-w-full flex-wrap items-center justify-end gap-1 px-1"
+          className={cn(
+            'flex min-h-9 min-w-0 max-w-full flex-wrap items-center justify-end gap-1 overflow-x-auto border-t bg-background p-1 [&>*]:min-w-0 [&>*]:max-w-full [&>span]:break-all [&>[role=group]]:flex-wrap',
+            mobile && '[&_button]:min-h-9 [&_button]:min-w-9'
+          )}
           role="group"
           aria-label={t('fileActions')}
         >
           {actions}
         </div>
       ) : null}
-      {overflow ? (
-        <Button
-          variant="ghost"
-          className="w-full rounded-none text-muted-foreground"
-          aria-expanded={expanded}
-          onClick={() => setExpanded((value) => !value)}
-        >
-          {expanded ? (
-            <ChevronUpIcon className="size-3.5" />
-          ) : (
-            <ChevronDownIcon className="size-3.5" />
-          )}
-          {expanded ? t('collapseTabs') : t('expandTabs', { count: tabs.length })}
-        </Button>
-      ) : null}
     </div>
   )
 }

package/src/client/l3_modules/project-files/l3-project-git-runtime.ts

@@ -75,12 +75,13 @@ export class L3ProjectGitRuntime implements L3ProjectGitBrowser {
     this.listeners.clear()
   }
   private async load(refresh: boolean): Promise<void> {
-    if (this.disposed) return
-    this.request?.abort()
+    if (this.disposed || this.request) return
     const request = new AbortController()
     this.request = request
-    this.state.snapshot = { ...this.state.snapshot, status: 'loading', error: null }
-    this.publish()
+    if (this.state.snapshot.status !== 'ready') {
+      this.state.snapshot = { ...this.state.snapshot, status: 'loading', error: null }
+      this.publish()
+    }
     try {
       const result = await this.reader.snapshot(request.signal, refresh)
       if (this.request !== request) return

package/src/client/l3_modules/project-files/l3-use-project-refresh.ts

@@ -0,0 +1,36 @@
+'use client'
+
+import { useEffect, type RefObject } from 'react'
+
+// 只在进入可见预览或窗口重新激活时读取；计时器仅合并同一次激活事件。
+export function useL3ProjectRefresh(
+  host: RefObject<HTMLElement | null>,
+  refresh: () => void,
+  active = true
+): void {
+  useEffect(() => {
+    if (!active) return
+    let timer: ReturnType<typeof setTimeout> | undefined
+    const visible = (): boolean =>
+      document.visibilityState === 'visible' &&
+      Boolean(host.current?.getClientRects().length) &&
+      !host.current?.closest('[inert], [aria-hidden="true"]')
+    const run = (): void => {
+      timer = undefined
+      if (visible()) refresh()
+    }
+    const onFocus = (): void => {
+      if (timer !== undefined) clearTimeout(timer)
+      timer = undefined
+      if (visible()) timer = setTimeout(run, 150)
+    }
+    run()
+    window.addEventListener('focus', onFocus)
+    document.addEventListener('visibilitychange', onFocus)
+    return () => {
+      if (timer !== undefined) clearTimeout(timer)
+      window.removeEventListener('focus', onFocus)
+      document.removeEventListener('visibilitychange', onFocus)
+    }
+  }, [active, host, refresh])
+}

package/src/client/l3_modules/project-files/views/l3-project-search-results.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { ChevronRightIcon, FileIcon, LoaderCircleIcon, SearchIcon } from 'lucide-react'
+import { ChevronRightIcon, LoaderCircleIcon, SearchIcon } from 'lucide-react'
 import { useId, useState, type ReactElement, type ReactNode, type Ref } from 'react'
 import { useTranslation } from 'react-i18next'
 import type {
@@ -268,7 +268,7 @@ export function L3ProjectSearchResults({
                               expanded && 'rotate-90'
                             )}
                           />
-                          <FileIcon className="size-3.5 shrink-0 text-muted-foreground" />
+                          <span className="shrink-0">{renderFileIcon(path)}</span>
                           <span className="min-w-0 truncate text-sm">
                             {path.slice(slash + 1)}
                             <span className="ml-1.5 text-xs text-muted-foreground">

package/src/client/l3_modules/project-files/views/l3-project-tree-folder.tsx

@@ -0,0 +1,86 @@
+'use client'
+
+import { ChevronRightIcon, FolderIcon, FolderOpenIcon } from 'lucide-react'
+import type { ComponentPropsWithRef } from 'react'
+import { cn } from '@client/l4_foundation/lib/l4-utils'
+import {
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger
+} from '@client/l4_foundation/ui/shadcn/collapsible'
+import type { L3CompactDirectory } from '../l3-project-path-tree'
+
+export function L3ProjectTreeFolder({
+  directory,
+  expanded,
+  onToggle,
+  children,
+  ...props
+}: ComponentPropsWithRef<'div'> & {
+  directory: L3CompactDirectory
+  expanded: boolean
+  onToggle: () => void
+}): React.JSX.Element {
+  const parts = directory.label.split('/')
+  const leaf = parts.at(-1)
+  const prefix = parts.slice(0, -1).join(' \\ ')
+  const label = parts.join(' \\ ')
+  const Icon = expanded ? FolderOpenIcon : FolderIcon
+
+  return (
+    <Collapsible open={expanded} onOpenChange={onToggle}>
+      <div
+        role="treeitem"
+        aria-expanded={expanded}
+        aria-selected={false}
+        title={directory.targetPath}
+        {...props}
+      >
+        <div className="flex min-h-9 items-center rounded-sm px-2 py-1 transition-colors hover:bg-foreground/8">
+          <CollapsibleTrigger
+            className="flex min-h-7 min-w-0 flex-1 cursor-pointer items-center gap-2 rounded-sm bg-transparent p-0 text-left text-sm outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring"
+            aria-label={label}
+            onKeyDown={(event) => {
+              if (
+                (event.key === 'ArrowLeft' && expanded) ||
+                (event.key === 'ArrowRight' && !expanded)
+              ) {
+                event.preventDefault()
+                event.stopPropagation()
+                onToggle()
+              }
+            }}
+          >
+            <span className="flex size-6 shrink-0 items-center justify-center">
+              <ChevronRightIcon
+                className={cn(
+                  'size-4 text-muted-foreground transition-transform',
+                  expanded && 'rotate-90'
+                )}
+              />
+            </span>
+            <Icon className="size-4 shrink-0 text-muted-foreground" aria-hidden="true" />
+            <span className="flex min-w-0 items-baseline">
+              {prefix ? (
+                <>
+                  <span className="min-w-0 shrink-[2] truncate text-muted-foreground">
+                    {prefix}
+                  </span>
+                  <span className="shrink-0 px-1 text-muted-foreground" aria-hidden="true">
+                    {'\\'}
+                  </span>
+                </>
+              ) : null}
+              <span className="min-w-0 truncate">{leaf}</span>
+            </span>
+          </CollapsibleTrigger>
+        </div>
+        <CollapsibleContent>
+          <div role="group" className="ml-4 border-l pl-2">
+            {children}
+          </div>
+        </CollapsibleContent>
+      </div>
+    </Collapsible>
+  )
+}

package/src/client/l4_foundation/ui/file-icons/README.md

@@ -1,6 +1,6 @@
 # 文件类型图标
 
-`l4-file-icon.tsx` 是宿主文件类型图标入口。特殊文件名优先于扩展名，未知类型回退 Lucide 文档图标；操作图标继续使用 Lucide。
+`l4-file-icon.tsx` 是文件树、搜索、预览页签与聊天读取消息共用的文件类型图标入口。常用类型保留彩色图标；环境与工具配置共用中性配置图标，其他已识别代码类型回退通用代码图标，未知文件回退文档图标。目录与操作图标继续使用中性色 Lucide。
 
 `material/` 保留 [Material Icon Theme](https://github.com/material-extensions/vscode-material-icon-theme) 的 18 个原始 SVG，来源版本为 `cb1dfb6d9cb73b15681a93939983d75dbba7bf5b`，采用 MIT 许可，完整许可见 [`material/LICENSE`](./material/LICENSE)。
 

package/src/client/l4_foundation/ui/file-icons/l4-file-icon.tsx

@@ -1,4 +1,4 @@
-import { FileTextIcon } from 'lucide-react'
+import { FileCode2Icon, FileTextIcon, Settings2Icon } from 'lucide-react'
 import Image, { type StaticImageData } from 'next/image'
 import agentIcon from './material/agent.svg'
 import consoleIcon from './material/console.svg'
@@ -74,6 +74,40 @@ const EXTENSION_ICONS = new Map<string, StaticImageData>(
   })
 )
 
+const CONFIG_EXTENSIONS = new Set(['env', 'toml', 'ini', 'conf', 'cfg', 'properties'])
+const CONFIG_NAMES = new Set([
+  '.editorconfig',
+  '.npmrc',
+  '.yarnrc',
+  '.prettierignore',
+  '.eslintignore'
+])
+const CODE_EXTENSIONS = new Set([
+  'c',
+  'cpp',
+  'cc',
+  'cxx',
+  'h',
+  'hpp',
+  'cs',
+  'go',
+  'rs',
+  'java',
+  'kt',
+  'kts',
+  'rb',
+  'php',
+  'swift',
+  'dart',
+  'vue',
+  'svelte',
+  'scss',
+  'sass',
+  'less',
+  'sql',
+  'xml'
+])
+
 export function L4FileIcon({
   path,
   className
@@ -83,13 +117,26 @@ export function L4FileIcon({
 }): React.JSX.Element {
   const fileName = path.replaceAll('\\', '/').split('/').at(-1)?.toLowerCase() ?? ''
   const extension = fileName.includes('.') ? fileName.slice(fileName.lastIndexOf('.') + 1) : ''
+  const config =
+    CONFIG_EXTENSIONS.has(extension) ||
+    CONFIG_NAMES.has(fileName) ||
+    fileName.startsWith('.env.') ||
+    fileName.startsWith('.eslintrc') ||
+    fileName.startsWith('.prettierrc') ||
+    fileName.startsWith('eslint.config.') ||
+    fileName.startsWith('prettier.config.')
+  if (config) return <Settings2Icon className={className} aria-hidden="true" />
+
   // 特殊文件名优先于扩展名；只查静态子集，不在卡片内生成完整主题映射。
   const icon =
     FILE_NAME_ICONS.get(fileName) ??
     (fileName.startsWith('dockerfile.') ? dockerIcon : undefined) ??
     EXTENSION_ICONS.get(extension)
 
-  if (!icon) return <FileTextIcon className={className} aria-hidden="true" />
+  if (!icon) {
+    const Fallback = CODE_EXTENSIONS.has(extension) ? FileCode2Icon : FileTextIcon
+    return <Fallback className={className} aria-hidden="true" />
+  }
 
   return (
     <Image

package/src/common/l2_biz/pi-session/l2-pi-session-contract.ts

@@ -5,6 +5,11 @@ import {
   L3PiSessionIdSchema
 } from '@common/l3_modules/pi/l3-pi-contract'
 import { L4TimestampMsSchema } from '@common/l4_foundation/l4-timestamp-contract'
+import {
+  L3PiSessionSearchScopeSchema,
+  L3PiSessionSearchMatchSchema,
+  L3PiSessionSearchQuerySchema
+} from '@common/l3_modules/pi/l3-pi-session-search-contract'
 
 export const L2PiDirectorySchema = z
   .object({
@@ -59,22 +64,8 @@ export const L2PiDirectoryEntryListResponseSchema = z
   })
   .strict()
 
-export const L2PiSessionHistorySearchScopeSchema = z.enum([
-  'title',
-  'user',
-  'assistant',
-  'sessionId'
-])
-
-export const L2PiSessionHistoryMatchSchema = z
-  .object({
-    scope: L2PiSessionHistorySearchScopeSchema,
-    count: z.number().int().positive(),
-    entryId: L3PiEntryIdSchema.nullable(),
-    timestampMs: L4TimestampMsSchema.nullable(),
-    preview: z.string().min(1).max(160)
-  })
-  .strict()
+export const L2PiSessionHistorySearchScopeSchema = L3PiSessionSearchScopeSchema
+export const L2PiSessionHistoryMatchSchema = L3PiSessionSearchMatchSchema
 
 export const L2PiSessionHistoryItemSchema = z
   .object({
@@ -90,14 +81,10 @@ export const L2PiSessionHistoryItemSchema = z
   })
   .strict()
 
-export const L2PiSessionHistoryQuerySchema = z
-  .object({
-    cwd: L3PiCwdSchema,
-    query: z.string().trim().max(120).default(''),
-    forceRefresh: z.boolean().default(false),
-    searchIn: z.array(L2PiSessionHistorySearchScopeSchema).min(1).max(4).default(['title', 'user'])
-  })
-  .strict()
+export const L2PiSessionHistoryQuerySchema = L3PiSessionSearchQuerySchema.extend({
+  cwd: L3PiCwdSchema,
+  forceRefresh: z.boolean().default(false)
+})
 
 export const L2PiSessionHistoryResponseSchema = z
   .object({