perf(CompanyOverview): hooks 支持 enabled 延迟加载和刷新

- 所有 hooks 参数改为 options 对象形式
- 新增 enabled 参数支持延迟加载
- 新增 refreshKey 参数支持手动刷新
- 智能初始化 loading 状态，避免首次渲染闪现空状态

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

src/views/Company/components/CompanyOverview/hooks/useAnnouncementsData.ts

@@ -11,6 +11,15 @@ interface ApiResponse<T> {
   data: T;
 }
 
+// 支持延迟加载的配置选项
+interface UseAnnouncementsDataOptions {
+  stockCode?: string;
+  /** 是否启用数据加载，默认 true */
+  enabled?: boolean;
+  /** 刷新标识，变化时触发重新请求 */
+  refreshKey?: number;
+}
+
 interface UseAnnouncementsDataResult {
   announcements: Announcement[];
   loading: boolean;
@@ -18,16 +27,22 @@ interface UseAnnouncementsDataResult {
 }
 
 /**
- * 公告数据 Hook
- * @param stockCode - 股票代码
+ * 公告数据 Hook（支持延迟加载和刷新）
+ * @param options - 配置选项
+ * @param options.stockCode - 股票代码
+ * @param options.enabled - 是否启用数据加载，默认 true
+ * @param options.refreshKey - 刷新标识，变化时触发重新请求
  */
-export const useAnnouncementsData = (stockCode?: string): UseAnnouncementsDataResult => {
+export const useAnnouncementsData = (options: UseAnnouncementsDataOptions): UseAnnouncementsDataResult => {
+  const { stockCode, enabled = true, refreshKey } = options;
+
   const [announcements, setAnnouncements] = useState<Announcement[]>([]);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
 
   useEffect(() => {
-    if (!stockCode) return;
+    // 只有 enabled 且有 stockCode 时才请求
+    if (!enabled || !stockCode) return;
 
     const controller = new AbortController();
 
@@ -57,7 +72,7 @@ export const useAnnouncementsData = (stockCode?: string): UseAnnouncementsDataRe
 
     loadData();
     return () => controller.abort();
-  }, [stockCode]);
+  }, [stockCode, enabled, refreshKey]);
 
   return { announcements, loading, error };
 };

src/views/Company/components/CompanyOverview/hooks/useBasicInfo.ts

@@ -11,6 +11,13 @@ interface ApiResponse<T> {
   data: T;
 }
 
