@huyooo/ui 3.0.0 → 4.0.1

package/dist/types/api/ones.generated.d.ts

@@ -1,22 +1,189 @@
-import { ApiResponse, RequestConfig, Client, EdenClient } from '@vafast/api-client';
+import { RequestConfig, Client, EdenClient, RequestBuilder } from '@vafast/api-client';
 /** API 契约类型 */
 export type Api = {
     health: {
-        /** 检查服务健康状态 */
         get: {
             return: any;
         };
     };
     'api-spec': {
-        /** 获取 API 规范，用于类型同步 */
         get: {
             return: any;
         };
     };
-    webhook: {
-        /** Webhook 接收测试端点 */
-        post: {
-            return: any;
+    internal: {
+        queue: {
+            storage: {
+                'cos-settlement': {
+                    /** 按价目表日窗口结算 COS 存储 GB·天用量（队列每日北京时间 0:05 触发） */
+                    post: {
+                        body: {
+                            appId: string;
+                            queueKey: string;
+                            queueDefinitionId: string;
+                            taskRunId: string;
+                            queueServiceKey: string;
+                            context: {
+                                triggerSource: "manual" | "internal" | "scheduler" | "planner" | "retry";
+                                actor: {
+                                    type: "user" | "service" | "system" | "queue";
+                                    id?: string;
+                                };
+                                businessContext: {
+                                    resourceType?: string;
+                                    resourceId?: string;
+                                    operation?: string;
+                                };
+                                traceContext: {
+                                    requestId?: string;
+                                    traceId?: string;
+                                    parentTaskRunId?: string;
+                                };
+                            };
+                        } & {
+                            payload: {
+                                scheduledAt?: string;
+                                source?: string;
+                                schedulerJobId?: string;
+                            };
+                        };
+                        return: any;
+                    };
+                };
+                'cos-settlement-scan': {
+                    /** 供 queue-server 平台调度触发，按有文件的 app 逐个入队结算任务 */
+                    post: {
+                        body: {
+                            queueServiceKey?: string;
+                            scheduledAt?: string;
+                            source?: string;
+                        };
+                        return: any;
+                    };
+                };
+            };
+        };
+        notificationGroups: {
+            resolve: {
+                /** 按 ID 列表解析并合并通知组投递配置 */
+                post: {
+                    body: {
+                        appId: string;
+                        groupIds: string[];
+                    };
+                    return: any;
+                };
+            };
+            dispatch: {
+                /** 解析通知组并合并投递邮件与 Webhook */
+                post: {
+                    body: {
+                        appId: string;
+                        groupIds: string[];
+                        alertEvent?: {
+                            kind: "triggered" | "test" | "preview";
+                            ruleId?: string;
+                            ruleName: string;
+                            metric: string;
+                            metricLabel: string;
+                            operator: string;
+                            operatorLabel: string;
+                            threshold: number;
+                            thresholdText: string;
+                            currentValue?: number;
+                            currentValueText?: string;
+                            path?: string;
+                            appId?: string;
+                            windowMinutes?: number;
+                            requestCount?: number;
+                            minRequests?: number;
+                            triggeredAt: string;
+                            evaluationReason?: string;
+                            conditionText?: string;
+                            wouldTrigger?: boolean;
+                        };
+                        securityAlert?: {
+                            alertId: string;
+                            appId: string;
+                            type: string;
+                            typeLabel: string;
+                            riskLevel: string;
+                            riskLevelLabel: string;
+                            clientIp: string;
+                            email?: string;
+                            userId?: string;
+                            relatedAccountSummary?: string | null;
+                            resolved: boolean;
+                            autoBlocked: boolean;
+                            triggeredAt: string;
+                            details: Record<string, unknown>;
+                        };
+                        businessEvent?: {
+                            eventKey: string;
+                            eventId: string;
+                            data: unknown;
+                            subscriptionSecret?: string | null;
+                        };
+                    };
+                    return: any;
+                };
+            };
+            dispatchNotify: {
+                /** 按目标类型向多个端点投递告警 Webhook 通知 */
+                post: {
+                    body: {
+                        targets: ({
+                            type: "generic" | "feishu" | "dingtalk" | "wecom" | "slack" | "email";
+                            url: string;
+                            secret?: string | null;
+                        })[];
+                        event: {
+                            kind: "triggered" | "test" | "preview";
+                            ruleId?: string;
+                            ruleName: string;
+                            metric: string;
+                            metricLabel: string;
+                            operator: string;
+                            operatorLabel: string;
+                            threshold: number;
+                            thresholdText: string;
+                            currentValue?: number;
+                            currentValueText?: string;
+                            path?: string;
+                            appId?: string;
+                            windowMinutes?: number;
+                            requestCount?: number;
+                            minRequests?: number;
+                            triggeredAt: string;
+                            evaluationReason?: string;
+                            conditionText?: string;
+                            wouldTrigger?: boolean;
+                        };
+                    };
+                    return: any;
+                };
+            };
+        };
+        messageNotifications: {
+            publish: {
+                /** 写入消息中心并可选发送邮件 */
+                post: {
+                    body: {
+                        appId: string;
+                        targetType: "all" | "role" | "user";
+                        targetIds: string[];
+                        title: string;
+                        description: string;
+                        type: string;
+                        priority: "urgent" | "high" | "normal" | "low";
+                        content: unknown;
+                        sendEmail?: boolean;
+                        appName?: string;
+                        emailLink?: string;
+                    };
+                    return: any;
+                };
+            };
         };
     };
     users: {
@@ -50,6 +217,8 @@ export type Api = {
                         status?: "draft" | "published";
                         targetType?: "all" | "role" | "user";
                         targetIds?: string[];
+                        sendEmail?: boolean;
+                        emailLink?: string;
                     };
                     return: any;
                 };
@@ -130,6 +299,7 @@ export type Api = {
                             type?: string;
                             priority?: "urgent" | "high" | "normal" | "low";
                             status?: "draft" | "published";
+                            targetType?: "all" | "role" | "user";
                         };
                     };
                     return: any;
@@ -167,6 +337,73 @@ export type Api = {
                 };
             };
         };
