@dxpos/knowledge 0.5.0 → 0.7.0

package/dist/generated/sdk.gen.js

@@ -1,6 +1,24 @@
 // This file is auto-generated by @hey-api/openapi-ts
 import { formDataBodySerializer } from './client';
 import { client } from './client.gen';
+/**
+ * 批量删除文件
+ *
+ * 需编辑者及以上。
+ */
+export const deleteApiFiles = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/files',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
 /**
  * 列出文件
  */
@@ -121,7 +139,7 @@ export const getApiFilesByIdUrl = (options) => (options.client ?? client).get({
 /**
  * RAG 问答
  *
- * stream 默认 true，返回 NDJSON 事件流：token / node / references / done / error。stream=false 时返回 JSON 信封，data 为完整回答与引用。
+ * stream 默认 true，返回 NDJSON 事件流：token / node / references / done / error。stream=false 时返回 JSON 信封，data 为完整回答与引用。attachments 为已上传的对话图片 fileId，实际上限由配置决定，默认 4。content 与 attachments 至少传一项。排队已满或等待超时时返回 429，响应头带 Retry-After。
  */
 export const postApiChat = (options) => (options.client ?? client).post({
     security: [{ scheme: 'bearer', type: 'http' }, {
@@ -137,39 +155,23 @@ export const postApiChat = (options) => (options.client ?? client).post({
     }
 });
 /**
- * 读取对话模块设置
+ * 读取会话生效的图片限制与欢迎语
  *
- * 需编辑者及以上。空字段表示继承全局设置。
+ * 按会话 > RAG 配置 > 全局 > 代码默认合并图片数量上限与压缩最长边；并返回生效的欢迎语与推荐问题（RAG > 全局）。
  */
-export const getApiChatSettings = (options) => (options?.client ?? client).get({
+export const getApiChatLimits = (options) => (options.client ?? client).get({
     security: [{ scheme: 'bearer', type: 'http' }, {
             in: 'cookie',
             name: 'authjs.session-token',
             type: 'apiKey'
         }],
-    url: '/api/chat/settings',
+    url: '/api/chat/limits',
     ...options
 });
-/**
- * 更新对话模块设置
- *
- * 需编辑者及以上。空字段表示继承全局设置。
- */
-export const putApiChatSettings = (options) => (options.client ?? client).put({
-    security: [{ scheme: 'bearer', type: 'http' }, {
-            in: 'cookie',
-            name: 'authjs.session-token',
-            type: 'apiKey'
-        }],
-    url: '/api/chat/settings',
-    ...options,
-    headers: {
-        'Content-Type': 'application/json',
-        ...options.headers
-    }
-});
 /**
  * 列出会话
+ *
+ * 管理员可传 userId 查看指定用户会话；ragId 可按 RAG 过滤。
  */
 export const getApiChatConversations = (options) => (options?.client ?? client).get({
     security: [{ scheme: 'bearer', type: 'http' }, {
@@ -240,6 +242,8 @@ export const patchApiChatConversationsById = (options) => (options.client ?? cli
 });
 /**
  * 关键词检索文档
+ *
+ * kbId 与 mark 不能同时为空，同时传入按 AND 匹配。
  */
 export const getApiSearch = (options) => (options.client ?? client).get({
     security: [{ scheme: 'bearer', type: 'http' }, {
@@ -250,3 +254,345 @@ export const getApiSearch = (options) => (options.client ?? client).get({
     url: '/api/search',
     ...options
 });
+/**
+ * 上报检索结果点击
+ */
+export const postApiSearchClick = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/search/click',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 列出知识库
+ */
+export const getApiKnowledgeBases = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/knowledge-bases',
+    ...options
+});
+/**
+ * 创建知识库
+ *
+ * 需管理员。mark 为知识库唯一标识，不可包含逗号。
+ */
+export const postApiKnowledgeBases = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/knowledge-bases',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 删除知识库
+ *
+ * 需管理员。删除会级联清理其下文档与分块。
+ */
+export const deleteApiKnowledgeBasesById = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/knowledge-bases/{id}',
+    ...options
+});
+/**
+ * 获取知识库
+ */
+export const getApiKnowledgeBasesById = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/knowledge-bases/{id}',
+    ...options
+});
+/**
+ * 更新知识库
+ *
+ * 需管理员。
+ */
+export const patchApiKnowledgeBasesById = (options) => (options.client ?? client).patch({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/knowledge-bases/{id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 列出 RAG 配置
+ */
+export const getApiRags = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/rags',
+    ...options
+});
+/**
+ * 创建 RAG 配置
+ *
+ * 绑定知识库与对话模块配置。mark 不可包含逗号。
+ */
+export const postApiRags = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/rags',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 删除 RAG 配置
+ */
+export const deleteApiRagsById = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/rags/{id}',
+    ...options
+});
+/**
+ * 获取 RAG 配置
+ */
+export const getApiRagsById = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/rags/{id}',
+    ...options
+});
+/**
+ * 更新 RAG 配置
+ *
+ * 空字段表示继承全局默认。
+ */
+export const patchApiRagsById = (options) => (options.client ?? client).patch({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/rags/{id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 按 id / mark 获取 RAG 配置摘要
+ *
+ * id 与 mark 不能同时为空，同时传入按 AND 匹配。返回 id/name/mark/welcome/recommendedQuestions。
+ */
+export const getApiRagsDetail = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/rags/detail',
+    ...options
+});
+/**
+ * 清空知识库文档
+ *
+ * 需编辑者及以上。按 kbId 清空该知识库全部文档与分块。
+ */
+export const deleteApiDocuments = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/documents',
+    ...options
+});
+/**
+ * 列出知识库文档
+ */
+export const getApiDocuments = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/documents',
+    ...options
+});
+/**
+ * 创建空白文档或上传 Markdown
+ *
+ * Content-Type 为 application/json 时创建空白文档（kbId 由 query 传入）；为 multipart/form-data 时上传 Markdown 文件，返回 NDJSON 进度事件流。需编辑者及以上。
+ */
+export const postApiDocuments = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/documents',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 按知识库 mark 获取文档树
+ *
+ * 仅支持 mark 查询，返回嵌套文档树（文件夹优先，名称按中文排序）。
+ */
+export const getApiDocumentsTree = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/documents/tree',
+    ...options
+});
+/**
+ * 删除文档
+ *
+ * 需编辑者及以上。
+ */
+export const deleteApiDocumentsById = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/documents/{id}',
+    ...options
+});
+/**
+ * 获取文档
+ */
+export const getApiDocumentsById = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/documents/{id}',
+    ...options
+});
+/**
+ * 更新文档
+ *
+ * 需编辑者及以上。修改内容会重新分块与向量化。
+ */
+export const patchApiDocumentsById = (options) => (options.client ?? client).patch({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/documents/{id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 列出文件夹
+ *
+ * kbId 与 mark 不能同时为空，同时传入按 AND 匹配。
+ */
+export const getApiFolders = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/folders',
+    ...options
+});
+/**
+ * 创建文件夹
+ *
+ * 需编辑者及以上。同级文件夹与文档不能重名。
+ */
+export const postApiFolders = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/folders',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * 删除文件夹
+ *
+ * 需编辑者及以上。级联删除子目录与文档。
+ */
+export const deleteApiFoldersById = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/folders/{id}',
+    ...options
+});
+/**
+ * 更新文件夹
+ *
+ * 需编辑者及以上。可重命名、移动或修改可见性。
+ */
+export const patchApiFoldersById = (options) => (options.client ?? client).patch({
+    security: [{ scheme: 'bearer', type: 'http' }, {
+            in: 'cookie',
+            name: 'authjs.session-token',
+            type: 'apiKey'
+        }],
+    url: '/api/folders/{id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});