@dxpos/knowledge 0.11.0 → 0.12.0

package/dist/generated/types.gen.d.ts

@@ -1,304 +1,1175 @@
 export type ClientOptions = {
     baseUrl: `${string}://${string}` | (string & {});
 };
+/**
+ * 文件状态：pending 等待上传确认，ready 可用，failed 上传失败
+ */
 export type FileStatus = 'pending' | 'ready' | 'failed';
+/**
+ * 文件归属业务：general 文件页上传，knowledge 知识库文档图片，chat 对话图片，rag 问答助手欢迎语图片，skill 技能压缩包，workflow 工作流图片
+ */
 export type FileScope = 'general' | 'knowledge' | 'chat' | 'rag' | 'skill' | 'workflow';
+/**
+ * 对象存储文件元数据
+ */
 export type StoredFile = {
+    /**
+     * 文件 ID
+     */
     id: string;
+    /**
+     * 对象存储键
+     */
     objectKey: string;
+    /**
+     * 文件名
+     */
     filename: string;
+    /**
+     * 文件大小（字节）
+     */
     size: number;
+    /**
+     * MIME 类型
+     */
     mimeType: string;
     status: FileStatus;
     scope: FileScope;
+    /**
+     * 上传人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
 };
+/**
+ * 文件列表项
+ */
 export type FileListItem = {
+    /**
+     * 文件 ID
+     */
     id: string;
+    /**
+     * 对象存储键
+     */
     objectKey: string;
+    /**
+     * 文件名
+     */
     filename: string;
+    /**
+     * 文件大小（字节）
+     */
     size: number;
+    /**
+     * MIME 类型
+     */
     mimeType: string;
     status: FileStatus;
     scope: FileScope;
+    /**
+     * 上传人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
+    /**
+     * 文件名，关键词高亮的 HTML
+     */
     filenameSnippet: string;
 };
+/**
+ * 服务端直传单个文件结果；成功时返回 file
+ */
 export type BackendUploadResult = {
+    /**
+     * 文件名
+     */
     filename: string;
+    /**
+     * 单项结果：ok 成功，error 失败（见 error）
+     */
     status: 'ok' | 'error';
     file?: StoredFile;
+    /**
+     * 失败原因，仅 status=error 时返回
+     */
     error?: string;
 };
+/**
+ * 预签名直传单个文件结果
+ */
 export type PrepareUploadResult = {
+    /**
+     * 文件名
+     */
     filename: string;
+    /**
+     * 单项结果：ok 成功，error 失败（见 error）
+     */
     status: 'ok' | 'error';
+    /**
+     * 文件 ID，确认上传时使用
+     */
     id?: string;
+    /**
+     * 对象存储键
+     */
     objectKey?: string;
+    /**
+     * 预签名 PUT 上传地址
+     */
     uploadUrl?: string;
+    /**
+     * 失败原因，仅 status=error 时返回
+     */
     error?: string;
 };
+/**
+ * 确认上传单个文件结果；成功时返回 file
+ */
 export type CompleteUploadResult = {
+    /**
+     * 文件 ID
+     */
     id: string;
+    /**
+     * 单项结果：ok 成功，error 失败（见 error）
+     */
     status: 'ok' | 'error';
     file?: StoredFile;
+    /**
+     * 公开访问地址，仅知识库文档图片（scope=knowledge）返回
+     */
     publicUrl?: string;
+    /**
+     * 失败原因，仅 status=error 时返回
+     */
     error?: string;
 };
+/**
+ * 删除单个文件结果
+ */
 export type BatchDeleteFileResult = {
+    /**
+     * 文件 ID
+     */
     id: string;
+    /**
+     * 单项结果：ok 成功，error 失败（见 error）
+     */
     status: 'ok' | 'error';
+    /**
+     * 失败原因，仅 status=error 时返回
+     */
     error?: string;
 };
+/**
+ * 引用来源：message 会话消息，chat_log 对话审计，rag_welcome 问答助手欢迎语，chat_welcome 全局欢迎语，document 知识库文档，llm_provider 模型提供商图标
+ */
 export type FileReferenceKind = 'message' | 'chat_log' | 'rag_welcome' | 'chat_welcome' | 'document' | 'llm_provider';
+/**
+ * 文件引用
+ */
 export type FileReference = {
     kind: FileReferenceKind;
+    /**
+     * 引用说明
+     */
     label: string;
+    /**
+     * 引用方 ID
+     */
     id?: string;
 };
+/**
+ * 仍被引用的文件
+ */
 export type FileReferencedItem = {
+    /**
+     * 文件 ID
+     */
     id: string;
+    /**
+     * 文件名
+     */
     filename: string;
+    /**
+     * 引用列表
+     */
     references: Array<FileReference>;
 };
+/**
+ * 文件仍被引用时的 409 响应数据
+ */
 export type FileReferencedData = {
+    /**
+     * 因仍被引用而未删除的文件
+     */
     blocked: Array<FileReferencedItem>;
 };
+/**
+ * 清理原因：pending 超时未确认上传，failed 上传失败，unreferenced 已就绪但无引用
+ */
 export type CleanupReason = 'pending' | 'failed' | 'unreferenced';
+/**
+ * 清理候选文件
+ */
 export type CleanupCandidate = {
+    /**
+     * 文件 ID
+     */
     id: string;
+    /**
+     * 对象存储键
+     */
     objectKey: string;
+    /**
+     * 文件名
+     */
     filename: string;
+    /**
+     * 文件大小（字节）
+     */
     size: number;
+    /**
+     * MIME 类型
+     */
     mimeType: string;
     status: FileStatus;
     scope: FileScope;
+    /**
+     * 上传人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
     reason: CleanupReason;
 };
+/**
+ * 失效文件清理报告
+ */
 export type CleanupReport = {
+    /**
+     * 是否仅预览
+     */
     dryRun: boolean;
+    /**
+     * 实际使用的文件创建时长阈值（小时）
+     */
     olderThanHours: number;
+    /**
+     * 实际使用的每批删除数量
+     */
     deleteBatchSize: number;
+    /**
+     * 清理候选文件
+     */
     candidates: Array<CleanupCandidate>;
+    /**
+     * 候选文件总数
+     */
     total: number;
+    /**
+     * 删除结果，仅 dryRun=false 时返回
+     */
     deleted?: Array<BatchDeleteFileResult>;
 };
+/**
+ * 消息角色：user 用户，assistant 问答助手
+ */
 export type MessageRole = 'user' | 'assistant';
+/**
+ * 用户消息图片附件
+ */
 export type MessageAttachment = {
+    /**
+     * 图片文件 ID
+     */
     fileId: string;
+    /**
+     * 图片 MIME 类型
+     */
     mimeType: string;
+    /**
+     * 当前有效的下载地址，仅响应返回
+     */
     url?: string;
 };
+/**
+ * 会话消息
+ */
 export type Message = {
+    /**
+     * 消息 ID
+     */
     id: string;
+    /**
+     * 所属会话 ID
+     */
     conversationId: string;
     role: MessageRole;
+    /**
+     * 消息正文
+     */
     content: string;
+    /**
+     * 图片附件，仅用户消息可能有值
+     */
     attachments: Array<MessageAttachment>;
+    /**
+     * 回答引用的知识库文档，仅问答助手消息可能有值
+     */
     references: Array<{
+        /**
+         * 文档 ID
+         */
         id: string;
+        /**
+         * 文档名
+         */
         filename: string;
+        /**
+         * 文档分块总数
+         */
         chunkCount: number;
+        /**
+         * 该文档命中分块的最高匹配度
+         */
         score: number;
     }>;
+    /**
+     * 输入 Token 数，仅问答助手消息有值
+     */
     promptTokens: number | null;
+    /**
+     * 输出 Token 数，仅问答助手消息有值
+     */
     completionTokens: number | null;
+    /**
+     * 总 Token 数，仅问答助手消息有值
+     */
     totalTokens: number | null;
+    /**
+     * 回答是否被中断
+     */
     aborted: boolean;
+    /**
+     * 创建人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
 };
+/**
+ * 会话
+ */
 export type Conversation = {
+    /**
+     * 会话 ID
+     */
     id: string;
+    /**
+     * 会话标题
+     */
     title: string;
+    /**
+     * 绑定的问答助手 ID；智能路由会话首问前为 null，问答助手被删除后也为 null
+     */
     ragId: number | null;
+    /**
+     * 绑定的智能路由 ID；直接绑定问答助手的会话为 null
+     */
+    routerId: number | null;
+    /**
+     * 多轮对话历史压缩摘要
+     */
     contextSummary: string | null;
+    /**
+     * 摘要覆盖到的最后一条消息 ID
+     */
     contextSummaryUpTo: string | null;
+    /**
+     * 会话归属用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
 };
+/**
+ * 流式问答 NDJSON 事件，每行一个，按 type 区分
+ */
 export type ChatEvent = {
+    /**
+     * 回答增量文本
+     */
     type: 'token';
+    /**
+     * 增量文本片段
+     */
     content: string;
 } | {
+    /**
+     * 处理节点完成
+     */
     type: 'node';
+    /**
+     * 节点名称
+     */
     name: string;
+    /**
+     * 节点状态，固定为 end
+     */
     status: 'end';
 } | {
+    /**
+     * 回答引用的知识库文档
+     */
     type: 'references';
+    /**
+     * 按匹配度降序排列
+     */
     documents: Array<{
+        /**
+         * 文档 ID
+         */
         id: string;
+        /**
+         * 文档名
+         */
         filename: string;
+        /**
+         * 文档分块总数
+         */
         chunkCount: number;
+        /**
+         * 该文档命中分块的最高匹配度
+         */
         score: number;
     }>;
 } | {
+    /**
+     * 智能路由命中，仅智能路由会话首问时返回
+     */
+    type: 'route';
+    /**
+     * 命中并绑定到会话的问答助手 ID
+     */
+    ragId: number;
+    /**
+     * 命中的问答助手名称
+     */
+    ragName: string;
+} | {
+    /**
+     * 回答结束
+     */
     type: 'done';
 } | {
+    /**
+     * 处理出错，事件流随即结束
+     */
     type: 'error';
+    /**
+     * 错误信息
+     */
     message: string;
 };
+/**
+ * 非流式问答结果；route 仅在本次触发智能路由时有值，否则为 null
+ */
 export type ChatAnswer = {
+    /**
+     * 完整回答
+     */
     answer: string;
+    /**
+     * 回答引用的知识库文档，按匹配度降序排列
+     */
     references: Array<{
+        /**
+         * 文档 ID
+         */
         id: string;
+        /**
+         * 文档名
+         */
         filename: string;
+        /**
+         * 文档分块总数
+         */
         chunkCount: number;
+        /**
+         * 该文档命中分块的最高匹配度
+         */
         score: number;
     }>;
+    route: ChatRouteResult;
 };
+/**
+ * 智能路由命中结果
+ */
+export type ChatRouteResult = {
+    /**
+     * 命中并绑定到会话的问答助手 ID
+     */
+    ragId: number;
+    /**
+     * 命中的问答助手名称
+     */
+    ragName: string;
+} | null;
+/**
+ * 知识库
+ */
 export type KnowledgeBase = {
+    /**
+     * 知识库 ID
+     */
     id: number;
+    /**
+     * 名称
+     */
     name: string;
+    /**
+     * 知识库唯一标识，不可包含逗号
+     */
     mark: string;
+    /**
+     * 描述
+     */
     description: string | null;
+    /**
+     * 文档分块大小（字符），不小于 100；null 继承全局
+     */
     chunkSize: number | null;
+    /**
+     * 相邻分块重叠字符数，需小于分块大小；null 继承全局
+     */
     chunkOverlap: number | null;
+    /**
+     * 召回时可按「字段=值」等条件过滤的文档 front matter 字段名
+     */
+    filterFields: Array<string>;
+    /**
+     * 创建人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
 };
+/**
+ * 按当前角色可见范围统计的文档数；阅览者仅统计公开文档
+ */
 export type KnowledgeBaseDocumentStats = {
+    /**
+     * 公开文档数
+     */
     public: number;
+    /**
+     * 内部文档数，阅览者不返回
+     */
     internal?: number;
+    /**
+     * 私有文档数，阅览者不返回
+     */
     private?: number;
+    /**
+     * 当前角色可见的文档总数
+     */
     total: number;
 };
+/**
+ * 知识库列表项，含文档数统计
+ */
 export type KnowledgeBaseListItem = {
+    /**
+     * 知识库 ID
+     */
     id: number;
+    /**
+     * 名称
+     */
     name: string;
+    /**
+     * 知识库唯一标识，不可包含逗号
+     */
     mark: string;
+    /**
+     * 描述
+     */
     description: string | null;
+    /**
+     * 文档分块大小（字符），不小于 100；null 继承全局
+     */
     chunkSize: number | null;
+    /**
+     * 相邻分块重叠字符数，需小于分块大小；null 继承全局
+     */
     chunkOverlap: number | null;
+    /**
+     * 召回时可按「字段=值」等条件过滤的文档 front matter 字段名
+     */
+    filterFields: Array<string>;
+    /**
+     * 创建人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
     documentStats: KnowledgeBaseDocumentStats;
 };
+/**
+ * 知识库导出包 manifest.json
+ */
+export type KnowledgeBaseManifest = {
+    /**
+     * 导出包格式版本
+     */
+    version: 1;
+    /**
+     * 导出时间
+     */
+    exportedAt: string;
+    /**
+     * 文档元数据列表
+     */
+    documents: Array<{
+        /**
+         * 文档在包内的相对路径，如 guides/setup.md
+         */
+        path: string;
+        visibility: Visibility;
+        /**
+         * 同级排序序号
+         */
+        sortOrder: number;
+    }>;
+};
+/**
+ * 可见性：public 公开，阅览者可浏览且参与问答检索；internal 内部，阅览者不可浏览但参与问答检索；private 私有，阅览者不可浏览也不参与问答检索。编辑者及以上不受限制
+ */
+export type Visibility = 'public' | 'internal' | 'private';
+/**
+ * 问答助手：绑定知识库与对话参数
+ */
 export type Rag = {
+    /**
+     * 问答助手 ID
+     */
     id: number;
+    /**
+     * 名称
+     */
     name: string;
+    /**
+     * 描述；作为智能路由候选且未填写意图时，用作意图描述
+     */
     description: string | null;
+    /**
+     * 问答助手唯一标识，可用于创建会话；不可包含逗号
+     */
     mark: string | null;
+    /**
+     * 绑定的知识库 ID
+     */
     kbId: number;
+    /**
+     * 系统提示词，支持 {{context}} 检索资料、{{fallback}} 低匹配度默认回复变量；null 继承全局
+     */
     systemPrompt: string | null;
+    /**
+     * 问题拆分提示词；null 继承全局
+     */
     splitPrompt: string | null;
+    /**
+     * 是否将用户问题拆分为多个子问题分别检索；null 继承全局
+     */
     splitQuery: boolean | null;
+    /**
+     * 向量检索匹配度阈值，取值 0~1，低于阈值的结果被过滤；null 继承全局
+     */
     scoreThreshold: number | null;
+    /**
+     * 检索结果全部低于阈值时的回复文案；null 继承全局
+     */
     lowScoreReply: string | null;
+    /**
+     * 深度思考：default 使用模型默认，false 关闭，low / medium / high 为思考强度；null 继承全局
+     */
     deepThinking: 'default' | 'false' | 'low' | 'medium' | 'high' | null;
+    /**
+     * 是否开启多轮对话（携带历史上下文）；null 继承全局
+     */
     multiTurn: boolean | null;
+    /**
+     * 多轮对话上下文 Token 阈值，超出后压缩历史；null 继承全局
+     */
     contextThreshold: number | null;
+    /**
+     * 每个问题向量检索的最大匹配数；null 继承全局
+     */
     retrieveLimit: number | null;
+    /**
+     * 单条消息图片数量上限；null 继承全局
+     */
     imageMaxCount: number | null;
+    /**
+     * 对话图片压缩最长边（像素）；null 继承全局
+     */
     imageMaxEdge: number | null;
+    /**
+     * 文本模型供应商 ID，与 textModel 需同时填写；null 使用全局文本模型
+     */
+    textProviderId: number | null;
+    /**
+     * 文本模型名称，与 textProviderId 需同时填写；null 使用全局文本模型
+     */
+    textModel: string | null;
     welcome: RagWelcomeConfig;
+    /**
+     * 推荐问题列表；null 继承全局
+     */
     recommendedQuestions: Array<string> | null;
+    /**
+     * 创建人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
 };
+/**
+ * 欢迎语配置；问答助手上为 null 时继承全局
+ */
 export type RagWelcomeConfig = {
+    /**
+     * 欢迎语文案，null 表示无文案
+     */
     text: string | null;
+    /**
+     * 欢迎语图片列表
+     */
     images?: Array<RagWelcomeImage>;
 } | null;
+/**
+ * 欢迎语图片
+ */
 export type RagWelcomeImage = {
+    /**
+     * 图片文件 ID
+     */
     fileId: string;
+    /**
+     * 图片 MIME 类型
+     */
     mimeType: string;
+    /**
+     * 当前有效的下载地址，仅响应返回
+     */
     url?: string;
 };
+/**
+ * 智能路由的候选问答助手
+ */
+export type IntentRoute = {
+    /**
+     * 候选问答助手 ID
+     */
+    ragId: number;
+    /**
+     * 意图描述，供模型判断是否命中；null 时取问答助手描述
+     */
+    intent: string | null;
+};
+/**
+ * 智能路由：按会话首问分析意图，路由到候选问答助手，未命中走兜底助手
+ */
+export type IntentRouter = {
+    /**
+     * 智能路由 ID
+     */
+    id: number;
+    /**
+     * 名称
+     */
+    name: string;
+    /**
+     * 描述
+     */
+    description: string | null;
+    /**
+     * 智能路由唯一标识，可用于创建会话（routerMark）；不可包含逗号
+     */
+    mark: string | null;
+    /**
+     * 意图分析提示词，必须包含 {{assistants}} 变量，模型需只输出命中助手的 id；null 使用默认提示词
+     */
+    intentPrompt: string | null;
+    /**
+     * 意图分析使用的文本模型供应商 ID，与 textModel 需同时填写；null 使用全局文本模型
+     */
+    textProviderId: number | null;
+    /**
+     * 意图分析使用的文本模型名称，与 textProviderId 需同时填写；null 使用全局文本模型
+     */
+    textModel: string | null;
+    /**
+     * 意图分析的深度思考：false 关闭（默认），default 使用模型默认，low / medium / high 为思考强度
+     */
+    deepThinking: 'default' | 'false' | 'low' | 'medium' | 'high';
+    /**
+     * 兜底问答助手 ID，未命中任何候选时使用
+     */
+    fallbackRagId: number;
+    /**
+     * 候选问答助手列表，至少一项且不能重复
+     */
+    routes: Array<IntentRoute>;
+    /**
+     * 创建人用户 ID
+     */
+    createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
+    updatedBy: string | null;
+    /**
+     * 创建时间
+     */
+    createdAt: string;
+    /**
+     * 更新时间
+     */
+    updatedAt: string;
+};
+/**
+ * 关键词检索命中
+ */
 export type SearchHit = {
+    /**
+     * 文档 ID
+     */
     documentId: string;
+    /**
+     * 文档名
+     */
     filename: string;
+    /**
+     * 命中分块序号
+     */
     chunkIndex: number;
+    /**
+     * 命中分块原文
+     */
     content: string;
+    /**
+     * 命中分块原文，关键词高亮的 HTML
+     */
     snippet: string;
+    /**
+     * 文档名，关键词高亮的 HTML
+     */
     filenameSnippet: string;
+    /**
+     * 文档 front matter 元数据，字段名到字符串值列表
+     */
+    metadata: {
+        [key: string]: Array<string>;
+    };
 };
-export type Visibility = 'public' | 'internal' | 'private';
+/**
+ * 文档处理状态：processing 分块与向量化中，ready 可用，failed 处理失败
+ */
 export type DocumentStatus = 'processing' | 'ready' | 'failed';
+/**
+ * 知识库文档
+ */
 export type Document = {
+    /**
+     * 文档 ID
+     */
     id: string;
+    /**
+     * 所属知识库 ID
+     */
     kbId: number;
+    /**
+     * 所在文件夹 ID，null 表示根目录
+     */
     folderId: string | null;
+    /**
+     * 同级排序序号
+     */
     sortOrder: number;
+    /**
+     * 文档名
+     */
     filename: string;
+    /**
+     * Markdown 正文
+     */
     content: string;
+    /**
+     * 正文字符数
+     */
     charCount: number;
+    /**
+     * 分块数
+     */
     chunkCount: number;
     status: DocumentStatus;
     visibility: Visibility;
+    /**
+     * 分块大小（字符）；null 继承知识库或全局
+     */
     chunkSize: number | null;
+    /**
+     * 分块重叠字符数；null 继承知识库或全局
+     */
     chunkOverlap: number | null;
+    /**
+     * 创建人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
 };
+/**
+ * 文档摘要，不含正文
+ */
 export type DocumentSummary = {
+    /**
+     * 文档 ID
+     */
     id: string;
+    /**
+     * 所属知识库 ID
+     */
     kbId: number;
+    /**
+     * 所在文件夹 ID，null 表示根目录
+     */
     folderId: string | null;
+    /**
+     * 同级排序序号
+     */
     sortOrder: number;
+    /**
+     * 文档名
+     */
     filename: string;
+    /**
+     * 正文字符数
+     */
     charCount: number;
+    /**
+     * 分块数
+     */
     chunkCount: number;
     status: DocumentStatus;
     visibility: Visibility;
+    /**
+     * 分块大小（字符）；null 继承知识库或全局
+     */
     chunkSize: number | null;
+    /**
+     * 分块重叠字符数；null 继承知识库或全局
+     */
     chunkOverlap: number | null;
+    /**
+     * 创建人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
 };
+/**
+ * 文档树节点，按 type 区分文件夹或文件
+ */
 export type DocumentTreeNode = {
+    /**
+     * 文件夹节点
+     */
     type: 'folder';
     folder: Folder;
+    /**
+     * 子节点，文件夹在前
+     */
     children: Array<DocumentTreeNode>;
 } | {
+    /**
+     * 文件节点
+     */
     type: 'file';
     document: DocumentSummary;
 };
+/**
+ * 知识库文件夹
+ */
 export type Folder = {
+    /**
+     * 文件夹 ID
+     */
     id: string;
+    /**
+     * 所属知识库 ID
+     */
     kbId: number;
+    /**
+     * 文件夹名
+     */
     name: string;
+    /**
+     * 父文件夹 ID，null 表示根目录
+     */
     parentId: string | null;
+    /**
+     * 同级排序序号
+     */
     sortOrder: number;
     visibility: Visibility;
+    /**
+     * 创建人用户 ID
+     */
     createdBy: string | null;
+    /**
+     * 最后更新人用户 ID
+     */
     updatedBy: string | null;
+    /**
+     * 创建时间
+     */
     createdAt: string;
+    /**
+     * 更新时间
+     */
     updatedAt: string;
 };
+/**
+ * 调用工作流请求体
+ */
 export type WorkflowInvokeRequest = {
+    /**
+     * 开始节点入参，键为入参名
+     */
     input?: {
         [key: string]: unknown;
     };
 };
+/**
+ * 工作流执行结果
+ */
 export type WorkflowInvokeResult = {
+    /**
+     * 执行记录 ID
+     */
     executionId: string;
+    /**
+     * 工作流 ID
+     */
     workflowId: string;
+    /**
+     * 执行状态：completed 成功，failed 失败
+     */
     status: 'completed' | 'failed';
+    /**
+     * 工作流输出，无输出时为 null
+     */
     output: {
         [key: string]: unknown;
     } | null;
+    /**
+     * 失败原因，成功时为 null
+     */
     error: string | null;
 };
 export type ErrorResponse = {
@@ -306,16 +1177,116 @@ export type ErrorResponse = {
      * 业务码，成功为 0
      */
     code: number;
+    /**
+     * 提示信息，失败时为错误原因
+     */
     message: string;
     data: {
         [key: string]: unknown;
     } | Array<unknown> | null;
 };
+/**
+ * 创建智能路由请求体
+ */
+export type IntentRouterCreate = {
+    /**
+     * 名称
+     */
+    name: string;
+    /**
+     * 描述
+     */
+    description?: string | null;
+    /**
+     * 智能路由唯一标识，可用于创建会话（routerMark）；不可包含逗号
+     */
+    mark?: string | null;
+    /**
+     * 意图分析提示词，必须包含 {{assistants}} 变量，模型需只输出命中助手的 id；null 使用默认提示词
+     */
+    intentPrompt?: string | null;
+    /**
+     * 意图分析使用的文本模型供应商 ID，与 textModel 需同时填写；null 使用全局文本模型
+     */
+    textProviderId?: number | null;
+    /**
+     * 意图分析使用的文本模型名称，与 textProviderId 需同时填写；null 使用全局文本模型
+     */
+    textModel?: string | null;
+    /**
+     * 意图分析的深度思考：false 关闭（默认），default 使用模型默认，low / medium / high 为思考强度
+     */
+    deepThinking?: 'default' | 'false' | 'low' | 'medium' | 'high';
+    /**
+     * 兜底问答助手 ID，未命中任何候选时使用
+     */
+    fallbackRagId: number;
+    /**
+     * 候选问答助手列表，至少一项且不能重复
+     */
+    routes: Array<IntentRoute>;
+};
+/**
+ * 更新智能路由请求体，仅更新传入字段
+ */
+export type IntentRouterUpdate = {
+    /**
+     * 名称
+     */
+    name?: string;
+    /**
+     * 描述
+     */
+    description?: string | null;
+    /**
+     * 智能路由唯一标识，可用于创建会话（routerMark）；不可包含逗号
+     */
+    mark?: string | null;
+    /**
+     * 意图分析提示词，必须包含 {{assistants}} 变量，模型需只输出命中助手的 id；null 使用默认提示词
+     */
+    intentPrompt?: string | null;
+    /**
+     * 意图分析使用的文本模型供应商 ID，与 textModel 需同时填写；null 使用全局文本模型
+     */
+    textProviderId?: number | null;
+    /**
+     * 意图分析使用的文本模型名称，与 textProviderId 需同时填写；null 使用全局文本模型
+     */
+    textModel?: string | null;
+    /**
+     * 意图分析的深度思考：false 关闭（默认），default 使用模型默认，low / medium / high 为思考强度
+     */
+    deepThinking?: 'default' | 'false' | 'low' | 'medium' | 'high';
+    /**
+     * 兜底问答助手 ID，未命中任何候选时使用
+     */
+    fallbackRagId?: number;
+    /**
+     * 候选问答助手列表，至少一项且不能重复
+     */
+    routes?: Array<IntentRoute>;
+};
+/**
+ * 问答助手摘要
+ */
 export type RagDetail = {
+    /**
+     * 问答助手 ID
+     */
     id: number;
+    /**
+     * 名称
+     */
     name: string;
+    /**
+     * 问答助手唯一标识，可用于创建会话；不可包含逗号
+     */
     mark: string | null;
     welcome: RagWelcomeConfig;
+    /**
+     * 推荐问题列表；null 继承全局
+     */
     recommendedQuestions: Array<string> | null;
 };
 export type DocumentUpdateByPath = {
@@ -338,7 +1309,13 @@ export type DocumentUpdateByPath = {
 };
 export type DeleteApiFilesData = {
     body: {
+        /**
+         * 待删除文件 ID 列表
+         */
         ids: Array<string>;
+        /**
+         * 为 true 时忽略引用强制删除
+         */
         force?: boolean;
     };
     path?: never;
@@ -370,6 +1347,9 @@ export type DeleteApiFilesErrors = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: FileReferencedData;
     };
@@ -392,8 +1372,14 @@ export type DeleteApiFilesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
             results: Array<BatchDeleteFileResult>;
         };
     };
@@ -403,7 +1389,13 @@ export type GetApiFilesData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 文件归属业务：general 文件页上传，knowledge 知识库文档图片，chat 对话图片，rag 问答助手欢迎语图片，skill 技能压缩包，workflow 工作流图片
+         */
         scope?: FileScope;
+        /**
+         * 文件状态：pending 等待上传确认，ready 可用，failed 上传失败
+         */
         status?: FileStatus;
         /**
          * 文件名关键词
@@ -417,7 +1409,13 @@ export type GetApiFilesData = {
          * 创建时间止
          */
         endDate?: string;
+        /**
+         * 每页条数，默认 50，最大 200
+         */
         limit?: number;
+        /**
+         * 偏移量，默认 0
+         */
         offset?: number;
     };
     url: '/api/files';
@@ -446,9 +1444,18 @@ export type GetApiFilesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 当前页文件
+             */
             items: Array<FileListItem>;
+            /**
+             * 符合条件的文件总数
+             */
             total: number;
         };
     };
@@ -456,6 +1463,9 @@ export type GetApiFilesResponses = {
 export type GetApiFilesResponse = GetApiFilesResponses[keyof GetApiFilesResponses];
 export type PostApiFilesData = {
     body: {
+        /**
+         * 待上传文件
+         */
         files: Array<Blob | File>;
         scope: FileScope;
     };
@@ -499,8 +1509,14 @@ export type PostApiFilesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
             results: Array<BackendUploadResult>;
         };
     };
@@ -508,9 +1524,21 @@ export type PostApiFilesResponses = {
 export type PostApiFilesResponse = PostApiFilesResponses[keyof PostApiFilesResponses];
 export type PostApiFilesPresignData = {
     body: {
+        /**
+         * 待上传文件列表
+         */
         items: Array<{
+            /**
+             * 文件名
+             */
             filename: string;
+            /**
+             * 文件大小（字节）
+             */
             size: number;
+            /**
+             * MIME 类型
+             */
             mimeType: string;
             scope: FileScope;
         }>;
@@ -555,8 +1583,14 @@ export type PostApiFilesPresignResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
             results: Array<PrepareUploadResult>;
         };
     };
@@ -564,6 +1598,9 @@ export type PostApiFilesPresignResponses = {
 export type PostApiFilesPresignResponse = PostApiFilesPresignResponses[keyof PostApiFilesPresignResponses];
 export type PostApiFilesCompleteData = {
     body: {
+        /**
+         * 预签名直传返回的文件 ID 列表
+         */
         ids: Array<string>;
     };
     path?: never;
@@ -606,8 +1643,14 @@ export type PostApiFilesCompleteResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
             results: Array<CompleteUploadResult>;
         };
     };
@@ -615,8 +1658,17 @@ export type PostApiFilesCompleteResponses = {
 export type PostApiFilesCompleteResponse = PostApiFilesCompleteResponses[keyof PostApiFilesCompleteResponses];
 export type PostApiFilesCleanupData = {
     body: {
+        /**
+         * 为 true 时仅返回候选列表不删除，默认 true
+         */
         dryRun?: boolean;
+        /**
+         * 仅处理创建超过该时长（小时）的文件，默认 24
+         */
         olderThanHours?: number;
+        /**
+         * 每批删除数量，默认 100
+         */
         deleteBatchSize?: number;
     };
     path?: never;
@@ -659,6 +1711,9 @@ export type PostApiFilesCleanupResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: CleanupReport;
     };
@@ -667,9 +1722,15 @@ export type PostApiFilesCleanupResponse = PostApiFilesCleanupResponses[keyof Pos
 export type DeleteApiFilesByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: {
+        /**
+         * 为 true 时忽略引用强制删除
+         */
         force?: boolean;
     };
     url: '/api/files/{id}';
@@ -699,6 +1760,9 @@ export type DeleteApiFilesByIdErrors = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: FileReferencedData;
     };
@@ -720,7 +1784,10 @@ export type DeleteApiFilesByIdResponses = {
         /**
          * 业务码，成功为 0
          */
-        code: number;
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -729,6 +1796,9 @@ export type DeleteApiFilesByIdResponse = DeleteApiFilesByIdResponses[keyof Delet
 export type GetApiFilesByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -770,6 +1840,9 @@ export type GetApiFilesByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: StoredFile;
     };
@@ -778,6 +1851,9 @@ export type GetApiFilesByIdResponse = GetApiFilesByIdResponses[keyof GetApiFiles
 export type GetApiFilesByIdRawData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -820,6 +1896,9 @@ export type GetApiFilesByIdRawResponse = GetApiFilesByIdRawResponses[keyof GetAp
 export type GetApiFilesByIdUrlData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -861,8 +1940,14 @@ export type GetApiFilesByIdUrlResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 下载地址
+             */
             url: string;
         };
     };
@@ -870,11 +1955,26 @@ export type GetApiFilesByIdUrlResponses = {
 export type GetApiFilesByIdUrlResponse = GetApiFilesByIdUrlResponses[keyof GetApiFilesByIdUrlResponses];
 export type PostApiChatData = {
     body: {
+        /**
+         * 会话 ID
+         */
         conversationId: string;
+        /**
+         * 用户问题，与 attachments 至少传一项
+         */
         content: string;
+        /**
+         * 图片附件，实际数量上限以 /api/chat/limits 返回的 imageMaxCount 为准
+         */
         attachments?: Array<{
+            /**
+             * 当前用户上传且已就绪的对话图片文件 ID（scope=chat）
+             */
             fileId: string;
         }>;
+        /**
+         * 是否以 NDJSON 事件流返回，默认 true
+         */
         stream?: boolean;
     };
     path?: never;
@@ -917,6 +2017,9 @@ export type PostApiChatResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: ChatAnswer;
     };
@@ -926,6 +2029,9 @@ export type GetApiChatLimitsData = {
     body?: never;
     path?: never;
     query: {
+        /**
+         * 会话 ID
+         */
         conversationId: string;
     };
     url: '/api/chat/limits';
@@ -958,11 +2064,23 @@ export type GetApiChatLimitsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 单条消息图片数量上限
+             */
             imageMaxCount: number;
+            /**
+             * 图片压缩最长边（像素），客户端上传前按此缩放
+             */
             imageMaxEdge: number;
             welcome: RagWelcomeConfig;
+            /**
+             * 生效的推荐问题
+             */
             recommendedQuestions: Array<string>;
         };
     };
@@ -972,8 +2090,18 @@ export type GetApiChatConversationsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 按会话归属用户过滤，仅管理员及以上生效
+         */
         userId?: string;
+        /**
+         * 按问答助手 ID 过滤
+         */
         ragId?: number;
+        /**
+         * 按智能路由 ID 过滤
+         */
+        routerId?: number;
     };
     url: '/api/chat/conversations';
 };
@@ -997,6 +2125,9 @@ export type GetApiChatConversationsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<Conversation>;
     };
@@ -1004,10 +2135,30 @@ export type GetApiChatConversationsResponses = {
 export type GetApiChatConversationsResponse = GetApiChatConversationsResponses[keyof GetApiChatConversationsResponses];
 export type PostApiChatConversationsData = {
     body?: {
+        /**
+         * 会话标题
+         */
         title?: string;
+        /**
+         * 会话归属用户 ID，默认为当前用户；指定他人时需对该用户有管理权限
+         */
         userId?: string;
+        /**
+         * 直接绑定的问答助手 ID，与 mark 二选一
+         */
         ragId?: number;
+        /**
+         * 直接绑定的问答助手标识，与 ragId 二选一
+         */
         mark?: string;
+        /**
+         * 绑定的智能路由 ID，与 routerMark 二选一
+         */
+        routerId?: number;
+        /**
+         * 绑定的智能路由标识，与 routerId 二选一
+         */
+        routerMark?: string;
     };
     path?: never;
     query?: never;
@@ -1049,6 +2200,9 @@ export type PostApiChatConversationsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Conversation;
     };
@@ -1057,6 +2211,9 @@ export type PostApiChatConversationsResponse = PostApiChatConversationsResponses
 export type DeleteApiChatConversationsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1098,6 +2255,9 @@ export type DeleteApiChatConversationsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1106,6 +2266,9 @@ export type DeleteApiChatConversationsByIdResponse = DeleteApiChatConversationsB
 export type GetApiChatConversationsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1147,9 +2310,15 @@ export type GetApiChatConversationsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
             conversation: Conversation;
+            /**
+             * 会话消息，按时间正序
+             */
             messages: Array<Message>;
         };
     };
@@ -1157,15 +2326,263 @@ export type GetApiChatConversationsByIdResponses = {
 export type GetApiChatConversationsByIdResponse = GetApiChatConversationsByIdResponses[keyof GetApiChatConversationsByIdResponses];
 export type PatchApiChatConversationsByIdData = {
     body: {
+        /**
+         * 会话标题，为空时保持原标题
+         */
         title?: string;
     };
     path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/chat/conversations/{id}';
+};
+export type PatchApiChatConversationsByIdErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type PatchApiChatConversationsByIdError = PatchApiChatConversationsByIdErrors[keyof PatchApiChatConversationsByIdErrors];
+export type PatchApiChatConversationsByIdResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: Conversation;
+    };
+};
+export type PatchApiChatConversationsByIdResponse = PatchApiChatConversationsByIdResponses[keyof PatchApiChatConversationsByIdResponses];
+export type GetApiChatRoutersData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/api/chat/routers';
+};
+export type GetApiChatRoutersErrors = {
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type GetApiChatRoutersError = GetApiChatRoutersErrors[keyof GetApiChatRoutersErrors];
+export type GetApiChatRoutersResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: Array<IntentRouter>;
+    };
+};
+export type GetApiChatRoutersResponse = GetApiChatRoutersResponses[keyof GetApiChatRoutersResponses];
+export type PostApiChatRoutersData = {
+    body: IntentRouterCreate;
+    path?: never;
+    query?: never;
+    url: '/api/chat/routers';
+};
+export type PostApiChatRoutersErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type PostApiChatRoutersError = PostApiChatRoutersErrors[keyof PostApiChatRoutersErrors];
+export type PostApiChatRoutersResponses = {
+    /**
+     * 成功
+     */
+    201: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: {
+            /**
+             * 新建智能路由 ID
+             */
+            id: number;
+        };
+    };
+};
+export type PostApiChatRoutersResponse = PostApiChatRoutersResponses[keyof PostApiChatRoutersResponses];
+export type DeleteApiChatRoutersByIdData = {
+    body?: never;
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/chat/routers/{id}';
+};
+export type DeleteApiChatRoutersByIdErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type DeleteApiChatRoutersByIdError = DeleteApiChatRoutersByIdErrors[keyof DeleteApiChatRoutersByIdErrors];
+export type DeleteApiChatRoutersByIdResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: null;
+    };
+};
+export type DeleteApiChatRoutersByIdResponse = DeleteApiChatRoutersByIdResponses[keyof DeleteApiChatRoutersByIdResponses];
+export type GetApiChatRoutersByIdData = {
+    body?: never;
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/chat/routers/{id}';
+};
+export type GetApiChatRoutersByIdErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type GetApiChatRoutersByIdError = GetApiChatRoutersByIdErrors[keyof GetApiChatRoutersByIdErrors];
+export type GetApiChatRoutersByIdResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: IntentRouter;
+    };
+};
+export type GetApiChatRoutersByIdResponse = GetApiChatRoutersByIdResponses[keyof GetApiChatRoutersByIdResponses];
+export type PatchApiChatRoutersByIdData = {
+    body: IntentRouterUpdate;
+    path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
-    url: '/api/chat/conversations/{id}';
+    url: '/api/chat/routers/{id}';
 };
