feat(frontend):优化前端页面设计

kilostar/api/resource.py

@@ -24,8 +24,7 @@ resource_router = APIRouter(prefix="/api/v1/resource")
 
 
 class Skill(BaseModel):
-    """Skill 核心组件类。
-    这是一个领域数据模型或功能封装类，承载了 Skill 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+    """``POST /skill`` 入参：技能仓库地址及可选子目录路径。"""
 
     repo_url: str
     path: str | None
@@ -35,10 +34,7 @@ class Skill(BaseModel):
 async def install_skill(
     skill: Skill, _: TokenData = Depends(RoleChecker(allowed_roles=UserAuthority.USER))
 ):
-    """处理针对 install skill 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        skill (Skill): 参与 install skill 逻辑运算或数据构建的上下文依赖对象。        _ (TokenData): 参与 install skill 逻辑运算或数据构建的上下文依赖对象。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """通过 viceroy 把 skill 仓库克隆到 ``plugin/skill``，并在状态机中登记。"""
     global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
     # noinspection PyUnresolvedReferences
     import os
@@ -62,10 +58,7 @@ async def install_skill(
 async def get_skills(
     _: TokenData = Depends(RoleChecker(allowed_roles=UserAuthority.USER)),
 ):
-    """处理针对 get skills 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        _ (TokenData): 参与 get skills 逻辑运算或数据构建的上下文依赖对象。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """返回当前状态机中已登记的所有 skill 名称列表。"""
     global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
     skills = await global_state_machine.get_skill_list.remote()
     return {"skills": skills}
@@ -78,10 +71,7 @@ async def delete_skill(
         RoleChecker(allowed_roles=UserAuthority.SUPER_ADMINISTRATOR)
     ),
 ):
-    """处理针对 delete skill 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        skill_name (str): 赋予该实体的人类可读名称或标题字符串，主要用于前端 UI 展示、日志记录或模糊检索。        _ (TokenData): 参与 delete skill 逻辑运算或数据构建的上下文依赖对象。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """从状态机中移除 skill 注册项；不会删除磁盘上的代码文件。"""
     global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
     # Note: this only removes it from the state machine manager.
     await global_state_machine.remove_skill.remote(skill_name)
@@ -92,10 +82,7 @@ async def delete_skill(
 async def get_tools(
     _: TokenData = Depends(RoleChecker(allowed_roles=UserAuthority.USER)),
 ):
-    """处理针对 get tools 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        _ (TokenData): 参与 get tools 逻辑运算或数据构建的上下文依赖对象。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """汇总各作用域 tool_mapper，返回去重后的工具名称列表。"""
     global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
     tool_mapper = await global_state_machine.get_tool_mapper.remote()
     all_tool_names = set()