RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.
Go agent-harnessagent-native-databaseagentic-aiagentic-retrievalagentic-searchaiai-agentscontext-enginecontext-engineeringcontext-managementharness-engineeringknowledge-compilationragretrieval-augmented-generationretrieval-harnesssearch-harness
import { fireEvent, render, screen } from '@testing-library/react';
import { FormProvider, useForm } from 'react-hook-form';
import message from '@/components/ui/message';
import { FileType } from '@/constants/file';
import { VisionEnhancementFormFields } from './vision-form-fields';
jest.mock('@/hooks/use-llm-request', () => ({
useFetchDefaultModelDictionary: () => ({ img2txt_id: 'model-A' }),
}));
jest.mock('@/components/ui/message', () => ({
__esModule: true,
default: { warning: jest.fn() },
}));
jest.mock('../../context', () => ({ useOwnerTenantId: () => 'tenant-1' }));
jest.mock('react-i18next', () => ({
useTranslation: () => ({ t: (key: string) => key }),
}));
jest.mock('@/components/ragflow-form', () => ({
RAGFlowFormItem: ({ name, children }: any) => {
const {
Controller,
useFormContext,
}: typeof import('react-hook-form') = require('react-hook-form');
const { control } = useFormContext();
return (
<Controller
name={name}
control={control}
render={({ field }) =>
typeof children === 'function' ? children(field) : children
}
/>
);
},
}));
jest.mock('@/components/model-tree-select', () => ({
ModelTypeMap: { img2txt_id: ['image2text'] },
ModelTreeSelectFormField: ({ name }: any) => {
const {
Controller,
useFormContext,
}: typeof import('react-hook-form') = require('react-hook-form');
const { control } = useFormContext();
return (
<Controller
name={name}
control={control}
render={({ field }) => (
<select aria-label="Vision model" {...field}>
<option value="">Default</option>
<option value="model-A">A</option>
<option value="model-B">B</option>
</select>
)}
/>
);
},
}));
function ParserVisionForm({ model = '' }: { model?: string }) {
const form = useForm({
defaultValues: {
enable_vision_enhancement: false,
vlm: { llm_id: model, system_prompt: '' },
},
});
return (
<FormProvider {...form}>
<VisionEnhancementFormFields />
</FormProvider>
);
}
describe('global vision model selection', () => {
it('offers the shared prompt only while enhancement is on', () => {
render(<ParserVisionForm />);
expect(
screen.queryByPlaceholderText('flow.systemPromptPlaceholder'),
).toBeNull();
fireEvent.click(screen.getByRole('switch'));
expect(
screen.getByPlaceholderText('flow.systemPromptPlaceholder'),
).toBeInTheDocument();
// Language has no control here on purpose: captions follow the knowledge
// base language, which also drives tokenization.
expect(screen.queryByLabelText('Vision language')).toBeNull();
});
it('selects default A on first enable and preserves user-selected B across toggles', () => {
render(<ParserVisionForm />);
fireEvent.click(screen.getByRole('switch'));
expect(screen.getByLabelText('Vision model')).toHaveValue('model-A');
fireEvent.change(screen.getByLabelText('Vision model'), {
target: { value: 'model-B' },
});
fireEvent.click(screen.getByRole('switch'));
expect(screen.queryByLabelText('Vision model')).not.toBeInTheDocument();
fireEvent.click(screen.getByRole('switch'));
expect(screen.getByLabelText('Vision model')).toHaveValue('model-B');
});
it('keeps saved model B when enhancement is enabled again', () => {
render(<ParserVisionForm model="model-B" />);
fireEvent.click(screen.getByRole('switch'));
expect(screen.getByLabelText('Vision model')).toHaveValue('model-B');
});
});
const visionWarningMock = message.warning as jest.Mock;
function ParserVisionFormWithImage({
ocrEnabled = false,
}: {
ocrEnabled?: boolean;
}) {
const form = useForm({
defaultValues: {
enable_vision_enhancement: true,
vlm: { llm_id: 'model-B', system_prompt: '' },
setups: [{ fileFormat: FileType.Image, ocr_enabled: ocrEnabled }],
},
});
return (
<FormProvider {...form}>
<VisionEnhancementFormFields />
</FormProvider>
);
}
describe('vision enhancement switch guard', () => {
beforeEach(() => {
visionWarningMock.mockClear();
});
it('blocks turning enhancement off while image OCR is off', () => {
render(<ParserVisionFormWithImage ocrEnabled={false} />);
fireEvent.click(screen.getByRole('switch'));
expect(visionWarningMock).toHaveBeenCalledWith(
'flow.imageTextSourceRequired',
);
// Still on: the model and prompt fields stay visible.
expect(screen.getByLabelText('Vision model')).toBeInTheDocument();
});
it('allows turning enhancement off while image OCR is on', () => {
render(<ParserVisionFormWithImage ocrEnabled={true} />);
fireEvent.click(screen.getByRole('switch'));
expect(visionWarningMock).not.toHaveBeenCalled();
expect(screen.queryByLabelText('Vision model')).not.toBeInTheDocument();
});
});