From e31883547d8a3aa006a4358a54ae27dfa71fcb61 Mon Sep 17 00:00:00 2001
From: WangCham <651122857@qq.com>
Date: Wed, 16 Jul 2025 18:15:27 +0800
Subject: [PATCH] feat: add description for topk

---
 web/src/app/home/knowledge/components/kb-form/KBForm.tsx | 7 +++++++
 web/src/i18n/locales/en-US.ts                            | 3 +++
 web/src/i18n/locales/ja-JP.ts                            | 3 +++
 web/src/i18n/locales/zh-Hans.ts                          | 3 +++
 4 files changed, 16 insertions(+)

diff --git a/web/src/app/home/knowledge/components/kb-form/KBForm.tsx b/web/src/app/home/knowledge/components/kb-form/KBForm.tsx
index 7ca885f4..16db601e 100644
--- a/web/src/app/home/knowledge/components/kb-form/KBForm.tsx
+++ b/web/src/app/home/knowledge/components/kb-form/KBForm.tsx
@@ -239,8 +239,15 @@ export default function KBForm({
                       type="number"
                       {...field}
                       onChange={(e) => field.onChange(Number(e.target.value))}
+                      className="w-[180px] h-10 text-base appearance-none"
+                      min={1}
+                      max={30}
+                      defaultValue={5}
                     />
                   </FormControl>
+                  <FormDescription>
+                    {t('knowledge.topKdescription')}
+                  </FormDescription>
                   <FormMessage />
                 </FormItem>
               )}
diff --git a/web/src/i18n/locales/en-US.ts b/web/src/i18n/locales/en-US.ts
index 43110f19..ddf7ad0c 100644
--- a/web/src/i18n/locales/en-US.ts
+++ b/web/src/i18n/locales/en-US.ts
@@ -246,6 +246,9 @@ const enUS = {
     kbName: 'Knowledge Base Name',
     kbDescription: 'Knowledge Base Description',
     topK: 'Top K',
+    topKRequired: 'Top K cannot be empty',
+    topKMax: 'Top K maximum value is 30',
+    topKdescription: 'Used to specify the number of relevant documents to retrieve, ranging from 1 to 30.',
     defaultDescription: 'A knowledge base',
     embeddingModelUUID: 'Embedding Model',
     selectEmbeddingModel: 'Select Embedding Model',
diff --git a/web/src/i18n/locales/ja-JP.ts b/web/src/i18n/locales/ja-JP.ts
index ad0bf56f..69357cb9 100644
--- a/web/src/i18n/locales/ja-JP.ts
+++ b/web/src/i18n/locales/ja-JP.ts
@@ -248,6 +248,9 @@ const jaJP = {
     kbName: '知識ベース名',
     kbDescription: '知識ベースの説明',
     topK: '上位K件',
+    topKRequired: '上位K件は必須です',
+    topKMax: '上位K件の最大値は30です',
+    topKdescription: '関連ドキュメントを取得するための上位K件の数。1〜30の範囲で設定可能です',
     defaultDescription: '知識ベース',
     embeddingModelUUID: '埋め込みモデル',
     selectEmbeddingModel: '埋め込みモデルを選択',
diff --git a/web/src/i18n/locales/zh-Hans.ts b/web/src/i18n/locales/zh-Hans.ts
index f64fc570..a0ea2b8e 100644
--- a/web/src/i18n/locales/zh-Hans.ts
+++ b/web/src/i18n/locales/zh-Hans.ts
@@ -241,6 +241,9 @@ const zhHans = {
     kbName: '知识库名称',
     kbDescription: '知识库描述',
     topK: '召回数量',
+    topKRequired: '召回数量不能为空',
+    topKMax: '召回数量最大值为 30',
+    topKdescription: '用于召回相关文档的数量,取值范围为 1-30',
     defaultDescription: '一个知识库',
     embeddingModelUUID: '嵌入模型',
     selectEmbeddingModel: '选择嵌入模型',