@jetcrab/pi-desk 1.1.12 → 1.1.13-dev

package/docs/plugins.md

@@ -77,7 +77,7 @@ plugin.addPreviewDirectory(directory, { default: true })
 
 `directory` 为服务端绝对目录；省略第二个参数只登记，`default: true` 同时设为默认预览目录，后登记的默认生效。原 CWD 始终可选；目录规范化后去重，最多登记 32 个。重复快照不会覆盖用户的手动选择。登记只在当前会话运行态内，插件在 `session_start`、`session_tree` 从自身数据恢复后重新登记；不要在普通查询时重复请求默认选择。
 
-调用不等待回执；非法路径或超限由宿主拒绝并记日志，实际目录内容按需读取。旧宿主或独立 Pi 不处理该登记；兼容旧 SDK 时使用 `plugin.addPreviewDirectory?.(...)`。`files.preview/reveal` 支持会话 CWD 下规范相对路径或服务端绝对文件路径（包括项目外文件）；`preview` 的 `imagePaths` 使用相同路径规则。宿主仍校验当前 Source，目录浏览边界不变。依赖项目外文件的插件需要同步更新宿主，旧宿主只接受项目内相对路径。`readImage` 仍只接受会话 CWD 下规范相对路径。
+调用不等待回执；非法路径或超限由宿主拒绝并记日志，实际目录内容按需读取。旧宿主或独立 Pi 不处理该登记；兼容旧 SDK 时使用 `plugin.addPreviewDirectory?.(...)`。`files.preview/reveal` 支持会话 CWD 下规范相对路径或服务端绝对文件路径（包括项目外文件）；`preview` 的 `imagePaths` 使用相同路径规则。宿主仍校验当前 Source，目录浏览边界不变。依赖项目外文件的插件需要同步更新宿主，旧宿主只接受项目内相对路径。`readImage` 仍只接受会话 CWD 下规范相对路径。`.md`、`.markdown` 在宿主文件查看器中默认以 Markdown 排版预览，可点击“源码”切换；会话文件视图与 `mode: 'standalone'` 独立查看器均支持，插件无需增加参数或自行渲染。
 
 ## Browser Entry 与懒界面
 
@@ -105,6 +105,26 @@ Application 使用 `chrome: 'host'` 让宿主负责 Dialog、标题、关闭、
 
 界面继承宿主明暗主题与字号，布局使用 `rem`、合理内边距和自身滚动；窄屏与触控可用，不以裁切或只靠 hover 隐藏必要操作。按钮、表单、加载/错误/重试优先复用 `/react/base`；需要 Markdown 时才加载 `/react/markdown`。
 
+### 侧栏顶部操作
+
+`session-sidebar-tab` 的 Lazy `mount({ target, host })` 内可为当前 Tab 设置顶部右侧按钮：
+
+```ts
+target.setHeaderActions?.([
+  {
+    label: '预览项目',
+    icon: { type: 'builtin', name: 'folder' },
+    onSelect: () => host.projects.preview(target.cwd)
+  }
+])
+```
+
+每次调用整体替换，`[]` 清空。按钮使用 `label` 作为可访问名称和提示，`icon` 复用 Contribution 图标；可选 `disabled` 禁用，`busy` 显示忙碌并禁用。状态变化时重新设置完整列表，不修改已提交对象。宿主保持列表顺序，超过三个操作时保留前两个，其余收进菜单。
+
+`onSelect` 可返回 `Promise<void>`；同一按钮回调尚未完成时不重复执行，异常由宿主记录并在当前挂载仍有效时提示。插件负责业务加载状态和结果展示；请求已经产生的副作用不因 Tab 关闭而回滚。
+
+按钮只属于当前挂载，切换 Tab、关闭侧栏／移动抽屉、Source 或 CWD 变化、挂载失败及插件重载时自动清空；旧按钮、迟到更新和旧 disposer 均不能操作新挂载。旧宿主可能没有此方法，使用可选调用，不自行访问宿主 DOM。`PluginPanelHeader.actions` 仍只作用于插件内容区标题，不是此顶栏入口。
+
 ## 通信、通知与后台
 
 Browser Method 示例：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetcrab/pi-desk",
-  "version": "1.1.12",
+  "version": "1.1.13-dev",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -69,7 +69,7 @@
     "viewerjs": "^1.11.8",
     "ws": "^8.21.3",
     "zod": "^4.4.3",
