wangdan-fit2cloud · Oct 8, 2026 · Oct 8, 2026
diff --git a/ui/src/api/API_README.md b/ui/src/api/API_README.md
@@ -143,6 +143,9 @@ v3 编辑表单提交 `{ name, description }`，标题上限 64、更新说明
 
 ### 模型选项查询
 
+`model-provider.ts` 的 `getProviderList(query?)` 统一查询 `GET /provider`；不传参数获取全部供应商，
+传入 `{ model_type }` 筛选支持指定模型类型的供应商，不再单独封装按类型查询方法。
+
 `workspace/model.ts` 的 `getModelListWithShared(query)` 请求
 `/workspace/<workspaceId>/model_list`，支持 `name`、`model_type`、`model_name` 筛选。
 将 `shared_model` 与 `model` 按共享在前的顺序合并为 `ModelItem[]`，分别标记
@@ -422,8 +425,10 @@ API 对象和工作空间上下文，作为该抽屉的范围选择例外；用
 
 `workspace/tool/workflow.ts` 的 `postToolWorkflowDebug(toolId, parameters)` 使用 Admin `postStream`
 请求 `/<toolId>/debug`，返回原始 SSE Response；输入参数来自工具基础节点，`chat_record_id` 用于识别
-执行记录，表单续跑沿用该 ID 并传入 `position`。`getToolWorkflowRecord(toolId, recordId)` 查询
-`/<toolId>/tool_record/<recordId>`，返回 `ToolWorkflowRecord` 的运行状态、输出及节点详情。
+执行记录，表单续跑沿用该 ID 并传入 `position`。调试结果与执行详情统一通过
+`getToolExecutionRecordDetail(toolId, recordId)` 查询 `/<toolId>/tool_record/<recordId>`，
+返回 `ToolExecutionRecordDetail` 的运行状态、输出及节点详情。Workspace、System 资源管理和
+System 共享资源分别保留各自路径下的同名接口，不再重复封装调试专用查询。
 工具调试读取服务端已保存工作流，画布页面在调试前保存未提交改动。
 
 ### 工具工作流模板中心
@@ -485,6 +490,8 @@ Admin 上传尚未创建的资源文件时，`sourceId` 可传 `undefined`，省
 资源类型使用 `@/api/enums` 的 `FILE_SOURCE_TYPE` 与 `@/api/types` 的 `FileSourceType`，
 包括知识库、智能体、工具、文档、对话及三种临时文件有效期。对话 Store 使用
 `FILE_SOURCE_TYPE.CHAT` 调用对应 File API，对话 API 不再维护上传接口。
+知识库工作流调试上传复用 Admin `FileApi.postUploadFile`，传知识库 ID 与 `FILE_SOURCE_TYPE.KNOWLEDGE`，
+通过返回的 `request` 获取文件地址，再适配动态表单的 `{ data: url }` 返回协议；工作流 API 不重复封装上传。
 
 ### System 资源管理模型与工具
 
@@ -517,6 +524,11 @@ System 接口由资源管理服务提供；本地开源后端没有对应扩展
 
 ### 知识库文档
 
+`putDocument(knowledgeId, documentId, data)` 统一通过 PUT `/<documentId>` 更新名称、启用状态和单项设置，
+不按更新字段重复封装同一接口。载荷 `DocumentUpdatePayload` 仅包含可更新字段，按需传入
+`name`、`is_active`、`hit_handling_method`、`directly_return_similarity`、`meta`，返回更新后的
+`DocumentItem`。名称上限 128 字符；共享文档仍只提供查询。
+
 `workspace/knowledge/document.ts` 同时维护文档启停、删除、召回设置、向量化、分词索引、
 任务取消、生成问题、迁移、同步、导出、原文件下载/替换及标签关联。
 批量任务沿用 v2 的 `id_list` / `state_list`；生成问题使用 `document_id_list`，

