chore(release): publish v0.1.10

Author: shuakami

README.md

@@ -1,6 +1,6 @@
 # uapi-sdk-python
 
-![Banner](https://raw.githubusercontent.com/uapis/uapi-sdk-python/main/banner.png)
+![Banner](https://raw.githubusercontent.com/AxT-Team/uapi-sdk-python/main/banner.png)
 
 [![Python](https://img.shields.io/badge/Python-3.9+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
 [![Docs](https://img.shields.io/badge/Docs-uapis.cn-2EAE5D?style=flat-square)](https://uapis.cn/)

internal/.openapi-generator/FILES

@@ -4,14 +4,14 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
-[**get_convert_unixtime**](ConvertApi.md#get_convert_unixtime) | **GET** /convert/unixtime | Unix时间戳与日期字符串双向转换
-[**post_convert_json**](ConvertApi.md#post_convert_json) | **POST** /convert/json | 美化并格式化JSON字符串
+[**get_convert_unixtime**](ConvertApi.md#get_convert_unixtime) | **GET** /convert/unixtime | 时间戳转换
+[**post_convert_json**](ConvertApi.md#post_convert_json) | **POST** /convert/json | JSON 格式化
 
 
 # **get_convert_unixtime**
 > GetConvertUnixtime200Response get_convert_unixtime(time)
 
-Unix时间戳与日期字符串双向转换
+时间戳转换
 
 时间戳和日期字符串，哪个用着更顺手？别纠结了，这个接口让你轻松拥有两种格式！
 
@@ -53,7 +53,7 @@ with uapi.ApiClient(configuration) as api_client:
     time = '1698380645' # str | 一个智能时间参数，可传入Unix时间戳（10位或13位）或标准日期字符串（如 '2023-10-27 10:30:00'），系统将自动识别并转换。
 
     try:
-        # Unix时间戳与日期字符串双向转换
+        # 时间戳转换
         api_response = api_instance.get_convert_unixtime(time)
         print("The response of ConvertApi->get_convert_unixtime:\n")
         pprint(api_response)
@@ -95,7 +95,7 @@ No authorization required
 # **post_convert_json**
 > PostConvertJson200Response post_convert_json(post_convert_json_request)
 
-美化并格式化JSON字符串
+JSON 格式化
 
 还在为一团乱麻的 JSON 字符串头疼吗？这个接口能瞬间让它变得井井有条，赏心悦目。
 
@@ -134,7 +134,7 @@ with uapi.ApiClient(configuration) as api_client:
     post_convert_json_request = uapi.PostConvertJsonRequest() # PostConvertJsonRequest | 这是一个JSON对象，里面必须包含一个名为 `content` 的字段。这个字段的值，就是你希望格式化的、原始的JSON字符串。
 
     try:
-        # 美化并格式化JSON字符串
+        # JSON 格式化
         api_response = api_instance.post_convert_json(post_convert_json_request)
         print("The response of ConvertApi->post_convert_json:\n")
         pprint(api_response)

internal/README.md

@@ -4,13 +4,13 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
-[**get_daily_news_image**](DailyApi.md#get_daily_news_image) | **GET** /daily/news-image | 生成每日新闻摘要图片
+[**get_daily_news_image**](DailyApi.md#get_daily_news_image) | **GET** /daily/news-image | 每日新闻图
 
 
 # **get_daily_news_image**
 > bytearray get_daily_news_image()
 
-生成每日新闻摘要图片
+每日新闻图
 
 想用一张图快速了解天下大事？这个接口为你一键生成今日新闻摘要，非常适合用在早报、数字看板或应用首页等场景。
 
@@ -48,7 +48,7 @@ with uapi.ApiClient(configuration) as api_client:
     api_instance = uapi.DailyApi(api_client)
 
     try:
-        # 生成每日新闻摘要图片
+        # 每日新闻图
         api_response = api_instance.get_daily_news_image()
         print("The response of DailyApi->get_daily_news_image:\n")
         pprint(api_response)

internal/docs/ConvertApi.md

@@ -4,8 +4,8 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
-[**get_search_engines**](DefaultApi.md#get_search_engines) | **GET** /search/engines | 获取搜索引擎信息
-[**get_sensitive_word_analyze_query**](DefaultApi.md#get_sensitive_word_analyze_query) | **GET** /sensitive-word/analyze-query | 查询参数分析
+[**get_search_engines**](DefaultApi.md#get_search_engines) | **GET** /search/engines | 搜索引擎配置
+[**get_sensitive_word_analyze_query**](DefaultApi.md#get_sensitive_word_analyze_query) | **GET** /sensitive-word/analyze-query | 敏感词分析 (GET)
 [**post_search_aggregate**](DefaultApi.md#post_search_aggregate) | **POST** /search/aggregate | 智能搜索
 [**post_sensitive_word_analyze**](DefaultApi.md#post_sensitive_word_analyze) | **POST** /sensitive-word/analyze | 分析敏感词
 [**post_sensitive_word_quick_check**](DefaultApi.md#post_sensitive_word_quick_check) | **POST** /text/profanitycheck | 敏感词检测（快速）
@@ -14,7 +14,7 @@ Method | HTTP request | Description
 # **get_search_engines**
 > GetSearchEngines200Response get_search_engines()
 
-获取搜索引擎信息
+搜索引擎配置
 
 获取 UAPI Pro Search 引擎的详细信息，包括支持的功能特性、参数限制和使用说明。
 
@@ -50,7 +50,7 @@ with uapi.ApiClient(configuration) as api_client:
     api_instance = uapi.DefaultApi(api_client)
 
     try:
-        # 获取搜索引擎信息
+        # 搜索引擎配置
         api_response = api_instance.get_search_engines()
         print("The response of DefaultApi->get_search_engines:\n")
         pprint(api_response)
@@ -88,7 +88,7 @@ No authorization required
 # **get_sensitive_word_analyze_query**
 > PostSensitiveWordAnalyze200Response get_sensitive_word_analyze_query(keyword)
 
-查询参数分析
+敏感词分析 (GET)
 
 通过URL查询参数分析单个关键词，便于GET请求调用。
 
@@ -115,7 +115,7 @@ with uapi.ApiClient(configuration) as api_client:
     keyword = '喵' # str | 要分析的关键词，最长50字符。
 
     try:
-        # 查询参数分析
+        # 敏感词分析 (GET)
         api_response = api_instance.get_sensitive_word_analyze_query(keyword)
         print("The response of DefaultApi->get_sensitive_word_analyze_query:\n")
         pprint(api_response)
@@ -164,10 +164,12 @@ No authorization required
 
 ## 功能概述
 
-UAPI Pro Search 是自研的智能搜索引擎，采用机器学习算法对搜索结果进行智能排序，确保最相关的内容排在前面。你可以用它搜索任何关键词，也可以限定在特定网站或特定文件类型中搜索。
+UAPI Pro Search 是一个智能搜索引擎，采用机器学习算法对搜索结果进行智能排序，确保最相关的内容排在前面。你可以用它搜索任何关键词，也可以限定在特定网站或特定文件类型中搜索。
 
 - **实时网页搜索**: 毫秒级响应，快速返回搜索结果
 - **智能排序**: 采用机器学习回归排序算法，结果更精准
+- **时间排序**: 支持按发布时间排序，获取最新内容
+- **时间范围过滤**: 支持按天/周/月/年过滤结果
 - **站内搜索**: 支持 `site:` 操作符，在指定网站内搜索
 - **文件类型过滤**: 支持 `filetype:` 操作符，快速找到 PDF、Word 等特定格式文件
 
@@ -246,7 +248,7 @@ No authorization required
 
 分析敏感词
 
-分析单个或多个关键词的敏感程度，返回详细的风险评分和分析结果。
+分析单个或多个关键词的敏感程度，返回标准化风险标签与置信度结果。
 
 > [!VIP]
 > 本API基于先进的分析模型，提供三级缓存策略和并发处理能力。
@@ -256,30 +258,19 @@ No authorization required
 - **模型驱动**: 使用先进的分析模型进行语义分析。
 - **高性能**: 采用三级缓存策略（持久化存储 → 统一缓存 → 模型分析），确保高频请求的响应速度。
 - **并发支持**: 支持批量并发处理，单次最多可分析100个关键词。
-- **详细评分**: 提供色情、辱骂、暴力三个维度的详细风险评分。
-- **变体识别**: 能够自动识别关键词的常见变体形式，如拼音、缩写等。
-
-## 风险评分说明
-
-返回的 `s` 字段包含三个维度的风险评分，范围均为0.0至1.0：
-
-- **s[0] - 色情风险**: 评估内容涉及色情信息的程度。
-- **s[1] - 辱骂/仇恨言论风险**: 评估内容是否包含侮辱性或仇恨性言论。
-- **s[2] - 暴力/威胁风险**: 评估内容是否涉及暴力或威胁信息。
-
-风险等级可参考：0.0-0.3为低风险，0.3-0.7为中等风险，0.7-1.0为高风险。
+- **标准标签**: 返回 `label` 字段，明确区分 `sensitive` 与 `normal`。
+- **分类清晰**: 返回 `category` 字段，用于标识具体风险类别。
+- **置信度输出**: 返回 `confidence` 字段，范围为0.0到1.0。
 
 ## 响应字段说明
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `results` | array | 分析结果对象的数组。 |
 | `results[].k` | string | 您在请求中提供的原始关键词。 |
-| `results[].r` | string | 模型对该关键词的分析过程和判断理由的简要说明。 |
-| `results[].s` | array[float] | 一个包含三个浮点数的数组，分别代表[色情, 辱骂, 暴力]三个维度的风险评分。分值范围从0.0到1.0，越高代表风险越大。 |
-| `results[].v` | array[string] | 模型识别出的该关键词的常见变体形式，例如拼音、谐音、缩写等。 |
-| `results[].t` | array[string] | 根据分析结果为关键词附加的分类标签，便于进行程序化处理和过滤。 |
-| `results[].d` | string | 对整体分析结果的一句简短总结，适合直接展示给用户或记录在日志中。 |
+| `results[].label` | string | 核心判断字段：`sensitive`(敏感)、`normal`(正常)。 |
+| `results[].category` | string | 风险分类：`safe`(安全)、`threat`(威胁)、`porn`(色情)、`fraud`(欺诈)、`insult`(辱骂)。 |
+| `results[].confidence` | number | 当前分类的置信度，范围0.0到1.0。 |
 | `total` | integer | 本次请求成功分析的关键词总数。 |
       
 

internal/docs/DailyApi.md

@@ -4,17 +4,17 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
-[**get_game_epic_free**](GameApi.md#get_game_epic_free) | **GET** /game/epic-free | 获取Epic Games免费游戏
-[**get_game_minecraft_historyid**](GameApi.md#get_game_minecraft_historyid) | **GET** /game/minecraft/historyid | 查询Minecraft玩家历史用户名
-[**get_game_minecraft_serverstatus**](GameApi.md#get_game_minecraft_serverstatus) | **GET** /game/minecraft/serverstatus | 查询Minecraft服务器状态
-[**get_game_minecraft_userinfo**](GameApi.md#get_game_minecraft_userinfo) | **GET** /game/minecraft/userinfo | 查询Minecraft玩家信息
-[**get_game_steam_summary**](GameApi.md#get_game_steam_summary) | **GET** /game/steam/summary | 获取Steam用户公开摘要
+[**get_game_epic_free**](GameApi.md#get_game_epic_free) | **GET** /game/epic-free | Epic 免费游戏
+[**get_game_minecraft_historyid**](GameApi.md#get_game_minecraft_historyid) | **GET** /game/minecraft/historyid | 查询 MC 曾用名
+[**get_game_minecraft_serverstatus**](GameApi.md#get_game_minecraft_serverstatus) | **GET** /game/minecraft/serverstatus | 查询 MC 服务器
+[**get_game_minecraft_userinfo**](GameApi.md#get_game_minecraft_userinfo) | **GET** /game/minecraft/userinfo | 查询 MC 玩家
+[**get_game_steam_summary**](GameApi.md#get_game_steam_summary) | **GET** /game/steam/summary | 查询 Steam 用户
 
 
 # **get_game_epic_free**
 > GetGameEpicFree200Response get_game_epic_free()
 
-获取Epic Games免费游戏
+Epic 免费游戏
 
 白嫖党的福音来了！想第一时间知道Epic商店本周送了哪些游戏大作吗？
 
@@ -53,7 +53,7 @@ with uapi.ApiClient(configuration) as api_client:
     api_instance = uapi.GameApi(api_client)
 
     try:
-        # 获取Epic Games免费游戏
+        # Epic 免费游戏
         api_response = api_instance.get_game_epic_free()
         print("The response of GameApi->get_game_epic_free:\n")
         pprint(api_response)
@@ -90,19 +90,25 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **get_game_minecraft_historyid**
-> GetGameMinecraftHistoryid200Response get_game_minecraft_historyid(uuid)
+> GetGameMinecraftHistoryid200Response get_game_minecraft_historyid(name=name, uuid=uuid)
 
-查询Minecraft玩家历史用户名
+查询 MC 曾用名
 
 想知道某个大佬以前叫什么名字吗？这个接口可以帮你追溯一个 Minecraft 玩家的“黑历史”！
 
 ## 功能概述
-通过提供一个玩家的 UUID，你可以获取到该玩家所有曾用名及其变更时间的列表。这对于识别回归的老玩家或者社区管理非常有用。
+通过提供玩家的用户名或 UUID，你可以获取到该玩家所有曾用名及其变更时间的列表。这对于识别回归的老玩家或者社区管理非常有用。
 
 ## 使用须知
 > [!NOTE]
-> **UUID 格式**
-> 查询时，请务必提供玩家的 **32位无破折号** Minecraft UUID，例如 `ee9b4ed1aac1491eb7611471be374b80`。
+> **参数说明**
+> - `name` 和 `uuid` 二选一
+> - UUID 支持带连字符（如 `ee9b4ed1-aac1-491e-b761-1471be374b80`）或不带连字符格式
+
+> [!IMPORTANT]
+> **响应结构差异**
+> - 使用 `uuid` 查询：返回单个用户的历史记录
+> - 使用 `name` 查询：返回所有匹配用户的列表（包括当前用户名或曾用名匹配的玩家），需判断响应中是否有 `results` 字段来区分两种模式
 
 ### Example
 
@@ -124,11 +130,12 @@ configuration = uapi.Configuration(
 with uapi.ApiClient(configuration) as api_client:
     # Create an instance of the API class
     api_instance = uapi.GameApi(api_client)
-    uuid = 'ee9b4ed1aac1491eb7611471be374b80' # str | 玩家的 Minecraft UUID，请务必使用32位无破折号的格式。
+    name = 'ExamplePlayer' # str | 玩家的 Minecraft 用户名。使用此参数查询时，会返回所有匹配用户的列表（包括当前用户名或曾用名匹配的玩家）。 (optional)
+    uuid = 'ee9b4ed1-aac1-491e-b761-1471be374b80' # str | 玩家的 Minecraft UUID，支持带连字符或不带连字符格式。 (optional)
 
     try:
-        # 查询Minecraft玩家历史用户名
-        api_response = api_instance.get_game_minecraft_historyid(uuid)
+        # 查询 MC 曾用名
+        api_response = api_instance.get_game_minecraft_historyid(name=name, uuid=uuid)
         print("The response of GameApi->get_game_minecraft_historyid:\n")
         pprint(api_response)
     except Exception as e:
@@ -142,7 +149,8 @@ with uapi.ApiClient(configuration) as api_client:
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **uuid** | **str**| 玩家的 Minecraft UUID，请务必使用32位无破折号的格式。 | 
+ **name** | **str**| 玩家的 Minecraft 用户名。使用此参数查询时，会返回所有匹配用户的列表（包括当前用户名或曾用名匹配的玩家）。 | [optional] 
+ **uuid** | **str**| 玩家的 Minecraft UUID，支持带连字符或不带连字符格式。 | [optional] 
 
 ### Return type
 
@@ -161,17 +169,17 @@ No authorization required
 
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-**200** | 查询成功！返回该玩家的完整用户名历史记录。 |  -  |
-**400** | 请求失败。请检查你是否提供了 `uuid` 参数，以及它的格式是否为32位无破折号字符串。 |  -  |
+**200** | 查询成功！根据查询方式返回不同结构： - **uuid 查询**：返回单个用户的历史记录 - **name 查询**：返回匹配用户列表（判断响应中是否有 `results` 字段来区分） |  -  |
+**400** | 请求失败。请检查你是否提供了 `name` 或 `uuid` 参数中的至少一个。 |  -  |
 **404** | 用户未找到。我们根据你提供的 UUID 未能找到对应的 Minecraft 玩家。请确认 UUID 是否正确。 |  -  |
-**502** | 上游服务错误。在向 Mojang 的官方 API 请求数据时遇到了问题。这可能是他们的服务暂时中断，请稍后重试。 |  -  |
+**502** | 服务暂时不可用，请稍后重试。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **get_game_minecraft_serverstatus**
 > GetGameMinecraftServerstatus200Response get_game_minecraft_serverstatus(server)
 
-查询Minecraft服务器状态
+查询 MC 服务器
 
 想在加入服务器前看看有多少人在线？或者检查一下服务器开没开？用这个接口就对了！
 
@@ -201,7 +209,7 @@ with uapi.ApiClient(configuration) as api_client:
     server = 'hypixel.net' # str | Minecraft服务器的地址，可以是域名（如 `hypixel.net`）或 `IP:端口` 的形式（如 `mc.example.com:25565`）。如果省略端口，将默认使用 `25565`。
 
     try:
-        # 查询Minecraft服务器状态
+        # 查询 MC 服务器
         api_response = api_instance.get_game_minecraft_serverstatus(server)
         print("The response of GameApi->get_game_minecraft_serverstatus:\n")
         pprint(api_response)
@@ -245,7 +253,7 @@ No authorization required
 # **get_game_minecraft_userinfo**
 > GetGameMinecraftUserinfo200Response get_game_minecraft_userinfo(username)
 
-查询Minecraft玩家信息
+查询 MC 玩家
 
 只需要一个玩家的用户名，就能快速获取到他的正版皮肤和独一无二的UUID！
 
@@ -275,7 +283,7 @@ with uapi.ApiClient(configuration) as api_client:
     username = 'Notch' # str | 玩家的 Minecraft 游戏内名称（正版ID）。
 
     try:
-        # 查询Minecraft玩家信息
+        # 查询 MC 玩家
         api_response = api_instance.get_game_minecraft_userinfo(username)
         print("The response of GameApi->get_game_minecraft_userinfo:\n")
         pprint(api_response)
@@ -319,7 +327,7 @@ No authorization required
 # **get_game_steam_summary**
 > GetGameSteamSummary200Response get_game_steam_summary(steamid=steamid, id=id, id3=id3, key=key)
 
-获取Steam用户公开摘要
+查询 Steam 用户
 
 想在你的网站或应用中展示用户的 Steam 个人资料？这个接口就是为你准备的。
 
@@ -370,7 +378,7 @@ with uapi.ApiClient(configuration) as api_client:
     key = 'key_example' # str | 你的 Steam Web API Key。这是一个可选参数，如果提供，它将覆盖我们在后端配置的全局Key。这为你提供了更大的灵活性，但请务必注意Key的保密，不要在前端暴露。 (optional)
 
     try:
-        # 获取Steam用户公开摘要
+        # 查询 Steam 用户
         api_response = api_instance.get_game_steam_summary(steamid=steamid, id=id, id3=id3, key=key)
         print("The response of GameApi->get_game_steam_summary:\n")
         pprint(api_response)

internal/docs/DefaultApi.md

@@ -5,7 +5,6 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**code** | **int** |  | [optional] 
 **message** | **str** |  | [optional] 
 **data** | [**GetAiTranslateLanguages200ResponseData**](GetAiTranslateLanguages200ResponseData.md) |  | [optional] 
 **performance** | [**GetAiTranslateLanguages200ResponsePerformance**](GetAiTranslateLanguages200ResponsePerformance.md) |  | [optional] 

internal/docs/GameApi.md

@@ -5,7 +5,6 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**code** | **int** |  | [optional] 
 **question** | **str** |  | [optional] 
 **answer** | **str** |  | [optional] 
 

internal/docs/GetAiTranslateLanguages200Response.md

@@ -5,7 +5,6 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**code** | **int** | 状态码，200代表操作成功。 | [optional] 
 **datetime** | **str** | 标准格式（YYYY-MM-DD HH:mm:ss）的日期时间字符串。 | [optional] 
 **timestamp** | **int** | 转换后的10位秒级Unix时间戳。 | [optional]