@skopon-cool/form-sdk 0.6.1 → 0.6.2

package/src/catalog/skoponSelectLoading.test.tsx

@@ -11,11 +11,12 @@ vi.mock('@a2ui/react/styles', () => ({
   removeStyles: vi.fn(),
 }))
 
-import { createElement } from 'react'
-import { render, cleanup, waitFor } from '@testing-library/react'
+import { createElement, createRef } from 'react'
+import { render, cleanup, waitFor, fireEvent } from '@testing-library/react'
 import { blocksToA2ui } from '../adapter/a2uiAdapter'
-import SkoponFormRenderer from '../components/SkoponFormRenderer'
+import SkoponFormRenderer, { type SkoponFormRendererRef } from '../components/SkoponFormRenderer'
 import type { CaseSearchFn } from './caseSearchContext'
+import type { ContentSearchFn } from './contentSearchContext'
 import type { ResumeSearchFn } from './resumeSearchContext'
 
 beforeAll(() => {
@@ -152,6 +153,9 @@ describe('case/resume select loading state', () => {
           resolveSearch = resolve
         }),
     )
+    const contentSearch: ContentSearchFn = vi.fn(
+      () => new Promise(() => {}),
+    )
 
     const doc = buildResumeSurface()
     const { rerender, queryByText } = render(
@@ -159,24 +163,99 @@ describe('case/resume select loading state', () => {
         doc,
         surfaceId: 'resume-loading-test',
         resumeSearch,
+        contentSearch,
       }),
     )
 
-    expect(queryByText('加载简历…')).toBeTruthy()
+    expect(queryByText('加载简历和内容…')).toBeTruthy()
 
     rerender(
       createElement(SkoponFormRenderer, {
         doc,
         surfaceId: 'resume-loading-test',
         resumeSearch: null,
+        contentSearch,
       }),
     )
 
     await waitFor(() => {
-      expect(queryByText('加载简历…')).toBeNull()
+      expect(queryByText('加载简历和内容…')).toBeNull()
     })
     expect(queryByText('未配置简历搜索服务')).toBeTruthy()
 
     resolveSearch({ list: [], total: 0, page: 1, pageSize: 20 })
   })
+
+  it('renders content tag labels on each resume-content card', async () => {
+    const resumeSearch: ResumeSearchFn = vi.fn(async () => ({
+      list: [{ resumeUniqueId: 'resume-1', name: '零食方案负责人' }],
+      total: 1,
+      page: 1,
+      pageSize: 20,
+    }))
+    const contentSearch: ContentSearchFn = vi.fn(async () => ({
+      list: [
+        {
+          flowUniqueId: 'flow-1',
+          name: '零食开箱流程',
+          title: '零食开箱测评',
+          tagLabels: ['1万–9.9万粉', '直播带货'],
+        },
+      ],
+      total: 1,
+      page: 1,
+      pageSize: 20,
+    }))
+
+    const { findByText } = render(
+      createElement(SkoponFormRenderer, {
+        doc: buildResumeSurface(),
+        surfaceId: 'resume-content-tags-test',
+        resumeSearch,
+        contentSearch,
+      }),
+    )
+
+    expect(await findByText('内容标签')).toBeTruthy()
+    expect(await findByText('1万–9.9万粉')).toBeTruthy()
+    expect(await findByText('直播带货')).toBeTruthy()
+  })
+  it('selects content without loading profiles, retains selections across pages and enforces max', async () => {
+    const resumeSearch = vi.fn(async () => { throw new Error('must not load profiles') })
+    const contentSearch: ContentSearchFn = vi.fn(async ({ page }) => ({
+      list: [1, 2].map(i => ({ flowUniqueId: `flow-${(page-1)*2+i}`, name: `内容${(page-1)*2+i}`, title: `内容${(page-1)*2+i}` })),
+      total: 4, page, pageSize: 2,
+    }))
+    const doc = blocksToA2ui({ title: '', description: '', blocks: [{
+      id: 'content', type: 'resume_multiselect', name: 'flows',
+      resumeDisplayMode: 'content-only', resumeDisplayCount: 2, resumeMaxCount: 2,
+      contentFilter: { pageSize: 2 },
+    }] }, { includeHeader: false })
+    const ref = createRef<SkoponFormRendererRef>()
+    const view = render(createElement(SkoponFormRenderer, { ref, doc, resumeSearch, contentSearch, fieldNames: ['flows'] }))
+    const one = await view.findByText('内容1')
+    expect(view.container.querySelector('.skopon-resume-select-card-person')).toBeNull()
+    expect(resumeSearch).not.toHaveBeenCalled()
+    fireEvent.click(one.closest('[role="button"]')!)
+    fireEvent.click(view.getByRole('button', { name: /换一批/ }))
+    const three = await view.findByText('内容3')
+    fireEvent.click(three.closest('[role="button"]')!)
+    expect(ref.current!.getValues().flows).toEqual(['flow-1', 'flow-3'])
+    expect(view.getByText('内容4').closest('[role="button"]')!.getAttribute('aria-disabled')).toBe('true')
+    fireEvent.click(view.getByRole('button', { name: /换一批/ }))
+    const back = await view.findByText('内容1')
+    expect(back.closest('[role="button"]')!.getAttribute('aria-pressed')).toBe('true')
+    fireEvent.click(back.closest('[role="button"]')!)
+    expect(ref.current!.getValues().flows).toEqual(['flow-3'])
+    expect(contentSearch).toHaveBeenCalledTimes(2)
+  })
+
+  it('renders content-only mode when no resume service is provided', async () => {
+    const contentSearch: ContentSearchFn = async () => ({list:[{flowUniqueId:'f',name:'内容',title:'独立内容'}],total:1,page:1,pageSize:20})
+    const doc=blocksToA2ui({title:'',description:'',blocks:[{id:'c',type:'resume_multiselect',name:'flows',resumeDisplayMode:'content-only'}]}, {includeHeader:false})
+    const view=render(createElement(SkoponFormRenderer,{doc,contentSearch}))
+    expect(await view.findByText('独立内容')).toBeTruthy()
+    expect(view.queryByText('未配置简历搜索服务')).toBeNull()
+  })
+
 })

