# 功能文档总览

本目录包含 4 个核心功能的两类文档：
- 用户使用分档
- API 文档

## 快速导航

| 功能 | 用户使用分档 | API 文档 |
|---|---|---|
| MusicPlus | [musicplus-user-tier.md](./musicplus-user-tier.md) | [musicplus-api.md](./musicplus-api.md) |
| Soundscape | [soundscape-user-tier.md](./soundscape-user-tier.md) | [soundscape-api.md](./soundscape-api.md) |
| ArtistPro | [artistpro-user-tier.md](./artistpro-user-tier.md) | [artistpro-api.md](./artistpro-api.md) |
| Podcast | [podcast-user-tier.md](./podcast-user-tier.md) | [podcast-api.md](./podcast-api.md) |

## 文档使用建议

1. 产品/运营：优先查看“用户使用分档”，用于制定引导和升级策略。
2. 前端：优先查看 API 文档中的字段与别名约定，保证请求兼容。
3. 后端：重点核对 API 文档中的路径、请求体字段、异步状态返回。
4. 测试：按每个功能的“模式 + 参数边界 + 失败处理”覆盖回归。

## 维护规范

1. 新增功能时，按同样结构补两份文档：`{feature}-user-tier.md` 与 `{feature}-api.md`。
2. 端点、参数、默认值变化时，优先更新 API 文档，再更新分档文档中的能力边界。
3. 若会员权益调整，四份分档文档要同步更新，避免文案冲突。