From 1565c4735fc726b3b46e648337f8fe652dee6d53 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=A5=BF=E7=93=9C=C2=B0?= <wxh_email@yeah.net>
Date: Tue, 12 May 2026 18:41:49 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9mcp=E5=8F=82=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 backend/api/routes/openapi.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/backend/api/routes/openapi.py b/backend/api/routes/openapi.py
index 7257e3ac..9cc80e29 100644
--- a/backend/api/routes/openapi.py
+++ b/backend/api/routes/openapi.py
@@ -105,6 +105,10 @@ async def get_cn_skills_by_job(
 ) -> SkillsListResponse:
     """
     获取职业技能列表
+
+    Args:
+        jobId (str): 职业ID，必填参数
+        jobGrowId (str): 转职ID，必填参数
     """
     key = f'openapi:{jobId}:{jobGrowId}:skills'
 
@@ -129,6 +133,12 @@ async def get_cn_skill_info(
 ) -> SkillDetailResponse:
     """
     获取技能详细信息
+
+    Args:
+        jobId (str): 职业ID，必填参数
+        jobGrowId (str): 转职ID，必填参数
+        skillId (str): 技能ID，必填参数
+        level (int, optional): 技能等级，默认为None
     """
     skill_info = {}
     key = f'openapi:{jobId}:{jobGrowId}:{skillId}'
@@ -193,6 +203,11 @@ async def get_skill_data_summary(
 ) -> SkillDataSummaryResponse:
     """
     获取技能数据汇总信息
+
+    Args:
+        job (str): 职业名称，必填参数
+        skills (str, optional): 技能列表字符串，逗号拼接技能名称，不传递或者传递为空时，查询所有技能，默认为''
+        weapons (str, optional): 武器类型列表字符串，逗号拼接武器类型名称，不传递或者传递为空时，查询所有武器类型，默认为''
     """
     job = job.replace('（', '(').replace('）', ')')
     key = f'openapi:skillData:summary:{job}'