-export type PatchApiChatConversationsByIdErrors = {
+export type PatchApiChatRoutersByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -1191,8 +2608,8 @@ export type PatchApiChatConversationsByIdErrors = {
      */
     500: ErrorResponse;
 };
-export type PatchApiChatConversationsByIdError = PatchApiChatConversationsByIdErrors[keyof PatchApiChatConversationsByIdErrors];
-export type PatchApiChatConversationsByIdResponses = {
+export type PatchApiChatRoutersByIdError = PatchApiChatRoutersByIdErrors[keyof PatchApiChatRoutersByIdErrors];
+export type PatchApiChatRoutersByIdResponses = {
     /**
      * 成功
      */
@@ -1201,11 +2618,14 @@ export type PatchApiChatConversationsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: Conversation;
+        data: IntentRouter;
     };
 };
-export type PatchApiChatConversationsByIdResponse = PatchApiChatConversationsByIdResponses[keyof PatchApiChatConversationsByIdResponses];
+export type PatchApiChatRoutersByIdResponse = PatchApiChatRoutersByIdResponses[keyof PatchApiChatRoutersByIdResponses];
 export type GetApiSearchData = {
     body?: never;
     path?: never;
@@ -1222,6 +2642,9 @@ export type GetApiSearchData = {
          * 知识库标识，与 kbId 不能同时为空
          */
         mark?: string;
+        /**
+         * 返回条数上限，默认 20，最大 50
+         */
         limit?: number;
     };
     url: '/api/search';
@@ -1254,6 +2677,9 @@ export type GetApiSearchResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<SearchHit>;
     };
@@ -1310,6 +2736,9 @@ export type PostApiSearchClickResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1341,6 +2770,9 @@ export type GetApiKnowledgeBasesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<KnowledgeBaseListItem>;
     };
