hydro-ai-helper 2.3.0 → 2.4.0

package/frontend/admin/ConfigPanel.tsx

@@ -1,7 +1,8 @@
 import React, { useState, useEffect, useCallback } from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import { VersionBadge } from './VersionBadge';
 import { EndpointManager } from './EndpointManager';
+import { ScenarioModelSelector } from './ScenarioModelSelector';
 import { BudgetConfigForm } from './BudgetConfigForm';
 import { JailbreakLogsViewer } from './JailbreakLogsViewer';
 import { TelemetrySettings } from './TelemetrySettings';
@@ -13,8 +14,21 @@ import {
 } from '../utils/styles';
 import type {
   Endpoint, ConfigState, JailbreakLogPagination, APIConfigResponse, TelemetryStatus,
+  AIScenarioKey, SelectedModel, ScenarioModelsState,
 } from './configTypes';
 
+const EMPTY_SCENARIO_MODELS: ScenarioModelsState = {
+  studentChat: [], learningSummary: [], teachingAnalysis: [],
+};
+
+function parseScenarioModels(raw?: Partial<Record<AIScenarioKey, SelectedModel[]>>): ScenarioModelsState {
+  return {
+    studentChat: raw?.studentChat || [],
+    learningSummary: raw?.learningSummary || [],
+    teachingAnalysis: raw?.teachingAnalysis || [],
+  };
+}
+
 interface ConfigPanelProps {
   embedded?: boolean;
 }
@@ -57,6 +71,7 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
       if (json.config == null) {
         setConfig({
           endpoints: [], selectedModels: [],
+          scenarioModels: { ...EMPTY_SCENARIO_MODELS },
           apiBaseUrl: '', modelName: '',
           rateLimitPerMinute: 5, timeoutSeconds: 30,
           systemPromptTemplate: '', extraJailbreakPatternsText: '',
@@ -67,6 +82,7 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
         setConfig({
           endpoints: (json.config.endpoints || []).map((ep) => ({ ...ep, newApiKey: '' })),
           selectedModels: json.config.selectedModels || [],
+          scenarioModels: parseScenarioModels(json.config.scenarioModels),
           apiBaseUrl: json.config.apiBaseUrl || '',
           modelName: json.config.modelName || '',
           rateLimitPerMinute: json.config.rateLimitPerMinute ?? 5,
@@ -131,6 +147,7 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
           apiKey: ep.newApiKey || undefined, models: ep.models, enabled: ep.enabled,
         }));
         body.selectedModels = config.selectedModels;
+        body.scenarioModels = config.scenarioModels;
       } else {
         body.apiBaseUrl = config.apiBaseUrl.trim();
         body.modelName = config.modelName.trim();
@@ -152,6 +169,7 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
         setConfig({
           endpoints: (json.config.endpoints || []).map((ep) => ({ ...ep, newApiKey: '' })),
           selectedModels: json.config.selectedModels || [],
+          scenarioModels: parseScenarioModels(json.config.scenarioModels),
           apiBaseUrl: json.config.apiBaseUrl || '',
           modelName: json.config.modelName || '',
           rateLimitPerMinute: json.config.rateLimitPerMinute ?? 5,
@@ -245,10 +263,17 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
     setConfig(prev => {
       if (!prev) return prev;
       const ep = prev.endpoints[index];
+      const dropEndpoint = (models: typeof prev.selectedModels) =>
+        ep?.id ? models.filter(sm => sm.endpointId !== ep.id) : models;
       return {
         ...prev,
         endpoints: prev.endpoints.filter((_, i) => i !== index),
-        selectedModels: ep?.id ? prev.selectedModels.filter(sm => sm.endpointId !== ep.id) : prev.selectedModels,
+        selectedModels: dropEndpoint(prev.selectedModels),
+        scenarioModels: {
+          studentChat: dropEndpoint(prev.scenarioModels.studentChat),
+          learningSummary: dropEndpoint(prev.scenarioModels.learningSummary),
+          teachingAnalysis: dropEndpoint(prev.scenarioModels.teachingAnalysis),
+        },
       };
     });
   }, []);
@@ -288,6 +313,13 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
     });
   }, []);
 