package/src/client/contentSearchClient.test.ts

@@ -0,0 +1,123 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it, vi } from 'vitest'
+import { createContentSearchClient } from './contentSearchClient'
+
+function mockResponse(json: unknown): Response {
+  return {
+    ok: true,
+    status: 200,
+    headers: { get: () => 'application/json' },
+    json: async () => json,
+    text: async () => '',
+  } as Response
+}
+
+describe('createContentSearchClient', () => {
+  it('searches published content flows and maps the latest case', async () => {
+    const fetchMock = vi.fn(async () =>
+      mockResponse({
+        success: true,
+        data: {
+          list: [
+            {
+              flow_id: 7,
+              flow_unique_id: 'flow-1',
+              name: '口播流程',
+              tag_labels: ['1万–9.9万粉', '直播带货'],
+              cases: [
+                {
+                  name: '爆款口播',
+                  platform: '抖音',
+                  link: 'https://example/work',
+                  attachments_json: [
+                    { type: 'image', url: 'https://cdn/cover.png' },
+                    { type: 'video', url: 'https://cdn/clip.mp4' },
+                  ],
+                },
+              ],
+            },
+          ],
+          total: 40,
+          page: 1,
+          page_size: 20,
+        },
+      }),
+    ) as unknown as typeof fetch
+
+    const contentSearch = createContentSearchClient({
+      fetch: fetchMock,
+      baseUrl: '/api/v1',
+      getHeaders: async () => ({ Authorization: 'Bearer test' }),
+    })
+    const result = await contentSearch({
+      filter: { flowType: 'content-production', tagUniqueIds: ['tag-hot'], pageSize: 20 },
+      page: 1,
+    })
+
+    const [url, init] = fetchMock.mock.calls[0] as [string, RequestInit]
+    expect(url).toContain('/api/v1/univ/flow/list?')
+    expect(url).toContain('owner_scope=content')
+    expect(url).toContain('flow_type=content-production')
+    expect(url).toContain('published=1')
+    expect(url).toContain('tag_unique_ids=tag-hot')
+    expect(url).toContain('tag_match=all')
+    expect(init.headers).toEqual({ Authorization: 'Bearer test' })
+    expect(result.list[0]).toMatchObject({
+      flowUniqueId: 'flow-1',
+      title: '爆款口播',
+      coverUrl: 'https://cdn/cover.png',
+      mediaUrl: 'https://cdn/clip.mp4',
+      mediaKind: 'video',
+      tagLabels: ['1万–9.9万粉', '直播带货'],
+    })
+    expect(result.total).toBe(40)
+  })
+
+  it('uses one normally ordered server request for multi-tag any results', async () => {
+    const fetchMock = vi.fn(async (input: string | URL | Request) => {
+      const url = new URL(String(input), 'https://example.test')
+      return mockResponse({
+        success: true,
+        data: {
+          list: [
+            { flow_unique_id: 'flow-zero-1', name: '零粉一', tag_labels: ['0粉冷启动'], cases: [] },
+            { flow_unique_id: 'flow-999-1', name: '千粉内一', tag_labels: ['1–999粉'], cases: [] },
+            { flow_unique_id: 'flow-10k-1', name: '万粉一', tag_labels: ['1万–9.9万粉'], cases: [] },
+          ],
+          total: 5,
+          page: Number(url.searchParams.get('page')),
+          page_size: Number(url.searchParams.get('page_size')),
+        },
+      })
+    }) as unknown as typeof fetch
+    const contentSearch = createContentSearchClient({ fetch: fetchMock, baseUrl: '/api/v1' })
+
+    const result = await contentSearch({
+      filter: {
+        tagUniqueIds: ['tag-fans-zero', 'tag-fans-1-999', 'tag-fans-10k-99k'],
+        tagMatch: 'any',
+        pageSize: 5,
+      },
+      page: 1,
+    })
+
+    expect(fetchMock).toHaveBeenCalledTimes(1)
+    const [url] = fetchMock.mock.calls[0] as [string]
+    const params = new URL(url, 'https://example.test').searchParams
+    expect(params.getAll('tag_unique_ids')).toEqual([
+      'tag-fans-zero',
+      'tag-fans-1-999',
+      'tag-fans-10k-99k',
+    ])
+    expect(params.get('tag_match')).toBe('any')
+    expect(params.get('page_size')).toBe('5')
+    expect(result.list.map((item) => item.flowUniqueId)).toEqual([
+      'flow-zero-1',
+      'flow-999-1',
+      'flow-10k-1',
+    ])
+    expect(result.total).toBe(5)
+  })
+})