@@ -1348,11 +2780,30 @@ export type GetApiKnowledgeBasesResponses = {
 export type GetApiKnowledgeBasesResponse = GetApiKnowledgeBasesResponses[keyof GetApiKnowledgeBasesResponses];
 export type PostApiKnowledgeBasesData = {
     body: {
+        /**
+         * 名称
+         */
         name: string;
+        /**
+         * 知识库唯一标识，不可包含逗号
+         */
         mark: string;
+        /**
+         * 描述
+         */
         description?: string | null;
+        /**
+         * 文档分块大小（字符），不小于 100；null 继承全局
+         */
         chunkSize?: number | null;
+        /**
+         * 相邻分块重叠字符数，需小于分块大小；null 继承全局
+         */
         chunkOverlap?: number | null;
+        /**
+         * 召回时可按「字段=值」等条件过滤的文档 front matter 字段名
+         */
+        filterFields?: Array<string>;
     };
     path?: never;
     query?: never;
@@ -1386,8 +2837,14 @@ export type PostApiKnowledgeBasesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 新建知识库 ID
+             */
             id: number;
         };
     };
@@ -1396,6 +2853,9 @@ export type PostApiKnowledgeBasesResponse = PostApiKnowledgeBasesResponses[keyof
 export type DeleteApiKnowledgeBasesByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1437,6 +2897,9 @@ export type DeleteApiKnowledgeBasesByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1445,6 +2908,9 @@ export type DeleteApiKnowledgeBasesByIdResponse = DeleteApiKnowledgeBasesByIdRes
 export type GetApiKnowledgeBasesByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1486,6 +2952,9 @@ export type GetApiKnowledgeBasesByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: KnowledgeBase;
     };
