@jetcrab/pi-desk 1.1.18-dev → 1.1.21

package/src/client/l4_foundation/ui/markdown/l4-markdown-remark.ts

@@ -0,0 +1,89 @@
+export const L4_MARKDOWN_ALLOWED_TAGS = {
+  input: ['dataPiMarkdownProgress'],
+  blockquote: ['dataPiMarkdownAlert']
+}
+
+// 仅描述本转换读取的 mdast 字段，不引入另一套解析器或运行依赖。
+interface MarkdownNode {
+  type: string
+  value?: string
+  children?: MarkdownNode[]
+  position?: { start: { offset?: number } }
+  data?: {
+    hName?: string
+    hProperties?: Record<string, string | boolean | string[]>
+  }
+}
+
+function statusNode(marker: string): MarkdownNode {
+  return {
+    type: 'paragraph',
+    children: [],
+    data: {
+      hName: 'input',
+      hProperties: {
+        type: 'checkbox',
+        disabled: true,
+        checked: marker.toLowerCase() === '[x]',
+        ...(marker === '[-]' ? { dataPiMarkdownProgress: 'true' } : {})
+      }
+    }
+  }
+}
+
+export function remarkL4Markdown(): (tree: MarkdownNode, file: { value: unknown }) => void {
+  return (tree, file): void => {
+    const source = String(file.value)
+    const isLiteral = (node: MarkdownNode, marker: string): boolean => {
+      const start = node.position?.start.offset
+      return start !== undefined && source.slice(start, start + marker.length) === marker
+    }
+
+    const visit = (node: MarkdownNode): void => {
+      const first = node.children?.[0]
+      if (node.type === 'tableCell' && node.children?.length === 1 && first?.type === 'text') {
+        const marker = first.value ?? ''
+        if (/^\[[ xX-]\]$/.test(marker) && isLiteral(first, marker)) {
+          node.children = [statusNode(marker)]
+        }
+      } else if (node.type === 'listItem' && first?.type === 'paragraph') {
+        const text = first.children?.[0]
+        if (
+          text?.type === 'text' &&
+          /^\[-\](?:\s|$)/.test(text.value ?? '') &&
+          isLiteral(text, '[-]')
+        ) {
+          text.value = text.value!.slice(3)
+          first.children!.unshift(statusNode('[-]'))
+          node.data = { ...node.data, hProperties: { className: ['task-list-item'] } }
+        }
+      } else if (node.type === 'blockquote' && first?.type === 'paragraph') {
+        const text = first.children?.[0]
+        const match = text?.value?.match(
+          /^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\][ \t]*(?:\r?\n|$)/
+        )
+        if (
+          text?.type === 'text' &&
+          match &&
+          isLiteral(text, `[!${match[1]}]`) &&
+          (match[0].endsWith('\n') ||
+            first.children!.length === 1 ||
+            first.children![1]?.type === 'break')
+        ) {
+          text.value = text.value!.slice(match[0].length)
+          if (!text.value) {
+            first.children!.shift()
+            if (first.children![0]?.type === 'break') first.children!.shift()
+          }
+          if (first.children!.length === 0) node.children!.shift()
+          node.data = {
+            ...node.data,
+            hProperties: { dataPiMarkdownAlert: match[1]!.toLowerCase() }
+          }
+        }
+      }
+      for (const child of node.children ?? []) visit(child)
+    }
+    visit(tree)
+  }
+}

package/src/client/l4_foundation/ui/markdown/l4-markdown.module.css

@@ -0,0 +1,58 @@
+.markdown :global(.task-list-item) {
+  list-style: none;
+}
+
+.status {
+  display: inline-flex;
+  position: relative;
+  width: 1rem;
+  height: 1rem;
+  align-items: center;
+  justify-content: center;
+  border: 1px solid var(--muted-foreground);
+  border-radius: 0.25rem;
+  vertical-align: -0.125rem;
+  color: var(--foreground);
+}
+
+.status[data-state='completed'] {
+  border-color: var(--foreground);
+  background: var(--foreground);
+  color: var(--background);
+}
+
+.status svg {
+  width: 0.875rem;
+  height: 0.875rem;
+  stroke-width: 2;
+}
+
+.alert {
+  margin-block: 0.75rem;
+  border-left: 3px solid var(--muted-foreground);
+  padding: 0.5rem 0.875rem;
+  color: var(--foreground);
+  font-style: normal;
+}
+
+.alertTitle {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.375rem;
+  font-weight: 600;
+}
+
+.alertTitle svg {
+  width: 1rem;
+  height: 1rem;
+  flex: none;
+}
+
+.alertBody > * {
+  margin-block: 0;
+}
+
+.alertBody > * + * {
+  margin-block-start: 0.5rem;
+}

