feat: 支持智能体置顶配置

offline-backend-20260512/backend/app/gateway/routers/skills.py

@@ -7,7 +7,7 @@ import re
 import subprocess
 import sys
 import tempfile
-from datetime import datetime
+from datetime import UTC, datetime
 from pathlib import Path
 from typing import Any
 
@@ -119,6 +119,7 @@ class SkillResponse(BaseModel):
     view_count: int = Field(default=0, description="Number of times the skill has been viewed")
     patch_count: int = Field(default=0, description="Number of times the skill has been patched")
     last_activity_at: datetime | None = Field(default=None, description="Most recent activity timestamp")
+    created_at: datetime | None = Field(default=None, description="Skill creation timestamp when known")
     state: str = Field(default="active", description="Lifecycle state: active, stale, or archived")
     pinned: bool = Field(default=False, description="Whether this skill is pinned (excluded from curation)")
     source: str = Field(default="upload", description="Origin: 'agent' for agent-created, 'upload' for user-uploaded")
@@ -241,8 +242,20 @@ def _skill_to_response(
     from deerflow.skills.usage import get_entry, latest_activity_at
 
     entry = get_entry(skill.name)
+    created_at_str = entry.get("created_at")
     last_at_str = latest_activity_at(skill.name)
+    created_at: datetime | None = None
     last_at: datetime | None = None
+    if created_at_str:
+        try:
+            created_at = datetime.fromisoformat(created_at_str)
+        except Exception:
+            pass
+    if created_at is None:
+        try:
+            created_at = datetime.fromtimestamp(skill.skill_file.stat().st_mtime, tz=UTC)
+        except Exception:
+            pass
     if last_at_str:
         try:
             last_at = datetime.fromisoformat(last_at_str)
@@ -278,6 +291,7 @@ def _skill_to_response(
         view_count=entry.get("view_count", 0),
         patch_count=entry.get("patch_count", 0),
         last_activity_at=last_at,
+        created_at=created_at,
         state=entry.get("state", "active"),
         pinned=entry.get("pinned", False),
         source=entry.get("source", "upload"),
@@ -688,6 +702,17 @@ async def _attach_and_filter_tags(
     return responses
 
 
+def _sort_skill_responses(responses: list[SkillResponse], sort: str) -> list[SkillResponse]:
+    reverse = sort not in {"time_asc", "activity_asc", "name_asc", "usage_asc"}
+    if sort in {"name_asc", "name_desc"}:
+        return sorted(responses, key=lambda r: (r.name or "").lower(), reverse=reverse)
+    if sort in {"usage_desc", "usage_asc"}:
+        return sorted(responses, key=lambda r: int(r.use_count or 0), reverse=reverse)
+    if sort in {"activity_desc", "activity_asc"}:
+        return sorted(responses, key=lambda r: str(r.last_activity_at or r.created_at or ""), reverse=reverse)
+    return sorted(responses, key=lambda r: str(r.created_at or r.last_activity_at or ""), reverse=reverse)
+
+
 @router.get(
     "/skills",
     response_model=SkillsListResponse,
@@ -701,6 +726,11 @@ async def list_skills(
     tag_store: TagStore = Depends(get_tag_store),
     search: str | None = Query(default=None, description="Case-insensitive fuzzy match on skill name"),
     tag_ids: list[str] | None = Query(default=None, description="Keep skills carrying any of these tags (OR)"),
+    sort: str = Query(
+        default="time_desc",
+        pattern="^(time_desc|time_asc|activity_desc|activity_asc|usage_desc|usage_asc|name_asc|name_desc)$",
+        description="Sort order. Default is newest created/modified first.",
+    ),
     admin: bool = Query(
         default=False,
         description=(
@@ -754,6 +784,7 @@ async def list_skills(
                 )
             )
         responses = await _attach_and_filter_tags(tag_store, responses, search, tag_ids)
+        responses = _sort_skill_responses(responses, sort)
         return SkillsListResponse(skills=responses)
     except HTTPException:
         raise