TimeCrackbot/NewBlog
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
18 Commits 1 Branch 0 Tags
0719d8ba5dfaf675ef345ee4dc7fb8fe3228fe56
Commit Graph
6 Commits
Author SHA1 Message Date
dsh 0719d8ba5d 书架首页改成「在读」，书籍挪到 /bookshelf/books/ 
原来 /bookshelf/ 是书籍页，点顶部导航「书架」直接进书籍，
和「先看在读」的预期相反。

- /bookshelf/       -> 在读页（view="reading"）
- /bookshelf/books/ -> 书籍页（view="books"）
- 顶部导航「书架」保持指向 /bookshelf/，现在落在在读页，不用改导航
- 侧栏「馆藏」：在读 -> /bookshelf/，书籍 -> /bookshelf/books/
- /bookshelf/reading/ 这个临时 URL 撤掉（还没上线，没有外链负担）

因为导航的 isCurrent 用的是 startsWith，在 /bookshelf/books/ 下
顶部「书架」仍然是高亮状态，符合预期。

验证
- /bookshelf/       : title「在读 20 本」、id=reading、20 张卡、20 条进度条、
                      无书籍区块；侧栏「在读」带 aria-current
- /bookshelf/books/ : title「书籍」、id=books、已读完分组 6 张、无进度条；
                      侧栏「书籍」带 aria-current
- 顶部导航「书架」href = /bookshelf/
 2026-09-15 11:11:32 +08:00
dsh a88bb536ab 书籍页：手工书单为空时隐藏统计行和搜索/筛选条 
books.json 是空的，所以「书籍」页顶上挂着一排
「0 本已读 / 0 本推荐 / 0 个领域」加搜索框、领域和评价筛选 ——
没数据可显示也没东西可筛，纯占地方。

改成 hasManualBooks = allBooks.length > 0 控制：
- 为空时整块（统计行 + 搜索框 + 领域筛选 + 评价筛选）不渲染
- 往 books.json 加了书自动回来，不用改代码
- 顺带补一个兜底空态：手工书单和微信读书都已读完都为空时，
  显示「书架还是空的」并提示两条填充路径

验证（双向都测了）
- books.json 为空时构建：本已读 / data-bookshelf-search /
  data-filter-books-category / data-filter-books-status 在产物里均 0 次；
  已读完分组和 6 张卡片不受影响
- 临时往 books.json 注入 1 本假书再构建：统计行、搜索框、领域筛选、
  评价筛选、手工书卡全部出现（测完已 git checkout 还原）
- 在读页未受影响：20 张卡 / 20 条进度条
 2026-09-15 11:05:39 +08:00
dsh 95e5111fd8 书架拆成「在读」和「书籍」两个独立页面 
问题：两块内容挤在 /bookshelf/ 一页里，往下滚就从「在读」滑进「书籍」，
不像两个分类该有的样子。

拆法
- src/pages/bookshelf.astro -> src/pages/bookshelf/index.astro（书籍页）
- 新增 src/pages/bookshelf/reading.astro（在读页）
- 两页共用 bookshelf-content.astro，只多收一个 view: "reading" | "books"，
  决定渲染哪一块；外壳（页眉/侧栏/页脚/样式）完全同一份，样式不会跑偏
- 在读页标题带真实本数：「在读 20 本 | 时之刃的小站」

侧栏「馆藏」改成真导航
- 在读 -> /bookshelf/reading/，数量 = 未读完本数（20）
- 书籍 -> /bookshelf/，数量 = 手工书单 + 微信读书已读完（0 + 6 = 6）
  原来这里只算 books.json 的 total，所以显示 0，正是截图里的问题
- 当前页用 aria-current="page" + 主色底高亮

页面互相不串
- /bookshelf/        : id=books、搜索框、已读完分组 6 张、无在读区块、0 条进度条
- /bookshelf/reading/: id=reading、在读卡片 20 张、20 条进度条、无书籍区块、
                       无搜索框、无已读完分组、0 张 data-weread-card