package/src/client/l4_foundation/ui/markdown/l4-markdown.tsx

@@ -0,0 +1,108 @@
+'use client'
+
+import {
+  CheckIcon,
+  InfoIcon,
+  LightbulbIcon,
+  MessageSquareWarningIcon,
+  MinusIcon,
+  OctagonAlertIcon,
+  TriangleAlertIcon
+} from 'lucide-react'
+import type { ComponentProps } from 'react'
+import { useTranslation } from 'react-i18next'
+import { defaultRemarkPlugins, type Components, type StreamdownProps } from 'streamdown'
+import { cn } from '@client/l4_foundation/lib/l4-utils'
+import { remarkL4Markdown } from './l4-markdown-remark'
+import styles from './l4-markdown.module.css'
+
+export { L4_MARKDOWN_ALLOWED_TAGS } from './l4-markdown-remark'
+
+export const L4_MARKDOWN_REMARK_PLUGINS: NonNullable<StreamdownProps['remarkPlugins']> = [
+  ...Object.values(defaultRemarkPlugins),
+  remarkL4Markdown
+]
+export const L4_MARKDOWN_CLASS_NAME = styles.markdown
+
+const alerts = {
+  note: { icon: InfoIcon, label: 'markdownNote' },
+  tip: { icon: LightbulbIcon, label: 'markdownTip' },
+  important: { icon: MessageSquareWarningIcon, label: 'markdownImportant' },
+  warning: { icon: TriangleAlertIcon, label: 'markdownWarning' },
+  caution: { icon: OctagonAlertIcon, label: 'markdownCaution' }
+} as const
+
+function MarkdownStatus({
+  'data-pi-markdown-progress': progress,
+  ...props
+}: ComponentProps<'input'> & {
+  node?: unknown
+  'data-pi-markdown-progress'?: string
+}): React.JSX.Element {
+  const { t } = useTranslation('common')
+  delete props.node
+  if (props.type !== 'checkbox') return <input {...props} />
+  const state = progress ? 'progress' : props.checked ? 'completed' : 'pending'
+  const marker = progress ? '[-]' : props.checked ? '[x]' : '[ ]'
+  const label = t(
+    progress ? 'markdownProgress' : props.checked ? 'markdownCompleted' : 'markdownPending'
+  )
+
+  return (
+    <span className={styles.status} data-state={state} role="img" aria-label={label} title={label}>
+      {progress ? (
+        <MinusIcon aria-hidden="true" />
+      ) : props.checked ? (
+        <CheckIcon aria-hidden="true" />
+      ) : null}
+      <span className="sr-only" aria-hidden="true">
+        {marker}
+      </span>
+    </span>
+  )
+}
+
+function MarkdownBlockquote({
+  'data-pi-markdown-alert': kind,
+  className,
+  children,
+  ...props
+}: ComponentProps<'blockquote'> & {
+  node?: unknown
+  'data-pi-markdown-alert'?: string
+}): React.JSX.Element {
+  const { t } = useTranslation('common')
+  delete props.node
+  const alert = Object.entries(alerts).find(([name]) => name === kind)?.[1]
+
+  if (!alert) {
+    return (
+      <blockquote
+        {...props}
+        data-streamdown="blockquote"
+        className={cn(
+          'my-4 border-muted-foreground/30 border-l-4 pl-4 text-muted-foreground italic',
+          className
+        )}
+      >
+        {children}
+      </blockquote>
+    )
+  }
+
+  const Icon = alert.icon
+  return (
+    <aside className={styles.alert} role="note" aria-label={t(alert.label)}>
+      <div className={styles.alertTitle}>
+        <Icon aria-hidden="true" />
+        {t(alert.label)}
+      </div>
+      <div className={styles.alertBody}>{children}</div>
+    </aside>
+  )
+}
+
+export const L4_MARKDOWN_COMPONENTS: Components = {
+  input: MarkdownStatus,
+  blockquote: MarkdownBlockquote
+}

