From d2022f8e94a98a1ad85b181fba206b9d1da3a6ca Mon Sep 17 00:00:00 2001
From: wangdan-fit2cloud <dan.wang@fit2cloud.com>
Date: Fri, 16 Oct 2026 11:09:43 +0800
Subject: [PATCH 1/2] feat: hit-test

---
 ui/src/api/API_README.md                      |   8 +
 .../knowledge/knowledge.ts                    |  15 +-
 .../shared-resources/knowledge/knowledge.ts   |   7 +
 .../admin/workspace/knowledge/knowledge.ts    |   7 +
 ui/src/api/types/knowledge.ts                 |  51 ++++-
 ui/src/assets/empty/hit-test.png              | Bin 0 -> 4380 bytes
 ui/src/constants/CONSTANT_README.md           |   3 +
 ui/src/constants/knowledge.ts                 |  21 +-
 ui/src/router/ROUTE_README.md                 |   3 +-
 .../modules/knowledge-system-resource.ts      |   9 +-
 .../system/modules/knowledge-system-shared.ts |   9 +-
 .../workspace/modules/knowledge-shared.ts     |   9 +-
 .../admin/workspace/modules/knowledge.ts      |   9 +-
 ui/src/views/VIEW_README.md                   |  15 +-
 .../hit-test/components/HitTestInput.vue      | 187 ++++++++++++++++
 .../hit-test/components/HitTestResult.vue     |  37 ++++
 .../views/knowledge-detail/hit-test/index.vue | 206 ++++++++++++++++++
 .../library/document/index.vue                |   8 +-
 .../knowledge-detail/recall-test/index.vue    |  10 -
 ui/src/workflow-canvas/WORKFLOW_README.md     |   3 +-
 .../component/SearchSetting.vue               |   5 +-
 .../nodes/search-knowledge-node/constant.ts   |  14 --
 .../nodes/search-knowledge-node/index.vue     |   5 +-
 23 files changed, 585 insertions(+), 56 deletions(-)
 create mode 100644 ui/src/assets/empty/hit-test.png
 create mode 100644 ui/src/views/knowledge-detail/hit-test/components/HitTestInput.vue
 create mode 100644 ui/src/views/knowledge-detail/hit-test/components/HitTestResult.vue
 create mode 100644 ui/src/views/knowledge-detail/hit-test/index.vue
 delete mode 100644 ui/src/views/knowledge-detail/recall-test/index.vue

diff --git a/ui/src/api/API_README.md b/ui/src/api/API_README.md
index 28d89f830a8..e77b17b531c 100644
--- a/ui/src/api/API_README.md
+++ b/ui/src/api/API_README.md
@@ -235,6 +235,14 @@ System 不传 Workspace 文件夹条件；System 共享不提供智能体选择
 共享工具 API 不提供工作空间文件夹移动或批量接口；复用卡片、Action 和表单接收完整 Workspace
 与 System 共享 API 的联合类型，不补造接口以匹配 Workspace 方法集合。
 
+### 知识库召回测试
+
+Workspace、System 资源管理和 System 共享资源均在各自 `knowledge/knowledge.ts` 中提供
+`postKnowledgeHitTest(knowledgeId, payload)`，向知识库的 `/hit_test` 提交 POST，直接返回命中分段数组。
+请求使用 `KnowledgeHitTestPayload`，包含 `query_text`、`image_list`、`top_number`、`similarity` 和
+`search_mode`；检索模式复用 `KNOWLEDGE_SEARCH_MODE`。文本和图片至少提供一项，图片仅支持向量或混合检索。
+结果使用 `KnowledgeHitTestResult`，保留分段、得分及图片命中信息。Workspace 共享暂无对应接口，不回退其他范围。
+
 ### System 共享知识库
 
 `system/shared-resources/knowledge/knowledge.ts` 使用 `/system/shared/knowledge`，维护分页、详情、
diff --git a/ui/src/api/admin/system/resource-management/knowledge/knowledge.ts b/ui/src/api/admin/system/resource-management/knowledge/knowledge.ts
index d3a1b9fb0f8..30125ace20d 100644
--- a/ui/src/api/admin/system/resource-management/knowledge/knowledge.ts
+++ b/ui/src/api/admin/system/resource-management/knowledge/knowledge.ts
@@ -1,7 +1,15 @@
 import { del, get, getExportFile, post, put } from '@/api/admin/core/request'
 import type LogicFlow from '@logicflow/core'
 import type { ParamsPage, ResponsePage } from '@/api/admin/core/types'
-import type { Dict, KnowledgeDetail, KnowledgeItem, KnowledgeGeneratePayload, KnowledgeSyncType } from '@/api/types'
+import type {
+  KnowledgeHitTestPayload,
+  KnowledgeHitTestResult,
+  Dict,
+  KnowledgeDetail,
+  KnowledgeItem,
+  KnowledgeGeneratePayload,
+  KnowledgeSyncType,
+} from '@/api/types'
 
 const prefix = '/system/resource/knowledge'
 
