# 文章列表分页 Plan

**目标**: 文章列表支持分页加载，默认每页 20 篇，不一次性加载全部

**涉及文件**:
- `/data/data/com.termux/files/home/wechat-viewer/app.py` — 改 `/api/articles` 发回端
- `/data/data/com.termux/files/home/wechat-viewer/templates/articles.html` — 改前端分页 UI
- `/data/data/com.termux/files/home/wechat-viewer/test_smoke.py` — 更新 T4 测试

**数据流**:
- 改前: 前端 `fetch(/api/articles)` → 后端查 500 条 → 全量返回
- 改后: 前端 `fetch(/api/articles?page=1&per_page=20)` → 后端查 500 条（DB 层不变）→ 只返回当前页 + total → 前端渲染分页控件

**步骤**:

1. **后端改 `/api/articles`**：
   - 接受 `page`（默认 1）和 `per_page`（默认 20）参数
   - 返回 `{ok, total, page, per_page, data: [当前页文章], talker_names: {talker→name}}`
   - 文章列表缓存下来？不，现在每次请求都重新处理 500 条有点浪费，但先不做缓存（避免引入新问题），先做分页

2. **前端改 `articles.html`**：
   - `load()` → `loadPage(page)`，只发一页请求
   - 底部加分页控件：上一页 / 页码 / 下一页
   - `checkCache` 只检查当前页的文章（节省批量查询）
   - 搜索/筛选仍然在前端已有页面内过滤

3. **更新 `test_smoke.py` T4**：
   - 验证分页响应格式：`ok + total > 0 + per_page + page + data 长度 <= per_page`

**验证**:
- `python3 test_smoke.py` 通过
- `curl -s 'http://127.0.0.1:5000/api/articles?page=1&per_page=5'` 返回 5 篇
- 页面打开速度快，分页控件可操作

**风险**:
- T4 测试的 check 签名可能变 → 需同步
- 搜索/筛选是先加载全量再过滤，还是服务端搜索？先保持前端筛选，因为数据量不大