package/src/client/contentSearchClient.ts

@@ -0,0 +1,156 @@
+import type { FormContentFilter } from '../types/index'
+import type { ContentSearchFn, ContentSearchItem } from '../catalog/contentSearchContext'
+import { parseEnvelope } from './apiEnvelope'
+import {
+  type ClientHeadersOptions,
+  resolveClientHeaders,
+} from './authStorage'
+
+export const DEFAULT_CONTENT_FLOW_TYPE = 'content-production'
+
+export interface ContentSearchClientOptions extends ClientHeadersOptions {
+  baseUrl?: string
+  listPath?: string
+  fetch?: typeof fetch
+  /** 默认 1（已发布） */
+  published?: number
+}
+
+interface ContentAttachmentDto {
+  type?: string
+  url?: string
+  dataUrl?: string
+  data_url?: string
+  mime_type?: string
+  mimeType?: string
+}
+
+interface ContentCaseDto {
+  name?: string
+  link?: string
+  platform?: string | null
+  attachments_json?: ContentAttachmentDto[]
+}
+
+interface ContentFlowDto {
+  flow_id?: number
+  flow_unique_id: string
+  name?: string
+  description?: string | null
+  tag_labels?: string[]
+  cases?: ContentCaseDto[]
+}
+
+interface PagedListDto<T> {
+  list: T[]
+  total: number
+  page: number
+  page_size: number
+}
+
+function attachmentRows(attachments: ContentAttachmentDto[] | undefined) {
+  return (attachments ?? [])
+    .map((row) => {
+      const mime = (row.mime_type ?? row.mimeType ?? '').trim().toLowerCase()
+      const declared = (row.type ?? '').trim().toLowerCase()
+      const type = declared || (mime.startsWith('video/') ? 'video' : mime.startsWith('image/') ? 'image' : '')
+      const url = (row.url ?? row.dataUrl ?? row.data_url ?? '').trim()
+      return { type, mime, url }
+    })
+    .filter((row) => row.url)
+}
+
+function isVideo(row: { type: string; mime: string }): boolean {
+  return row.type === 'video' || row.type === '视频' || row.mime.startsWith('video/')
+}
+
+function isImage(row: { type: string; mime: string }): boolean {
+  return row.type === 'image' || row.type === '图片' || row.mime.startsWith('image/') || row.type === ''
+}
+
+function mediaFromAttachments(attachments: ContentAttachmentDto[] | undefined): {
+  coverUrl: string | null
+  mediaUrl: string | null
+  mediaKind: 'video' | 'image' | null
+} {
+  const rows = attachmentRows(attachments)
+  const video = rows.find(isVideo)
+  const image = rows.find(isImage)
+  if (video) {
+    return { coverUrl: image?.url ?? null, mediaUrl: video.url, mediaKind: 'video' }
+  }
+  if (image) {
+    return { coverUrl: image.url, mediaUrl: null, mediaKind: 'image' }
+  }
+  return { coverUrl: null, mediaUrl: null, mediaKind: null }
+}
+
+export function mapContentFlow(dto: ContentFlowDto): ContentSearchItem {
+  const flowName = dto.name?.trim() || '未命名内容'
+  const latest = dto.cases?.[0]
+  const caseName = latest?.name?.trim()
+  const media = mediaFromAttachments(latest?.attachments_json)
+  return {
+    flowUniqueId: dto.flow_unique_id,
+    flowId: dto.flow_id,
+    name: flowName,
+    description: dto.description ?? undefined,
+    tagLabels: (dto.tag_labels ?? []).map(String).map((item) => item.trim()).filter(Boolean),
+    title: caseName || flowName,
+    platform: latest?.platform ?? null,
+    coverUrl: media.coverUrl,
+    mediaUrl: media.mediaUrl,
+    mediaKind: media.mediaKind,
+    link: latest?.link,
+  }
+}
+
+function buildContentListQuery(
+  filter: FormContentFilter,
+  page: number,
+  published: number,
+): URLSearchParams {
+  const params = new URLSearchParams()
+  params.set('page', String(page))
+  params.set('page_size', String(filter.pageSize ?? 20))
+  params.set('owner_scope', 'content')
+  params.set('published', String(published))
+  params.set('flow_type', (filter.flowType ?? DEFAULT_CONTENT_FLOW_TYPE).trim() || DEFAULT_CONTENT_FLOW_TYPE)
+  if (filter.category?.trim()) params.set('category_unique_id', filter.category.trim())
+  for (const id of filter.tagUniqueIds ?? []) {
+    if (id) params.append('tag_unique_ids', id)
+  }
+  params.set('tag_match', filter.tagMatch === 'any' ? 'any' : 'all')
+  return params
+}
+
+export function createContentSearchClient(
+  options: ContentSearchClientOptions = {},
+): ContentSearchFn {
+  const baseUrl = (options.baseUrl ?? '/api/v1').replace(/\/$/, '')
+  const listPath = options.listPath ?? '/univ/flow/list'
+  const fetchFn = options.fetch ?? fetch
+  const published = options.published ?? 1
+
+  return async ({ filter, page }) => {
+    const headers = await resolveClientHeaders(options)
+    const requestPage = async (requestFilter: FormContentFilter) => {
+      const params = buildContentListQuery(requestFilter, page, published)
+      const response = await fetchFn(`${baseUrl}${listPath}?${params.toString()}`, {
+        method: 'GET',
+        headers,
+      })
+      return parseEnvelope<PagedListDto<ContentFlowDto>>(response)
+    }
+
+    // 多标签 any 查询由服务端一次完成，并沿用 Flow 的正常排序与分页。
+    // 不要在客户端按标签拆请求，否则一个 9 标签分组每次换批会放大成 9 次请求。
+    const data = await requestPage(filter)
+    return {
+      list: (data.list ?? []).map(mapContentFlow),
+      total: data.total ?? 0,
+      page: data.page ?? page,
+      pageSize: data.page_size ?? filter.pageSize ?? 20,
+    }
+  }
+}

