用途:将分散在各 API 路由中的数据转换逻辑集中到一处,保证不同端点输出格式一致,并让转换函数可复用、可测试。适用于转换逻辑散落各处、需要统一输出格式、构建聚合数据仪表盘等场景。
主要能力:聚合器(按类别汇总数量)、排名器(按分数取前 N 名)、趋势计算器(对比不同周期,含滚动平均与百分比变化)、数据清洗器(校验并清理数据,如热点数据)。另含字符串工具(截断、slugify)与日期工具(相对时间格式化)。
使用方式:在 lib/transformers.ts 中实现并导出函数,在 API 路由中导入调用,例如 aggregateCategories、rankItems、filterValidHotspots、calculateTrend 等,将原始数据经转换后返回 API 输出。
限制与注意:资料未提供安装命令、依赖、收费或平台信息。建议保持纯函数、处理空数组与空值等边界情况、避免修改输入数据、为可空返回添加类型守卫,并单独测试各转换函数。