diff --git a/configs/config.yaml b/configs/config.yaml
index e3387f5..31fb1e0 100644
--- a/configs/config.yaml
+++ b/configs/config.yaml
@@ -58,7 +58,8 @@ jwt:
   refresh_prefix: "refresh:"
   pair_key_mode: "triple"
 
-# Must match Aliyun wyrs.admin.jwt-secret / WYRS_ADMIN_JWT_SECRET (popadmin login).
+# Must match Aliyun WYRS_ADMIN_JWT_SECRET (popadmin login).
+# Prod rejects the jar default "...-production-2025"; set a shared non-default secret.
 admin:
   jwt_secret: "wyrs-admin-jwt-secret-change-in-production-2025"
 
diff --git a/internal/transport/http/docs/openapi.yaml b/internal/transport/http/docs/openapi.yaml
index bc03e65..8df1029 100644
--- a/internal/transport/http/docs/openapi.yaml
+++ b/internal/transport/http/docs/openapi.yaml
@@ -2054,7 +2054,7 @@ paths:
     get:
       tags: [admin-music]
       summary: 分类树（含下架）
-      description: `data.categories` 为总分类树（children 为子分类）。别名 `/api/admin/pop/music/categories`。
+      description: "`data.categories` 为总分类树（children 为子分类）。别名 `/api/admin/pop/music/categories`。"
       operationId: adminListMusicCategories
       security:
         - bearerAuth: []