CR-006-批量推荐接口 SHAP 归因性能降级策略 » 历史记录 » 版本 1
Huarui Lin, 2026-04-12 20:03
| 1 | 1 | Huarui Lin | # CR-006-批量推荐接口 SHAP 归因性能降级策略 |
|---|---|---|---|
| 2 | |||
| 3 | | 字段 | 内容 | |
||
| 4 | |------|------| |
||
| 5 | | **CR ID** | CR-006 | |
||
| 6 | | **标题** | 批量推荐接口严禁执行 SHAP 计算，`top_features` 字段统一返回空值 | |
||
| 7 | | **发起人** | Henry Lin (PM) | |
||
| 8 | | **日期** | 2026-04-11 | |
||
| 9 | | **状态** | ✅ Approved | |
||
| 10 | | **影响范围** | 规约 6.1 节（批量推荐输出）、Step 6 推理服务实现 | |
||
| 11 | |||
| 12 | ### 1. 变更描述 |
||
| 13 | |||
| 14 | **原文（规约 6.1 节批量推荐输出）**： |
||
| 15 | > 排序后的推荐 DataFrame（fund_id, score, top_features, recommendation） |
||
| 16 | **变更为**： |
||
| 17 | > 排序后的推荐 DataFrame（fund_id, score, **top_features (固定为空字符串 `""`)**, recommendation） |
||
| 18 | > **工程红线**：批量推荐接口的代码实现路径中，**严禁** import 或调用 `shap.TreeExplainer`。详细的 Top5 正负特征归因必须由前端在用户点击具体基金后，通过调用“单基金查询”接口获取。 |
||
| 19 | |||
| 20 | ### 2. 变更原因（根因追溯） |
||
| 21 | |||
| 22 | SHAP TreeExplainer 单样本解释在纯 CPU 环境下耗时约 5-10ms。若批量接口传入 1000 只候选基金并全量计算 SHAP，将导致接口响应时间（RT）从 200ms 飙升至 5-10 秒，无法满足业务端列表页实时渲染的 SLA 要求。功能需向性能妥协，采取“列表粗看、详情细查”的分级架构。 |
||
| 23 | |||
| 24 | --- |