uapi-browser-sdk 0.1.4 → 0.1.12

package/internal/docs/PostTextAesDecryptAdvanced200Response.md

@@ -0,0 +1,34 @@
+
+# PostTextAesDecryptAdvanced200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`plaintext` | string
+
+## Example
+
+```typescript
+import type { PostTextAesDecryptAdvanced200Response } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "plaintext": Hello, World! 你好世界！,
+} satisfies PostTextAesDecryptAdvanced200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextAesDecryptAdvanced200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextAesDecryptAdvanced400Response.md

@@ -0,0 +1,34 @@
+
+# PostTextAesDecryptAdvanced400Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`error` | string
+
+## Example
+
+```typescript
+import type { PostTextAesDecryptAdvanced400Response } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "error": 填充验证失败：密钥、模式或填充方式可能不正确,
+} satisfies PostTextAesDecryptAdvanced400Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextAesDecryptAdvanced400Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextAesDecryptAdvancedRequest.md

@@ -0,0 +1,42 @@
+
+# PostTextAesDecryptAdvancedRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`text` | string
+`key` | string
+`mode` | string
+`padding` | string
+`iv` | string
+
+## Example
+
+```typescript
+import type { PostTextAesDecryptAdvancedRequest } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "text": 68vWkaxJPg1vx0LWJONpEfYdvW3Wz7V5uXiYg0WWfGJHIZWBmVVghHg=,
+  "key": my-super-secret-key,
+  "mode": GCM,
+  "padding": NONE,
+  "iv": cmFuZG9tSVZoZXJl,
+} satisfies PostTextAesDecryptAdvancedRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextAesDecryptAdvancedRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextAesEncryptAdvanced200Response.md

@@ -0,0 +1,40 @@
+
+# PostTextAesEncryptAdvanced200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`ciphertext` | string
+`mode` | string
+`padding` | string
+`iv` | string
+
+## Example
+
+```typescript
+import type { PostTextAesEncryptAdvanced200Response } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "ciphertext": kJB3X5YxNzA2MTA1NDQ3Mjc3ODg5...,
+  "mode": GCM,
+  "padding": NONE,
+  "iv": cmFuZG9tSVZoZXJl,
+} satisfies PostTextAesEncryptAdvanced200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextAesEncryptAdvanced200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextAesEncryptAdvanced400Response.md

@@ -0,0 +1,34 @@
+
+# PostTextAesEncryptAdvanced400Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`error` | string
+
+## Example
+
+```typescript
+import type { PostTextAesEncryptAdvanced400Response } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "error": 不支持的加密模式: INVALID,
+} satisfies PostTextAesEncryptAdvanced400Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextAesEncryptAdvanced400Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextAesEncryptAdvancedRequest.md

@@ -0,0 +1,44 @@
+
+# PostTextAesEncryptAdvancedRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`text` | string
+`key` | string
+`mode` | string
+`padding` | string
+`iv` | string
+`outputFormat` | string
+
+## Example
+
+```typescript
+import type { PostTextAesEncryptAdvancedRequest } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "text": Hello, World! 你好世界！,
+  "key": my-super-secret-key,
+  "mode": GCM,
+  "padding": PKCS7,
+  "iv": cmFuZG9tSVZoZXJl,
+  "outputFormat": hex,
+} satisfies PostTextAesEncryptAdvancedRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextAesEncryptAdvancedRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextAesEncryptRequest.md

@@ -17,7 +17,7 @@ import type { PostTextAesEncryptRequest } from 'uapi-browser-sdk-browser'
 // TODO: Update the object below with actual values
 const example = {
   "key": a-secret-key-123,
-  "text": top secret message,
+  "text": 这是一段需要加密的消息,
 } satisfies PostTextAesEncryptRequest
 
 console.log(example)

package/internal/docs/PostTextConvert200Response.md

@@ -0,0 +1,42 @@
+
+# PostTextConvert200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`result` | string
+`from` | string
+`to` | string
+`length` | number
+`info` | string
+
+## Example
+
+```typescript
+import type { PostTextConvert200Response } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "result": aGVsbG8gd29ybGQ=,
+  "from": plain,
+  "to": base64,
+  "length": 16,
+  "info": 此转换为单向哈希，不可逆,
+} satisfies PostTextConvert200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextConvert200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextConvert400Response.md

@@ -0,0 +1,38 @@
+
+# PostTextConvert400Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`errorCode` | string
+`errorMessage` | string
+`errorDetails` | string
+
+## Example
+
+```typescript
+import type { PostTextConvert400Response } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "errorCode": CONVERSION_FAILED,
+  "errorMessage": 不支持的源格式: unknown,
+  "errorDetails": ,
+} satisfies PostTextConvert400Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextConvert400Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/PostTextConvertRequest.md