+  const updateScenarioModels = useCallback((scenario: AIScenarioKey, chain: SelectedModel[]) => {
+    setConfig(prev => {
+      if (!prev) return prev;
+      return { ...prev, scenarioModels: { ...prev.scenarioModels, [scenario]: chain } };
+    });
+  }, []);
+
   const changePage = (newPage: number) => {
     if (newPage < 1 || newPage > logPagination.totalPages) return;
     loadJailbreakLogs(newPage);
@@ -390,6 +422,18 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
           />
         </div>
 
+        {config.endpoints.length > 0 && (
+          <div style={dsCardStyle}>
+            <ScenarioModelSelector
+              endpoints={config.endpoints}
+              globalModels={config.selectedModels}
+              scenarioModels={config.scenarioModels}
+              onChange={updateScenarioModels}
+              disabled={isBusy}
+            />
+          </div>
+        )}
+
         <div style={dsCardStyle}>
           <h2 style={cardTitleStyle}>{i18n('ai_helper_admin_general_settings')}</h2>
           <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '15px' }}>
@@ -401,6 +445,9 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
                 onChange={(e) => setConfig({ ...config, timeoutSeconds: e.target.value === '' ? '' : Number(e.target.value) })}
                 placeholder="30" min="1" disabled={isBusy} style={getInputStyle()}
               />
+              <p style={{ fontSize: '12px', color: COLORS.textMuted, margin: `${SPACING.xs} 0 0` }}>
+                {i18n('ai_helper_config_timeout_hint')}
+              </p>
             </div>
             <div>
               <label style={{ display: 'block', marginBottom: SPACING.xs, fontWeight: 500, color: COLORS.textPrimary }}>{i18n('ai_helper_config_rate_limit_per_minute')}</label>
@@ -408,8 +455,11 @@ export const ConfigPanel: React.FC<ConfigPanelProps> = ({ embedded = false }) =>
                 type="number"
                 value={config.rateLimitPerMinute}
                 onChange={(e) => setConfig({ ...config, rateLimitPerMinute: e.target.value === '' ? '' : Number(e.target.value) })}
-                placeholder="5" min="1" disabled={isBusy} style={getInputStyle()}
+                placeholder="5" min="0" disabled={isBusy} style={getInputStyle()}
               />
+              <p style={{ fontSize: '12px', color: COLORS.textMuted, margin: `${SPACING.xs} 0 0` }}>
+                {i18n('ai_helper_config_rate_limit_hint')}
+              </p>
             </div>
           </div>
         </div>

package/frontend/admin/EndpointManager.tsx

