uapi-browser-sdk 0.1.12 → 0.1.14

package/README.md

@@ -1,6 +1,6 @@
 # uapi-browser-sdk
 
-![Banner](https://raw.githubusercontent.com/uapis/uapi-browser-sdk/main/banner.png)
+![Banner](https://raw.githubusercontent.com/AxT-Team/uapi-browser-sdk/main/banner.png)
 
 [![Browser TS](https://img.shields.io/badge/TypeScript-ES2020-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Docs](https://img.shields.io/badge/Docs-uapis.cn-2EAE5D?style=flat-square)](https://uapis.cn/)
@@ -18,11 +18,13 @@ npm i uapi-browser-sdk
 ```ts
 import { UapiClient } from 'uapi-browser-sdk'
 
-const client = new UapiClient('https://uapis.cn/api/v1')
-const result = await client.social.getSocialQqUserinfo({ qq: '10001' })
+const client = new UapiClient('https://uapis.cn', 'YOUR_API_KEY')
+const result = await client.misc.getMiscHotboard({ type: 'weibo' })
 console.log(result)
 ```
 
+这个接口默认只要传 `type` 就可以拿当前热榜。`time`、`keyword`、`timeStart`、`timeEnd`、`limit`、`sources` 都是按场景再传的可选参数。
+
 ## CDN 引入
 
 `uapi-browser-sdk` 发布在 npm，因而可以直接通过常见 CDN 以 ES Module 方式加载。建议在生产环境固定版本号（`@latest` 仅用于快速试用）。
@@ -33,7 +35,7 @@ console.log(result)
 <script type="module">
   import { UapiClient } from 'https://cdn.jsdelivr.net/npm/uapi-browser-sdk@latest/dist/index.js';
 
-  const client = new UapiClient('https://uapis.cn/api/v1');
+  const client = new UapiClient('https://uapis.cn', 'YOUR_API_KEY');
   const data = await client.social.getSocialQqUserinfo({ qq: '10001' });
   console.log(data);
 </script>
@@ -70,6 +72,63 @@ SDK 采用原生 `fetch`，自动补上 `Authorization` 头且不依赖任何 No
 
 如果你需要查看字段细节或内部逻辑，仓库中的 `./internal` 目录同步保留了由 `openapi-generator` 生成的完整结构体，随时可供参考。
 
+## 响应元信息
+
+每次请求完成后，SDK 会自动把响应 Header 解析成结构化的 `ResponseMeta`，你不用自己拆原始字符串。
+
+成功时可以通过 `client.lastResponseMeta` 读取，失败时可以通过 `err.meta` 读取，两条路径拿到的是同一套字段。
+
+```ts
+import { UapiClient, UapiError } from 'uapi-browser-sdk'
+
+const client = new UapiClient('https://uapis.cn', 'YOUR_API_KEY')
+
+// 成功路径
+await client.social.getSocialQqUserinfo({ qq: '10001' })
+const meta = client.lastResponseMeta
+if (meta) {
+  console.log('这次请求原价:', meta.creditsRequested ?? 0, '积分')
+  console.log('这次实际扣费:', meta.creditsCharged ?? 0, '积分')
+  console.log('特殊计价:', meta.creditsPricing ?? '原价')
+  console.log('余额剩余:', meta.balanceRemainingCents ?? 0, '分')
+  console.log('资源包剩余:', meta.quotaRemainingCredits ?? 0, '积分')
+  console.log('当前有效额度桶:', meta.activeQuotaBuckets ?? 0)
+  console.log('额度用空即停:', meta.stopOnEmpty ?? false)
+  console.log('Key QPS:', meta.billingKeyRateRemaining ?? 0, '/', meta.billingKeyRateLimit ?? 0, meta.billingKeyRateUnit ?? 'req')
+  console.log('Request ID:', meta.requestId)
+}
+
+// 失败路径
+try {
+  await client.social.getSocialQqUserinfo({ qq: '10001' })
+} catch (err) {
+  if (err instanceof UapiError && err.meta) {
+    console.log('Retry-After 秒数:', err.meta.retryAfterSeconds ?? null)
+    console.log('Retry-After 原始值:', err.meta.retryAfterRaw ?? null)
+    console.log('访客 QPS:', err.meta.visitorRateRemaining ?? 0, '/', err.meta.visitorRateLimit ?? 0)
+    console.log('Request ID:', err.meta.requestId)
+  }
+}
+```
+
+常用字段一览：
+
+| 字段 | 说明 |
+|------|------|
+| `creditsRequested` | 这次请求原本要扣多少积分，也就是请求价 |
+| `creditsCharged` | 这次请求实际扣了多少积分 |
+| `creditsPricing` | 特殊计价原因，例如缓存半价 `cache-hit-half-price` |
+| `balanceRemainingCents` | 账户余额剩余（分） |
+| `quotaRemainingCredits` | 资源包剩余积分 |
+| `activeQuotaBuckets` | 当前还有多少个有效额度桶参与计费 |
+| `stopOnEmpty` | 额度耗尽后是否直接停止服务 |
+| `retryAfterSeconds` / `retryAfterRaw` | 限流后的等待时长；当服务端返回 HTTP 时间字符串时看 `retryAfterRaw` |
+| `requestId` | 请求唯一 ID，排障时使用 |
+| `billingKeyRateLimit` / `billingKeyRateRemaining` | Billing Key 当前 QPS 规则的上限与剩余 |
+| `billingIpRateLimit` / `billingIpRateRemaining` | Billing Key 单 IP 当前 QPS 规则的上限与剩余 |
+| `visitorRateLimit` / `visitorRateRemaining` | 访客当前 QPS 规则的上限与剩余 |
+| `rateLimitPolicies` / `rateLimits` | 完整结构化限流策略数据 |
+
 ## 错误模型概览
 
 | HTTP 状态码 | SDK 错误类型 | 附加信息                                     |

package/dist/internal/src/apis/ClipzyApi.d.ts

@@ -25,10 +25,6 @@ export interface PostClipzyStoreOperationRequest {
  *
  */
 export declare class ClipzyApi extends runtime.BaseAPI {
-    /**
-     * Creates request options for getClipzyGet without sending the request
-     */
-    getClipzyGetRequestOpts(requestParameters: GetClipzyGetRequest): Promise<runtime.RequestOpts>;
     /**
      * **此接口用于“最高安全等级”方法。**  您提供第一步中获得的ID，它会返回存储在服务器上的**加密数据**。您需要在自己的客户端中，使用您自己保管的密钥来解密它。
      * 步骤2 (方法一): 获取加密数据
@@ -39,10 +35,6 @@ export declare class ClipzyApi extends runtime.BaseAPI {
      * 步骤2 (方法一): 获取加密数据
      */
     getClipzyGet(requestParameters: GetClipzyGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetClipzyGet200Response>;
-    /**
-     * Creates request options for getClipzyRaw without sending the request
-     */
-    getClipzyRawRequestOpts(requestParameters: GetClipzyRawRequest): Promise<runtime.RequestOpts>;
     /**
      * **此接口用于“方便自动化”方法。**  您提供第一步获得的ID，并附上您自己保管的**解密密钥**作为 `key` 参数。服务器会直接为您解密，并返回纯文本内容。  > [!IMPORTANT] > 查看文档首页的 **cURL 示例**，了解此接口最典型的用法。
      * 步骤2 (方法二): 获取原始文本
@@ -53,10 +45,6 @@ export declare class ClipzyApi extends runtime.BaseAPI {
      * 步骤2 (方法二): 获取原始文本
      */
     getClipzyRaw(requestParameters: GetClipzyRawRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<string>;
-    /**
-     * Creates request options for postClipzyStore without sending the request
-     */
-    postClipzyStoreRequestOpts(requestParameters: PostClipzyStoreOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * 这是所有流程的第一步。您的客户端应用需要先在本地准备好 **加密后的数据**，然后调用此接口进行上传。成功后，您会得到一个用于后续操作的唯一ID。  > [!NOTE] > 您发送给此接口的应该是**密文**，而不是原始文本。请参考文档首页的JavaScript示例来了解如何在客户端进行加密。
      * 步骤1：上传加密数据

package/dist/internal/src/apis/ClipzyApi.js

@@ -18,9 +18,10 @@ import { GetClipzyGet200ResponseFromJSON, PostClipzyStore200ResponseFromJSON, Po
  */
 export class ClipzyApi extends runtime.BaseAPI {
     /**
-     * Creates request options for getClipzyGet without sending the request
+     * **此接口用于“最高安全等级”方法。**  您提供第一步中获得的ID，它会返回存储在服务器上的**加密数据**。您需要在自己的客户端中，使用您自己保管的密钥来解密它。
+     * 步骤2 (方法一): 获取加密数据
      */
-    async getClipzyGetRequestOpts(requestParameters) {
+    async getClipzyGetRaw(requestParameters, initOverrides) {
         if (requestParameters['id'] == null) {
             throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getClipzyGet().');
         }
@@ -30,20 +31,12 @@ export class ClipzyApi extends runtime.BaseAPI {
         }
         const headerParameters = {};
         let urlPath = `/api/get`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-    /**
-     * **此接口用于“最高安全等级”方法。**  您提供第一步中获得的ID，它会返回存储在服务器上的**加密数据**。您需要在自己的客户端中，使用您自己保管的密钥来解密它。
-     * 步骤2 (方法一): 获取加密数据
-     */
-    async getClipzyGetRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.getClipzyGetRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => GetClipzyGet200ResponseFromJSON(jsonValue));
     }
     /**
@@ -55,9 +48,10 @@ export class ClipzyApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Creates request options for getClipzyRaw without sending the request
+     * **此接口用于“方便自动化”方法。**  您提供第一步获得的ID，并附上您自己保管的**解密密钥**作为 `key` 参数。服务器会直接为您解密，并返回纯文本内容。  > [!IMPORTANT] > 查看文档首页的 **cURL 示例**，了解此接口最典型的用法。
+     * 步骤2 (方法二): 获取原始文本
      */
-    async getClipzyRawRequestOpts(requestParameters) {
+    async getClipzyRawRaw(requestParameters, initOverrides) {
         if (requestParameters['id'] == null) {
             throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getClipzyRaw().');
         }
@@ -71,20 +65,12 @@ export class ClipzyApi extends runtime.BaseAPI {
         const headerParameters = {};
         let urlPath = `/api/raw/{id}`;
         urlPath = urlPath.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id'])));
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-    /**
-     * **此接口用于“方便自动化”方法。**  您提供第一步获得的ID，并附上您自己保管的**解密密钥**作为 `key` 参数。服务器会直接为您解密，并返回纯文本内容。  > [!IMPORTANT] > 查看文档首页的 **cURL 示例**，了解此接口最典型的用法。
-     * 步骤2 (方法二): 获取原始文本
-     */
-    async getClipzyRawRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.getClipzyRawRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         if (this.isJsonMime(response.headers.get('content-type'))) {
             return new runtime.JSONApiResponse(response);
         }
@@ -101,9 +87,10 @@ export class ClipzyApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Creates request options for postClipzyStore without sending the request
+     * 这是所有流程的第一步。您的客户端应用需要先在本地准备好 **加密后的数据**，然后调用此接口进行上传。成功后，您会得到一个用于后续操作的唯一ID。  > [!NOTE] > 您发送给此接口的应该是**密文**，而不是原始文本。请参考文档首页的JavaScript示例来了解如何在客户端进行加密。
+     * 步骤1：上传加密数据
      */
-    async postClipzyStoreRequestOpts(requestParameters) {
+    async postClipzyStoreRaw(requestParameters, initOverrides) {
         if (requestParameters['postClipzyStoreRequest'] == null) {
             throw new runtime.RequiredError('postClipzyStoreRequest', 'Required parameter "postClipzyStoreRequest" was null or undefined when calling postClipzyStore().');
         }
@@ -111,21 +98,13 @@ export class ClipzyApi extends runtime.BaseAPI {
         const headerParameters = {};
         headerParameters['Content-Type'] = 'application/json';
         let urlPath = `/api/store`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
             body: PostClipzyStoreRequestToJSON(requestParameters['postClipzyStoreRequest']),
-        };
-    }
-    /**
-     * 这是所有流程的第一步。您的客户端应用需要先在本地准备好 **加密后的数据**，然后调用此接口进行上传。成功后，您会得到一个用于后续操作的唯一ID。  > [!NOTE] > 您发送给此接口的应该是**密文**，而不是原始文本。请参考文档首页的JavaScript示例来了解如何在客户端进行加密。
-     * 步骤1：上传加密数据
-     */
-    async postClipzyStoreRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.postClipzyStoreRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => PostClipzyStore200ResponseFromJSON(jsonValue));
     }
     /**

package/dist/internal/src/apis/ConvertApi.d.ts

@@ -21,10 +21,6 @@ export interface PostConvertJsonOperationRequest {
  *
  */
 export declare class ConvertApi extends runtime.BaseAPI {
-    /**
-     * Creates request options for getConvertUnixtime without sending the request
-     */
-    getConvertUnixtimeRequestOpts(requestParameters: GetConvertUnixtimeRequest): Promise<runtime.RequestOpts>;
     /**
      * 时间戳和日期字符串，哪个用着更顺手？别纠结了，这个接口让你轻松拥有两种格式！  ## 功能概述 这是一个非常智能的转换器。你给它一个 Unix 时间戳，它还你一个人类可读的日期时间；你给它一个日期时间字符串，它还你一个 Unix 时间戳。它会自动识别你输入的是哪种格式。  ## 使用须知 这个接口非常智能，能够自动识别输入格式：  - **输入时间戳**：支持10位秒级（如 `1672531200`）和13位毫秒级（如 `1672531200000`）。 - **输入日期字符串**：为了确保准确性，推荐使用 `YYYY-MM-DD HH:mm:ss` 标准格式（如 `2023-01-01 08:00:00`）。  > [!TIP] > 无论你输入哪种格式，响应中都会同时包含标准日期字符串和秒级Unix时间戳，方便你按需取用。  ## 错误处理指南 - **400 Bad Request**: 如果你提供的 `time` 参数既不是有效的时间戳，也不是我们支持的日期格式，就会收到这个错误。请检查你的输入值。
      * 时间戳转换
@@ -35,10 +31,6 @@ export declare class ConvertApi extends runtime.BaseAPI {
      * 时间戳转换
      */
     getConvertUnixtime(requestParameters: GetConvertUnixtimeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetConvertUnixtime200Response>;
-    /**
-     * Creates request options for postConvertJson without sending the request
-     */
-    postConvertJsonRequestOpts(requestParameters: PostConvertJsonOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * 还在为一团乱麻的 JSON 字符串头疼吗？这个接口能瞬间让它变得井井有条，赏心悦目。  ## 功能概述 你只需要提供一个原始的、可能是压缩过的或者格式混乱的 JSON 字符串，这个 API 就会返回一个经过美化（带标准缩进和换行）的版本。这在调试 API 响应、或者需要在前端界面清晰展示 JSON 数据时非常有用。  ## 使用须知 > [!NOTE] > **请求格式** > 请注意，待格式化的 JSON 字符串需要被包裹在另一个 JSON 对象中，作为 `content` 字段的值提交。具体格式请参考请求体示例。  ## 错误处理指南 - **400 Bad Request**: 最常见的原因是你提供的 `content` 字符串本身不是一个有效的 JSON。请仔细检查括号、引号是否正确闭合，或者有没有多余的逗号等语法错误。
      * JSON 格式化

package/dist/internal/src/apis/ConvertApi.js

@@ -18,9 +18,10 @@ import { GetConvertUnixtime200ResponseFromJSON, PostConvertJson200ResponseFromJS
  */
 export class ConvertApi extends runtime.BaseAPI {
     /**
-     * Creates request options for getConvertUnixtime without sending the request
+     * 时间戳和日期字符串，哪个用着更顺手？别纠结了，这个接口让你轻松拥有两种格式！  ## 功能概述 这是一个非常智能的转换器。你给它一个 Unix 时间戳，它还你一个人类可读的日期时间；你给它一个日期时间字符串，它还你一个 Unix 时间戳。它会自动识别你输入的是哪种格式。  ## 使用须知 这个接口非常智能，能够自动识别输入格式：  - **输入时间戳**：支持10位秒级（如 `1672531200`）和13位毫秒级（如 `1672531200000`）。 - **输入日期字符串**：为了确保准确性，推荐使用 `YYYY-MM-DD HH:mm:ss` 标准格式（如 `2023-01-01 08:00:00`）。  > [!TIP] > 无论你输入哪种格式，响应中都会同时包含标准日期字符串和秒级Unix时间戳，方便你按需取用。  ## 错误处理指南 - **400 Bad Request**: 如果你提供的 `time` 参数既不是有效的时间戳，也不是我们支持的日期格式，就会收到这个错误。请检查你的输入值。
+     * 时间戳转换
      */
-    async getConvertUnixtimeRequestOpts(requestParameters) {
+    async getConvertUnixtimeRaw(requestParameters, initOverrides) {
         if (requestParameters['time'] == null) {
             throw new runtime.RequiredError('time', 'Required parameter "time" was null or undefined when calling getConvertUnixtime().');
         }
@@ -30,20 +31,12 @@ export class ConvertApi extends runtime.BaseAPI {
         }
         const headerParameters = {};
         let urlPath = `/convert/unixtime`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-    /**
-     * 时间戳和日期字符串，哪个用着更顺手？别纠结了，这个接口让你轻松拥有两种格式！  ## 功能概述 这是一个非常智能的转换器。你给它一个 Unix 时间戳，它还你一个人类可读的日期时间；你给它一个日期时间字符串，它还你一个 Unix 时间戳。它会自动识别你输入的是哪种格式。  ## 使用须知 这个接口非常智能，能够自动识别输入格式：  - **输入时间戳**：支持10位秒级（如 `1672531200`）和13位毫秒级（如 `1672531200000`）。 - **输入日期字符串**：为了确保准确性，推荐使用 `YYYY-MM-DD HH:mm:ss` 标准格式（如 `2023-01-01 08:00:00`）。  > [!TIP] > 无论你输入哪种格式，响应中都会同时包含标准日期字符串和秒级Unix时间戳，方便你按需取用。  ## 错误处理指南 - **400 Bad Request**: 如果你提供的 `time` 参数既不是有效的时间戳，也不是我们支持的日期格式，就会收到这个错误。请检查你的输入值。
-     * 时间戳转换
-     */
-    async getConvertUnixtimeRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.getConvertUnixtimeRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => GetConvertUnixtime200ResponseFromJSON(jsonValue));
     }
     /**
@@ -55,9 +48,10 @@ export class ConvertApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Creates request options for postConvertJson without sending the request
+     * 还在为一团乱麻的 JSON 字符串头疼吗？这个接口能瞬间让它变得井井有条，赏心悦目。  ## 功能概述 你只需要提供一个原始的、可能是压缩过的或者格式混乱的 JSON 字符串，这个 API 就会返回一个经过美化（带标准缩进和换行）的版本。这在调试 API 响应、或者需要在前端界面清晰展示 JSON 数据时非常有用。  ## 使用须知 > [!NOTE] > **请求格式** > 请注意，待格式化的 JSON 字符串需要被包裹在另一个 JSON 对象中，作为 `content` 字段的值提交。具体格式请参考请求体示例。  ## 错误处理指南 - **400 Bad Request**: 最常见的原因是你提供的 `content` 字符串本身不是一个有效的 JSON。请仔细检查括号、引号是否正确闭合，或者有没有多余的逗号等语法错误。
+     * JSON 格式化
      */
-    async postConvertJsonRequestOpts(requestParameters) {
+    async postConvertJsonRaw(requestParameters, initOverrides) {
         if (requestParameters['postConvertJsonRequest'] == null) {
             throw new runtime.RequiredError('postConvertJsonRequest', 'Required parameter "postConvertJsonRequest" was null or undefined when calling postConvertJson().');
         }
@@ -65,21 +59,13 @@ export class ConvertApi extends runtime.BaseAPI {
         const headerParameters = {};
         headerParameters['Content-Type'] = 'application/json';
         let urlPath = `/convert/json`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
             body: PostConvertJsonRequestToJSON(requestParameters['postConvertJsonRequest']),
-        };
-    }
-    /**
-     * 还在为一团乱麻的 JSON 字符串头疼吗？这个接口能瞬间让它变得井井有条，赏心悦目。  ## 功能概述 你只需要提供一个原始的、可能是压缩过的或者格式混乱的 JSON 字符串，这个 API 就会返回一个经过美化（带标准缩进和换行）的版本。这在调试 API 响应、或者需要在前端界面清晰展示 JSON 数据时非常有用。  ## 使用须知 > [!NOTE] > **请求格式** > 请注意，待格式化的 JSON 字符串需要被包裹在另一个 JSON 对象中，作为 `content` 字段的值提交。具体格式请参考请求体示例。  ## 错误处理指南 - **400 Bad Request**: 最常见的原因是你提供的 `content` 字符串本身不是一个有效的 JSON。请仔细检查括号、引号是否正确闭合，或者有没有多余的逗号等语法错误。
-     * JSON 格式化
-     */
-    async postConvertJsonRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.postConvertJsonRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => PostConvertJson200ResponseFromJSON(jsonValue));
     }
     /**

package/dist/internal/src/apis/DailyApi.d.ts

@@ -14,10 +14,6 @@ import * as runtime from '../runtime';
  *
  */
 export declare class DailyApi extends runtime.BaseAPI {
-    /**
-     * Creates request options for getDailyNewsImage without sending the request
-     */
-    getDailyNewsImageRequestOpts(): Promise<runtime.RequestOpts>;
     /**
      * 想用一张图快速了解天下大事？这个接口为你一键生成今日新闻摘要，非常适合用在早报、数字看板或应用首页等场景。  ## 功能概述 此接口会实时抓取各大平台的热点新闻，并动态地将它们渲染成一张清晰、美观的摘要图片。你调用接口，直接就能得到一张可以展示的图片。  ## 使用须知 调用此接口时，请务必注意以下两点：  1.  **响应格式是图片**：接口成功时直接返回 `image/jpeg` 格式的二进制数据，而非 JSON。请确保你的客户端能正确处理二进制流，例如直接在 `<img>` 标签中显示，或保存为 `.jpg` 文件。  2.  **设置合理超时**：由于涉及实时新闻抓取和图片渲染，处理过程可能耗时数秒。建议将客户端请求超时时间设置为至少10秒，以防止因等待过久而失败。  > [!IMPORTANT] > 未能正确处理图片响应或超时设置过短，是导致调用失败的最常见原因。
      * 每日新闻图

package/dist/internal/src/apis/DailyApi.js

@@ -17,26 +17,19 @@ import * as runtime from '../runtime';
  */
 export class DailyApi extends runtime.BaseAPI {
     /**
-     * Creates request options for getDailyNewsImage without sending the request
+     * 想用一张图快速了解天下大事？这个接口为你一键生成今日新闻摘要，非常适合用在早报、数字看板或应用首页等场景。  ## 功能概述 此接口会实时抓取各大平台的热点新闻，并动态地将它们渲染成一张清晰、美观的摘要图片。你调用接口，直接就能得到一张可以展示的图片。  ## 使用须知 调用此接口时，请务必注意以下两点：  1.  **响应格式是图片**：接口成功时直接返回 `image/jpeg` 格式的二进制数据，而非 JSON。请确保你的客户端能正确处理二进制流，例如直接在 `<img>` 标签中显示，或保存为 `.jpg` 文件。  2.  **设置合理超时**：由于涉及实时新闻抓取和图片渲染，处理过程可能耗时数秒。建议将客户端请求超时时间设置为至少10秒，以防止因等待过久而失败。  > [!IMPORTANT] > 未能正确处理图片响应或超时设置过短，是导致调用失败的最常见原因。
+     * 每日新闻图
      */
-    async getDailyNewsImageRequestOpts() {
+    async getDailyNewsImageRaw(initOverrides) {
         const queryParameters = {};
         const headerParameters = {};
         let urlPath = `/daily/news-image`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-    /**
-     * 想用一张图快速了解天下大事？这个接口为你一键生成今日新闻摘要，非常适合用在早报、数字看板或应用首页等场景。  ## 功能概述 此接口会实时抓取各大平台的热点新闻，并动态地将它们渲染成一张清晰、美观的摘要图片。你调用接口，直接就能得到一张可以展示的图片。  ## 使用须知 调用此接口时，请务必注意以下两点：  1.  **响应格式是图片**：接口成功时直接返回 `image/jpeg` 格式的二进制数据，而非 JSON。请确保你的客户端能正确处理二进制流，例如直接在 `<img>` 标签中显示，或保存为 `.jpg` 文件。  2.  **设置合理超时**：由于涉及实时新闻抓取和图片渲染，处理过程可能耗时数秒。建议将客户端请求超时时间设置为至少10秒，以防止因等待过久而失败。  > [!IMPORTANT] > 未能正确处理图片响应或超时设置过短，是导致调用失败的最常见原因。
-     * 每日新闻图
-     */
-    async getDailyNewsImageRaw(initOverrides) {
-        const requestOptions = await this.getDailyNewsImageRequestOpts();
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.BlobApiResponse(response);
     }
     /**

package/dist/internal/src/apis/DefaultApi.d.ts

@@ -27,10 +27,6 @@ export interface PostSensitiveWordQuickCheckOperationRequest {
  *
  */
 export declare class DefaultApi extends runtime.BaseAPI {
-    /**
-     * Creates request options for getSearchEngines without sending the request
-     */
-    getSearchEnginesRequestOpts(): Promise<runtime.RequestOpts>;
     /**
      * 获取 UAPI Pro Search 引擎的详细信息，包括支持的功能特性、参数限制和使用说明。  ## 功能概述  此接口返回搜索引擎的完整配置信息，你可以用它来： - 了解搜索引擎支持哪些功能（如站内搜索、文件类型过滤等） - 获取参数的默认值和限制范围 - 查看当前引擎版本和可用状态  适合在应用初始化时调用，或用于动态配置搜索界面。
      * 搜索引擎配置
@@ -41,10 +37,6 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * 搜索引擎配置
      */
     getSearchEngines(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSearchEngines200Response>;
-    /**
-     * Creates request options for getSensitiveWordAnalyzeQuery without sending the request
-     */
-    getSensitiveWordAnalyzeQueryRequestOpts(requestParameters: GetSensitiveWordAnalyzeQueryRequest): Promise<runtime.RequestOpts>;
     /**
      * 通过URL查询参数分析单个关键词，便于GET请求调用。
      * 敏感词分析 (GET)
@@ -55,10 +47,6 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * 敏感词分析 (GET)
      */
     getSensitiveWordAnalyzeQuery(requestParameters: GetSensitiveWordAnalyzeQueryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PostSensitiveWordAnalyze200Response>;
-    /**
-     * Creates request options for postSearchAggregate without sending the request
-     */
-    postSearchAggregateRequestOpts(requestParameters: PostSearchAggregateOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * 想在你的应用中集成搜索功能？我们提供了一个强大的搜索引擎API，让你可以轻松实现实时网页搜索。  ## 功能概述  UAPI Pro Search 是一个智能搜索引擎，采用机器学习算法对搜索结果进行智能排序，确保最相关的内容排在前面。你可以用它搜索任何关键词，也可以限定在特定网站或特定文件类型中搜索。  - **实时网页搜索**: 毫秒级响应，快速返回搜索结果 - **智能排序**: 采用机器学习回归排序算法，结果更精准 - **时间排序**: 支持按发布时间排序，获取最新内容 - **时间范围过滤**: 支持按天/周/月/年过滤结果 - **站内搜索**: 支持 `site:` 操作符，在指定网站内搜索 - **文件类型过滤**: 支持 `filetype:` 操作符，快速找到 PDF、Word 等特定格式文件
      * 智能搜索
@@ -69,10 +57,6 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * 智能搜索
      */
     postSearchAggregate(requestParameters: PostSearchAggregateOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PostSearchAggregate200Response>;
-    /**
-     * Creates request options for postSensitiveWordAnalyze without sending the request
-     */
-    postSensitiveWordAnalyzeRequestOpts(requestParameters: PostSensitiveWordAnalyzeOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * 分析单个或多个关键词的敏感程度，返回标准化风险标签与置信度结果。  ## 功能概述  - **模型驱动**: 使用先进的分析模型进行语义分析。 - **高性能**: 采用三级缓存策略（持久化存储 → 统一缓存 → 模型分析），确保高频请求的响应速度。 - **并发支持**: 支持批量并发处理，单次最多可分析100个关键词。 - **输入限制**: 单条关键词最多 1,000 字符，总字符数最多 20,000。 - **标准标签**: 返回 `label` 字段，明确区分 `sensitive` 与 `normal`。 - **分类清晰**: 返回 `category` 字段，用于标识具体风险类别。 - **置信度输出**: 返回 `confidence` 字段，范围为0.0到1.0。  ## 响应字段说明  | 字段 | 类型 | 说明 | |------|------|------| | `results` | array | 分析结果对象的数组。 | | `results[].k` | string | 您在请求中提供的原始关键词。 | | `results[].label` | string | 核心判断字段：`sensitive`(敏感)、`normal`(正常)。 | | `results[].category` | string | 风险分类：`safe`(安全)、`threat`(威胁)、`porn`(色情)、`fraud`(欺诈)、`insult`(辱骂)。 | | `results[].confidence` | number | 当前分类的置信度，范围0.0到1.0。 | | `total` | integer | 本次请求成功分析的关键词总数。 |
      * 分析敏感词
@@ -83,10 +67,6 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * 分析敏感词
      */
     postSensitiveWordAnalyze(requestParameters: PostSensitiveWordAnalyzeOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PostSensitiveWordAnalyze200Response>;
-    /**
-     * Creates request options for postSensitiveWordQuickCheck without sending the request
-     */
-    postSensitiveWordQuickCheckRequestOpts(requestParameters: PostSensitiveWordQuickCheckOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * 在你的社区或应用中，需要来过滤掉不和谐的声音吗？这个接口可以助你一臂之力。  ## 功能概述  我们对敏感词检测接口进行了大幅升级，现在采用高效的 **Aho-Corasick 算法**，实现了多模式字符串匹配。这意味着你不再需要手动编写复杂的正则表达式，系统会自动高效地检测出文本中的所有敏感词。  ### 主要特性  - **高性能算法**：基于 Aho-Corasick 算法，单次扫描即可检测多个敏感词模式 - **简繁体支持**：自动识别和处理简体中文、繁体中文内容 - **多模匹配**：无需编写正则表达式，系统内置智能匹配逻辑 - **快速响应**：相比传统方法，检测速度显著提升  无论是论坛、社交平台还是评论系统，这个接口都能帮你快速构建内容审核功能。
      * 敏感词检测（快速）

package/dist/internal/src/apis/DefaultApi.js

@@ -18,26 +18,19 @@ import { GetSearchEngines200ResponseFromJSON, PostSearchAggregate200ResponseFrom
  */
 export class DefaultApi extends runtime.BaseAPI {
     /**
-     * Creates request options for getSearchEngines without sending the request
+     * 获取 UAPI Pro Search 引擎的详细信息，包括支持的功能特性、参数限制和使用说明。  ## 功能概述  此接口返回搜索引擎的完整配置信息，你可以用它来： - 了解搜索引擎支持哪些功能（如站内搜索、文件类型过滤等） - 获取参数的默认值和限制范围 - 查看当前引擎版本和可用状态  适合在应用初始化时调用，或用于动态配置搜索界面。
+     * 搜索引擎配置
      */
-    async getSearchEnginesRequestOpts() {
+    async getSearchEnginesRaw(initOverrides) {
         const queryParameters = {};
         const headerParameters = {};
         let urlPath = `/search/engines`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-    /**
-     * 获取 UAPI Pro Search 引擎的详细信息，包括支持的功能特性、参数限制和使用说明。  ## 功能概述  此接口返回搜索引擎的完整配置信息，你可以用它来： - 了解搜索引擎支持哪些功能（如站内搜索、文件类型过滤等） - 获取参数的默认值和限制范围 - 查看当前引擎版本和可用状态  适合在应用初始化时调用，或用于动态配置搜索界面。
-     * 搜索引擎配置
-     */
-    async getSearchEnginesRaw(initOverrides) {
-        const requestOptions = await this.getSearchEnginesRequestOpts();
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => GetSearchEngines200ResponseFromJSON(jsonValue));
     }
     /**
@@ -49,9 +42,10 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Creates request options for getSensitiveWordAnalyzeQuery without sending the request
+     * 通过URL查询参数分析单个关键词，便于GET请求调用。
+     * 敏感词分析 (GET)
      */
-    async getSensitiveWordAnalyzeQueryRequestOpts(requestParameters) {
+    async getSensitiveWordAnalyzeQueryRaw(requestParameters, initOverrides) {
         if (requestParameters['keyword'] == null) {
             throw new runtime.RequiredError('keyword', 'Required parameter "keyword" was null or undefined when calling getSensitiveWordAnalyzeQuery().');
         }
@@ -61,20 +55,12 @@ export class DefaultApi extends runtime.BaseAPI {
         }
         const headerParameters = {};
         let urlPath = `/sensitive-word/analyze-query`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-    /**
-     * 通过URL查询参数分析单个关键词，便于GET请求调用。
-     * 敏感词分析 (GET)
-     */
-    async getSensitiveWordAnalyzeQueryRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.getSensitiveWordAnalyzeQueryRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => PostSensitiveWordAnalyze200ResponseFromJSON(jsonValue));
     }
     /**
@@ -86,9 +72,10 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Creates request options for postSearchAggregate without sending the request
+     * 想在你的应用中集成搜索功能？我们提供了一个强大的搜索引擎API，让你可以轻松实现实时网页搜索。  ## 功能概述  UAPI Pro Search 是一个智能搜索引擎，采用机器学习算法对搜索结果进行智能排序，确保最相关的内容排在前面。你可以用它搜索任何关键词，也可以限定在特定网站或特定文件类型中搜索。  - **实时网页搜索**: 毫秒级响应，快速返回搜索结果 - **智能排序**: 采用机器学习回归排序算法，结果更精准 - **时间排序**: 支持按发布时间排序，获取最新内容 - **时间范围过滤**: 支持按天/周/月/年过滤结果 - **站内搜索**: 支持 `site:` 操作符，在指定网站内搜索 - **文件类型过滤**: 支持 `filetype:` 操作符，快速找到 PDF、Word 等特定格式文件
+     * 智能搜索
      */
-    async postSearchAggregateRequestOpts(requestParameters) {
+    async postSearchAggregateRaw(requestParameters, initOverrides) {
         if (requestParameters['postSearchAggregateRequest'] == null) {
             throw new runtime.RequiredError('postSearchAggregateRequest', 'Required parameter "postSearchAggregateRequest" was null or undefined when calling postSearchAggregate().');
         }
@@ -96,21 +83,13 @@ export class DefaultApi extends runtime.BaseAPI {
         const headerParameters = {};
         headerParameters['Content-Type'] = 'application/json';
         let urlPath = `/search/aggregate`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
             body: PostSearchAggregateRequestToJSON(requestParameters['postSearchAggregateRequest']),
-        };
-    }
-    /**
-     * 想在你的应用中集成搜索功能？我们提供了一个强大的搜索引擎API，让你可以轻松实现实时网页搜索。  ## 功能概述  UAPI Pro Search 是一个智能搜索引擎，采用机器学习算法对搜索结果进行智能排序，确保最相关的内容排在前面。你可以用它搜索任何关键词，也可以限定在特定网站或特定文件类型中搜索。  - **实时网页搜索**: 毫秒级响应，快速返回搜索结果 - **智能排序**: 采用机器学习回归排序算法，结果更精准 - **时间排序**: 支持按发布时间排序，获取最新内容 - **时间范围过滤**: 支持按天/周/月/年过滤结果 - **站内搜索**: 支持 `site:` 操作符，在指定网站内搜索 - **文件类型过滤**: 支持 `filetype:` 操作符，快速找到 PDF、Word 等特定格式文件
-     * 智能搜索
-     */
-    async postSearchAggregateRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.postSearchAggregateRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => PostSearchAggregate200ResponseFromJSON(jsonValue));
     }
     /**
@@ -122,9 +101,10 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Creates request options for postSensitiveWordAnalyze without sending the request
+     * 分析单个或多个关键词的敏感程度，返回标准化风险标签与置信度结果。  ## 功能概述  - **模型驱动**: 使用先进的分析模型进行语义分析。 - **高性能**: 采用三级缓存策略（持久化存储 → 统一缓存 → 模型分析），确保高频请求的响应速度。 - **并发支持**: 支持批量并发处理，单次最多可分析100个关键词。 - **输入限制**: 单条关键词最多 1,000 字符，总字符数最多 20,000。 - **标准标签**: 返回 `label` 字段，明确区分 `sensitive` 与 `normal`。 - **分类清晰**: 返回 `category` 字段，用于标识具体风险类别。 - **置信度输出**: 返回 `confidence` 字段，范围为0.0到1.0。  ## 响应字段说明  | 字段 | 类型 | 说明 | |------|------|------| | `results` | array | 分析结果对象的数组。 | | `results[].k` | string | 您在请求中提供的原始关键词。 | | `results[].label` | string | 核心判断字段：`sensitive`(敏感)、`normal`(正常)。 | | `results[].category` | string | 风险分类：`safe`(安全)、`threat`(威胁)、`porn`(色情)、`fraud`(欺诈)、`insult`(辱骂)。 | | `results[].confidence` | number | 当前分类的置信度，范围0.0到1.0。 | | `total` | integer | 本次请求成功分析的关键词总数。 |
+     * 分析敏感词
      */
-    async postSensitiveWordAnalyzeRequestOpts(requestParameters) {
+    async postSensitiveWordAnalyzeRaw(requestParameters, initOverrides) {
         if (requestParameters['postSensitiveWordAnalyzeRequest'] == null) {
             throw new runtime.RequiredError('postSensitiveWordAnalyzeRequest', 'Required parameter "postSensitiveWordAnalyzeRequest" was null or undefined when calling postSensitiveWordAnalyze().');
         }
@@ -132,21 +112,13 @@ export class DefaultApi extends runtime.BaseAPI {
         const headerParameters = {};
         headerParameters['Content-Type'] = 'application/json';
         let urlPath = `/sensitive-word/analyze`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
             body: PostSensitiveWordAnalyzeRequestToJSON(requestParameters['postSensitiveWordAnalyzeRequest']),
-        };
-    }
-    /**
-     * 分析单个或多个关键词的敏感程度，返回标准化风险标签与置信度结果。  ## 功能概述  - **模型驱动**: 使用先进的分析模型进行语义分析。 - **高性能**: 采用三级缓存策略（持久化存储 → 统一缓存 → 模型分析），确保高频请求的响应速度。 - **并发支持**: 支持批量并发处理，单次最多可分析100个关键词。 - **输入限制**: 单条关键词最多 1,000 字符，总字符数最多 20,000。 - **标准标签**: 返回 `label` 字段，明确区分 `sensitive` 与 `normal`。 - **分类清晰**: 返回 `category` 字段，用于标识具体风险类别。 - **置信度输出**: 返回 `confidence` 字段，范围为0.0到1.0。  ## 响应字段说明  | 字段 | 类型 | 说明 | |------|------|------| | `results` | array | 分析结果对象的数组。 | | `results[].k` | string | 您在请求中提供的原始关键词。 | | `results[].label` | string | 核心判断字段：`sensitive`(敏感)、`normal`(正常)。 | | `results[].category` | string | 风险分类：`safe`(安全)、`threat`(威胁)、`porn`(色情)、`fraud`(欺诈)、`insult`(辱骂)。 | | `results[].confidence` | number | 当前分类的置信度，范围0.0到1.0。 | | `total` | integer | 本次请求成功分析的关键词总数。 |
-     * 分析敏感词
-     */
-    async postSensitiveWordAnalyzeRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.postSensitiveWordAnalyzeRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => PostSensitiveWordAnalyze200ResponseFromJSON(jsonValue));
     }
     /**
@@ -158,9 +130,10 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Creates request options for postSensitiveWordQuickCheck without sending the request
+     * 在你的社区或应用中，需要来过滤掉不和谐的声音吗？这个接口可以助你一臂之力。  ## 功能概述  我们对敏感词检测接口进行了大幅升级，现在采用高效的 **Aho-Corasick 算法**，实现了多模式字符串匹配。这意味着你不再需要手动编写复杂的正则表达式，系统会自动高效地检测出文本中的所有敏感词。  ### 主要特性  - **高性能算法**：基于 Aho-Corasick 算法，单次扫描即可检测多个敏感词模式 - **简繁体支持**：自动识别和处理简体中文、繁体中文内容 - **多模匹配**：无需编写正则表达式，系统内置智能匹配逻辑 - **快速响应**：相比传统方法，检测速度显著提升  无论是论坛、社交平台还是评论系统，这个接口都能帮你快速构建内容审核功能。
+     * 敏感词检测（快速）
      */
-    async postSensitiveWordQuickCheckRequestOpts(requestParameters) {
+    async postSensitiveWordQuickCheckRaw(requestParameters, initOverrides) {
         if (requestParameters['postSensitiveWordQuickCheckRequest'] == null) {
             throw new runtime.RequiredError('postSensitiveWordQuickCheckRequest', 'Required parameter "postSensitiveWordQuickCheckRequest" was null or undefined when calling postSensitiveWordQuickCheck().');
         }
@@ -168,21 +141,13 @@ export class DefaultApi extends runtime.BaseAPI {
         const headerParameters = {};
         headerParameters['Content-Type'] = 'application/json';
         let urlPath = `/text/profanitycheck`;
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
             body: PostSensitiveWordQuickCheckRequestToJSON(requestParameters['postSensitiveWordQuickCheckRequest']),
-        };
-    }
-    /**
-     * 在你的社区或应用中，需要来过滤掉不和谐的声音吗？这个接口可以助你一臂之力。  ## 功能概述  我们对敏感词检测接口进行了大幅升级，现在采用高效的 **Aho-Corasick 算法**，实现了多模式字符串匹配。这意味着你不再需要手动编写复杂的正则表达式，系统会自动高效地检测出文本中的所有敏感词。  ### 主要特性  - **高性能算法**：基于 Aho-Corasick 算法，单次扫描即可检测多个敏感词模式 - **简繁体支持**：自动识别和处理简体中文、繁体中文内容 - **多模匹配**：无需编写正则表达式，系统内置智能匹配逻辑 - **快速响应**：相比传统方法，检测速度显著提升  无论是论坛、社交平台还是评论系统，这个接口都能帮你快速构建内容审核功能。
-     * 敏感词检测（快速）
-     */
-    async postSensitiveWordQuickCheckRaw(requestParameters, initOverrides) {
-        const requestOptions = await this.postSensitiveWordQuickCheckRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
         return new runtime.JSONApiResponse(response, (jsonValue) => PostSensitiveWordQuickCheck200ResponseFromJSON(jsonValue));
     }
     /**