+        messageNotificationTypes: {
+            list: {
+                /** 分页查询当前应用可见的消息通知类型 */
+                post: {
+                    body: {
+                        type?: string;
+                        label?: string;
+                        accessScope?: "private" | "all_apps";
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+            selectable: {
+                /** 消息中心创建通知时可绑定的类型列表 */
+                post: {
+                    body: Record<string, unknown>;
+                    return: any;
+                };
+            };
+            findOne: {
+                post: {
+                    body: {
+                        id: string;
+                    };
+                    return: any;
+                };
+            };
+            create: {
+                post: {
+                    body: {
+                        type: string;
+                        label: string;
+                        description: string;
+                        contentShape?: "text" | "descriptions";
+                        contentSchema: unknown;
+                        sampleContent: unknown;
+                        accessScope?: "private" | "all_apps";
+                    };
+                    return: any;
+                };
+            };
+            update: {
+                post: {
+                    body: {
+                        id: string;
+                        type: string;
+                        label: string;
+                        description: string;
+                        contentShape?: "text" | "descriptions";
+                        contentSchema?: unknown;
+                        sampleContent: unknown;
+                        accessScope?: "private" | "all_apps";
+                    };
+                    return: any;
+                };
+            };
+            delete: {
+                post: {
+                    body: {
+                        id: string;
+                    };
+                    return: any;
+                };
+            };
+        };
         changelogNotifications: {
             create: {
                 /** 创建新的更新日志 */
@@ -487,6 +724,115 @@ export type Api = {
             };
         };
     };
+    notificationGroups: {
+        list: {
+            post: {
+                body: {
+                    id?: string;
+                    name?: string;
+                    description?: string;
+                    notifyChannel?: "email" | "webhook" | "message";
+                    enabled?: boolean;
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        create: {
+            post: {
+                body: {
+                    name: string;
+                    description?: string;
+                    enabled?: boolean;
+                    notifyChannels: ("email" | "webhook" | "message")[];
+                    notifyEmails?: string[];
+                    webhookTargets?: ({
+                        type: "generic" | "feishu" | "dingtalk" | "wecom" | "slack";
+                        url: string;
+                        secret?: string | null;
+                    })[];
+                    notifyMessage?: {
+                        targetType: "all" | "role" | "user";
+                        targetIds: string[];
+                        type: string;
+                        priority: "urgent" | "high" | "normal" | "low";
+                    };
+                };
+                return: any;
+            };
+        };
+        update: {
+            post: {
+                body: {
+                    id: string;
+                    name?: string;
+                    description?: string;
+                    enabled?: boolean;
+                    notifyChannels?: ("email" | "webhook" | "message")[];
+                    notifyEmails?: string[];
+                    webhookTargets?: ({
+                        type: "generic" | "feishu" | "dingtalk" | "wecom" | "slack";
+                        url: string;
+                        secret?: string | null;
+                    })[];
+                    notifyMessage?: {
+                        targetType: "all" | "role" | "user";
+                        targetIds: string[];
+                        type: string;
+                        priority: "urgent" | "high" | "normal" | "low";
+                    };
+                };
+                return: any;
+            };
+        };
+        delete: {
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            post: {
+                body: {
+                    enabledOnly?: boolean;
+                };
+                return: any;
+            };
+        };
+        sendTest: {
+            post: {
+                body: {
+                    id: string;
+                    subject?: string;
+                    text?: string;
+                };
+                return: any;
+            };
+        };
+        validate: {
+            /** 验证邮件或 Webhook 端点是否可达 */
+            post: {
+                body: {
+                    endpointUrl?: string;
+                    deliveryType?: "generic" | "feishu" | "dingtalk" | "wecom" | "slack" | "email";
+                    signSecret?: string;
+                    notifyEmails?: string[];
+                };
+                return: any;
+            };
+        };
+    };
     webhooks: {
         events: {
             /** 获取所有可用的 Webhook 事件类型 */
@@ -525,6 +871,7 @@ export type Api = {
                     useQuota?: boolean;
                     maxTotalSize?: number;
                     maxFileCount?: number;
+                    accessScope?: "private" | "all_apps";
                 };
                 return: any;
             };
@@ -553,6 +900,7 @@ export type Api = {
                     useQuota?: boolean;
                     maxTotalSize?: number;
                     maxFileCount?: number;
+                    accessScope?: "private" | "all_apps";
                 };
                 return: any;
             };
@@ -565,6 +913,13 @@ export type Api = {
                     pageSize: number;
                     where: {
                         name?: string;
+                        bucketId?: string;
+                        accessScope?: "private" | "all_apps";
+                        accessMode?: "owned" | "granted";
+                        useFileExtensions?: boolean;
+                        useLimitContentLength?: boolean;
+                        useLimitContentTypes?: boolean;
+                        fileExtension?: string;
                     };
                 };
                 return: any;
@@ -637,6 +992,7 @@ export type Api = {
                     current: number;
                     pageSize: number;
                     where: {
+                        id?: string;
                         bucketId?: string;
                         name?: string;
                         filename?: string;
@@ -645,11 +1001,21 @@ export type Api = {
                         keyword?: string;
                         fileCategory?: string;
                         creatorKeyword?: string;
+                        bucketAccessScope?: "private" | "all_apps";
                     };
                 };
                 return: any;
             };
         };
+        findMany: {
+            /** 根据 ID 列表批量查询文件详情 */
+            post: {
+                body: {
+                    ids: string[];
+                };
+                return: any;
+            };
+        };
         findOne: {
             /** 根据 ID 查询文件详情 */
             post: {
@@ -691,143 +1057,22 @@ export type Api = {
             };
         };
     };
-    events: {
-        create: {
-            /** 创建新事件 */
-            post: {
-                body: {
-                    name: string;
-                    eventKey: string;
-                    type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                    description: string;
-                };
-                return: any;
-            };
-        };
-        delete: {
-            /** 删除事件 */
-            post: {
-                body: {
-                    id: string;
-                };
-                return: any;
-            };
-        };
-        update: {
-            /** 更新事件信息 */
-            post: {
-                body: {
-                    id: string;
-                    name: string;
-                    eventKey: string;
-                    type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                    description: string;
-                };
-                return: any;
-            };
-        };
-        find: {
-            /** 分页查询事件列表 */
-            post: {
-                body: {
-                    current: number;
-                    pageSize: number;
-                    where: {
-                        name?: string;
-                        type?: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                        eventKey?: string;
-                        description?: string;
-                    };
-                };
-                return: any;
-            };
-        };
-        findOne: {
-            /** 根据 ID 查询事件详情 */
-            post: {
-                body: {
-                    id: string;
-                };
-                return: any;
-            };
-        };
-    };
-    eventLogs: {
-        create: {
-            /** 创建新事件日志 */
-            post: {
-                body: {
-                    payload: unknown;
-                    name: string;
-                    eventKey: string;
-                    type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                };
-                return: any;
-            };
-        };
-        delete: {
-            /** 删除事件日志 */
-            post: {
-                body: {
-                    id: string;
-                };
-                return: any;
-            };
-        };
-        update: {
-            /** 更新事件日志 */
-            post: {
-                body: {
-                    id: string;
-                    payload: unknown;
-                    name: string;
-                    eventKey: string;
-                    type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                };
-                return: any;
-            };
-        };
-        find: {
-            /** 分页查询事件日志列表 */
-            post: {
-                body: {
-                    current: number;
-                    pageSize: number;
-                    where: {
-                        name?: string;
-                        type?: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                        eventKey?: string;
-                    };
-                };
-                return: any;
-            };
-        };
-        findOne: {
-            /** 根据 ID 查询事件日志详情 */
-            post: {
-                body: {
-                    id: string;
-                };
-                return: any;
-            };
-        };
-    };
     feedbackCenter: {
         create: {
             /** 用户提交反馈 */
             post: {
                 body: {
                     title: string;
-                    type: "bugReports" | "featureSuggestions" | "technicalSupportRequests" | "generalOpinions";
+                    type: "bugReports" | "featureSuggestions" | "technicalSupportRequests" | "generalOpinions" | "illegalContentReports";
                     description: string;
                     priority?: "urgent" | "high" | "normal" | "low";
-                    attachments?: {
+                    attachments?: ({
                         key: string;
                         name: string;
                         size: number;
                         mimeType: string;
                         kind: "image" | "video" | "file";
-                    }[];
+                    })[];
                 };
                 return: any;
             };
@@ -870,13 +1115,13 @@ export type Api = {
                         message: {
                             type: "text";
                             content?: string;
-                            attachments?: {
+                            attachments?: ({
                                 key: string;
                                 name: string;
                                 size: number;
                                 mimeType: string;
                                 kind: "image" | "video" | "file";
-                            }[];
+                            })[];
                             senderRole: "user" | "support" | "system";
                         };
                     };
@@ -942,7 +1187,7 @@ export type Api = {
             };
         };
         unreadReplyCount: {
-            /** 统计末条客服消息尚未阅读的未关闭反馈数 */
+            /** 统计当前用户反馈中末条客服消息尚未阅读的会话数量 */
             post: {
                 return: any;
             };
@@ -959,6 +1204,10 @@ export type Api = {
         getTrafficStatistics: {
             /** 获取反馈流量统计数据 */
             post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                };
                 return: any;
             };
         };
@@ -983,13 +1232,13 @@ export type Api = {
                     message: {
                         type: "text";
                         content?: string;
-                        attachments?: {
+                        attachments?: ({
                             key: string;
                             name: string;
                             size: number;
                             mimeType: string;
                             kind: "image" | "video" | "file";
-                        }[];
+                        })[];
                         senderRole: "user" | "support" | "system";
                     };
                 };
@@ -1022,7 +1271,16 @@ export type Api = {
             post: {
                 body: {
                     repositorieId: string;
-                    content: string;
+                    content: {
+                        type: string;
+                        attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                        content?: unknown[];
+                        marks?: ({
+                            type: string;
+                            attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                        })[];
+                        text?: string;
+                    };
                 };
                 return: any;
             };
@@ -1041,7 +1299,16 @@ export type Api = {
             post: {
                 body: {
                     id: string;
-                    content: string;
+                    content: {
+                        type: string;
+                        attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                        content?: unknown[];
+                        marks?: ({
+                            type: string;
+                            attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                        })[];
+                        text?: string;
+                    };
                 };
                 return: any;
             };
@@ -1060,7 +1327,16 @@ export type Api = {
             };
         };
         findOne: {
-            /** 根据 ID 查询文档详情 */
+            /** 根据 ID 查询当前应用的文档管理详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        findPublicOne: {
+            /** 仅查询已公开知识库中的文档详情 */
             post: {
                 body: {
                     id: string;
@@ -1075,10 +1351,10 @@ export type Api = {
             post: {
                 body: {
                     path: string;
-                    components: {
+                    components: ({
                         type: "pageFaq" | "pageHero" | "pageFeature";
                         config: unknown;
-                    }[];
+                    })[];
                     description: string;
                 };
                 return: any;
@@ -1099,10 +1375,10 @@ export type Api = {
                 body: {
                     id: string;
                     path: string;
-                    components: {
+                    components: ({
                         type: "pageFaq" | "pageHero" | "pageFeature";
                         config: unknown;
-                    }[];
+                    })[];
                     description: string;
                 };
                 return: any;
@@ -1159,7 +1435,34 @@ export type Api = {
                 post: {
                     body: {
                         id: string;
-                        catalogues: unknown[];
+                        catalogues: {
+                            name: string;
+                            key: string;
+                            children?: unknown[];
+                        }[];
+                    };
+                    return: any;
+                };
+            };
+        };
+        documents: {
+            create: {
+                /** 创建文档并原子化写入知识库目录 */
+                post: {
+                    body: {
+                        repositoryId: string;
+                        parentId?: string;
+                        name: string;
+                    };
+                    return: any;
+                };
+            };
+            delete: {
+                /** 删除目录节点、子节点及对应文档 */
+                post: {
+                    body: {
+                        repositoryId: string;
+                        documentId: string;
                     };
                     return: any;
                 };
@@ -1181,7 +1484,16 @@ export type Api = {
             };
         };
         findOne: {
-            /** 根据 ID 查询知识库详情 */
+            /** 根据 ID 查询当前应用的知识库管理详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        findPublicOne: {
+            /** 根据 ID 查询当前应用已公开的知识库详情 */
             post: {
                 body: {
                     id: string;
@@ -1300,7 +1612,314 @@ export type Api = {
                 body: {
                     id: string;
                 };
-                return: any;
+                return: any;
+            };
+        };
+    };
+    releases: {
+        getUploadToken: {
+            /** STS 临时凭证（30 分钟）。对 electron/production/{appId}/{platform}/{arch}/versions/{version}/ 或 latest/ 目录授权。 */
+            post: {
+                body: {
+                    version: string;
+                    platformId: string;
+                    target?: "version" | "latest";
+                    filename: string;
+                };
+                return: any;
+            };
+        };
+        uploadComplete: {
+            /** 各平台打包上传完成后调用。服务端自动创建/更新版本记录。 */
+            post: {
+                body: {
+                    version: string;
+                    platformId: string;
+                    downloadUrl: string;
+                    artifactUrl?: string;
+                    zipUrl?: string;
+                    artifactKey?: string;
+                    latestKey?: string;
+                    zipKey?: string;
+                    fileSize?: number;
+                    releaseNotes?: string;
+                    channel?: string;
+                };
+                return: any;
+            };
+        };
+        latest: {
+            /** 公开接口。通过 app-id header 传入。 */
+            post: {
+                return: any;
+            };
+        };
+        list: {
+            /** 管理端查询 Electron 发布版本列表。 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where?: {
+                        version?: string;
+                        status?: "draft" | "published" | "disabled" | "archived";
+                        platformId?: string;
+                        channel?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        detail: {
+            /** 管理端查询单个 Electron 发布版本详情。 */
+            post: {
+                body: {
+                    version: string;
+                };
+                return: any;
+            };
+        };
+        updateStatus: {
+            /** 管理端更新发布版本状态。 */
+            post: {
+                body: {
+                    version: string;
+                    status: "draft" | "published" | "disabled" | "archived";
+                };
+                return: any;
+            };
+        };
+        setLatest: {
+            /** 管理端指定某版本为 latest，并重建 Electron 更新 feed。 */
+            post: {
+                body: {
+                    version: string;
+                };
+                return: any;
+            };
+        };
+        refreshFeed: {
+            /** 管理端按当前 latest 版本重建 Electron RELEASES.json。 */
+            post: {
+                body: {
+                    version?: string;
+                };
+                return: any;
+            };
+        };
+    };
+    market: {
+        getUploadToken: {
+            /** STS 临时凭证（30 分钟），对 superx-market/extensions/{extensionId}/{version}/ 目录授权。 */
+            post: {
+                body: {
+                    extensionId: string;
+                    version: string;
+                };
+                return: any;
+            };
+        };
+        publish: {
+            /** CLI 上传完成后调用。创建或更新扩展版本记录。 */
+            post: {
+                body: {
+                    extensionId: string;
+                    version: string;
+                    sha256: string;
+                    name: string;
+                    description: string;
+                    overview?: string;
+                    icon: string;
+                    iconBg?: string;
+                    iconColor?: string;
+                    category: string;
+                    features: {
+                        tools?: boolean;
+                        skills?: boolean;
+                        mcps?: boolean;
+                        parts?: boolean;
+                        bin?: boolean;
+                        app?: {
+                            activation: {
+                                direct?: Record<string, unknown>;
+                                directory?: Record<string, unknown>;
+                                file?: {
+                                    extensions?: string[];
+                                    mediaKinds?: ("image" | "video" | "audio")[];
+                                };
+                            };
+                        };
+                    };
+                    defaults?: {
+                        extensionEnabled?: boolean;
+                        toolsChatEnabled?: boolean;
+                    };
+                    resources?: {
+                        description?: string;
+                        items: ({
+                            name: string;
+                            storageKind: "sqlite" | "vector" | "fulltext" | "filesystem";
+                            scope?: "extension" | "workspace" | "custom";
+                            description: string;
+                            queryHint: string;
+                            path?: string;
+                            capabilities?: {
+                                readable?: boolean;
+                                writable?: boolean;
+                                queryable?: boolean;
+                                searchable?: boolean;
+                                recoverable?: boolean;
+                            };
+                        })[];
+                    };
+                    runtime?: {
+                        binaries?: ({
+                            name: string;
+                            path: string;
+                            platform?: "darwin" | "win32" | "linux";
+                            arch?: "arm64" | "x64";
+                            required?: boolean;
+                        })[];
+                    };
+                    assets: {
+                        tools?: {
+                            description: string;
+                            items: {
+                                name: string;
+                                displayName?: string;
+                                description: string;
+                                category: string;
+                                parameters?: Record<string, unknown>;
+                                governance?: {
+                                    sideEffectLevel?: string;
+                                    approvalPolicy?: string;
+                                };
+                            }[];
+                        };
+                        parts?: {
+                            description: string;
+                            items: {
+                                name: string;
+                                description: string;
+                            }[];
+                        };
+                        app?: {
+                            description: string;
+                            activation: {
+                                direct?: Record<string, unknown>;
+                                directory?: Record<string, unknown>;
+                                file?: {
+                                    extensions?: string[];
+                                    mediaKinds?: ("image" | "video" | "audio")[];
+                                };
+                            };
+                        };
+                        skills?: {
+                            description: string;
+                            items: {
+                                name: string;
+                                description?: string;
+                            }[];
+                        };
+                        mcps?: {
+                            description: string;
+                            items: ({
+                                name: string;
+                                description?: string;
+                                transport?: "stdio" | "streamableHttp" | "sse";
+                            })[];
+                        };
+                        resources?: {
+                            description?: string;
+                            items: ({
+                                name: string;
+                                storageKind: "sqlite" | "vector" | "fulltext" | "filesystem";
+                                scope?: "extension" | "workspace" | "custom";
+                                description: string;
+                                queryHint: string;
+                                path?: string;
+                                capabilities?: {
+                                    readable?: boolean;
+                                    writable?: boolean;
+                                    queryable?: boolean;
+                                    searchable?: boolean;
+                                    recoverable?: boolean;
+                                };
+                            })[];
+                        };
+                    };
+                    tags: string[];
+                    lifecycle: {
+                        installable: boolean;
+                        uninstallable: boolean;
+                        enableSwitch: boolean;
+                        updatable: boolean;
+                    };
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** CLI 删除已发布扩展。支持删除单个版本或全部版本，并同步清理 COS 归档。 */
+            post: {
+                body: {
+                    extensionId: string;
+                    version?: string;
+                };
+                return: any;
+            };
+        };
+        catalog: {
+            /** 公开接口。Ones 标准分页（current/pageSize/where → items/count）。每个 extensionId 仅返回最新 published 版本；不含 overview/assets（详情走 /market/detail）。 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where?: {
+                        keyword?: string;
+                        category?: string;
+                        feature?: string;
+                        extensionId?: string;
+                        extensionIds?: string[];
+                        installStatus?: "installed" | "not-installed";
+                        installedIds?: string[];
+                    };
+                };
+                return: any;
+            };
+        };
+        detail: {
+            /** 公开接口。仅获取已发布扩展的详情和 CDN 下载基础 URL。 */
+            post: {
+                body: {
+                    extensionId: string;
+                    version?: string;
+                };
+                return: any;
+            };
+        };
+        admin: {
+            'set-status': {
+                /** 管理接口。修改扩展的上架状态（published/unlisted/suspended）。需登录态。 */
+                post: {
+                    body: {
+                        extensionId: string;
+                        status: "published" | "unlisted" | "suspended";
+                        reason?: string;
+                    };
+                    return: any;
+                };
+            };
+            'set-trust': {
+                /** 管理接口。修改扩展的信任等级（official/verified/community）。需登录态。 */
+                post: {
+                    body: {
+                        extensionId: string;
+                        trust: "official" | "verified" | "community";
+                        reason?: string;
+                    };
+                    return: any;
+                };
             };
         };
     };
@@ -1308,27 +1927,178 @@ export type Api = {
 /** API 客户端类型（提供完整的 IDE 智能提示） */
 export interface ApiClient {
     health: {
-        /** 检查服务健康状态 */
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        get: (config?: RequestConfig) => RequestBuilder<any>;
     };
     'api-spec': {
-        /** 获取 API 规范，用于类型同步 */
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        get: (config?: RequestConfig) => RequestBuilder<any>;
     };
-    webhook: {
-        /** Webhook 接收测试端点 */
-        post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+    internal: {
+        queue: {
+            storage: {
+                'cos-settlement': {
+                    /** 按价目表日窗口结算 COS 存储 GB·天用量（队列每日北京时间 0:05 触发） */
+                    post: (body?: {
+                        appId: string;
+                        queueKey: string;
+                        queueDefinitionId: string;
+                        taskRunId: string;
+                        queueServiceKey: string;
+                        context: {
+                            triggerSource: "manual" | "internal" | "scheduler" | "planner" | "retry";
+                            actor: {
+                                type: "user" | "service" | "system" | "queue";
+                                id?: string;
+                            };
+                            businessContext: {
+                                resourceType?: string;
+                                resourceId?: string;
+                                operation?: string;
+                            };
+                            traceContext: {
+                                requestId?: string;
+                                traceId?: string;
+                                parentTaskRunId?: string;
+                            };
+                        };
+                    } & {
+                        payload: {
+                            scheduledAt?: string;
+                            source?: string;
+                            schedulerJobId?: string;
+                        };
+                    }, config?: RequestConfig) => RequestBuilder<any>;
+                };
+                'cos-settlement-scan': {
+                    /** 供 queue-server 平台调度触发，按有文件的 app 逐个入队结算任务 */
+                    post: (body?: {
+                        queueServiceKey?: string;
+                        scheduledAt?: string;
+                        source?: string;
+                    }, config?: RequestConfig) => RequestBuilder<any>;
+                };
+            };
+        };
+        notificationGroups: {
+            resolve: {
+                /** 按 ID 列表解析并合并通知组投递配置 */
+                post: (body: {
+                    appId: string;
+                    groupIds: string[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            dispatch: {
+                /** 解析通知组并合并投递邮件与 Webhook */
+                post: (body: {
+                    appId: string;
+                    groupIds: string[];
+                    alertEvent?: {
+                        kind: "triggered" | "test" | "preview";
+                        ruleId?: string;
+                        ruleName: string;
+                        metric: string;
+                        metricLabel: string;
+                        operator: string;
+                        operatorLabel: string;
+                        threshold: number;
+                        thresholdText: string;
+                        currentValue?: number;
+                        currentValueText?: string;
+                        path?: string;
+                        appId?: string;
+                        windowMinutes?: number;
+                        requestCount?: number;
+                        minRequests?: number;
+                        triggeredAt: string;
+                        evaluationReason?: string;
+                        conditionText?: string;
+                        wouldTrigger?: boolean;
+                    };
+                    securityAlert?: {
+                        alertId: string;
+                        appId: string;
+                        type: string;
+                        typeLabel: string;
+                        riskLevel: string;
+                        riskLevelLabel: string;
+                        clientIp: string;
+                        email?: string;
+                        userId?: string;
+                        relatedAccountSummary?: string | null;
+                        resolved: boolean;
+                        autoBlocked: boolean;
+                        triggeredAt: string;
+                        details: Record<string, unknown>;
+                    };
+                    businessEvent?: {
+                        eventKey: string;
+                        eventId: string;
+                        data: unknown;
+                        subscriptionSecret?: string | null;
+                    };
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            dispatchNotify: {
+                /** 按目标类型向多个端点投递告警 Webhook 通知 */
+                post: (body: {
+                    targets: ({
+                        type: "generic" | "feishu" | "dingtalk" | "wecom" | "slack" | "email";
+                        url: string;
+                        secret?: string | null;
+                    })[];
+                    event: {
+                        kind: "triggered" | "test" | "preview";
+                        ruleId?: string;
+                        ruleName: string;
+                        metric: string;
+                        metricLabel: string;
+                        operator: string;
+                        operatorLabel: string;
+                        threshold: number;
+                        thresholdText: string;
+                        currentValue?: number;
+                        currentValueText?: string;
+                        path?: string;
+                        appId?: string;
+                        windowMinutes?: number;
+                        requestCount?: number;
+                        minRequests?: number;
+                        triggeredAt: string;
+                        evaluationReason?: string;
+                        conditionText?: string;
+                        wouldTrigger?: boolean;
+                    };
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        messageNotifications: {
+            publish: {
+                /** 写入消息中心并可选发送邮件 */
+                post: (body: {
+                    appId: string;
+                    targetType: "all" | "role" | "user";
+                    targetIds: string[];
+                    title: string;
+                    description: string;
+                    type: string;
+                    priority: "urgent" | "high" | "normal" | "low";
+                    content: unknown;
+                    sendEmail?: boolean;
+                    appName?: string;
+                    emailLink?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
     };
     users: {
         dependencies: {
             /** 管理员检查指定用户的业务资源依赖 */
             post: (body: {
                 userId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         myDependencies: {
             /** 用户检查自己的业务资源依赖 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     messageCenter: {
@@ -1344,26 +2114,28 @@ export interface ApiClient {
                     status?: "draft" | "published";
                     targetType?: "all" | "role" | "user";
                     targetIds?: string[];
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                    sendEmail?: boolean;
+                    emailLink?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             delete: {
                 /** 删除消息通知 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             batch: {
                 delete: {
                     /** 批量删除消息通知 */
                     post: (body: {
                         ids: string[];
-                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                    }, config?: RequestConfig) => RequestBuilder<any>;
                 };
                 read: {
                     /** 批量将消息标记为已读 */
                     post: (body: {
                         ids: string[];
-                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                    }, config?: RequestConfig) => RequestBuilder<any>;
                 };
             };
             update: {
@@ -1378,19 +2150,19 @@ export interface ApiClient {
                     status?: "draft" | "published";
                     targetType?: "all" | "role" | "user";
                     targetIds?: string[];
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             read: {
                 /** 将指定消息标记为已读 */
                 post: (body: {
                     messageId: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             readAll: {
                 /** 将所有消息标记为已读 */
-                post: (body: {
+                post: (body?: {
                     type?: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             find: {
                 /** 分页查询消息通知列表（管理员） */
@@ -1403,8 +2175,9 @@ export interface ApiClient {
                         type?: string;
                         priority?: "urgent" | "high" | "normal" | "low";
                         status?: "draft" | "published";
+                        targetType?: "all" | "role" | "user";
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             own: {
                 /** 查询用户可见的消息列表 */
@@ -1417,17 +2190,66 @@ export interface ApiClient {
                         priority?: "urgent" | "high" | "normal" | "low";
                         read?: boolean;
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             findOne: {
                 /** 根据 ID 查询消息详情 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             statistics: {
                 /** 获取消息统计数据 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        messageNotificationTypes: {
+            list: {
+                /** 分页查询当前应用可见的消息通知类型 */
+                post: (body?: {
+                    type?: string;
+                    label?: string;
+                    accessScope?: "private" | "all_apps";
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            selectable: {
+                /** 消息中心创建通知时可绑定的类型列表 */
+                post: (body?: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            findOne: {
+                post: (body: {
+                    id: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            create: {
+                post: (body: {
+                    type: string;
+                    label: string;
+                    description: string;
+                    contentShape?: "text" | "descriptions";
+                    contentSchema: unknown;
+                    sampleContent: unknown;
+                    accessScope?: "private" | "all_apps";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            update: {
+                post: (body: {
+                    id: string;
+                    type: string;
+                    label: string;
+                    description: string;
+                    contentShape?: "text" | "descriptions";
+                    contentSchema?: unknown;
+                    sampleContent: unknown;
+                    accessScope?: "private" | "all_apps";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            delete: {
+                post: (body: {
+                    id: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         changelogNotifications: {
@@ -1440,20 +2262,20 @@ export interface ApiClient {
                     content: unknown;
                     changeType?: "feature" | "improvement" | "fix" | "security" | "breaking";
                     publishedAt?: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             delete: {
                 /** 删除更新日志 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             batch: {
                 delete: {
                     /** 批量删除更新日志 */
                     post: (body: {
                         ids: string[];
-                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                    }, config?: RequestConfig) => RequestBuilder<any>;
                 };
             };
             update: {
@@ -1466,17 +2288,17 @@ export interface ApiClient {
                     content: unknown;
                     changeType?: "feature" | "improvement" | "fix" | "security" | "breaking";
                     publishedAt?: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             read: {
                 /** 将指定更新日志标记为已读 */
                 post: (body: {
                     changelogId: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             readAll: {
                 /** 将所有可见更新日志标记为已读 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
             find: {
                 /** 分页查询更新日志列表 */
@@ -1488,7 +2310,7 @@ export interface ApiClient {
                         version?: string;
                         changeType?: "feature" | "improvement" | "fix" | "security" | "breaking";
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             own: {
                 /** 查询用户可见的更新日志列表（支持已读过滤） */
@@ -1500,13 +2322,13 @@ export interface ApiClient {
                         changeType?: "feature" | "improvement" | "fix" | "security" | "breaking";
                         read?: boolean;
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             findOne: {
                 /** 根据 ID 查询更新日志详情 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         eventNotifications: {
@@ -1520,20 +2342,20 @@ export interface ApiClient {
                     startAt?: string;
                     endAt?: string;
                     pinned?: boolean;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             delete: {
                 /** 删除活动通知 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             batch: {
                 delete: {
                     /** 批量删除活动通知 */
                     post: (body: {
                         ids: string[];
-                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                    }, config?: RequestConfig) => RequestBuilder<any>;
                 };
             };
             update: {
@@ -1547,17 +2369,17 @@ export interface ApiClient {
                     startAt?: string;
                     endAt?: string;
                     pinned?: boolean;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             read: {
                 /** 将指定活动通知标记为已读 */
                 post: (body: {
                     eventId: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             readAll: {
                 /** 将所有可见活动通知标记为已读 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
             find: {
                 /** 分页查询活动通知列表 */
@@ -1568,7 +2390,7 @@ export interface ApiClient {
                         title?: string;
                         status?: "draft" | "published";
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             own: {
                 /** 查询用户可见的活动通知列表（支持已读过滤） */
@@ -1579,13 +2401,13 @@ export interface ApiClient {
                         title?: string;
                         read?: boolean;
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             findOne: {
                 /** 根据 ID 查询活动通知详情 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         noticeNotifications: {
@@ -1600,20 +2422,20 @@ export interface ApiClient {
                     pinned?: boolean;
                     requireConfirm?: boolean;
                     expireAt?: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             delete: {
                 /** 删除公告通知 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             batch: {
                 delete: {
                     /** 批量删除公告通知 */
                     post: (body: {
                         ids: string[];
-                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                    }, config?: RequestConfig) => RequestBuilder<any>;
                 };
             };
             update: {
@@ -1628,17 +2450,17 @@ export interface ApiClient {
                     pinned?: boolean;
                     requireConfirm?: boolean;
                     expireAt?: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             read: {
                 /** 将指定公告标记为已读 */
                 post: (body: {
                     noticeId: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             readAll: {
                 /** 将所有公告标记为已读 */
-                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (config?: RequestConfig) => RequestBuilder<any>;
             };
             find: {
                 /** 分页查询公告通知列表（管理端） */
@@ -1650,7 +2472,7 @@ export interface ApiClient {
                         priority?: "urgent" | "important" | "normal";
                         status?: "draft" | "published";
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             own: {
                 /** 查询用户可见的公告列表（支持已读过滤） */
@@ -1662,28 +2484,113 @@ export interface ApiClient {
                         priority?: "urgent" | "important" | "normal";
                         read?: boolean;
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             findOne: {
                 /** 根据 ID 查询公告通知详情 */
                 post: (body: {
                     id: string;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
+    notificationGroups: {
+        list: {
+            post: (body?: {
+                id?: string;
+                name?: string;
+                description?: string;
+                notifyChannel?: "email" | "webhook" | "message";
+                enabled?: boolean;
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        create: {
+            post: (body: {
+                name: string;
+                description?: string;
+                enabled?: boolean;
+                notifyChannels: ("email" | "webhook" | "message")[];
+                notifyEmails?: string[];
+                webhookTargets?: ({
+                    type: "generic" | "feishu" | "dingtalk" | "wecom" | "slack";
+                    url: string;
+                    secret?: string | null;
+                })[];
+                notifyMessage?: {
+                    targetType: "all" | "role" | "user";
+                    targetIds: string[];
+                    type: string;
+                    priority: "urgent" | "high" | "normal" | "low";
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        update: {
+            post: (body: {
+                id: string;
+                name?: string;
+                description?: string;
+                enabled?: boolean;
+                notifyChannels?: ("email" | "webhook" | "message")[];
+                notifyEmails?: string[];
+                webhookTargets?: ({
+                    type: "generic" | "feishu" | "dingtalk" | "wecom" | "slack";
+                    url: string;
+                    secret?: string | null;
+                })[];
+                notifyMessage?: {
+                    targetType: "all" | "role" | "user";
+                    targetIds: string[];
+                    type: string;
+                    priority: "urgent" | "high" | "normal" | "low";
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            post: (body?: {
+                enabledOnly?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        sendTest: {
+            post: (body: {
+                id: string;
+                subject?: string;
+                text?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        validate: {
+            /** 验证邮件或 Webhook 端点是否可达 */
+            post: (body?: {
+                endpointUrl?: string;
+                deliveryType?: "generic" | "feishu" | "dingtalk" | "wecom" | "slack" | "email";
+                signSecret?: string;
+                notifyEmails?: string[];
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
     webhooks: {
         events: {
             /** 获取所有可用的 Webhook 事件类型 */
-            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            get: (config?: RequestConfig) => RequestBuilder<any>;
             ':id': {
                 /** 获取指定分类的 Webhook 事件 */
-                get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                get: (config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         categories: {
             /** 获取所有 Webhook 事件分类 */
-            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            get: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     buckets: {
@@ -1700,13 +2607,14 @@ export interface ApiClient {
                 useQuota?: boolean;
                 maxTotalSize?: number;
                 maxFileCount?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                accessScope?: "private" | "all_apps";
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除存储桶 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新存储桶配置 */
@@ -1722,7 +2630,8 @@ export interface ApiClient {
                 useQuota?: boolean;
                 maxTotalSize?: number;
                 maxFileCount?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                accessScope?: "private" | "all_apps";
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询存储桶列表 */
@@ -1731,18 +2640,25 @@ export interface ApiClient {
                 pageSize: number;
                 where: {
                     name?: string;
+                    bucketId?: string;
+                    accessScope?: "private" | "all_apps";
+                    accessMode?: "owned" | "granted";
+                    useFileExtensions?: boolean;
+                    useLimitContentLength?: boolean;
+                    useLimitContentTypes?: boolean;
+                    fileExtension?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询存储桶详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         options: {
             /** 获取存储桶下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     files: {
@@ -1756,26 +2672,26 @@ export interface ApiClient {
                 type: string;
                 webkitRelativePath: string;
                 subjectUserId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除文件 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         deleteMany: {
             /** 批量删除多个文件 */
             post: (body: {
                 ids: string[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新文件信息 */
             post: (body: {
                 id: string;
                 status: "progress" | "success" | "fail";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询文件列表，支持关键词搜索 */
@@ -1783,6 +2699,7 @@ export interface ApiClient {
                 current: number;
                 pageSize: number;
                 where: {
+                    id?: string;
                     bucketId?: string;
                     name?: string;
                     filename?: string;
@@ -1791,26 +2708,33 @@ export interface ApiClient {
                     keyword?: string;
                     fileCategory?: string;
                     creatorKeyword?: string;
+                    bucketAccessScope?: "private" | "all_apps";
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findMany: {
+            /** 根据 ID 列表批量查询文件详情 */
+            post: (body: {
+                ids: string[];
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询文件详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getUrl: {
             /** 获取单个文件的访问 URL */
             post: (body: {
                 filename: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getUrls: {
             /** 批量获取多个文件的访问 URL */
             post: (body: {
                 filenames: string[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getKeyAndCredentials: {
             /** 获取文件上传的密钥和凭证 */
@@ -1820,98 +2744,7 @@ export interface ApiClient {
                 size: number;
                 type: string;
                 subjectUserId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-    };
-    events: {
-        create: {
-            /** 创建新事件 */
-            post: (body: {
-                name: string;
-                eventKey: string;
-                type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        delete: {
-            /** 删除事件 */
-            post: (body: {
-                id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        update: {
-            /** 更新事件信息 */
-            post: (body: {
-                id: string;
-                name: string;
-                eventKey: string;
-                type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        find: {
-            /** 分页查询事件列表 */
-            post: (body: {
-                current: number;
-                pageSize: number;
-                where: {
-                    name?: string;
-                    type?: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                    eventKey?: string;
-                    description?: string;
-                };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        findOne: {
-            /** 根据 ID 查询事件详情 */
-            post: (body: {
-                id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-    };
-    eventLogs: {
-        create: {
-            /** 创建新事件日志 */
-            post: (body: {
-                payload: unknown;
-                name: string;
-                eventKey: string;
-                type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        delete: {
-            /** 删除事件日志 */
-            post: (body: {
-                id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        update: {
-            /** 更新事件日志 */
-            post: (body: {
-                id: string;
-                payload: unknown;
-                name: string;
-                eventKey: string;
-                type: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        find: {
-            /** 分页查询事件日志列表 */
-            post: (body: {
-                current: number;
-                pageSize: number;
-                where: {
-                    name?: string;
-                    type?: "authentication" | "connection" | "directory" | "directoryGroup" | "directoryUser" | "emailVerification" | "invitation" | "magicAuth" | "organization" | "organizationDomain" | "organizationMembership" | "passwordReset" | "role" | "permissionManagement" | "session" | "user";
-                    eventKey?: string;
-                };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        findOne: {
-            /** 根据 ID 查询事件日志详情 */
-            post: (body: {
-                id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     feedbackCenter: {
@@ -1919,23 +2752,23 @@ export interface ApiClient {
             /** 用户提交反馈 */
             post: (body: {
                 title: string;
-                type: "bugReports" | "featureSuggestions" | "technicalSupportRequests" | "generalOpinions";
+                type: "bugReports" | "featureSuggestions" | "technicalSupportRequests" | "generalOpinions" | "illegalContentReports";
                 description: string;
                 priority?: "urgent" | "high" | "normal" | "low";
-                attachments?: {
+                attachments?: ({
                     key: string;
                     name: string;
                     size: number;
                     mimeType: string;
                     kind: "image" | "video" | "file";
-                }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                })[];
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除反馈 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新反馈内容 */
@@ -1944,13 +2777,13 @@ export interface ApiClient {
                 status?: "newFeedback" | "inProgress" | "pending" | "resolved" | "closed";
                 priority?: "urgent" | "high" | "normal" | "low";
                 assigneeId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
             status: {
                 /** 更新反馈处理状态 */
                 post: (body: {
                     id: string;
                     status: "newFeedback" | "inProgress" | "pending" | "resolved" | "closed";
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             messages: {
                 /** 在反馈会话中发送消息 */
@@ -1959,16 +2792,16 @@ export interface ApiClient {
                     message: {
                         type: "text";
                         content?: string;
-                        attachments?: {
+                        attachments?: ({
                             key: string;
                             name: string;
                             size: number;
                             mimeType: string;
                             kind: "image" | "video" | "file";
-                        }[];
+                        })[];
                         senderRole: "user" | "support" | "system";
                     };
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         batch: {
@@ -1976,13 +2809,13 @@ export interface ApiClient {
                 /** 批量删除反馈 */
                 post: (body: {
                     ids: string[];
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             close: {
                 /** 批量关闭反馈 */
                 post: (body: {
                     ids: string[];
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         find: {
@@ -1998,36 +2831,37 @@ export interface ApiClient {
                     assigneeKeyword?: string;
                     creatorKeyword?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询反馈详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         own: {
             /** 查询当前用户提交的反馈 */
             post: (body: {
                 current: number;
                 pageSize: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         unreadReplyCount: {
-            /** 统计末条客服消息尚未阅读的未关闭反馈数 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<{
-                count: number;
-            }>>;
+            /** 统计当前用户反馈中末条客服消息尚未阅读的会话数量 */
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         markRead: {
             /** 将反馈会话中当前消息标记为已读 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<Record<string, never>>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getTrafficStatistics: {
             /** 获取反馈流量统计数据 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (body: {
+                startTime: string;
+                endTime: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         getCountChart: {
             /** 获取反馈数量趋势图表 */
@@ -2035,7 +2869,7 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     messages: {
@@ -2046,28 +2880,28 @@ export interface ApiClient {
                 message: {
                     type: "text";
                     content?: string;
-                    attachments?: {
+                    attachments?: ({
                         key: string;
                         name: string;
                         size: number;
                         mimeType: string;
                         kind: "image" | "video" | "file";
-                    }[];
+                    })[];
                     senderRole: "user" | "support" | "system";
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         list: {
             /** 分页查询对话消息列表 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
             incremental: {
                 /** 增量查询新的对话消息 */
                 post: (body: {
                     id: string;
                     lastSeq?: number;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
@@ -2076,21 +2910,39 @@ export interface ApiClient {
             /** 创建新文档 */
             post: (body: {
                 repositorieId: string;
-                content: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                content: {
+                    type: string;
+                    attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                    content?: unknown[];
+                    marks?: ({
+                        type: string;
+                        attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                    })[];
+                    text?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除文档 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新文档内容 */
             post: (body: {
                 id: string;
-                content: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                content: {
+                    type: string;
+                    attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                    content?: unknown[];
+                    marks?: ({
+                        type: string;
+                        attrs?: Record<string, string | number | boolean | null | unknown[] | Record<string, unknown>>;
+                    })[];
+                    text?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询文档列表 */
@@ -2100,13 +2952,19 @@ export interface ApiClient {
                 where: {
                     content?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
-            /** 根据 ID 查询文档详情 */
+            /** 根据 ID 查询当前应用的文档管理详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findPublicOne: {
+            /** 仅查询已公开知识库中的文档详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pages: {
@@ -2114,30 +2972,30 @@ export interface ApiClient {
             /** 创建新页面 */
             post: (body: {
                 path: string;
-                components: {
+                components: ({
                     type: "pageFaq" | "pageHero" | "pageFeature";
                     config: unknown;
-                }[];
+                })[];
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除页面 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新页面内容 */
             post: (body: {
                 id: string;
                 path: string;
-                components: {
+                components: ({
                     type: "pageFaq" | "pageHero" | "pageFeature";
                     config: unknown;
-                }[];
+                })[];
                 description: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询页面列表 */
@@ -2147,7 +3005,7 @@ export interface ApiClient {
                 where: {
                     path?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     repositories: {
@@ -2157,13 +3015,13 @@ export interface ApiClient {
                 title: string;
                 description: string;
                 isPublic: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除知识库 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新知识库信息 */
@@ -2172,13 +3030,34 @@ export interface ApiClient {
                 title: string;
                 description: string;
                 isPublic: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
             catalogues: {
                 /** 更新知识库目录结构 */
                 post: (body: {
                     id: string;
-                    catalogues: unknown[];
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                    catalogues: {
+                        name: string;
+                        key: string;
+                        children?: unknown[];
+                    }[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        documents: {
+            create: {
+                /** 创建文档并原子化写入知识库目录 */
+                post: (body: {
+                    repositoryId: string;
+                    parentId?: string;
+                    name: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            delete: {
+                /** 删除目录节点、子节点及对应文档 */
+                post: (body: {
+                    repositoryId: string;
+                    documentId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         find: {
@@ -2191,13 +3070,19 @@ export interface ApiClient {
                     description?: string;
                     isPublic?: boolean;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
-            /** 根据 ID 查询知识库详情 */
+            /** 根据 ID 查询当前应用的知识库管理详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findPublicOne: {
+            /** 根据 ID 查询当前应用已公开的知识库详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     repositoriesPermissions: {
@@ -2207,13 +3092,13 @@ export interface ApiClient {
                 repositorieId: string;
                 userId: string;
                 role: "admin" | "edit" | "view" | "not";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除知识库访问权限 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新知识库访问权限 */
@@ -2221,7 +3106,7 @@ export interface ApiClient {
                 id: string;
                 userId: string;
                 role: "admin" | "edit" | "view" | "not";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询知识库权限列表 */
@@ -2232,13 +3117,13 @@ export interface ApiClient {
                     repositorieId?: string;
                     role?: "admin" | "edit" | "view" | "not";
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询知识库权限详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     blog: {
@@ -2249,13 +3134,13 @@ export interface ApiClient {
                 description: string;
                 content: unknown;
                 coverImage: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除博客文章 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新博客文章内容 */
@@ -2265,7 +3150,7 @@ export interface ApiClient {
                 description: string;
                 content: unknown;
                 coverImage: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询博客文章列表 */
@@ -2275,13 +3160,276 @@ export interface ApiClient {
                 where?: {
                     title?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询博客文章详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    releases: {
+        getUploadToken: {
+            /** STS 临时凭证（30 分钟）。对 electron/production/{appId}/{platform}/{arch}/versions/{version}/ 或 latest/ 目录授权。 */
+            post: (body: {
+                version: string;
+                platformId: string;
+                target?: "version" | "latest";
+                filename: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        uploadComplete: {
+            /** 各平台打包上传完成后调用。服务端自动创建/更新版本记录。 */
+            post: (body: {
+                version: string;
+                platformId: string;
+                downloadUrl: string;
+                artifactUrl?: string;
+                zipUrl?: string;
+                artifactKey?: string;
+                latestKey?: string;
+                zipKey?: string;
+                fileSize?: number;
+                releaseNotes?: string;
+                channel?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        latest: {
+            /** 公开接口。通过 app-id header 传入。 */
+            post: (config?: RequestConfig) => RequestBuilder<any>;
+        };
+        list: {
+            /** 管理端查询 Electron 发布版本列表。 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where?: {
+                    version?: string;
+                    status?: "draft" | "published" | "disabled" | "archived";
+                    platformId?: string;
+                    channel?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        detail: {
+            /** 管理端查询单个 Electron 发布版本详情。 */
+            post: (body: {
+                version: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        updateStatus: {
+            /** 管理端更新发布版本状态。 */
+            post: (body: {
+                version: string;
+                status: "draft" | "published" | "disabled" | "archived";
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        setLatest: {
+            /** 管理端指定某版本为 latest，并重建 Electron 更新 feed。 */
+            post: (body: {
+                version: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        refreshFeed: {
+            /** 管理端按当前 latest 版本重建 Electron RELEASES.json。 */
+            post: (body?: {
+                version?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    market: {
+        getUploadToken: {
+            /** STS 临时凭证（30 分钟），对 superx-market/extensions/{extensionId}/{version}/ 目录授权。 */
+            post: (body: {
+                extensionId: string;
+                version: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        publish: {
+            /** CLI 上传完成后调用。创建或更新扩展版本记录。 */
+            post: (body: {
+                extensionId: string;
+                version: string;
+                sha256: string;
+                name: string;
+                description: string;
+                overview?: string;
+                icon: string;
+                iconBg?: string;
+                iconColor?: string;
+                category: string;
+                features: {
+                    tools?: boolean;
+                    skills?: boolean;
+                    mcps?: boolean;
+                    parts?: boolean;
+                    bin?: boolean;
+                    app?: {
+                        activation: {
+                            direct?: Record<string, unknown>;
+                            directory?: Record<string, unknown>;
+                            file?: {
+                                extensions?: string[];
+                                mediaKinds?: ("image" | "video" | "audio")[];
+                            };
+                        };
+                    };
+                };
+                defaults?: {
+                    extensionEnabled?: boolean;
+                    toolsChatEnabled?: boolean;
+                };
+                resources?: {
+                    description?: string;
+                    items: ({
+                        name: string;
+                        storageKind: "sqlite" | "vector" | "fulltext" | "filesystem";
+                        scope?: "extension" | "workspace" | "custom";
+                        description: string;
+                        queryHint: string;
+                        path?: string;
+                        capabilities?: {
+                            readable?: boolean;
+                            writable?: boolean;
+                            queryable?: boolean;
+                            searchable?: boolean;
+                            recoverable?: boolean;
+                        };
+                    })[];
+                };
+                runtime?: {
+                    binaries?: ({
+                        name: string;
+                        path: string;
+                        platform?: "darwin" | "win32" | "linux";
+                        arch?: "arm64" | "x64";
+                        required?: boolean;
+                    })[];
+                };
+                assets: {
+                    tools?: {
+                        description: string;
+                        items: {
+                            name: string;
+                            displayName?: string;
+                            description: string;
+                            category: string;
+                            parameters?: Record<string, unknown>;
+                            governance?: {
+                                sideEffectLevel?: string;
+                                approvalPolicy?: string;
+                            };
+                        }[];
+                    };
+                    parts?: {
+                        description: string;
+                        items: {
+                            name: string;
+                            description: string;
+                        }[];
+                    };
+                    app?: {
+                        description: string;
+                        activation: {
+                            direct?: Record<string, unknown>;
+                            directory?: Record<string, unknown>;
+                            file?: {
+                                extensions?: string[];
+                                mediaKinds?: ("image" | "video" | "audio")[];
+                            };
+                        };
+                    };
+                    skills?: {
+                        description: string;
+                        items: {
+                            name: string;
+                            description?: string;
+                        }[];
+                    };
+                    mcps?: {
+                        description: string;
+                        items: ({
+                            name: string;
+                            description?: string;
+                            transport?: "stdio" | "streamableHttp" | "sse";
+                        })[];
+                    };
+                    resources?: {
+                        description?: string;
+                        items: ({
+                            name: string;
+                            storageKind: "sqlite" | "vector" | "fulltext" | "filesystem";
+                            scope?: "extension" | "workspace" | "custom";
+                            description: string;
+                            queryHint: string;
+                            path?: string;
+                            capabilities?: {
+                                readable?: boolean;
+                                writable?: boolean;
+                                queryable?: boolean;
+                                searchable?: boolean;
+                                recoverable?: boolean;
+                            };
+                        })[];
+                    };
+                };
+                tags: string[];
+                lifecycle: {
+                    installable: boolean;
+                    uninstallable: boolean;
+                    enableSwitch: boolean;
+                    updatable: boolean;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            /** CLI 删除已发布扩展。支持删除单个版本或全部版本，并同步清理 COS 归档。 */
+            post: (body: {
+                extensionId: string;
+                version?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        catalog: {
+            /** 公开接口。Ones 标准分页（current/pageSize/where → items/count）。每个 extensionId 仅返回最新 published 版本；不含 overview/assets（详情走 /market/detail）。 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where?: {
+                    keyword?: string;
+                    category?: string;
+                    feature?: string;
+                    extensionId?: string;
+                    extensionIds?: string[];
+                    installStatus?: "installed" | "not-installed";
+                    installedIds?: string[];
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        detail: {
+            /** 公开接口。仅获取已发布扩展的详情和 CDN 下载基础 URL。 */
+            post: (body: {
+                extensionId: string;
+                version?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        admin: {
+            'set-status': {
+                /** 管理接口。修改扩展的上架状态（published/unlisted/suspended）。需登录态。 */
+                post: (body: {
+                    extensionId: string;
+                    status: "published" | "unlisted" | "suspended";
+                    reason?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'set-trust': {
+                /** 管理接口。修改扩展的信任等级（official/verified/community）。需登录态。 */
+                post: (body: {
+                    extensionId: string;
+                    trust: "official" | "verified" | "community";
+                    reason?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
         };
     };
 }