@dxpos/knowledge 0.10.0 → 0.12.0

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

@@ -1,282 +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 Rag = {
+/**
+ * 按当前角色可见范围统计的文档数；阅览者仅统计公开文档
+ */
+export type KnowledgeBaseDocumentStats = {
+    /**
+     * 公开文档数
+     */
+    public: number;
+    /**
+     * 内部文档数，阅览者不返回
+     */
+    internal?: number;
+    /**
+     * 私有文档数，阅览者不返回
+     */
+    private?: number;
+    /**
+     * 当前角色可见的文档总数
+     */
+    total: number;
+};
+/**
+ * 知识库列表项，含文档数统计
+ */
+export type KnowledgeBaseListItem = {
+    /**
+     * 知识库 ID
+     */
     id: number;
-    name: string;
+    /**
+     * 名称
+     */
+    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 = {
@@ -284,16 +1177,116 @@ export type ErrorResponse = {
      * 业务码，成功为 0
      */
     code: number;
+    /**
+     * 提示信息，失败时为错误原因
+     */
     message: string;
     data: {
         [key: string]: unknown;
     } | Array<unknown> | null;
 };
-export type RagDetail = {
-    id: number;
-    name: string;
+/**
+ * 创建智能路由请求体
+ */
+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 = {
@@ -316,7 +1309,13 @@ export type DocumentUpdateByPath = {
 };
 export type DeleteApiFilesData = {
     body: {
+        /**
+         * 待删除文件 ID 列表
+         */
         ids: Array<string>;
+        /**
+         * 为 true 时忽略引用强制删除
+         */
         force?: boolean;
     };
     path?: never;
@@ -348,6 +1347,9 @@ export type DeleteApiFilesErrors = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: FileReferencedData;
     };
@@ -370,8 +1372,14 @@ export type DeleteApiFilesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
             results: Array<BatchDeleteFileResult>;
         };
     };
@@ -381,7 +1389,13 @@ export type GetApiFilesData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 文件归属业务：general 文件页上传，knowledge 知识库文档图片，chat 对话图片，rag 问答助手欢迎语图片，skill 技能压缩包，workflow 工作流图片
+         */
         scope?: FileScope;
+        /**
+         * 文件状态：pending 等待上传确认，ready 可用，failed 上传失败
+         */
         status?: FileStatus;
         /**
          * 文件名关键词
@@ -395,12 +1409,333 @@ export type GetApiFilesData = {
          * 创建时间止
          */
         endDate?: string;
+        /**
+         * 每页条数，默认 50，最大 200
+         */
         limit?: number;
+        /**
+         * 偏移量，默认 0
+         */
         offset?: number;
     };
     url: '/api/files';
 };
-export type GetApiFilesErrors = {
+export type GetApiFilesErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type GetApiFilesError = GetApiFilesErrors[keyof GetApiFilesErrors];
+export type GetApiFilesResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: {
+            /**
+             * 当前页文件
+             */
+            items: Array<FileListItem>;
+            /**
+             * 符合条件的文件总数
+             */
+            total: number;
+        };
+    };
+};
+export type GetApiFilesResponse = GetApiFilesResponses[keyof GetApiFilesResponses];
+export type PostApiFilesData = {
+    body: {
+        /**
+         * 待上传文件
+         */
+        files: Array<Blob | File>;
+        scope: FileScope;
+    };
+    path?: never;
+    query?: never;
+    url: '/api/files';
+};
+export type PostApiFilesErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type PostApiFilesError = PostApiFilesErrors[keyof PostApiFilesErrors];
+export type PostApiFilesResponses = {
+    /**
+     * 部分或全部成功
+     */
+    201: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
+            results: Array<BackendUploadResult>;
+        };
+    };
+};
+export type PostApiFilesResponse = PostApiFilesResponses[keyof PostApiFilesResponses];
+export type PostApiFilesPresignData = {
+    body: {
+        /**
+         * 待上传文件列表
+         */
+        items: Array<{
+            /**
+             * 文件名
+             */
+            filename: string;
+            /**
+             * 文件大小（字节）
+             */
+            size: number;
+            /**
+             * MIME 类型
+             */
+            mimeType: string;
+            scope: FileScope;
+        }>;
+    };
+    path?: never;
+    query?: never;
+    url: '/api/files/presign';
+};
+export type PostApiFilesPresignErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type PostApiFilesPresignError = PostApiFilesPresignErrors[keyof PostApiFilesPresignErrors];
+export type PostApiFilesPresignResponses = {
+    /**
+     * 成功
+     */
+    201: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
+            results: Array<PrepareUploadResult>;
+        };
+    };
+};
+export type PostApiFilesPresignResponse = PostApiFilesPresignResponses[keyof PostApiFilesPresignResponses];
+export type PostApiFilesCompleteData = {
+    body: {
+        /**
+         * 预签名直传返回的文件 ID 列表
+         */
+        ids: Array<string>;
+    };
+    path?: never;
+    query?: never;
+    url: '/api/files/complete';
+};
+export type PostApiFilesCompleteErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type PostApiFilesCompleteError = PostApiFilesCompleteErrors[keyof PostApiFilesCompleteErrors];
+export type PostApiFilesCompleteResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: {
+            /**
+             * 逐项结果，顺序与请求一致
+             */
+            results: Array<CompleteUploadResult>;
+        };
+    };
+};
+export type PostApiFilesCompleteResponse = PostApiFilesCompleteResponses[keyof PostApiFilesCompleteResponses];
+export type PostApiFilesCleanupData = {
+    body: {
+        /**
+         * 为 true 时仅返回候选列表不删除，默认 true
+         */
+        dryRun?: boolean;
+        /**
+         * 仅处理创建超过该时长（小时）的文件，默认 24
+         */
+        olderThanHours?: number;
+        /**
+         * 每批删除数量，默认 100
+         */
+        deleteBatchSize?: number;
+    };
+    path?: never;
+    query?: never;
+    url: '/api/files/cleanup';
+};
+export type PostApiFilesCleanupErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type PostApiFilesCleanupError = PostApiFilesCleanupErrors[keyof PostApiFilesCleanupErrors];
+export type PostApiFilesCleanupResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: CleanupReport;
+    };
+};
+export type PostApiFilesCleanupResponse = PostApiFilesCleanupResponses[keyof PostApiFilesCleanupResponses];
+export type DeleteApiFilesByIdData = {
+    body?: never;
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * 为 true 时忽略引用强制删除
+         */
+        force?: boolean;
+    };
+    url: '/api/files/{id}';
+};
+export type DeleteApiFilesByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -409,13 +1744,39 @@ export type GetApiFilesErrors = {
      * 未登录
      */
     401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * 文件仍被引用
+     */
+    409: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: FileReferencedData;
+    };
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
     /**
      * 服务器内部错误
      */
     500: ErrorResponse;
 };
