feat: Implement FAQ functionality in Knowledge Base

- Added support for creating and managing FAQ knowledge bases, including new API endpoints for listing, upserting, updating, and deleting FAQ entries.
- Enhanced the frontend to allow users to create FAQ knowledge bases and manage FAQ entries with a dedicated interface.
- Introduced new types and configurations for FAQ handling in the backend, ensuring proper indexing and retrieval of FAQ entries.
- Updated localization files to include new strings related to FAQ management in multiple languages.
- Refactored existing components to accommodate the new FAQ features, improving user experience and functionality.
This commit is contained in:
wizardchen
2025-11-15 01:30:17 +08:00
parent 0ea5e6a2a2
commit 25fdaed8ca
37 changed files with 4778 additions and 198 deletions
+41
View File
@@ -8,6 +8,7 @@ export function listKnowledgeBases() {
export function createKnowledgeBase(data: {
name: string;
description?: string;
type?: 'document' | 'faq';
chunking_config?: any;
embedding_model_id?: string;
summary_model_id?: string;
@@ -16,6 +17,7 @@ export function createKnowledgeBase(data: {
vlm_config?: any;
cos_config?: any;
extract_config?: any;
faq_config?: { index_mode: string; question_index_mode?: string };
}) {
return post(`/api/v1/knowledge-bases`, data);
}
@@ -76,4 +78,43 @@ export function getKnowledgeDetailsCon(id: string, page: number) {
// Get chunk by chunk_id only (new endpoint - to be added to backend)
export function getChunkByIdOnly(chunkId: string) {
return get(`/api/v1/chunks/by-id/${chunkId}`);
}
const buildQuery = (params?: Record<string, any>) => {
if (!params) return '';
const query = new URLSearchParams();
Object.entries(params).forEach(([key, value]) => {
if (value === undefined || value === null || value === '') return;
query.append(key, String(value));
});
const queryString = query.toString();
return queryString ? `?${queryString}` : '';
};
export function listFAQEntries(kbId: string, params?: { page?: number; page_size?: number }) {
const query = buildQuery(params);
return get(`/api/v1/knowledge-bases/${kbId}/faq/entries${query}`);
}
export function upsertFAQEntries(kbId: string, data: { entries: any[]; mode: 'append' | 'replace' }) {
return post(`/api/v1/knowledge-bases/${kbId}/faq/entries`, data);
}
export function updateFAQEntry(kbId: string, entryId: string, data: any) {
return put(`/api/v1/knowledge-bases/${kbId}/faq/entries/${entryId}`, data);
}
export function deleteFAQEntries(kbId: string, ids: string[]) {
return del(`/api/v1/knowledge-bases/${kbId}/faq/entries`, { ids });
}
export function searchFAQEntries(
kbId: string,
data: {
query_text: string
vector_threshold?: number
match_count?: number
}
) {
return post(`/api/v1/knowledge-bases/${kbId}/faq/search`, data);
}
+80 -2
View File
@@ -482,6 +482,7 @@ export default {
refresh: 'Refresh',
loading: 'Loading...',
noData: 'No data',
noMoreData: 'All content loaded',
error: 'Error',
success: 'Success',
warning: 'Warning',
@@ -658,6 +659,7 @@ export default {
},
knowledgeList: {
create: 'Create Knowledge Base',
createFAQ: 'Create FAQ Knowledge Base',
uninitializedBanner: 'Some knowledge bases are not initialized. Configure model information in settings before adding documents.',
empty: {
title: 'No knowledge bases yet',
@@ -680,11 +682,16 @@ export default {
basic: 'Basic Information',
models: 'Model Configuration',
chunking: 'Chunking Settings',
advanced: 'Advanced Settings'
advanced: 'Advanced Settings',
faq: 'FAQ Settings'
},
basic: {
title: 'Basic Information',
description: 'Configure the knowledge base name and description',
typeLabel: 'Knowledge Base Type',
typeDocument: 'Document-based',
typeFAQ: 'FAQ Q&A',
typeDescription: 'FAQ suits structured Q&A datasets; document type supports file parsing and chunking.',
nameLabel: 'Knowledge Base Name',
namePlaceholder: 'Enter knowledge base name',
descriptionLabel: 'Knowledge Base Description',
@@ -706,7 +713,78 @@ export default {
createFailed: 'Failed to create knowledge base',
missingId: 'Knowledge base ID is missing',
buildDataFailed: 'Failed to construct submission data',
updateSuccess: 'Configuration saved successfully'
updateSuccess: 'Configuration saved successfully',
indexModeRequired: 'Please select an indexing mode for FAQ knowledge bases'
},
faq: {
title: 'FAQ Configuration',
description: 'Configure indexing strategy and guidance for FAQ-style knowledge bases',
indexModeLabel: 'Indexing Mode',
indexModeDescription: 'Question-only indexing improves precision, question+answer improves recall.',
questionIndexModeLabel: 'Question Indexing Mode',
questionIndexModeDescription: 'Combined: Standard and similar questions are indexed together. Separate: Each question is indexed independently for more precise retrieval but requires more storage.',
entryGuide: 'Each FAQ entry contains a primary question, similar questions, negative examples, and multiple answers. Manage them in the FAQ knowledge base detail view.',
modes: {
questionOnly: 'Questions only',
questionAnswer: 'Question + answer',
combined: 'Combined',
separate: 'Separate'
},
standardQuestion: 'Primary Question',
answers: 'Answers',
similarQuestions: 'Similar Questions',
negativeQuestions: 'Negative Examples',
editorCreate: 'Create FAQ Entry',
editorEdit: 'Edit FAQ Entry',
addAnswer: 'Add Answer',
answerPlaceholder: 'Enter answer content, supports multi-line text, press Ctrl+Enter or click button to add',
similarPlaceholder: 'Enter similar question and click plus icon to add',
negativePlaceholder: 'Enter negative example and click plus icon to add',
answerRequired: 'Please provide at least one answer',
noAnswer: 'No answers',
noSimilar: 'No similar questions',
noNegative: 'No negative examples',
emptyTitle: 'No FAQ entries',
emptyDesc: 'Click "Create FAQ Entry" above to get started',
searchTest: 'Search Test',
searchTestTitle: 'FAQ Search Test',
queryLabel: 'Query',
queryPlaceholder: 'Enter a question to search',
vectorThresholdLabel: 'Vector Similarity Threshold',
vectorThresholdDesc: 'Range 0-1, default 0.7',
keywordThresholdLabel: 'Keyword Match Threshold',
keywordThresholdDesc: 'Range 0-1, default 0.5',
matchCountLabel: 'Result Count',
matchCountDesc: 'Range 1-50, default 10',
searchButton: 'Search',
searching: 'Searching...',
searchResults: 'Search Results',
noResults: 'No matching FAQ entries found',
score: 'Similarity',
matchType: 'Match Type',
matchTypeEmbedding: 'Vector Match',
matchTypeKeywords: 'Keyword Match',
similarityThresholdLabel: 'Similarity Threshold',
},
faqImport: {
title: 'Batch Import FAQ',
modeLabel: 'Import Mode',
appendMode: 'Append',
replaceMode: 'Replace existing entries',
fileLabel: 'Select File',
fileTip: 'Supports JSON / CSV / Excel with fields standard_question, answers, similar_questions, negative_questions',
clickToUpload: 'Click to upload file',
dragDropTip: 'or drag and drop file here',
importButton: 'Import FAQ',
deleteSelected: 'Delete Selected',
deleteSuccess: 'Selected entries deleted',
previewCount: '{count} entries parsed',
previewMore: '{count} more entries not shown',
importSuccess: 'Import completed',
parseFailed: 'Failed to parse file',
invalidJSON: 'Invalid JSON format',
unsupportedFormat: 'Unsupported file format',
selectFile: 'Please select a file to import first',
},
models: {
title: 'Model Configuration',
+80 -2
View File
@@ -481,6 +481,7 @@ export default {
refresh: 'Обновить',
loading: 'Загрузка...',
noData: 'Нет данных',
noMoreData: 'Весь контент загружен',
error: 'Ошибка',
success: 'Успешно',
warning: 'Предупреждение',
@@ -747,6 +748,7 @@ export default {
},
knowledgeList: {
create: 'Создать базу знаний',
createFAQ: 'Создать FAQ-базу',
uninitializedBanner: 'Некоторые базы знаний не инициализированы. Сначала настройте модели в разделе настроек, чтобы добавлять документы.',
empty: {
title: 'Базы знаний отсутствуют',
@@ -769,11 +771,16 @@ export default {
basic: 'Основная информация',
models: 'Конфигурация моделей',
chunking: 'Настройки разбиения',
advanced: 'Дополнительные настройки'
advanced: 'Дополнительные настройки',
faq: 'FAQ настройки'
},
basic: {
title: 'Основная информация',
description: 'Укажите название и описание базы знаний',
typeLabel: 'Тип базы знаний',
typeDocument: 'Документальная',
typeFAQ: 'FAQ (вопрос-ответ)',
typeDescription: 'FAQ подходит для структурированных Q&A; документальный тип поддерживает загрузку файлов и разбиение.',
nameLabel: 'Название базы знаний',
namePlaceholder: 'Введите название базы знаний',
descriptionLabel: 'Описание базы знаний',
@@ -795,7 +802,78 @@ export default {
createFailed: 'Не удалось создать базу знаний',
missingId: 'Отсутствует ID базы знаний',
buildDataFailed: 'Не удалось сформировать данные для отправки',
updateSuccess: 'Настройки сохранены'
updateSuccess: 'Настройки сохранены',
indexModeRequired: 'Выберите режим индексации для FAQ базы знаний'
},
faq: {
title: 'Настройки FAQ',
description: 'Определите стратегию индексации и общие правила для FAQ-базы знаний',
indexModeLabel: 'Режим индексации',
indexModeDescription: 'Только вопросы дают более высокую точность, вопросы+ответы повышают полноту выдачи.',
questionIndexModeLabel: 'Режим индексации вопросов',
questionIndexModeDescription: 'Объединенная: стандартные и похожие вопросы индексируются вместе. Раздельная: каждый вопрос индексируется независимо для более точного поиска, но требует больше места.',
entryGuide: 'Каждый FAQ включает основной вопрос, похожие вопросы, негативные примеры и несколько ответов. Управляйте ими в деталях FAQ-базы.',
modes: {
questionOnly: 'Только вопросы',
questionAnswer: 'Вопрос + ответ',
combined: 'Объединенная',
separate: 'Раздельная'
},
standardQuestion: 'Основной вопрос',
answers: 'Ответы',
similarQuestions: 'Похожие вопросы',
negativeQuestions: 'Негативные примеры',
editorCreate: 'Создать FAQ запись',
editorEdit: 'Редактировать FAQ запись',
addAnswer: 'Добавить ответ',
answerPlaceholder: 'Введите содержимое ответа, поддерживается многострочный текст, нажмите Ctrl+Enter или нажмите кнопку для добавления',
similarPlaceholder: 'Введите похожий вопрос и нажмите значок плюса для добавления',
negativePlaceholder: 'Введите негативный пример и нажмите значок плюса для добавления',
answerRequired: 'Добавьте хотя бы один ответ',
noAnswer: 'Ответы отсутствуют',
noSimilar: 'Похожие вопросы отсутствуют',
noNegative: 'Нет негативных примеров',
emptyTitle: 'Нет записей FAQ',
emptyDesc: 'Нажмите "Создать FAQ запись" выше, чтобы начать',
searchTest: 'Тест поиска',
searchTestTitle: 'Тест поиска FAQ',
queryLabel: 'Запрос',
queryPlaceholder: 'Введите вопрос для поиска',
vectorThresholdLabel: 'Порог векторного сходства',
vectorThresholdDesc: 'Диапазон 0-1, по умолчанию 0.7',
keywordThresholdLabel: 'Порог совпадения ключевых слов',
keywordThresholdDesc: 'Диапазон 0-1, по умолчанию 0.5',
matchCountLabel: 'Количество результатов',
matchCountDesc: 'Диапазон 1-50, по умолчанию 10',
searchButton: 'Начать поиск',
searching: 'Поиск...',
searchResults: 'Результаты поиска',
noResults: 'Совпадающих записей FAQ не найдено',
score: 'Сходство',
matchType: 'Тип совпадения',
matchTypeEmbedding: 'Векторное совпадение',
matchTypeKeywords: 'Совпадение ключевых слов',
similarityThresholdLabel: 'Порог сходства',
},
faqImport: {
title: 'Пакетный импорт FAQ',
modeLabel: 'Режим импорта',
appendMode: 'Добавить',
replaceMode: 'Заменить существующие записи',
fileLabel: 'Выберите файл',
fileTip: 'Поддерживаются JSON / CSV / Excel. Поля: standard_question, answers, similar_questions, negative_questions',
clickToUpload: 'Нажмите для загрузки файла',
dragDropTip: 'или перетащите файл сюда',
importButton: 'Импортировать FAQ',
deleteSelected: 'Удалить выбранные',
deleteSuccess: 'Выбранные записи удалены',
previewCount: 'Разобрано записей: {count}',
previewMore: 'Ещё {count} записей не показано',
importSuccess: 'Импорт завершён',
parseFailed: 'Не удалось разобрать файл',
invalidJSON: 'Неверный формат JSON',
unsupportedFormat: 'Формат файла не поддерживается',
selectFile: 'Сначала выберите файл для импорта',
},
models: {
title: 'Конфигурация моделей',
+78
View File
@@ -566,6 +566,7 @@ export default {
refresh: "刷新",
loading: "加载中...",
noData: "暂无数据",
noMoreData: "已加载全部内容",
error: "错误",
success: "成功",
warning: "警告",
@@ -970,6 +971,7 @@ export default {
},
knowledgeList: {
create: "新建知识库",
createFAQ: "新建 FAQ 知识库",
uninitializedBanner:
"部分知识库尚未初始化,需要先在设置中配置模型信息才能添加知识文档",
empty: {
@@ -994,10 +996,15 @@ export default {
models: "模型配置",
chunking: "分块设置",
advanced: "高级设置",
faq: "FAQ 设置",
},
basic: {
title: "基本信息",
description: "设置知识库的名称和描述信息",
typeLabel: "知识库类型",
typeDocument: "文档型",
typeFAQ: "FAQ 问答",
typeDescription: "FAQ 类型适合结构化问答数据;文档型支持文件解析与分块。",
nameLabel: "知识库名称",
namePlaceholder: "请输入知识库名称",
descriptionLabel: "知识库描述",
@@ -1020,6 +1027,77 @@ export default {
missingId: "缺少知识库 ID",
buildDataFailed: "数据构建失败",
updateSuccess: "配置保存成功",
indexModeRequired: "请选择 FAQ 的索引方式",
},
faq: {
title: "FAQ 配置",
description: "设置 FAQ 知识库的索引策略和问答组织方式",
indexModeLabel: "索引方式",
indexModeDescription: "仅索引问题可提升精度,索引问答可提高召回率",
questionIndexModeLabel: "问题索引方式",
questionIndexModeDescription: "一起索引:标准问和相似问合并索引;分别索引:标准问和每个相似问独立索引,检索更精确但需要更多存储",
entryGuide: "FAQ 条目由标准问、相似问、反例和多个答案组成,可在知识库详情中批量导入、编辑。",
modes: {
questionOnly: "仅标准问/相似问",
questionAnswer: "标准问 + 答案",
combined: "一起索引",
separate: "分别索引",
},
standardQuestion: "标准问",
answers: "答案",
similarQuestions: "相似问",
negativeQuestions: "反例",
editorCreate: "新增 FAQ 条目",
editorEdit: "编辑 FAQ 条目",
addAnswer: "添加答案",
answerPlaceholder: "请输入答案内容,支持多行文本,按 Ctrl+Enter 或点击按钮添加",
similarPlaceholder: "输入相似问题后点击加号添加",
negativePlaceholder: "输入反例后点击加号添加",
answerRequired: "请至少填写一个答案",
noAnswer: "暂无答案",
noSimilar: "暂无相似问",
noNegative: "暂无反例",
emptyTitle: "暂无 FAQ 条目",
emptyDesc: "点击上方“新增 FAQ 条目”按钮开始创建",
searchTest: "检索测试",
searchTestTitle: "FAQ 检索测试",
queryLabel: "查询内容",
queryPlaceholder: "请输入要检索的问题",
vectorThresholdLabel: "向量相似度阈值",
vectorThresholdDesc: "范围 0-1,默认 0.7",
keywordThresholdLabel: "关键词匹配阈值",
keywordThresholdDesc: "范围 0-1,默认 0.5",
matchCountLabel: "结果数量",
matchCountDesc: "范围 1-50,默认 10",
searchButton: "开始检索",
searching: "检索中...",
searchResults: "检索结果",
noResults: "未找到匹配的 FAQ 条目",
score: "相似度",
matchType: "匹配类型",
matchTypeEmbedding: "向量匹配",
matchTypeKeywords: "关键词匹配",
similarityThresholdLabel: "相似度阈值",
},
faqImport: {
title: "批量导入 FAQ",
modeLabel: "导入模式",
appendMode: "追加导入",
replaceMode: "替换现有条目",
fileLabel: "选择文件",
fileTip: "支持 JSON / CSV / Excel,字段包含 standard_question、answers、similar_questions、negative_questions",
clickToUpload: "点击上传文件",
dragDropTip: "或拖拽文件到此处",
importButton: "导入 FAQ",
deleteSelected: "批量删除",
deleteSuccess: "选中条目已删除",
previewCount: "共解析 {count} 条记录",
previewMore: "还有 {count} 条未展示",
importSuccess: "导入成功",
parseFailed: "解析文件失败",
invalidJSON: "JSON 文件格式不正确",
unsupportedFormat: "暂不支持该文件格式",
selectFile: "请先选择需要导入的文件",
},
models: {
title: "模型配置",
+5 -1
View File
@@ -6,6 +6,7 @@ export const useUIStore = defineStore('ui', {
showKBEditorModal: false,
kbEditorMode: 'create' as 'create' | 'edit',
currentKBId: null as string | null,
kbEditorType: 'document' as 'document' | 'faq',
kbEditorInitialSection: null as string | null,
settingsInitialSection: null as string | null,
settingsInitialSubSection: null as string | null,
@@ -39,6 +40,7 @@ export const useUIStore = defineStore('ui', {
openKBSettings(kbId: string, initialSection?: string) {
this.currentKBId = kbId
this.kbEditorMode = 'edit'
this.kbEditorType = 'document'
this.kbEditorInitialSection = initialSection || null
this.showKBEditorModal = true
},
@@ -47,9 +49,10 @@ export const useUIStore = defineStore('ui', {
this.openKBSettings(kbId, initialSection)
},
openCreateKB() {
openCreateKB(type: 'document' | 'faq' = 'document') {
this.currentKBId = null
this.kbEditorMode = 'create'
this.kbEditorType = type
this.kbEditorInitialSection = null
this.showKBEditorModal = true
},
@@ -58,6 +61,7 @@ export const useUIStore = defineStore('ui', {
this.showKBEditorModal = false
this.currentKBId = null
this.kbEditorInitialSection = null
this.kbEditorType = 'document'
},
openManualEditor(options: {
+2 -2
View File
@@ -193,6 +193,6 @@ export function put(url: string, data = {}) {
return instance.put(url, data);
}
export function del(url: string) {
return instance.delete(url);
export function del(url: string, data?: any) {
return instance.delete(url, { data });
}
+126 -80
View File
@@ -15,12 +15,17 @@ const router = useRouter();
import {
batchQueryKnowledge,
listKnowledgeFiles,
getKnowledgeBaseById,
} from "@/api/knowledge-base/index";
import FAQEntryManager from './components/FAQEntryManager.vue';
import { formatStringDate } from "@/utils/index";
import { useI18n } from 'vue-i18n';
const route = useRoute();
const { t } = useI18n();
const kbId = computed(() => (route.params as any).kbId as string || '');
const kbInfo = ref<any>(null);
const kbLoading = ref(false);
const isFAQ = computed(() => (kbInfo.value?.type || '') === 'faq');
let { cardList, total, moreIndex, details, getKnowled, delKnowledge, openMore, onVisibleChange, getCardDetails, getfDetails } = useKnowledgeBase(kbId.value)
let isCardDetails = ref(false);
let timeout: ReturnType<typeof setInterval> | null = null;
@@ -76,10 +81,34 @@ const loadKnowledgeFiles = async (kbIdValue: string) => {
}
};
const loadKnowledgeBaseInfo = async (targetKbId: string) => {
if (!targetKbId) {
kbInfo.value = null;
return;
}
kbLoading.value = true;
try {
const res: any = await getKnowledgeBaseById(targetKbId);
kbInfo.value = res?.data || null;
if (!isFAQ.value) {
getKnowled({ page: 1, page_size: pageSize }, targetKbId);
loadKnowledgeFiles(targetKbId);
} else {
cardList.value = [];
total.value = 0;
}
} catch (error) {
console.error('Failed to load knowledge base info:', error);
kbInfo.value = null;
} finally {
kbLoading.value = false;
}
};
// 监听路由参数变化,重新获取知识库内容
watch(() => kbId.value, (newKbId, oldKbId) => {
if (newKbId && newKbId !== oldKbId) {
loadKnowledgeFiles(newKbId);
loadKnowledgeBaseInfo(newKbId);
}
}, { immediate: false });
@@ -87,7 +116,7 @@ watch(() => kbId.value, (newKbId, oldKbId) => {
const handleFileUploaded = (event: CustomEvent) => {
const uploadedKbId = event.detail.kbId;
console.log('接收到文件上传事件,上传的知识库ID:', uploadedKbId, '当前知识库ID:', kbId.value);
if (uploadedKbId && uploadedKbId === kbId.value) {
if (uploadedKbId && uploadedKbId === kbId.value && !isFAQ.value) {
console.log('匹配当前知识库,开始刷新文件列表');
// 如果上传的文件属于当前知识库,使用 loadKnowledgeFiles 刷新文件列表
loadKnowledgeFiles(uploadedKbId);
@@ -95,7 +124,7 @@ const handleFileUploaded = (event: CustomEvent) => {
};
onMounted(() => {
getKnowled({ page: 1, page_size: pageSize });
loadKnowledgeBaseInfo(kbId.value);
// 监听文件上传事件
window.addEventListener('knowledgeFileUploaded', handleFileUploaded as EventListener);
@@ -105,6 +134,7 @@ onUnmounted(() => {
window.removeEventListener('knowledgeFileUploaded', handleFileUploaded as EventListener);
});
watch(() => cardList.value, (newValue) => {
if (isFAQ.value) return;
let analyzeList = [];
analyzeList = newValue.filter(item => {
return item.parse_status == 'pending' || item.parse_status == 'processing';
@@ -172,12 +202,13 @@ const delCard = (index: number, item: KnowledgeCard) => {
};
const manualEditorSuccess = ({ kbId: savedKbId }: { kbId: string; knowledgeId: string; status: 'draft' | 'publish' }) => {
if (savedKbId === kbId.value) {
if (savedKbId === kbId.value && !isFAQ.value) {
loadKnowledgeFiles(savedKbId);
}
};
const handleManualEdit = (index: number, item: KnowledgeCard) => {
if (isFAQ.value) return;
if (cardList.value[index]) {
cardList.value[index].isMore = false;
}
@@ -190,6 +221,7 @@ const handleManualEdit = (index: number, item: KnowledgeCard) => {
};
const handleScroll = () => {
if (isFAQ.value) return;
const element = knowledgeScroll.value;
if (element) {
let pageNum = Math.ceil(total.value / pageSize)
@@ -256,95 +288,103 @@ async function createNewSession(value: string): Promise<void> {
</script>
<template>
<div v-show="cardList.length" class="knowledge-card-box" style="position: relative">
<div class="knowledge-card-wrap" ref="knowledgeScroll" @scroll="handleScroll">
<div class="knowledge-card" v-for="(item, index) in cardList" :key="index" @click="openCardDetails(item)">
<div class="card-content">
<div class="card-content-nav">
<span class="card-content-title">{{ item.file_name }}</span>
<t-popup v-model="item.isMore" overlayClassName="card-more"
:on-visible-change="onVisibleChange" trigger="click" destroy-on-close placement="bottom-right">
<div variant="outline" class="more-wrap" @click.stop="openMore(index)"
:class="[moreIndex == index ? 'active-more' : '']">
<img class="more" src="@/assets/img/more.png" alt="" />
</div>
<template #content>
<div class="card-menu">
<div
v-if="item.type === 'manual'"
class="card-menu-item"
@click.stop="handleManualEdit(index, item)"
>
<t-icon class="icon" name="edit" />
<span>{{ t('knowledgeBase.editDocument') }}</span>
</div>
<div
class="card-menu-item danger"
@click.stop="delCard(index, item)"
>
<t-icon class="icon" name="delete" />
<span>{{ t('knowledgeBase.deleteDocument') }}</span>
</div>
<template v-if="!isFAQ">
<div v-show="cardList.length" class="knowledge-card-box" style="position: relative">
<div class="knowledge-card-wrap" ref="knowledgeScroll" @scroll="handleScroll">
<div class="knowledge-card" v-for="(item, index) in cardList" :key="index" @click="openCardDetails(item)">
<div class="card-content">
<div class="card-content-nav">
<span class="card-content-title">{{ item.file_name }}</span>
<t-popup v-model="item.isMore" overlayClassName="card-more"
:on-visible-change="onVisibleChange" trigger="click" destroy-on-close placement="bottom-right">
<div variant="outline" class="more-wrap" @click.stop="openMore(index)"
:class="[moreIndex == index ? 'active-more' : '']">
<img class="more" src="@/assets/img/more.png" alt="" />
</div>
</template>
</t-popup>
<template #content>
<div class="card-menu">
<div
v-if="item.type === 'manual'"
class="card-menu-item"
@click.stop="handleManualEdit(index, item)"
>
<t-icon class="icon" name="edit" />
<span>{{ t('knowledgeBase.editDocument') }}</span>
</div>
<div
class="card-menu-item danger"
@click.stop="delCard(index, item)"
>
<t-icon class="icon" name="delete" />
<span>{{ t('knowledgeBase.deleteDocument') }}</span>
</div>
</div>
</template>
</t-popup>
</div>
<div
v-if="item.parse_status === 'processing' || item.parse_status === 'pending'"
class="card-analyze"
>
<t-icon name="loading" class="card-analyze-loading"></t-icon>
<span class="card-analyze-txt">{{ t('knowledgeBase.parsingInProgress') }}</span>
</div>
<div
v-else-if="item.parse_status === 'failed'"
class="card-analyze failure"
>
<t-icon name="close-circle" class="card-analyze-loading failure"></t-icon>
<span class="card-analyze-txt failure">{{ t('knowledgeBase.parsingFailed') }}</span>
</div>
<div v-else-if="item.parse_status === 'draft'" class="card-draft">
<t-tag size="small" theme="warning" variant="light-outline">{{ t('knowledgeBase.draft') }}</t-tag>
<span class="card-draft-tip">{{ t('knowledgeBase.draftTip') }}</span>
</div>
<div v-else-if="item.parse_status === 'completed'" class="card-content-txt">
{{ item.description }}
</div>
</div>
<div
v-if="item.parse_status === 'processing' || item.parse_status === 'pending'"
class="card-analyze"
>
<t-icon name="loading" class="card-analyze-loading"></t-icon>
<span class="card-analyze-txt">{{ t('knowledgeBase.parsingInProgress') }}</span>
</div>
<div
v-else-if="item.parse_status === 'failed'"
class="card-analyze failure"
>
<t-icon name="close-circle" class="card-analyze-loading failure"></t-icon>
<span class="card-analyze-txt failure">{{ t('knowledgeBase.parsingFailed') }}</span>
</div>
<div v-else-if="item.parse_status === 'draft'" class="card-draft">
<t-tag size="small" theme="warning" variant="light-outline">{{ t('knowledgeBase.draft') }}</t-tag>
<span class="card-draft-tip">{{ t('knowledgeBase.draftTip') }}</span>
</div>
<div v-else-if="item.parse_status === 'completed'" class="card-content-txt">
{{ item.description }}
<div class="card-bottom">
<span class="card-time">{{ item.updated_at }}</span>
<div class="card-type">
<span>{{ item.file_type }}</span>
</div>
</div>
</div>
<div class="card-bottom">
<span class="card-time">{{ item.updated_at }}</span>
<div class="card-type">
<span>{{ item.file_type }}</span>
<t-dialog v-model:visible="delDialog" dialogClassName="del-knowledge" :closeBtn="false" :cancelBtn="null"
:confirmBtn="null">
<div class="circle-wrap">
<div class="header">
<img class="circle-img" src="@/assets/img/circle.png" alt="">
<span class="circle-title">{{ t('knowledgeBase.deleteConfirmation') }}</span>
</div>
<span class="del-circle-txt">
{{ t('knowledgeBase.confirmDeleteDocument', { fileName: knowledge.file_name || '' }) }}
</span>
<div class="circle-btn">
<span class="circle-btn-txt" @click="delDialog = false">{{ t('common.cancel') }}</span>
<span class="circle-btn-txt confirm" @click="delCardConfirm">{{ t('knowledgeBase.confirmDelete') }}</span>
</div>
</div>
</div>
</t-dialog>
</div>
<t-dialog v-model:visible="delDialog" dialogClassName="del-knowledge" :closeBtn="false" :cancelBtn="null"
:confirmBtn="null">
<div class="circle-wrap">
<div class="header">
<img class="circle-img" src="@/assets/img/circle.png" alt="">
<span class="circle-title">{{ t('knowledgeBase.deleteConfirmation') }}</span>
</div>
<span class="del-circle-txt">
{{ t('knowledgeBase.confirmDeleteDocument', { fileName: knowledge.file_name || '' }) }}
</span>
<div class="circle-btn">
<span class="circle-btn-txt" @click="delDialog = false">{{ t('common.cancel') }}</span>
<span class="circle-btn-txt confirm" @click="delCardConfirm">{{ t('knowledgeBase.confirmDelete') }}</span>
</div>
</div>
</t-dialog>
<InputField @send-msg="sendMsg"></InputField>
<DocContent :visible="isCardDetails" :details="details" @closeDoc="closeDoc" @getDoc="getDoc"></DocContent>
</div>
<InputField @send-msg="sendMsg"></InputField>
<DocContent :visible="isCardDetails" :details="details" @closeDoc="closeDoc" @getDoc="getDoc"></DocContent>
</div>
<EmptyKnowledge v-show="!cardList.length"></EmptyKnowledge>
<EmptyKnowledge v-show="!cardList.length"></EmptyKnowledge>
</template>
<template v-else>
<div class="faq-manager-wrapper">
<FAQEntryManager v-if="kbId" :kb-id="kbId" />
</div>
</template>
<!-- 知识库编辑器(创建/编辑统一组件) -->
<KnowledgeBaseEditorModal
:visible="uiStore.showKBEditorModal"
:mode="uiStore.kbEditorMode"
:kb-id="uiStore.currentKBId || undefined"
:initial-type="uiStore.kbEditorType"
@update:visible="(val) => val ? null : uiStore.closeKBEditor()"
@success="handleKBEditorSuccess"
/>
@@ -369,6 +409,12 @@ async function createNewSession(value: string): Promise<void> {
flex: 1;
}
.faq-manager-wrapper {
flex: 1;
padding: 24px 44px;
overflow-y: auto;
}
@media (max-width: 1250px) and (min-width: 1045px) {
.answers-input {
transform: translateX(-329px);
@@ -40,6 +40,18 @@
<p class="section-desc">{{ $t('knowledgeEditor.basic.description') }}</p>
</div>
<div class="section-body">
<div class="form-item">
<label class="form-label required">{{ $t('knowledgeEditor.basic.typeLabel') }}</label>
<t-radio-group
v-model="formData.type"
:disabled="mode === 'edit'"
variant="default-filled"
>
<t-radio-button value="document">{{ $t('knowledgeEditor.basic.typeDocument') }}</t-radio-button>
<t-radio-button value="faq">{{ $t('knowledgeEditor.basic.typeFAQ') }}</t-radio-button>
</t-radio-group>
<p class="form-tip">{{ $t('knowledgeEditor.basic.typeDescription') }}</p>
</div>
<div class="form-item">
<label class="form-label required">{{ $t('knowledgeEditor.basic.nameLabel') }}</label>
<t-input
@@ -73,8 +85,45 @@
/>
</div>
<!-- FAQ 配置 -->
<div v-if="isFAQ && formData" v-show="currentSection === 'faq'" class="section">
<div class="section-content">
<div class="section-header">
<h3 class="section-title">{{ $t('knowledgeEditor.faq.title') }}</h3>
<p class="section-desc">{{ $t('knowledgeEditor.faq.description') }}</p>
</div>
<div class="section-body">
<div class="form-item">
<label class="form-label required">{{ $t('knowledgeEditor.faq.indexModeLabel') }}</label>
<t-radio-group
v-model="formData.faqConfig.indexMode"
variant="default-filled"
>
<t-radio-button value="question_only">{{ $t('knowledgeEditor.faq.modes.questionOnly') }}</t-radio-button>
<t-radio-button value="question_answer">{{ $t('knowledgeEditor.faq.modes.questionAnswer') }}</t-radio-button>
</t-radio-group>
<p class="form-tip">{{ $t('knowledgeEditor.faq.indexModeDescription') }}</p>
</div>
<div class="form-item">
<label class="form-label required">{{ $t('knowledgeEditor.faq.questionIndexModeLabel') }}</label>
<t-radio-group
v-model="formData.faqConfig.questionIndexMode"
variant="default-filled"
>
<t-radio-button value="combined">{{ $t('knowledgeEditor.faq.modes.combined') }}</t-radio-button>
<t-radio-button value="separate">{{ $t('knowledgeEditor.faq.modes.separate') }}</t-radio-button>
</t-radio-group>
<p class="form-tip">{{ $t('knowledgeEditor.faq.questionIndexModeDescription') }}</p>
</div>
<div class="faq-guide">
<p>{{ $t('knowledgeEditor.faq.entryGuide') }}</p>
</div>
</div>
</div>
</div>
<!-- 分块设置 -->
<div v-show="currentSection === 'chunking'" class="section">
<div v-if="!isFAQ" v-show="currentSection === 'chunking'" class="section">
<KBChunkingSettings
v-if="formData"
:config="formData.chunkingConfig"
@@ -83,7 +132,7 @@
</div>
<!-- 高级设置 -->
<div v-show="currentSection === 'advanced'" class="section">
<div v-if="!isFAQ" v-show="currentSection === 'advanced'" class="section">
<KBAdvancedSettings
ref="advancedSettingsRef"
v-if="formData"
@@ -133,6 +182,7 @@ const props = defineProps<{
visible: boolean
mode: 'create' | 'edit'
kbId?: string
initialType?: 'document' | 'faq'
}>()
// Emits
@@ -147,12 +197,21 @@ const loading = ref(false)
const allModels = ref<any[]>([])
const hasFiles = ref(false)
const navItems = computed(() => [
{ key: 'basic', icon: 'info-circle', label: t('knowledgeEditor.sidebar.basic') },
{ key: 'models', icon: 'control-platform', label: t('knowledgeEditor.sidebar.models') },
{ key: 'chunking', icon: 'file-copy', label: t('knowledgeEditor.sidebar.chunking') },
{ key: 'advanced', icon: 'setting', label: t('knowledgeEditor.sidebar.advanced') }
])
const navItems = computed(() => {
const items = [
{ key: 'basic', icon: 'info-circle', label: t('knowledgeEditor.sidebar.basic') },
{ key: 'models', icon: 'control-platform', label: t('knowledgeEditor.sidebar.models') }
]
if (formData.value?.type === 'faq') {
items.push({ key: 'faq', icon: 'help-circle', label: t('knowledgeEditor.sidebar.faq') })
} else {
items.push(
{ key: 'chunking', icon: 'file-copy', label: t('knowledgeEditor.sidebar.chunking') },
{ key: 'advanced', icon: 'setting', label: t('knowledgeEditor.sidebar.advanced') }
)
}
return items
})
// 模型配置引用
const modelConfigRef = ref<InstanceType<typeof KBModelConfig>>()
@@ -160,12 +219,34 @@ const advancedSettingsRef = ref<InstanceType<typeof KBAdvancedSettings>>()
// 表单数据
const formData = ref<any>(null)
const isFAQ = computed(() => formData.value?.type === 'faq')
watch(
() => formData.value?.type,
(newType, oldType) => {
if (!formData.value) return
if (newType === 'faq') {
if (!formData.value.faqConfig) {
formData.value.faqConfig = { indexMode: 'question_answer', questionIndexMode: 'combined' }
}
if (!['basic', 'models', 'faq'].includes(currentSection.value)) {
currentSection.value = 'faq'
}
} else if (oldType === 'faq' && currentSection.value === 'faq') {
currentSection.value = 'basic'
}
}
)
// 初始化表单数据
const initFormData = () => {
const initFormData = (type: 'document' | 'faq' = 'document') => {
return {
type,
name: '',
description: '',
faqConfig: {
indexMode: 'question_answer'
},
modelConfig: {
llmModelId: '',
embeddingModelId: '',
@@ -234,9 +315,15 @@ const loadKBData = async () => {
hasFiles.value = (filesResult as any)?.total > 0
// 设置表单数据
const kbType = (kb.type as 'document' | 'faq') || 'document'
formData.value = {
type: kbType,
name: kb.name || '',
description: kb.description || '',
faqConfig: {
indexMode: kb.faq_config?.index_mode || 'question_answer',
questionIndexMode: kb.faq_config?.question_index_mode || 'combined'
},
modelConfig: {
llmModelId: kb.summary_model_id || '',
embeddingModelId: kb.embedding_model_id || '',
@@ -339,6 +426,12 @@ const validateForm = (): boolean => {
}
}
if (formData.value.type === 'faq' && !formData.value.faqConfig?.indexMode) {
MessagePlugin.warning(t('knowledgeEditor.messages.indexModeRequired'))
currentSection.value = 'faq'
return false
}
return true
}
@@ -349,6 +442,7 @@ const buildSubmitData = () => {
const data: any = {
name: formData.value.name,
description: formData.value.description,
type: formData.value.type,
chunking_config: {
chunk_size: formData.value.chunkingConfig.chunkSize,
chunk_overlap: formData.value.chunkingConfig.chunkOverlap,
@@ -400,6 +494,13 @@ const buildSubmitData = () => {
}
}
if (formData.value.type === 'faq') {
data.faq_config = {
index_mode: formData.value.faqConfig?.indexMode || 'question_answer',
question_index_mode: formData.value.faqConfig?.questionIndexMode || 'combined'
}
}
return data
}
@@ -430,11 +531,18 @@ const handleSubmit = async () => {
throw new Error(t('knowledgeEditor.messages.missingId'))
}
// 1. 更新基本信息(名称、描述)
// 1. 更新基本信息(名称、描述)和 FAQ 配置
const updateConfig: any = {}
if (formData.value.type === 'faq' && formData.value.faqConfig) {
updateConfig.faq_config = {
index_mode: formData.value.faqConfig.indexMode || 'question_answer',
question_index_mode: formData.value.faqConfig.questionIndexMode || 'combined'
}
}
await updateKnowledgeBase(props.kbId, {
name: data.name,
description: data.description,
config: {} // 空配置,只更新基本信息
config: updateConfig
})
// 2. 更新完整配置(模型、分块、多模态、知识图谱等)
@@ -524,7 +632,7 @@ watch(() => props.visible, async (newVal) => {
await loadKBData()
} else {
// 创建模式:初始化空表单
formData.value = initFormData()
formData.value = initFormData(props.initialType || 'document')
hasFiles.value = false
}
} else {
@@ -740,6 +848,22 @@ watch(
}
}
.form-tip {
margin-top: 6px;
font-size: 12px;
color: #00000066;
}
.faq-guide {
margin-top: 20px;
padding: 12px 16px;
border-radius: 8px;
background: #f5f5f5;
color: #00000099;
font-size: 13px;
line-height: 20px;
}
.settings-footer {
padding: 16px 32px;
border-top: 1px solid #e5e5e5;
@@ -763,5 +887,48 @@ watch(
transform: scale(0.95);
}
}
// Radio-group 样式优化,符合项目主题风格
:deep(.t-radio-group) {
.t-radio-group--filled {
background: #f5f5f5;
}
.t-radio-button {
border-color: #d9d9d9;
// color: #00000099;
&:hover:not(.t-is-disabled) {
border-color: #07c05f;
color: #07c05f;
}
&.t-is-checked {
background: #07c05f;
border-color: #07c05f;
color: #fff;
&:hover:not(.t-is-disabled) {
background: #05a04f;
border-color: #05a04f;
color: #fff;
}
}
// 禁用状态样式
&.t-is-disabled {
background: #f5f5f5;
border-color: #d9d9d9;
color: #00000040;
cursor: not-allowed;
opacity: 0.6;
&.t-is-checked {
background: #f0f0f0;
border-color: #d9d9d9;
color: #00000066;
}
}
}
}
</style>
@@ -3,10 +3,12 @@
<!-- 头部 -->
<div class="header">
<h2>{{ $t('knowledgeBase.title') }}</h2>
<button class="create-btn" @click="openCreateModal">
<t-icon name="add" size="16px" class="btn-icon" />
<span>{{ $t('knowledgeList.create') }}</span>
</button>
<div class="action-buttons">
<button class="create-btn ghost" @click="openCreateModal">
<t-icon name="add" size="16px" class="btn-icon" />
<span>{{ $t('knowledgeList.create') }}</span>
</button>
</div>
</div>
<!-- 未初始化知识库提示 -->
@@ -67,9 +69,8 @@
<!-- 卡片底部 -->
<div class="card-bottom">
<div class="status-badge" :class="{ 'initialized': isInitialized(kb), 'uninitialized': !isInitialized(kb) }">
<span v-if="!isInitialized(kb)" class="warning-icon">⚠</span>
<span>{{ isInitialized(kb) ? $t('knowledgeBase.initializedStatus') : $t('knowledgeBase.notInitializedStatus') }}</span>
<div class="type-badge" :class="{ 'document': (kb.type || 'document') === 'document', 'faq': kb.type === 'faq' }">
<span>{{ kb.type === 'faq' ? $t('knowledgeEditor.basic.typeFAQ') : $t('knowledgeEditor.basic.typeDocument') }}</span>
</div>
<span class="card-time">{{ kb.updated_at }}</span>
</div>
@@ -112,6 +113,7 @@
:visible="uiStore.showKBEditorModal"
:mode="uiStore.kbEditorMode"
:kb-id="uiStore.currentKBId || undefined"
:initial-type="uiStore.kbEditorType"
@update:visible="(val) => val ? null : uiStore.closeKBEditor()"
@success="handleKBEditorSuccess"
/>
@@ -143,6 +145,7 @@ interface KB {
updated_at?: string;
embedding_model_id?: string;
summary_model_id?: string;
type?: 'document' | 'faq';
showMore?: boolean;
}
@@ -278,15 +281,19 @@ const handleKBEditorSuccess = (kbId: string) => {
}
}
.action-buttons {
display: flex;
gap: 12px;
align-items: center;
}
.create-btn {
display: flex;
align-items: center;
gap: 6px;
padding: 8px 20px;
height: 36px;
background: #07c05f;
color: #fff;
border: none;
border: 1px solid transparent;
border-radius: 8px;
font-family: "PingFang SC";
font-size: 14px;
@@ -294,16 +301,38 @@ const handleKBEditorSuccess = (kbId: string) => {
cursor: pointer;
transition: all 0.2s ease;
.btn-icon {
flex-shrink: 0;
}
}
.create-btn.primary {
background: #07c05f;
color: #fff;
border-color: #07c05f;
&:hover {
background: #05a04f;
border-color: #05a04f;
}
&:active {
background: #048f45;
border-color: #048f45;
}
}
.create-btn.ghost {
background: transparent;
color: #07c05f;
border-color: #07c05f;
&:hover {
background: #07c05f1a;
}
.btn-icon {
flex-shrink: 0;
&:active {
background: #07c05f33;
}
}
@@ -428,7 +457,7 @@ const handleKBEditorSuccess = (kbId: string) => {
margin-top: auto;
}
.status-badge {
.type-badge {
display: flex;
align-items: center;
gap: 3px;
@@ -438,18 +467,14 @@ const handleKBEditorSuccess = (kbId: string) => {
font-size: 12px;
font-weight: 500;
&.initialized {
&.document {
background: #07c05f1a;
color: #07c05f;
}
&.uninitialized {
background: #fff7e6;
color: #d46b08;
}
.warning-icon {
font-size: 12px;
&.faq {
background: #1890ff1a;
color: #1890ff;
}
}
File diff suppressed because it is too large Load Diff