积分明细支持按月导出的设计与实现

需求从哪里来

积分规则一多，用户就会问「我这 300 分是怎么来的」。明细页只能一页页翻，导出成表格后自己求和、分类，体验会好很多。

字段怎么定

最少要有五列：时间、来源任务、变动值、变动后余额、备注。少了余额这一列，对账时无法发现中间漏记；少了任务名，只能看到一串数字。

时间,来源,变动,余额,备注
2026-10-27 00:01,每日签到,+10,1030,连续签到第2天
2026-10-26 23:40,每日发布文章,+60,1020,审核中

分页拉取要注意顺序

明细接口通常分页返回，导出时必须按时间倒序拉全量再反转，否则会出现顺序错乱。并发拉取能提速，但要用固定的时间边界做校验，避免中间新增记录导致重复或遗漏。

文件格式与编码

CSV 一定要带 UTF-8 BOM，否则用 Excel 打开中文会乱码。文件名带上月份，比如 points-2026-10.csv，用户下载多次也不会覆盖。

大文件怎么办

超过几万行时不要在前端拼字符串，改成后端生成、异步下载。多数用户的月度记录只有几十行，但设计时留好这条路径，后续不用重构。