-export type GetApiFilesError = GetApiFilesErrors[keyof GetApiFilesErrors];
-export type GetApiFilesResponses = {
+export type DeleteApiFilesByIdError = DeleteApiFilesByIdErrors[keyof DeleteApiFilesByIdErrors];
+export type DeleteApiFilesByIdResponses = {
     /**
      * 成功
      */
@@ -424,24 +1785,26 @@ export type GetApiFilesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: {
-            items: Array<FileListItem>;
-            total: number;
-        };
+        data: null;
     };
 };
-export type GetApiFilesResponse = GetApiFilesResponses[keyof GetApiFilesResponses];
-export type PostApiFilesData = {
-    body: {
-        files: Array<Blob | File>;
-        scope: FileScope;
+export type DeleteApiFilesByIdResponse = DeleteApiFilesByIdResponses[keyof DeleteApiFilesByIdResponses];
+export type GetApiFilesByIdData = {
+    body?: never;
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
     };
-    path?: never;
     query?: never;
-    url: '/api/files';
+    url: '/api/files/{id}';
 };
-export type PostApiFilesErrors = {
+export type GetApiFilesByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -467,37 +1830,36 @@ export type PostApiFilesErrors = {
      */
     500: ErrorResponse;
 };
-export type PostApiFilesError = PostApiFilesErrors[keyof PostApiFilesErrors];
-export type PostApiFilesResponses = {
+export type GetApiFilesByIdError = GetApiFilesByIdErrors[keyof GetApiFilesByIdErrors];
+export type GetApiFilesByIdResponses = {
     /**
-     * 部分或全部成功
+     * 成功
      */
-    201: {
+    200: {
         /**
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: {
-            results: Array<BackendUploadResult>;
-        };
+        data: StoredFile;
     };
 };
-export type PostApiFilesResponse = PostApiFilesResponses[keyof PostApiFilesResponses];
-export type PostApiFilesPresignData = {
-    body: {
-        items: Array<{
-            filename: string;
-            size: number;
-            mimeType: string;
-            scope: FileScope;
-        }>;
+export type GetApiFilesByIdResponse = GetApiFilesByIdResponses[keyof GetApiFilesByIdResponses];
+export type GetApiFilesByIdRawData = {
+    body?: never;
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
     };
-    path?: never;
     query?: never;
-    url: '/api/files/presign';
+    url: '/api/files/{id}/raw';
 };
-export type PostApiFilesPresignErrors = {
+export type GetApiFilesByIdRawErrors = {
     /**
      * 请求参数无效
      */
@@ -523,32 +1885,26 @@ export type PostApiFilesPresignErrors = {
      */
     500: ErrorResponse;
 };
-export type PostApiFilesPresignError = PostApiFilesPresignErrors[keyof PostApiFilesPresignErrors];
-export type PostApiFilesPresignResponses = {
+export type GetApiFilesByIdRawError = GetApiFilesByIdRawErrors[keyof GetApiFilesByIdRawErrors];
+export type GetApiFilesByIdRawResponses = {
     /**
-     * 成功
+     * 文件二进制流，Content-Type 为文件 MIME
      */
-    201: {
+    200: Blob | File;
+};
+export type GetApiFilesByIdRawResponse = GetApiFilesByIdRawResponses[keyof GetApiFilesByIdRawResponses];
+export type GetApiFilesByIdUrlData = {
+    body?: never;
+    path: {
         /**
-         * 业务码，成功为 0
+         * 资源 ID
          */
-        code: number;
-        message: string;
-        data: {
-            results: Array<PrepareUploadResult>;
-        };
-    };
-};
-export type PostApiFilesPresignResponse = PostApiFilesPresignResponses[keyof PostApiFilesPresignResponses];
-export type PostApiFilesCompleteData = {
-    body: {
-        ids: Array<string>;
+        id: string;
     };
-    path?: never;
     query?: never;
-    url: '/api/files/complete';
+    url: '/api/files/{id}/url';
 };
-export type PostApiFilesCompleteErrors = {
+export type GetApiFilesByIdUrlErrors = {
     /**
      * 请求参数无效
      */
@@ -574,8 +1930,8 @@ export type PostApiFilesCompleteErrors = {
      */
     500: ErrorResponse;
 };
-export type PostApiFilesCompleteError = PostApiFilesCompleteErrors[keyof PostApiFilesCompleteErrors];
-export type PostApiFilesCompleteResponses = {
+export type GetApiFilesByIdUrlError = GetApiFilesByIdUrlErrors[keyof GetApiFilesByIdUrlErrors];
+export type GetApiFilesByIdUrlResponses = {
     /**
      * 成功
      */
@@ -584,24 +1940,48 @@ export type PostApiFilesCompleteResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
-            results: Array<CompleteUploadResult>;
+            /**
+             * 下载地址
+             */
+            url: string;
         };
     };
 };
-export type PostApiFilesCompleteResponse = PostApiFilesCompleteResponses[keyof PostApiFilesCompleteResponses];
-export type PostApiFilesCleanupData = {
+export type GetApiFilesByIdUrlResponse = GetApiFilesByIdUrlResponses[keyof GetApiFilesByIdUrlResponses];
+export type PostApiChatData = {
     body: {
-        dryRun?: boolean;
-        olderThanHours?: number;
-        deleteBatchSize?: number;
+        /**
+         * 会话 ID
+         */
+        conversationId: string;
+        /**
+         * 用户问题，与 attachments 至少传一项
+         */
+        content: string;
+        /**
+         * 图片附件，实际数量上限以 /api/chat/limits 返回的 imageMaxCount 为准
+         */
+        attachments?: Array<{
+            /**
+             * 当前用户上传且已就绪的对话图片文件 ID（scope=chat）
+             */
+            fileId: string;
+        }>;
+        /**
+         * 是否以 NDJSON 事件流返回，默认 true
+         */
+        stream?: boolean;
     };
     path?: never;
     query?: never;
-    url: '/api/files/cleanup';
+    url: '/api/chat';
 };
-export type PostApiFilesCleanupErrors = {
+export type PostApiChatErrors = {
     /**
      * 请求参数无效
      */
@@ -627,32 +2007,36 @@ export type PostApiFilesCleanupErrors = {
      */
     500: ErrorResponse;
 };
-export type PostApiFilesCleanupError = PostApiFilesCleanupErrors[keyof PostApiFilesCleanupErrors];
-export type PostApiFilesCleanupResponses = {
+export type PostApiChatError = PostApiChatErrors[keyof PostApiChatErrors];
+export type PostApiChatResponses = {
     /**
-     * 成功
+     * stream=true 为 NDJSON 事件；stream=false 为 JSON 信封
      */
     200: {
         /**
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: CleanupReport;
+        data: ChatAnswer;
     };
 };
-export type PostApiFilesCleanupResponse = PostApiFilesCleanupResponses[keyof PostApiFilesCleanupResponses];
-export type DeleteApiFilesByIdData = {
+export type PostApiChatResponse = PostApiChatResponses[keyof PostApiChatResponses];
+export type GetApiChatLimitsData = {
     body?: never;
-    path: {
-        id: string;
-    };
-    query?: {
-        force?: boolean;
+    path?: never;
+    query: {
+        /**
+         * 会话 ID
+         */
+        conversationId: string;
     };
-    url: '/api/files/{id}';
+    url: '/api/chat/limits';
 };
-export type DeleteApiFilesByIdErrors = {
+export type GetApiChatLimitsErrors = {
     /**
      * 请求参数无效
      */
@@ -661,36 +2045,78 @@ export type DeleteApiFilesByIdErrors = {
      * 未登录
      */
     401: ErrorResponse;
-    /**
-     * 无权限
-     */
-    403: ErrorResponse;
     /**
      * 资源不存在
      */
     404: ErrorResponse;
     /**
-     * 文件仍被引用
+     * 服务器内部错误
      */
-    409: {
+    500: ErrorResponse;
+};
+export type GetApiChatLimitsError = GetApiChatLimitsErrors[keyof GetApiChatLimitsErrors];
+export type GetApiChatLimitsResponses = {
+    /**
+     * 成功
+     */
+    200: {
         /**
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: FileReferencedData;
+        data: {
+            /**
+             * 单条消息图片数量上限
+             */
+            imageMaxCount: number;
+            /**
+             * 图片压缩最长边（像素），客户端上传前按此缩放
+             */
+            imageMaxEdge: number;
+            welcome: RagWelcomeConfig;
+            /**
+             * 生效的推荐问题
+             */
+            recommendedQuestions: Array<string>;
+        };
+    };
+};
+export type GetApiChatLimitsResponse = GetApiChatLimitsResponses[keyof GetApiChatLimitsResponses];
+export type GetApiChatConversationsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * 按会话归属用户过滤，仅管理员及以上生效
+         */
+        userId?: string;
+        /**
+         * 按问答助手 ID 过滤
+         */
+        ragId?: number;
+        /**
+         * 按智能路由 ID 过滤
+         */
+        routerId?: number;
     };
+    url: '/api/chat/conversations';
+};
+export type GetApiChatConversationsErrors = {
     /**
-     * LLM 并发已满
+     * 未登录
      */
-    429: ErrorResponse;
+    401: ErrorResponse;
     /**
      * 服务器内部错误
      */
     500: ErrorResponse;
 };
-export type DeleteApiFilesByIdError = DeleteApiFilesByIdErrors[keyof DeleteApiFilesByIdErrors];
-export type DeleteApiFilesByIdResponses = {
+export type GetApiChatConversationsError = GetApiChatConversationsErrors[keyof GetApiChatConversationsErrors];
+export type GetApiChatConversationsResponses = {
     /**
      * 成功
      */
@@ -699,20 +2125,46 @@ export type DeleteApiFilesByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: null;
+        data: Array<Conversation>;
     };
 };
-export type DeleteApiFilesByIdResponse = DeleteApiFilesByIdResponses[keyof DeleteApiFilesByIdResponses];
-export type GetApiFilesByIdData = {
-    body?: never;
-    path: {
-        id: string;
+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;
-    url: '/api/files/{id}';
+    url: '/api/chat/conversations';
 };
-export type GetApiFilesByIdErrors = {
+export type PostApiChatConversationsErrors = {
     /**
      * 请求参数无效
      */
@@ -738,30 +2190,36 @@ export type GetApiFilesByIdErrors = {
      */
     500: ErrorResponse;
 };
-export type GetApiFilesByIdError = GetApiFilesByIdErrors[keyof GetApiFilesByIdErrors];
-export type GetApiFilesByIdResponses = {
+export type PostApiChatConversationsError = PostApiChatConversationsErrors[keyof PostApiChatConversationsErrors];
+export type PostApiChatConversationsResponses = {
     /**
      * 成功
      */
-    200: {
+    201: {
         /**
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: StoredFile;
+        data: Conversation;
     };
 };
-export type GetApiFilesByIdResponse = GetApiFilesByIdResponses[keyof GetApiFilesByIdResponses];
-export type GetApiFilesByIdRawData = {
+export type PostApiChatConversationsResponse = PostApiChatConversationsResponses[keyof PostApiChatConversationsResponses];
+export type DeleteApiChatConversationsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
-    url: '/api/files/{id}/raw';
+    url: '/api/chat/conversations/{id}';
 };
-export type GetApiFilesByIdRawErrors = {
+export type DeleteApiChatConversationsByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -787,23 +2245,36 @@ export type GetApiFilesByIdRawErrors = {
      */
     500: ErrorResponse;
 };
-export type GetApiFilesByIdRawError = GetApiFilesByIdRawErrors[keyof GetApiFilesByIdRawErrors];
-export type GetApiFilesByIdRawResponses = {
+export type DeleteApiChatConversationsByIdError = DeleteApiChatConversationsByIdErrors[keyof DeleteApiChatConversationsByIdErrors];
+export type DeleteApiChatConversationsByIdResponses = {
     /**
-     * 文件二进制流，Content-Type 为文件 MIME
+     * 成功
      */
-    200: Blob | File;
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: null;
+    };
 };
-export type GetApiFilesByIdRawResponse = GetApiFilesByIdRawResponses[keyof GetApiFilesByIdRawResponses];
-export type GetApiFilesByIdUrlData = {
+export type DeleteApiChatConversationsByIdResponse = DeleteApiChatConversationsByIdResponses[keyof DeleteApiChatConversationsByIdResponses];
+export type GetApiChatConversationsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
-    url: '/api/files/{id}/url';
+    url: '/api/chat/conversations/{id}';
 };
-export type GetApiFilesByIdUrlErrors = {
+export type GetApiChatConversationsByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -829,8 +2300,8 @@ export type GetApiFilesByIdUrlErrors = {
      */
     500: ErrorResponse;
 };
-export type GetApiFilesByIdUrlError = GetApiFilesByIdUrlErrors[keyof GetApiFilesByIdUrlErrors];
-export type GetApiFilesByIdUrlResponses = {
+export type GetApiChatConversationsByIdError = GetApiChatConversationsByIdErrors[keyof GetApiChatConversationsByIdErrors];
+export type GetApiChatConversationsByIdResponses = {
     /**
      * 成功
      */
@@ -839,27 +2310,37 @@ export type GetApiFilesByIdUrlResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
-            url: string;
+            conversation: Conversation;
+            /**
+             * 会话消息，按时间正序
+             */
+            messages: Array<Message>;
         };
     };
 };
-export type GetApiFilesByIdUrlResponse = GetApiFilesByIdUrlResponses[keyof GetApiFilesByIdUrlResponses];
-export type PostApiChatData = {
+export type GetApiChatConversationsByIdResponse = GetApiChatConversationsByIdResponses[keyof GetApiChatConversationsByIdResponses];
+export type PatchApiChatConversationsByIdData = {
     body: {
-        conversationId: string;
-        content: string;
-        attachments?: Array<{
-            fileId: string;
-        }>;
-        stream?: boolean;
+        /**
+         * 会话标题，为空时保持原标题
+         */
+        title?: string;
+    };
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
     };
-    path?: never;
     query?: never;
-    url: '/api/chat';
+    url: '/api/chat/conversations/{id}';
 };
-export type PostApiChatErrors = {
+export type PatchApiChatConversationsByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -885,77 +2366,31 @@ export type PostApiChatErrors = {
      */
     500: ErrorResponse;
 };
-export type PostApiChatError = PostApiChatErrors[keyof PostApiChatErrors];
-export type PostApiChatResponses = {
+export type PatchApiChatConversationsByIdError = PatchApiChatConversationsByIdErrors[keyof PatchApiChatConversationsByIdErrors];
+export type PatchApiChatConversationsByIdResponses = {
     /**
-     * stream=true 为 NDJSON 事件；stream=false 为 JSON 信封
+     * 成功
      */
     200: {
         /**
          * 业务码，成功为 0
          */
         code: number;
-        message: string;
-        data: ChatAnswer;
-    };
-};
-export type PostApiChatResponse = PostApiChatResponses[keyof PostApiChatResponses];
-export type GetApiChatLimitsData = {
-    body?: never;
-    path?: never;
-    query: {
-        conversationId: string;
-    };
-    url: '/api/chat/limits';
-};
-export type GetApiChatLimitsErrors = {
-    /**
-     * 请求参数无效
-     */
-    400: ErrorResponse;
-    /**
-     * 未登录
-     */
-    401: ErrorResponse;
-    /**
-     * 资源不存在
-     */
-    404: ErrorResponse;
-    /**
-     * 服务器内部错误
-     */
-    500: ErrorResponse;
-};
-export type GetApiChatLimitsError = GetApiChatLimitsErrors[keyof GetApiChatLimitsErrors];
-export type GetApiChatLimitsResponses = {
-    /**
-     * 成功
-     */
-    200: {
         /**
-         * 业务码，成功为 0
+         * 提示信息，失败时为错误原因
          */
-        code: number;
         message: string;
-        data: {
-            imageMaxCount: number;
-            imageMaxEdge: number;
-            welcome: RagWelcomeConfig;
-            recommendedQuestions: Array<string>;
-        };
+        data: Conversation;
     };
 };
-export type GetApiChatLimitsResponse = GetApiChatLimitsResponses[keyof GetApiChatLimitsResponses];
-export type GetApiChatConversationsData = {
+export type PatchApiChatConversationsByIdResponse = PatchApiChatConversationsByIdResponses[keyof PatchApiChatConversationsByIdResponses];
+export type GetApiChatRoutersData = {
     body?: never;
     path?: never;
-    query?: {
-        userId?: string;
-        ragId?: number;
-    };
-    url: '/api/chat/conversations';
+    query?: never;
+    url: '/api/chat/routers';
 };
-export type GetApiChatConversationsErrors = {
+export type GetApiChatRoutersErrors = {
     /**
      * 未登录
      */
@@ -965,8 +2400,8 @@ export type GetApiChatConversationsErrors = {
      */
     500: ErrorResponse;
 };
-export type GetApiChatConversationsError = GetApiChatConversationsErrors[keyof GetApiChatConversationsErrors];
-export type GetApiChatConversationsResponses = {
+export type GetApiChatRoutersError = GetApiChatRoutersErrors[keyof GetApiChatRoutersErrors];
+export type GetApiChatRoutersResponses = {
     /**
      * 成功
      */
@@ -975,23 +2410,21 @@ export type GetApiChatConversationsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: Array<Conversation>;
+        data: Array<IntentRouter>;
     };
 };
-export type GetApiChatConversationsResponse = GetApiChatConversationsResponses[keyof GetApiChatConversationsResponses];
-export type PostApiChatConversationsData = {
-    body?: {
-        title?: string;
-        userId?: string;
-        ragId?: number;
-        mark?: string;
-    };
+export type GetApiChatRoutersResponse = GetApiChatRoutersResponses[keyof GetApiChatRoutersResponses];
+export type PostApiChatRoutersData = {
+    body: IntentRouterCreate;
     path?: never;
     query?: never;
-    url: '/api/chat/conversations';
+    url: '/api/chat/routers';
 };
-export type PostApiChatConversationsErrors = {
+export type PostApiChatRoutersErrors = {
     /**
      * 请求参数无效
      */
@@ -1000,25 +2433,13 @@ export type PostApiChatConversationsErrors = {
      * 未登录
      */
     401: ErrorResponse;
-    /**
-     * 无权限
-     */
-    403: ErrorResponse;
-    /**
-     * 资源不存在
-     */
-    404: ErrorResponse;
-    /**
-     * LLM 并发已满
-     */
-    429: ErrorResponse;
     /**
      * 服务器内部错误
      */
     500: ErrorResponse;
 };
-export type PostApiChatConversationsError = PostApiChatConversationsErrors[keyof PostApiChatConversationsErrors];
-export type PostApiChatConversationsResponses = {
+export type PostApiChatRoutersError = PostApiChatRoutersErrors[keyof PostApiChatRoutersErrors];
+export type PostApiChatRoutersResponses = {
     /**
      * 成功
      */
@@ -1027,20 +2448,31 @@ export type PostApiChatConversationsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: Conversation;
+        data: {
+            /**
+             * 新建智能路由 ID
+             */
+            id: number;
+        };
     };
 };
-export type PostApiChatConversationsResponse = PostApiChatConversationsResponses[keyof PostApiChatConversationsResponses];
-export type DeleteApiChatConversationsByIdData = {
+export type PostApiChatRoutersResponse = PostApiChatRoutersResponses[keyof PostApiChatRoutersResponses];
+export type DeleteApiChatRoutersByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
-    url: '/api/chat/conversations/{id}';
+    url: '/api/chat/routers/{id}';
 };
-export type DeleteApiChatConversationsByIdErrors = {
+export type DeleteApiChatRoutersByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -1066,8 +2498,8 @@ export type DeleteApiChatConversationsByIdErrors = {
      */
     500: ErrorResponse;
 };
-export type DeleteApiChatConversationsByIdError = DeleteApiChatConversationsByIdErrors[keyof DeleteApiChatConversationsByIdErrors];
-export type DeleteApiChatConversationsByIdResponses = {
+export type DeleteApiChatRoutersByIdError = DeleteApiChatRoutersByIdErrors[keyof DeleteApiChatRoutersByIdErrors];
+export type DeleteApiChatRoutersByIdResponses = {
     /**
      * 成功
      */
@@ -1076,20 +2508,26 @@ export type DeleteApiChatConversationsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
 };
-export type DeleteApiChatConversationsByIdResponse = DeleteApiChatConversationsByIdResponses[keyof DeleteApiChatConversationsByIdResponses];
-export type GetApiChatConversationsByIdData = {
+export type DeleteApiChatRoutersByIdResponse = DeleteApiChatRoutersByIdResponses[keyof DeleteApiChatRoutersByIdResponses];
+export type GetApiChatRoutersByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
-    url: '/api/chat/conversations/{id}';
+    url: '/api/chat/routers/{id}';
 };
-export type GetApiChatConversationsByIdErrors = {
+export type GetApiChatRoutersByIdErrors = {
     /**
      * 请求参数无效
      */
@@ -1115,8 +2553,8 @@ export type GetApiChatConversationsByIdErrors = {
      */
     500: ErrorResponse;
 };
-export type GetApiChatConversationsByIdError = GetApiChatConversationsByIdErrors[keyof GetApiChatConversationsByIdErrors];
-export type GetApiChatConversationsByIdResponses = {
+export type GetApiChatRoutersByIdError = GetApiChatRoutersByIdErrors[keyof GetApiChatRoutersByIdErrors];
+export type GetApiChatRoutersByIdResponses = {
     /**
      * 成功
      */
@@ -1125,25 +2563,26 @@ export type GetApiChatConversationsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: {
-            conversation: Conversation;
-            messages: Array<Message>;
-        };
+        data: IntentRouter;
     };
 };
-export type GetApiChatConversationsByIdResponse = GetApiChatConversationsByIdResponses[keyof GetApiChatConversationsByIdResponses];
-export type PatchApiChatConversationsByIdData = {
-    body: {
-        title?: string;
-    };
+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 = {
     /**
      * 请求参数无效
      */
@@ -1169,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 = {
     /**
      * 成功
      */
@@ -1179,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;
@@ -1200,6 +2642,9 @@ export type GetApiSearchData = {
          * 知识库标识，与 kbId 不能同时为空
          */
         mark?: string;
+        /**
+         * 返回条数上限，默认 20，最大 50
+         */
         limit?: number;
     };
     url: '/api/search';
@@ -1232,6 +2677,9 @@ export type GetApiSearchResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<SearchHit>;
     };
@@ -1288,6 +2736,9 @@ export type PostApiSearchClickResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1319,18 +2770,40 @@ export type GetApiKnowledgeBasesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
-        data: Array<KnowledgeBase>;
+        data: Array<KnowledgeBaseListItem>;
     };
 };
 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;
@@ -1364,8 +2837,14 @@ export type PostApiKnowledgeBasesResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 新建知识库 ID
+             */
             id: number;
         };
     };
@@ -1374,6 +2853,9 @@ export type PostApiKnowledgeBasesResponse = PostApiKnowledgeBasesResponses[keyof
 export type DeleteApiKnowledgeBasesByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1415,6 +2897,9 @@ export type DeleteApiKnowledgeBasesByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1423,6 +2908,9 @@ export type DeleteApiKnowledgeBasesByIdResponse = DeleteApiKnowledgeBasesByIdRes
 export type GetApiKnowledgeBasesByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1464,6 +2952,9 @@ export type GetApiKnowledgeBasesByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: KnowledgeBase;
     };
@@ -1471,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;
@@ -1519,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;
@@ -1550,6 +3099,9 @@ export type GetApiRagsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<Rag>;
     };
@@ -1557,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;
@@ -1603,8 +3211,14 @@ export type PostApiRagsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: {
+            /**
+             * 新建问答助手 ID
+             */
             id: number;
         };
     };
@@ -1613,6 +3227,9 @@ export type PostApiRagsResponse = PostApiRagsResponses[keyof PostApiRagsResponse
 export type DeleteApiRagsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1654,6 +3271,9 @@ export type DeleteApiRagsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1662,6 +3282,9 @@ export type DeleteApiRagsByIdResponse = DeleteApiRagsByIdResponses[keyof DeleteA
 export type GetApiRagsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -1703,6 +3326,9 @@ export type GetApiRagsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Rag;
     };
@@ -1710,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;
@@ -1770,6 +3455,9 @@ export type PatchApiRagsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Rag;
     };
@@ -1779,7 +3467,13 @@ export type GetApiRagsDetailData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 问答助手 ID，与 mark 不能同时为空
+         */
         id?: number | null;
+        /**
+         * 问答助手标识，与 id 不能同时为空
+         */
         mark?: string;
     };
     url: '/api/rags/detail';
@@ -1812,6 +3506,9 @@ export type GetApiRagsDetailResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: RagDetail;
     };
@@ -1856,6 +3553,9 @@ export type DeleteApiDocumentsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -1896,6 +3596,9 @@ export type GetApiDocumentsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<DocumentSummary>;
     };
@@ -1903,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;
     };
@@ -1944,6 +3653,9 @@ export type PostApiDocumentsResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: DocumentSummary;
     };
@@ -1988,6 +3700,9 @@ export type GetApiDocumentsTreeResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<DocumentTreeNode>;
     };
@@ -2035,6 +3750,9 @@ export type PatchApiDocumentsByPathResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Document;
     };
@@ -2043,6 +3761,9 @@ export type PatchApiDocumentsByPathResponse = PatchApiDocumentsByPathResponses[k
 export type DeleteApiDocumentsByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2084,6 +3805,9 @@ export type DeleteApiDocumentsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -2092,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}';
@@ -2123,6 +3853,9 @@ export type GetApiDocumentsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Document;
     };
@@ -2130,13 +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;
@@ -2178,16 +3934,80 @@ export type PatchApiDocumentsByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Document;
     };
 };
 export type PatchApiDocumentsByIdResponse = PatchApiDocumentsByIdResponses[keyof PatchApiDocumentsByIdResponses];
+export type PostApiDocumentsByIdCopyData = {
+    body?: never;
+    path: {
+        /**
+         * 资源 ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/documents/{id}/copy';
+};
+export type PostApiDocumentsByIdCopyErrors = {
+    /**
+     * 请求参数无效
+     */
+    400: ErrorResponse;
+    /**
+     * 未登录
+     */
+    401: ErrorResponse;
+    /**
+     * 无权限
+     */
+    403: ErrorResponse;
+    /**
+     * 资源不存在
+     */
+    404: ErrorResponse;
+    /**
+     * LLM 并发已满
+     */
+    429: ErrorResponse;
+    /**
+     * 服务器内部错误
+     */
+    500: ErrorResponse;
+};
+export type PostApiDocumentsByIdCopyError = PostApiDocumentsByIdCopyErrors[keyof PostApiDocumentsByIdCopyErrors];
+export type PostApiDocumentsByIdCopyResponses = {
+    /**
+     * 成功
+     */
+    200: {
+        /**
+         * 业务码，成功为 0
+         */
+        code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
+        message: string;
+        data: Document;
+    };
+};
+export type PostApiDocumentsByIdCopyResponse = PostApiDocumentsByIdCopyResponses[keyof PostApiDocumentsByIdCopyResponses];
 export type GetApiFoldersData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 知识库 ID，与 mark 不能同时为空
+         */
         kbId?: number | null;
+        /**
+         * 知识库标识，与 kbId 不能同时为空
+         */
         mark?: string;
     };
     url: '/api/folders';
@@ -2220,6 +4040,9 @@ export type GetApiFoldersResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Array<Folder>;
     };
@@ -2227,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;
@@ -2264,6 +4096,9 @@ export type PostApiFoldersResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Folder;
     };
@@ -2272,6 +4107,9 @@ export type PostApiFoldersResponse = PostApiFoldersResponses[keyof PostApiFolder
 export type DeleteApiFoldersByIdData = {
     body?: never;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2313,6 +4151,9 @@ export type DeleteApiFoldersByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: null;
     };
@@ -2320,11 +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;
@@ -2366,6 +4220,9 @@ export type PatchApiFoldersByIdResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: Folder;
     };
@@ -2374,6 +4231,9 @@ export type PatchApiFoldersByIdResponse = PatchApiFoldersByIdResponses[keyof Pat
 export type PostApiWorkflowsByIdInvokeData = {
     body: WorkflowInvokeRequest;
     path: {
+        /**
+         * 资源 ID
+         */
         id: string;
     };
     query?: never;
@@ -2415,6 +4275,9 @@ export type PostApiWorkflowsByIdInvokeResponses = {
          * 业务码，成功为 0
          */
         code: number;
+        /**
+         * 提示信息，失败时为错误原因
+         */
         message: string;
         data: WorkflowInvokeResult;
     };