@jetcrab/pi-desk 1.1.6-dev → 1.1.8-dev

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

@@ -1,7 +1,7 @@
 'use client'
 
 import { ChevronDownIcon, ChevronUpIcon, FileCode2Icon, XIcon } from 'lucide-react'
-import { useLayoutEffect, useRef, useState } from 'react'
+import { useLayoutEffect, useRef, useState, useSyncExternalStore } 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'
@@ -13,8 +13,12 @@ import {
 } from '@client/l4_foundation/ui/shadcn/context-menu'
 import type { L3FileTabCloseScope } from './l3-project-file-runtime'
 import { L3FileContextMenuContent } from './l3-file-context-menu-content'
+import type { L3ProjectGitBrowser } from './l3-project-git-runtime'
+import { findL3GitFile, getL3GitChangeBadge, getL3GitChangeClass } from './l3-project-git-model'
 
 interface L3ProjectFileTabsProps {
+  cwd: string
+  gitRuntime: L3ProjectGitBrowser
   paths: readonly string[]
   activePath: string | null
   diffPath: string | null
@@ -39,6 +43,8 @@ function fileLabel(path: string, paths: readonly string[]): string {
 }
 
 export function L3ProjectFileTabs({
+  cwd,
+  gitRuntime,
   paths,
   activePath,
   diffPath,
@@ -47,6 +53,8 @@ export function L3ProjectFileTabs({
   onClose
 }: L3ProjectFileTabsProps): React.JSX.Element | null {
   const { t } = useTranslation('projectFiles')
+  useSyncExternalStore(gitRuntime.subscribe, gitRuntime.getRevision, gitRuntime.getRevision)
+  const snapshot = gitRuntime.getWorkspace(cwd)?.snapshot
   const rowsRef = useRef<HTMLDivElement>(null)
   const suppressTouchClickRef = useRef(false)
   const [expanded, setExpanded] = useState(false)
@@ -98,6 +106,10 @@ export function L3ProjectFileTabs({
           {tabs.map((tab, index) => {
             const clipped = !expanded && clippedIndexes.includes(index)
             const selected = tab.path === active
+            const change =
+              tab.path && snapshot?.status === 'ready'
+                ? findL3GitFile(cwd, tab.path, snapshot.repositories)?.change
+                : undefined
             const closeLabel =
               tab.path === null
                 ? t('closeDiff', { name: tab.title.split('/').at(-1) })
@@ -186,7 +198,17 @@ export function L3ProjectFileTabs({
                     }}
                   >
                     <FileCode2Icon className="size-3.5 shrink-0" />
-                    <span className="truncate">{tab.label}</span>
+                    <span className={cn('truncate', change && getL3GitChangeClass(change))}>
+                      {tab.label}
+                    </span>
+                    {change ? (
+                      <span
+                        className={cn('shrink-0 text-xs', getL3GitChangeClass(change))}
+                        aria-label={t('gitStatus', { status: getL3GitChangeBadge(change) })}
+                      >
+                        {getL3GitChangeBadge(change)}
+                      </span>
+                    ) : null}
                   </button>
                   <Button
                     variant="ghost"

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

@@ -131,6 +131,38 @@ export function getL3GitChangeBadge(change: L4GitFileChange): string {
   return '?'
 }
 
+export function getL3GitChangeClass(change: L4GitFileChange): string {
+  const badge = getL3GitChangeBadge(change)
+  if (badge === 'D') return 'text-muted-foreground'
+  if (badge === '?') return 'text-red-600 dark:text-red-400'
+  if (badge === 'A') return 'text-emerald-600 dark:text-emerald-400'
+  if (badge === '!') return 'text-violet-600 dark:text-violet-400'
+  return 'text-blue-600 dark:text-blue-400'
+}
+
+export function findL3GitFile(
+  cwd: string,
+  path: string,
+  repositories: readonly L4GitRepository[]
+): { repository: L4GitRepository; path: string; change: L4GitFileChange | undefined } | null {
+  if (/^(?:[a-z]:|\/|\\\\)/i.test(path)) return null
+  const windows = /^[a-z]:[\\/]/i.test(cwd) || cwd.startsWith('\\\\')
+  const key = (value: string): string => (windows ? value.toLowerCase() : value)
+  const repository = [...repositories]
+    .sort((left, right) => right.root.length - left.root.length)
+    .find((item) => !item.root || key(path).startsWith(`${key(item.root)}/`))
+  if (!repository) return null
+  const relative = repository.root ? path.slice(repository.root.length + 1) : path
+  return {
+    repository,
+    path: relative,
+    change:
+      repository.state === 'ready'
+        ? repository.changes.find((item) => key(item.path) === key(relative))
+        : undefined
+  }
+}
+
 export function listL3GitProjectChanges(
   repositories: readonly L4GitRepository[]
 ): L3GitProjectChange[] {

package/src/client/l4_foundation/ui/code/l4-code-diff.tsx

@@ -44,10 +44,11 @@ interface L4CodeDiffProps {
   onEscape?: () => void
   savedState?: L4CodeDiffState | null
   onSaveState?: (state: L4CodeDiffState | null) => void
+  initialLine?: number
 }
 
 function L4CodeDiffComponent(
-  { original, modified, viewMode, onEscape, savedState, onSaveState }: L4CodeDiffProps,
+  { original, modified, viewMode, onEscape, savedState, onSaveState, initialLine }: L4CodeDiffProps,
   ref: ForwardedRef<L4CodeDiffHandle>
 ): React.JSX.Element {
   const { t } = useTranslation('common')
@@ -58,12 +59,14 @@ function L4CodeDiffComponent(
   const escapeRef = useRef(onEscape)
   const savedStateRef = useRef(savedState)
   const saveStateRef = useRef(onSaveState)
+  const initialLineRef = useRef(initialLine)
 
   useEffect(() => {
     escapeRef.current = onEscape
     savedStateRef.current = savedState
     saveStateRef.current = onSaveState
-  }, [onEscape, onSaveState, savedState])
+    initialLineRef.current = initialLine
+  }, [initialLine, onEscape, onSaveState, savedState])
   const [loadState, setLoadState] = useState<'loading' | 'ready' | 'error'>('loading')
   const [changeCount, setChangeCount] = useState<number | null>(null)
 
@@ -130,6 +133,7 @@ function L4CodeDiffComponent(
           useInlineViewWhenSpaceIsLimited: false,
           enableSplitViewResizing: true,
           diffAlgorithm: 'advanced',
+          ignoreTrimWhitespace: false,
           maxComputationTime: 5_000,
           hideUnchangedRegions: initialSettings.collapseUnchanged
             ? {
@@ -156,13 +160,29 @@ function L4CodeDiffComponent(
           contextmenu: true,
           ariaLabel: t('gitDiffReadOnly')
         })
-        diffEditor.setModel({ original: originalModel, modified: modifiedModel })
+        const requestedLine = initialLineRef.current
+        let initialPositionApplied = false
         scrollListeners.push(
           diffEditor.onDidUpdateDiff(() => {
-            if (active) setChangeCount(diffEditor?.getLineChanges()?.length ?? null)
+            if (!active || !diffEditor) return
+            const changes = diffEditor.getLineChanges()
+            setChangeCount(changes?.length ?? null)
+            if (!initialPositionApplied && changes !== null && requestedLine !== undefined) {
+              initialPositionApplied = true
+              const lineNumber = Math.max(
+                1,
+                Math.min(requestedLine, modifiedModel?.getLineCount() ?? 1)
+              )
+              const modifiedEditor = diffEditor.getModifiedEditor()
+              modifiedEditor.setPosition({ lineNumber, column: 1 })
+              modifiedEditor.revealLineInCenter(lineNumber)
+            }
           })
         )
-        if (savedStateRef.current) diffEditor.restoreViewState(savedStateRef.current)
+        diffEditor.setModel({ original: originalModel, modified: modifiedModel })
+        if (requestedLine === undefined && savedStateRef.current) {
+          diffEditor.restoreViewState(savedStateRef.current)
+        }
         const save = (): void => saveStateRef.current?.(diffEditor?.saveViewState() ?? null)
         scrollListeners.push(
           diffEditor.getOriginalEditor().onDidScrollChange(save),

package/src/client/l4_foundation/ui/code/l4-code-line-changes.ts

@@ -0,0 +1,49 @@
+import { DefaultLinesDiffComputer } from 'monaco-editor/editor/common/diff/defaultLinesDiffComputer/defaultLinesDiffComputer'
+
+export interface L4LineChange {
+  kind: 'added' | 'modified' | 'deleted'
+  originalStartLineNumber: number
+  originalEndLineNumberExclusive: number
+  modifiedStartLineNumber: number
+  modifiedEndLineNumberExclusive: number
+}
+
+/** 行号从 1 开始，结束行不包含在范围内；纯删除的 modified 范围为空。 */
+export function computeL4LineChanges(original: string, modified: string): L4LineChange[] | null {
+  if (original.length + modified.length > 2 * 1024 * 1024) return null
+  const originalLines = original.split(/\r\n|\r|\n/)
+  const modifiedLines = modified.split(/\r\n|\r|\n/)
+  if (originalLines.length + modifiedLines.length > 50_000) return null
+
+  try {
+    const startedAt = Date.now()
+    const result = new DefaultLinesDiffComputer().computeDiff(originalLines, modifiedLines, {
+      ignoreTrimWhitespace: false,
+      maxComputationTimeMs: 500,
+      computeMoves: false
+    })
+    if (result.hitTimeout || Date.now() - startedAt > 500) return null
+    return result.changes.map(({ original: before, modified: after }) => {
+      // Monaco 的空模型占一行，但空文件不应被归类为替换了这一行。
+      const originalEnd = original === '' ? 1 : before.endLineNumberExclusive
+      const modifiedEnd = modified === '' ? 1 : after.endLineNumberExclusive
+      return {
+        kind:
+          before.startLineNumber === originalEnd
+            ? 'added'
+            : after.startLineNumber === modifiedEnd
+              ? 'deleted'
+              : 'modified',
+        originalStartLineNumber: before.startLineNumber,
+        originalEndLineNumberExclusive: originalEnd,
+        modifiedStartLineNumber: after.startLineNumber,
+        modifiedEndLineNumberExclusive: modifiedEnd
+      }
+    })
+  } catch (error: unknown) {
+    console.warn('[Pi Desk][CodePreview] 行差异计算失败', {
+      errorName: error instanceof Error ? error.name : 'UnknownError'
+    })
+    return null
+  }
+}

package/src/client/l4_foundation/ui/code/l4-code-line-changes.worker.ts

@@ -0,0 +1,10 @@
+import { computeL4LineChanges, type L4LineChange } from './l4-code-line-changes'
+
+const scope = self as unknown as {
+  onmessage: ((event: MessageEvent<{ original: string; modified: string }>) => void) | null
+  postMessage: (changes: L4LineChange[] | null) => void
+}
+
+scope.onmessage = (event): void => {
+  scope.postMessage(computeL4LineChanges(event.data.original, event.data.modified))
+}

package/src/client/l4_foundation/ui/code/l4-code-line-markers.module.css

@@ -0,0 +1,60 @@
+.host {
+  --git-added: #16803c;
+  --git-modified: #216bcc;
+  --git-deleted: #d12c38;
+}
+
+:global(.dark) .host {
+  --git-added: #59c77b;
+  --git-modified: #6aabff;
+  --git-deleted: #ff757f;
+}
+
+.added,
+.modified,
+.deletedBefore,
+.deletedAfter {
+  /* 实际移动命中区，保持点击相对元素左缘小于 4px，避免触发 Monaco 折叠。 */
+  margin-left: 8px;
+  width: 4px !important;
+  z-index: 1;
+  cursor: pointer;
+}
+
+.added::before,
+.modified::before {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  width: 3px;
+  content: '';
+}
+
+.added::before {
+  background: var(--git-added);
+}
+
+.modified::before {
+  background: var(--git-modified);
+}
+
+.deletedBefore::before,
+.deletedAfter::before {
+  position: absolute;
+  left: 0;
+  width: 0;
+  height: 0;
+  border-top: 4px solid transparent;
+  border-bottom: 4px solid transparent;
+  border-left: 4px solid var(--git-deleted);
+  content: '';
+}
+
+.deletedBefore::before {
+  top: -3px;
+}
+
+.deletedAfter::before {
+  bottom: -3px;
+}

package/src/client/l4_foundation/ui/code/l4-code-line-markers.ts

@@ -0,0 +1,156 @@
+import type { editor } from 'monaco-editor'
+import type { L4Monaco } from './l4-monaco-runtime'
+import type { L4LineChange } from './l4-code-line-changes'
+import styles from './l4-code-line-markers.module.css'
+
+export interface L4CodeLineMarkers {
+  previousChange: () => void
+  nextChange: () => void
+  dispose: () => void
+}
+
+export function bindL4CodeLineMarkers(
+  codeEditor: editor.IStandaloneCodeEditor,
+  monaco: L4Monaco,
+  input: {
+    path: string
+    original: string
+    modified: string
+    tooltip: (kind: L4LineChange['kind'], count: number) => string
+    onChanges: (count: number | null) => void
+    onOpenDiff: (lineNumber: number) => void
+  }
+): L4CodeLineMarkers {
+  const decorations = codeEditor.createDecorationsCollection()
+  const lineCount = codeEditor.getModel()?.getLineCount() ?? 1
+  let changes: L4LineChange[] = []
+  let active = true
+  let worker: Worker | null = null
+  let timeout: ReturnType<typeof setTimeout> | null = null
+  const markerSelector = [styles.added, styles.modified, styles.deletedBefore, styles.deletedAfter]
+    .map((className) => `.${className}`)
+    .join(',')
+
+  const markerLine = (change: L4LineChange): number =>
+    Math.min(
+      lineCount,
+      change.kind === 'deleted'
+        ? Math.max(1, change.modifiedStartLineNumber - 1)
+        : change.modifiedStartLineNumber
+    )
+
+  const stopWorker = (): void => {
+    if (timeout !== null) clearTimeout(timeout)
+    timeout = null
+    worker?.terminate()
+    worker = null
+  }
+
+  const finish = (result: L4LineChange[] | null): void => {
+    if (!active) return
+    stopWorker()
+    changes = result ?? []
+    decorations.set(
+      changes.map((change): editor.IModelDeltaDecoration => {
+        const deleted = change.kind === 'deleted'
+        const startLine = markerLine(change)
+        const endLine = deleted ? startLine : change.modifiedEndLineNumberExclusive - 1
+        const count = deleted
+          ? change.originalEndLineNumberExclusive - change.originalStartLineNumber
+          : change.modifiedEndLineNumberExclusive - change.modifiedStartLineNumber
+        const colors = {
+          added: ['#16803c', '#59c77b'],
+          modified: ['#216bcc', '#6aabff'],
+          deleted: ['#d12c38', '#ff757f']
+        }[change.kind]
+        const markerClass = deleted
+          ? change.modifiedStartLineNumber === 1
+            ? styles.deletedBefore
+            : styles.deletedAfter
+          : styles[change.kind]
+        return {
+          range: new monaco.Range(startLine, 1, endLine, 1),
+          options: {
+            isWholeLine: !deleted,
+            showIfCollapsed: true,
+            linesDecorationsClassName: deleted ? undefined : markerClass,
+            firstLineDecorationClassName: deleted ? markerClass : undefined,
+            linesDecorationsTooltip: input.tooltip(change.kind, count),
+            overviewRuler: {
+              color: colors[0],
+              darkColor: colors[1],
+              position: monaco.editor.OverviewRulerLane.Left
+            }
+          }
+        }
+      })
+    )
+    if (result === null) {
+      console.warn('[Pi Desk][CodePreview] 行标记不可用，计算失败或超过限制', {
+        path: input.path
+      })
+    }
+    input.onChanges(result?.length ?? null)
+  }
+
+  const mouseListener = codeEditor.onMouseDown((event) => {
+    if (
+      event.target.type !== monaco.editor.MouseTargetType.GUTTER_LINE_DECORATIONS ||
+      !event.target.element?.closest(markerSelector)
+    ) {
+      return
+    }
+    const line = event.target.position?.lineNumber
+    if (line === undefined) return
+    const change = changes.find((item) =>
+      item.kind === 'deleted'
+        ? markerLine(item) === line
+        : item.modifiedStartLineNumber <= line && line < item.modifiedEndLineNumberExclusive
+    )
+    if (change) input.onOpenDiff(line)
+  })
+
+  try {
+    worker = new Worker(new URL('./l4-code-line-changes.worker.ts', import.meta.url), {
+      type: 'module',
+      name: 'pi-desk-line-changes'
+    })
+    worker.onmessage = (event: MessageEvent<L4LineChange[] | null>): void => finish(event.data)
+    worker.onerror = (): void => finish(null)
+    worker.onmessageerror = (): void => finish(null)
+    // 含 Worker 启动预算；取消时终止 Worker，旧文件结果没有回流通道。
+    timeout = setTimeout(() => finish(null), 3_000)
+    worker.postMessage({ original: input.original, modified: input.modified })
+  } catch {
+    finish(null)
+  }
+
+  const navigate = (direction: 'previous' | 'next'): void => {
+    if (changes.length === 0) return
+    const currentLine = codeEditor.getPosition()?.lineNumber ?? 1
+    const lines = changes.map(markerLine)
+    const line =
+      direction === 'next'
+        ? (lines.find((item) => item > currentLine) ?? lines[0])
+        : (lines.findLast((item) => item < currentLine) ?? lines[lines.length - 1])
+    codeEditor.setPosition({ lineNumber: line, column: 1 })
+    codeEditor.revealLineInCenter(line)
+    codeEditor.focus()
+  }
+
+  return {
+    previousChange(): void {
+      navigate('previous')
+    },
+    nextChange(): void {
+      navigate('next')
+    },
+    dispose(): void {
+      active = false
+      stopWorker()
+      mouseListener.dispose()
+      decorations.clear()
+      changes = []
+    }
+  }
+}

package/src/client/l4_foundation/ui/code/l4-code-preview.tsx

@@ -23,6 +23,8 @@ import {
 
 import { bindL4MonacoPreviewEscape } from './l4-monaco-preview-escape'
 import { useL4CodePreferences } from './l4-code-preferences'
+import { bindL4CodeLineMarkers, type L4CodeLineMarkers } from './l4-code-line-markers'
+import markerStyles from './l4-code-line-markers.module.css'
 
 export type L4CodePreviewState = editor.ICodeEditorViewState
 
@@ -32,6 +34,8 @@ export interface L4CodePreviewHandle {
   getSelectionText: () => string
   getViewState: () => L4CodePreviewState | null
   focus: () => void
+  previousChange: () => void
+  nextChange: () => void
 }
 
 interface L4CodePreviewProps {
@@ -41,13 +45,27 @@ interface L4CodePreviewProps {
   savedState: L4CodePreviewState | null
   onSaveState: (path: string, state: L4CodePreviewState | null) => void
   onEscape?: () => void
+  originalContent?: string
+  onChanges?: (count: number | null) => void
+  onOpenDiff?: (lineNumber: number) => void
 }
 
 function L4CodePreviewComponent(
-  { path, content, size, savedState, onSaveState, onEscape }: L4CodePreviewProps,
+  {
+    path,
+    content,
+    size,
+    savedState,
+    onSaveState,
+    onEscape,
+    originalContent,
+    onChanges,
+    onOpenDiff
+  }: L4CodePreviewProps,
   ref: ForwardedRef<L4CodePreviewHandle>
 ): React.JSX.Element {
   const { t } = useTranslation('common')
+  const { t: projectFilesT } = useTranslation('projectFiles')
   const { wrapLines } = useL4CodePreferences()
   const hostRef = useRef<HTMLDivElement>(null)
   const editorRef = useRef<editor.IStandaloneCodeEditor | null>(null)
@@ -55,11 +73,16 @@ function L4CodePreviewComponent(
   const wrapLinesRef = useRef(wrapLines)
   const savedStateRef = useRef(savedState)
   const escapeRef = useRef(onEscape)
+  const markersRef = useRef<L4CodeLineMarkers | null>(null)
+  const changesRef = useRef(onChanges)
+  const openDiffRef = useRef(onOpenDiff)
 
   useEffect(() => {
     savedStateRef.current = savedState
     escapeRef.current = onEscape
-  }, [onEscape, savedState])
+    changesRef.current = onChanges
+    openDiffRef.current = onOpenDiff
+  }, [onChanges, onEscape, onOpenDiff, savedState])
   const [loadState, setLoadState] = useState<'loading' | 'ready' | 'error'>('loading')
 
   useEffect(() => {
@@ -90,6 +113,12 @@ function L4CodePreviewComponent(
       },
       focus(): void {
         editorRef.current?.focus()
+      },
+      previousChange(): void {
+        markersRef.current?.previousChange()
+      },
+      nextChange(): void {
+        markersRef.current?.nextChange()
       }
     }),
     []
@@ -101,6 +130,7 @@ function L4CodePreviewComponent(
     let active = true
     let codeEditor: editor.IStandaloneCodeEditor | null = null
     let model: editor.ITextModel | null = null
+    let markers: L4CodeLineMarkers | null = null
     let stopThemeObserver = (): void => undefined
     let stopTypographyObserver = (): void => undefined
 
@@ -131,6 +161,7 @@ function L4CodePreviewComponent(
           wrappingIndent: 'same',
           ...getL4MonacoTypography(),
           lineNumbersMinChars: 3,
+          lineDecorationsWidth: 26,
           folding: size <= 1024 * 1024,
           renderValidationDecorations: 'off',
           renderWhitespace: 'selection',
@@ -145,6 +176,25 @@ function L4CodePreviewComponent(
         if (escapeRef.current)
           bindL4MonacoPreviewEscape(codeEditor, monaco.KeyCode.Escape, () => escapeRef.current?.())
         editorRef.current = codeEditor
+        if (originalContent !== undefined) {
+          markers = bindL4CodeLineMarkers(codeEditor, monaco, {
+            path,
+            original: originalContent,
+            modified: content,
+            tooltip: (kind, count) =>
+              projectFilesT(
+                {
+                  added: 'gitAddedLines',
+                  modified: 'gitModifiedLines',
+                  deleted: 'gitDeletedLines'
+                }[kind],
+                { count }
+              ),
+            onChanges: (count) => changesRef.current?.(count),
+            onOpenDiff: (lineNumber) => openDiffRef.current?.(lineNumber)
+          })
+          markersRef.current = markers
+        }
         stopThemeObserver = observeL4MonacoTheme((theme) => monaco.editor.setTheme(theme))
         stopTypographyObserver = observeL4MonacoTypography((typography) =>
           codeEditor?.updateOptions(typography)
@@ -158,18 +208,24 @@ function L4CodePreviewComponent(
           errorName: error instanceof Error ? error.name : 'UnknownError'
         })
         setLoadState('error')
+        if (originalContent !== undefined) changesRef.current?.(null)
       })
 
     return () => {
       active = false
       stopThemeObserver()
       stopTypographyObserver()
-      if (codeEditor) onSaveStateRef.current(path, codeEditor.saveViewState())
+      markers?.dispose()
+      markersRef.current = null
+      if (codeEditor) {
+        savedStateRef.current = codeEditor.saveViewState()
+        onSaveStateRef.current(path, savedStateRef.current)
+      }
       editorRef.current = null
       codeEditor?.dispose()
       model?.dispose()
     }
-  }, [content, path, size, t])
+  }, [content, originalContent, path, projectFilesT, size, t])
 
   useEffect(() => {
     editorRef.current?.updateOptions({ wordWrap: wrapLines ? 'on' : 'off' })
@@ -180,7 +236,7 @@ function L4CodePreviewComponent(
       data-testid="code-preview"
       className="relative h-full min-h-0 w-full overflow-hidden bg-background"
     >
-      <div ref={hostRef} className="size-full" />
+      <div ref={hostRef} className={`size-full ${markerStyles.host}`} />
       {loadState === 'loading' ? (
         <div className="pointer-events-none absolute inset-0 flex items-center justify-center gap-2 bg-background text-sm text-muted-foreground">
           <LoaderCircleIcon className="size-4 animate-spin" /> {t('codeLoading')}

package/src/client/l4_foundation/ui/code/l4-monaco-lines-diff.d.ts

@@ -0,0 +1,21 @@
+declare module 'monaco-editor/editor/common/diff/defaultLinesDiffComputer/defaultLinesDiffComputer' {
+  interface LineRange {
+    startLineNumber: number
+    endLineNumberExclusive: number
+  }
+
+  export class DefaultLinesDiffComputer {
+    computeDiff(
+      originalLines: string[],
+      modifiedLines: string[],
+      options: {
+        ignoreTrimWhitespace: boolean
+        maxComputationTimeMs: number
+        computeMoves: boolean
+      }
+    ): {
+      changes: { original: LineRange; modified: LineRange }[]
+      hitTimeout: boolean
+    }
+  }
+}

package/src/common/l3_modules/project-files/l3-project-files-locale-messages.ts

@@ -45,6 +45,14 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     copyContentFailed: 'Could not copy the file. Please copy it manually.',
     fileActions: 'File actions',
     headToWorking: 'HEAD ↔ working tree',
+    gitChangesCount: 'Against HEAD · {{count}} changes',
+    gitChangesCompact: '{{count}} changes',
+    gitMarkersLoading: 'Comparing with HEAD…',
+    gitMarkersFailed: 'Could not read changes · Reload to retry',
+    gitMarkersUnavailable: 'Line change markers unavailable',
+    gitAddedLines: '{{count}} lines added',
+    gitModifiedLines: '{{count}} lines modified',
+    gitDeletedLines: '{{count}} lines deleted',
     noDiffChanges: ' · No content differences',
     previousChange: 'Previous change',
     nextChange: 'Next change',
@@ -131,6 +139,14 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     copyContentFailed: '复制文件内容失败，请手动复制。',
     fileActions: '文件操作',
     headToWorking: 'HEAD ↔ 工作区',
+    gitChangesCount: '相对 HEAD · {{count}} 处变更',
+    gitChangesCompact: '{{count}} 处变更',
+    gitMarkersLoading: '正在与 HEAD 比较…',
+    gitMarkersFailed: '变更读取失败 · 刷新重试',
+    gitMarkersUnavailable: '此文件无法显示行变更',
+    gitAddedLines: '新增 {{count}} 行',
+    gitModifiedLines: '修改 {{count}} 行',
+    gitDeletedLines: '删除 {{count}} 行',
     noDiffChanges: ' · 当前比较无内容差异',
     previousChange: '上一个变更',
     nextChange: '下一个变更',

package/src/server/l4_foundation/pidesk/l4-pidesk-runtime.ts

@@ -60,7 +60,7 @@ export async function initializeL4PiDeskCommands(
   const sdkRoot = dirname(
     dirname(createRequire(join(hostRoot, 'package.json')).resolve('@jetcrab/pi-desk-sdk'))
   )
-  const docsDirectory = join(hostRoot, 'docs', 'pi-desk')
+  const docsDirectory = join(hostRoot, 'docs')
   await Promise.all(
     ['README.md', 'commands.md', 'plugins.md'].map((file) => access(join(docsDirectory, file)))
   )

package/temp/build/pi-desk/release/.next/BUILD_ID

@@ -1 +1 @@
-NwX_o5zDfv-NABRLmLIjY
+-pemk30NXpiExEU5tjb1t