@@ -1,5 +1,5 @@
 import React, { useState } from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import {
   COLORS, SPACING, RADIUS, SHADOWS, TRANSITIONS,
   getInputStyle, getButtonStyle, getBadgeStyle,

package/frontend/admin/FeedbackForm.tsx

@@ -1,5 +1,5 @@
 import React, { useState } from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import {
   COLORS, SPACING, RADIUS, TYPOGRAPHY,
   getInputStyle, getButtonStyle,

package/frontend/admin/JailbreakLogsViewer.tsx

@@ -1,5 +1,5 @@
 import React from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import {
   COLORS, SPACING, RADIUS, TYPOGRAPHY,
   cardStyle, getButtonStyle,

package/frontend/admin/ScenarioModelSelector.tsx

@@ -0,0 +1,238 @@
+import React from 'react';
+import { i18n } from '../utils/i18n';
+import {
+  COLORS, SPACING, RADIUS,
+  getInputStyle, getButtonStyle, getBadgeStyle,
+} from '../utils/styles';
+import type { Endpoint, SelectedModel, AIScenarioKey, ScenarioModelsState } from './configTypes';
+import { AI_SCENARIO_KEYS } from './configTypes';
+
+interface ScenarioModelSelectorProps {
+  endpoints: Endpoint[];
+  /** 全局默认模型链（用于展示"跟随全局"场景当前实际生效的模型） */
+  globalModels: SelectedModel[];
+  scenarioModels: ScenarioModelsState;
+  onChange: (scenario: AIScenarioKey, chain: SelectedModel[]) => void;
+  disabled: boolean;
+}
+
+/** 把模型链概括成 "a → b → c" 的短文本（最多 3 个，多余折叠） */
+function summarizeChain(chain: SelectedModel[]): string {
+  const names = chain.map(sm => sm.modelName);
+  const shown = names.slice(0, 3).join(' → ');
+  return names.length > 3 ? `${shown} → +${names.length - 3}` : shown;
+}
+
+const SCENARIO_META: Record<AIScenarioKey, { labelKey: string; descKey: string; icon: string }> = {
+  studentChat: {
+    labelKey: 'ai_helper_admin_scenario_student_chat',
+    descKey: 'ai_helper_admin_scenario_student_chat_desc',
+    icon: '💬',
+  },
+  learningSummary: {
+    labelKey: 'ai_helper_admin_scenario_learning_summary',
+    descKey: 'ai_helper_admin_scenario_learning_summary_desc',
+    icon: '📝',
+  },
+  teachingAnalysis: {
+    labelKey: 'ai_helper_admin_scenario_teaching_analysis',
+    descKey: 'ai_helper_admin_scenario_teaching_analysis_desc',
+    icon: '📊',
+  },
+};
+
+const OPTION_SEPARATOR = '::';
+
+export const ScenarioModelSelector: React.FC<ScenarioModelSelectorProps> = ({
+  endpoints, globalModels, scenarioModels, onChange, disabled,
+}) => {
+  // 可供选择的 端点×模型 组合（未保存端点的临时 ID 会在保存时由后端重映射为真实 ID）
+  const modelOptions: Array<{ endpointId: string; endpointName: string; modelName: string }> = [];
+  for (const ep of endpoints) {
+    if (!ep.id || !ep.enabled) continue;
+    for (const model of ep.models) {
+      modelOptions.push({ endpointId: ep.id, endpointName: ep.name, modelName: model });
+    }
+  }
+
+  const endpointName = (endpointId: string) =>
+    endpoints.find(e => e.id === endpointId)?.name || i18n('ai_helper_admin_endpoint_unknown');
+
+  const addModel = (scenario: AIScenarioKey, optionValue: string) => {
+    if (!optionValue) return;
+    const sepIndex = optionValue.indexOf(OPTION_SEPARATOR);
+    if (sepIndex <= 0) return;
+    const endpointId = optionValue.slice(0, sepIndex);
+    const modelName = optionValue.slice(sepIndex + OPTION_SEPARATOR.length);
+    const chain = scenarioModels[scenario];
+    if (chain.some(sm => sm.endpointId === endpointId && sm.modelName === modelName)) return;
+    onChange(scenario, [...chain, { endpointId, modelName }]);
+  };
+
+  const removeModel = (scenario: AIScenarioKey, index: number) => {
+    onChange(scenario, scenarioModels[scenario].filter((_, i) => i !== index));
+  };
+
+  const moveModel = (scenario: AIScenarioKey, index: number, direction: 'up' | 'down') => {
+    const chain = [...scenarioModels[scenario]];
+    const ni = direction === 'up' ? index - 1 : index + 1;
+    if (ni < 0 || ni >= chain.length) return;
+    [chain[index], chain[ni]] = [chain[ni], chain[index]];
+    onChange(scenario, chain);
+  };
+
+  return (
+    <div>
+      <h2 style={{ marginTop: 0, marginBottom: SPACING.sm, fontSize: '18px', color: COLORS.textPrimary }}>
+        {i18n('ai_helper_admin_scenario_title')}
+      </h2>
+      <p style={{ fontSize: '13px', color: COLORS.textMuted, marginTop: 0, marginBottom: SPACING.base }}>
+        {i18n('ai_helper_admin_scenario_desc')}
+      </p>
+
+      <div style={{ display: 'flex', flexDirection: 'column', gap: SPACING.md }}>
+        {AI_SCENARIO_KEYS.map((scenario) => {
+          const meta = SCENARIO_META[scenario];
+          const chain = scenarioModels[scenario];
+          const isDefault = chain.length === 0;
+
+          return (
+            <div
+              key={scenario}
+              style={{
+                padding: SPACING.base, backgroundColor: COLORS.bgCard,
+                borderRadius: RADIUS.md, border: `1px solid ${COLORS.border}`,
+              }}
+            >
+              <div style={{ display: 'flex', alignItems: 'center', gap: SPACING.sm, marginBottom: SPACING.xs, flexWrap: 'wrap' }}>
+                <span style={{ fontSize: '16px' }}>{meta.icon}</span>
+                <span style={{ fontSize: '14px', fontWeight: 600, color: COLORS.textPrimary }}>{i18n(meta.labelKey)}</span>
+                {isDefault ? (
+                  <span style={getBadgeStyle('info')}>{i18n('ai_helper_admin_scenario_follow_global')}</span>
+                ) : (
+                  <span style={getBadgeStyle('success')}>{i18n('ai_helper_admin_scenario_custom')}</span>
+                )}
+                {!isDefault && (
+                  <button
+                    onClick={() => onChange(scenario, [])}
+                    disabled={disabled}
+                    style={{
+                      ...getButtonStyle('ghost'),
+                      padding: '2px 8px', fontSize: '12px', marginLeft: 'auto',
+                      cursor: disabled ? 'not-allowed' : 'pointer',
+                    }}
+                  >
+                    {i18n('ai_helper_admin_scenario_reset')}
+                  </button>
+                )}
+              </div>
+              <p style={{ fontSize: '12px', color: COLORS.textMuted, margin: `0 0 ${SPACING.sm}` }}>
+                {i18n(meta.descKey)}
+              </p>
+
+              {isDefault && (
+                <div style={{
+                  fontSize: '12px', marginBottom: SPACING.sm,
+                  color: globalModels.length > 0 ? COLORS.textSecondary : COLORS.warningText,
+                }}>
+                  {globalModels.length > 0
+                    ? i18n('ai_helper_admin_scenario_effective_global', summarizeChain(globalModels))
+                    : i18n('ai_helper_admin_scenario_global_empty')}
+                </div>
+              )}
+
+              {!isDefault && (
+                <div style={{ display: 'flex', flexDirection: 'column', gap: SPACING.xs, marginBottom: SPACING.sm }}>
+                  {chain.map((sm, index) => (
+                    <div
+                      key={`${sm.endpointId}-${sm.modelName}`}
+                      style={{
+                        display: 'flex', alignItems: 'center', padding: `${SPACING.xs} ${SPACING.md}`,
+                        backgroundColor: COLORS.bgPage, borderRadius: RADIUS.sm, border: `1px solid ${COLORS.border}`,
+                      }}
+                    >
+                      <span style={{
+                        width: '20px', height: '20px', borderRadius: '50%',
+                        backgroundColor: COLORS.primaryLight, color: COLORS.primary,
+                        display: 'flex', alignItems: 'center', justifyContent: 'center',
+                        fontSize: '11px', fontWeight: 600, marginRight: SPACING.sm, flexShrink: 0,
+                      }}>
+                        {index + 1}
+                      </span>
+                      <div style={{ flex: 1, minWidth: 0 }}>
+                        <span style={{ fontSize: '13px', fontWeight: 500, color: COLORS.textPrimary }}>{sm.modelName}</span>
+                        <span style={{ fontSize: '12px', color: COLORS.textMuted, marginLeft: SPACING.sm }}>{endpointName(sm.endpointId)}</span>
+                      </div>
+                      <div style={{ display: 'flex', gap: '4px' }}>
+                        <button
+                          onClick={() => moveModel(scenario, index, 'up')}
+                          disabled={disabled || index === 0}
+                          style={{
+                            ...getButtonStyle('ghost'), padding: '2px 6px', fontSize: '12px',
+                            cursor: (disabled || index === 0) ? 'not-allowed' : 'pointer',
+                            opacity: (disabled || index === 0) ? 0.5 : 1,
+                          }}
+                        >
+                          ↑
+                        </button>
+                        <button
+                          onClick={() => moveModel(scenario, index, 'down')}
+                          disabled={disabled || index === chain.length - 1}
+                          style={{
+                            ...getButtonStyle('ghost'), padding: '2px 6px', fontSize: '12px',
+                            cursor: (disabled || index === chain.length - 1) ? 'not-allowed' : 'pointer',
+                            opacity: (disabled || index === chain.length - 1) ? 0.5 : 1,
+                          }}
+                        >
+                          ↓
+                        </button>
+                        <button
+                          onClick={() => removeModel(scenario, index)}
+                          disabled={disabled}
+                          style={{
+                            ...getButtonStyle('danger'), padding: '2px 6px', fontSize: '12px',
+                            cursor: disabled ? 'not-allowed' : 'pointer',
+                          }}
+                        >
+                          ×
+                        </button>
+                      </div>
+                    </div>
+                  ))}
+                </div>
+              )}
+
+              {modelOptions.length > 0 ? (
+                <select
+                  value=""
+                  onChange={(e) => addModel(scenario, e.target.value)}
+                  disabled={disabled}
+                  style={{ ...getInputStyle(), maxWidth: '420px', cursor: disabled ? 'not-allowed' : 'pointer' }}
+                >
+                  <option value="">
+                    {isDefault
+                      ? i18n('ai_helper_admin_scenario_add_model_override')
+                      : i18n('ai_helper_admin_scenario_add_model')}
+                  </option>
+                  {modelOptions.map(opt => (
+                    <option
+                      key={`${opt.endpointId}${OPTION_SEPARATOR}${opt.modelName}`}
+                      value={`${opt.endpointId}${OPTION_SEPARATOR}${opt.modelName}`}
+                      disabled={chain.some(sm => sm.endpointId === opt.endpointId && sm.modelName === opt.modelName)}
+                    >
+                      {opt.modelName} — {opt.endpointName}
+                    </option>
+                  ))}
+                </select>
+              ) : (
+                <div style={{ fontSize: '12px', color: COLORS.textMuted }}>
+                  {i18n('ai_helper_admin_scenario_no_models')}
+                </div>
+              )}
+            </div>
+          );
+        })}
+      </div>
+    </div>
+  );
+};

package/frontend/admin/TelemetrySettings.tsx

@@ -1,5 +1,5 @@
 import React from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import {
   COLORS, SPACING, RADIUS, TYPOGRAPHY,
 } from '../utils/styles';

package/frontend/admin/VersionBadge.tsx

@@ -9,7 +9,7 @@
  */
 
 import React, { useState, useEffect, useRef } from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import { buildApiUrl } from '../utils/domainUtils';
 import {
   COLORS, SPACING, RADIUS, SHADOWS, TRANSITIONS, ANIMATIONS, TYPOGRAPHY, FONT_FAMILY,

package/frontend/admin/configTypes.ts

@@ -16,6 +16,13 @@ export interface SelectedModel {
   modelName: string;
 }
 
+export type AIScenarioKey = 'studentChat' | 'learningSummary' | 'teachingAnalysis';
+
+export const AI_SCENARIO_KEYS: readonly AIScenarioKey[] = ['studentChat', 'learningSummary', 'teachingAnalysis'] as const;
+
+/** 每个场景的专属模型链；空数组 = 跟随全局 selectedModels */
+export type ScenarioModelsState = Record<AIScenarioKey, SelectedModel[]>;
+
 export interface BudgetConfigState {
   dailyTokenLimitPerUser: number | '';
   dailyTokenLimitPerDomain: number | '';
@@ -26,6 +33,7 @@ export interface BudgetConfigState {
 export interface ConfigState {
   endpoints: Endpoint[];
   selectedModels: SelectedModel[];
+  scenarioModels: ScenarioModelsState;
   apiBaseUrl: string;
   modelName: string;
   rateLimitPerMinute: number | '';
@@ -73,6 +81,7 @@ export interface APIConfigResponse {
   config: {
     endpoints?: Array<Omit<Endpoint, 'newApiKey' | 'isNew'> & { apiKeyMasked?: string; hasApiKey?: boolean }>;
     selectedModels?: SelectedModel[];
+    scenarioModels?: Partial<Record<AIScenarioKey, SelectedModel[]>>;
     apiBaseUrl?: string;
     modelName?: string;
     rateLimitPerMinute?: number;

package/frontend/batchSummary/BatchSummaryPanel.tsx

@@ -5,7 +5,7 @@
  */
 
 import React, { useEffect, useState, useCallback, useRef, useMemo } from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import { COLORS, SPACING, RADIUS, SHADOWS, LAYOUT, getButtonStyle, getAlertStyle, markdownTheme } from '../utils/styles';
 
 /** i18n with hardcoded Chinese fallback for keys that may not yet be in lang-*.js */
@@ -29,6 +29,9 @@ const I18N_FALLBACK: Record<string, string> = {
   ai_helper_batch_summary_stats_failed: '失败',
   ai_helper_batch_summary_stats_not_generated: '未生成',
   ai_helper_batch_summary_no_new_students: '所有学生已生成总结，无需补充',
+  ai_helper_batch_summary_publish_done: '已发布 {0} 份总结',
+  ai_helper_batch_summary_publish_skipped_failed: '{0} 名学生生成失败，未发布',
+  ai_helper_batch_summary_publish_skipped_pending: '{0} 名学生尚未生成，未发布',
 };
 function t(key: string): string {
   const val = i18n(key);
@@ -227,6 +230,24 @@ export const BatchSummaryPanel: React.FC<BatchSummaryPanelProps> = ({
     publishAll();
   }, [publishAll]);
 
+  // Publish outcome notice — warns when publishAll skipped failed/pending
+  // students (they would otherwise see a blank tab with no one the wiser).
+  const publishNotice = useMemo(() => {
+    const pr = state.publishResult;
+    if (!pr) return null;
+    const parts = [t('ai_helper_batch_summary_publish_done').replace('{0}', String(pr.published))];
+    if (pr.skippedFailed > 0) {
+      parts.push(t('ai_helper_batch_summary_publish_skipped_failed').replace('{0}', String(pr.skippedFailed)));
+    }
+    if (pr.skippedPending > 0) {
+      parts.push(t('ai_helper_batch_summary_publish_skipped_pending').replace('{0}', String(pr.skippedPending)));
+    }
+    return {
+      text: parts.join(' · '),
+      variant: (pr.skippedFailed + pr.skippedPending > 0 ? 'warning' : 'success') as 'warning' | 'success',
+    };
+  }, [state.publishResult]);
+
   // ── Publish single ──────────────────────────────────────────────────────────
 
   const handlePublishOne = useCallback(async (userId: number) => {
@@ -453,6 +474,13 @@ export const BatchSummaryPanel: React.FC<BatchSummaryPanelProps> = ({
         </div>
       )}
 
+      {/* Publish outcome */}
+      {publishNotice && (
+        <div style={{ ...getAlertStyle(publishNotice.variant), marginBottom: SPACING.base }}>
+          {publishNotice.text}
+        </div>
+      )}
+
       {/* Error */}
       {state.error && (
         <div style={{ ...getAlertStyle('error'), marginBottom: SPACING.base }}>

package/frontend/batchSummary/StudentSummaryView.tsx

@@ -2,17 +2,26 @@
  * StudentSummaryView — read-only view of a student's published AI learning summary.
  * Fetches the current user's published summary for a given contest and renders markdown.
  * Polls every 30s until a published summary is found, then stops.
+ * While nothing is published (or the request fails) it renders an explanatory
+ * placeholder instead of nothing — a blank tab is indistinguishable from a bug
+ * for students, which is exactly how the "无法看到 AI 学习总结" report read.
  */
 
 import React, { useEffect, useState, useRef, useCallback } from 'react';
-import { i18n } from '@hydrooj/ui-default';
-import { COLORS, SPACING, RADIUS, SHADOWS, LAYOUT, markdownTheme } from '../utils/styles';
+import { i18n } from '../utils/i18n';
+import { COLORS, SPACING, RADIUS, SHADOWS, LAYOUT, markdownTheme, emptyStateStyle } from '../utils/styles';
 import { renderMarkdown } from '../utils/markdown';
 
+/** i18n with hardcoded Chinese fallback for keys that may not yet be in lang-*.js */
+const I18N_FALLBACK: Record<string, string> = {
+  ai_helper_batch_summary_my_title: 'AI 学习总结',
+  ai_helper_batch_summary_my_empty: '你的学习总结尚未发布。老师发布后会自动显示在这里。',
+  ai_helper_batch_summary_my_load_failed: '学习总结加载失败，正在自动重试…',
+};
+
 function t(key: string): string {
   const val = i18n(key);
-  if (val === key && key === 'ai_helper_batch_summary_my_title') return 'AI 学习总结';
-  return val;
+  return val === key ? (I18N_FALLBACK[key] || val) : val;
 }
 
 interface StudentSummaryViewProps {
@@ -40,22 +49,29 @@ function buildUrl(domainId: string, path: string): string {
 
 const POLL_INTERVAL = 30000; // 30 seconds
 
+/** Fetch outcome: `failed` distinguishes request errors from "not published yet" */
+interface FetchResult {
+  failed: boolean;
+  summary: string | null;
+}
+
 export const StudentSummaryView: React.FC<StudentSummaryViewProps> = ({ domainId, contestId }) => {
   const [summary, setSummary] = useState<string | null>(null);
   const [loading, setLoading] = useState(true);
+  const [loadFailed, setLoadFailed] = useState(false);
   const timerRef = useRef<ReturnType<typeof setInterval> | null>(null);
 
-  const fetchSummary = useCallback(async () => {
+  const fetchSummary = useCallback(async (): Promise<FetchResult> => {
     try {
       const res = await fetch(buildUrl(domainId, `/my-summary?contestId=${contestId}`), {
         credentials: 'include',
         headers: { 'X-Requested-With': 'XMLHttpRequest' },
       });
-      if (!res.ok) return null;
+      if (!res.ok) return { failed: true, summary: null };
       const data = await res.json();
-      return data.summary?.summary || null;
+      return { failed: false, summary: data.summary?.summary || null };
     } catch {
-      return null;
+      return { failed: true, summary: null };
     }
   }, [domainId, contestId]);
 
@@ -66,17 +82,19 @@ export const StudentSummaryView: React.FC<StudentSummaryViewProps> = ({ domainId
       const result = await fetchSummary();
       if (cancelled) return;
       setLoading(false);
-      if (result) {
-        setSummary(result);
+      setLoadFailed(result.failed);
+      if (result.summary) {
+        setSummary(result.summary);
         return; // Already have summary, no need to poll
       }
 
-      // No published summary yet — start polling until one appears
+      // No published summary yet (or the request failed) — poll until one appears
       timerRef.current = setInterval(async () => {
         const polled = await fetchSummary();
         if (cancelled) return;
-        if (polled) {
-          setSummary(polled);
+        setLoadFailed(polled.failed);
+        if (polled.summary) {
+          setSummary(polled.summary);
           // Stop polling once we have the summary
           if (timerRef.current) {
             clearInterval(timerRef.current);
@@ -95,7 +113,22 @@ export const StudentSummaryView: React.FC<StudentSummaryViewProps> = ({ domainId
     };
   }, [fetchSummary]);
 
-  if (loading || !summary) return null;
+  if (loading) return null;
+
+  if (!summary) {
+    return (
+      <div style={{
+        maxWidth: LAYOUT.contentMaxWidth,
+        margin: '0 auto',
+        width: '100%',
+        marginBottom: SPACING.base,
+      }}>
+        <div style={emptyStateStyle}>
+          {t(loadFailed ? 'ai_helper_batch_summary_my_load_failed' : 'ai_helper_batch_summary_my_empty')}
+        </div>
+      </div>
+    );
+  }
 
   return (
     <div style={{

package/frontend/batchSummary/SummaryCard.tsx

@@ -5,7 +5,7 @@
  */
 
 import React, { useState } from 'react';
-import { i18n } from '@hydrooj/ui-default';
+import { i18n } from '../utils/i18n';
 import {
   COLORS, SPACING, RADIUS, SHADOWS, getButtonStyle,
 } from '../utils/styles';