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

数据链路
- 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 均已从产物消失
- 其他页面（首页/时间线/关于/文章页）不含该区块，未受影响

README.md

@@ -273,15 +273,38 @@ prose-p:leading-[1.78] md:prose-p:leading-[1.85]
 > 移动端页眉目前**故意关掉**了常驻磨砂（`site-header.astro` 的 `@media (max-width: 767px)` 那段）：固定元素持续模糊会让移动端合成开销变大。要开的话建议用「滚动后才开」的方式，别让它一直生效。
 
 
-## 书架数据
+## 书架与「最近在读」
 
-书架页的数据来自这三个文件，由 `src/components/bookshelf-content.astro` 在**构建时 import**（所以文件必须存在，删掉会导致构建失败）：
+书架页（`/bookshelf/`）有两块内容：
 
-- `public/data/books.json`
-- `public/data/papers.json`
-- `public/data/comics.json`
+**1. 最近在读** —— 来自微信读书，构建时抓取，页面本身不发任何请求。
 
-目前都是空的 `{"data":{"items":[],"total":0}}`，所以书架页显示为空。要填充就按同样的结构往 `items` 里加记录。
+```
+微信读书 Agent Gateway
+   ↓  scripts/fetch-reading.mjs（读 .env 的 WEREAD_API_KEY）
+src/data/reading.json
+   ↓  src/lib/reading.ts
+src/components/bookshelf-content.astro
+```
+
+- 刷新数据：`pnpm reading`（失败会明确报错并 exit 1）；`pnpm reading --top 12` 可改抓取条数（默认 8）
+- **`pnpm build` 会自动先跑一次抓取，但用 `--soft` 模式**：微信读书挂了 / Key 过期 / 断网时，保留上一次的 `reading.json` 继续构建，**不会阻塞部署**
+- `src/data/reading.json` 是数据快照，**要提交进 git**，这样 CI 或新克隆的仓库没 Key 也能构建
+- Key 申请：<https://weread.qq.com/r/weread-skills> 扫码，拿到 `wrk-` 开头的串，写进 `.env` 的 `WEREAD_API_KEY`（`.env` 已 gitignore）。**只在本地构建**时用得上 —— `deploy.sh` 是本地构建再 rsync，凭据不会上传服务器；如果另外接了 Vercel / GitHub Actions 构建，要在那边单独配 secret
+
+接口是腾讯官方的 Agent Gateway（`POST https://i.weread.qq.com/api/agent/gateway`）。几个实测得到的结论，改脚本前值得知道：
+
+- 请求体里 `skill_version` **必填**，业务参数**平铺在顶层**，不能包进 `params`
+- `/shelf/sync` 一次就给全封面/书名/作者/分类/最近阅读时间/跳转链接，**只有阅读进度**要额外调 `/book/getprogress`，所以请求数 = 1 + N
+- `book.progress` 是 0–100 的整数，**只有 100 才算读完**
+- `book.recordReadingTime` **恒为 0**，所以卡片不做「累计时长」
+- `deepLink` 实测是普通 https（`https://weread.qq.com/book-detail?...`），浏览器能直接打开
+- `category` 是 `文学-外国文学` 这种「大类-子类」复合串
+- 时间戳统一按 `YYYY-MM-DD` 展示（官方硬性要求），顺带避开「N 天前」在静态站上会随构建时间变旧
+
+展示逻辑：过滤掉私密阅读（`secret === 1`）和从没打开过的书；读完的照常显示，标「已读完」；0% 标「还没开始」；有声书不管。
+
+**2. 书籍** —— 来自 `public/data/books.json`，由 `bookshelf-content.astro` 在构建时 import（文件必须存在）。另外两个文件 `papers.json` / `comics.json` 对应的漫画、论文分类已经移除，文件保留但不再被引用。
 
 ## 部署