package/src/common/l2_biz/auth/l2-auth-return-to.ts

@@ -0,0 +1,41 @@
+function hasControlCharacters(value: string): boolean {
+  return Array.from(value).some((character) => {
+    const code = character.charCodeAt(0)
+    return code <= 0x1f || (code >= 0x7f && code <= 0x9f)
+  })
+}
+
+export function L2ResolveAuthReturnTo(value: unknown): string {
+  if (
+    typeof value !== 'string' ||
+    !value.startsWith('/') ||
+    value.startsWith('//') ||
+    value.includes('\\') ||
+    hasControlCharacters(value)
+  ) {
+    return '/'
+  }
+
+  let pathname: string
+  try {
+    pathname = decodeURIComponent(value.split(/[?#]/, 1)[0])
+    if (hasControlCharacters(decodeURIComponent(value))) return '/'
+  } catch {
+    return '/'
+  }
+  if (pathname.startsWith('//') || pathname.includes('\\')) return '/'
+
+  const segments: string[] = []
+  for (const segment of pathname.split('/')) {
+    if (segment === '..') segments.pop()
+    else if (segment !== '' && segment !== '.') segments.push(segment)
+  }
+  if (segments.join('/').toLowerCase() === 'login') return '/'
+
+  return value
+}
+
+export function L2BuildLoginHref(returnTo: unknown): string {
+  const target = L2ResolveAuthReturnTo(returnTo)
+  return target === '/' ? '/login' : `/login?returnTo=${encodeURIComponent(target)}`
+}

package/src/common/l2_biz/model-settings/l2-model-settings-contract.ts

@@ -222,7 +222,11 @@ export const L2ModelSettingsPreviewResponseSchema = z
   .object({
     projectDefaults: z.array(
       z
-        .object({ cwd: L3PiCwdSchema, from: L2ModelSelectionSchema, to: L2ModelSelectionSchema })
+        .object({
+          cwd: L3PiCwdSchema,
+          from: L2ModelSelectionSchema,
+          to: L2ModelSelectionSchema.nullable()
+        })
         .strict()
     )
   })

package/src/common/l2_biz/plugin/l2-plugin-management-messages.ts

@@ -87,6 +87,8 @@ export const L2_PLUGIN_MANAGEMENT_MESSAGES = {
     contributionSettings: 'Settings page',
     contributionMessage: 'Message view',
     contributionSidebar: 'Session sidebar',
+    contributionWidget: 'Composer widget',
+    contributionSessionHeader: 'Session header item',
     tagTools: '{{count}} tools',
     tagFixed: '{{count}} fixed prompts',
     tagDynamic: '{{count}} dynamic hooks',
@@ -324,6 +326,8 @@ export const L2_PLUGIN_MANAGEMENT_MESSAGES = {
     contributionSettings: '设置页',
     contributionMessage: '消息视图',
     contributionSidebar: '会话侧栏',
+    contributionWidget: '输入区挂件',
+    contributionSessionHeader: '会话标题项',
     tagTools: '工具 {{count}}',
     tagFixed: '固定提示 {{count}}',
     tagDynamic: '动态影响 {{count}}',

package/src/common/l2_biz/project-preview/l2-project-history-messages.ts

@@ -1,5 +1,19 @@
 export const L2_PROJECT_HISTORY_MESSAGES = {
   en: {
+    chooseProject: 'Open a project',
+    switchProject: 'Switch project',
+    directoryPath: 'Directory path',
+    directoryPlaceholder: 'Enter an absolute directory path',
+    serverDirectoryHint: 'Browse directories on the connected server.',
+    openProject: 'Open',
+    recentProjects: 'Project history',
+    browseDirectories: 'Browse directories',
+    loadingDirectories: 'Loading directories…',
+    parentDirectory: 'Parent directory',
+    directoryRoots: 'Directories',
+    openThisDirectory: 'Open this directory',
+    noSubdirectories: 'No subdirectories',
+    noRecentProjects: 'No project history. Enter a path or browse directories.',
     currentHead: 'Current HEAD',
     localBranch: 'Local branch',
     remoteBranch: 'Remote branch · local record',
@@ -76,6 +90,20 @@ export const L2_PROJECT_HISTORY_MESSAGES = {
     historyReadFailed: 'Could not read Git history'
   },
   'zh-CN': {
+    chooseProject: '打开项目',
+    switchProject: '切换项目',
+    directoryPath: '目录路径',
+    directoryPlaceholder: '输入完整目录路径',
+    serverDirectoryHint: '选择所连接服务上的目录。',
+    openProject: '打开',
+    recentProjects: '历史项目',
+    browseDirectories: '浏览目录',
+    loadingDirectories: '正在读取目录…',
+    parentDirectory: '上级目录',
+    directoryRoots: '目录',
+    openThisDirectory: '打开此目录',
+    noSubdirectories: '没有子目录',
+    noRecentProjects: '没有历史项目，可输入路径或浏览目录。',
     currentHead: '当前 HEAD',
     localBranch: '本地分支',
     remoteBranch: '远程分支 · 本地记录',

package/src/common/l2_biz/project-preview/l2-project-preview-navigation.ts

@@ -0,0 +1,5 @@
+export const L2_PROJECT_PREVIEW_PATH = '/project-preview'
+
+export function buildL2ProjectPreviewHref(cwd?: string | null): string {
+  return cwd ? `${L2_PROJECT_PREVIEW_PATH}?cwd=${encodeURIComponent(cwd)}` : L2_PROJECT_PREVIEW_PATH
+}

package/src/common/l2_biz/settings/l2-settings-messages.ts

@@ -110,7 +110,8 @@ export const L2_SETTINGS_MESSAGES = {
     removeAndSave: 'Remove and save',
     replaceProjectDefaultsTitle: 'Update project default models',
     replaceProjectDefaultsDescription:
-      'The following projects will use the new model settings. Confirm to save all changes together.',
+      'The following project defaults will be updated or cleared. Confirm to save all changes together.',
+    clearProjectDefault: 'Clear project default',
     confirmAndSaveModels: 'Confirm and save',
     modelSaved: 'Model configuration saved.',
     modelSaveFailed: 'Could not save the model configuration',
@@ -405,8 +406,8 @@ export const L2_SETTINGS_MESSAGES = {
       '有 {{count}} 个常用组合引用了已删除模型，保存配置将同时删除这些组合。',
     removeAndSave: '删除并保存',
     replaceProjectDefaultsTitle: '同步项目默认模型',
-    replaceProjectDefaultsDescription:
-      '以下项目的默认模型将替换为本次设置的新模型，确认后一起保存。',
+    replaceProjectDefaultsDescription: '以下项目默认将更新或清除，确认后一起保存。',
+    clearProjectDefault: '清除项目默认',
     confirmAndSaveModels: '确认并保存',
     modelSaved: '模型配置已保存。',
     modelSaveFailed: '模型配置保存失败',

package/src/common/l2_biz/work-session/l2-work-session-file-contract.ts

@@ -10,6 +10,7 @@ import {
   L4ProjectFileEntrySchema,
   L4ProjectFileListSchema,
   L4ProjectFileSearchSchema,
+  L4ProjectSearchInputSchema,
   L4ProjectFileContentSchema,
   L4ProjectDirectoryPathSchema,
   L4ProjectFileImageMimeTypeSchema,
@@ -47,9 +48,9 @@ export const L2WorkSessionFileListRequestSchema = L2WorkSessionFileProjectRefSch
 
 export const L2WorkSessionFileListResponseSchema = L4ProjectFileListSchema
 
-export const L2WorkSessionFileSearchRequestSchema = L2WorkSessionFileProjectRefSchema.extend({
-  query: z.string().trim().min(1).max(200)
-}).strict()
+export const L2WorkSessionFileSearchRequestSchema = L2WorkSessionFileProjectRefSchema.extend(
+  L4ProjectSearchInputSchema.shape
+).strict()
 
 export const L2WorkSessionFileSearchResponseSchema = L4ProjectFileSearchSchema
 

package/src/common/l2_biz/workbench/l2-workbench-locale-messages.ts

@@ -202,6 +202,9 @@ export const L2_WORKBENCH_LOCALE_MESSAGES = {
     deleteSessionTitle: 'Delete work session',
     copyProjectPath: 'Copy project path',
     renameSessionTitle: 'Edit title',
+    reloadChatData: 'Reload chat data',
+    reloadChatDataFailed: 'Could not reload chat data',
+    reloadChatSourceChanged: 'The session has changed. Select it again.',
     sessionTitleLabel: 'Session title',
     renameSessionFailed: 'Could not save the session title',
     sidebarSessions: 'Work sessions',
@@ -209,6 +212,7 @@ export const L2_WORKBENCH_LOCALE_MESSAGES = {
     sidebarReplaceSession: 'Replace work session',
     createSession: 'Create work session',
     projectPreview: 'Project preview',
+    projectPreviewWindow: 'Open in new window',
     refreshFiles: 'Refresh project files',
     pinnedBelow: 'Pinned below',
     settings: 'Settings',
@@ -645,6 +649,9 @@ export const L2_WORKBENCH_LOCALE_MESSAGES = {
     deleteSessionTitle: '删除工作会话',
     copyProjectPath: '复制项目路径',
     renameSessionTitle: '修改标题',
+    reloadChatData: '重新加载聊天数据',
+    reloadChatDataFailed: '重新加载聊天数据失败',
+    reloadChatSourceChanged: '会话已变化，请重新选择会话',
     sessionTitleLabel: '会话标题',
     renameSessionFailed: '保存会话标题失败',
     sidebarSessions: '工作会话',
@@ -652,6 +659,7 @@ export const L2_WORKBENCH_LOCALE_MESSAGES = {
     sidebarReplaceSession: '替换工作会话',
     createSession: '新建工作会话',
     projectPreview: '项目预览',
+    projectPreviewWindow: '在新窗口打开',
     refreshFiles: '刷新项目文件',
     pinnedBelow: '以下固定',
     settings: '设置',

package/src/common/l3_modules/project-files/l3-project-files-contract.ts

@@ -6,6 +6,7 @@ import {
   L4ProjectFileImagePreviewModeSchema,
   L4ProjectFileListSchema,
   L4ProjectFileSearchSchema,
+  L4ProjectSearchInputSchema,
   L4ProjectFileContentSchema
 } from '@common/l4_foundation/file/l4-project-file-contract'
 import {
@@ -67,9 +68,7 @@ export const L3ProjectFileList = {
 } as const
 export const L3ProjectFileSearch = {
   path: '/api/project-files/search',
-  request: L3ProjectReadContextSchema.extend({
-    query: z.string().trim().min(1).max(200)
-  }).strict(),
+  request: L3ProjectReadContextSchema.extend(L4ProjectSearchInputSchema.shape).strict(),
   response: L4ProjectFileSearchSchema
 } as const
 export const L3ProjectFileGet = {

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

@@ -19,16 +19,39 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     sessionDirectory: 'Original folder',
     unavailable: 'Unavailable',
     projectFiles: '{{name}} project files',
-    searchFiles: 'Search filenames',
-    closeSearch: 'Close file search',
+    searchFiles: 'Search filenames or paths',
+    searchAll: 'Search files or content',
+    searchContent: 'Search file content',
+    searchScope: 'Search scope',
+    searchScopeAll: 'All',
+    searchScopeFiles: 'Files',
+    searchScopeContent: 'Content',
+    searchCaseSensitive: 'Match case',
+    searchWholeWord: 'Match whole word',
+    searchRegex: 'Use regular expression',
+    searchResults: 'Search results',
+    searchStart: 'Search this project',
+    searchTryOptions: 'Try another query or adjust the search options.',
+    searchFailed: 'Could not search the project. Please try again.',
+    searchCounts: '{{files}} files · {{lines}} matching lines',
+    searchShownCounts: 'Shown: {{counts}}',
+    searchFileHeading: 'Filenames',
+    searchContentHeading: 'Content',
+    searchContentCounts: '{{lines}} matching lines · {{files}} files',
+    searchProjectRoot: 'Project root',
+    searchExpandFiles: 'Show {{count}} more files',
+    searchOpenLine: 'Open {{path}}, line {{line}}',
+    searchLineUnavailable: 'The file content has changed and the matching line no longer exists.',
+    searchTextLimit: 'Content search: previewable UTF-8 text up to 5 MiB.',
+    closeSearch: 'Exit search',
     layout: 'File organization',
     directory: 'Folders',
     repository: 'Repositories',
     changesOnly: 'Changes only',
-    searchProject: 'Search project files',
-    noMatches: 'No matching files',
+    searchProject: 'Search project',
+    noMatches: 'No matching results',
     searching: 'Searching…',
-    resultLimit: 'Showing the first 100 results.',
+    resultLimit: 'Results are limited. Refine your query or narrow the search scope.',
     copied: 'Copied.',
     copyFailed: 'Could not copy. Please try again.',
     revealRequested: 'Opened the system file manager.',
@@ -119,16 +142,39 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     sessionDirectory: '原目录',
     unavailable: '不可用',
     projectFiles: '{{name}} 项目文件',
-    searchFiles: '搜索文件名',
-    closeSearch: '关闭文件搜索',
+    searchFiles: '搜索文件名或路径',
+    searchAll: '搜索文件或内容',
+    searchContent: '搜索文件内容',
+    searchScope: '搜索范围',
+    searchScopeAll: '全部',
+    searchScopeFiles: '文件',
+    searchScopeContent: '内容',
+    searchCaseSensitive: '区分大小写',
+    searchWholeWord: '全词匹配',
+    searchRegex: '使用正则表达式',
+    searchResults: '搜索结果',
+    searchStart: '搜索这个项目',
+    searchTryOptions: '试试其他关键词，或调整搜索选项。',
+    searchFailed: '项目搜索失败，请重试。',
+    searchCounts: '{{files}} 个文件 · {{lines}} 个命中行',
+    searchShownCounts: '已显示：{{counts}}',
+    searchFileHeading: '文件名',
+    searchContentHeading: '内容',
+    searchContentCounts: '{{lines}} 个命中行 · {{files}} 个文件',
+    searchProjectRoot: '项目根目录',
+    searchExpandFiles: '展开其余 {{count}} 个文件',
+    searchOpenLine: '打开 {{path}} 第 {{line}} 行',
+    searchLineUnavailable: '文件内容已变化，搜索命中行已不存在',
+    searchTextLimit: '正文搜索：可预览的 UTF-8 文本，不超过 5 MiB。',
+    closeSearch: '退出搜索',
     layout: '文件组织方式',
     directory: '目录',
     repository: '仓库',
     changesOnly: '只看变更',
-    searchProject: '搜索项目文件',
-    noMatches: '没有匹配文件',
+    searchProject: '搜索项目',
+    noMatches: '没有匹配结果',
     searching: '正在搜索…',
-    resultLimit: '结果较多，仅显示前 100 条。',
+    resultLimit: '结果较多，已截断显示。请细化关键词或缩小搜索范围。',
     copied: '已复制。',
     copyFailed: '复制失败，请重试。',
     revealRequested: '已请求运行端文件管理器定位。',

package/src/common/l4_foundation/file/l4-project-file-contract.ts

@@ -3,6 +3,8 @@ import { z } from 'zod'
 export const L4_PROJECT_FILE_PATH_MAX_LENGTH = 4096
 export const L4_PROJECT_FILE_LIST_MAX_ENTRIES = 5000
 export const L4_PROJECT_FILE_SEARCH_MAX_RESULTS = 100
+export const L4_PROJECT_CONTENT_SEARCH_MAX_RESULTS = 200
+export const L4_PROJECT_SEARCH_TEXT_MAX_LENGTH = 1000
 export const L4_PROJECT_TEXT_FILE_MAX_BYTES = 5 * 1024 * 1024
 export const L4_PROJECT_CODE_PARSE_MAX_BYTES = 1024 * 1024
 export const L4_PROJECT_IMAGE_FILE_MAX_BYTES = 10 * 1024 * 1024
@@ -76,9 +78,53 @@ export const L4ProjectFileListSchema = z
   })
   .strict()
 
+export const L4ProjectSearchInputSchema = z
+  .object({
+    query: z
+      .string()
+      .min(1)
+      .max(200)
+      .refine(
+        (value) => value.trim().length > 0 && !/[\0\r\n]/.test(value),
+        '搜索词必须是非空单行文本'
+      ),
+    scope: z.enum(['all', 'files', 'content']).default('all'),
+    caseSensitive: z.boolean().default(false),
+    wholeWord: z.boolean().default(false),
+    regex: z.boolean().default(false)
+  })
+  .strict()
+
+export const L4ProjectSearchRangeSchema = z
+  .object({ start: z.number().int().nonnegative(), end: z.number().int().nonnegative() })
+  .strict()
+  .refine((range) => range.start <= range.end, '搜索命中区间无效')
+
+export const L4ProjectFileMatchSchema = z
+  .object({ path: L4ProjectFilePathSchema, ranges: z.array(L4ProjectSearchRangeSchema) })
+  .strict()
+  .refine(
+    (match) => match.ranges.every((range) => range.end <= match.path.length),
+    '文件名命中区间越界'
+  )
+
+export const L4ProjectContentMatchSchema = z
+  .object({
+    path: L4ProjectFilePathSchema,
+    line: z.number().int().positive(),
+    text: z.string().max(L4_PROJECT_SEARCH_TEXT_MAX_LENGTH),
+    ranges: z.array(L4ProjectSearchRangeSchema)
+  })
+  .strict()
+  .refine(
+    (match) => match.ranges.every((range) => range.end <= match.text.length),
+    '正文命中区间越界'
+  )
+
 export const L4ProjectFileSearchSchema = z
   .object({
-    matches: z.array(L4ProjectFilePathSchema).max(L4_PROJECT_FILE_SEARCH_MAX_RESULTS),
+    fileMatches: z.array(L4ProjectFileMatchSchema).max(L4_PROJECT_FILE_SEARCH_MAX_RESULTS),
+    contentMatches: z.array(L4ProjectContentMatchSchema).max(L4_PROJECT_CONTENT_SEARCH_MAX_RESULTS),
     truncated: z.boolean()
   })
   .strict()
@@ -103,6 +149,10 @@ export const L4ProjectFileContentSchema = z.discriminatedUnion('kind', [
 
 export type L4ProjectFileEntry = z.infer<typeof L4ProjectFileEntrySchema>
 export type L4ProjectFileList = z.infer<typeof L4ProjectFileListSchema>
+export type L4ProjectSearchInput = z.infer<typeof L4ProjectSearchInputSchema>
+export type L4ProjectSearchRange = z.infer<typeof L4ProjectSearchRangeSchema>
+export type L4ProjectFileMatch = z.infer<typeof L4ProjectFileMatchSchema>
+export type L4ProjectContentMatch = z.infer<typeof L4ProjectContentMatchSchema>
 export type L4ProjectFileSearch = z.infer<typeof L4ProjectFileSearchSchema>
 export type L4ProjectFileContent = z.infer<typeof L4ProjectFileContentSchema>
 export type L4ProjectFileImagePreviewMode = z.infer<typeof L4ProjectFileImagePreviewModeSchema>

package/src/common/l4_foundation/locale/l4-host-error-messages.ts

@@ -15,6 +15,12 @@ export const L4_HOST_ERROR_MESSAGES = {
     imageTooLarge: 'This image is too large for online preview',
     previewUnsupported: 'This file type cannot be previewed online',
     fileReadFailed: 'Could not read the project file',
+    projectSearchPatternInvalid: 'The search expression is invalid or uses unsupported syntax',
+    projectSearchUnavailable:
+      'The project search engine is unavailable. Reinstall the complete runtime dependencies',
+    projectSearchTimeout: 'Project search timed out. Narrow the search scope and try again',
+    projectSearchReadFailed: 'Could not read project search files or results',
+    projectSearchCancelled: 'Project search was cancelled',
     revealFailed: 'Could not open the file location',
     repositoryMissing: 'Git repository not found',
     gitOutsideProject: 'The Git target is outside the current project',
@@ -169,6 +175,11 @@ export const L4_HOST_ERROR_MESSAGES = {
     imageTooLarge: '图片过大，暂不支持在线预览',
     previewUnsupported: '当前文件类型不支持在线预览',
     fileReadFailed: '读取项目文件失败',
+    projectSearchPatternInvalid: '搜索表达式无效或包含不支持的语法',
+    projectSearchUnavailable: '项目搜索引擎不可用，请重新安装完整运行依赖',
+    projectSearchTimeout: '项目搜索超时，请缩小搜索范围后重试',
+    projectSearchReadFailed: '无法读取项目搜索文件或结果',
+    projectSearchCancelled: '项目搜索已取消',
     revealFailed: '打开所在文件夹失败',
     repositoryMissing: 'Git 仓库不存在',
     gitOutsideProject: 'Git 目标不在当前项目目录内',