diff --git a/ui/src/api/admin/model-provider.ts b/ui/src/api/admin/model-provider.ts
@@ -3,14 +3,9 @@ import type { BaseModelOption, DynamicFormField, ModelProviderItem, ModelTypeOpt
 
 const prefix = '/provider'
 
-/** 获取全部模型供应商。 */
-const getProviderList = () => {
-  return get<ModelProviderItem[]>(prefix)
-}
-
-/** 获取支持指定模型类型的供应商。 */
-const getProviderListByModelType = (modelType: string) => {
-  return get<ModelProviderItem[]>(prefix, { model_type: modelType })
+/** 获取模型供应商，可按模型类型筛选。 */
+const getProviderList = (query?: { model_type?: string }) => {
+  return get<ModelProviderItem[]>(prefix, query)
 }
 
 /** 获取创建模型所需的动态表单。 */
@@ -33,4 +28,4 @@ const getBaseModelList = (provider: string, modelType: string) => {
   return get<BaseModelOption[]>(`${prefix}/model_list`, { model_type: modelType, provider })
 }
 
-export default { getBaseModelList, getBaseModelParamsForm, getModelCreateForm, getModelTypeList, getProviderList, getProviderListByModelType }
+export default { getBaseModelList, getBaseModelParamsForm, getModelCreateForm, getModelTypeList, getProviderList }
diff --git a/ui/src/api/admin/system/resource-management/tool/tool-workflow.ts b/ui/src/api/admin/system/resource-management/tool/tool-workflow.ts
@@ -7,7 +7,6 @@ import type {
   ToolExecutionRecord,
   ToolExecutionRecordDetail,
   ToolWorkflowDetail,
-  ToolWorkflowRecord,
   WorkflowStoreTemplate,
   WorkflowVersion,
   WorkflowVersionPayload,
@@ -39,9 +38,6 @@ const putToolWorkflowPublish = (toolId: string) => {
 const postToolWorkflowDebug = (toolId: string, parameters: Record<string, unknown>) =>
   postStream(ADMIN_API_BASE_PATH, `${prefix}/${toolId}/debug`, parameters)
 
-/** 查询工具工作流调试的输出和节点执行记录。 */
-const getToolWorkflowRecord = (toolId: string, recordId: string) => get<ToolWorkflowRecord>(`${prefix}/${toolId}/tool_record/${recordId}`)
-
 /** 获取工具发布历史，按发布时间倒序返回完整版本快照。 */
 const getWorkflowVersions = (toolId: string) => get<WorkflowVersion[]>(`${prefix}/${toolId}/tool_version`)
 
@@ -68,5 +64,4 @@ export default {
   putToolWorkflow,
   putToolWorkflowPublish,
   postToolWorkflowDebug,
-  getToolWorkflowRecord,
 }
diff --git a/ui/src/api/admin/system/shared-resources/tool/tool-workflow.ts b/ui/src/api/admin/system/shared-resources/tool/tool-workflow.ts
@@ -7,7 +7,6 @@ import type {
   ToolExecutionRecord,
   ToolExecutionRecordDetail,
   ToolWorkflowDetail,
-  ToolWorkflowRecord,
   WorkflowStoreTemplate,
   WorkflowVersion,
   WorkflowVersionPayload,
@@ -39,9 +38,6 @@ const putToolWorkflowPublish = (toolId: string) => {
 const postToolWorkflowDebug = (toolId: string, parameters: Record<string, unknown>) =>
   postStream(ADMIN_API_BASE_PATH, `${prefix}/${toolId}/debug`, parameters)
 
-/** 查询工具工作流调试的输出和节点执行记录。 */
-const getToolWorkflowRecord = (toolId: string, recordId: string) => get<ToolWorkflowRecord>(`${prefix}/${toolId}/tool_record/${recordId}`)
-
 /** 获取工具发布历史，按发布时间倒序返回完整版本快照。 */
 const getWorkflowVersions = (toolId: string) => get<WorkflowVersion[]>(`${prefix}/${toolId}/tool_version`)
 
@@ -68,5 +64,4 @@ export default {
   putToolWorkflow,
   putToolWorkflowPublish,
   postToolWorkflowDebug,
-  getToolWorkflowRecord,
 }
diff --git a/ui/src/api/admin/workspace/application/chat-log.ts b/ui/src/api/admin/workspace/application/chat-log.ts
@@ -30,10 +30,6 @@ const getChatRecordLog = (applicationId: string, chatId: string, page: ParamsPag
     order_asc: orderAsc,
   })
 
-/** 获取聊天记录详情。 */
-const getChatRecordDetails = (applicationId: string, chatId: string, chatRecordId: string) =>
-  get<Dict<unknown>>(`${getPrefix()}/${applicationId}/chat/${chatId}/chat_record/${chatRecordId}`)
-
 /** 获取聊天记录的标注段落。 */
 const getMarkChatRecord = (applicationId: string, chatId: string, chatRecordId: string) =>
   get<Dict<unknown>[]>(`${getPrefix()}/${applicationId}/chat/${chatId}/chat_record/${chatRecordId}/improve`)
@@ -67,7 +63,6 @@ export default {
   putChatLogCleanTime,
   postChatLogAddKnowledge,
   getChatRecordLog,
-  getChatRecordDetails,
   getMarkChatRecord,
   putChatRecordLog,
   deleteMarkChatRecord,

diff --git a/ui/src/api/admin/workspace/knowledge/document.ts b/ui/src/api/admin/workspace/knowledge/document.ts
@@ -8,6 +8,7 @@ import type {
   DocumentSettingPayload,
   DocumentTaskState,
   DocumentTaskType,
+  DocumentUpdatePayload,
 } from '@/api/types'
 import { getWorkspaceId } from '@/utils/resource-context'
 
@@ -21,9 +22,9 @@ const getDocumentPage = (knowledgeId: string, page: ParamsPage, query?: Dict<unk
 const putQuickCreateDocuments = (knowledgeId: string, documents: DocumentQuickCreatePayload[]) =>
   put<DocumentQuickCreatePayload[], DocumentItem[]>(`${getPrefix(knowledgeId)}/batch_create`, documents)
 
-/** 更新文档启用状态。 */
-const putDocumentActive = (knowledgeId: string, documentId: string, isActive: boolean) =>
-  put(`${getPrefix(knowledgeId)}/${documentId}`, { is_active: isActive })
+/** 更新文档名称、启用状态或设置，返回保存后的文档。 */
+const putDocument = (knowledgeId: string, documentId: string, data: DocumentUpdatePayload) =>
+  put<DocumentUpdatePayload, DocumentItem>(`${getPrefix(knowledgeId)}/${documentId}`, data)
 
 /** 删除单个文档。 */
 const deleteDocument = (knowledgeId: string, documentId: string) => del(`${getPrefix(knowledgeId)}/${documentId}`)
@@ -75,10 +76,6 @@ const putLarkDocumentSync = (knowledgeId: string, documentId: string) =>
 const putMulLarkSyncDocument = (knowledgeId: string, documentIds: string[]) =>
   put<{ id_list: string[] }, boolean>(`/workspace/${getWorkspaceId()}/knowledge/lark/${knowledgeId}/_batch`, { id_list: documentIds })
 
-/** 单个文档设置。 */
-const putDocumentSetting = (knowledgeId: string, documentId: string, data: DocumentSettingPayload) =>
-  put(`${getPrefix(knowledgeId)}/${documentId}`, data)
-
 /** 批量文档设置。 */
 const putBatchDocumentSetting = (knowledgeId: string, documentIds: string[], data: DocumentSettingPayload) =>
   put(`${getPrefix(knowledgeId)}/batch_hit_handling`, { ...data, id_list: documentIds })
@@ -117,7 +114,7 @@ const postReplaceDocumentSource = (knowledgeId: string, documentId: string, file
 export default {
   getDocumentPage,
   putQuickCreateDocuments,
-  putDocumentActive,
+  putDocument,
   deleteDocument,
   putBatchDeleteDocuments,
   putDocumentRefresh,
@@ -126,7 +123,6 @@ export default {
   putBatchTokenizeDocuments,
   putCancelTask,
   putBatchCancelDocumentTask,
-  putDocumentSetting,
   putBatchDocumentSetting,
   putGenerateDocumentQuestions,
   putMigrateDocuments,

diff --git a/ui/src/api/admin/workspace/knowledge/workflow.ts b/ui/src/api/admin/workspace/knowledge/workflow.ts
@@ -46,15 +46,6 @@ const putKnowledgeWorkflowPublish = (knowledgeId: string) => {
   return put<undefined, boolean>(`${getPrefix()}/${knowledgeId}/publish`)
 }
 
-/** 上传知识库调试文件，返回文件访问地址（末段为 file_id）。 */
-const postKnowledgeUploadFile = (knowledgeId: string, file: File) => {
-  const payload = new FormData()
-  payload.append('file', file)
-  payload.append('source_id', knowledgeId)
-  payload.append('source_type', 'KNOWLEDGE')
-  return post<FormData, string>('/oss/file', payload)
-}
-
 /** 获取数据源节点的动态表单配置。 */
 const getKnowledgeWorkflowFormList = (knowledgeId: string, type: 'local' | 'tool', id: string, node: Dict<unknown>) => {
   return post<{ node: Dict<unknown> }, Dict<unknown>[]>(`${getPrefix()}/${knowledgeId}/datasource/${type}/${id}/form_list`, { node })
@@ -97,7 +88,6 @@ export default {
   postKnowledgeWorkflow,
   putKnowledgeWorkflow,
   putKnowledgeWorkflowPublish,
-  postKnowledgeUploadFile,
   getKnowledgeWorkflowFormList,
   postKnowledgeWorkflowDebug,
   getKnowledgeWorkflowAction,

diff --git a/ui/src/api/admin/workspace/tool/workflow.ts b/ui/src/api/admin/workspace/tool/workflow.ts
@@ -7,7 +7,6 @@ import type {
   ToolExecutionRecord,
   ToolExecutionRecordDetail,
   ToolWorkflowDetail,
-  ToolWorkflowRecord,
   WorkflowStoreTemplate,
   WorkflowVersion,
   WorkflowVersionPayload,
@@ -43,9 +42,6 @@ const putToolWorkflowPublish = (toolId: string) => {
 const postToolWorkflowDebug = (toolId: string, parameters: Record<string, unknown>) =>
   postStream(ADMIN_API_BASE_PATH, `${getPrefix()}/${toolId}/debug`, parameters)
 
-/** 查询工具工作流调试的输出和节点执行记录。 */
-const getToolWorkflowRecord = (toolId: string, recordId: string) => get<ToolWorkflowRecord>(`${getPrefix()}/${toolId}/tool_record/${recordId}`)
-
 /** 获取工具发布历史，按发布时间倒序返回完整版本快照。 */
 const getWorkflowVersions = (toolId: string) => get<WorkflowVersion[]>(`${getPrefix()}/${toolId}/tool_version`)
 
@@ -72,5 +68,4 @@ export default {
   putToolWorkflow,
   putToolWorkflowPublish,
   postToolWorkflowDebug,
-  getToolWorkflowRecord,
 }
diff --git a/ui/src/api/types/document.ts b/ui/src/api/types/document.ts
@@ -49,3 +49,6 @@ export interface DocumentItem {
   create_time: string
   update_time: string
 }
+
+/** 单个文档的局部更新字段。 */
+export type DocumentUpdatePayload = Partial<Pick<DocumentItem, 'name' | 'is_active' | 'hit_handling_method' | 'directly_return_similarity' | 'meta'>>
diff --git a/ui/src/api/types/tool.ts b/ui/src/api/types/tool.ts
@@ -172,19 +172,6 @@ export interface UpdateStoreToolPayload {
   versions: ToolStoreVersion[]
 }
 
-/** 工具工作流调试完成后的执行记录。 */
-export interface ToolWorkflowRecord {
-  id: string
-  state: string
-  run_time?: number
-  meta: {
-    output?: unknown
-    details?:
-      | import('@/workflow-canvas/execution-details/types').ExecutionNodeDetail[]
-      | Record<string, import('@/workflow-canvas/execution-details/types').ExecutionNodeDetail>
-  }
-}
-
 /** 工作流工具模板商店的查询响应。 */
 export interface ToolWorkflowStoreResponse {
   additionalProperties: { tags: ToolStoreTag[] }
@@ -200,7 +187,9 @@ export interface ToolExecutionRecordDetail {
     input?: unknown
     output?: unknown
     err_message?: string
-    details?: ToolWorkflowRecord['meta']['details']
+    details?:
+      | import('@/workflow-canvas/execution-details/types').ExecutionNodeDetail[]
+      | Record<string, import('@/workflow-canvas/execution-details/types').ExecutionNodeDetail>
   }
 }