package/src/client/resumeSearchClient.test.ts

@@ -56,7 +56,9 @@ describe('createResumeSearchClient', () => {
     const result = await resumeSearch({
       filter: {
         names: ['导演'],
+        agentKind: 'director',
         agentUniqueIds: ['agent-1'],
+        tagUniqueIds: ['tag-a', 'tag-b'],
         resumeUniqueIds: ['resume-abc'],
         pageSize: 20,
       },
@@ -68,6 +70,9 @@ describe('createResumeSearchClient', () => {
     expect(url).toContain('/api/v1/univ/resume/search?')
     expect(url).toContain('name=%E5%AF%BC%E6%BC%94')
     expect(url).toContain('agent_unique_id=agent-1')
+    expect(url).toContain('agent_type=director')
+    expect(url).toContain('tag_unique_ids=tag-a')
+    expect(url).toContain('tag_unique_ids=tag-b')
     expect(url).toContain('resume_unique_id=resume-abc')
     expect(url).toContain('published=1')
     expect(init.headers).toEqual({ Authorization: 'Bearer test' })

package/src/client/resumeSearchClient.ts

@@ -80,6 +80,11 @@ function buildResumeSearchQuery(
   for (const id of filter.agentUniqueIds ?? []) {
     if (id) params.append('agent_unique_id', id)
   }
+  const agentType = filter.agentKind?.trim()
+  if (agentType) params.append('agent_type', agentType)
+  for (const id of filter.tagUniqueIds ?? []) {
+    if (id) params.append('tag_unique_ids', id)
+  }
   for (const id of filter.resumeUniqueIds ?? []) {
     if (id) params.append('resume_unique_id', id)
   }

package/src/client/skoponSdkClients.ts

@@ -1,7 +1,9 @@
 import { createCaseSearchClient, type CaseSearchClientOptions } from './caseSearchClient'
+import { createContentSearchClient, type ContentSearchClientOptions } from './contentSearchClient'
 import { createFormClient, type FormClient, type FormClientOptions } from './formClient'
 import { createResumeSearchClient, type ResumeSearchClientOptions } from './resumeSearchClient'
 import type { CaseSearchFn } from '../catalog/caseSearchContext'
+import type { ContentSearchFn } from '../catalog/contentSearchContext'
 import type { ResumeSearchFn } from '../catalog/resumeSearchContext'
 import type { SkoponAuthStorageOptions } from './authStorage'
 
@@ -12,12 +14,14 @@ export interface SkoponSdkClientsOptions {
   authStorage?: SkoponAuthStorageOptions
   form?: Pick<FormClientOptions, 'detailPath'>
   resume?: Pick<ResumeSearchClientOptions, 'searchPath' | 'published'>
+  content?: Pick<ContentSearchClientOptions, 'listPath' | 'published'>
   case?: Pick<CaseSearchClientOptions, 'listPath' | 'published'>
 }
 
 export interface SkoponSdkClients {
   fetchDetail: FormClient['fetchDetail']
   resumeSearch: ResumeSearchFn
+  contentSearch: ContentSearchFn
   caseSearch: CaseSearchFn
 }
 
@@ -43,6 +47,11 @@ export function createSkoponSdkClients(
       searchPath: options.resume?.searchPath,
       published: options.resume?.published,
     }),
+    contentSearch: createContentSearchClient({
+      ...shared,
+      listPath: options.content?.listPath,
+      published: options.content?.published,
+    }),
     caseSearch: createCaseSearchClient({
       ...shared,
       listPath: options.case?.listPath,

package/src/components/AskUserFormCard.tsx

@@ -27,6 +27,7 @@ import {
 } from '../submit/submitAnswerAgent'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { CaseSearchFn } from '../catalog/caseSearchContext'
+import type { ContentSearchFn } from '../catalog/contentSearchContext'
 import type { ResumeSearchFn } from '../catalog/resumeSearchContext'
 import { FormRuntimeProvider, useFormRuntime } from '../runtime/formRuntimeContext'
 import { FormRuntimeWsClient } from '../runtime/formRuntimeWs'
@@ -75,6 +76,8 @@ export interface AskUserFormCardProps {
   onNotify?: (type: 'success' | 'error', message: string) => void
   /** 简历多选组件：注入搜索函数 */
   resumeSearch?: ResumeSearchFn | null
+  /** 简历多选组件：内容制作搜索 */
+  contentSearch?: ContentSearchFn | null
   /** 案例单选组件：注入搜索函数 */
   caseSearch?: CaseSearchFn | null
 }
@@ -95,6 +98,7 @@ function AskUserFormCardBody({
   fetchFormDetail,
   onNotify,
   resumeSearch = null,
+  contentSearch = null,
   caseSearch = null,
   onSurfaceReadyChange,
   onAutoControlReady,
@@ -491,6 +495,7 @@ function AskUserFormCardBody({
         interactive
         wrapProvider={false}
         resumeSearch={resumeSearch}
+        contentSearch={contentSearch}
         caseSearch={caseSearch}
         onUploadingChange={setUploading}
       />

package/src/components/SkoponA2uiStreamRenderer.tsx

@@ -7,6 +7,7 @@ import { buildSkoponCatalog } from '../catalog/a2uiCustomCatalog'
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
 import { FileUploadStatusProvider } from '../catalog/fileUploadStatusContext'
 import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
+import { ContentSearchProvider, type ContentSearchFn } from '../catalog/contentSearchContext'
 import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
 import SkoponFormProvider from './SkoponFormProvider'
 
@@ -18,6 +19,8 @@ export interface SkoponA2uiStreamRendererProps {
   interactive?: boolean
   /** 简历多选组件：注入搜索函数 */
   resumeSearch?: ResumeSearchFn | null
+  /** 简历多选组件：内容制作搜索 */
+  contentSearch?: ContentSearchFn | null
   /** 案例单选组件：注入搜索函数 */
   caseSearch?: CaseSearchFn | null
 }
@@ -32,6 +35,7 @@ export default function SkoponA2uiStreamRenderer({
   emptyHint = null,
   interactive = true,
   resumeSearch = null,
+  contentSearch = null,
   caseSearch = null,
 }: SkoponA2uiStreamRendererProps) {
   useEffect(() => {
@@ -185,15 +189,17 @@ export default function SkoponA2uiStreamRenderer({
     <SkoponFormProvider>
       <FileUploadStatusProvider>
         <ResumeSearchProvider resumeSearch={resumeSearch}>
-          <CaseSearchProvider caseSearch={caseSearch}>
-            <A2uiPreviewModeProvider interactive={interactive}>
-              <div className="a2ui-surface a2ui-container">
-                {surfaces.map((surface) => (
-                  <A2uiSurface key={surface.id} surface={surface} />
-                ))}
-              </div>
-            </A2uiPreviewModeProvider>
-          </CaseSearchProvider>
+          <ContentSearchProvider contentSearch={contentSearch}>
+            <CaseSearchProvider caseSearch={caseSearch}>
+              <A2uiPreviewModeProvider interactive={interactive}>
+                <div className="a2ui-surface a2ui-container">
+                  {surfaces.map((surface) => (
+                    <A2uiSurface key={surface.id} surface={surface} />
+                  ))}
+                </div>
+              </A2uiPreviewModeProvider>
+            </CaseSearchProvider>
+          </ContentSearchProvider>
         </ResumeSearchProvider>
       </FileUploadStatusProvider>
     </SkoponFormProvider>

package/src/components/SkoponFormRenderer.tsx

@@ -17,6 +17,7 @@ import { SKOPON_CATALOG_ID, buildSkoponCatalog } from '../catalog/a2uiCustomCata
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
 import { FileUploadStatusProvider } from '../catalog/fileUploadStatusContext'
 import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
+import { ContentSearchProvider, type ContentSearchFn } from '../catalog/contentSearchContext'
 import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
 import SkoponFormProvider from './SkoponFormProvider'
 
@@ -34,6 +35,8 @@ export interface SkoponFormRendererProps {
   fieldNames?: string[]
   /** 简历多选组件：注入搜索函数 */
   resumeSearch?: ResumeSearchFn | null
+  /** 简历多选组件：内容制作搜索 */
+  contentSearch?: ContentSearchFn | null
   /** 案例单选组件：注入搜索函数 */
   caseSearch?: CaseSearchFn | null
   /** 任意文件上传任务的聚合状态 */
@@ -51,6 +54,7 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
       interactive = true,
       fieldNames = [],
       resumeSearch = null,
+      contentSearch = null,
       caseSearch = null,
       onUploadingChange,
       wrapProvider = true,
@@ -128,9 +132,11 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
       const empty = (
         <FileUploadStatusProvider onUploadingChange={onUploadingChange}>
           <ResumeSearchProvider resumeSearch={resumeSearch}>
-            <CaseSearchProvider caseSearch={caseSearch}>
-              <A2uiPreviewModeProvider interactive={interactive}>{emptyHint}</A2uiPreviewModeProvider>
-            </CaseSearchProvider>
+            <ContentSearchProvider contentSearch={contentSearch}>
+              <CaseSearchProvider caseSearch={caseSearch}>
+                <A2uiPreviewModeProvider interactive={interactive}>{emptyHint}</A2uiPreviewModeProvider>
+              </CaseSearchProvider>
+            </ContentSearchProvider>
           </ResumeSearchProvider>
         </FileUploadStatusProvider>
       )
@@ -140,15 +146,17 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
     const content = (
       <FileUploadStatusProvider onUploadingChange={onUploadingChange}>
         <ResumeSearchProvider resumeSearch={resumeSearch}>
-          <CaseSearchProvider caseSearch={caseSearch}>
-            <A2uiPreviewModeProvider interactive={interactive}>
-              <div className="a2ui-surface a2ui-container">
-                {surfaces.map((surface) => (
-                  <A2uiSurface key={surface.id} surface={surface} />
-                ))}
-              </div>
-            </A2uiPreviewModeProvider>
-          </CaseSearchProvider>
+          <ContentSearchProvider contentSearch={contentSearch}>
+            <CaseSearchProvider caseSearch={caseSearch}>
+              <A2uiPreviewModeProvider interactive={interactive}>
+                <div className="a2ui-surface a2ui-container">
+                  {surfaces.map((surface) => (
+                    <A2uiSurface key={surface.id} surface={surface} />
+                  ))}
+                </div>
+              </A2uiPreviewModeProvider>
+            </CaseSearchProvider>
+          </ContentSearchProvider>
         </ResumeSearchProvider>
       </FileUploadStatusProvider>
     )

package/src/index.ts

@@ -8,6 +8,7 @@ export type {
   FormBlockOption,
   FormBlockType,
   FormCaseFilter,
+  FormContentFilter,
   FormConditionOperator,
   FormDefinitionPayload,
   FormDetailResult,
@@ -124,6 +125,11 @@ export {
   createResumeSearchClient,
   type ResumeSearchClientOptions,
 } from './client/resumeSearchClient'
+export {
+  createContentSearchClient,
+  DEFAULT_CONTENT_FLOW_TYPE,
+  type ContentSearchClientOptions,
+} from './client/contentSearchClient'
 export {
   createCaseSearchClient,
   type CaseSearchClientOptions,
@@ -137,6 +143,7 @@ export {
 export { default as SkoponFormRenderer } from './components/SkoponFormRenderer'
 export type { SkoponFormRendererProps, SkoponFormRendererRef } from './components/SkoponFormRenderer'
 export type { ResumeSearchFn as SkoponResumeSearchFn } from './catalog/resumeSearchContext'
+export type { ContentSearchFn as SkoponContentSearchFn } from './catalog/contentSearchContext'
 export type { CaseSearchFn as SkoponCaseSearchFn } from './catalog/caseSearchContext'
 
 export { default as SkoponA2uiStreamRenderer } from './components/SkoponA2uiStreamRenderer'
@@ -155,6 +162,15 @@ export { antdTheme as skoponAntdTheme } from './theme/antd-theme'
 export { brandColors as skoponBrandColors } from './theme/brand-colors'
 
 
+export {
+  ContentSearchProvider,
+  useContentSearch,
+  type ContentSearchFn,
+  type ContentSearchItem,
+  type ContentSearchParams,
+  type ContentSearchResult,
+} from './catalog/contentSearchContext'
+
 export {
   ResumeSearchProvider,
   useResumeSearch,