From 49cd3923087bee1c077332883c4190ceea40eddd Mon Sep 17 00:00:00 2001 From: wizardchen Date: Wed, 6 May 2026 20:19:57 +0800 Subject: [PATCH] fix(frontend): rework chunking debug UX in KB editor MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The chunking debug panel was an inline section that crowded the strategy form, broke its own layout with negative margins, and crashed on result.rejected being null. The trigger button required scrolling to the form's bottom to reach. - Move debug into a right-side t-drawer pinned above the modal stacking context (attach=body, z-index 3000) so it overlays cleanly. - Promote the trigger to a sticky header sibling next to the section title, with right padding to clear the modal close button. - Replace unicode arrows / + / − with tdesign-icons (Chevron, Play, ErrorCircle) and rebuild the result layout: pill-shaped breadcrumb tags, line-clamped previews with gradient fade on collapse, ordered chunk list, structured error block. - Drop custom char counter (t-textarea already has one). - Add four sample fixtures (markdown / faq / chapter / plain) loadable as preset chips so users have realistic content to test against. - Guard `result.rejected` nullability that crashed the panel. - Normalize the recursive tier label to legacy in the UI since both tiers behave identically — pairs with the backend cleanup. - Rename strategy labels in zh-CN/en-US/ko-KR/ru-RU from internal jargon ("auto", "heading", "heuristic", "legacy") to descriptive names ("Automatic", "Heading-aware", "Structure-aware", "Length-based") and add presetLabel + sample i18n keys. --- frontend/src/i18n/locales/en-US.ts | 23 +- frontend/src/i18n/locales/ko-KR.ts | 23 +- frontend/src/i18n/locales/ru-RU.ts | 23 +- frontend/src/i18n/locales/zh-CN.ts | 23 +- .../knowledge/settings/KBChunkingDebug.vue | 672 +++++++++++------- .../knowledge/settings/KBChunkingSettings.vue | 76 +- .../knowledge/settings/chunkingSamples.ts | 291 ++++++++ 7 files changed, 813 insertions(+), 318 deletions(-) create mode 100644 frontend/src/views/knowledge/settings/chunkingSamples.ts diff --git a/frontend/src/i18n/locales/en-US.ts b/frontend/src/i18n/locales/en-US.ts index 47098afa..1d03ffa4 100755 --- a/frontend/src/i18n/locales/en-US.ts +++ b/frontend/src/i18n/locales/en-US.ts @@ -1924,20 +1924,20 @@ export default { strategyPlaceholder: 'Select strategy (defaults to classic recursive splitting)', strategies: { auto: { - label: 'Automatic (recommended)', - tooltip: 'A document profiler analyzes structure and picks heading-aware, smart-detection or classic splitting per upload.' + label: 'Automatic', + tooltip: 'A document profiler picks between heading-aware, structure-aware and length-based splitting per upload.' }, heading: { - label: 'Markdown-optimized', - tooltip: 'Splits primarily at Markdown headings (#, ##, ###). Best for clean Markdown with explicit section structure.' + label: 'Heading-aware', + tooltip: 'Splits at Markdown heading boundaries (#, ##, ###); each chunk carries its heading path. Best for well-structured Markdown.' }, heuristic: { - label: 'Smart structure detection', - tooltip: 'Detects page-breaks, numbered sections, multilingual chapter markers (DE/EN/ZH), all-caps titles. Ideal for PDFs without proper Markdown.' + label: 'Structure-aware', + tooltip: 'Splits on detected structural cues: page-breaks, numbered sections, multilingual chapter markers (DE/EN/ZH), all-caps titles. Ideal for PDFs without Markdown headings.' }, legacy: { - label: 'Classic', - tooltip: 'Classic recursive splitting on separators only — the original behavior. Use this if the new strategies misbehave on your content.' + label: 'Length-based', + tooltip: 'Ignores structure; splits recursively by character count and separators — the original behavior. Use when the structure-aware strategies misbehave on your content.' } }, overlapWarning: 'Overlap is large compared to chunk size — chunks will share most of their content.', @@ -1957,6 +1957,13 @@ export default { toggleHint: 'Run the chunker against sample text without re-uploading', sampleLabel: 'Sample text', samplePlaceholder: 'Paste a Markdown / plain-text snippet to see how the current configuration would chunk it…', + presetLabel: 'Load sample:', + samples: { + markdown: 'Markdown doc', + faq: 'FAQ list', + chapter: 'PDF chapters', + plain: 'Plain prose' + }, runButton: 'Run preview', loading: 'Running chunker on sample…', errorPrefix: 'Preview failed', diff --git a/frontend/src/i18n/locales/ko-KR.ts b/frontend/src/i18n/locales/ko-KR.ts index a539478c..ad0404e4 100755 --- a/frontend/src/i18n/locales/ko-KR.ts +++ b/frontend/src/i18n/locales/ko-KR.ts @@ -2533,20 +2533,20 @@ export default { strategyPlaceholder: "전략 선택 (기본: 클래식 재귀 분할)", strategies: { auto: { - label: "자동 (권장)", - tooltip: "문서 프로파일러가 구조를 분석하여 헤딩 인식, 스마트 감지 또는 클래식 분할을 선택합니다." + label: "자동", + tooltip: "문서 프로파일러가 콘텐츠 구조에 따라 「헤딩 기준」, 「구조 인식」, 「길이 기준」 분할 중 하나를 자동 선택합니다." }, heading: { - label: "Markdown 최적화", - tooltip: "주로 Markdown 헤딩(#, ##, ###)에서 분할합니다. 명확한 섹션 구조의 Markdown에 적합합니다." + label: "헤딩 기준", + tooltip: "Markdown 헤딩(#, ##, ###) 경계에서 분할하며 각 청크에 헤딩 경로가 부착됩니다. 잘 구조화된 Markdown 문서에 적합합니다." }, heuristic: { - label: "스마트 구조 감지", - tooltip: "페이지 구분자, 번호 매겨진 섹션, 다국어 챕터 마커(DE/EN/ZH), 대문자 제목을 감지합니다. Markdown 구조가 없는 PDF에 적합합니다." + label: "구조 인식", + tooltip: "페이지 구분자, 번호 매겨진 섹션, 다국어 챕터 마커(DE/EN/ZH), 대문자 제목 등 구조적 신호를 감지하여 분할합니다. Markdown 헤딩이 없는 PDF/스캔본에 적합합니다." }, legacy: { - label: "클래식", - tooltip: "구분자만 사용한 클래식 재귀 분할 — 원래 동작. 새 전략이 콘텐츠에서 잘못 작동하는 경우 사용하세요." + label: "길이 기준", + tooltip: "구조를 무시하고 문자 수와 구분자로만 재귀 분할합니다 — 원래 동작. 위 전략들이 콘텐츠에서 잘못 작동할 때 사용하세요." } }, overlapWarning: "오버랩이 청크 크기에 비해 큽니다 — 청크가 대부분의 콘텐츠를 공유합니다.", @@ -2566,6 +2566,13 @@ export default { toggleHint: "재업로드 없이 샘플 텍스트에 대해 청커 실행", sampleLabel: "샘플 텍스트", samplePlaceholder: "현재 구성으로 어떻게 청크되는지 보려면 Markdown / 일반 텍스트 스니펫을 붙여넣으세요…", + presetLabel: "샘플 불러오기:", + samples: { + markdown: "Markdown 문서", + faq: "FAQ 목록", + chapter: "PDF 챕터", + plain: "일반 텍스트" + }, runButton: "미리보기 실행", loading: "샘플에 대해 청커 실행 중…", errorPrefix: "미리보기 실패", diff --git a/frontend/src/i18n/locales/ru-RU.ts b/frontend/src/i18n/locales/ru-RU.ts index c0d612a9..076bc6d9 100755 --- a/frontend/src/i18n/locales/ru-RU.ts +++ b/frontend/src/i18n/locales/ru-RU.ts @@ -2136,20 +2136,20 @@ export default { strategyPlaceholder: 'Выберите стратегию (по умолчанию классическое рекурсивное разбиение)', strategies: { auto: { - label: 'Автоматически (рекомендуется)', - tooltip: 'Профилировщик документа анализирует структуру и выбирает заголовочное, эвристическое или классическое разбиение для каждой загрузки.' + label: 'Автоматически', + tooltip: 'Профилировщик документа сам выбирает между «По заголовкам», «По структуре» и «По длине» разбиением для каждой загрузки.' }, heading: { - label: 'Оптимизировано для Markdown', - tooltip: 'Разбивает преимущественно по заголовкам Markdown (#, ##, ###). Подходит для чистого Markdown с явной структурой разделов.' + label: 'По заголовкам', + tooltip: 'Разбивает по границам заголовков Markdown (#, ##, ###); каждый фрагмент получает свой путь заголовков. Подходит для хорошо структурированного Markdown.' }, heuristic: { - label: 'Умное определение структуры', - tooltip: 'Определяет разрывы страниц, нумерованные разделы, многоязычные маркеры глав (DE/EN/ZH), заголовки в верхнем регистре. Идеально для PDF без Markdown.' + label: 'По структуре', + tooltip: 'Разбивает по обнаруженным структурным признакам: разрывы страниц, нумерованные разделы, многоязычные маркеры глав (DE/EN/ZH), заголовки в верхнем регистре. Идеально для PDF без заголовков Markdown.' }, legacy: { - label: 'Классический', - tooltip: 'Классическое рекурсивное разбиение только по разделителям — оригинальное поведение. Используйте, если новые стратегии работают некорректно.' + label: 'По длине', + tooltip: 'Игнорирует структуру и разбивает рекурсивно по числу символов и разделителям — оригинальное поведение. Используйте, если стратегии с учётом структуры работают некорректно.' } }, overlapWarning: 'Перекрытие велико по сравнению с размером блока — блоки будут содержать большую часть одинакового контента.', @@ -2169,6 +2169,13 @@ export default { toggleHint: 'Запустить разбиение для примера текста без повторной загрузки', sampleLabel: 'Пример текста', samplePlaceholder: 'Вставьте фрагмент Markdown / простого текста, чтобы увидеть, как его разобьет текущая конфигурация…', + presetLabel: 'Загрузить пример:', + samples: { + markdown: 'Markdown-документ', + faq: 'Список FAQ', + chapter: 'Главы PDF', + plain: 'Обычный текст' + }, runButton: 'Запустить предпросмотр', loading: 'Запуск разбиения на примере…', errorPrefix: 'Ошибка предпросмотра', diff --git a/frontend/src/i18n/locales/zh-CN.ts b/frontend/src/i18n/locales/zh-CN.ts index bfce3988..67f8f75b 100755 --- a/frontend/src/i18n/locales/zh-CN.ts +++ b/frontend/src/i18n/locales/zh-CN.ts @@ -2492,20 +2492,20 @@ export default { strategyPlaceholder: "选择策略(默认使用经典递归分块)", strategies: { auto: { - label: "自动(推荐)", - tooltip: "文档分析器自动选择标题感知、结构检测或经典分块。" + label: "自动", + tooltip: "文档分析器根据内容结构自动在「按标题切分」「结构感知」「按长度切分」之间选择。" }, heading: { - label: "Markdown 优化", - tooltip: "主要按 Markdown 标题(#、##、###)切分。适合结构清晰的 Markdown。" + label: "按标题切分", + tooltip: "在 Markdown 标题(#、##、###)边界处切分,每块自动带上所在标题路径。适合结构清晰的 Markdown 文档。" }, heuristic: { - label: "智能结构检测", - tooltip: "检测分页符、编号章节、多语言章节标记(DE/EN/ZH)、全大写标题。适用于无 Markdown 结构的 PDF。" + label: "结构感知", + tooltip: "识别分页符、编号章节、多语言章节标记(DE/EN/ZH)、全大写标题等结构信号进行切分。适合没有 Markdown 标题的 PDF / 扫描件。" }, legacy: { - label: "经典", - tooltip: "仅按分隔符进行经典递归分块——原始行为。如果新策略效果不佳请使用此项。" + label: "按长度切分", + tooltip: "忽略结构,仅按字符数和分隔符递归切分——原始行为。当上述策略对你的内容效果不佳时使用。" } }, overlapWarning: "重叠相对于分块大小较大——分块之间会共享大部分内容。", @@ -2525,6 +2525,13 @@ export default { toggleHint: "无需重新上传即可对示例文本运行分块器", sampleLabel: "示例文本", samplePlaceholder: "粘贴 Markdown / 纯文本片段以查看当前配置的分块结果…", + presetLabel: "载入示例:", + samples: { + markdown: "Markdown 文档", + faq: "FAQ 列表", + chapter: "PDF 章节", + plain: "纯文本" + }, runButton: "运行预览", loading: "正在对示例运行分块器…", errorPrefix: "预览失败", diff --git a/frontend/src/views/knowledge/settings/KBChunkingDebug.vue b/frontend/src/views/knowledge/settings/KBChunkingDebug.vue index d22c634b..61502428 100644 --- a/frontend/src/views/knowledge/settings/KBChunkingDebug.vue +++ b/frontend/src/views/knowledge/settings/KBChunkingDebug.vue @@ -1,161 +1,220 @@