+// 支持延迟加载的配置选项
+interface UseBasicInfoOptions {
+  stockCode?: string;
+  /** 是否启用数据加载，默认 true */
+  enabled?: boolean;
+}
+
 interface UseBasicInfoResult {
   basicInfo: BasicInfo | null;
   loading: boolean;
@@ -18,16 +25,22 @@ interface UseBasicInfoResult {
 }
 
 /**
- * 公司基本信息 Hook
- * @param stockCode - 股票代码
+ * 公司基本信息 Hook（支持延迟加载）
+ * @param options - 配置选项
+ * @param options.stockCode - 股票代码
+ * @param options.enabled - 是否启用数据加载，默认 true
  */
-export const useBasicInfo = (stockCode?: string): UseBasicInfoResult => {
+export const useBasicInfo = (options: UseBasicInfoOptions): UseBasicInfoResult => {
+  const { stockCode, enabled = true } = options;
+
   const [basicInfo, setBasicInfo] = useState<BasicInfo | null>(null);
-  const [loading, setLoading] = useState(false);
+  // 智能初始化 loading：当需要加载数据时，初始值为 true，避免首次渲染闪现空状态
+  const [loading, setLoading] = useState(() => enabled && !!stockCode);
   const [error, setError] = useState<string | null>(null);
 
   useEffect(() => {
-    if (!stockCode) return;
+    // 只有 enabled 且有 stockCode 时才请求
+    if (!enabled || !stockCode) return;
 
     const controller = new AbortController();
 
@@ -57,7 +70,7 @@ export const useBasicInfo = (stockCode?: string): UseBasicInfoResult => {
 
     loadData();
     return () => controller.abort();
-  }, [stockCode]);
+  }, [stockCode, enabled]);
 
   return { basicInfo, loading, error };
 };

src/views/Company/components/CompanyOverview/hooks/useBranchesData.ts

@@ -11,6 +11,13 @@ interface ApiResponse<T> {
   data: T;
 }
 
+// 支持延迟加载的配置选项
+interface UseBranchesDataOptions {
+  stockCode?: string;
+  /** 是否启用数据加载，默认 true */
+  enabled?: boolean;
+}
+
 interface UseBranchesDataResult {
   branches: Branch[];
   loading: boolean;
@@ -18,16 +25,24 @@ interface UseBranchesDataResult {
 }
 
 /**
- * 分支机构数据 Hook
- * @param stockCode - 股票代码
+ * 分支机构数据 Hook（支持延迟加载）
+ * @param options - 配置选项
+ * @param options.stockCode - 股票代码
+ * @param options.enabled - 是否启用数据加载，默认 true
  */
-export const useBranchesData = (stockCode?: string): UseBranchesDataResult => {
+export const useBranchesData = (options: UseBranchesDataOptions): UseBranchesDataResult => {
+  const { stockCode, enabled = true } = options;
+
   const [branches, setBranches] = useState<Branch[]>([]);
-  const [loading, setLoading] = useState(false);
+  const [loading, setLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
+  const [hasLoaded, setHasLoaded] = useState(false);
 
   useEffect(() => {
-    if (!stockCode) return;
+    if (!enabled || !stockCode) {
+      setLoading(false);
+      return;
+    }
 
     const controller = new AbortController();
 
@@ -46,18 +61,25 @@ export const useBranchesData = (stockCode?: string): UseBranchesDataResult => {
         } else {
           setError("加载分支机构数据失败");
         }
+        setLoading(false);
+        setHasLoaded(true);
       } catch (err: any) {
-        if (err.name === "CanceledError") return;
+        // 请求被取消时，不更新任何状态
+        if (err.name === "CanceledError") {
+          return;
+        }
         logger.error("useBranchesData", "loadData", err, { stockCode });
         setError("网络请求失败");
-      } finally {
         setLoading(false);
+        setHasLoaded(true);
       }
     };
 
     loadData();
     return () => controller.abort();
-  }, [stockCode]);
+  }, [stockCode, enabled]);
 
-  return { branches, loading, error };
+  const isLoading = loading || (enabled && !hasLoaded && !error);
+
+  return { branches, loading: isLoading, error };
 };

src/views/Company/components/CompanyOverview/hooks/useDisclosureData.ts

@@ -11,6 +11,13 @@ interface ApiResponse<T> {
   data: T;
 }
 
+// 支持延迟加载的配置选项
+interface UseDisclosureDataOptions {
+  stockCode?: string;
+  /** 是否启用数据加载，默认 true */
+  enabled?: boolean;
+}
+
 interface UseDisclosureDataResult {
   disclosureSchedule: DisclosureSchedule[];
   loading: boolean;
@@ -18,16 +25,21 @@ interface UseDisclosureDataResult {
 }
 
 /**
- * 披露日程数据 Hook
- * @param stockCode - 股票代码
+ * 披露日程数据 Hook（支持延迟加载）
+ * @param options - 配置选项
+ * @param options.stockCode - 股票代码
+ * @param options.enabled - 是否启用数据加载，默认 true
  */
-export const useDisclosureData = (stockCode?: string): UseDisclosureDataResult => {
+export const useDisclosureData = (options: UseDisclosureDataOptions): UseDisclosureDataResult => {
+  const { stockCode, enabled = true } = options;
+
   const [disclosureSchedule, setDisclosureSchedule] = useState<DisclosureSchedule[]>([]);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
 
   useEffect(() => {
-    if (!stockCode) return;
+    // 只有 enabled 且有 stockCode 时才请求
+    if (!enabled || !stockCode) return;
 
     const controller = new AbortController();
 
@@ -57,7 +69,7 @@ export const useDisclosureData = (stockCode?: string): UseDisclosureDataResult =
 
     loadData();
     return () => controller.abort();
-  }, [stockCode]);
+  }, [stockCode, enabled]);
 
   return { disclosureSchedule, loading, error };
 };

src/views/Company/components/CompanyOverview/hooks/useManagementData.ts

@@ -11,6 +11,13 @@ interface ApiResponse<T> {
   data: T;
 }
 
