# API 接口清单与完成度

## v1 路由（前缀 `/api`）
| 接口 | 方法 | 说明 | 状态 | 备注 |
| --- | --- | --- | --- | --- |
| `/api/upload` | POST | 上传 CSV 文件 | ✅ 已实现 | 仅接受 `settings.ALLOWED_EXTENSIONS`（默认 csv）。返回保存后的文件名。 |
| `/api/analyze` | POST | 对上传的 CSV 做完整分析 | ✅ 已实现 | 返回分析结果；已切换 charts 数据模式（`analysis.<lang>.charts`），`images` 保留为空以兼容旧前端。 |
| `/api/available_methods` | GET | 列出支持的分析方法 | ✅ 已实现 | 静态列表。 |
| `/api/image/{filename}` | GET | 获取图片文件 | ✅ 已实现 | 从 `uploads/` 读取。 |
| `/api/download/{filename}` | GET | 下载文件 | ✅ 已实现 | 从 `uploads/` 读取。 |
| `/api/list_uploads` | GET | 列出上传文件 | ✅ 已实现 | 返回文件名/大小/修改时间。 |

## v2 路由（前缀 `/api/v2`）
| 接口 | 方法 | 说明 | 状态 | 备注 |
| --- | --- | --- | --- | --- |
| `/api/v2/analyze` | POST | 从 OSS/URL 下载 CSV 并分析 | ✅ 已实现 | 复用 v1 分析器；已返回 charts 数据模式，`images` 为空。`API_MODE=v2` 下仍禁用图片。 |
| `/api/v2/available_methods` | GET | 列出支持的分析方法 | ✅ 已实现 | 与 v1 相同。 |

## 已知差距 / 待办（尚未实现）
- **预测置信区间**：当前 VAR 仅返回点预测；如需 CI 需改用 `forecast_interval`（不改算法，只取上下界）。
- **异常点标注**：暂无标注输出；若需要，需要在封装层额外计算（max/min 或异常检测）。