@huyooo/ui 0.13.6 → 0.13.9

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

@@ -1,4 +1,4 @@
-import { ApiResponse, RequestConfig, Client, EdenClient } from '@vafast/api-client';
+import { RequestConfig, Client, EdenClient, RequestBuilder } from '@vafast/api-client';
 /** API 契约类型 */
 export type Api = {
     health: {
@@ -87,6 +87,15 @@ export type Api = {
                 return: any;
             };
         };
+        manageOptions: {
+            /** 管理端表单与筛选用产品选项 */
+            post: {
+                body: {
+                    status?: "" | "active" | "archived";
+                };
+                return: any;
+            };
+        };
         updateSort: {
             /** 批量更新产品排序 */
             post: {
@@ -99,7 +108,7 @@ export type Api = {
                 return: any;
             };
         };
-        listActive: {
+        options: {
             /** 获取定价页面可用产品列表（公开） */
             post: {
                 return: any;
@@ -172,21 +181,16 @@ export type Api = {
                 return: any;
             };
         };
-        listByProduct: {
-            /** 获取指定产品的所有可用价格方案 */
+        options: {
+            /** 按产品或免费体验筛选可用价格方案 */
             post: {
                 body: {
-                    productId: string;
+                    productId?: string;
+                    freeOnly?: boolean;
                 };
                 return: any;
             };
         };
-        listFreeActive: {
-            /** 获取当前应用可领取的免费体验价格方案 */
-            post: {
-                return: any;
-            };
-        };
     };
     subscriptions: {
         create: {
@@ -278,6 +282,15 @@ export type Api = {
                 return: any;
             };
         };
+        statistics: {
+            /** 获取订阅概览页统计数据（状态计数、MRR、产品分布、最近订阅） */
+            post: {
+                body: {
+                    recentLimit?: number;
+                };
+                return: any;
+            };
+        };
         history: {
             /** 查询单个订阅的权益变化历史（管理端） */
             post: {
@@ -287,6 +300,24 @@ export type Api = {
                 return: any;
             };
         };
+        historyFind: {
+            /** 分页查询订阅权益变化历史（管理端） */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        userId?: string;
+                        subscriptionId?: string;
+                        productId?: string;
+                        action?: string;
+                        startTime?: string;
+                        endTime?: string;
+                    };
+                };
+                return: any;
+            };
+        };
         trend: {
             /** 获取订阅各状态的历史趋势数据 */
             post: {
@@ -734,7 +765,8 @@ export type Api = {
             post: {
                 body: {
                     userId: string;
-                    amount: number;
+                    amount?: number;
+                    amountMicro?: number;
                     requestId?: string;
                     description?: string;
                     metadata?: Record<string, unknown>;
@@ -870,7 +902,7 @@ export type Api = {
                 return: any;
             };
         };
-        getTrendChart: {
+        trendChart: {
             /** 获取积分变动趋势图表数据 */
             post: {
                 body: {
@@ -882,7 +914,7 @@ export type Api = {
                 return: any;
             };
         };
-        getTypeDistributionChart: {
+        typeDistributionChart: {
             /** 获取积分类型分布图表数据 */
             post: {
                 body: {
@@ -893,7 +925,7 @@ export type Api = {
                 return: any;
             };
         };
-        getRankingChart: {
+        rankingChart: {
             /** 获取用户积分排行榜 */
             post: {
                 body: {
@@ -1283,13 +1315,13 @@ export type Api = {
                 return: any;
             };
         };
-        getConfig: {
+        findOne: {
             /** 获取当前预警配置 */
             post: {
                 return: any;
             };
         };
-        findAlerts: {
+        find: {
             /** 分页查询预警记录 */
             post: {
                 body: {
@@ -1317,7 +1349,7 @@ export type Api = {
     };
     consumption: {
         trend: {
-            /** 聚合服务消费的趋势数据 */
+            /** 聚合积分消耗趋势 */
             post: {
                 body: {
                     startDate?: string;
@@ -1328,7 +1360,7 @@ export type Api = {
             };
         };
         overview: {
-            /** 聚合服务消费的概览数据 */
+            /** 聚合积分消耗概览 */
             post: {
                 body: {
                     startDate?: string;
@@ -1338,6 +1370,99 @@ export type Api = {
             };
         };
     };
+    billingUsage: {
+        charges: {
+            find: {
+                /** 查询 billingUsageRecord 全站扣费明细 */
+                post: {
+                    body: {
+                        where?: {
+                            keyword?: string;
+                            userId?: string;
+                            serviceGroup?: "ai" | "platform" | "storage";
+                            businessLineKey?: string;
+                            billingProductLineKey?: string;
+                            serviceKey?: string;
+                            serviceKeys?: string[];
+                            meterKey?: string;
+                            priceListId?: string;
+                            pricingType?: "flat" | "tiered" | "meters";
+                            subjectKey?: string;
+                            id?: string;
+                            idempotencyKey?: string;
+                            resourceId?: string;
+                            status?: "pending" | "charged" | "failed" | "canceled";
+                            startDate?: string;
+                            endDate?: string;
+                        };
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+            findOne: {
+                /** 按 ID 查询单条扣费记录（含 AI 扩展字段，供详情抽屉） */
+                post: {
+                    body: {
+                        id: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        consumption: {
+            overview: {
+                /** 聚合已入账扣费结果 */
+                post: {
+                    body: {
+                        where?: {
+                            userId?: string;
+                            serviceGroup?: "ai" | "platform" | "storage";
+                            businessLineKey?: string;
+                            billingProductLineKey?: string;
+                            serviceKey?: string;
+                            serviceKeys?: string[];
+                            startDate?: string;
+                            endDate?: string;
+                        };
+                    };
+                    return: any;
+                };
+            };
+            trend: {
+                /** 按日聚合积分消耗趋势 */
+                post: {
+                    body: {
+                        where?: {
+                            userId?: string;
+                            serviceGroup?: "ai" | "platform" | "storage";
+                            businessLineKey?: string;
+                            billingProductLineKey?: string;
+                            serviceKey?: string;
+                            serviceKeys?: string[];
+                            startDate?: string;
+                            endDate?: string;
+                        };
+                        limit?: number;
+                    };
+                    return: any;
+                };
+            };
+        };
+        reference: {
+            trace: {
+                /** 按 resourceId 查询扣费明细与积分流水 */
+                post: {
+                    body: {
+                        resourceId: string;
+                        serviceKey?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
     pointsRecharge: {
         packages: {
             /** 获取可用的充值套餐列表 */
@@ -1391,7 +1516,7 @@ export type Api = {
                 return: any;
             };
         };
-        detail: {
+        findOne: {
             /** 管理端查询单个积分充值订单详情及操作时间线 */
             post: {
                 body: {
@@ -1446,7 +1571,7 @@ export type Api = {
         };
     };
     rechargePackage: {
-        list: {
+        find: {
             /** 获取充值套餐列表（管理端） */
             post: {
                 body: {
@@ -1562,7 +1687,7 @@ export type Api = {
                 return: any;
             };
         };
-        list: {
+        find: {
             /** 查询退款记录列表 */
             post: {
                 body: {
@@ -1577,7 +1702,7 @@ export type Api = {
                 return: any;
             };
         };
-        detail: {
+        findOne: {
             /** 查询单个退款单详情 */
             post: {
                 body: {
@@ -1613,12 +1738,14 @@ export type Api = {
         };
     };
     serviceDefinition: {
-        list: {
+        find: {
             /** 获取应用的所有服务定义 */
             post: {
                 body: {
                     page?: number;
                     pageSize?: number;
+                    keyword?: string;
+                    enabled?: boolean;
                 };
                 return: any;
             };
@@ -1630,8 +1757,6 @@ export type Api = {
                     serviceType: string;
                     name: string;
                     description?: string;
-                    billingUnit: string;
-                    billingMode?: "event" | "continuous";
                 };
                 return: any;
             };
@@ -1643,8 +1768,6 @@ export type Api = {
                     id: string;
                     name?: string;
                     description?: string;
-                    billingUnit?: string;
-                    billingMode?: "event" | "continuous";
                     enabled?: boolean;
                 };
                 return: any;
@@ -1660,43 +1783,16 @@ export type Api = {
             };
         };
     };
-    pricingRule: {
-        get: {
-            /** 获取服务的定价规则 */
-            post: {
-                body: {
-                    serviceType: string;
-                };
-                return: any;
-            };
-        };
-        save: {
-            /** 创建或更新定价规则 */
-            post: {
-                body: {
-                    serviceType: string;
-                    tiers?: {
-                        minUsage: number;
-                        maxUsage: number | null;
-                        pricePerUnit: number;
-                    }[];
-                    flatPrice?: number | null;
-                    freeQuota?: number;
-                    profitMargin?: number;
-                    enabled?: boolean;
-                };
-                return: any;
-            };
-        };
-    };
     usage: {
         report: {
             /** 上报服务用量，自动计费扣费 */
             post: {
                 body: {
                     serviceType: string;
+                    priceListId?: string;
                     metadata: Record<string, unknown>;
-                    requestId?: string;
+                    idempotencyKey?: string;
+                    resourceId?: string;
                 };
                 return: any;
             };
@@ -1706,6 +1802,7 @@ export type Api = {
             post: {
                 body: {
                     serviceType: string;
+                    priceListId?: string;
                     metadata: Record<string, unknown>;
                     freeQuotaOverride?: number;
                 };
@@ -1719,6 +1816,7 @@ export type Api = {
                     startDate?: string;
                     endDate?: string;
                     serviceType?: string;
+                    userId?: string;
                     groupBy?: "day" | "service" | "user";
                 };
                 return: any;
@@ -1730,7 +1828,11 @@ export type Api = {
                 body: {
                     page?: number;
                     pageSize?: number;
-                    serviceType?: string;
+                    id?: string;
+                    idempotencyKey?: string;
+                    resourceId?: string;
+                    serviceKey?: string;
+                    userId?: string;
                     startDate?: string;
                     endDate?: string;
                 };
@@ -1738,111 +1840,207 @@ export type Api = {
             };
         };
     };
-    export: {
-        recharge: {
-            /** 导出充值订单记录为 CSV 格式 */
+    priceList: {
+        find: {
             post: {
                 body: {
-                    startDate?: string;
-                    endDate?: string;
-                    status?: string;
+                    where?: {
+                        priceListId?: string;
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        meterKey?: string;
+                        pricingType?: "flat" | "tiered" | "meters";
+                        keyword?: string;
+                        enabled?: boolean;
+                    };
+                    page?: number;
+                    pageSize?: number;
                 };
                 return: any;
             };
         };
-        refund: {
-            /** 导出退款记录为 CSV 格式 */
+        findOne: {
             post: {
                 body: {
-                    startDate?: string;
-                    endDate?: string;
-                    status?: string;
+                    id: string;
                 };
                 return: any;
             };
         };
-        pointsHistory: {
-            /** 导出积分变动记录为 CSV 格式 */
+        options: {
+            /** 筛选项、绑价表单 Select 用价目表下拉 */
             post: {
                 body: {
-                    startDate?: string;
-                    endDate?: string;
-                    type?: string;
-                    userId?: string;
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    serviceKey?: string;
+                    pricingType?: "flat" | "tiered" | "meters";
+                    enabled?: boolean;
                 };
                 return: any;
             };
         };
-    };
-    financeReport: {
-        overview: {
-            /** 获取收入概览数据 */
+        previewSchema: {
+            /** 由所选计费项生成填价表单结构 */
             post: {
                 body: {
-                    startDate?: string;
-                    endDate?: string;
+                    businessLineKey: string;
+                    serviceKey: string;
+                    meterRefs: {
+                        businessLineKey: string;
+                        serviceKey: string;
+                        meterKey: string;
+                    }[];
                 };
                 return: any;
             };
         };
-        trend: {
-            /** 获取收入趋势数据（按日/周/月） */
+        create: {
             post: {
                 body: {
-                    period: "day" | "week" | "month";
-                    days?: number;
+                    businessLineKey: string;
+                    serviceKey: string;
+                    meterRefs?: {
+                        businessLineKey: string;
+                        serviceKey: string;
+                        meterKey: string;
+                    }[];
+                    name: string;
+                    currency?: "CNY" | "USD";
+                    enabled?: boolean;
+                    pricingValues: {
+                        type: "flat";
+                        originalPrice: number;
+                        sellPrice: number;
+                    } | {
+                        type: "tiered";
+                        priceStructure: "flat" | "segmented";
+                        tiers: {
+                            match?: Record<string, string>;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    } | {
+                        type: "meters";
+                        meters: {
+                            componentKey: string;
+                            businessLineKey: string;
+                            serviceKey: string;
+                            meterKey: string;
+                            tiers: {
+                                match?: Record<string, string>;
+                                tierRangeMode?: "at_most" | "at_least" | "between";
+                                minTokens?: number;
+                                maxTokens?: number;
+                                minInclusive?: boolean;
+                                maxInclusive?: boolean;
+                                originalFenPerUnit: number;
+                                sellFenPerUnit: number;
+                                billingEnabled: boolean;
+                            }[];
+                        }[];
+                    };
                 };
                 return: any;
             };
         };
-        packageRank: {
-            /** 获取套餐销售排行数据 */
+        update: {
             post: {
                 body: {
-                    startDate?: string;
-                    endDate?: string;
-                    limit?: number;
+                    id: string;
+                    name?: string;
+                    currency?: "CNY" | "USD";
+                    enabled?: boolean;
+                    meterRefs?: {
+                        businessLineKey: string;
+                        serviceKey: string;
+                        meterKey: string;
+                    }[];
+                    pricingValues?: {
+                        type: "flat";
+                        originalPrice: number;
+                        sellPrice: number;
+                    } | {
+                        type: "tiered";
+                        priceStructure: "flat" | "segmented";
+                        tiers: {
+                            match?: Record<string, string>;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    } | {
+                        type: "meters";
+                        meters: {
+                            componentKey: string;
+                            businessLineKey: string;
+                            serviceKey: string;
+                            meterKey: string;
+                            tiers: {
+                                match?: Record<string, string>;
+                                tierRangeMode?: "at_most" | "at_least" | "between";
+                                minTokens?: number;
+                                maxTokens?: number;
+                                minInclusive?: boolean;
+                                maxInclusive?: boolean;
+                                originalFenPerUnit: number;
+                                sellFenPerUnit: number;
+                                billingEnabled: boolean;
+                            }[];
+                        }[];
+                    };
                 };
                 return: any;
             };
         };
-        userRank: {
-            /** 获取用户充值排行数据 */
+        delete: {
             post: {
                 body: {
-                    startDate?: string;
-                    endDate?: string;
-                    limit?: number;
+                    id: string;
                 };
                 return: any;
             };
         };
     };
-    reconciliation: {
-        generate: {
-            /** 生成指定日期的对账报告 */
+    priceBinding: {
+        find: {
             post: {
                 body: {
-                    date: string;
+                    where?: {
+                        subjectType?: "model-profile";
+                        subjectKey?: string;
+                        serviceKey?: string;
+                        businessLineKey?: string;
+                        enabled?: boolean;
+                    };
                 };
                 return: any;
             };
         };
-        list: {
-            /** 查询对账报告列表 */
+        upsert: {
             post: {
                 body: {
-                    page?: number;
-                    pageSize?: number;
-                    status?: string;
-                    startDate?: string;
-                    endDate?: string;
+                    subjectType: "model-profile";
+                    subjectKey: string;
+                    priceListId: string;
+                    enabled?: boolean;
                 };
                 return: any;
             };
         };
-        detail: {
-            /** 查询对账报告详情 */
+        delete: {
             post: {
                 body: {
                     id: string;
@@ -1850,117 +2048,634 @@ export type Api = {
                 return: any;
             };
         };
-        processAnomaly: {
-            /** 处理对账异常订单 */
+    };
+    businessLine: {
+        find: {
             post: {
                 body: {
-                    reportId: string;
-                    orderId: string;
-                    action: "confirm_paid" | "mark_cancelled" | "ignore";
-                    remark?: string;
+                    where?: {
+                        keyword?: string;
+                        enabled?: boolean;
+                    };
+                    withStats?: boolean;
+                    page?: number;
+                    pageSize?: number;
                 };
                 return: any;
             };
         };
-        batchGenerate: {
-            /** 批量生成指定日期范围的对账报告 */
+        findOne: {
             post: {
                 body: {
-                    startDate: string;
-                    endDate: string;
+                    businessLineKey: string;
                 };
                 return: any;
             };
         };
-    };
-    invoice: {
-        apply: {
-            /** 申请开具发票 */
+        options: {
+            /** 筛选项、表单 Select 用业务线下拉 */
             post: {
                 body: {
-                    invoiceType: "personal" | "company" | "vat_special";
-                    title: string;
-                    taxNumber?: string;
-                    companyAddress?: string;
-                    companyPhone?: string;
-                    bankName?: string;
-                    bankAccount?: string;
-                    email: string;
-                    receiverName?: string;
-                    receiverPhone?: string;
-                    receiverAddress?: string;
-                    orderIds?: string[];
-                    remark?: string;
+                    enabled?: boolean;
                 };
                 return: any;
             };
         };
-        list: {
-            /** 查询发票申请列表 */
+        create: {
             post: {
                 body: {
-                    page?: number;
-                    pageSize?: number;
-                    status?: string;
-                    userId?: string;
-                    startDate?: string;
-                    endDate?: string;
+                    businessLineKey: string;
+                    label: string;
                 };
                 return: any;
             };
         };
-        detail: {
-            /** 查询发票详情 */
+        update: {
             post: {
                 body: {
-                    invoiceNo: string;
+                    businessLineKey: string;
+                    label?: string;
+                    enabled?: boolean;
                 };
                 return: any;
             };
         };
-        review: {
-            /** 审核发票申请（通过/拒绝） */
+        delete: {
             post: {
                 body: {
-                    invoiceNo: string;
-                    action: "approve" | "reject";
-                    remark?: string;
+                    businessLineKey: string;
                 };
                 return: any;
             };
         };
-        issue: {
-            /** 标记发票已开具 */
+    };
+    billingProductLine: {
+        find: {
             post: {
                 body: {
-                    invoiceNo: string;
-                    invoiceCode?: string;
-                    invoiceNumber?: string;
-                    invoiceUrl?: string;
+                    where?: {
+                        businessLineKey?: string;
+                        keyword?: string;
+                        enabled?: boolean;
+                    };
+                    withStats?: boolean;
+                    page?: number;
+                    pageSize?: number;
                 };
                 return: any;
             };
         };
-        stats: {
-            /** 获取发票统计数据 */
+        findOne: {
             post: {
                 body: {
-                    startDate?: string;
-                    endDate?: string;
+                    productLineId: string;
                 };
                 return: any;
             };
         };
-        cancel: {
-            /** 取消发票申请（仅待审核状态可取消） */
+        options: {
+            /** 筛选项、表单 Select 用产品线下拉 */
             post: {
                 body: {
-                    invoiceNo: string;
+                    businessLineKey?: string;
+                    enabled?: boolean;
                 };
                 return: any;
             };
         };
-    };
+        create: {
+            post: {
+                body: {
+                    businessLineKey: string;
+                    productLineKey: string;
+                    label: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            post: {
+                body: {
+                    productLineId: string;
+                    label?: string;
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            post: {
+                body: {
+                    productLineId: string;
+                };
+                return: any;
+            };
+        };
+    };
+    billingServiceCatalog: {
+        service: {
+            find: {
+                post: {
+                    body: {
+                        where?: {
+                            businessLineKey?: string;
+                            billingProductLineKey?: string;
+                            productLine?: string;
+                            source?: "builtin" | "custom";
+                            serviceKey?: string;
+                            keyword?: string;
+                            enabled?: boolean;
+                        };
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+            options: {
+                /** 筛选项、表单 Select 用服务下拉 */
+                post: {
+                    body: {
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        enabled?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            create: {
+                post: {
+                    body: {
+                        businessLineKey: string;
+                        billingProductLineKey: string;
+                        serviceType: string;
+                        name: string;
+                        description?: string;
+                        dependencies?: {
+                            businessLineKey: string;
+                            billingProductLineKey: string;
+                            serviceKey: string;
+                            meterKeys?: string[];
+                            required?: boolean;
+                        }[];
+                    };
+                    return: any;
+                };
+            };
+            update: {
+                post: {
+                    body: {
+                        businessLineKey: string;
+                        serviceKey: string;
+                        label?: string;
+                        description?: string;
+                        billingProductLineKey?: string;
+                        dependencies?: {
+                            businessLineKey: string;
+                            billingProductLineKey: string;
+                            serviceKey: string;
+                            meterKeys?: string[];
+                            required?: boolean;
+                        }[];
+                        enabled?: boolean;
+                    };
+                    return: any;
+                };
+            };
+            delete: {
+                post: {
+                    body: {
+                        businessLineKey: string;
+                        serviceKey: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        runtime: {
+            export: {
+                /** 前端运行时缓存：服务 + 价目表 operation */
+                post: {
+                    return: any;
+                };
+            };
+        };
+    };
+    billingMeter: {
+        find: {
+            post: {
+                body: {
+                    where?: {
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        chargeMode?: "instant" | "settlement";
+                        source?: "builtin" | "custom";
+                        keyword?: string;
+                        enabled?: boolean;
+                    };
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        options: {
+            post: {
+                body: {
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    serviceKey?: string;
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        create: {
+            post: {
+                body: {
+                    businessLineKey: string;
+                    serviceKey: string;
+                    meterKey: string;
+                    label: string;
+                    description?: string;
+                    chargeMode?: "instant" | "settlement";
+                    settlementPeriod?: "hour" | "day" | "month";
+                    pricingSchema?: {
+                        unitLabel: string;
+                        quantityScale?: number;
+                        priceStructure?: "flat" | "segmented" | "keyed";
+                        matchKeys?: {
+                            key: string;
+                            label: string;
+                            values: {
+                                value: string;
+                                label: string;
+                            }[];
+                        }[];
+                        tiers: {
+                            match?: Record<string, string>;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                        }[];
+                    };
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        update: {
+            post: {
+                body: {
+                    id: string;
+                    businessLineKey?: string;
+                    serviceKey?: string;
+                    meterKey?: string;
+                    label?: string;
+                    description?: string;
+                    chargeMode?: "instant" | "settlement";
+                    settlementPeriod?: "hour" | "day" | "month";
+                    pricingSchema?: {
+                        unitLabel: string;
+                        quantityScale?: number;
+                        priceStructure?: "flat" | "segmented" | "keyed";
+                        matchKeys?: {
+                            key: string;
+                            label: string;
+                            values: {
+                                value: string;
+                                label: string;
+                            }[];
+                        }[];
+                        tiers: {
+                            match?: Record<string, string>;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                        }[];
+                    };
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
+    billingMeterChargeItem: {
+        find: {
+            post: {
+                body: {
+                    where?: {
+                        keyword?: string;
+                        userId?: string;
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        meterKey?: string;
+                        priceListId?: string;
+                        pricingType?: "flat" | "tiered" | "meters";
+                        resourceId?: string;
+                        subjectKey?: string;
+                        idempotencyKey?: string;
+                        billingUsageRecordId?: string;
+                        chargeMode?: "instant" | "settlement";
+                        status?: "pending" | "accumulating" | "charged" | "failed" | "canceled";
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        overview: {
+            post: {
+                body: {
+                    where?: {
+                        keyword?: string;
+                        userId?: string;
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        meterKey?: string;
+                        priceListId?: string;
+                        pricingType?: "flat" | "tiered" | "meters";
+                        resourceId?: string;
+                        subjectKey?: string;
+                        idempotencyKey?: string;
+                        billingUsageRecordId?: string;
+                        chargeMode?: "instant" | "settlement";
+                        status?: "pending" | "accumulating" | "charged" | "failed" | "canceled";
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        trend: {
+            post: {
+                body: {
+                    where?: {
+                        keyword?: string;
+                        userId?: string;
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        meterKey?: string;
+                        priceListId?: string;
+                        pricingType?: "flat" | "tiered" | "meters";
+                        resourceId?: string;
+                        subjectKey?: string;
+                        idempotencyKey?: string;
+                        billingUsageRecordId?: string;
+                        chargeMode?: "instant" | "settlement";
+                        status?: "pending" | "accumulating" | "charged" | "failed" | "canceled";
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+    };
+    export: {
+        recharge: {
+            /** 导出充值订单记录为 CSV 格式 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    status?: string;
+                };
+                return: any;
+            };
+        };
+        refund: {
+            /** 导出退款记录为 CSV 格式 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    status?: string;
+                };
+                return: any;
+            };
+        };
+        pointsHistory: {
+            /** 导出积分变动记录为 CSV 格式 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    type?: string;
+                    userId?: string;
+                };
+                return: any;
+            };
+        };
+    };
+    financeReport: {
+        overview: {
+            /** 获取收入概览数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        trend: {
+            /** 获取收入趋势数据（按日/周/月） */
+            post: {
+                body: {
+                    period: "day" | "week" | "month";
+                    days?: number;
+                };
+                return: any;
+            };
+        };
+        packageRank: {
+            /** 获取套餐销售排行数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+        userRank: {
+            /** 获取用户充值排行数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+    };
+    reconciliation: {
+        generate: {
+            /** 生成指定日期的对账报告 */
+            post: {
+                body: {
+                    date: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 查询对账报告列表 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                    status?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 查询对账报告详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        processAnomaly: {
+            /** 处理对账异常订单 */
+            post: {
+                body: {
+                    reportId: string;
+                    orderId: string;
+                    action: "confirm_paid" | "mark_cancelled" | "ignore";
+                    remark?: string;
+                };
+                return: any;
+            };
+        };
+        batchGenerate: {
+            /** 批量生成指定日期范围的对账报告 */
+            post: {
+                body: {
+                    startDate: string;
+                    endDate: string;
+                };
+                return: any;
+            };
+        };
+    };
+    invoice: {
+        apply: {
+            /** 申请开具发票 */
+            post: {
+                body: {
+                    invoiceType: "personal" | "company" | "vat_special";
+                    title: string;
+                    taxNumber?: string;
+                    companyAddress?: string;
+                    companyPhone?: string;
+                    bankName?: string;
+                    bankAccount?: string;
+                    email: string;
+                    receiverName?: string;
+                    receiverPhone?: string;
+                    receiverAddress?: string;
+                    orderIds?: string[];
+                    remark?: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 查询发票申请列表 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                    status?: string;
+                    userId?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 查询发票详情 */
+            post: {
+                body: {
+                    invoiceNo: string;
+                };
+                return: any;
+            };
+        };
+        review: {
+            /** 审核发票申请（通过/拒绝） */
+            post: {
+                body: {
+                    invoiceNo: string;
+                    action: "approve" | "reject";
+                    remark?: string;
+                };
+                return: any;
+            };
+        };
+        issue: {
+            /** 标记发票已开具 */
+            post: {
+                body: {
+                    invoiceNo: string;
+                    invoiceCode?: string;
+                    invoiceNumber?: string;
+                    invoiceUrl?: string;
+                };
+                return: any;
+            };
+        };
+        stats: {
+            /** 获取发票统计数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        cancel: {
+            /** 取消发票申请（仅待审核状态可取消） */
+            post: {
+                body: {
+                    invoiceNo: string;
+                };
+                return: any;
+            };
+        };
+    };
     agreement: {
         create: {
             /** 创建支付宝签约代扣授权 */
@@ -2044,7 +2759,9 @@ export type Api = {
                     body: {
                         appId: string;
                         userId: string;
-                        serviceType: string;
+                        businessLineKey: string;
+                        serviceKey: string;
+                        priceListId: string;
                         amount: number;
                         freeQuotaOverride?: number;
                     };
@@ -2059,7 +2776,9 @@ export type Api = {
                         items: {
                             key: string;
                             userId: string;
-                            serviceType: string;
+                            businessLineKey: string;
+                            serviceKey: string;
+                            priceListId?: string;
                             amount: number;
                             freeQuotaOverride?: number;
                         }[];
@@ -2073,10 +2792,13 @@ export type Api = {
                     body: {
                         appId: string;
                         userId: string;
-                        serviceType: string;
+                        businessLineKey: string;
+                        serviceKey: string;
+                        priceListId?: string;
                         amount: number;
                         metadata?: Record<string, unknown>;
-                        requestId?: string;
+                        idempotencyKey?: string;
+                        resourceId?: string;
                         usageKind?: "event" | "continuous_settlement";
                         periodStart?: string;
                         periodEnd?: string;
@@ -2085,6 +2807,196 @@ export type Api = {
                     return: any;
                 };
             };
+            reversal: {
+                /** 供内部服务冲正已上报的服务用量并退还积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId: string;
+                        idempotencyKey: string;
+                        reason?: string;
+                        reversalIdempotencyKey?: string;
+                    };
+                    return: any;
+                };
+            };
+            'preview-meter-charge': {
+                /** 供 ai-server 等根据价目表与 meter 用量计算积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        businessLineKey: string;
+                        serviceKey: string;
+                        priceListId?: string;
+                        meterUsage: Record<string, number>;
+                        meterMatchContext?: Record<string, Record<string, string>>;
+                        meterTierMatchUsage?: Record<string, number>;
+                        exchangeRate?: number;
+                    };
+                    return: any;
+                };
+            };
+            'record-ai': {
+                /** 供 ai-server 传入 meter 用量，由计费引擎算价并扣积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId: string;
+                        businessLineKey: string;
+                        idempotencyKey: string;
+                        serviceKey: string;
+                        priceListId: string;
+                        resourceId?: string;
+                        subjectKey: string;
+                        sourceService?: string;
+                        sourceType?: string;
+                        sourceId?: string;
+                        labels?: Record<string, string>;
+                        quantity: number;
+                        unit: string;
+                        meterUsage: Record<string, number>;
+                        meterMatchContext?: Record<string, Record<string, string>>;
+                        meterTierMatchUsage?: Record<string, number>;
+                        exchangeRate?: number;
+                        snapshot?: {
+                            priceListId?: string;
+                            usage?: Record<string, number>;
+                            cost?: Record<string, unknown>;
+                        };
+                    };
+                    return: any;
+                };
+            };
+            find: {
+                /** 供 ai-server 等内部服务查询 billingUsageRecord */
+                post: {
+                    body: {
+                        appId: string;
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        serviceGroups?: "ai" | "platform" | "storage"[];
+                        resourceId?: string;
+                        serviceKey?: string;
+                        model?: string;
+                        subjectKeys?: string[];
+                        id?: string;
+                        requestId?: string;
+                        startTime?: string;
+                        endTime?: string;
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+            'stats-ai': {
+                /** 供 ai-server 查询 AI 用量聚合统计 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId?: string;
+                        subjectKeys?: string[];
+                        startTime?: string;
+                        endTime?: string;
+                        timezone?: string;
+                    };
+                    return: any;
+                };
+            };
+            'by-resource': {
+                /** 按 resourceId 联合查询用量与积分流水 */
+                post: {
+                    body: {
+                        appId: string;
+                        resourceId: string;
+                        serviceKey?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        pricing: {
+            'resolve-model': {
+                /** 供 ai-server 运行时读取模型定价 */
+                post: {
+                    body: {
+                        appId: string;
+                        supplierId: string;
+                        profileId: string;
+                        productLine?: string;
+                        billingPlan?: string;
+                    };
+                    return: any;
+                };
+            };
+            'sync-model': {
+                post: {
+                    body: {
+                        appId: string;
+                        operatorId: string;
+                        supplierId: string;
+                        profileId: string;
+                        profileName?: string;
+                        productLine: string;
+                        currency: "CNY" | "USD";
+                        plans: unknown[];
+                    };
+                    return: any;
+                };
+            };
+            'delete-model': {
+                post: {
+                    body: {
+                        appId: string;
+                        supplierId: string;
+                        profileId: string;
+                    };
+                    return: any;
+                };
+            };
+            'load-model-plans': {
+                post: {
+                    body: {
+                        appId: string;
+                        supplierId: string;
+                        profileId: string;
+                    };
+                    return: any;
+                };
+            };
+            'list-model-pricing-map': {
+                post: {
+                    body: {
+                        appId: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        billingCatalog: {
+            list: {
+                /** 服务 + 价目表 operation 列表（供 ai-server 等内部服务） */
+                post: {
+                    body: {
+                        appId: string;
+                        billingProductLineKey?: "ai" | "storage" | "platform";
+                        group?: "ai" | "storage" | "platform";
+                    };
+                    return: any;
+                };
+            };
+        };
+        points: {
+            'by-request-ids': {
+                /** 供 ai-server 溯源：通过 requestId 列表查询 pointsHistory */
+                post: {
+                    body: {
+                        appId: string;
+                        requestIds: string[];
+                    };
+                    return: any;
+                };
+            };
         };
     };
     webhooks: {
@@ -2114,11 +3026,11 @@ 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>;
     };
     products: {
         create: {
@@ -2136,13 +3048,13 @@ export interface ApiClient {
                 }[];
                 metadata?: Record<string, unknown>;
                 displayOrder?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除产品 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新产品信息 */
@@ -2161,7 +3073,7 @@ export interface ApiClient {
                 status?: "active" | "archived";
                 metadata?: Record<string, unknown>;
                 displayOrder?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询产品列表 */
@@ -2172,13 +3084,19 @@ export interface ApiClient {
                     name?: string;
                     status?: "" | "active" | "archived";
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 查询产品详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        manageOptions: {
+            /** 管理端表单与筛选用产品选项 */
+            post: (body: {
+                status?: "" | "active" | "archived";
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         updateSort: {
             /** 批量更新产品排序 */
@@ -2187,11 +3105,11 @@ export interface ApiClient {
                     id: string;
                     displayOrder: number;
                 }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        listActive: {
+        options: {
             /** 获取定价页面可用产品列表（公开） */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     prices: {
@@ -2208,13 +3126,13 @@ export interface ApiClient {
                 interval?: "day" | "week" | "month" | "year";
                 intervalCount?: number;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除价格方案 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新价格方案信息 */
@@ -2225,7 +3143,7 @@ export interface ApiClient {
                 metadata?: Record<string, unknown>;
                 trialPeriodDays?: number;
                 allowRepeatTrial?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询价格方案列表 */
@@ -2237,23 +3155,20 @@ export interface ApiClient {
                     type?: "" | "free" | "one_time" | "recurring";
                     active?: 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>;
         };
-        listByProduct: {
-            /** 获取指定产品的所有可用价格方案 */
+        options: {
+            /** 按产品或免费体验筛选可用价格方案 */
             post: (body: {
-                productId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        listFreeActive: {
-            /** 获取当前应用可领取的免费体验价格方案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                productId?: string;
+                freeOnly?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     subscriptions: {
@@ -2262,7 +3177,7 @@ export interface ApiClient {
             post: (body: {
                 priceId: string;
                 couponCode?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         cancel: {
             /** 取消订阅 */
@@ -2270,13 +3185,13 @@ export interface ApiClient {
                 subscriptionId: string;
                 cancelAtPeriodEnd?: boolean;
                 reason?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         resume: {
             /** 恢复已取消的订阅 */
             post: (body: {
                 subscriptionId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         change: {
             /** 升级或降级订阅 */
@@ -2284,7 +3199,7 @@ export interface ApiClient {
                 subscriptionId: string;
                 newPriceId: string;
                 proration?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 查询当前用户的订阅列表 */
@@ -2292,21 +3207,21 @@ export interface ApiClient {
                 current?: number;
                 pageSize?: number;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         current: {
             /** 获取当前活跃订阅 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         summary: {
             /** 获取当前用户订阅、配额、积分和待支付账单摘要 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         userDetail: {
             /** 管理员查询指定用户的订阅、免费体验、配额、积分和最近消费记录 */
             post: (body: {
                 userId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询订阅列表（管理端） */
@@ -2319,13 +3234,34 @@ export interface ApiClient {
                     status?: string;
                     cancelAtPeriodEnd?: boolean;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        statistics: {
+            /** 获取订阅概览页统计数据（状态计数、MRR、产品分布、最近订阅） */
+            post: (body: {
+                recentLimit?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         history: {
             /** 查询单个订阅的权益变化历史（管理端） */
             post: (body: {
                 subscriptionId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        historyFind: {
+            /** 分页查询订阅权益变化历史（管理端） */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    userId?: string;
+                    subscriptionId?: string;
+                    productId?: string;
+                    action?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         trend: {
             /** 获取订阅各状态的历史趋势数据 */
@@ -2333,26 +3269,26 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "day" | "week" | "month";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         count: {
             /** 供其他服务查询用户订阅数量 */
             post: (body: {
                 userId: string;
                 appId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         countBatch: {
             /** 供其他服务批量查询用户订阅数量 */
             post: (body: {
                 userIds: string[];
                 appId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         notify: {
             alipay: {
                 /** 支付宝订阅支付回调通知 */
-                post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
@@ -2367,13 +3303,13 @@ export interface ApiClient {
                 limit: number;
                 period: "day" | "week" | "month" | "year" | "lifetime";
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除配额定义 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新配额定义 */
@@ -2384,7 +3320,7 @@ export interface ApiClient {
                 limit?: number;
                 period?: "day" | "week" | "month" | "year" | "lifetime";
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询配额列表 */
@@ -2396,7 +3332,7 @@ export interface ApiClient {
                     priceId?: string;
                     featureKey?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         check: {
             /** 供其他服务检查配额是否足够，不写入使用量 */
@@ -2406,11 +3342,11 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 used?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 获取当前用户的配额使用情况 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         reserve: {
             /** 供其他服务检查并预占配额 */
@@ -2420,51 +3356,51 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         commit: {
             /** 供其他服务确认已预占配额 */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         release: {
             /** 供其他服务释放已预占配额 */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     trials: {
         current: {
             /** 获取当前用户免费体验状态 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         start: {
             /** 领取当前应用的免费体验权益 */
             post: (body: {
                 priceId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     newUserDefaults: {
         find: {
             /** 查询注册后默认授予的免费权益配置 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新注册后默认授予的免费权益配置 */
             post: (body: {
                 autoGrantFreePriceOnSignup: boolean;
                 defaultFreePriceId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         grantMissingFreeEntitlements: {
             /** 给当前应用下没有活跃订阅/体验的用户补发默认免费价格方案 */
             post: (body: {
                 dryRun?: boolean;
                 userIds?: string[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     usageRecords: {
@@ -2475,7 +3411,7 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 used?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         reserveQuota: {
             /** 检查配额并写入 reserved 使用量记录 */
@@ -2484,19 +3420,19 @@ export interface ApiClient {
                 featureKey: string;
                 quantity?: number;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         commitQuota: {
             /** 将 reserved 使用量记录确认成 committed */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         releaseQuota: {
             /** 将 reserved 使用量记录释放成 released */
             post: (body: {
                 usageRecordId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询使用记录（管理端） */
@@ -2510,7 +3446,7 @@ export interface ApiClient {
                     startTime?: string;
                     endTime?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 查询当前用户的使用记录 */
@@ -2521,7 +3457,7 @@ export interface ApiClient {
                 status?: string;
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取使用量统计数据 */
@@ -2531,7 +3467,7 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "hour" | "day" | "week" | "month";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     invoices: {
@@ -2547,13 +3483,13 @@ export interface ApiClient {
                     startTime?: string;
                     endTime?: 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>;
         };
         my: {
             /** 查询当前用户的订阅账单列表 */
@@ -2561,40 +3497,40 @@ export interface ApiClient {
                 current?: number;
                 pageSize?: number;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         cancel: {
             /** 取消当前用户自己的待支付订阅账单 */
             post: (body: {
                 id: string;
                 reason?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         pay: {
             /** 为当前用户的待支付账单生成支付链接 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         verifyPayment: {
             /** 查询支付宝订单状态，如果已支付则完成订阅入账 */
             post: (body: {
                 orderId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         void: {
             /** 管理端作废待支付订阅账单 */
             post: (body: {
                 id: string;
                 reason?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取订阅账单统计数据 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         revenueReport: {
             /** 获取收入报表数据 */
@@ -2602,18 +3538,18 @@ export interface ApiClient {
                 startTime: string;
                 endTime: string;
                 granularity: "day" | "week" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         revenueByProduct: {
             /** 获取按产品分布的收入数据 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取订阅账单状态下拉选项与展示文案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         stats: {
             /** 供其他服务查询发票统计数据 */
@@ -2621,7 +3557,7 @@ export interface ApiClient {
                 appId: string;
                 userIds: string[];
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statsByUser: {
             /** 供其他服务按用户分组查询发票统计 */
@@ -2629,7 +3565,7 @@ export interface ApiClient {
                 appId: string;
                 userIds: string[];
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     points: {
@@ -2637,7 +3573,7 @@ export interface ApiClient {
             /** 查询用户积分账户余额 */
             post: (body: {
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         earn: {
             /** 发放积分（充值、奖励等） */
@@ -2651,17 +3587,18 @@ export interface ApiClient {
                 referrerId?: string;
                 ruleId?: string;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         consume: {
             /** 按调用方计算好的积分数消费积分 */
             post: (body: {
                 userId: string;
-                amount: number;
+                amount?: number;
+                amountMicro?: number;
                 requestId?: string;
                 description?: string;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         consumeByPrice: {
             /** 根据计价配置消费积分 */
@@ -2672,7 +3609,7 @@ export interface ApiClient {
                 requestId?: string;
                 description?: string;
                 metadata?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         checkBalance: {
             /** 检查积分是否足够（不扣费） */
@@ -2680,7 +3617,7 @@ export interface ApiClient {
                 userId: string;
                 priceCode: string;
                 quantity?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         reversal: {
             /** 冲正/退还已消费的积分 */
@@ -2689,7 +3626,7 @@ export interface ApiClient {
                 originalTransactionId: string;
                 requestId?: string;
                 reason: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         clawback: {
             /** 追回/扣回已发放的积分 */
@@ -2698,7 +3635,7 @@ export interface ApiClient {
                 originalTransactionId: string;
                 requestId?: string;
                 reason: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         adjust: {
             /** 人工调整积分（加/减） */
@@ -2708,7 +3645,7 @@ export interface ApiClient {
                 requestId?: string;
                 reason: string;
                 relatedOrderId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         batchAdjust: {
             /** 批量调整多用户积分 */
@@ -2717,19 +3654,19 @@ export interface ApiClient {
                 amount: number;
                 requestId?: string;
                 reason: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取用户积分统计数据 */
             post: (body: {
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         leaderboard: {
             /** 获取积分排行榜 */
             post: (body: {
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsHistory: {
@@ -2743,46 +3680,46 @@ export interface ApiClient {
                 pageSize?: number;
                 startDate?: string;
                 endDate?: 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>;
         };
         statistics: {
             /** 获取积分统计数据 */
             post: (body: {
                 userId?: string;
                 period?: "day" | "week" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        getTrendChart: {
+        trendChart: {
             /** 获取积分变动趋势图表数据 */
             post: (body: {
                 userId?: string;
                 startTime: string;
                 endTime: string;
                 granularity: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        getTypeDistributionChart: {
+        typeDistributionChart: {
             /** 获取积分类型分布图表数据 */
             post: (body: {
                 userId?: string;
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        getRankingChart: {
+        rankingChart: {
             /** 获取用户积分排行榜 */
             post: (body: {
                 type?: "earn" | "spend" | "reversal" | "clawback" | "adjust";
                 startTime?: string;
                 endTime?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsTrigger: {
@@ -2791,7 +3728,7 @@ export interface ApiClient {
             post: (body: {
                 ruleId: string;
                 eventData?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         triggerByEvent: {
             /** 根据事件自动匹配并触发积分规则 */
@@ -2799,7 +3736,7 @@ export interface ApiClient {
                 event: string;
                 eventData?: Record<string, unknown>;
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         batchTrigger: {
             /** 批量触发多个积分规则 */
@@ -2808,7 +3745,7 @@ export interface ApiClient {
                     ruleId: string;
                     eventData?: Record<string, unknown>;
                 }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsTriggerHistory: {
@@ -2827,21 +3764,21 @@ export interface ApiClient {
                     startDate?: string;
                     endDate?: 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>;
         };
         statusOptions: {
             /** 获取积分触发状态下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         rewardTargetOptions: {
             /** 获取奖励目标下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取积分触发历史统计数据 */
@@ -2851,7 +3788,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 period?: "today" | "week" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         trends: {
             /** 获取积分触发趋势图表数据 */
@@ -2861,7 +3798,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 granularity?: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         pointsTrends: {
             /** 获取积分变动趋势图表数据 */
@@ -2871,7 +3808,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 granularity?: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         completionAnalysis: {
             /** 获取积分规则完成度分析数据 */
@@ -2880,7 +3817,7 @@ export interface ApiClient {
                 ruleId?: string;
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         triggerTypeTrends: {
             /** 获取积分触发类型趋势图表数据 */
@@ -2890,7 +3827,7 @@ export interface ApiClient {
                 startTime?: string;
                 endTime?: string;
                 granularity?: "minute" | "hour" | "day" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsTriggerRule: {
@@ -2905,7 +3842,7 @@ export interface ApiClient {
                 pointsReward: unknown;
                 constraints: unknown;
                 activeTimeRanges: unknown;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询积分触发规则列表 */
@@ -2919,13 +3856,13 @@ export interface ApiClient {
                     ruleCode?: string;
                     event?: 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>;
         };
         update: {
             /** 更新积分触发规则配置 */
@@ -2939,28 +3876,28 @@ export interface ApiClient {
                 pointsReward?: unknown;
                 constraints?: unknown;
                 activeTimeRanges?: unknown;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         updateStatus: {
             /** 启用或禁用积分触发规则 */
             post: (body: {
                 id: string;
                 status: "draft" | "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除积分触发规则 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取积分触发规则状态下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         eventOptions: {
             /** 获取可绑定的事件类型选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsPriceConfig: {
@@ -2975,7 +3912,7 @@ export interface ApiClient {
                 unit?: string;
                 minCharge?: number;
                 status?: "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 分页查询计价配置列表 */
@@ -2988,14 +3925,14 @@ export interface ApiClient {
                 };
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         findOne: {
             /** 根据 ID 或 code 查询计价配置详情 */
             post: (body: {
                 id?: string;
                 code?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新计价配置 */
@@ -3008,24 +3945,24 @@ export interface ApiClient {
                 unit?: string;
                 minCharge?: number;
                 status?: "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         updateStatus: {
             /** 启用或停用计价配置 */
             post: (body: {
                 id: string;
                 status: "active" | "inactive";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
             /** 删除计价配置 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         billingModeOptions: {
             /** 获取计费方式下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsUsageRecord: {
@@ -3042,7 +3979,7 @@ export interface ApiClient {
                 };
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 按维度统计消费数据 */
@@ -3053,14 +3990,14 @@ export interface ApiClient {
                 priceCode?: string;
                 userId?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         overview: {
             /** 获取消费概览数据 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     pointsBalanceAlert: {
@@ -3072,13 +4009,13 @@ export interface ApiClient {
                 notifyEmail?: boolean;
                 notifyEmails?: string[];
                 cooldownHours?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        getConfig: {
+        findOne: {
             /** 获取当前预警配置 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
-        findAlerts: {
+        find: {
             /** 分页查询预警记录 */
             post: (body: {
                 where?: {
@@ -3089,49 +4026,127 @@ export interface ApiClient {
                 };
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         triggerCheck: {
             /** 手动触发预警检查（测试用） */
             post: (body: {
                 userId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     consumption: {
         trend: {
-            /** 聚合服务消费的趋势数据 */
+            /** 聚合积分消耗趋势 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         overview: {
-            /** 聚合服务消费的概览数据 */
+            /** 聚合积分消耗概览 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    billingUsage: {
+        charges: {
+            find: {
+                /** 查询 billingUsageRecord 全站扣费明细 */
+                post: (body: {
+                    where?: {
+                        keyword?: string;
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        serviceKeys?: string[];
+                        meterKey?: string;
+                        priceListId?: string;
+                        pricingType?: "flat" | "tiered" | "meters";
+                        subjectKey?: string;
+                        id?: string;
+                        idempotencyKey?: string;
+                        resourceId?: string;
+                        status?: "pending" | "charged" | "failed" | "canceled";
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            findOne: {
+                /** 按 ID 查询单条扣费记录（含 AI 扩展字段，供详情抽屉） */
+                post: (body: {
+                    id: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        consumption: {
+            overview: {
+                /** 聚合已入账扣费结果 */
+                post: (body: {
+                    where?: {
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        serviceKeys?: string[];
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            trend: {
+                /** 按日聚合积分消耗趋势 */
+                post: (body: {
+                    where?: {
+                        userId?: string;
+                        serviceGroup?: "ai" | "platform" | "storage";
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        serviceKey?: string;
+                        serviceKeys?: string[];
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    limit?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        reference: {
+            trace: {
+                /** 按 resourceId 查询扣费明细与积分流水 */
+                post: (body: {
+                    resourceId: string;
+                    serviceKey?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
         };
     };
     pointsRecharge: {
         packages: {
             /** 获取可用的充值套餐列表 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         createOrder: {
             /** 创建积分充值订单 */
             post: (body: {
                 packageId: string;
                 payType: "alipay" | "weixinpay";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         createQRCodeOrder: {
             /** 创建支付宝扫码支付订单（当面付） */
             post: (body: {
                 packageId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         orders: {
             /** 查询用户的充值订单记录 */
@@ -3139,7 +4154,7 @@ export interface ApiClient {
                 status?: string;
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         find: {
             /** 管理端分页查询全部积分充值订单 */
@@ -3152,51 +4167,51 @@ export interface ApiClient {
                     startTime?: string;
                     endTime?: string;
                 };
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        detail: {
+        findOne: {
             /** 管理端查询单个积分充值订单详情及操作时间线 */
             post: (body: {
                 orderId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         adminStatistics: {
             /** 管理端积分充值订单统计 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statistics: {
             /** 获取用户积分充值订单统计 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         statusOptions: {
             /** 获取积分充值订单状态下拉选项与展示文案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         verifyPayment: {
             /** 查询支付宝订单状态，如果已支付则完成充值 */
             post: (body: {
                 orderId: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         notify: {
             alipay: {
                 /** 支付宝积分充值回调通知 */
-                post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                post: (body: Record<string, unknown>, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
     };
     rechargePackage: {
-        list: {
+        find: {
             /** 获取充值套餐列表（管理端） */
             post: (body: {
                 includeDisabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         create: {
             /** 创建新的充值套餐 */
@@ -3207,207 +4222,696 @@ export interface ApiClient {
                 bonus: number;
                 description?: string;
                 sort?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
             /** 更新充值套餐信息 */
             post: (body: {
-                id: string;
-                name?: string;
-                price?: number;
-                points?: number;
-                bonus?: number;
-                description?: string;
-                sort?: number;
+                id: string;
+                name?: string;
+                price?: number;
+                points?: number;
+                bonus?: number;
+                description?: string;
+                sort?: number;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            /** 删除充值套餐 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        updateSort: {
+            /** 批量更新套餐排序 */
+            post: (body: {
+                items: {
+                    id: string;
+                    sort: number;
+                }[];
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    refund: {
+        apply: {
+            /** 对已支付订单申请退款 */
+            post: (body: {
+                orderId: string;
+                reason?: string;
+                refundAmount?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        applySubscription: {
+            /** 对已支付订阅账单申请退款 */
+            post: (body: {
+                invoiceId: string;
+                reason?: string;
+                refundAmount?: number;
+                subscriptionAction?: "cancel_immediate" | "none";
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        approve: {
+            /** 审批退款申请（通过或拒绝） */
+            post: (body: {
+                refundNo: string;
+                action: "approve" | "reject";
+                remark?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        execute: {
+            /** 执行已审批的退款（调用支付宝/微信退款接口） */
+            post: (body: {
+                refundNo: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        manual: {
+            /** 管理员手动标记退款完成（用于线上接口故障或特殊情况） */
+            post: (body: {
+                refundNo: string;
+                manualRefundNo?: string;
+                remark: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        find: {
+            /** 查询退款记录列表 */
+            post: (body: {
+                page?: number;
+                pageSize?: number;
+                status?: string;
+                sourceType?: "points_recharge" | "subscription_invoice";
+                userId?: string;
+                startDate?: string;
+                endDate?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            /** 查询单个退款单详情 */
+            post: (body: {
+                refundNo: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        stats: {
+            /** 获取退款统计数据 */
+            post: (body: {
+                startDate?: string;
+                endDate?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        syncStatus: {
+            /** 手动同步单个退款单的支付宝退款状态 */
+            post: (body: {
+                refundNo: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        statusOptions: {
+            /** 获取退款单状态下拉选项与展示文案 */
+            post: (config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    serviceDefinition: {
+        find: {
+            /** 获取应用的所有服务定义 */
+            post: (body: {
+                page?: number;
+                pageSize?: number;
+                keyword?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        create: {
+            /** 创建新的服务定义 */
+            post: (body: {
+                serviceType: string;
+                name: string;
+                description?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        update: {
+            /** 更新服务定义 */
+            post: (body: {
+                id: string;
+                name?: string;
+                description?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            /** 删除服务定义 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    usage: {
+        report: {
+            /** 上报服务用量，自动计费扣费 */
+            post: (body: {
+                serviceType: string;
+                priceListId?: string;
+                metadata: Record<string, unknown>;
+                idempotencyKey?: string;
+                resourceId?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        preview: {
+            /** 按当前定价规则预估本次用量费用，不写入记录、不扣积分 */
+            post: (body: {
+                serviceType: string;
+                priceListId?: string;
+                metadata: Record<string, unknown>;
+                freeQuotaOverride?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        stats: {
+            /** 获取用量统计数据 */
+            post: (body: {
+                startDate?: string;
+                endDate?: string;
+                serviceType?: string;
+                userId?: string;
+                groupBy?: "day" | "service" | "user";
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        records: {
+            /** 获取用量记录列表 */
+            post: (body: {
+                page?: number;
+                pageSize?: number;
+                id?: string;
+                idempotencyKey?: string;
+                resourceId?: string;
+                serviceKey?: string;
+                userId?: string;
+                startDate?: string;
+                endDate?: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    priceList: {
+        find: {
+            post: (body: {
+                where?: {
+                    priceListId?: string;
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    serviceKey?: string;
+                    meterKey?: string;
+                    pricingType?: "flat" | "tiered" | "meters";
+                    keyword?: string;
+                    enabled?: boolean;
+                };
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        findOne: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            /** 筛选项、绑价表单 Select 用价目表下拉 */
+            post: (body: {
+                businessLineKey?: string;
+                billingProductLineKey?: string;
+                serviceKey?: string;
+                pricingType?: "flat" | "tiered" | "meters";
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        previewSchema: {
+            /** 由所选计费项生成填价表单结构 */
+            post: (body: {
+                businessLineKey: string;
+                serviceKey: string;
+                meterRefs: {
+                    businessLineKey: string;
+                    serviceKey: string;
+                    meterKey: string;
+                }[];
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        create: {
+            post: (body: {
+                businessLineKey: string;
+                serviceKey: string;
+                meterRefs?: {
+                    businessLineKey: string;
+                    serviceKey: string;
+                    meterKey: string;
+                }[];
+                name: string;
+                currency?: "CNY" | "USD";
+                enabled?: boolean;
+                pricingValues: {
+                    type: "flat";
+                    originalPrice: number;
+                    sellPrice: number;
+                } | {
+                    type: "tiered";
+                    priceStructure: "flat" | "segmented";
+                    tiers: {
+                        match?: Record<string, string>;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                        originalFenPerUnit: number;
+                        sellFenPerUnit: number;
+                        billingEnabled: boolean;
+                    }[];
+                } | {
+                    type: "meters";
+                    meters: {
+                        componentKey: string;
+                        businessLineKey: string;
+                        serviceKey: string;
+                        meterKey: string;
+                        tiers: {
+                            match?: Record<string, string>;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    }[];
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        update: {
+            post: (body: {
+                id: string;
+                name?: string;
+                currency?: "CNY" | "USD";
+                enabled?: boolean;
+                meterRefs?: {
+                    businessLineKey: string;
+                    serviceKey: string;
+                    meterKey: string;
+                }[];
+                pricingValues?: {
+                    type: "flat";
+                    originalPrice: number;
+                    sellPrice: number;
+                } | {
+                    type: "tiered";
+                    priceStructure: "flat" | "segmented";
+                    tiers: {
+                        match?: Record<string, string>;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                        originalFenPerUnit: number;
+                        sellFenPerUnit: number;
+                        billingEnabled: boolean;
+                    }[];
+                } | {
+                    type: "meters";
+                    meters: {
+                        componentKey: string;
+                        businessLineKey: string;
+                        serviceKey: string;
+                        meterKey: string;
+                        tiers: {
+                            match?: Record<string, string>;
+                            tierRangeMode?: "at_most" | "at_least" | "between";
+                            minTokens?: number;
+                            maxTokens?: number;
+                            minInclusive?: boolean;
+                            maxInclusive?: boolean;
+                            originalFenPerUnit: number;
+                            sellFenPerUnit: number;
+                            billingEnabled: boolean;
+                        }[];
+                    }[];
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+    };
+    priceBinding: {
+        find: {
+            post: (body: {
+                where?: {
+                    subjectType?: "model-profile";
+                    subjectKey?: string;
+                    serviceKey?: string;
+                    businessLineKey?: string;
+                    enabled?: boolean;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        upsert: {
+            post: (body: {
+                subjectType: "model-profile";
+                subjectKey: string;
+                priceListId: string;
                 enabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
-            /** 删除充值套餐 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        updateSort: {
-            /** 批量更新套餐排序 */
+    };
+    businessLine: {
+        find: {
             post: (body: {
-                items: {
-                    id: string;
-                    sort: number;
-                }[];
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                where?: {
+                    keyword?: string;
+                    enabled?: boolean;
+                };
+                withStats?: boolean;
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-    };
-    refund: {
-        apply: {
-            /** 对已支付订单申请退款 */
+        findOne: {
             post: (body: {
-                orderId: string;
-                reason?: string;
-                refundAmount?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                businessLineKey: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        applySubscription: {
-            /** 对已支付订阅账单申请退款 */
+        options: {
+            /** 筛选项、表单 Select 用业务线下拉 */
             post: (body: {
-                invoiceId: string;
-                reason?: string;
-                refundAmount?: number;
-                subscriptionAction?: "cancel_immediate" | "none";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        approve: {
-            /** 审批退款申请（通过或拒绝） */
+        create: {
             post: (body: {
-                refundNo: string;
-                action: "approve" | "reject";
-                remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                businessLineKey: string;
+                label: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        execute: {
-            /** 执行已审批的退款（调用支付宝/微信退款接口） */
+        update: {
             post: (body: {
-                refundNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                businessLineKey: string;
+                label?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        manual: {
-            /** 管理员手动标记退款完成（用于线上接口故障或特殊情况） */
+        delete: {
             post: (body: {
-                refundNo: string;
-                manualRefundNo?: string;
-                remark: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                businessLineKey: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        list: {
-            /** 查询退款记录列表 */
+    };
+    billingProductLine: {
+        find: {
             post: (body: {
+                where?: {
+                    businessLineKey?: string;
+                    keyword?: string;
+                    enabled?: boolean;
+                };
+                withStats?: boolean;
                 page?: number;
                 pageSize?: number;
-                status?: string;
-                sourceType?: "points_recharge" | "subscription_invoice";
-                userId?: string;
-                startDate?: string;
-                endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        detail: {
-            /** 查询单个退款单详情 */
+        findOne: {
             post: (body: {
-                refundNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                productLineId: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        stats: {
-            /** 获取退款统计数据 */
+        options: {
+            /** 筛选项、表单 Select 用产品线下拉 */
             post: (body: {
-                startDate?: string;
-                endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                businessLineKey?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        syncStatus: {
-            /** 手动同步单个退款单的支付宝退款状态 */
+        create: {
             post: (body: {
-                refundNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                businessLineKey: string;
+                productLineKey: string;
+                label: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        statusOptions: {
-            /** 获取退款单状态下拉选项与展示文案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        update: {
+            post: (body: {
+                productLineId: string;
+                label?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        delete: {
+            post: (body: {
+                productLineId: string;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
-    serviceDefinition: {
-        list: {
-            /** 获取应用的所有服务定义 */
+    billingServiceCatalog: {
+        service: {
+            find: {
+                post: (body: {
+                    where?: {
+                        businessLineKey?: string;
+                        billingProductLineKey?: string;
+                        productLine?: string;
+                        source?: "builtin" | "custom";
+                        serviceKey?: string;
+                        keyword?: string;
+                        enabled?: boolean;
+                    };
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            options: {
+                /** 筛选项、表单 Select 用服务下拉 */
+                post: (body: {
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    enabled?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            create: {
+                post: (body: {
+                    businessLineKey: string;
+                    billingProductLineKey: string;
+                    serviceType: string;
+                    name: string;
+                    description?: string;
+                    dependencies?: {
+                        businessLineKey: string;
+                        billingProductLineKey: string;
+                        serviceKey: string;
+                        meterKeys?: string[];
+                        required?: boolean;
+                    }[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            update: {
+                post: (body: {
+                    businessLineKey: string;
+                    serviceKey: string;
+                    label?: string;
+                    description?: string;
+                    billingProductLineKey?: string;
+                    dependencies?: {
+                        businessLineKey: string;
+                        billingProductLineKey: string;
+                        serviceKey: string;
+                        meterKeys?: string[];
+                        required?: boolean;
+                    }[];
+                    enabled?: boolean;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            delete: {
+                post: (body: {
+                    businessLineKey: string;
+                    serviceKey: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        runtime: {
+            export: {
+                /** 前端运行时缓存：服务 + 价目表 operation */
+                post: (config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+    };
+    billingMeter: {
+        find: {
             post: (body: {
+                where?: {
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    serviceKey?: string;
+                    chargeMode?: "instant" | "settlement";
+                    source?: "builtin" | "custom";
+                    keyword?: string;
+                    enabled?: boolean;
+                };
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
+        };
+        options: {
+            post: (body: {
+                businessLineKey?: string;
+                billingProductLineKey?: string;
+                serviceKey?: string;
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         create: {
-            /** 创建新的服务定义 */
             post: (body: {
-                serviceType: string;
-                name: string;
+                businessLineKey: string;
+                serviceKey: string;
+                meterKey: string;
+                label: string;
                 description?: string;
-                billingUnit: string;
-                billingMode?: "event" | "continuous";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                chargeMode?: "instant" | "settlement";
+                settlementPeriod?: "hour" | "day" | "month";
+                pricingSchema?: {
+                    unitLabel: string;
+                    quantityScale?: number;
+                    priceStructure?: "flat" | "segmented" | "keyed";
+                    matchKeys?: {
+                        key: string;
+                        label: string;
+                        values: {
+                            value: string;
+                            label: string;
+                        }[];
+                    }[];
+                    tiers: {
+                        match?: Record<string, string>;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                    }[];
+                };
+                enabled?: boolean;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         update: {
-            /** 更新服务定义 */
             post: (body: {
                 id: string;
-                name?: string;
+                businessLineKey?: string;
+                serviceKey?: string;
+                meterKey?: string;
+                label?: string;
                 description?: string;
-                billingUnit?: string;
-                billingMode?: "event" | "continuous";
+                chargeMode?: "instant" | "settlement";
+                settlementPeriod?: "hour" | "day" | "month";
+                pricingSchema?: {
+                    unitLabel: string;
+                    quantityScale?: number;
+                    priceStructure?: "flat" | "segmented" | "keyed";
+                    matchKeys?: {
+                        key: string;
+                        label: string;
+                        values: {
+                            value: string;
+                            label: string;
+                        }[];
+                    }[];
+                    tiers: {
+                        match?: Record<string, string>;
+                        tierRangeMode?: "at_most" | "at_least" | "between";
+                        minTokens?: number;
+                        maxTokens?: number;
+                        minInclusive?: boolean;
+                        maxInclusive?: boolean;
+                    }[];
+                };
                 enabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         delete: {
-            /** 删除服务定义 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-    };
-    pricingRule: {
-        get: {
-            /** 获取服务的定价规则 */
-            post: (body: {
-                serviceType: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        save: {
-            /** 创建或更新定价规则 */
-            post: (body: {
-                serviceType: string;
-                tiers?: {
-                    minUsage: number;
-                    maxUsage: number | null;
-                    pricePerUnit: number;
-                }[];
-                flatPrice?: number | null;
-                freeQuota?: number;
-                profitMargin?: number;
-                enabled?: boolean;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
-    usage: {
-        report: {
-            /** 上报服务用量，自动计费扣费 */
-            post: (body: {
-                serviceType: string;
-                metadata: Record<string, unknown>;
-                requestId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        preview: {
-            /** 按当前定价规则预估本次用量费用，不写入记录、不扣积分 */
+    billingMeterChargeItem: {
+        find: {
             post: (body: {
-                serviceType: string;
-                metadata: Record<string, unknown>;
-                freeQuotaOverride?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                where?: {
+                    keyword?: string;
+                    userId?: string;
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    serviceKey?: string;
+                    meterKey?: string;
+                    priceListId?: string;
+                    pricingType?: "flat" | "tiered" | "meters";
+                    resourceId?: string;
+                    subjectKey?: string;
+                    idempotencyKey?: string;
+                    billingUsageRecordId?: string;
+                    chargeMode?: "instant" | "settlement";
+                    status?: "pending" | "accumulating" | "charged" | "failed" | "canceled";
+                    startDate?: string;
+                    endDate?: string;
+                };
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        stats: {
-            /** 获取用量统计数据 */
+        overview: {
             post: (body: {
-                startDate?: string;
-                endDate?: string;
-                serviceType?: string;
-                groupBy?: "day" | "service" | "user";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                where?: {
+                    keyword?: string;
+                    userId?: string;
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    serviceKey?: string;
+                    meterKey?: string;
+                    priceListId?: string;
+                    pricingType?: "flat" | "tiered" | "meters";
+                    resourceId?: string;
+                    subjectKey?: string;
+                    idempotencyKey?: string;
+                    billingUsageRecordId?: string;
+                    chargeMode?: "instant" | "settlement";
+                    status?: "pending" | "accumulating" | "charged" | "failed" | "canceled";
+                    startDate?: string;
+                    endDate?: string;
+                };
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        records: {
-            /** 获取用量记录列表 */
+        trend: {
             post: (body: {
-                page?: number;
-                pageSize?: number;
-                serviceType?: string;
-                startDate?: string;
-                endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                where?: {
+                    keyword?: string;
+                    userId?: string;
+                    businessLineKey?: string;
+                    billingProductLineKey?: string;
+                    serviceKey?: string;
+                    meterKey?: string;
+                    priceListId?: string;
+                    pricingType?: "flat" | "tiered" | "meters";
+                    resourceId?: string;
+                    subjectKey?: string;
+                    idempotencyKey?: string;
+                    billingUsageRecordId?: string;
+                    chargeMode?: "instant" | "settlement";
+                    status?: "pending" | "accumulating" | "charged" | "failed" | "canceled";
+                    startDate?: string;
+                    endDate?: string;
+                };
+                limit?: number;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     export: {
@@ -3417,7 +4921,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         refund: {
             /** 导出退款记录为 CSV 格式 */
@@ -3425,7 +4929,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         pointsHistory: {
             /** 导出积分变动记录为 CSV 格式 */
@@ -3434,7 +4938,7 @@ export interface ApiClient {
                 endDate?: string;
                 type?: string;
                 userId?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     financeReport: {
@@ -3443,14 +4947,14 @@ export interface ApiClient {
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         trend: {
             /** 获取收入趋势数据（按日/周/月） */
             post: (body: {
                 period: "day" | "week" | "month";
                 days?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         packageRank: {
             /** 获取套餐销售排行数据 */
@@ -3458,7 +4962,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         userRank: {
             /** 获取用户充值排行数据 */
@@ -3466,7 +4970,7 @@ export interface ApiClient {
                 startDate?: string;
                 endDate?: string;
                 limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     reconciliation: {
@@ -3474,9 +4978,9 @@ export interface ApiClient {
             /** 生成指定日期的对账报告 */
             post: (body: {
                 date: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        list: {
+        find: {
             /** 查询对账报告列表 */
             post: (body: {
                 page?: number;
@@ -3484,13 +4988,13 @@ export interface ApiClient {
                 status?: string;
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        detail: {
+        findOne: {
             /** 查询对账报告详情 */
             post: (body: {
                 id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         processAnomaly: {
             /** 处理对账异常订单 */
@@ -3499,14 +5003,14 @@ export interface ApiClient {
                 orderId: string;
                 action: "confirm_paid" | "mark_cancelled" | "ignore";
                 remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         batchGenerate: {
             /** 批量生成指定日期范围的对账报告 */
             post: (body: {
                 startDate: string;
                 endDate: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     invoice: {
@@ -3526,9 +5030,9 @@ export interface ApiClient {
                 receiverAddress?: string;
                 orderIds?: string[];
                 remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        list: {
+        find: {
             /** 查询发票申请列表 */
             post: (body: {
                 page?: number;
@@ -3537,13 +5041,13 @@ export interface ApiClient {
                 userId?: string;
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
-        detail: {
+        findOne: {
             /** 查询发票详情 */
             post: (body: {
                 invoiceNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         review: {
             /** 审核发票申请（通过/拒绝） */
@@ -3551,7 +5055,7 @@ export interface ApiClient {
                 invoiceNo: string;
                 action: "approve" | "reject";
                 remark?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         issue: {
             /** 标记发票已开具 */
@@ -3560,20 +5064,20 @@ export interface ApiClient {
                 invoiceCode?: string;
                 invoiceNumber?: string;
                 invoiceUrl?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         stats: {
             /** 获取发票统计数据 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         cancel: {
             /** 取消发票申请（仅待审核状态可取消） */
             post: (body: {
                 invoiceNo: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     agreement: {
@@ -3584,39 +5088,39 @@ export interface ApiClient {
                 period: number;
                 singleAmount: number;
                 totalAmount?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         query: {
             /** 查询签约状态 */
             post: (body: {
                 externalAgreementNo?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         my: {
             /** 获取当前用户的签约信息 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         unsign: {
             /** 解除签约授权 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
         history: {
             /** 查询签约历史记录 */
             post: (body: {
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         deductLogs: {
             /** 查询代扣扣款记录 */
             post: (body: {
                 page?: number;
                 pageSize?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            }, config?: RequestConfig) => RequestBuilder<any>;
         };
         signNotify: {
             /** 支付宝签约异步通知回调 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            post: (config?: RequestConfig) => RequestBuilder<any>;
         };
     };
     internal: {
@@ -3628,7 +5132,7 @@ export interface ApiClient {
                     userId: string;
                     event: string;
                     eventData?: Record<string, unknown>;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
         };
         usage: {
@@ -3637,10 +5141,12 @@ export interface ApiClient {
                 post: (body: {
                     appId: string;
                     userId: string;
-                    serviceType: string;
+                    businessLineKey: string;
+                    serviceKey: string;
+                    priceListId: string;
                     amount: number;
                     freeQuotaOverride?: number;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             previewBatch: {
                 /** 供内部服务批量预估通用计费用量，不写入记录、不扣积分 */
@@ -3649,41 +5155,197 @@ export interface ApiClient {
                     items: {
                         key: string;
                         userId: string;
-                        serviceType: string;
+                        businessLineKey: string;
+                        serviceKey: string;
+                        priceListId?: string;
                         amount: number;
                         freeQuotaOverride?: number;
                     }[];
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
             };
             report: {
                 /** 供内部服务上报通用计费用量并扣积分 */
                 post: (body: {
                     appId: string;
                     userId: string;
-                    serviceType: string;
+                    businessLineKey: string;
+                    serviceKey: string;
+                    priceListId?: string;
                     amount: number;
                     metadata?: Record<string, unknown>;
-                    requestId?: string;
+                    idempotencyKey?: string;
+                    resourceId?: string;
                     usageKind?: "event" | "continuous_settlement";
                     periodStart?: string;
                     periodEnd?: string;
                     freeQuotaOverride?: number;
-                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            reversal: {
+                /** 供内部服务冲正已上报的服务用量并退还积分 */
+                post: (body: {
+                    appId: string;
+                    userId: string;
+                    idempotencyKey: string;
+                    reason?: string;
+                    reversalIdempotencyKey?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'preview-meter-charge': {
+                /** 供 ai-server 等根据价目表与 meter 用量计算积分 */
+                post: (body: {
+                    appId: string;
+                    businessLineKey: string;
+                    serviceKey: string;
+                    priceListId?: string;
+                    meterUsage: Record<string, number>;
+                    meterMatchContext?: Record<string, Record<string, string>>;
+                    meterTierMatchUsage?: Record<string, number>;
+                    exchangeRate?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'record-ai': {
+                /** 供 ai-server 传入 meter 用量，由计费引擎算价并扣积分 */
+                post: (body: {
+                    appId: string;
+                    userId: string;
+                    businessLineKey: string;
+                    idempotencyKey: string;
+                    serviceKey: string;
+                    priceListId: string;
+                    resourceId?: string;
+                    subjectKey: string;
+                    sourceService?: string;
+                    sourceType?: string;
+                    sourceId?: string;
+                    labels?: Record<string, string>;
+                    quantity: number;
+                    unit: string;
+                    meterUsage: Record<string, number>;
+                    meterMatchContext?: Record<string, Record<string, string>>;
+                    meterTierMatchUsage?: Record<string, number>;
+                    exchangeRate?: number;
+                    snapshot?: {
+                        priceListId?: string;
+                        usage?: Record<string, number>;
+                        cost?: Record<string, unknown>;
+                    };
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            find: {
+                /** 供 ai-server 等内部服务查询 billingUsageRecord */
+                post: (body: {
+                    appId: string;
+                    userId?: string;
+                    serviceGroup?: "ai" | "platform" | "storage";
+                    serviceGroups?: "ai" | "platform" | "storage"[];
+                    resourceId?: string;
+                    serviceKey?: string;
+                    model?: string;
+                    subjectKeys?: string[];
+                    id?: string;
+                    requestId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'stats-ai': {
+                /** 供 ai-server 查询 AI 用量聚合统计 */
+                post: (body: {
+                    appId: string;
+                    userId?: string;
+                    subjectKeys?: string[];
+                    startTime?: string;
+                    endTime?: string;
+                    timezone?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'by-resource': {
+                /** 按 resourceId 联合查询用量与积分流水 */
+                post: (body: {
+                    appId: string;
+                    resourceId: string;
+                    serviceKey?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        pricing: {
+            'resolve-model': {
+                /** 供 ai-server 运行时读取模型定价 */
+                post: (body: {
+                    appId: string;
+                    supplierId: string;
+                    profileId: string;
+                    productLine?: string;
+                    billingPlan?: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'sync-model': {
+                post: (body: {
+                    appId: string;
+                    operatorId: string;
+                    supplierId: string;
+                    profileId: string;
+                    profileName?: string;
+                    productLine: string;
+                    currency: "CNY" | "USD";
+                    plans: unknown[];
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'delete-model': {
+                post: (body: {
+                    appId: string;
+                    supplierId: string;
+                    profileId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'load-model-plans': {
+                post: (body: {
+                    appId: string;
+                    supplierId: string;
+                    profileId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+            'list-model-pricing-map': {
+                post: (body: {
+                    appId: string;
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        billingCatalog: {
+            list: {
+                /** 服务 + 价目表 operation 列表（供 ai-server 等内部服务） */
+                post: (body: {
+                    appId: string;
+                    billingProductLineKey?: "ai" | "storage" | "platform";
+                    group?: "ai" | "storage" | "platform";
+                }, config?: RequestConfig) => RequestBuilder<any>;
+            };
+        };
+        points: {
+            'by-request-ids': {
+                /** 供 ai-server 溯源：通过 requestId 列表查询 pointsHistory */
+                post: (body: {
+                    appId: string;
+                    requestIds: 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>;
         };
     };
 }