-    "@jetcrab/pi-desk-sdk": "^1.1.3"
+    "@jetcrab/pi-desk-sdk": "^1.1.4-dev"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "1.2.0",

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

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

package/src/client/l2_biz/auth/l2-login.tsx

@@ -96,7 +96,7 @@ export function L2Login(): React.JSX.Element {
                 name="password"
                 value={password}
                 autoComplete="current-password"
-                maxLength={256}
+                maxLength={64}
                 disabled={submitting}
                 aria-describedby={error ? 'login-error' : undefined}
                 onChange={(event) => setPassword(event.target.value)}

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

@@ -2,6 +2,7 @@
 
 import type {
   BrowserFilePreviewOptions,
+  BrowserSessionSidebarHeaderAction,
   BrowserSessionSidebarTabTarget,
   PluginSource
 } from '@jetcrab/pi-desk-sdk/browser'
@@ -15,6 +16,7 @@ interface L2PluginSessionSidebarTabProps {
   cwd: string
   onPreviewFile: (path: string, options?: BrowserFilePreviewOptions) => void
   onRevealFile: (path: string) => Promise<void>
+  onHeaderActionsChange: (actions: readonly BrowserSessionSidebarHeaderAction[]) => void
 }
 
 export function L2PluginSessionSidebarTab({
@@ -23,13 +25,15 @@ export function L2PluginSessionSidebarTab({
   source,
   cwd,
   onPreviewFile,
-  onRevealFile
+  onRevealFile,
+  onHeaderActionsChange
 }: L2PluginSessionSidebarTabProps): React.JSX.Element {
   const target: BrowserSessionSidebarTabTarget = {
     kind: 'session-sidebar-tab',
     source,
     cwd,
-    files: { preview: onPreviewFile, reveal: onRevealFile }
+    files: { preview: onPreviewFile, reveal: onRevealFile },
+    setHeaderActions: onHeaderActionsChange
   }
   const targetKey = `${source.workId}\u0000${source.sessionId}\u0000${source.branchId}\u0000${cwd}`
 

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

@@ -99,7 +99,7 @@ export function L2AuthSettings(): React.JSX.Element {
                   className="[&::-ms-reveal]:hidden"
                   autoComplete="new-password"
                   minLength={12}
-                  maxLength={256}
+                  maxLength={64}
                   required
                   disabled={busy}
                   value={state.password}

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

@@ -17,7 +17,6 @@ import {
   subscribeL4DisplaySize
 } from '@client/l4_foundation/ui/l4-display-size-provider'
 import { L3ConversationMarkdown } from '@client/l3_modules/conversation/l3-conversation-markdown'
-import { saveL4PowerSaving, useL4PowerSaving } from '@client/l4_foundation/ui/l4-power-saving'
 
 const THEME_OPTIONS = [
   { value: 'system', label: 'common:system', icon: MonitorIcon },
@@ -34,7 +33,6 @@ const DISPLAY_SIZE_OPTIONS = [
 export function L2AppearanceSettings(): React.JSX.Element {
   const { t } = useTranslation('settings')
   const theme = useSyncExternalStore(subscribeL4Theme, readL4Theme, () => L4_DEFAULT_THEME)
-  const powerSaving = useL4PowerSaving()
   const size = useSyncExternalStore(
     subscribeL4DisplaySize,
     readL4DisplaySize,
@@ -58,7 +56,7 @@ export function L2AppearanceSettings(): React.JSX.Element {
               onChange={saveL4Theme}
             />
           </div>
-          <div className="space-y-2 border-b pb-4">
+          <div className="space-y-2">
             <h3 className="text-sm font-medium">{t('displaySize')}</h3>
             <L4ChoiceGroup<L4DisplaySize>
               label={t('displaySize')}
@@ -71,19 +69,6 @@ export function L2AppearanceSettings(): React.JSX.Element {
               onChange={saveL4DisplaySize}
             />
           </div>
-          <div className="space-y-2">
-            <h3 className="text-sm font-medium">{t('powerSaving')}</h3>
-            <L4ChoiceGroup<'off' | 'on'>
-              label={t('powerSaving')}
-              layout="segmented"
-              value={powerSaving ? 'on' : 'off'}
-              options={[
-                { value: 'off', label: t('powerSavingOff'), testId: 'power-saving-off' },
-                { value: 'on', label: t('powerSavingOn'), testId: 'power-saving-on' }
-              ]}
-              onChange={(value) => saveL4PowerSaving(value === 'on')}
-            />
-          </div>
         </div>
         <div className="min-w-0 space-y-2">
           <h3 className="text-sm font-medium">{t('displayPreview')}</h3>

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

@@ -14,7 +14,7 @@ import {
   XCircleIcon,
   XIcon
 } from 'lucide-react'
-import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react'
+import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from 'react'
 import { useTranslation } from 'react-i18next'
 import {
   type L2TaskDetailBody,
@@ -50,7 +50,6 @@ import {
 } from '@client/l3_modules/conversation/l3-conversation-messages'
 import { L3ConversationTailSpacerObserver } from '@client/l3_modules/conversation/l3-conversation-viewport'
 import { useL4AppToast } from '@client/l4_foundation/ui/l4-app-toast'
-import { useL4WindowReveal } from '@client/l4_foundation/ui/l4-window-reveal'
 import type { L2TaskCenterRuntime } from './l2-task-center-runtime'
 
 interface L2TaskCenterProps {
@@ -443,8 +442,6 @@ function TaskCenterPanel({
   }, [runtime])
   useSyncExternalStore(runtime.subscribe, getPanelSnapshot, getPanelSnapshot)
   const state = runtime.getState()
-  const closeButtonRef = useRef<HTMLButtonElement>(null)
-  const desktopCloseButtonRef = useRef<HTMLButtonElement>(null)
   const [mobileDetail, setMobileDetail] = useState(false)
   const selectedTask = tasks.find((task) => task.taskId === state.selectedTaskId) ?? null
 
@@ -455,17 +452,6 @@ function TaskCenterPanel({
 
   const showMobileDetail = mobileDetail && state.selectedTaskId !== null
   const panelOpen = state.open && sameSource(state.source, source)
-  const listRef = useRef<HTMLDivElement>(null)
-  const detailRef = useRef<HTMLDivElement>(null)
-  useL4WindowReveal(listRef, panelOpen && !showMobileDetail ? 'task-list' : null)
-  useL4WindowReveal(
-    detailRef,
-    panelOpen ? `${state.selectedTaskId ?? 'no-task'}:${showMobileDetail}` : null
-  )
-
-  if (!state.open || !sameSource(state.source, source) || typeof document === 'undefined') {
-    return null
-  }
 
   const select = (taskId: string): void => {
     runtime.selectTask(taskId)
@@ -474,23 +460,17 @@ function TaskCenterPanel({
 
   return (
     <L4AppDialogRoot
-      open
+      open={panelOpen}
       onOpenChange={(open) => {
         if (!open) runtime.close()
       }}
     >
       <L4AppDialogContent
         aria-label={t('title')}
-        initialFocus={() =>
-          desktopCloseButtonRef.current?.getClientRects().length
-            ? desktopCloseButtonRef.current
-            : closeButtonRef.current
-        }
         showCloseButton={false}
-        className="h-[calc(100dvh-2rem)] max-w-[70rem] flex-row bg-background data-open:animate-none 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-dvh max-lg:max-h-dvh max-lg:w-dvw max-lg:max-w-none max-lg:rounded-none max-lg:border-0"
       >
         <div
-          ref={listRef}
           className={cn(
             'flex min-w-0 flex-1 flex-col border-r bg-sidebar lg:max-w-80',
             showMobileDetail && 'hidden lg:flex'
@@ -505,7 +485,6 @@ function TaskCenterPanel({
               </p>
             </div>
             <Button
-              ref={showMobileDetail ? undefined : closeButtonRef}
               className="lg:hidden"
               type="button"
               variant="ghost"
@@ -576,10 +555,7 @@ function TaskCenterPanel({
           </div>
         </div>
 
-        <div
-          ref={detailRef}
-          className={cn('min-w-0 flex-1', !showMobileDetail && 'hidden lg:block')}
-        >
+        <div className={cn('min-w-0 flex-1', !showMobileDetail && 'hidden lg:block')}>
           <div className="flex h-full min-h-0 flex-col">
             <div className="flex min-h-12 items-center gap-2 border-b bg-muted/10 px-3 lg:hidden">
               <Button
@@ -595,7 +571,6 @@ function TaskCenterPanel({
                 {selectedTask?.title ?? t('detail')}
               </span>
               <Button
-                ref={showMobileDetail ? closeButtonRef : undefined}
                 type="button"
                 variant="ghost"
                 size="icon"
@@ -616,7 +591,6 @@ function TaskCenterPanel({
           </div>
         </div>
         <Button
-          ref={desktopCloseButtonRef}
           className="absolute right-4 top-3 z-10 hidden lg:inline-flex"
           type="button"
           variant="ghost"

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

@@ -7,7 +7,12 @@ import type { PluginSource } from '@jetcrab/pi-desk-sdk/browser'
 import type { L2WorkSessionFileGetResponse } from '@common/l2_biz/work-session/l2-work-session-file-contract'
 import { createL4Base64ImageBlob } from '@client/l4_foundation/media/l4-base64-image'
 import { readL3ImagePreviewMode } from '@client/l3_modules/preferences/l3-work-session-file-preferences'
-import { L4CodePreview } from '@client/l4_foundation/ui/code/l4-code-preview'
+import {
+  L4CodePreview,
+  type L4CodePreviewState
+} from '@client/l4_foundation/ui/code/l4-code-preview'
+import { L3MarkdownPreview } from '@client/l3_modules/project-files/l3-markdown-preview'
+import { getL3ProjectTextPreviewKind } from '@client/l3_modules/project-files/l3-project-text-preview'
 import {
   L4AppDialogContent,
   L4AppDialogRoot,
@@ -56,7 +61,14 @@ export function L2PluginStandaloneFilePreview({
   onClose: () => void
 }): React.JSX.Element | null {
   const { t } = useTranslation('workbench')
+  const { t: filesT } = useTranslation('projectFiles')
   const iframeRef = useRef<HTMLIFrameElement>(null)
+  const [view, setView] = useState<{ mode: 'preview' | 'source'; scrollTop: number }>({
+    mode: 'preview',
+    scrollTop: 0
+  })
+  const previewScrollTop = useRef(0)
+  const [editorState, setEditorState] = useState<L4CodePreviewState | null>(null)
   const [retry, setRetry] = useState(0)
   const [document, setDocument] = useState<StandaloneFileDocument>(() => {
     const url =
@@ -129,7 +141,7 @@ export function L2PluginStandaloneFilePreview({
 
   if (!target) return null
   const path = target.imagePaths?.[imageIndex] ?? target.path
-  const isHtml = /\.html?$/i.test(path)
+  const previewKind = getL3ProjectTextPreviewKind(path)
   return (
     <L4AppDialogRoot
       open
@@ -150,8 +162,8 @@ export function L2PluginStandaloneFilePreview({
           className="flex size-full min-h-0 min-w-0 flex-col overflow-hidden bg-background"
           aria-label={t('standaloneViewer', { name: target.projectName })}
         >
-          <header className="flex min-h-14 shrink-0 items-center border-b pl-3 pr-14 pt-[env(safe-area-inset-top)]">
-            <div className="min-w-0">
+          <header className="flex min-h-14 shrink-0 items-center gap-3 border-b pl-3 pr-14 pt-[env(safe-area-inset-top)]">
+            <div className="min-w-0 flex-1">
               <p className="truncate text-sm font-semibold" title={fileName(path)}>
                 {fileName(path)}
               </p>
@@ -162,6 +174,23 @@ export function L2PluginStandaloneFilePreview({
                 {target.projectName} · {path}
               </p>
             </div>
+            {previewKind === 'markdown' && document.status === 'text' ? (
+              <div className="flex shrink-0" role="group" aria-label={filesT('markdownMode')}>
+                {(['preview', 'source'] as const).map((mode) => (
+                  <Button
+                    key={mode}
+                    size="sm"
+                    variant={view.mode === mode ? 'secondary' : 'ghost'}
+                    aria-pressed={view.mode === mode}
+                    onClick={() => {
+                      if (view.mode !== mode) setView({ mode, scrollTop: previewScrollTop.current })
+                    }}
+                  >
+                    {filesT(mode === 'preview' ? 'previewMode' : 'sourceMode')}
+                  </Button>
+                ))}
+              </div>
+            ) : null}
           </header>
           <div className="min-h-0 flex-1 overflow-hidden pb-[env(safe-area-inset-bottom)]">
             {target.imagePaths ? (
@@ -197,7 +226,16 @@ export function L2PluginStandaloneFilePreview({
                 slides={[{ src: document.objectUrl, alt: target.path }]}
                 ariaLabel={t('standaloneImage', { name: fileName(target.path) })}
               />
-            ) : isHtml ? (
+            ) : previewKind === 'markdown' && view.mode === 'preview' ? (
+              <L3MarkdownPreview
+                content={document.content}
+                label={filesT('markdownPreview', { name: path })}
+                savedScrollTop={view.scrollTop}
+                onScroll={(scrollTop) => {
+                  previewScrollTop.current = scrollTop
+                }}
+              />
+            ) : previewKind === 'html' ? (
               <iframe
                 ref={iframeRef}
                 className="block size-full border-0 bg-white"
@@ -210,8 +248,8 @@ export function L2PluginStandaloneFilePreview({
                 path={target.path}
                 content={document.content}
                 size={document.size}
-                savedState={null}
-                onSaveState={() => undefined}
+                savedState={editorState}
+                onSaveState={(_path, state) => setEditorState(state)}
                 onEscape={onClose}
               />
             )}

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

@@ -0,0 +1,57 @@
+'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 { L2WorkbenchBiz } from '../l2-workbench-biz'
+
+interface L2WorkSessionRename {
+  open: boolean
+  title: string
+  saving: boolean
+  error: string | null
+  show: (workSession: L2WorkSessionListItem) => void
+  close: () => void
+  setTitle: (title: string) => void
+  save: () => Promise<void>
+}
+
+export function useL2WorkSessionRename(
+  biz: Pick<L2WorkbenchBiz, 'renameWorkSession'>,
+  disabled: boolean
+): L2WorkSessionRename {
+  const { t } = useTranslation('workbench')
+  const [target, setTarget] = useState<Pick<L2WorkSessionListItem, 'workId' | 'sessionId'> | null>(
+    null
+  )
+  const [title, setTitle] = useState('')
+  const [saving, setSaving] = useState(false)
+  const [error, setError] = useState<string | null>(null)
+
+  const show = useCallback((workSession: L2WorkSessionListItem): void => {
+    setTarget({ workId: workSession.workId, sessionId: workSession.sessionId })
+    setTitle(workSession.sessionTitle ?? '')
+    setError(null)
+  }, [])
+
+  const close = (): void => {
+    if (!saving) setTarget(null)
+  }
+
+  const save = async (): Promise<void> => {
+    const trimmedTitle = title.trim()
+    if (!target || saving || disabled || !trimmedTitle) return
+    setSaving(true)
+    setError(null)
+    try {
+      await biz.renameWorkSession({ ...target, title: trimmedTitle })
+      setTarget(null)
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : t('renameSessionFailed'))
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  return { open: target !== null, title, saving, error, show, close, setTitle, save }
+}

package/src/client/l2_biz/workbench/l2-work-session-columns.tsx

@@ -16,7 +16,6 @@ import type { L2ChatSource } from '@common/l2_biz/chat/l2-chat-contract'
 import type { L3CapabilityModeNames } from '@common/l3_modules/capability-modes/l3-capability-modes-contract'
 import type { L2WorkSessionListItem } from '@common/l2_biz/work-session/l2-work-session-contract'
 import { cn } from '@client/l4_foundation/lib/l4-utils'
-import { useL4WindowReveal } from '@client/l4_foundation/ui/l4-window-reveal'
 import {
   ResizableHandle,
   ResizablePanel,
@@ -52,7 +51,6 @@ import {
 import styles from './l2-work-session-columns.module.css'
 import motionStyles from './l2-workbench-motion.module.css'
 import { useL2WorkSessionColumnCapacity } from './hooks/l2-work-session-column-capacity'
-import { useL2WorkSessionColumnMotion } from './hooks/l2-work-session-column-motion'
 import type { L2FileWorkspaceRuntime } from './file-workspace/l2-file-workspace-runtime'
 import { L2WorkSessionFileLayout } from './file-workspace/l2-work-session-file-layout'
 import { Button, buttonVariants } from '@client/l4_foundation/ui/shadcn/button'
@@ -212,10 +210,6 @@ const WorkSessionColumn = memo(function WorkSessionColumn({
 }: WorkSessionColumnProps): React.JSX.Element {
   const { t } = useTranslation('workbench')
   const columnRef = useRef<HTMLElement>(null)
-  useL4WindowReveal(
-    columnRef,
-    `${workSession.workId}:${workSession.sessionId}:${workSession.branchId}`
-  )
   const initializationIssue = useL2WorkbenchInitializationIssue(workSession, chatRuntime)
   useSyncExternalStore(fileRuntime.subscribe, fileRuntime.getRevision, fileRuntime.getRevision)
   const fileWorkspace = fileRuntime.getWorkspace(workSession.workId)
@@ -566,11 +560,6 @@ export function L2WorkSessionColumns({
   const panelGroupRef = useGroupRef()
   const panelIdsJson = JSON.stringify(columnItems.map((item) => item.key))
   const columnModesKey = columnModes.map((mode) => (mode === 'expanded' ? 'e' : 'c')).join('')
-  useL2WorkSessionColumnMotion(
-    containerRef,
-    `${panelIdsJson}:${columnModesKey}:${primaryWorkId}`,
-    !mobile
-  )
 
   useLayoutEffect(() => {
     const panelIds = JSON.parse(panelIdsJson) as string[]

package/src/client/l2_biz/workbench/l2-work-session-sidebar.tsx

@@ -25,6 +25,7 @@ import {
   MessageSquareTextIcon,
   PinIcon,
   PinOffIcon,
+  PencilIcon,
   PlusIcon,
   RefreshCwIcon,
   Repeat2Icon,
@@ -43,7 +44,10 @@ import {
   useState,
   type ReactNode
 } from 'react'
-import type { BrowserContributionIcon } from '@jetcrab/pi-desk-sdk/browser'
+import type {
+  BrowserContributionIcon,
+  BrowserSessionSidebarHeaderAction
+} from '@jetcrab/pi-desk-sdk/browser'
 import type { L2WorkSessionListItem } from '@common/l2_biz/work-session/l2-work-session-contract'
 import type { L3AppNotification } from '@common/l3_modules/app-runtime/l3-app-runtime-contract'
 import { copyL4BrowserText } from '@client/l4_foundation/lib/l4-browser-clipboard'
@@ -108,6 +112,7 @@ interface L2WorkSessionSidebarProps {
   mobile: boolean
   fileBrowser: ReactNode
   pluginTabContent: ReactNode
+  pluginHeaderActions?: readonly BrowserSessionSidebarHeaderAction[]
   pluginSessionTabs: readonly L2SidebarPluginSessionTab[]
   fileRefreshLoading: boolean
   canBrowseFiles: boolean
@@ -134,6 +139,7 @@ interface L2WorkSessionSidebarProps {
   onSelect: (workId: string) => void
   onTogglePin: (workId: string) => void
   onDelete: (workId: string) => void
+  onRename: (workSession: L2WorkSessionListItem) => void
   onArrangementChange: (arrangement: L2WorkSessionArrangement, movedWorkId: string) => void
 }
 
@@ -209,19 +215,22 @@ function SidebarHeaderGroup({
   className?: string
 }): React.JSX.Element {
   const { t } = useTranslation('workbench')
+  const overflow = appearance === 'action' && items.length > 3 ? items.slice(2) : []
+  const visibleItems = overflow.length > 0 ? items.slice(0, 2) : items
   return (
     <div
       className={cn('flex min-w-0 items-center gap-0', className)}
       role="group"
       aria-label={label}
     >
-      {items.map((item) => (
+      {visibleItems.map((item) => (
         <button
           key={item.key}
           data-testid={item.testId}
           type="button"
           disabled={item.disabled}
           aria-pressed={item.pressed}
+          aria-busy={item.busy || undefined}
           aria-label={
             appearance === 'mode' ? t('showSidebarMode', { name: item.label }) : item.label
           }
@@ -243,6 +252,30 @@ function SidebarHeaderGroup({
           </span>
         </button>
       ))}
+      {overflow.length > 0 ? (
+        <DropdownMenu>
+          <DropdownMenuTrigger
+            render={
+              <button
+                type="button"
+                aria-label={label}
+                title={label}
+                className={SIDEBAR_HEADER_ACTION_BUTTON_CLASS}
+              >
+                <EllipsisIcon className="size-4" />
+              </button>
+            }
+          />
+          <DropdownMenuContent align="end">
+            {overflow.map((item) => (
+              <DropdownMenuItem key={item.key} disabled={item.disabled} onClick={item.onSelect}>
+                <span className="shrink-0 [&_svg]:size-4">{item.icon}</span>
+                {item.label}
+              </DropdownMenuItem>
+            ))}
+          </DropdownMenuContent>
+        </DropdownMenu>
+      ) : null}
     </div>
   )
 }
@@ -309,7 +342,8 @@ const SortableWorkSessionRow = memo(function SortableWorkSessionRow({
   now,
   onSelect,
   onTogglePin,
-  onDelete
+  onDelete,
+  onRename
 }: {
   workSession: L2WorkSessionListItem
   mobile: boolean
@@ -322,7 +356,10 @@ const SortableWorkSessionRow = memo(function SortableWorkSessionRow({
   onSelect: (workId: string) => void
   onTogglePin: (workId: string) => void
   onDelete: (workId: string) => void
+  onRename: (workSession: L2WorkSessionListItem) => void
 }): React.JSX.Element {
+  const suppressTouchClick = useRef(false)
+  const lastPointer = useRef('')
   const actionsDisabled = disabled || ordering
   const {
     attributes,
@@ -518,9 +555,57 @@ const SortableWorkSessionRow = memo(function SortableWorkSessionRow({
   )
 
   return (
-    <ContextMenu>
-      <ContextMenuTrigger render={row} />
+    <ContextMenu
+      onOpenChange={(open, details) => {
+        if (open && (lastPointer.current === 'touch' || details.event.type.startsWith('touch'))) {
+          suppressTouchClick.current = true
+        }
+      }}
+    >
+      <ContextMenuTrigger
+        render={row}
+        onPointerDown={(event) => {
+          lastPointer.current = event.pointerType
+          suppressTouchClick.current = false
+        }}
+        onTouchEndCapture={(event) => {
+          // 长按打开菜单后，松手不能派生为选择会话的点击。
+          if (suppressTouchClick.current && event.cancelable) event.preventDefault()
+        }}
+        onClickCapture={(event) => {
+          if (!suppressTouchClick.current) return
+          event.preventDefault()
+          event.stopPropagation()
+          suppressTouchClick.current = false
+        }}
+        onKeyDownCapture={(event) => {
+          if (event.target !== event.currentTarget || event.nativeEvent.isComposing) return
+          lastPointer.current = 'keyboard'
+          suppressTouchClick.current = false
+          if (event.key !== 'ContextMenu' && !(event.key === 'F10' && event.shiftKey)) return
+          event.preventDefault()
+          event.stopPropagation()
+          const rect = event.currentTarget.getBoundingClientRect()
+          event.currentTarget.dispatchEvent(
+            new MouseEvent('contextmenu', {
+              bubbles: true,
+              cancelable: true,
+              button: 2,
+              clientX: rect.left + rect.width / 2,
+              clientY: rect.top + rect.height / 2
+            })
+          )
+        }}
+      />
       <ContextMenuContent>
+        <ContextMenuItem
+          data-testid={`work-session-rename-${workSession.workId}`}
+          disabled={actionsDisabled || deleting}
+          onClick={() => onRename(workSession)}
+        >
+          <PencilIcon />
+          {t('renameSessionTitle')}
+        </ContextMenuItem>
         <ContextMenuItem
           data-testid={`work-session-copy-project-path-${workSession.workId}`}
           onClick={copyProjectPath}
@@ -562,6 +647,7 @@ function L2WorkSessionSidebarComponent({
   mobile,
   fileBrowser,
   pluginTabContent,
+  pluginHeaderActions = [],
   pluginSessionTabs,
   fileRefreshLoading,
   canBrowseFiles,
@@ -588,6 +674,7 @@ function L2WorkSessionSidebarComponent({
   onSelect,
   onTogglePin,
   onDelete,
+  onRename,
   onArrangementChange
 }: L2WorkSessionSidebarProps): React.JSX.Element {
   const { t } = useTranslation('workbench')
@@ -696,7 +783,20 @@ function L2WorkSessionSidebarComponent({
               onSelect: onRefreshFiles
             }
           ]
-        : []
+        : pluginHeaderActions.map((action, index) => ({
+            key: String(index),
+            label: action.label,
+            icon: action.busy ? (
+              <LoaderCircleIcon className="animate-spin" />
+            ) : (
+              <L4PluginIcon icon={action.icon} />
+            ),
+            disabled: action.disabled || action.busy,
+            busy: action.busy,
+            onSelect: () => {
+              void action.onSelect()
+            }
+          }))
 
   useLayoutEffect(() => {
     const container = shortcutContainerRef.current
@@ -787,6 +887,7 @@ function L2WorkSessionSidebarComponent({
         onSelect={onSelect}
         onTogglePin={onTogglePin}
         onDelete={onDelete}
+        onRename={onRename}
       />
     )
   })