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
7 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 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 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
dsh c841fa2047 修复评论区切页后排版崩坏：twikoo 基础样式改为静态引入 
Astro 的 ClientRouter 切页时会清掉 head 里它不认识的 <style>，而 twikoo
的 CSS 正是 twikoo.min.js 运行时 appendChild 到 head 的；脚本本身又只执行
一次（window.twikoo 已存在就跳过），样式不会重新注入。

表现：从一篇带评论的文章点链接进另一篇后，评论区样式整段丢失 ——
markdown 图标被 .twikoo svg{width:100%;height:100%} 撑成 768x1240px、
文件输入框 .tk-input-image 从 display:none 变回可见、.OwO-items 从 flex
塌成 block 竖排成一列；整页刷新后恢复。

修复：把官方 twikoo.css 放进 public/assets/css/（与现有 twikoo.min.js 同为
1.7.20，已核对两个文件都来自同一个 npm 包、md5 一致），在 Comments.astro
里用静态 <link> 引入，排在 twikoo-custom.css 之前。静态 link 在 <body> 里，
切页时会随新页面一起换进来，不再依赖运行时注入。

没有换用官方 twikoo.nocss.js：它是 all 完整版去掉 CSS（997 KB），比
twikoo.min.js（506 KB，CSS 打包在内）大近一倍，而本站服务器没开 gzip，
换过去等于访客多下 491 KB。

验证（headless Chrome 131，禁用缓存，对本地 dist 实测）：
- 直接打开文章页：icon 18.75px / fileInput none / .tk-submit 179px
- 文章 -> 文章切页：修复前 768px / inline-block / 2919px；
  修复后与直接打开逐像素一致（diff bbox = None，差异像素 0.0000%）
- 连续切页 3 次、切页后展开 OwO 表情面板，均正常
 2026-09-15 08:39:41 +08:00
dsh 0b99eabfbe 评论区改为自托管 twikoo 前端，并适配主题 
- 前端脚本从 jsDelivr 改为自托管 public/assets/js/twikoo.min.js，
  版本与后端对齐（1.7.20）。国内访问 jsDelivr 实测 3 秒以上且常被墙，
  是评论区空白的根因
- 新增 public/assets/css/twikoo-custom.css 主题适配层：选择器加 #twikoo
  前缀以覆盖运行时注入的样式，颜色引用主题变量，自动跟随亮/暗色
- 修复首屏重复初始化：astro:page-load 在首屏也会触发，用 dataset.mounted 去重
- 评论配置移除已无用的 version 字段；README 与操作指南同步更新
 2026-09-14 20:58:37 +08:00
dsh 686b1caa7d 新增 new-post 脚本与操作指南文档 
- scripts/new-post.mjs + pnpm new-post：按标题建文章，支持 --category/--tags/
  --description/--image/--file/--pinned/--draft，标题里的冒号引号会正确转义
- docs/操作指南.md：写文章、发偶得、加相册、预览、检查、部署的完整流程
- 修复 astro check 报出的 2 个类型错误（gallery 索引页 querySelector 未指定
  HTMLElement，导致 dataset 不可用）。现在 pnpm check 为 0 error
 2026-09-14 20:50:22 +08:00