+// 支持延迟加载的配置选项
+interface UseManagementDataOptions {
+  stockCode?: string;
+  /** 是否启用数据加载，默认 true */
+  enabled?: boolean;
+}
+
 interface UseManagementDataResult {
   management: Management[];
   loading: boolean;
@@ -18,16 +25,23 @@ interface UseManagementDataResult {
 }
 
 /**
- * 管理团队数据 Hook
- * @param stockCode - 股票代码
+ * 管理团队数据 Hook（支持延迟加载）
+ * @param options - 配置选项
+ * @param options.stockCode - 股票代码
+ * @param options.enabled - 是否启用数据加载，默认 true
  */
-export const useManagementData = (stockCode?: string): UseManagementDataResult => {
+export const useManagementData = (options: UseManagementDataOptions): UseManagementDataResult => {
+  const { stockCode, enabled = true } = options;
+
   const [management, setManagement] = useState<Management[]>([]);
-  const [loading, setLoading] = useState(false);
+  const [loading, setLoading] = useState(() => enabled && !!stockCode);
   const [error, setError] = useState<string | null>(null);
+  // 记录是否已完成首次加载，用于派生 loading 状态
+  const [hasLoaded, setHasLoaded] = useState(false);
 
   useEffect(() => {
-    if (!stockCode) return;
+    // 只有 enabled 且有 stockCode 时才请求
+    if (!enabled || !stockCode) return;
 
     const controller = new AbortController();
 
@@ -52,12 +66,17 @@ export const useManagementData = (stockCode?: string): UseManagementDataResult =
         setError("网络请求失败");
       } finally {
         setLoading(false);
+        setHasLoaded(true);
       }
     };
 
     loadData();
     return () => controller.abort();
-  }, [stockCode]);
+  }, [stockCode, enabled]);
 
-  return { management, loading, error };
+  // 派生 loading 状态：enabled 但尚未完成首次加载时，视为 loading
+  // 这样可以在渲染时同步判断，避免 useEffect 异步导致的空状态闪烁
+  const isLoading = loading || (enabled && !hasLoaded && !error);
+
+  return { management, loading: isLoading, error };
 };

src/views/Company/components/CompanyOverview/hooks/useShareholderData.ts

@@ -11,6 +11,13 @@ interface ApiResponse<T> {
   data: T;
 }
 
+// 支持延迟加载的配置选项
+interface UseShareholderDataOptions {
+  stockCode?: string;
+  /** 是否启用数据加载，默认 true */
+  enabled?: boolean;
+}
+
 interface UseShareholderDataResult {
   actualControl: ActualControl[];
   concentration: Concentration[];
@@ -21,19 +28,25 @@ interface UseShareholderDataResult {
 }
 
 /**
- * 股权结构数据 Hook
- * @param stockCode - 股票代码
+ * 股权结构数据 Hook（支持延迟加载）
+ * @param options - 配置选项
+ * @param options.stockCode - 股票代码
+ * @param options.enabled - 是否启用数据加载，默认 true
  */
-export const useShareholderData = (stockCode?: string): UseShareholderDataResult => {
+export const useShareholderData = (options: UseShareholderDataOptions): UseShareholderDataResult => {
+  const { stockCode, enabled = true } = options;
+
   const [actualControl, setActualControl] = useState<ActualControl[]>([]);
   const [concentration, setConcentration] = useState<Concentration[]>([]);
   const [topShareholders, setTopShareholders] = useState<Shareholder[]>([]);
   const [topCirculationShareholders, setTopCirculationShareholders] = useState<Shareholder[]>([]);
-  const [loading, setLoading] = useState(false);
+  // 智能初始化 loading：当需要加载数据时，初始值为 true，避免首次渲染闪现空状态
+  const [loading, setLoading] = useState(() => enabled && !!stockCode);
   const [error, setError] = useState<string | null>(null);
 
   useEffect(() => {
-    if (!stockCode) return;
+    // 只有 enabled 且有 stockCode 时才请求
+    if (!enabled || !stockCode) return;
 
     const controller = new AbortController();
 
@@ -69,7 +82,7 @@ export const useShareholderData = (stockCode?: string): UseShareholderDataResult
 
     loadData();
     return () => controller.abort();
-  }, [stockCode]);
+  }, [stockCode, enabled]);
 
   return {
     actualControl,