freedakgmail
33b4c734aa
后端: - 新增认证(auth)、任务(tasks)、映射(mappings)、对账(reconciliation)、异常(exceptions)、导出(exports) API - 新增核心模块: database, security, permissions, tenant, exceptions, error_handlers - 新增数据模型: user, company, reconciliation_task, field_mapping, uploaded_file 等 - 新增服务层: ai_recognizer, file_parser, file_storage, mapping, reconciliation 等 - 添加数据库迁移脚本 前端: - 新增登录页面和仪表盘页面 - 新增任务列表、任务详情、字段映射页面 - 新增异常处理页面和规则设置页面 - 新增 API 代理路由 /api/[...path] - 新增 UI 组件库 (button, card, dialog, input, table 等) - 新增 auth 组件 (ProtectedRoute, PermissionGate) - 新增 layout 组件 (Header, Sidebar) - 新增 mapping 组件 (FieldMappingTable, AISuggestionPanel) - 新增 API 客户端和 hooks (useAsync, useToast, usePermission 等) - 新增状态管理 (auth-store, company-store, ui-store) - 集成 Tailwind CSS 和 shadcn/ui 组件库 其他: - 添加 Alembic 数据库迁移配置 - 添加初始化示例数据脚本 - 更新项目文档
69 lines
1.6 KiB
TypeScript
69 lines
1.6 KiB
TypeScript
import { useCallback, useEffect, useRef, useState } from 'react';
|
|
|
|
/**
|
|
* 防抖 Hook
|
|
* 延迟执行函数，直到停止调用一段时间后才执行
|
|
*
|
|
* @param value - 要防抖的值
|
|
* @param delay - 延迟时间（毫秒）
|
|
* @returns 防抖后的值
|
|
*/
|
|
export function useDebounce<T>(value: T, delay: number = 500): T {
|
|
const [debouncedValue, setDebouncedValue] = useState<T>(value);
|
|
|
|
useEffect(() => {
|
|
const handler = setTimeout(() => {
|
|
setDebouncedValue(value);
|
|
}, delay);
|
|
|
|
return () => {
|
|
clearTimeout(handler);
|
|
};
|
|
}, [value, delay]);
|
|
|
|
return debouncedValue;
|
|
}
|
|
|
|
/**
|
|
* 防抖回调 Hook
|
|
* 延迟执行回调函数
|
|
*
|
|
* @param callback - 要防抖的回调函数
|
|
* @param delay - 延迟时间（毫秒）
|
|
* @returns 防抖后的回调函数
|
|
*/
|
|
export function useDebouncedCallback<T extends (...args: unknown[]) => unknown>(
|
|
callback: T,
|
|
delay: number = 500
|
|
): (...args: Parameters<T>) => void {
|
|
const timeoutRef = useRef<NodeJS.Timeout | undefined>(undefined);
|
|
const callbackRef = useRef<T>(callback);
|
|
|
|
// 保持最新的 callback 引用
|
|
useEffect(() => {
|
|
callbackRef.current = callback;
|
|
}, [callback]);
|
|
|
|
useEffect(() => {
|
|
return () => {
|
|
if (timeoutRef.current) {
|
|
clearTimeout(timeoutRef.current);
|
|
}
|
|
};
|
|
}, []);
|
|
|
|
return useCallback(
|
|
(...args: Parameters<T>) => {
|
|
if (timeoutRef.current) {
|
|
clearTimeout(timeoutRef.current);
|
|
}
|
|
|
|
timeoutRef.current = setTimeout(() => {
|
|
callbackRef.current(...args);
|
|
}, delay);
|
|
},
|
|
[delay]
|
|
);
|
|
}
|
|
|
|
export default useDebounce; |