@@ -1493,13 +2962,35 @@ export type GetApiKnowledgeBasesByIdResponses = {
 export type GetApiKnowledgeBasesByIdResponse = GetApiKnowledgeBasesByIdResponses[keyof GetApiKnowledgeBasesByIdResponses];
 export type PatchApiKnowledgeBasesByIdData = {
     body: {
+        /**
+         * 名称
+         */
         name?: string;
+        /**
+         * 知识库唯一标识，不可包含逗号
+         */
         mark?: string;
+        /**
+         * 描述
+         */
         description?: string | null;
+        /**
+         * 文档分块大小（字符），不小于 100；null 继承全局
+         */
         chunkSize?: number | null;
+        /**
+         * 相邻分块重叠字符数，需小于分块大小；null 继承全局
+         */
         chunkOverlap?: number | null;
+        /**
+         * 召回时可按「字段=值」等条件过滤的文档 front matter 字段名
+         */
+        filterFields?: Array<string>;
     };
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1541,11 +3032,47 @@ export type PatchApiKnowledgeBasesByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: KnowledgeBase;
     };
 };
 export type PatchApiKnowledgeBasesByIdResponse = PatchApiKnowledgeBasesByIdResponses[keyof PatchApiKnowledgeBasesByIdResponses];
+export type GetApiKnowledgeBasesByIdExportData = {
+    body?: never;
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/knowledge-bases/{id}/export';
+};
+export type GetApiKnowledgeBasesByIdExportErrors = {
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type GetApiKnowledgeBasesByIdExportError = GetApiKnowledgeBasesByIdExportErrors[keyof GetApiKnowledgeBasesByIdExportErrors];
+export type GetApiKnowledgeBasesByIdExportResponses = {
+    /**
+     * Zip 二进制流
+     */
+    200: Blob | File;
+};
+export type GetApiKnowledgeBasesByIdExportResponse = GetApiKnowledgeBasesByIdExportResponses[keyof GetApiKnowledgeBasesByIdExportResponses];
 export type GetApiRagsData = {
     body?: never;
     path?: never;
@@ -1572,6 +3099,9 @@ export type GetApiRagsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<Rag>;
     };
@@ -1579,22 +3109,78 @@ export type GetApiRagsResponses = {
 export type GetApiRagsResponse = GetApiRagsResponses[keyof GetApiRagsResponses];
 export type PostApiRagsData = {
     body: {
+        /**
+         * 名称
+         */
         name: string;
+        /**
+         * 描述；作为智能路由候选且未填写意图时，用作意图描述
+         */
         description?: string | null;
+        /**
+         * 问答助手唯一标识，可用于创建会话；不可包含逗号
+         */
         mark?: string | null;
+        /**
+         * 绑定的知识库 ID
+         */
         kbId: number;
+        /**
+         * 系统提示词，支持 {{context}} 检索资料、{{fallback}} 低匹配度默认回复变量；null 继承全局
+         */
         systemPrompt?: string | null;
+        /**
+         * 问题拆分提示词；null 继承全局
+         */
         splitPrompt?: string | null;
+        /**
+         * 是否将用户问题拆分为多个子问题分别检索；null 继承全局
+         */
         splitQuery?: boolean | null;
+        /**
+         * 向量检索匹配度阈值，取值 0~1，低于阈值的结果被过滤；null 继承全局
+         */
         scoreThreshold?: number | null;
+        /**
+         * 检索结果全部低于阈值时的回复文案；null 继承全局
+         */
         lowScoreReply?: string | null;
+        /**
+         * 深度思考：default 使用模型默认，false 关闭，low / medium / high 为思考强度；null 继承全局
+         */
         deepThinking?: 'default' | 'false' | 'low' | 'medium' | 'high' | null;
+        /**
+         * 是否开启多轮对话（携带历史上下文）；null 继承全局
+         */
         multiTurn?: boolean | null;
+        /**
+         * 多轮对话上下文 Token 阈值，超出后压缩历史；null 继承全局
+         */
         contextThreshold?: number | null;
+        /**
+         * 每个问题向量检索的最大匹配数；null 继承全局
+         */
         retrieveLimit?: number | null;
+        /**
+         * 单条消息图片数量上限；null 继承全局
+         */
         imageMaxCount?: number | null;
+        /**
+         * 对话图片压缩最长边（像素）；null 继承全局
+         */
         imageMaxEdge?: number | null;
+        /**
+         * 文本模型供应商 ID，与 textModel 需同时填写；null 使用全局文本模型
+         */
+        textProviderId?: number | null;
+        /**
+         * 文本模型名称，与 textProviderId 需同时填写；null 使用全局文本模型
+         */
+        textModel?: string | null;
         welcome?: RagWelcomeConfig;
+        /**
+         * 推荐问题列表；null 继承全局
+         */
         recommendedQuestions?: Array<string> | null;
     };
     path?: never;
@@ -1625,8 +3211,14 @@ export type PostApiRagsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 新建问答助手 ID
+             */
             id: number;
         };
     };
@@ -1635,6 +3227,9 @@ export type PostApiRagsResponse = PostApiRagsResponses[keyof PostApiRagsResponse
 export type DeleteApiRagsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1676,6 +3271,9 @@ export type DeleteApiRagsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1684,6 +3282,9 @@ export type DeleteApiRagsByIdResponse = DeleteApiRagsByIdResponses[keyof DeleteA
 export type GetApiRagsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1725,6 +3326,9 @@ export type GetApiRagsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Rag;
     };
@@ -1732,25 +3336,84 @@ export type GetApiRagsByIdResponses = {
 export type GetApiRagsByIdResponse = GetApiRagsByIdResponses[keyof GetApiRagsByIdResponses];
 export type PatchApiRagsByIdData = {
     body: {
+        /**
+         * 名称
+         */
         name?: string;
+        /**
+         * 描述；作为智能路由候选且未填写意图时，用作意图描述
+         */
         description?: string | null;
+        /**
+         * 问答助手唯一标识，可用于创建会话；不可包含逗号
+         */
         mark?: string | null;
+        /**
+         * 绑定的知识库 ID
+         */
         kbId?: number;
+        /**
+         * 系统提示词，支持 {{context}} 检索资料、{{fallback}} 低匹配度默认回复变量；null 继承全局
+         */
         systemPrompt?: string | null;
+        /**
+         * 问题拆分提示词；null 继承全局
+         */
         splitPrompt?: string | null;
+        /**
+         * 是否将用户问题拆分为多个子问题分别检索；null 继承全局
+         */
         splitQuery?: boolean | null;
+        /**
+         * 向量检索匹配度阈值，取值 0~1，低于阈值的结果被过滤；null 继承全局
+         */
         scoreThreshold?: number | null;
+        /**
+         * 检索结果全部低于阈值时的回复文案；null 继承全局
+         */
         lowScoreReply?: string | null;
+        /**
+         * 深度思考：default 使用模型默认，false 关闭，low / medium / high 为思考强度；null 继承全局
+         */
         deepThinking?: 'default' | 'false' | 'low' | 'medium' | 'high' | null;
+        /**
+         * 是否开启多轮对话（携带历史上下文）；null 继承全局
+         */
         multiTurn?: boolean | null;
+        /**
+         * 多轮对话上下文 Token 阈值，超出后压缩历史；null 继承全局
+         */
         contextThreshold?: number | null;
+        /**
+         * 每个问题向量检索的最大匹配数；null 继承全局
+         */
         retrieveLimit?: number | null;
+        /**
+         * 单条消息图片数量上限；null 继承全局
+         */
         imageMaxCount?: number | null;
+        /**
+         * 对话图片压缩最长边（像素）；null 继承全局
+         */
         imageMaxEdge?: number | null;
+        /**
+         * 文本模型供应商 ID，与 textModel 需同时填写；null 使用全局文本模型
+         */
+        textProviderId?: number | null;
+        /**
+         * 文本模型名称，与 textProviderId 需同时填写；null 使用全局文本模型
+         */
+        textModel?: string | null;
         welcome?: RagWelcomeConfig;
+        /**
+         * 推荐问题列表；null 继承全局
+         */
         recommendedQuestions?: Array<string> | null;
     };
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1792,6 +3455,9 @@ export type PatchApiRagsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Rag;
     };
@@ -1801,7 +3467,13 @@ export type GetApiRagsDetailData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 问答助手 ID，与 mark 不能同时为空
+         */
         id?: number | null;
+        /**
+         * 问答助手标识，与 id 不能同时为空
+         */
         mark?: string;
     };
     url: '/api/rags/detail';
@@ -1834,6 +3506,9 @@ export type GetApiRagsDetailResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: RagDetail;
     };
@@ -1878,6 +3553,9 @@ export type DeleteApiDocumentsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1918,6 +3596,9 @@ export type GetApiDocumentsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<DocumentSummary>;
     };