顺带更正 README 首段还写着的「读书/论文/漫画书架」。
 2026-09-15 10:58:27 +08:00
dsh 8a867132de 已读完的书卡改成和「在读」同一套样式，补开始/读完时间 
可行性（先说结论）
- 「开始阅读时间」在官方文档里没列，但 /book/getprogress 的原始回包里有
  book.startReadingTime，6 本已读完的全都有
- 顺带纠正我上一轮的错误结论：真正常为 0 的是 recordReadingTime，
  book.readingTime 是有值的（西线无战事 6190 秒 = 103 分），
  已存进 JSON 的 readingSeconds，卡片暂未展示

抽公共组件
- 新增 src/components/reading-card.astro，在读和已读完共用，样式强制统一：
  横版卡片、封面在左、信息在右
- 两处只在底部两行不同：
    在读   进度条 + 百分比 / 最近阅读 X
    已读完 开始 X / 读完 Y（无进度条）

数据层
- fetch-reading.mjs 每个条目新增 startedAt / finishedAt / readingSeconds
- src/lib/reading.ts 的 ReadingBook 类型同步补上（都可选，老数据不会炸）
- startReadingTime / finishTime 缺失时卡片自动少一行，不会渲染出「开始 —」

时间显示走 Asia/Shanghai。所以西线无战事的 startReadingTime
1786207913（UTC 08-08T15:31Z）在页面上是「开始 2026-08-09」，
这才是本地日期。

静态验证（dist/bookshelf/index.html）
- 在读区 20 张卡 / 20 条进度条 / 20 个「最近阅读」
- 已读完区 6 张卡 / 0 条进度条 / 6 个「开始 X」/ 6 个「读完 X」
- 抽一张：西线无战事（译文经典） 雷马克 · 文学-外国文学
  开始 2026-08-09 读完 2026-09-06，确认不含进度条
- 搜索/领域筛选的 data-weread-card 仍挂在新卡片上，筛选不受影响
 2026-09-15 10:51:50 +08:00
dsh 4df235ea21 已读完的书挪进「书籍」，抓取上限去掉（8 -> 整架 26 本） 
抓取范围
- TOP_N 默认从 8 改成 0=不限制。原来那个 8 是我拍的「最近动过的前 8 本」，
  不是接口限制；整架 26 本也就 1+26 个请求，完全够用
- --top N 仍可用，想只抓最近几本时加

分组调整
- 「最近在读」只留 progress < 100 的（20 本），进度条不再出现 100%
- 新增「书籍」区底部的「微信读书 · 已读完」分组（6 本），卡片结构与手工
  书单一致，左上角带「已读完」徽标；因为微信读书的数据没有书评/简介，
  这一组点击直接跳 weread.qq.com，不弹窗
- 这一组带 data-weread-card + data-category="微信读书"，所以搜索框和
  「领域」筛选同样作用得到；领域筛选里会多出一个「微信读书」选项
- 筛选逻辑把 [data-book-card] 的选择器扩成 [data-book-card],
  [data-weread-card]，分组计数也一并算上

实测数据分布（整架 26 本）
- 已读完 6 / 在读中 16（1%-97%）/ 没开始 4（0%）

静态验证（dist/bookshelf/index.html）
- 在读区 20 张卡片，进度条 30/0/77/28/13/97/0/5/16/3/10/1/4/13/4/0/1/10/6/0，
  区内无「已读完」字样
- 已读完分组 6 张卡片，6 个徽标、6 个微信读书跳转链接，均带 data-weread-card
- 手工书单 3 张卡片未受影响；领域筛选新增「微信读书」按钮
 2026-09-15 10:45:29 +08:00
dsh 95dd0d9552 书架页新增「最近在读」：构建时抓微信读书，顺带移除漫画/论文 
数据链路
- 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 均已从产物消失
- 其他页面（首页/时间线/关于/文章页）不含该区块，未受影响
 2026-09-15 10:40:11 +08:00