feat: include account info in balance response

progress.md

@@ -1282,6 +1282,24 @@
 - ID 说明：T-605 已用于「免邮箱验证」，故本任务用 T-606。
 - 下一步：实现 T-606（路由改造 + DownloadRelease 模型/admin/迁移 + 首页/下载 SSR 模板 + 测试）。
 
+## 2026-07-06 变更：余额接口返回桌面端测试连接账号信息
+
+- 背景：桌面端“测试连接”希望在余额点数外展示当前 API Key 所属账号。为兼容已有调用方，保留旧字段 `user` 与 `points_balance`，新增 `account` 对象；按决策不返回邮箱。
+- 文档先行：先更新 `docs/api.md` 的 `GET /api/v1/balance` 成功响应结构：
+  - `user`: 旧兼容字段，用户名。
+  - `points_balance`: 当前点数余额。
+  - `account.username`: 用户名。
+  - `account.display_name`: 用户姓名；未设置时回退用户名。
+  - 不返回 `email`、数据库用户 ID 或其他敏感字段。
+- 代码变更：
+  - `apps/api/views.py`：`BalanceView` 响应新增 `account`，`display_name = request.user.get_full_name() or username`。
+  - `apps/api/tests.py`：更新 `BalanceApiTests`，断言旧字段保留、新字段存在，且 `account` 不含 `email` / `id`。
+- 验证：
+  - `py -3.12 -m py_compile apps\api\views.py apps\api\tests.py`：通过。
+  - `py -3.12 manage.py check`：通过，0 issues。
+  - `py -3.12 manage.py test apps.api.tests.BalanceApiTests --keepdb --noinput --verbosity 2`：通过，3 tests OK。
+  - 测试期仅保留 allauth 在 MySQL 条件唯一约束上的既有 `models.W036` 警告。
+
 ## 2026-07-06 决策：T-606 首页视觉方向定为 v1「生成台」
 
 - 背景：为 T-606（公开首页 + 客户端下载）出了两版 SVG 原型，写入 `prototypes/`：