@@ -1925,7 +3606,13 @@ export type GetApiDocumentsResponses = {
 export type GetApiDocumentsResponse = GetApiDocumentsResponses[keyof GetApiDocumentsResponses];
 export type PostApiDocumentsData = {
     body?: {
+        /**
+         * 文档名，不能包含 /，同级不能与文件夹或文档重名
+         */
         filename: string;
+        /**
+         * 所在文件夹 ID，不传或 null 表示根目录
+         */
         folderId?: string | null;
         visibility?: Visibility;
     };
@@ -1966,6 +3653,9 @@ export type PostApiDocumentsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: DocumentSummary;
     };
@@ -2010,6 +3700,9 @@ export type GetApiDocumentsTreeResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<DocumentTreeNode>;
     };
@@ -2057,6 +3750,9 @@ export type PatchApiDocumentsByPathResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Document;
     };
@@ -2065,6 +3761,9 @@ export type PatchApiDocumentsByPathResponse = PatchApiDocumentsByPathResponses[k
 export type DeleteApiDocumentsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2106,6 +3805,9 @@ export type DeleteApiDocumentsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -2114,9 +3816,15 @@ export type DeleteApiDocumentsByIdResponse = DeleteApiDocumentsByIdResponses[key
 export type GetApiDocumentsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: {
+        /**
+         * 访问来源，用于访问统计：docs 文档页、search 检索结果；不传记为直接访问
+         */
         source?: 'docs' | 'search';
     };
     url: '/api/documents/{id}';
@@ -2145,6 +3853,9 @@ export type GetApiDocumentsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Document;
     };
@@ -2152,15 +3863,36 @@ export type GetApiDocumentsByIdResponses = {
 export type GetApiDocumentsByIdResponse = GetApiDocumentsByIdResponses[keyof GetApiDocumentsByIdResponses];
 export type PatchApiDocumentsByIdData = {
     body: {
+        /**
+         * 文档名
+         */
         filename?: string;
+        /**
+         * Markdown 正文，修改后重新分块与向量化
+         */
         content?: string;
         visibility?: Visibility;
+        /**
+         * 分块大小（字符），不小于 100；null 继承知识库或全局
+         */
         chunkSize?: number | null;
+        /**
+         * 分块重叠字符数，需小于分块大小；null 继承知识库或全局
+         */
         chunkOverlap?: number | null;
+        /**
+         * 移动到的目标文件夹 ID，null 表示根目录
+         */
         folderId?: string | null;
+        /**
+         * 在目标目录中的排序位置，从 0 开始
+         */
         index?: number;
     };
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2202,6 +3934,9 @@ export type PatchApiDocumentsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Document;
     };
@@ -2210,6 +3945,9 @@ export type PatchApiDocumentsByIdResponse = PatchApiDocumentsByIdResponses[keyof
 export type PostApiDocumentsByIdCopyData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2251,6 +3989,9 @@ export type PostApiDocumentsByIdCopyResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Document;
     };
@@ -2260,7 +4001,13 @@ export type GetApiFoldersData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 知识库 ID，与 mark 不能同时为空
+         */
         kbId?: number | null;
+        /**
+         * 知识库标识，与 kbId 不能同时为空
+         */
         mark?: string;
     };
     url: '/api/folders';
@@ -2293,6 +4040,9 @@ export type GetApiFoldersResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<Folder>;
     };
