feat(usage): /admin/usage 错误请求新增分类过滤

- 后端 GetErrorLogs/ListRequestErrors 新增 category 参数,复用 CategoryToFilter 反查映射,与 phase 可叠加
- UsageFilters errors 模式插入分类下拉(选项同用户端,other 不可反查不列),error_category 随 filters 透传

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: DaydreamCoding

backend/internal/handler/admin/ops_handler.go

@@ -127,6 +127,14 @@ func (h *OpsHandler) GetErrorLogs(c *gin.Context) {
 		filter.Phase = ""
 	}
 
+	// 分类(用户侧粗分类码)→ phase/type ANY 条件,与用户端 /usage/errors 同一映射;
+	// 未知分类返回空切片 = 不过滤。与 phase 参数可同时设置(AND 语义)。
+	if cat := strings.TrimSpace(c.Query("category")); cat != "" {
+		phases, types := service.CategoryToFilter(cat)
+		filter.ErrorPhasesAny = phases
+		filter.ErrorTypesAny = types
+	}
+
 	if platform := strings.TrimSpace(c.Query("platform")); platform != "" {
 		filter.Platform = platform
 	}
@@ -249,6 +257,14 @@ func (h *OpsHandler) ListRequestErrors(c *gin.Context) {
 		filter.Phase = ""
 	}
 
+	// 分类(用户侧粗分类码)→ phase/type ANY 条件,与用户端 /usage/errors 同一映射;
+	// 未知分类返回空切片 = 不过滤。与 phase 参数可同时设置(AND 语义)。
+	if cat := strings.TrimSpace(c.Query("category")); cat != "" {
+		phases, types := service.CategoryToFilter(cat)
+		filter.ErrorPhasesAny = phases
+		filter.ErrorTypesAny = types
+	}
+
 	if platform := strings.TrimSpace(c.Query("platform")); platform != "" {
 		filter.Platform = platform
 	}

frontend/src/api/admin/ops.ts

@@ -1098,6 +1098,8 @@ export type OpsErrorListQueryParams = {
   model?: string
 
   phase?: string
+  // 分类(用户侧粗分类码,如 auth/rate_limit/upstream),后端反查为 phase/type ANY 条件
+  category?: string
   error_owner?: string
   error_source?: string
   resolved?: string

frontend/src/api/admin/usage.ts

@@ -88,6 +88,7 @@ export interface AdminUsageQueryParams extends UsageQueryParams {
   sort_order?: 'asc' | 'desc'
   // 错误请求 tab 专属筛选(仅传给错误列表接口;共用同一 filters 对象)
   error_phase?: string | null
+  error_category?: string | null
   status_code?: number | null
 }
 

frontend/src/components/admin/usage/UsageFilters.vue

@@ -145,6 +145,12 @@
           <Select v-model="filters.error_phase" :options="errorPhaseOptions" @change="emitChange" />
         </div>
 
+        <!-- Error Category Filter (errors only) -->
+        <div v-if="mode === 'errors'" class="w-full sm:w-auto sm:min-w-[180px]">
+          <label class="input-label">{{ t('usage.errors.category') }}</label>
+          <Select v-model="filters.error_category" :options="errorCategoryOptions" @change="emitChange" />
+        </div>
+
         <!-- Status Code Filter (errors only) -->
         <div v-if="mode === 'errors'" class="w-full sm:w-auto sm:min-w-[180px]">
           <label class="input-label">{{ t('admin.ops.errorLog.status') }}</label>
@@ -270,6 +276,14 @@ const errorPhaseOptions = computed<SelectOption[]>(() => [
   { value: 'internal', label: t('admin.ops.errorLog.typeInternal') },
 ])
 
+// 分类码同用户端 /usage 错误筛选;"other" 无法反查为过滤条件,刻意不列
+const errorCategoryCodes = ['auth', 'rate_limit', 'quota', 'invalid_request', 'service_unavailable', 'upstream', 'internal', 'cyber']
+
+const errorCategoryOptions = computed<SelectOption[]>(() => [
+  { value: null, label: t('usage.errors.allCategories') },
+  ...errorCategoryCodes.map((c) => ({ value: c, label: t('usage.errors.categories.' + c) })),
+])
+
 const commonErrorStatusCodes = [400, 401, 403, 404, 408, 413, 429, 499, 500, 502, 503, 504, 529]
 
 const statusCodeOptions = computed<SelectOption[]>(() => [

frontend/src/views/admin/UsageView.vue

@@ -732,6 +732,7 @@ const loadAdminErrors = async () => {
       group_id: filters.value.group_id ?? undefined,
       model: filters.value.model || undefined,
       phase: filters.value.error_phase || undefined,
+      category: filters.value.error_category || undefined,
       status_codes: filters.value.status_code != null ? String(filters.value.status_code) : undefined,
       sort_by: errSortBy.value,
       sort_order: errSortOrder.value,