@@ -0,0 +1,40 @@
+
+# PostTextConvertRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`text` | string
+`from` | string
+`to` | string
+`options` | { [key: string]: any; }
+
+## Example
+
+```typescript
+import type { PostTextConvertRequest } from 'uapi-browser-sdk-browser'
+
+// TODO: Update the object below with actual values
+const example = {
+  "text": hello world,
+  "from": plain,
+  "to": base64,
+  "options": null,
+} satisfies PostTextConvertRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PostTextConvertRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/internal/docs/RandomApi.md

@@ -4,10 +4,10 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**getAnswerbookAsk**](RandomApi.md#getanswerbookask) | **GET** /answerbook/ask | 获取答案之书的神秘答案 (GET) |
-| [**getRandomImage**](RandomApi.md#getrandomimage) | **GET** /random/image | 随机二次元、风景、动漫图片壁纸 |
-| [**getRandomString**](RandomApi.md#getrandomstring) | **GET** /random/string | 生成高度可定制的随机字符串 |
-| [**postAnswerbookAsk**](RandomApi.md#postanswerbookaskoperation) | **POST** /answerbook/ask | 获取答案之书的神秘答案 (POST) |
+| [**getAnswerbookAsk**](RandomApi.md#getanswerbookask) | **GET** /answerbook/ask | 答案之书 |
+| [**getRandomImage**](RandomApi.md#getrandomimage) | **GET** /random/image | 随机图片 |
+| [**getRandomString**](RandomApi.md#getrandomstring) | **GET** /random/string | 随机字符串 |
+| [**postAnswerbookAsk**](RandomApi.md#postanswerbookaskoperation) | **POST** /answerbook/ask | 答案之书 (POST) |
 
 
 
@@ -15,7 +15,7 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 > GetAnswerbookAsk200Response getAnswerbookAsk(question)
 
-获取答案之书的神秘答案 (GET)
+答案之书
 
 想要获得人生问题的神秘答案吗？答案之书API提供了一个神奇8球风格的问答服务，你可以提问并获得随机的神秘答案。  ## 功能概述 通过向答案之书提问，你将获得一个充满智慧（或许）的随机答案。这个API支持通过查询参数或POST请求体两种方式提问。  ## 使用须知  > [!TIP] > **提问技巧** > - 提出明确的问题会获得更好的体验 > - 问题不能为空 > - 支持中文问题 > - 答案具有随机性，仅供娱乐参考
 
@@ -84,9 +84,9 @@ No authorization required
 
 > Blob getRandomImage(category, type)
 
-随机二次元、风景、动漫图片壁纸
+随机图片
 
-需要一张随机图片作为占位符或者背景吗？这个接口是你的不二之选。  ## 功能概述 这是一个非常简单的接口，它会从我们庞大的图库和精选外部图床中随机挑选一张图片，然后通过 302 重定向让你直接访问到它。这使得它可以非常方便地直接用在 HTML 的 `<img>` 标签中。  你可以通过 `/api/v1/random/image?category=acg&type=4k` 这样的请求获取由UapiPro服务器提供的图片，也可以通过 `/api/v1/random/image?category=ai_drawing` 获取由外部图床精选的图片。  如果你不提供任何 category 参数，程序会从所有图片（包括本地的和URL的）中随机抽取一张（**全局随机图片不包含ikun和AI绘画**）。  > [!TIP] > 如果你需要更精确地控制图片类型，请使用 `/image/random/{category}/{type}` 接口。  ### 支持的主类别与子类别 - **UapiPro服务器图片**   - **furry**（福瑞）     - z4k     - szs8k     - s4k     - 4k   - **bq**（表情包/趣图）     - youshou     - xiongmao     - waiguoren     - maomao     - ikun     - eciyuan   - **acg**（二次元动漫）     - pc     - mb - **外部图床精选图片**   - **ai_drawing**: AI绘画。   - **general_anime**: 动漫图。   - **landscape**: 风景图。   - **mobile_wallpaper**: 手机壁纸。   - **pc_wallpaper**: 电脑壁纸。 - **混合动漫**   - **anime**: 混合了UapiPro服务器的acg和外部图床的general_anime分类下的图片。  > [!NOTE] > 默认全局随机（未指定category参数）时，不会包含ikun和AI绘画（ai_drawing）类别的图片。 
+需要一张随机图片作为占位符或者背景吗？这个接口是你的不二之选。  ## 功能概述 这是一个非常简单的接口，它会从我们庞大的图库和精选外部图床中随机挑选一张图片，然后通过 302 重定向让你直接访问到它。这使得它可以非常方便地直接用在 HTML 的 `<img>` 标签中。  你可以通过 `/api/v1/random/image?category=acg&type=4k` 这样的请求获取由UapiPro服务器提供的图片，也可以通过 `/api/v1/random/image?category=ai_drawing` 获取由外部图床精选的图片。  如果你不提供任何 category 参数，程序会从所有图片（包括本地的和URL的）中随机抽取一张（**全局随机图片不包含ikun和AI绘画**）。  > [!TIP] > 如果你需要更精确地控制图片类型，请使用 `/image/random/{category}/{type}` 接口。  ### 支持的主类别与子类别 - **acg**（二次元动漫）     - pc     - mb - **外部图床精选/混合动漫**   - **landscape**: 风景图。   - **anime**: 混合了UapiPro服务器的acg和外部图床的general_anime分类下的图片。   - **pc_wallpaper**: 电脑壁纸。   - **mobile_wallpaper**: 手机壁纸。   - **general_anime**: 动漫图。   - **ai_drawing**: AI绘画。 - **其他分类**   - **bq**（表情包/趣图）     - eciyuan     - ikun     - xiongmao     - waiguoren     - maomao   - **furry**（福瑞）     - z4k     - szs8k     - s4k     - 4k  > [!NOTE] > 默认全局随机（未指定category参数）时，不会包含ikun和AI绘画（ai_drawing）类别的图片。 
 
 ### Example
 
@@ -102,9 +102,9 @@ async function example() {
   const api = new RandomApi();
 
   const body = {
-    // 'furry' | 'bq' | 'acg' | 'ai_drawing' | 'general_anime' | 'landscape' | 'mobile_wallpaper' | 'pc_wallpaper' | 'anime' | （可选）指定图片主类别。  **支持的主类别：** - `furry`（福瑞，UapiPro服务器） - `bq`（表情包/趣图，UapiPro服务器） - `acg`（二次元动漫，UapiPro服务器） - `ai_drawing`（AI绘画，外部图床） - `general_anime`（动漫图，外部图床） - `landscape`（风景图，外部图床） - `mobile_wallpaper`（手机壁纸，外部图床） - `pc_wallpaper`（电脑壁纸，外部图床） - `anime`（混合动漫，UapiPro服务器acg + 外部图床general_anime）  > [!TIP] > 如果不指定，将从所有图片中随机抽取（不包含 `ikun` 和 `ai_drawing`）。  (optional)
+    // 'acg' | 'landscape' | 'anime' | 'pc_wallpaper' | 'mobile_wallpaper' | 'general_anime' | 'ai_drawing' | 'bq' | 'furry' | （可选）指定图片主类别。  **支持的主类别：** - `acg`（二次元动漫，UapiPro服务器） - `landscape`（风景图，外部图床） - `anime`（混合动漫） - `pc_wallpaper`（电脑壁纸，外部图床） - `mobile_wallpaper`（手机壁纸，外部图床） - `general_anime`（动漫图，外部图床） - `ai_drawing`（AI绘画，外部图床） - `bq`（表情包/趣图，UapiPro服务器） - `furry`（福瑞，UapiPro服务器）  > [!TIP] > 如果不指定，将从所有图片中随机抽取（不包含 `ikun` 和 `ai_drawing`）。  (optional)
     category: acg,
-    // 'z4k' | 'szs8k' | 's4k' | '4k' | 'youshou' | 'xiongmao' | 'waiguoren' | 'maomao' | 'ikun' | 'eciyuan' | 'pc' | 'mb' | （可选，仅UapiPro服务器图片支持）指定图片子类别。  - **furry**: `z4k`, `szs8k`, `s4k`, `4k` - **bq**: `youshou`, `xiongmao`, `waiguoren`, `maomao`, `ikun`, `eciyuan` - **acg**: `pc`, `mb`  > [!TIP] > 外部图床类别和 `anime` 混合类别不支持 `type` 参数。  (optional)
+    // 'pc' | 'mb' | 'eciyuan' | 'ikun' | '4k' | 's4k' | 'z4k' | 'szs8k' | 'xiongmao' | 'maomao' | 'waiguoren' | （可选，仅UapiPro服务器图片支持）指定图片子类别。  - **bq**: `xiongmao`, `waiguoren`, `maomao`, `ikun`, `eciyuan` - **acg**: `pc`, `mb` - **furry**: `z4k`, `szs8k`, `s4k`, `4k`  > [!TIP] > 外部图床类别和 `anime` 混合类别不支持 `type` 参数。  (optional)
     type: pc,
   } satisfies GetRandomImageRequest;
 
@@ -125,8 +125,8 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **category** | `furry`, `bq`, `acg`, `ai_drawing`, `general_anime`, `landscape`, `mobile_wallpaper`, `pc_wallpaper`, `anime` | （可选）指定图片主类别。  **支持的主类别：** - `furry`（福瑞，UapiPro服务器） - `bq`（表情包/趣图，UapiPro服务器） - `acg`（二次元动漫，UapiPro服务器） - `ai_drawing`（AI绘画，外部图床） - `general_anime`（动漫图，外部图床） - `landscape`（风景图，外部图床） - `mobile_wallpaper`（手机壁纸，外部图床） - `pc_wallpaper`（电脑壁纸，外部图床） - `anime`（混合动漫，UapiPro服务器acg + 外部图床general_anime）  > [!TIP] > 如果不指定，将从所有图片中随机抽取（不包含 `ikun` 和 `ai_drawing`）。  | [Optional] [Defaults to `undefined`] [Enum: furry, bq, acg, ai_drawing, general_anime, landscape, mobile_wallpaper, pc_wallpaper, anime] |
-| **type** | `z4k`, `szs8k`, `s4k`, `4k`, `youshou`, `xiongmao`, `waiguoren`, `maomao`, `ikun`, `eciyuan`, `pc`, `mb` | （可选，仅UapiPro服务器图片支持）指定图片子类别。  - **furry**: `z4k`, `szs8k`, `s4k`, `4k` - **bq**: `youshou`, `xiongmao`, `waiguoren`, `maomao`, `ikun`, `eciyuan` - **acg**: `pc`, `mb`  > [!TIP] > 外部图床类别和 `anime` 混合类别不支持 `type` 参数。  | [Optional] [Defaults to `undefined`] [Enum: z4k, szs8k, s4k, 4k, youshou, xiongmao, waiguoren, maomao, ikun, eciyuan, pc, mb] |
+| **category** | `acg`, `landscape`, `anime`, `pc_wallpaper`, `mobile_wallpaper`, `general_anime`, `ai_drawing`, `bq`, `furry` | （可选）指定图片主类别。  **支持的主类别：** - `acg`（二次元动漫，UapiPro服务器） - `landscape`（风景图，外部图床） - `anime`（混合动漫） - `pc_wallpaper`（电脑壁纸，外部图床） - `mobile_wallpaper`（手机壁纸，外部图床） - `general_anime`（动漫图，外部图床） - `ai_drawing`（AI绘画，外部图床） - `bq`（表情包/趣图，UapiPro服务器） - `furry`（福瑞，UapiPro服务器）  > [!TIP] > 如果不指定，将从所有图片中随机抽取（不包含 `ikun` 和 `ai_drawing`）。  | [Optional] [Defaults to `undefined`] [Enum: acg, landscape, anime, pc_wallpaper, mobile_wallpaper, general_anime, ai_drawing, bq, furry] |
+| **type** | `pc`, `mb`, `eciyuan`, `ikun`, `4k`, `s4k`, `z4k`, `szs8k`, `xiongmao`, `maomao`, `waiguoren` | （可选，仅UapiPro服务器图片支持）指定图片子类别。  - **bq**: `xiongmao`, `waiguoren`, `maomao`, `ikun`, `eciyuan` - **acg**: `pc`, `mb` - **furry**: `z4k`, `szs8k`, `s4k`, `4k`  > [!TIP] > 外部图床类别和 `anime` 混合类别不支持 `type` 参数。  | [Optional] [Defaults to `undefined`] [Enum: pc, mb, eciyuan, ikun, 4k, s4k, z4k, szs8k, xiongmao, maomao, waiguoren] |
 
 ### Return type
 
@@ -145,8 +145,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | �ɹ����ʣ�ֱ�ӷ��� JPEG ��ʽ��ͼƬ���������ݣ�Ĭ�� Content-Type Ϊ image/jpeg�� |  -  |
-| **302** | 成功！你的客户端将会被重定向到一张随机图片的URL。 |  -  |
+| **200** | 成功！将随机图片以图片二进制 (image/jpeg) 直接返回给客户端，可直接在 <img> 标签中使用。 |  -  |
 | **404** | 未找到指定类别的图片。 |  -  |
 | **500** | 服务器内部错误。 |  -  |
 
@@ -157,7 +156,7 @@ No authorization required
 
 > GetRandomString200Response getRandomString(length, type)
 
-生成高度可定制的随机字符串
+随机字符串
 
 无论是需要生成一个安全的随机密码、一个唯一的Token，还是一个简单的随机ID，这个接口都能满足你。  ## 功能概述 你可以精确地控制生成字符串的长度和字符集类型，非常灵活。  ## 使用须知  > [!TIP] > **字符集类型 `type` 详解** > 你可以通过 `type` 参数精确控制生成的字符集： > - **`numeric`**: 纯数字 (0-9) > - **`lower`**: 纯小写字母 (a-z) > - **`upper`**: 纯大写字母 (A-Z) > - **`alpha`**: 大小写字母 (a-zA-Z) > - **`alphanumeric`** (默认): 数字和大小写字母 (0-9a-zA-Z) > - **`hex`**: 十六进制字符 (0-9a-f)
 
@@ -229,7 +228,7 @@ No authorization required
 
 > PostAnswerbookAsk200Response postAnswerbookAsk(postAnswerbookAskRequest)
 
-获取答案之书的神秘答案 (POST)
+答案之书 (POST)
 
 通过POST请求向答案之书提问并获得神秘答案。  ## 功能概述 与GET方式相同，但通过JSON请求体发送问题，适合在需要发送较长问题或希望避免URL编码问题的场景中使用。  ## 请求体格式 请求体必须是有效的JSON格式，包含question字段。
 
@@ -247,7 +246,7 @@ async function example() {
   const api = new RandomApi();
 
   const body = {
-    // PostAnswerbookAskRequest | 包含问题的JSON对象
+    // PostAnswerbookAskRequest | 
     postAnswerbookAskRequest: ...,
   } satisfies PostAnswerbookAskOperationRequest;
 
@@ -268,7 +267,7 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **postAnswerbookAskRequest** | [PostAnswerbookAskRequest](PostAnswerbookAskRequest.md) | 包含问题的JSON对象 | |
+| **postAnswerbookAskRequest** | [PostAnswerbookAskRequest](PostAnswerbookAskRequest.md) |  | |
 
 ### Return type
 

package/internal/docs/SocialApi.md

@@ -4,14 +4,14 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**getGithubRepo**](SocialApi.md#getgithubrepo) | **GET** /github/repo | 获取GitHub仓库信息 |
-| [**getSocialBilibiliArchives**](SocialApi.md#getsocialbilibiliarchives) | **GET** /social/bilibili/archives | 获取Bilibili用户投稿列表 |
-| [**getSocialBilibiliLiveroom**](SocialApi.md#getsocialbilibililiveroom) | **GET** /social/bilibili/liveroom | 获取Bilibili直播间信息 |
-| [**getSocialBilibiliReplies**](SocialApi.md#getsocialbilibilireplies) | **GET** /social/bilibili/replies | 获取Bilibili视频评论 |
-| [**getSocialBilibiliUserinfo**](SocialApi.md#getsocialbilibiliuserinfo) | **GET** /social/bilibili/userinfo | 查询Bilibili用户信息 |
-| [**getSocialBilibiliVideoinfo**](SocialApi.md#getsocialbilibilivideoinfo) | **GET** /social/bilibili/videoinfo | 获取Bilibili视频详细信息 |
-| [**getSocialQqGroupinfo**](SocialApi.md#getsocialqqgroupinfo) | **GET** /social/qq/groupinfo | 获取QQ群名称、头像、简介 |
-| [**getSocialQqUserinfo**](SocialApi.md#getsocialqquserinfo) | **GET** /social/qq/userinfo | 独家获取QQ号头像、昵称 |
+| [**getGithubRepo**](SocialApi.md#getgithubrepo) | **GET** /github/repo | 查询 GitHub 仓库 |
+| [**getSocialBilibiliArchives**](SocialApi.md#getsocialbilibiliarchives) | **GET** /social/bilibili/archives | 查询 B站投稿 |
+| [**getSocialBilibiliLiveroom**](SocialApi.md#getsocialbilibililiveroom) | **GET** /social/bilibili/liveroom | 查询 B站直播间 |
+| [**getSocialBilibiliReplies**](SocialApi.md#getsocialbilibilireplies) | **GET** /social/bilibili/replies | 查询 B站评论 |
+| [**getSocialBilibiliUserinfo**](SocialApi.md#getsocialbilibiliuserinfo) | **GET** /social/bilibili/userinfo | 查询 B站用户 |
+| [**getSocialBilibiliVideoinfo**](SocialApi.md#getsocialbilibilivideoinfo) | **GET** /social/bilibili/videoinfo | 查询 B站视频 |
+| [**getSocialQqGroupinfo**](SocialApi.md#getsocialqqgroupinfo) | **GET** /social/qq/groupinfo | 查询 QQ 群信息 |
+| [**getSocialQqUserinfo**](SocialApi.md#getsocialqquserinfo) | **GET** /social/qq/userinfo | 查询 QQ 信息 |
 
 
 
@@ -19,7 +19,7 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 > GetGithubRepo200Response getGithubRepo(repo)
 
-获取GitHub仓库信息
+查询 GitHub 仓库
 
 需要快速获取一个GitHub仓库的核心信息？这个接口为你聚合了最有价值的数据，避免了多次调用GitHub官方API的麻烦，并且内置了缓存优化，速度更快、更稳定。  ### 聚合高价值数据 一次请求，即可获得以下信息： - **核心指标**: `star`, `fork`, `open_issues` 等关键统计数据。 - **项目详情**: 描述、主页、分支、语言、话题标签、开源协议。 - **参与者信息**: 获取协作者(`collaborators`)和推断的维护者(`maintainers`)列表，包括他们的公开邮箱（如果可用）。  > [!NOTE] > `collaborators` 字段在私有仓库或权限受限时可能为空。`maintainers` 是根据最新提交记录推断的，仅供参考。  ### 性能与稳定性 我们内置了多级缓存，有效避免触发GitHub的API速率限制。对于需要更高请求额度的用户，可以联系我们定制接口。
 
@@ -88,7 +88,7 @@ No authorization required
 
 > GetSocialBilibiliArchives200Response getSocialBilibiliArchives(mid, keywords, orderby, ps, pn)
 
-获取Bilibili用户投稿列表
+查询 B站投稿
 
 想要获取UP主的所有投稿视频？或者想在你的应用里展示创作者的作品集？这个接口能帮你轻松实现。  ## 功能概述 通过用户的 `mid`（用户ID），你可以获取该UP主的投稿视频列表。接口支持关键词搜索、分页加载和多种排序方式，让你能够灵活地展示和分析创作者的内容。  ## 参数说明 - **`mid` (用户ID)**: B站用户的mid，必填参数。 - **`keywords` (搜索关键词)**: 可选，用于在该UP主的投稿中搜索特定关键词。 - **`orderby` (排序方式)**:    - `pubdate`: 按最新发布排序（默认）   - `views`: 按最多播放排序 - **`ps` (每页条数)**: 默认20条。 - **`pn` (页码)**: 默认1，用于分页。  ## 响应体字段说明 - **`total` (总稿件数)**: UP主的投稿总数。 - **`page` (当前页码)**: 当前返回的页码。 - **`size` (每页数量)**: 每页返回的视频数量。 - **`videos` (视频列表)**: 包含当前页的所有视频信息：   - `aid`: 视频的AV号   - `bvid`: 视频的BV号   - `title`: 视频标题   - `cover`: 封面URL   - `duration`: 时长（秒）   - `play_count`: 播放量   - `publish_time`: 发布时间戳   - `create_time`: 创建时间戳   - `state`: 视频状态   - `is_ugc_pay`: 是否付费视频（0=免费，1=付费）   - `is_interactive`: 是否为互动视频
 
@@ -170,7 +170,7 @@ No authorization required
 
 > GetSocialBilibiliLiveroom200Response getSocialBilibiliLiveroom(mid, roomId)
 
-获取Bilibili直播间信息
+查询 B站直播间
 
 想知道你喜欢的主播开播了吗？或者想在你的应用里集成B站直播间状态？这个接口能满足你。  ## 功能概述 这是一个智能接口，你可以用主播的 `mid` (用户ID) 或者直播间的 `room_id` (长号或短号)来查询。它会返回直播间的详细信息，包括是否在直播、标题、封面、人气、分区等。  ## 响应体字段说明 - **`live_status` (直播状态)**: `0` 代表未开播，`1` 代表直播中，`2` 代表轮播中。
 
@@ -240,9 +240,9 @@ No authorization required
 
 > GetSocialBilibiliReplies200Response getSocialBilibiliReplies(oid, sort, ps, pn)
 
-获取Bilibili视频评论
+查询 B站评论
 
-想要分析B站视频的评论区？这个接口可以帮你轻松获取评论数据，包括热门评论和最新评论，还支持分页加载。  ## 功能概述 通过视频的 `oid`（通常就是视频的`aid`），你可以分页获取该视频的评论区内容。你可以指定排序方式和分页参数，来精确地获取你需要的数据。  ## 参数说明 - **`sort` (排序方式)**: `0`=按时间排序, `1`=按点赞数排序, `2`=按回复数排序。默认为按时间排序。  ## 响应体字段说明 - **`hots` (热门评论)**: 仅在请求第一页时，可能会返回热门评论列表。其结构与 `replies` 中的对象一致。 - **`replies` (评论列表)**: 这是一个数组，包含了当前页的评论。其中：   - `root`: 指向根评论的ID。如果评论本身就是根评论，则为 `0`。   - `parent`: 指向该条回复所回复的上一级评论ID。如果评论是根评论，则为 `0`。
+想要分析B站视频的评论区？这个接口可以帮你轻松获取评论数据，包括热门评论和最新评论，还支持分页加载。  ## 功能概述 通过视频的 `oid`（通常就是视频的`aid`），你可以分页获取该视频的评论区内容。你可以指定排序方式和分页参数，来精确地获取你需要的数据。  ## 参数说明 - **`sort` (排序方式)**   - `0` 或 `time`：按时间排序   - `1` 或 `like`：按点赞排序   - `2` 或 `reply`：按回复数排序   - `3` 或 `hot`（也支持 `hottest`、`最热`）：按最热排序  ## 响应体字段说明 - **`hots` (热门评论)**: 仅在请求第一页时，可能会返回热门评论列表。其结构与 `replies` 中的对象一致。 - **`replies` (评论列表)**: 这是一个数组，包含了当前页的评论。其中：   - `root`: 指向根评论的ID。如果评论本身就是根评论，则为 `0`。   - `parent`: 指向该条回复所回复的上一级评论ID。如果评论是根评论，则为 `0`。
 
 ### Example
 
@@ -260,8 +260,8 @@ async function example() {
   const body = {
     // string | 目标评论区的ID。对于视频，这通常就是它的 `aid`。
     oid: 1706416465,
-    // string | 排序方式。`0`=按时间, `1`=按点赞, `2`=按回复。默认为 `0`。 (optional)
-    sort: 1,
+    // string | 排序方式。支持 `0/time`（按时间）、`1/like`（按点赞）、`2/reply`（按回复数）、`3/hot/hottest/最热`（按最热）。默认为 `0/time`。 (optional)
+    sort: hot,
     // string | 每页获取的评论数量，范围是1到20。默认为 `20`。 (optional)
     ps: 5,
     // string | 要获取的页码，从1开始。默认为 `1`。 (optional)
@@ -286,7 +286,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **oid** | `string` | 目标评论区的ID。对于视频，这通常就是它的 `aid`。 | [Defaults to `undefined`] |
-| **sort** | `string` | 排序方式。`0`=按时间, `1`=按点赞, `2`=按回复。默认为 `0`。 | [Optional] [Defaults to `undefined`] |
+| **sort** | `string` | 排序方式。支持 `0/time`（按时间）、`1/like`（按点赞）、`2/reply`（按回复数）、`3/hot/hottest/最热`（按最热）。默认为 `0/time`。 | [Optional] [Defaults to `undefined`] |
 | **ps** | `string` | 每页获取的评论数量，范围是1到20。默认为 `20`。 | [Optional] [Defaults to `undefined`] |
 | **pn** | `string` | 要获取的页码，从1开始。默认为 `1`。 | [Optional] [Defaults to `undefined`] |
 
@@ -316,7 +316,7 @@ No authorization required
 
 > GetSocialBilibiliUserinfo200Response getSocialBilibiliUserinfo(uid)
 
-查询Bilibili用户信息
+查询 B站用户
 
 想在你的应用里集成B站用户资料展示？这个接口可以轻松获取用户的公开信息。  ## 功能概述 通过一个用户的UID（那一串纯数字ID），你可以查询到该用户的昵称、性别、头像、等级、签名等一系列公开的基本信息。
 
@@ -374,7 +374,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 查询成功！返回用户的详细信息。请注意，我们直接透传了B站官方API的返回结构。 |  -  |
+| **200** | 查询成功！返回 B 站用户公开数据。 |  -  |
 | **400** | 缺少uid参数 |  -  |
 | **404** | Bilibili用户不存在 |  -  |
 | **502** | 上游Bilibili API错误或风控 |  -  |
@@ -386,7 +386,7 @@ No authorization required
 
 > GetSocialBilibiliVideoinfo200Response getSocialBilibiliVideoinfo(aid, bvid)
 
-获取Bilibili视频详细信息
+查询 B站视频
 
 想在你的应用里展示B站视频的详细信息吗？无论是封面、标题，还是播放量、UP主信息，这个接口都能一网打尽。  ## 功能概述 通过提供视频的 `aid` 或 `bvid`，你可以获取到该视频的完整元数据，包括多P信息、UP主资料、数据统计等。  ## 响应体字段说明 - **`copyright` (视频类型)**: `1` 代表原创，`2` 代表转载。 - **`owner` (UP主信息)**: 包含 `mid`, `name`, `face` 等UP主的基本资料。 - **`stat` (数据统计)**: 包含了播放、弹幕、评论、点赞、投币、收藏、分享等核心数据。 - **`pages` (分P列表)**: 这是一个数组，包含了视频的每一个分P的信息，即使是单P视频也会有一个元素。
 
@@ -456,9 +456,9 @@ No authorization required
 
 > GetSocialQqGroupinfo200Response getSocialQqGroupinfo(groupId)
 
-获取QQ群名称、头像、简介
+查询 QQ 群信息
 
-想在你的应用里展示QQ群信息？这个接口让你轻松获取群名称、群头像、群简介等公开信息。它能帮你快速构建社群导航站、群聊推荐系统，或是为你的数据分析工具提供可靠的数据源。无论是展示群聊卡片、生成加群链接，还是进行社群数据统计，这个接口都能满足你的需求。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 你只需要提供一个QQ群号（5-12位纯数字），接口就会返回该群的完整公开信息。我们会先验证群号的有效性，确保返回的数据准确可靠。接口的响应速度快，数据结构清晰，非常适合集成到各类应用场景中。  ## 返回数据说明 接口会返回以下QQ群的关键信息： - **群基础信息**: 包括群号、群名称，让你能够准确识别和展示群聊。 - **视觉素材**: 提供群头像URL（标准100x100尺寸），可直接用于在你的界面中展示群聊图标。 - **群介绍资料**: 包含群描述/简介和群标签，帮助用户了解群聊的主题和特色。 - **便捷入口**: 返回加群链接（二维码URL），方便用户一键加入感兴趣的群聊。 - **数据时效**: 提供最后更新时间戳，让你了解数据的新鲜度。  所有返回的数据都遵循标准的JSON格式，字段命名清晰，便于解析和使用。无论你是在做网页端、移动端还是后端服务，都能轻松集成。
+想在你的应用里展示QQ群信息？这个接口让你轻松获取群名称、群头像、群简介、成员数量等详细公开信息。  ## 功能概述 你只需要提供一个QQ群号（5-12位纯数字），接口就会返回该群的完整公开信息。我们会先验证群号的有效性，确保返回的数据准确可靠。接口响应速度快，数据结构清晰，非常适合集成到各类应用场景中。  ## 返回数据说明 接口会返回以下QQ群的关键信息：  ### 基础字段（所有群都有） - **群基础信息**: 包括群号、群名称，让你能够准确识别和展示群聊 - **视觉素材**: 提供群头像URL（支持多种尺寸），可直接用于在你的界面中展示群聊图标 - **群介绍资料**: 包含群描述/简介和群标签，帮助用户了解群聊的主题和特色 - **便捷入口**: 返回加群链接（二维码URL），方便用户一键加入感兴趣的群聊 - **成员统计**: 当前成员数和最大成员数，直观了解群规模 - **数据时效**: 提供最后更新时间戳，让你了解数据的新鲜度  ### 扩展字段（部分群有） - **活跃度**: 活跃成员数量（可选） - **群主信息**: 群主QQ号和UID（可选） - **时间信息**: 建群时间戳和格式化时间（可选） - **群等级**: 群等级数值（可选） - **群公告**: 群公告/简介内容（可选） - **认证信息**: 官方认证类型和说明（可选）  所有返回的数据都遵循标准的JSON格式，字段命名清晰，便于解析和使用。扩展字段仅在数据可用时返回，保持响应体精简。
 
 ### Example
 
@@ -516,8 +516,7 @@ No authorization required
 |-------------|-------------|------------------|
 | **200** | 成功响应，返回QQ群的详细信息 |  -  |
 | **400** | 缺少或无效的group_id参数 |  -  |
-| **404** | QQ群不存在或无法访问 |  -  |
-| **500** | 获取QQ群聊信息失败 |  -  |
+| **404** | QQ群不存在或无法访问（经优化后，此接口遵循RESTful规范，群不存在时返回404而非500） |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
@@ -526,9 +525,9 @@ No authorization required
 
 > GetSocialQqUserinfo200Response getSocialQqUserinfo(qq)
 
-独家获取QQ号头像、昵称
+查询 QQ 信息
 
-这是一个功能丰富的QQ用户信息查询接口，能够获取QQ用户的详细公开信息。  > [!VIP] > 我们在近日优化了此接口，速度应该会更加快了。   ## 功能概述 通过QQ号查询用户的详细信息，包括基础资料、等级信息、VIP状态等。返回的信息丰富全面，适合用于用户画像分析、社交应用集成等场景。  ## 数据字段说明 - **基础信息**: 昵称、个性签名、头像、年龄、性别 - **联系信息**: QQ邮箱、个性域名(QID) - **等级信息**: QQ等级、VIP状态和等级 - **时间信息**: 注册时间、最后更新时间
+这是一个功能丰富的QQ用户信息查询接口，能够获取QQ用户的详细公开信息。  ## 功能概述 通过QQ号查询用户的详细信息，包括基础资料、等级信息、VIP状态等。返回的信息丰富全面，适合用于用户画像分析、社交应用集成等场景。  ## 数据字段说明 - **基础信息**: 昵称、个性签名、头像、年龄、性别 - **联系信息**: QQ邮箱、个性域名(QID) - **等级信息**: QQ等级、VIP状态和等级 - **时间信息**: 注册时间、最后更新时间
 
 ### Example