@@ -2300,9 +4050,18 @@ export type GetApiFoldersResponses = {
 export type GetApiFoldersResponse = GetApiFoldersResponses[keyof GetApiFoldersResponses];
 export type PostApiFoldersData = {
     body: {
+        /**
+         * 文件夹名，不能包含 /，同级不能与文件夹或文档重名
+         */
         name: string;
+        /**
+         * 父文件夹 ID，不传或 null 表示根目录
+         */
         parentId?: string | null;
         visibility?: Visibility;
+        /**
+         * 所属知识库 ID
+         */
         kbId: number;
     };
     path?: never;
@@ -2337,6 +4096,9 @@ export type PostApiFoldersResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Folder;
     };
@@ -2345,6 +4107,9 @@ export type PostApiFoldersResponse = PostApiFoldersResponses[keyof PostApiFolder
 export type DeleteApiFoldersByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2386,6 +4151,9 @@ export type DeleteApiFoldersByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -2393,12 +4161,24 @@ export type DeleteApiFoldersByIdResponses = {
 export type DeleteApiFoldersByIdResponse = DeleteApiFoldersByIdResponses[keyof DeleteApiFoldersByIdResponses];
 export type PatchApiFoldersByIdData = {
     body: {
+        /**
+         * 文件夹名，不能包含 /
+         */
         name?: string;
+        /**
+         * 移动到的父文件夹 ID，null 表示根目录
+         */
         parentId?: string | null;
         visibility?: Visibility;
+        /**
+         * 在同级中的排序位置，从 0 开始
+         */
         index?: number;
     };
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2440,6 +4220,9 @@ export type PatchApiFoldersByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Folder;
     };
@@ -2448,6 +4231,9 @@ export type PatchApiFoldersByIdResponse = PatchApiFoldersByIdResponses[keyof Pat
 export type PostApiWorkflowsByIdInvokeData = {
     body: WorkflowInvokeRequest;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2489,6 +4275,9 @@ export type PostApiWorkflowsByIdInvokeResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: WorkflowInvokeResult;
     };