shaguabijia-app-server/docs/api/savings/platform-savings-feed.md

GET /api/v1/platform/savings-feed — 首页轮播 feed(真实+种子混播)

所属:Platform 组（前缀 /api/v1/platform） | 鉴权:无 | ← 返回 API 索引

客户端首页顶部「某用户 比价后节省 xx 元」滚动条数据源。全平台真实比价记录优先;不足时用运营配的种子(ops_marquee_seed)补齐到 limit 条「混播」,保证轮播不空。

用户标识脱敏规则(全 feed 统一):① 有昵称 → 昵称脱敏:≥3 字「首+隐藏字数个星+末」(省钱小能手→省***手)、2 字「首+星」(阿强→阿*)、1 字「用户+该字」(喵→用户喵);② 没昵称 → 按 user_id 确定性合成一个假昵称再脱敏(同用户恒定,避免无昵称用户清一色 用户****),少数露「用户」+ 8 星 + id 后 3 位(用户********618)。

合成假名走本地语料组合生成(无外部库):中文真名(姓池 ×名字字池 拼「姓+1~2字」) / 中文网络昵称 / 英文昵称 / 英文名(可带数字尾) 混播,中文为主英文为辅,组合空间上万。真实条按 user_id 播种 → 同一用户名字恒定、不同用户各异(刷新/翻页不变脸,同屏几乎不撞名);种子/兜底用运行时随机源出多样。当前真实用户大多没设昵称,故走合成。

入参

参数	类型	说明
limit	int, query	返回条数,默认 8,范围 1~30

出参

响应 200:SavingsFeedOut

字段	类型	说明
items	list	轮播条目数组(最多 limit 条)
items[].masked_user	string	脱敏用户名:昵称/合成名脱敏(省***手 / 王* / SaveK**g)或匿名 用户********618
items[].saved_amount_cents	int	节省（分），客户端 ÷100 显示「x.xx 元」
items[].time	string	北京时间 HH:MM:SS

说明

• 真实条:comparison_record 中 status='success' 且 0 < saved_amount_cents ≤ 300 元 的近期记录(金额超 300 元视为异常 / bug 值剔除,防「节省 999 元」穿帮),JOIN user 表取昵称 → 仅 user 表内用户的记录入选(孤儿/已删用户记录不计,设计如此;当前用户量少,缺口由种子补足),按 user_id 去重(同一用户只取最新一条,避免单人刷屏);有昵称按真实昵称脱敏,无昵称按 user_id 播种确定性合成脱敏名(同用户恒定、刷新不变脸)。
• 种子条:ops_marquee_seed(enabled=true),仅在真实去重后不足 limit 时补齐;从启用种子中公平随机抽取(不再固定取前 N,所有种子都有机会露出)。每条种子:用户名留空或旧 用户****xxx 模板名则随机合成混合风格名并避开同屏撞名(自愈历史种子),金额在 [min_cents, max_cents] 取长尾随机值(小额居多、偶尔大额,固定金额则 min==max)。
• 兜底:真实 + 种子仍凑不满 limit(种子被全停用 / 太少)时,用内置合成条补满,保证轮播既不空也不稀疏。
• time 为合成的「最近」时间(从当前北京时间往前随机抖动递减,首条几十秒前,其余多数 1~5 分钟、偶尔扎堆或较长):社会证明轮播保证永远像刚发生且节奏自然不机械,不受旧测试数据 / 低谷期记录影响。真实的用户/金额不变,只换展示时间。
• 因含随机(种子抽取 / 金额 / 展示时间 / 种子合成名),每次请求结果都不同——这是轮播想要的鲜活感;但真实用户的脱敏名按 user_id 恒定,同一用户跨请求不变脸(避免「同一人换张脸」露馅)。
• 性能:首页人人都看、真实数据变化慢,真实记录原始行带 ~30s 进程内缓存(展示层随机仍每次重算,只省 DB 往返;新记录最多晚 30s 进轮播)。查询走复合索引 ix_comparison_status_created (status, created_at),避免随数据量增大全表扫。
• 逻辑见 app/repositories/ops_marquee.py;运营管理种子见 admin-marquee-seeds。