书架页新增「最近在读」：构建时抓微信读书，顺带移除漫画/论文

数据链路
- scripts/fetch-reading.mjs：调腾讯官方 Agent Gateway
  （POST https://i.weread.qq.com/api/agent/gateway，Bearer wrk-...），
  /shelf/sync 拿书架，再对前 N 本调 /book/getprogress 拿进度，
  写出 src/data/reading.json
- src/lib/reading.ts：读 JSON + 按 YYYY-MM-DD 格式化（官方硬性要求），
  文件缺失返回 null 让页面走空态而不是构建报错
- src/components/bookshelf-content.astro：只渲染，页面本身不发请求

接口实测得到的几个结论（都写进脚本注释和 README 了）
- skill_version 必填，业务参数平铺顶层
- /shelf/sync 一次给全封面/书名/作者/分类/最近阅读时间/deepLink，
  只有进度要额外请求，所以请求数 = 1 + N
- progress 是 0-100 整数，只有 100 算读完
- recordReadingTime 恒为 0，所以卡片不做「累计时长」
- deepLink 实测是普通 https，浏览器能直接打开

失败兜底（这次最关键的一条）
- pnpm reading：失败 exit 1，明确报错
- pnpm build：串的是 `fetch-reading.mjs --soft`，Key 失效/断网/接口挂了
  都保留上一次的 reading.json 并 exit 0，不会阻塞部署
- 实测：错误 Key 时 pnpm reading exit 1；pnpm build 完整跑通 exit 0 且
  reading.json 未被改动；不设 Key 也 exit 0
- process.loadEnvFile 不覆盖已存在的环境变量，所以 CI 设的 Key 优先于 .env

Key 安全
- 只写进 .env（gitignore，权限 600），已确认 git status 里没有它
- deploy.sh 是本地构建再 rsync，凭据不会上传服务器
- .env.example 补了占位和申请地址

书架页改版
- 移除漫画/论文两个分类：删掉 tab 切换、两个视图、对应筛选和 JS，
  956 行 -> 620 行；sidebar 的 tab 按钮改成 #reading / #books 页内锚点
- 新增「最近在读」区块置顶（Collection · 01），书籍顺延为 02
- 卡片：封面（hot-link 腾讯 CDN，referrerpolicy=no-referrer）+ 书名 +
  作者 · 分类 + 进度条 + 最近阅读日期，整卡跳 weread.qq.com
- 读完标「已读完」，0% 标「还没开始」
- 过滤私密阅读（secret=1）和从没打开过的书；有声书不处理

静态验证（dist/bookshelf/index.html）
- 8 张在读卡片，链接均指向 weread.qq.com/book-detail
- 8 条进度条宽度 30/0/77/100/28/13/97/0，与脚本输出一致
- 8 张封面全部 hot-link，无本地副本
- 漫画/论文/comics/papers/data-type-btn/switchType 均已从产物消失
- 其他页面（首页/时间线/关于/文章页）不含该区块，未受影响

docs/操作指南.md

@@ -193,6 +193,35 @@ pnpm preview    # 本地预览构建产物（搜索功能只有这里才生效
 
 ---
 
+## 7.5 刷新「最近在读」
+
+书架页（`/bookshelf/`）顶部的「最近在读」是从微信读书抓来的，数据存在 `src/data/reading.json`。
+
+**只想更新书单**（不动别的）：
+
+```bash
+pnpm reading
+```
+
+会打印抓到的每本书和进度。想看更多本就 `pnpm reading --top 12`（默认 8 本）。
+
+**平时不用管**：`pnpm build` 和 `./deploy.sh` 都会自动先抓一次。抓不到就沿用上一次的数据，**不会让部署失败**。
+
+**首次配置**（只做一次）：
+
+1. 打开 <https://weread.qq.com/r/weread-skills> 扫码，拿到 `wrk-` 开头的 Key
+2. 在项目根目录的 `.env` 里加一行：
+
+   ```
+   WEREAD_API_KEY=wrk-你的key
+   ```
+
+   `.env` 已被 gitignore，不会提交，也不会随 `deploy.sh` 上传到服务器。
+
+不想出现在页面上就改 `scripts/fetch-reading.mjs` 里的过滤条件（默认跳过私密阅读和从没打开过的书）。
+
+---
+
 ## 8. 常见问题
 
 **改了文件但浏览器没变**
@@ -247,8 +276,21 @@ sudo sysctl fs.inotify.max_user_watches=524288
 `twikoo-custom.css` 之前）。如果又出现这个症状，先确认这两行 `<link>` 还在，
 并且 `public/assets/css/twikoo.css` 没被误删。
 
-**想回退到之前的状态**
+**「最近在读」空了 / 数据不更新**
 
+先看构建日志里有没有 `⚠️ 抓取失败，继续用上一次的数据构建`，后面会跟具体原因：
+
+| 日志里的话 | 怎么办 |
+|---|---|
+| `WEREAD_API_KEY 无效或已过期` | Key 失效了，重新扫码拿一个，更新 `.env` |
+| `缺少 WEREAD_API_KEY` | `.env` 里没配，见第 7.5 节 |
+| `fetch failed` / 超时 | 网络问题，重跑 `pnpm reading` 即可 |
+
+**重要**：以上任何一种都**不会**让 `pnpm build` 失败 —— 页面会继续用 `src/data/reading.json` 里上一次的数据。所以「站点发布成功但书单是旧的」是正常现象，不是 bug。
+
+如果连空态提示都看不到，检查 `src/data/reading.json` 是否存在（这个文件要提交进 git）。
+
+**想回退到之前的状态**
 ```bash
 git log --oneline        # 看提交
 git reset --hard <提交号>