@@ -77,7 +85,12 @@ const putKnowledgeKeywordIndex = (knowledgeId: string) => put<undefined, void>(`
 const postTransformWorkflow = (knowledgeId: string, payload: { work_flow: LogicFlow.GraphConfigData }) =>
   post<{ work_flow: LogicFlow.GraphConfigData }, boolean>(`${prefix}/${knowledgeId}/transform_workflow`, payload)
 
+/** 测试知识库检索并返回命中的分段。 */
+const postKnowledgeHitTest = (knowledgeId: string, payload: KnowledgeHitTestPayload) =>
+  post<KnowledgeHitTestPayload, KnowledgeHitTestResult[]>(`${prefix}/${knowledgeId}/hit_test`, payload)
+
 export default {
+  postKnowledgeHitTest,
   postTransformWorkflow,
   putKnowledgeKeywordIndex,
   exportKnowledgeExcel,
diff --git a/ui/src/api/admin/system/shared-resources/knowledge/knowledge.ts b/ui/src/api/admin/system/shared-resources/knowledge/knowledge.ts
index 31937bccf85..a2541889ce0 100644
--- a/ui/src/api/admin/system/shared-resources/knowledge/knowledge.ts
+++ b/ui/src/api/admin/system/shared-resources/knowledge/knowledge.ts
@@ -3,6 +3,8 @@ import type LogicFlow from '@logicflow/core'
 import type { ParamsPage, ResponsePage } from '@/api/admin/core/types'
 import type {
   Dict,
+  KnowledgeHitTestPayload,
+  KnowledgeHitTestResult,
   KnowledgeCreatePayload,
   KnowledgeDetail,
   KnowledgeGeneratePayload,
@@ -96,7 +98,12 @@ const putKnowledgeKeywordIndex = (knowledgeId: string) => put<undefined, void>(`
 const postTransformWorkflow = (knowledgeId: string, payload: { work_flow: LogicFlow.GraphConfigData }) =>
   post<{ work_flow: LogicFlow.GraphConfigData }, boolean>(`${prefix}/${knowledgeId}/transform_workflow`, payload)
 
+/** 测试知识库检索并返回命中的分段。 */
+const postKnowledgeHitTest = (knowledgeId: string, payload: KnowledgeHitTestPayload) =>
+  post<KnowledgeHitTestPayload, KnowledgeHitTestResult[]>(`${prefix}/${knowledgeId}/hit_test`, payload)
+
 export default {
+  postKnowledgeHitTest,
   postTransformWorkflow,
   deleteKnowledge,
   exportKnowledge,
diff --git a/ui/src/api/admin/workspace/knowledge/knowledge.ts b/ui/src/api/admin/workspace/knowledge/knowledge.ts
index 1cf1faaab98..48f70ae5840 100644
--- a/ui/src/api/admin/workspace/knowledge/knowledge.ts
+++ b/ui/src/api/admin/workspace/knowledge/knowledge.ts
@@ -3,6 +3,8 @@ import type LogicFlow from '@logicflow/core'
 import type { ParamsPage, ResponsePage } from '../../core/types'
 import type {
   Dict,
+  KnowledgeHitTestPayload,
+  KnowledgeHitTestResult,
   KnowledgeDetail,
   KnowledgeItem,
   KnowledgeGeneratePayload,
@@ -129,7 +131,12 @@ const putKnowledgeKeywordIndex = (knowledgeId: string) => put<undefined, void>(`
 const postTransformWorkflow = (knowledgeId: string, payload: { work_flow: LogicFlow.GraphConfigData }) =>
   post<{ work_flow: LogicFlow.GraphConfigData }, boolean>(`${getPrefix()}/${knowledgeId}/transform_workflow`, payload)
 
+/** 测试知识库检索并返回命中的分段。 */
+const postKnowledgeHitTest = (knowledgeId: string, payload: KnowledgeHitTestPayload) =>
+  post<KnowledgeHitTestPayload, KnowledgeHitTestResult[]>(`${getPrefix()}/${knowledgeId}/hit_test`, payload)
+
 export default {
+  postKnowledgeHitTest,
   getKnowledgeMcpConfig,
   putKnowledgeKeywordIndex,
   exportKnowledgeExcel,
diff --git a/ui/src/api/types/knowledge.ts b/ui/src/api/types/knowledge.ts
index 5f7b0bbb0c0..21473b98a2e 100644
--- a/ui/src/api/types/knowledge.ts
+++ b/ui/src/api/types/knowledge.ts
@@ -1,9 +1,10 @@
 /** Workspace 知识库列表和知识库卡片共用的业务类型。 */
 
 import type LogicFlow from '@logicflow/core'
-import { KNOWLEDGE_SYNC_TYPE, KNOWLEDGE_TYPE } from '@/api/enums'
+import { KNOWLEDGE_SEARCH_MODE, KNOWLEDGE_SYNC_TYPE, KNOWLEDGE_TYPE } from '@/api/enums'
 import type { DefaultModelSettingPayload } from './model'
 import type { DocumentTaskState } from './document'
+import type { ParagraphItem } from './paragraph'
 
 /** 生成关联问题共用的模型与提示词配置。 */
 export interface RelatedQuestionsConfig {
@@ -153,3 +154,51 @@ export interface KnowledgeWorkflowStoreResponse {
   additionalProperties: { tags: { key: string; name: string }[] }
   apps: import('./workflow-template').WorkflowStoreTemplate[]
 }
+
+/** 知识库召回测试的检索模式。 */
+export type KnowledgeSearchMode = (typeof KNOWLEDGE_SEARCH_MODE)[keyof typeof KNOWLEDGE_SEARCH_MODE]
+
+/** 召回测试使用的已上传图片。 */
+export interface KnowledgeHitTestImage {
+  file_id: string
+  name?: string
+  url?: string
+}
+
+/** 召回测试的查询内容与检索参数；文本和图片至少提供一项。 */
+export interface KnowledgeHitTestPayload {
+  query_text?: string | null
+  image_list?: KnowledgeHitTestImage[]
+  top_number: number
+  similarity: number
+  search_mode: KnowledgeSearchMode
+}
+
+/** 召回结果命中的图片资产。 */
+export interface KnowledgeHitTestAsset {
+  id: string
+  file_id: string
+  file_name: string
+  url: string
+  position: number
+  caption: string
+  ocr_text: string
+  description: string
+  hit_num: number
+  last_hit_time: string | null
+}
+
+/** 召回测试返回的分段与命中得分。 */
+export interface KnowledgeHitTestResult extends ParagraphItem {
+  knowledge_id: string
+  knowledge_name: string
+  document_name: string
+  similarity: number
+  comprehensive_score: number
+  source_id: string
+  source_type: number
+  hit_unit_type: string
+  query_unit_type: string | null
+  query_unit_index: number | null
+  hit_asset: KnowledgeHitTestAsset | null
+}
diff --git a/ui/src/assets/empty/hit-test.png b/ui/src/assets/empty/hit-test.png
new file mode 100644
index 0000000000000000000000000000000000000000..c25303859cb69f75f0bd03706ddd49d797133854
GIT binary patch
literal 4380
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
WC$%en-`<q~0000<MNUMnLSTZVQ*ku_

literal 0
HcmV?d00001

diff --git a/ui/src/constants/CONSTANT_README.md b/ui/src/constants/CONSTANT_README.md
index 2a9406a55e5..41dd156c711 100644
--- a/ui/src/constants/CONSTANT_README.md
+++ b/ui/src/constants/CONSTANT_README.md
@@ -23,6 +23,9 @@ API 枚举值。例如角色类型和登录方式以 `src/api/enums` 为唯一
 `knowledge.ts` 的 `KNOWLEDGE_SYNC_OPTIONS` 统一维护增量同步、替换同步和整体同步的值、文案及说明，
 手动同步弹窗与定时同步设置直接复用，日志同步方式标签也从这些选项读取。
 
+`knowledge.ts` 的 `KNOWLEDGE_SEARCH_MODE_OPTIONS` 统一维护向量、全文和混合检索的值、文案及说明，
+召回测试页与工作流知识库检索节点直接复用，选项值引用 `KNOWLEDGE_SEARCH_MODE`。
+
 `schedule.ts` 的 `SCHEDULE_OPTION` 统一提供触发器、长期记忆与知识库定时同步的周期级联选项，
 包含周期文案、执行时间和间隔数值；使用方只读，配置回填与校验仍由各自组件维护。
 周期类型统一使用 `api/enums/schedule.ts` 的 `SCHEDULE_TYPE`，经 `@/api/enums` 导入。
diff --git a/ui/src/constants/knowledge.ts b/ui/src/constants/knowledge.ts
index 2ca05c6a070..20252df2856 100644
--- a/ui/src/constants/knowledge.ts
+++ b/ui/src/constants/knowledge.ts
@@ -1,4 +1,4 @@
-import { KNOWLEDGE_TYPE, KNOWLEDGE_SYNC_TYPE } from '@/api/enums'
+import { KNOWLEDGE_TYPE, KNOWLEDGE_SYNC_TYPE, KNOWLEDGE_SEARCH_MODE } from '@/api/enums'
 import type { KnowledgeType } from '@/api/types'
 
 /** 前端知识库类型标识。 */
@@ -31,3 +31,22 @@ export const KNOWLEDGE_SYNC_OPTIONS = [
   { value: KNOWLEDGE_SYNC_TYPE.REPLACE, label: '替换同步', description: '重新获取来源文档并替换匹配的文档，保留未匹配的旧文档' },
   { value: KNOWLEDGE_SYNC_TYPE.COMPLETE, label: '整体同步', description: '重新获取来源文档并重建该来源的文档，保留其他来源的文档' },
 ] as const
+
+/** 召回测试与工作流知识库检索共用的模式选项。 */
+export const KNOWLEDGE_SEARCH_MODE_OPTIONS = [
+  {
+    value: KNOWLEDGE_SEARCH_MODE.EMBEDDING,
+    label: '向量检索',
+    description: '向量检索是一种基于向量相似度的检索方式，适用于知识库中的大数据量场景。',
+  },
+  {
+    value: KNOWLEDGE_SEARCH_MODE.KEYWORDS,
+    label: '全文检索',
+    description: '全文检索是一种基于文本相似度的检索方式，适用于知识库中的小数据量场景。',
+  },
+  {
+    value: KNOWLEDGE_SEARCH_MODE.BLEND,
+    label: '混合检索',
+    description: '混合检索是一种基于向量和文本相似度的检索方式，适用于知识库中的中等数据量场景。',
+  },
+] as const
diff --git a/ui/src/router/ROUTE_README.md b/ui/src/router/ROUTE_README.md
index b8fbd510561..f944c01739c 100644
--- a/ui/src/router/ROUTE_README.md
+++ b/ui/src/router/ROUTE_README.md
@@ -241,10 +241,11 @@ Workspace 共享覆盖 resourceScope，保留 Workspace scope 及知识库 activ
 | ---------- | --------------------------------------------------------------------------------------------------------------------- |
 | 资料库     | 空 path 分组；document、image、tag；仅 BASE 显示图片                                                                  |
 | 工作流     | workflow-entry；WORKFLOW 类型 beforeEnter 重定向对应全屏画布，其他类型显示转换页                                      |
-| 检索优化   | retrieval/recall、retrieval/question、retrieval/dictionary                                                            |
+| 检索优化   | retrieval/hit-test、retrieval/question、retrieval/dictionary                                                          |
 | 授权与集成 | integration/chat-user、integration/external-retrieval                                                                 |
 | 设置       | BASE 单独 setting；WEB 分组含 setting/base、document-strategy、scheduled-sync；LARK／WORKFLOW 含 base、scheduled-sync |
 
+召回测试子路由通过 `props` 传入资源范围与知识库 ID 组成的 Vue `key`，切换资源时重建该页。
 分组不挂 View，直接访问重定向首个子页，保留参数、query、hash。
 设置只用 detailMenuVisible 控制菜单类型，不添加类型访问守卫。资料库 View 的目录是 library/tags，URL 仍为 tag。
 
diff --git a/ui/src/router/admin/system/modules/knowledge-system-resource.ts b/ui/src/router/admin/system/modules/knowledge-system-resource.ts
index 84ea9b1fdf1..0fac4343403 100644
--- a/ui/src/router/admin/system/modules/knowledge-system-resource.ts
+++ b/ui/src/router/admin/system/modules/knowledge-system-resource.ts
@@ -55,13 +55,14 @@ export const systemResourceKnowledgeRoutes: RouteRecordRaw[] = [
       {
         path: 'retrieval',
         name: 'system-resource-knowledge-retrieval',
-        redirect: { name: 'system-resource-knowledge-recall-test' },
+        redirect: { name: 'system-resource-knowledge-hit-test' },
         meta: { title: '检索优化', icon: 'icon_trace_outlined', order: 30 },
         children: [
           {
-            path: 'recall',
-            name: 'system-resource-knowledge-recall-test',
-            component: () => import('@/views/knowledge-detail/recall-test/index.vue'),
+            path: 'hit-test',
+            name: 'system-resource-knowledge-hit-test',
+            component: () => import('@/views/knowledge-detail/hit-test/index.vue'),
+            props: (route) => ({ key: `${route.meta.resourceScope}:${route.params.knowledgeId}` }),
             meta: { title: '召回测试', order: 10 },
           },
           {
diff --git a/ui/src/router/admin/system/modules/knowledge-system-shared.ts b/ui/src/router/admin/system/modules/knowledge-system-shared.ts
index 50e79aaa9b7..02b8714dd90 100644
--- a/ui/src/router/admin/system/modules/knowledge-system-shared.ts
+++ b/ui/src/router/admin/system/modules/knowledge-system-shared.ts
@@ -55,13 +55,14 @@ export const systemSharedKnowledgeRoutes: RouteRecordRaw[] = [
       {
         path: 'retrieval',
         name: 'system-shared-knowledge-retrieval',
-        redirect: { name: 'system-shared-knowledge-recall-test' },
+        redirect: { name: 'system-shared-knowledge-hit-test' },
         meta: { title: '检索优化', icon: 'icon_trace_outlined', order: 30 },
         children: [
           {
-            path: 'recall',
-            name: 'system-shared-knowledge-recall-test',
-            component: () => import('@/views/knowledge-detail/recall-test/index.vue'),
+            path: 'hit-test',
+            name: 'system-shared-knowledge-hit-test',
+            component: () => import('@/views/knowledge-detail/hit-test/index.vue'),
+            props: (route) => ({ key: `${route.meta.resourceScope}:${route.params.knowledgeId}` }),
             meta: { title: '召回测试', order: 10 },
           },
           {
diff --git a/ui/src/router/admin/workspace/modules/knowledge-shared.ts b/ui/src/router/admin/workspace/modules/knowledge-shared.ts
index 29570a1eb8b..cd2e15aa973 100644
--- a/ui/src/router/admin/workspace/modules/knowledge-shared.ts
+++ b/ui/src/router/admin/workspace/modules/knowledge-shared.ts
@@ -55,13 +55,14 @@ export const sharedKnowledgeRoutes: RouteRecordRaw[] = [
       {
         path: 'retrieval',
         name: 'workspace-shared-knowledge-retrieval',
-        redirect: { name: 'workspace-shared-knowledge-recall-test' },
+        redirect: { name: 'workspace-shared-knowledge-hit-test' },
         meta: { title: '检索优化', icon: 'icon_trace_outlined', order: 30 },
         children: [
           {
-            path: 'recall',
-            name: 'workspace-shared-knowledge-recall-test',
-            component: () => import('@/views/knowledge-detail/recall-test/index.vue'),
+            path: 'hit-test',
+            name: 'workspace-shared-knowledge-hit-test',
+            component: () => import('@/views/knowledge-detail/hit-test/index.vue'),
+            props: (route) => ({ key: `${route.meta.resourceScope}:${route.params.knowledgeId}` }),
             meta: { title: '召回测试', order: 10 },
           },
           {
diff --git a/ui/src/router/admin/workspace/modules/knowledge.ts b/ui/src/router/admin/workspace/modules/knowledge.ts
index b0e2e183535..6ef4c6f6f11 100644
--- a/ui/src/router/admin/workspace/modules/knowledge.ts
+++ b/ui/src/router/admin/workspace/modules/knowledge.ts
@@ -67,13 +67,14 @@ export const knowledgeRoutes: RouteRecordRaw[] = [
           {
             path: 'retrieval',
             name: 'workspace-knowledge-retrieval',
-            redirect: { name: 'workspace-knowledge-recall-test' },
+            redirect: { name: 'workspace-knowledge-hit-test' },
             meta: { title: '检索优化', icon: 'icon_trace_outlined', order: 30 },
             children: [
               {
-                path: 'recall',
-                name: 'workspace-knowledge-recall-test',
-                component: () => import('@/views/knowledge-detail/recall-test/index.vue'),
+                path: 'hit-test',
+                name: 'workspace-knowledge-hit-test',
+                component: () => import('@/views/knowledge-detail/hit-test/index.vue'),
+                props: (route) => ({ key: `${route.meta.resourceScope}:${route.params.knowledgeId}` }),
                 meta: { title: '召回测试', order: 10 },
               },
               {
diff --git a/ui/src/views/VIEW_README.md b/ui/src/views/VIEW_README.md
index 602a02bcbbc..80b06c74a24 100644
--- a/ui/src/views/VIEW_README.md
+++ b/ui/src/views/VIEW_README.md
@@ -44,7 +44,8 @@
 | `knowledge-detail/`                                                                   | 四范围知识库详情、菜单与上下文               |
 | `knowledge-detail/library/document/`、`tags/`                                         | 文档及标签维护                               |
 | `knowledge-detail/library/image/`                                                     | 图片列表，复用文档操作                       |
-| `knowledge-detail/recall-test/`、`question/`                                          | 检索优化占位页                               |
+| `knowledge-detail/hit-test/`                                                          | 召回测试参数、文本／图片查询及结果展示       |
+| `knowledge-detail/question/`                                                          | 问题管理占位页                               |
 | `knowledge-detail/termbase/`                                                          | 知识库自定义分词维护                         |
 | `knowledge-detail/chat-user/`、`external-retrieval/`                                  | 对话授权与外部检索配置                       |
 | `knowledge-detail/setting/base/`、`document-strategy/`、`scheduled-sync/`             | 基础设置、文档策略、定时同步与日志           |
@@ -132,6 +133,18 @@
 复用周期及同步方式常量，支持日、周、月、间隔和 Cron，间隔至少 5 分钟；完整 Cron 由后台校验。
 日志页按需挂载 `SyncLogTable`，传完整 API，仅展示定时任务，不轮询；跳过执行展示原因。
 
+### 召回测试
+
+`hit-test/` 按截图提供参数／输入与结果两栏，复用详情标题栏。通过详情上下文选择 Workspace、
+System 资源管理或 System 共享 Knowledge API 的 `postKnowledgeHitTest`；Workspace 共享缺少对应接口时
+由上下文返回文档页，不回退其他范围。
+默认向量检索、相似度 0.600、TOP K 6；切换全文检索重置相似度为 0，其余模式为 0.6。
+文本和图片至少提供一项，空白文本不可提交；图片存在或上传中时禁选全文检索，全文模式不提供图片入口。
+图片通过 Admin File API 上传为 120 分钟临时文件，最多 10 张、每张 20MB，仅提交上传成功的文件引用；
+上传中或存在失败图片时禁测试，移除失败图片后可重试。移除与卸载释放本地预览并取消未完成上传。
+测试期间冻结参数与输入；结果展示提交时的查询、分段、得分、文档名称及命中图片，Markdown 只读。
+初始、无命中与失败分别展示空态，失败保留输入供重试。切换知识库或资源范围通过路由 key 重建召回测试页，隔离查询与结果状态。
+
 ### 文档列表与导入
 
 `library/document/index.vue` 管理查询、分页、选择、启停及刷新；Action 管理各自请求和浮层。
diff --git a/ui/src/views/knowledge-detail/hit-test/components/HitTestInput.vue b/ui/src/views/knowledge-detail/hit-test/components/HitTestInput.vue
new file mode 100644
index 00000000000..0d817b4cab7
--- /dev/null
+++ b/ui/src/views/knowledge-detail/hit-test/components/HitTestInput.vue
@@ -0,0 +1,187 @@
+<script setup lang="ts">
+import { computed, onBeforeUnmount, reactive, ref, watch } from 'vue'
+import { Picture } from '@element-plus/icons-vue'
+import FileApi from '@/api/admin/file'
+import { FILE_SOURCE_TYPE } from '@/api/enums'
+import type { KnowledgeHitTestImage } from '@/api/types'
+import { MsgWarning } from '@/utils/message'
+
+defineOptions({ name: 'KnowledgeHitTestInput' })
+
+const props = withDefaults(defineProps<{ modelValue: string; disabled?: boolean; allowImages?: boolean }>(), { disabled: false, allowImages: true })
+const emit = defineEmits<{
+  'update:modelValue': [value: string]
+  'update:images': [images: KnowledgeHitTestImage[]]
+  'update:uploading': [uploading: boolean]
+  'update:failed': [failed: boolean]
+}>()
+
+interface QueryImage {
+  id: number
+  name: string
+  previewUrl: string
+  status: 'uploading' | 'success' | 'failed'
+  uploadedImage?: KnowledgeHitTestImage
+}
+
+// 查询图片先上传为临时文件，仅将上传成功的引用交给召回接口。
+const maxImageCount = 10
+const maxImageSizeMB = 20
+const imageInputRef = ref<HTMLInputElement>()
+const queryImages = ref<QueryImage[]>([])
+const uploadRequests = new Map<number, () => void>()
+const canSelectImages = computed(() => props.allowImages && !props.disabled && queryImages.value.length < maxImageCount)
+const hasFailedImages = computed(() => queryImages.value.some((image) => image.status === 'failed'))
+let nextImageId = 0
+let disposed = false
+
+watch(
+  () => queryImages.value.flatMap((image) => (image.uploadedImage ? [image.uploadedImage] : [])),
+  (images) => emit('update:images', images),
+  { immediate: true, flush: 'sync' },
+)
+watch(
+  () => queryImages.value.some((image) => image.status === 'uploading'),
+  (uploading) => emit('update:uploading', uploading),
+  { immediate: true, flush: 'sync' },
+)
+watch(hasFailedImages, (failed) => emit('update:failed', failed), { immediate: true })
+
+function selectImages(event: Event) {
+  const input = event.target as HTMLInputElement
+  const files = Array.from(input.files ?? [])
+  input.value = ''
+  if (!canSelectImages.value) return
+
+  for (const file of files) {
+    if (queryImages.value.length >= maxImageCount) {
+      MsgWarning(`每次最多上传 ${maxImageCount} 张图片`)
+      break
+    }
+    if (!/\.(jpe?g|png|gif|webp)$/i.test(file.name)) {
+      MsgWarning('仅支持 JPG、PNG、GIF、WebP 图片')
+      continue
+    }
+    if (!file.size || file.size > maxImageSizeMB * 1024 * 1024) {
+      MsgWarning(file.size ? `每张图片不能超过 ${maxImageSizeMB}MB` : '图片不能为空')
+      continue
+    }
+
+    const image = reactive<QueryImage>({
+      id: ++nextImageId,
+      name: file.name,
+      previewUrl: URL.createObjectURL(file),
+      status: 'uploading',
+    })
+    queryImages.value.push(image)
+    uploadImage(image, file)
+  }
+}
+
+function uploadImage(image: QueryImage, file: File) {
+  // 上传返回资源地址，末段是召回接口要求的 file_id。
+  void Promise.resolve()
+    .then(() => {
+      if (disposed || !queryImages.value.includes(image)) return
+      const { request, abort } = FileApi.postUploadFile(file, undefined, FILE_SOURCE_TYPE.TEMPORARY_120_MINUTE)
+      uploadRequests.set(image.id, abort)
+      return request.then((url) => {
+        if (disposed || !queryImages.value.includes(image)) return
+        const fileId = url.split(/[?#]/)[0]?.split('/').filter(Boolean).pop()
+        if (!fileId) throw new Error('上传图片未返回文件 ID')
+        image.uploadedImage = { file_id: fileId, name: file.name, url }
+        image.status = 'success'
+      })
+    })
+    .catch(() => {
+      // 请求层提示上传错误，保留缩略图供移除后重新选择。
+      if (!disposed && queryImages.value.includes(image)) image.status = 'failed'
+    })
+    .finally(() => uploadRequests.delete(image.id))
+}
+
+function removeImage(image: QueryImage) {
+  if (props.disabled) return
+  queryImages.value = queryImages.value.filter((queryImage) => queryImage.id !== image.id)
+  uploadRequests.get(image.id)?.()
+  uploadRequests.delete(image.id)
+  URL.revokeObjectURL(image.previewUrl)
+}
+
+// 只取消尚未完成的上传，已上传临时文件由服务端按有效期清理。
+onBeforeUnmount(() => {
+  disposed = true
+  for (const abort of uploadRequests.values()) abort()
+  for (const image of queryImages.value) URL.revokeObjectURL(image.previewUrl)
+  uploadRequests.clear()
+})
+</script>
+
+<template>
+  <div class="mk-input-box border" :class="{ 'bg-N100!': disabled }">
+    <MkHorizontalScroll v-if="queryImages.length" class="mb-3">
+      <template v-for="image in queryImages" :key="image.id">
+        <div class="group relative shrink-0">
+          <!-- 预览查询图片 -->
+          <el-image
+            :src="image.previewUrl"
+            :alt="image.name"
+            :title="image.name"
+            :preview-src-list="[image.previewUrl]"
+            preview-teleported
+            fit="cover"
+            class="size-20 rounded-lg border"
+          />
+          <div v-if="image.status === 'uploading'" class="pointer-events-none absolute inset-0 flex-center rounded-lg bg-N900/30">
+            <LoadingIcon :size="20" class="text-white" />
+          </div>
+          <div
+            v-else-if="image.status === 'failed'"
+            class="pointer-events-none absolute inset-x-0 bottom-0 rounded-b-lg bg-danger/90 py-1 text-center text-sm text-white"
+          >
+            上传失败
+          </div>
+          <!-- 移除查询图片 -->
+          <button
+            type="button"
+            class="mk-remove-button group-hover-visible disabled:cursor-not-allowed"
+            title="移除图片"
+            :disabled="disabled"
+            @click="removeImage(image)"
+          >
+            <MkIcon name="icon_close_bold_outlined" :size="8" class="text-white!" />
+          </button>
+        </div>
+      </template>
+    </MkHorizontalScroll>
+    <p v-if="hasFailedImages" class="mb-2 text-sm text-danger">请移除上传失败的图片后再测试</p>
+
+    <!-- 输入召回测试内容 -->
+    <el-input
+      :model-value="modelValue"
+      type="textarea"
+      :autosize="{ minRows: 2, maxRows: 7 }"
+      resize="none"
+      placeholder="请输入测试内容"
+      :disabled="disabled"
+      @update:model-value="emit('update:modelValue', $event)"
+    />
+    <div class="mt-2 flex min-h-8 justify-end">
+      <input
+        ref="imageInputRef"
+        type="file"
+        multiple
+        accept=".jpg,.jpeg,.png,.gif,.webp"
+        :disabled="!canSelectImages"
+        class="hidden"
+        @change="selectImages"
+      />
+      <MkTooltip v-if="allowImages" :content="`最多 ${maxImageCount} 张图片，每张不超过 ${maxImageSizeMB}MB，支持 JPG、PNG、GIF、WebP`">
+        <!-- 上传查询图片 -->
+        <el-button text :disabled="!canSelectImages" title="上传图片" @click="imageInputRef?.click()">
+          <MkIcon :icon="Picture" :size="20" />
+        </el-button>
+      </MkTooltip>
+    </div>
+  </div>
+</template>
diff --git a/ui/src/views/knowledge-detail/hit-test/components/HitTestResult.vue b/ui/src/views/knowledge-detail/hit-test/components/HitTestResult.vue
new file mode 100644
index 00000000000..abf91049607
--- /dev/null
+++ b/ui/src/views/knowledge-detail/hit-test/components/HitTestResult.vue
@@ -0,0 +1,37 @@
+<script setup lang="ts">
+import { Document } from '@element-plus/icons-vue'
+import type { KnowledgeHitTestResult } from '@/api/types'
+
+defineOptions({ name: 'KnowledgeHitTestResult' })
+defineProps<{ paragraph: KnowledgeHitTestResult; index: number }>()
+</script>
+
+<template>
+  <article class="overflow-hidden rounded-xl border bg-white p-4">
+    <header class="flex-between gap-3">
+      <div class="flex-align-center min-w-0 gap-2">
+        <span class="flex-center size-6 shrink-0 rounded-md bg-primary/10 text-sm text-primary">{{ index }}</span>
+        <h6 class="min-w-0 break-words">{{ paragraph.title || '未命名分段' }}</h6>
+      </div>
+      <MkTooltip content="检索相似度">
+        <span class="shrink-0 text-primary">{{ paragraph.similarity.toFixed(3) }}</span>
+      </MkTooltip>
+    </header>
+    <el-image
+      v-if="paragraph.hit_asset"
+      :src="paragraph.hit_asset.url"
+      :alt="paragraph.hit_asset.caption || paragraph.hit_asset.file_name"
+      :preview-src-list="[paragraph.hit_asset.url]"
+      preview-teleported
+      fit="contain"
+      class="mt-3 h-40 max-w-full rounded-md"
+    />
+    <el-scrollbar max-height="280" class="my-3">
+      <MdPreview :model-value="paragraph.content" />
+    </el-scrollbar>
+    <footer class="flex-align-center min-w-0 gap-1 border-t pt-3 text-sm text-N600">
+      <el-icon class="shrink-0"><Document /></el-icon>
+      <span class="truncate" :title="paragraph.document_name">{{ paragraph.document_name }}</span>
+    </footer>
+  </article>
+</template>
diff --git a/ui/src/views/knowledge-detail/hit-test/index.vue b/ui/src/views/knowledge-detail/hit-test/index.vue
new file mode 100644
index 00000000000..01bf6210b9d
--- /dev/null
+++ b/ui/src/views/knowledge-detail/hit-test/index.vue
@@ -0,0 +1,206 @@
+<script setup lang="ts">
+import { computed, reactive, ref, useTemplateRef } from 'vue'
+import type { FormInstance, FormRules } from 'element-plus'
+import type { ResourceDetailPageProps } from '@/layout/ResourceDetailLayout.vue'
+import { KNOWLEDGE_SEARCH_MODE } from '@/api/enums'
+import { KNOWLEDGE_SEARCH_MODE_OPTIONS } from '@/constants/knowledge'
+import type { KnowledgeHitTestImage, KnowledgeHitTestPayload, KnowledgeHitTestResult } from '@/api/types'
+import { useKnowledgeDetailContext } from '@/views/knowledge-detail/context'
+import emptyHitTestImage from '@/assets/empty/hit-test.png'
+import HitTestInput from './components/HitTestInput.vue'
+import HitTestResult from './components/HitTestResult.vue'
+
+defineOptions({ name: 'HitTestView' })
+defineProps<ResourceDetailPageProps>()
+defineExpose({ customHeader: true })
+
+const { knowledgeId, resourceApi } = useKnowledgeDetailContext({ resourceScopes: ['workspace', 'system-resource', 'system-shared'] })
+
+// 检索参数与待测试内容，图片查询仅支持向量和混合检索。
+const searchForm = reactive<Pick<KnowledgeHitTestPayload, 'search_mode' | 'similarity' | 'top_number'>>({
+  search_mode: KNOWLEDGE_SEARCH_MODE.EMBEDDING,
+  similarity: 0.6,
+  top_number: 6,
+})
+const searchFormRef = useTemplateRef<FormInstance>('searchFormRef')
+const searchRules: FormRules = {
+  similarity: [{ required: true, type: 'number', message: '请输入相似度', trigger: 'change' }],
+  top_number: [{ required: true, type: 'number', message: '请输入召回数量', trigger: 'change' }],
+}
+const queryText = ref('')
+const queryImages = ref<KnowledgeHitTestImage[]>([])
+const uploading = ref(false)
+const hasFailedImages = ref(false)
+const loading = ref(false)
+const hasImages = computed(() => queryImages.value.length > 0)
+const isKeywordSearch = computed(() => searchForm.search_mode === KNOWLEDGE_SEARCH_MODE.KEYWORDS)
+const canTest = computed(() => !loading.value && !uploading.value && !hasFailedImages.value && (!!queryText.value.trim() || hasImages.value))
+
+function changeSearchMode() {
+  searchForm.similarity = isKeywordSearch.value ? 0 : 0.6
+}
+
+// 仅展示本次提交的查询快照，失败保留输入和检索参数供重试。
+const resultParagraphs = ref<KnowledgeHitTestResult[]>([])
+const tested = ref(false)
+const testFailed = ref(false)
+const submittedQuery = ref('')
+
+function testKnowledge() {
+  if (!canTest.value) return
+  searchFormRef.value?.validate((valid) => {
+    if (!valid || !canTest.value) return
+    const payload: KnowledgeHitTestPayload = {
+      ...searchForm,
+      query_text: queryText.value.trim(),
+      image_list: queryImages.value.map((queryImage) => ({ ...queryImage })),
+    }
+    const queryTitle = payload.query_text || `图片检索（${queryImages.value.length} 张）`
+    loading.value = true
+    testFailed.value = false
+    return resourceApi.knowledge
+      .postKnowledgeHitTest(knowledgeId.value, payload)
+      .then((paragraphs) => {
+        resultParagraphs.value = paragraphs
+        submittedQuery.value = queryTitle
+        tested.value = true
+      })
+      .catch(() => {
+        // 通用错误由请求层提示；结果区标记失败，避免误认为是本次测试结果。
+        testFailed.value = true
+      })
+      .finally(() => {
+        loading.value = false
+      })
+  })
+}
+</script>
+
+<template>
+  <Teleport v-if="headerTarget" :to="headerTarget">
+    <div class="flex-align-center gap-2">
+      <h4>{{ title }}</h4>
+      <MkTooltip content="针对用户提问召回匹配的知识内容，保障回答效果" placement="right">
+        <MkIcon name="icon_info_outlined" class="text-N600!" />
+      </MkTooltip>
+    </div>
+  </Teleport>
+  <div class="grid min-h-0 flex-1 grid-cols-2 gap-6 -pr-0!">
+    <section class="min-w-0 space-y-4">
+      <div
+        class="relative rounded-xl border bg-white p-4 after:absolute after:-bottom-1.5 after:left-1/2 after:size-3 after:rotate-45 after:border-r after:border-b after:bg-white"
+      >
+        <h4 class="mb-5">检索参数</h4>
+        <el-form
+          ref="searchFormRef"
+          :model="searchForm"
+          :rules="searchRules"
+          label-position="top"
+          hide-required-asterisk
+          :disabled="loading"
+          @submit.prevent
+        >
+          <el-form-item label="检索模式" class="mb-4!">
+            <!-- 选择检索模式 -->
+            <el-radio-group v-model="searchForm.search_mode" class="mk-radio-group-vertical" @change="changeSearchMode">
+              <template v-for="searchMode in KNOWLEDGE_SEARCH_MODE_OPTIONS" :key="searchMode.value">
+                <el-card
+                  shadow="never"
+                  class="w-full rounded-xl!"
+                  body-class="p-4!"
+                  :class="{ 'border-primary!': searchForm.search_mode === searchMode.value }"
+                >
+                  <el-radio
+                    :value="searchMode.value"
+                    :disabled="loading || (searchMode.value === KNOWLEDGE_SEARCH_MODE.KEYWORDS && (hasImages || uploading))"
+                    class="mk-card-radio items-center! [&_.el-radio__input]:mt-0!"
+                  >
+                    <h6>{{ searchMode.label }}</h6>
+                    <span class="mt-1 block text-sm text-N600">{{ searchMode.description }}</span>
+                    <span v-if="searchMode.value === KNOWLEDGE_SEARCH_MODE.KEYWORDS && hasImages" class="mt-1 block text-sm text-N500">
+                      图片不支持全文检索，请先移除图片
+                    </span>
+                  </el-radio>
+                </el-card>
+              </template>
+            </el-radio-group>
+          </el-form-item>
+          <div class="grid grid-cols-2 gap-4">
+            <el-form-item prop="similarity" class="mb-0!">
+              <template #label>
+                <span class="flex-align-center gap-1">
+                  相似度高于
+                  <MkTooltip content="仅召回得分高于此值的分段。向量和全文检索范围为 0–1，混合检索范围为 0–2。">
+                    <MkIcon name="icon_info_outlined" :size="16" class="text-N500" />
+                  </MkTooltip>
+                </span>
+              </template>
+              <!-- 设置相似度阈值 -->
+              <el-input-number
+                v-model="searchForm.similarity"
+                class="w-full!"
+                :min="0"
+                :max="searchForm.search_mode === KNOWLEDGE_SEARCH_MODE.BLEND ? 2 : 1"
+                :precision="3"
+                :step="0.1"
+                :value-on-clear="0"
+                controls-position="right"
+                align="left"
+              />
+            </el-form-item>
+            <el-form-item label="召回 TOP K" prop="top_number" class="mb-0!">
+              <!-- 设置召回数量 -->
+              <el-input-number
+                v-model="searchForm.top_number"
+                class="w-full!"
+                :min="1"
+                :max="10000"
+                :precision="0"
+                :value-on-clear="1"
+                controls-position="right"
+                align="left"
+              />
+            </el-form-item>
+          </div>
+        </el-form>
+      </div>
+
+      <HitTestInput
+        v-model="queryText"
+        :disabled="loading"
+        :allow-images="!isKeywordSearch"
+        @update:images="queryImages = $event"
+        @update:uploading="uploading = $event"
+        @update:failed="hasFailedImages = $event"
+      />
+      <!-- 执行召回测试 -->
+      <el-button type="primary" class="w-full" :loading="loading" :disabled="!canTest" @click="testKnowledge">
+        <MkIcon v-if="!loading" name="icon_play_outlined" class="mr-1" />
+        测试
+      </el-button>
+    </section>
+
+    <section v-loading="loading" class="flex-column min-h-[520px] min-w-0 rounded-xl border bg-N100 p-4">
+      <div v-if="!tested" class="flex-center flex-1">
+        <MkEmpty :image="emptyHitTestImage" description="召回的知识显示在这里" :image-size="125" />
+      </div>
+      <template v-else>
+        <header class="mb-4 space-y-2">
+          <div class="flex-between gap-3">
+            <h4>召回结果</h4>
+            <span class="shrink-0 text-sm text-N500">共 {{ resultParagraphs.length }} 条</span>
+          </div>
+          <p class="break-words text-N600">{{ submittedQuery }}</p>
+        </header>
+        <div v-if="!resultParagraphs.length" class="flex-center flex-1">
+          <MkEmpty type="search" description="未召回相关知识，请调整检索参数或测试内容" />
+        </div>
+        <div v-else class="space-y-3">
+          <template v-for="(paragraph, paragraphIndex) in resultParagraphs" :key="paragraph.id">
+            <HitTestResult :paragraph="paragraph" :index="paragraphIndex + 1" />
+          </template>
+        </div>
+      </template>
+    </section>
+  </div>
+</template>
diff --git a/ui/src/views/knowledge-detail/library/document/index.vue b/ui/src/views/knowledge-detail/library/document/index.vue
index 0053f0aa217..64be20271d5 100644
--- a/ui/src/views/knowledge-detail/library/document/index.vue
+++ b/ui/src/views/knowledge-detail/library/document/index.vue
@@ -513,11 +513,7 @@ onBeforeUnmount(() => {
               />
               <!-- 同步 -->
               <SyncDocumentAction
-                v-if="
-                  knowledgeType === KNOWLEDGE_TYPE_KEY.WEB ||
-                  knowledgeType === KNOWLEDGE_TYPE_KEY.LARK ||
-                  (knowledgeType === KNOWLEDGE_TYPE_KEY.WORKFLOW && row.meta?.source_type === 'web')
-                "
+                v-if="knowledgeType !== KNOWLEDGE_TYPE_KEY.BASE"
                 label="同步"
                 :api="resourceApi.document"
                 :knowledge-id="knowledgeId"
@@ -632,7 +628,7 @@ onBeforeUnmount(() => {
           <MkDropdownMenu>
             <!-- 批量同步 -->
             <BatchSyncDocumentAction
-              v-if="knowledgeType === KNOWLEDGE_TYPE_KEY.WEB || knowledgeType === KNOWLEDGE_TYPE_KEY.LARK"
+              v-if="knowledgeType !== KNOWLEDGE_TYPE_KEY.BASE"
               label="同步"
               :api="resourceApi.document"
               :knowledge-id="knowledgeId"
diff --git a/ui/src/views/knowledge-detail/recall-test/index.vue b/ui/src/views/knowledge-detail/recall-test/index.vue
deleted file mode 100644
index dcdf8e3008f..00000000000
--- a/ui/src/views/knowledge-detail/recall-test/index.vue
+++ /dev/null
@@ -1,10 +0,0 @@
-<script setup lang="ts">
-import type { ResourceDetailPageProps } from '@/layout/ResourceDetailLayout.vue'
-defineOptions({ name: 'RecallTestView' })
-
-defineProps<ResourceDetailPageProps>()
-</script>
-
-<template>
-  <div class="flex-center min-h-0 flex-1 text-N500">召回测试功能待接入</div>
-</template>
diff --git a/ui/src/workflow-canvas/WORKFLOW_README.md b/ui/src/workflow-canvas/WORKFLOW_README.md
index 0d43dc05679..706bbcaf5d9 100644
--- a/ui/src/workflow-canvas/WORKFLOW_README.md
+++ b/ui/src/workflow-canvas/WORKFLOW_README.md
@@ -344,7 +344,8 @@ AI 对话、图片理解和视频理解统一复用 `component/ThinkingSetting.v
 知识库检索在入口维护范围、参数摘要、问题表单和关联数据；`component/SearchSetting.vue`
 封装参数按钮与弹窗，通过 `v-model` 编辑并遵循通用设置弹窗规则。范围引用加入节点表单，
 问题引用保留独立有效性检查；移除关联只清理明确取消的 ID，保留当前用户不可见的知识库。
-检索模式协议复用 `KNOWLEDGE_SEARCH_MODE`。
+检索模式协议复用 `KNOWLEDGE_SEARCH_MODE`；模式选项与说明复用知识库常量 `KNOWLEDGE_SEARCH_MODE_OPTIONS`，
+见 [常量文档](../constants/CONSTANT_README.md)。
 
 文档内容提取、多路召回和文档标签检索节点使用统一的节点标题、`mk-gray-card`、表单必填标记与
 `MkIcon`。多路召回的参数设置按钮与弹窗封装在节点 `component/SearchSetting.vue`，通过
diff --git a/ui/src/workflow-canvas/nodes/search-knowledge-node/component/SearchSetting.vue b/ui/src/workflow-canvas/nodes/search-knowledge-node/component/SearchSetting.vue
index 29362cfedd1..6d51096be3e 100644
--- a/ui/src/workflow-canvas/nodes/search-knowledge-node/component/SearchSetting.vue
+++ b/ui/src/workflow-canvas/nodes/search-knowledge-node/component/SearchSetting.vue
@@ -3,7 +3,8 @@ import { ref, useTemplateRef } from 'vue'
 import { cloneDeep } from 'lodash'
 import type { FormInstance } from 'element-plus'
 import { KNOWLEDGE_SEARCH_MODE } from '@/api/enums'
-import { defaultSearchSetting, searchModeOptions } from '../constant'
+import { defaultSearchSetting } from '../constant'
+import { KNOWLEDGE_SEARCH_MODE_OPTIONS } from '@/constants/knowledge'
 import type { KnowledgeSearchSetting } from '../types'
 
 defineOptions({ name: 'SearchKnowledgeSetting' })
@@ -42,7 +43,7 @@ function resetData() {
     <el-form ref="formRef" :model="formData" label-position="top" require-asterisk-position="right" @submit.prevent>
       <el-form-item label="检索模式">
         <el-radio-group v-model="formData.search_mode" class="space-y-2" @change="changeSearchMode">
-          <template v-for="option in searchModeOptions" :key="option.value">
+          <template v-for="option in KNOWLEDGE_SEARCH_MODE_OPTIONS" :key="option.value">
             <el-card shadow="hover" class="w-full" :class="{ 'border-primary!': formData.search_mode === option.value }">
               <el-radio :value="option.value" class="mk-card-radio">
                 <h6>{{ option.label }}</h6>
diff --git a/ui/src/workflow-canvas/nodes/search-knowledge-node/constant.ts b/ui/src/workflow-canvas/nodes/search-knowledge-node/constant.ts
index f4da25cdeb3..ec7033ce1c3 100644
--- a/ui/src/workflow-canvas/nodes/search-knowledge-node/constant.ts
+++ b/ui/src/workflow-canvas/nodes/search-knowledge-node/constant.ts
@@ -7,17 +7,3 @@ export const defaultSearchSetting: KnowledgeSearchSetting = {
   max_paragraph_char_number: 5000,
   search_mode: KNOWLEDGE_SEARCH_MODE.EMBEDDING,
 }
-
-export const searchModeOptions = [
-  {
-    value: KNOWLEDGE_SEARCH_MODE.EMBEDDING,
-    label: '向量检索',
-    description: '向量检索是一种基于向量相似度的检索方式，适用于知识库中的大数据量场景。',
-  },
-  { value: KNOWLEDGE_SEARCH_MODE.KEYWORDS, label: '全文检索', description: '全文检索是一种基于文本相似度的检索方式，适用于知识库中的小数据量场景。' },
-  {
-    value: KNOWLEDGE_SEARCH_MODE.BLEND,
-    label: '混合检索',
-    description: '混合检索是一种基于向量和文本相似度的检索方式，适用于知识库中的中等数据量场景。',
-  },
-]
diff --git a/ui/src/workflow-canvas/nodes/search-knowledge-node/index.vue b/ui/src/workflow-canvas/nodes/search-knowledge-node/index.vue
index bbff3898132..55186f89bf3 100644
--- a/ui/src/workflow-canvas/nodes/search-knowledge-node/index.vue
+++ b/ui/src/workflow-canvas/nodes/search-knowledge-node/index.vue
@@ -9,7 +9,8 @@ import type { WorkflowNodeModel } from '@/workflow-canvas/core/workflow-node'
 import NodeSearchScope from '@/workflow-canvas/component/node-search-scope/index.vue'
 import type { NodeSearchScopeData } from '@/workflow-canvas/component/node-search-scope/types'
 import SearchSetting from './component/SearchSetting.vue'
-import { defaultSearchSetting, searchModeOptions } from './constant.ts'
+import { defaultSearchSetting } from './constant.ts'
+import { KNOWLEDGE_SEARCH_MODE_OPTIONS } from '@/constants/knowledge'
 import type { SearchKnowledgeNodeForm } from './types'
 
 defineOptions({ name: 'WorkflowSearchKnowledgeNode' })
@@ -70,7 +71,7 @@ const settingRows = computed(() => [
   {
     label: '检索模式',
     value:
-      searchModeOptions.find(({ value }) => value === formData.value.knowledge_setting.search_mode)?.label ??
+      KNOWLEDGE_SEARCH_MODE_OPTIONS.find(({ value }) => value === formData.value.knowledge_setting.search_mode)?.label ??
       formData.value.knowledge_setting.search_mode,
   },
   { label: '相似度高于', value: formData.value.knowledge_setting.similarity.toFixed(3) },

From 1533114fa04283b8c620a4ff05fc2ded113c832d Mon Sep 17 00:00:00 2001
From: wangdan-fit2cloud <dan.wang@fit2cloud.com>
Date: Fri, 16 Oct 2026 14:19:53 +0800
Subject: [PATCH 2/2] feat: image paragraph

---
 ui/src/views/VIEW_README.md                   |  3 +-
 ui/src/views/knowledge-detail/context.ts      | 14 +++++++
 .../upload-document/UploadDocumentDrawer.vue  |  2 +-
 .../knowledge-detail/library/image/index.vue  | 42 ++++++++++++++-----
 .../image/upload-image/UploadImageDrawer.vue  |  2 +-
 5 files changed, 50 insertions(+), 13 deletions(-)

diff --git a/ui/src/views/VIEW_README.md b/ui/src/views/VIEW_README.md
index 80b06c74a24..163251ad058 100644
--- a/ui/src/views/VIEW_README.md
+++ b/ui/src/views/VIEW_README.md
@@ -106,7 +106,7 @@
 
 `knowledge-detail/context.ts` 仅通过 `provideKnowledgeDetailContext` 和
 `useKnowledgeDetailContext` 公开详情、更新能力、ID、来源导航及完整 API。
-`resourceApi.knowledge / scheduledSync / document / image / tags / termbase / chatUser / externalRetrieval` 按当前范围响应式读取，无需 `.value`，
+`resourceApi.knowledge / scheduledSync / document / paragraph / image / tags / termbase / chatUser / externalRetrieval` 按当前范围响应式读取，无需 `.value`，
 不要在 setup 时解构具体 API。`workflow` 当前仅普通 Workspace 提供，其他范围不回退。
 共有查询方法必填，部分范围缺失的方法可选调用；未发请求时不提示成功、不关闭、不刷新或修改快照，loading 正常清理。
 不增加查询／维护双入口、接口别名或专属 Context hook，也不以方法存在性新增操作显隐规则。
@@ -150,6 +150,7 @@ System 资源管理或 System 共享 Knowledge API 的 `postKnowledgeHitTest`；
 `library/document/index.vue` 管理查询、分页、选择、启停及刷新；Action 管理各自请求和浮层。
 `library/image/index.vue` 使用独立列表入口，复用 `document/` 的状态、展示组件及 Action，
 查询与操作沿用 Document API；图片列表的查询参数差异见 [API 文档](../api/API_README.md#文档与分段)。
+点击图片行通过 `resourceApi.paragraph.getParagraphPage` 查询首个分段，使用 `ParagraphDialog` 展示详情；弹窗按需挂载，关闭动画结束后卸载。
 图片上传独立放在 `image/upload-image/`，`ButtonUploadImage` 管理入口与按需挂载，
 `UploadImageDrawer` 分为上传图片、图片处理两步，复用 `MkDragUpload` 的多文件图片模式暂存文件；
 `ImageProcessingForm` 管理视觉增强策略及模型／工具选项，不展示文档分段与索引设置。
diff --git a/ui/src/views/knowledge-detail/context.ts b/ui/src/views/knowledge-detail/context.ts
index e584f7cdd79..36711cfddcc 100644
--- a/ui/src/views/knowledge-detail/context.ts
+++ b/ui/src/views/knowledge-detail/context.ts
@@ -13,6 +13,10 @@ import DocumentApi from '@/api/admin/workspace/knowledge/document'
 import SharedDocumentApi from '@/api/admin/workspace/shared/knowledge/document'
 import SystemResourceDocumentApi from '@/api/admin/system/resource-management/knowledge/document'
 import SystemSharedDocumentApi from '@/api/admin/system/shared-resources/knowledge/document'
+import ParagraphApi from '@/api/admin/workspace/knowledge/paragraph'
+import SharedParagraphApi from '@/api/admin/workspace/shared/knowledge/paragraph'
+import SystemResourceParagraphApi from '@/api/admin/system/resource-management/knowledge/paragraph'
+import SystemSharedParagraphApi from '@/api/admin/system/shared-resources/knowledge/paragraph'
 import TagsApi from '@/api/admin/workspace/knowledge/tags'
 import SharedTagsApi from '@/api/admin/workspace/shared/knowledge/tags'
 import SystemResourceTagsApi from '@/api/admin/system/resource-management/knowledge/tags'
@@ -44,6 +48,9 @@ type OptionalApiMethods<Api> = Pick<Api, keyof Api> & {
 }
 
 interface KnowledgeResourceApi {
+  readonly paragraph: OptionalApiMethods<
+    typeof ParagraphApi | typeof SharedParagraphApi | typeof SystemResourceParagraphApi | typeof SystemSharedParagraphApi
+  >
   readonly chatUser: OptionalApiMethods<
     typeof ChatUserApi | typeof SharedChatUserApi | typeof SystemResourceChatUserApi | typeof SystemSharedChatUserApi
   >
@@ -82,6 +89,7 @@ const resourceConfigs = {
       scheduledSync: ScheduledSyncApi,
       externalRetrieval: ExternalRetrievalApi,
       document: DocumentApi,
+      paragraph: ParagraphApi,
       image: ImageApi,
       tags: TagsApi,
       termbase: TermbaseApi,
@@ -96,6 +104,7 @@ const resourceConfigs = {
       scheduledSync: SharedScheduledSyncApi,
       externalRetrieval: SharedExternalRetrievalApi,
       document: SharedDocumentApi,
+      paragraph: SharedParagraphApi,
       tags: SharedTagsApi,
       termbase: SharedTermbaseApi,
     },
@@ -108,6 +117,7 @@ const resourceConfigs = {
       scheduledSync: SystemResourceScheduledSyncApi,
       externalRetrieval: SystemResourceExternalRetrievalApi,
       document: SystemResourceDocumentApi,
+      paragraph: SystemResourceParagraphApi,
       image: SystemResourceImageApi,
       tags: SystemResourceTagsApi,
       termbase: SystemResourceTermbaseApi,
@@ -121,6 +131,7 @@ const resourceConfigs = {
       scheduledSync: SystemSharedScheduledSyncApi,
       externalRetrieval: SystemSharedExternalRetrievalApi,
       document: SystemSharedDocumentApi,
+      paragraph: SystemSharedParagraphApi,
       tags: SystemSharedTagsApi,
       termbase: SystemSharedTermbaseApi,
     },
@@ -163,6 +174,9 @@ function createKnowledgeDetailContext(state: KnowledgeDetailState): KnowledgeDet
     get document() {
       return resourceConfig.value.resourceApi.document
     },
+    get paragraph() {
+      return resourceConfig.value.resourceApi.paragraph
+    },
     get tags() {
       return resourceConfig.value.resourceApi.tags
     },
diff --git a/ui/src/views/knowledge-detail/library/document/upload-document/UploadDocumentDrawer.vue b/ui/src/views/knowledge-detail/library/document/upload-document/UploadDocumentDrawer.vue
index b62650454c2..8ca8bdd6486 100644
--- a/ui/src/views/knowledge-detail/library/document/upload-document/UploadDocumentDrawer.vue
+++ b/ui/src/views/knowledge-detail/library/document/upload-document/UploadDocumentDrawer.vue
@@ -72,7 +72,7 @@ function handleGeneratePreview() {
   if (!validateImportFiles() || !strategyRef.value) return
   const fileIds = successfulFiles.value.flatMap((file) => (file.file_id ? [file.file_id] : []))
   if (fileIds.length !== successfulFiles.value.length) {
-    MsgWarning('文件上传结果缺少文件 ID，请重新上传')
+    MsgWarning('没有上传成功的文件，请重新上传')
     return
   }
   loading.value = true
diff --git a/ui/src/views/knowledge-detail/library/image/index.vue b/ui/src/views/knowledge-detail/library/image/index.vue
index 9071a3dda96..65e95f05599 100644
--- a/ui/src/views/knowledge-detail/library/image/index.vue
+++ b/ui/src/views/knowledge-detail/library/image/index.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { computed, onBeforeUnmount, onMounted, ref } from 'vue'
+import { computed, nextTick, onBeforeUnmount, onMounted, ref } from 'vue'
 import { useRoute } from 'vue-router'
 import type { CascaderOption, TableColumnCtx } from 'element-plus'
 import MkEditName from '@/components/mk-edit-name/index.vue'
@@ -9,13 +9,15 @@ import CommonSystemApi from '@/api/admin/system/common'
 import { DOCUMENT_RESOURCE_TYPE, DOCUMENT_TASK_TYPE } from '@/api/enums'
 import { DOCUMENT_HIT_HANDLING_LABELS } from '@/constants/document'
 import { DOCUMENT_STATUS_FILTER_OPTIONS } from '../document/status'
-import type { Dict, DocumentHitHandling, DocumentItem, OptionItem } from '@/api/types'
+import type { Dict, DocumentHitHandling, DocumentItem, OptionItem, ParagraphItem } from '@/api/types'
 import { datetimeFormat } from '@/utils/time'
 import { numberFormat } from '@/utils/number'
+import { getFileUrl } from '@/utils/common'
 import { MsgSuccess } from '@/utils/message'
 import { isWorkspaceResource, isWorkspaceSharedResource } from '@/utils/resource-context'
 import ButtonUploadImage from './upload-image/ButtonUploadImage.vue'
 import { useKnowledgeDetailContext } from '@/views/knowledge-detail/context'
+import ParagraphDialog from '@/views/document-detail/paragraph-dialog/ParagraphDialog.vue'
 import DocumentStatus from '../document/components/DocumentStatus.vue'
 import DocumentTags from '../document/components/DocumentTags.vue'
 import {
@@ -43,14 +45,26 @@ const route = useRoute()
 const knowledgeId = computed(() => String(route.params.knowledgeId ?? ''))
 const { knowledge, resourceApi } = useKnowledgeDetailContext()
 
-/* 文档分段入口：选择列与行内操作继续处理自身交互。 */
+/* 图片分段详情：取首个分段，弹窗关闭后卸载。 */
+const paragraphDialogRef = ref<InstanceType<typeof ParagraphDialog>>()
+const selectedParagraph = ref<ParagraphItem>()
+
 function handleOpenParagraph(document: DocumentItem, column?: TableColumnCtx<DocumentItem> | null) {
-  if (loading.value || operationLoading.value || column?.type === 'selection') return
-  // void router.push({
-  //   name: routeNames.value.paragraph,
-  //   params: { ...routeParams.value, type: knowledgeType.value, documentId: document.id },
-  //   query: route.query,
-  // })
+  if (loading.value || operationLoading.value || selectedParagraph.value || column?.type === 'selection') return
+  operationLoading.value = true
+  return resourceApi.paragraph
+    .getParagraphPage(knowledgeId.value, document.id, { currentPage: 1, pageSize: 1 })
+    .then(async (page) => {
+      const paragraph = page.records[0]
+      if (!paragraph) return
+      selectedParagraph.value = paragraph
+      await nextTick()
+      paragraphDialogRef.value?.open(paragraph)
+    })
+    .catch(() => {})
+    .finally(() => {
+      operationLoading.value = false
+    })
 }
 
 /* 文档名称编辑 */
@@ -301,7 +315,7 @@ onBeforeUnmount(() => {
         >
           <template #prefix>
             <!-- 图片 -->
-            <!-- <el-image :src="file.url || file.previewUrl" :alt="file.name" :title="file.name" fit="cover" /> -->
+            <el-image class="h-7.5! w-7.5!" :src="getFileUrl(row.meta?.source_file_id as string | undefined)" :alt="row.name" fit="cover" />
           </template>
         </MkEditName>
       </template>
@@ -577,4 +591,12 @@ onBeforeUnmount(() => {
       </MkDropdown>
     </template>
   </MkTable>
+  <ParagraphDialog
+    v-if="selectedParagraph"
+    ref="paragraphDialogRef"
+    :knowledge-id="knowledgeId"
+    :document-id="selectedParagraph.document_id"
+    @success="refreshAfterOperation"
+    @closed="selectedParagraph = undefined"
+  />
 </template>
diff --git a/ui/src/views/knowledge-detail/library/image/upload-image/UploadImageDrawer.vue b/ui/src/views/knowledge-detail/library/image/upload-image/UploadImageDrawer.vue
index 9b9589c6df5..9e80e89fdc7 100644
--- a/ui/src/views/knowledge-detail/library/image/upload-image/UploadImageDrawer.vue
+++ b/ui/src/views/knowledge-detail/library/image/upload-image/UploadImageDrawer.vue
@@ -68,7 +68,7 @@ function handleGeneratePreview() {
   if (!validateFiles() || !processingRef.value) return
   const fileIds = successfulFiles.value.flatMap((file) => (file.file_id ? [file.file_id] : []))
   if (fileIds.length !== successfulFiles.value.length) {
-    MsgWarning('文件上传结果缺少文件 ID，请重新上传')
+    MsgWarning('没有上传成功的文件，请重新上传')
     return
   }
   loading.value = true