Commit Graph
15 Commits
Author SHA1 Message Date
TimeCrackbot ff698be696 修改了微信读书的脚本 2026-10-11 16:52:21 +08:00
dsh 6a74061689 修复偶得里任务列表不渲染:给 markdown-it 补上 GFM 任务列表
问题
站主反馈偶得里 `- [ ] 每天至少阅读1小时…` 没渲染成复选框,`[ ]` 原样显示;
同样的语法在文章里正常。原因不是语法写错,而是**两套渲染器**:

  文章:Astro 内容管线 → Sätteri,配置里开了 gfm        → 任务列表正常
  偶得:src/lib/thoughts.ts 里裸的 new MarkdownIt()      → 不含 GFM 扩展

实测确认:这条偶得(20260822-好好工作.md,任务列表嵌在引用块里)产出的是
  <blockquote><ul><li>[ ] 每天至少阅读1小时…</li></ul></blockquote>

改法
新增 src/plugins/markdown-it/task-lists.mjs,输出刻意与 Sätteri 那边逐字对齐:
  <ul class="contains-task-list">
    <li class="task-list-item"><input type="checkbox" disabled> 文字</li>
  </ul>
这样以后给任务列表写 CSS,文章和偶得两边都吃得到。

几个实现细节
- 判断任务项看的是 list_item_open → paragraph_open → inline 这个固定结构;
  紧凑列表里 paragraph 是 hidden 的但 token 仍在,所以照样能判
- 找父级列表是按 token 层级往回扫,不是假设它在最外层 —— 因为站主的用法
  正是把任务列表放在引用块里
- class 用 addClass 去重:一个列表里每个任务项都会来加一次,直接用 attrJoin
  会变成 class="contains-task-list contains-task-list contains-task-list …"
- 方括号后必须跟空白才算任务项,`- [ ]紧贴文字` 按普通文本处理(与 GFM 一致)

验证
- 该偶得现在产出 contains-task-list / task-list-item / checkbox,与文章
  树莓派云服务器的使用总结 里那处逐字一致
- 边界用例:`[x]`/`[X]` 正确勾选、有序任务列表可用、嵌套列表只标父级、
  多个列表各自只加一次 class、普通列表项不受影响
- pnpm build 退出码 0

顺带在操作指南里记了「两套渲染器」这个根因,以及偶得目前还缺的 GFM 能力
(裸链接自动转换、脚注、数学公式、callout、智能标点)。
2026-09-17 20:15:48 +08:00
dsh cfcd24a3f8 回滚字体改动,恢复到 ef72d52 的状态
按站主要求,把字体相关改动整体回退。用 revert 而不是 reset —— 这些提交
已经推送并部署过,保留历史比改写历史安全。

撤销的两个提交:
- f56a6ed 门面字体改为霞鹜新致宋(LXGW Neo ZhiSong)
- e92ee27 字体系统重做:脱离 Google Fonts,统一思源黑/宋,门面加霞鹜文楷

回滚后恢复到:
- 西文与中文全部来自 Google Fonts
  (Inter / Noto Sans SC / Playfair Display / Noto Serif SC)
- 门面档用鸿蒙 Sans SC(jsdelivr 的 Regular + Semibold)
- --font-display-sans 回到 "HarmonyOS Sans SC"
- 站点名与首页那句话去掉 font-display-sans
- 操作指南里的字体说明表一并删除(缓存那条 FAQ 保留)

⚠️ 一并回来的已知问题
--font-mono 又变回 "Geist Mono", "Geist Mono Fallback" —— 这两个名字既没有
@font-face 也没装在机器上,font-mono 的回退链是断的,浏览器会退回默认字体
(不是等宽)。全站几十处 font-mono(时间线日期、偶得时间戳、内联代码…)受影响。
这是回滚的既定代价;要单独修的话就是一行。

验证:四个字体文件(BaseLayout / global.css / hero.tsx / site-header.astro)
与 ef72d52 逐字一致(git diff 为空),文档也一致。
2026-09-17 19:49:46 +08:00
dsh f56a6eda11 门面字体改为霞鹜新致宋(LXGW Neo ZhiSong)
按站主要求,门面档(fontProfile="interface")整体换成霞鹜新致宋。
文章页不受影响,仍是思源黑体 —— 宋体在长正文里不如黑体好读。

- BaseLayout:门面档额外加载 ZeoSeven 的 22 号字体,替换掉原来的霞鹜文楷
  (文楷 regular + bold 两档一起删掉)
- global.css:--font-display-sans 换成新致宋;恢复按下 font-profile-interface
  覆盖字族的规则,让门面整体走宋体(思源黑体兜底)
- 站点名与首页那句话本来就挂在 --font-display-sans 上,无需改动

为什么必须用 ZeoSeven 而不是 jsdelivr
  jsdelivr 上的 lxgw-neo-zhisong-webfont@1.0.0 是**单文件 4.45 MB、没有
  unicode-range 分包**,挂上去等于每个访客都要下 4.45 MB,不能用。
  ZeoSeven 的 /22/main/result.css 把字体切成 145 个 unicode-range 分包
  (CSS 158 KB / gzip 54 KB),浏览器只下当前页面命中的那几个。
  Fontsource 没有收录这款字(三个包名都 404),所以没有更统一的来源。
  实测 ZeoSeven 响应稳定(连续 3 次均 200,耗时约 0.11s),分包可下。

已知取舍
  新致宋只有 400 一个字重,门面里的 font-medium / font-semibold / font-bold
  会由浏览器合成加粗。宋体的合成加粗偏糊,如果观感不好,把那几处字重去掉
  改用常规字重即可。这一点已写进操作指南。

体积(样式表 gzip)
  门面:原 127.4 KB(思源黑 + 思源宋 + Inter + Playfair + 文楷两档)
       → 118.9 KB(思源黑 + 思源宋 + Inter + Playfair + 新致宋)
  文章页:不变

验证:pnpm build 退出码 0
- 首页加载 zeoseven/22/main/result.css;文章页不加载
- 两类页面均无 lxgw-wenkai 残留
- 产物 CSS 里 --font-display-sans 为 "LXGW Neo ZhiSong",
  body.font-profile-interface 覆盖规则与思源黑体兜底均在
2026-09-17 19:44:21 +08:00
dsh e92ee27818 字体系统重做:脱离 Google Fonts,统一思源黑/宋,门面加霞鹜文楷
一、全部改走 jsdelivr 上的 Fontsource,不再依赖 Google Fonts
   之前文章页的 Inter / Noto Sans SC / Playfair Display / Noto Serif SC
   全部来自 fonts.googleapis.com —— 而文章页恰恰是最该稳的页面。
   现在 5 份样式表都由 BaseLayout 顶部的 fontStylesheets 统一声明。

二、CJK 用可变字体(关键)
   @fontsource-variable/noto-sans-sc 一份 CSS 覆盖 font-weight: 100 900,
   不用为 400/500/600/700 各加载一份(那样是 4 × 105 KB = 420 KB)。
   每份 CSS 内含约 100 条带 unicode-range 的 @font-face,浏览器只下载当前
   页面命中的分包。完整思源黑体 3.3 MB / 101 个分包,一页通常只用到 100–300 KB。

三、层次:楷(门面点睛)> 宋(标题)> 黑(正文/UI)
   - 正文/UI:思源黑体 Noto Sans SC Variable(两档都用)
   - 标题:思源宋体 Noto Serif SC Variable
   - 门面点睛:霞鹜文楷 LXGW WenKai(regular + bold)—— 用在站点名、
     首页那句话、以及 --font-display-sans 覆盖的卡片标题
   - 西文:Inter Variable(正文)+ Playfair Display(展示)
   霞鹜文楷只在 fontProfile="interface" 的页面加载;文章页没加载它,
   而 --font-display-sans 里它排在思源黑体前面,靠浏览器自动回退。

四、删掉鸿蒙 Sans
   两档现在都用思源黑体,所以 body.font-profile-interface 那条按档覆盖字族的
   规则删掉了。class 保留,它现在只用来决定是否加载文楷。

五、顺带修掉 --font-mono 断掉的回退链
   原来只有 "Geist Mono", "Geist Mono Fallback" —— 这两个名字既没有 @font-face
   也没装在机器上,等于整条回退链失效,浏览器退回默认字体(不是等宽)。
   全站几十处 font-mono(时间线日期、偶得时间戳、内联代码、灯箱说明…)都在受影响。
   补上 ui-monospace / SFMono-Regular / Menlo / Consolas / monospace。

体积账(gzip 后的样式表,和 .woff2 分包的实际下载是两回事)
   文章页  62.5 KB -> 64.6 KB
   门面   125.5 KB -> 127.4 KB
   基本持平,换来摆脱 Google Fonts + 字体统一 + 多一款文楷

验证:pnpm build 退出码 0
- 文章页只加载 Inter + Playfair + 思源黑 + 思源宋;首页额外加载文楷两档
- 两类页面里 Google Fonts 与鸿蒙均已消失
- 产物 CSS 里 5 个字族名与 ui-monospace 回退均在
- 站点名与首页那句话的 class 已带 font-display-sans
- 字体文件实测可下载(jsdelivr 相对路径解析正常)
2026-09-17 19:35:12 +08:00
dsh ef72d52de4 标题后的 # 锚点:补上缺失的样式,并修跳转定位与无障碍
问题
- 插件 src/plugins/satteri/autolink-headings.mjs 会在每个标题末尾追加
  <a class="anchor"><span class="anchor-icon">#</span></a>,但项目里从来
  没给 .anchor / .anchor-icon 写过任何样式(源码和产物 CSS 都查过,零条规则)
- 结果是那个 # 以纯文本形式常驻显示在每一个标题后面,看起来像 Markdown 语法错误
- 另外标题有 id 却没有 scroll-margin-top,点 # 跳过去标题顶部紧贴视口上沿,
  正好藏在 69px 高的 sticky 导航栏下面

改法
- global.css 补样式:默认 opacity:0 隐藏,鼠标悬停标题(或键盘聚焦锚点)才浮现,
  悬停锚点本身转朱红;触屏没有 hover,直接 display:none(跨标题跳转用目录即可)
- 补 :is(h1..h6)[id] { scroll-margin-top: calc(var(--header-h,69px) + 1.25rem) }
- 插件里给锚点补无障碍名称:aria-label="链接到「标题文字」",图标加 aria-hidden。
  否则读屏会连着念二十几个「#,链接」,完全不知道跳到哪

踩到的坑(已写进操作指南)
Astro 的文章缓存只在 markdown 内容变化时失效,改插件代码不会重新渲染,
必须先 rm -rf node_modules/.astro .astro。第一次改完插件产物没变就是这个原因。

验证:清缓存重建后,产物 HTML 里锚点带上了 aria-label 与 aria-hidden;
产物 CSS 里 .anchor 的 5 条规则 + scroll-margin-top 均正确,
@media(hover:none) 的作用域也确认无误
2026-09-17 18:37:20 +08:00
dsh 71026ee291 文档:记录两个部署目标的服务方式,并开启线上压缩
排查「树莓派预览打不开」时发现两件事,都不是这次部署造成的,但都修了/记了:

1) 树莓派上根本没有 web 服务
   - nginx 未安装(Unit nginx.service could not be found),80 端口无人监听
   - deploy.sh 一直把文件 rsync 到 /home/pi/www/Astro_firefly(这次也确实到了,
     index.html 17:54、59 个 KaTeX 字体都在),但没有服务对外提供
   - 补了 Caddy 容器 blog-caddy(--restart unless-stopped,配置 /home/pi/caddy/Caddyfile,
     站点根挂到 /srv:ro),http://192.168.1.87 现在正常,各页面 200

2) 云服务器的 Caddy 一条 encode 都没有,全站裸传
   - twikoo.min.js 506 KB、主 CSS 231 KB、首页 HTML 134 KB
   - 站点块加 encode zstd gzip(改前按已有习惯备份成
     Caddyfile.bak.gzip.20260915_175943,validate 通过后 reload)
   - 实测 twikoo.min.js 506108 -> 160547 B(省 68%),CSS 230615 -> 40822 B(省 82%)
   - Caddy 按 Accept-Encoding 协商 zstd / gzip,所有页面仍 200

README 与操作指南补了「两个目标各自怎么服务的」和 Pi Caddy 的重建命令,
并注明 1Panel 管的 Caddyfile 手改后要注意什么、reload 为什么是安全的。
2026-09-15 18:00:33 +08:00
dsh 9c0851fd12 修复 pnpm dev 启动刷红:Sketch.astro 脚本误识别 + .pnpm-store 撑爆 inotify
两个独立问题叠在一起,用户看到的只是第一个(扫描失败会中止启动,
第二个来不及暴露)。

1) Sketch.astro 的 frontmatter 里出现字面量的 script 开标签
   Astro 编译器靠扫描源码文本收集内联脚本,分不清真标签和字符串/注释。
   原代码用模板字符串拼 iframe 里的 resize 脚本,那个字面量开标签被当成
   组件脚本抽出来交给 Vite,里面的 ${JSON.stringify(...)} 直接报
   `Expected "}" but found "{"`,dev 依赖扫描失败、整个 /src 刷红。
   -> 改成 "\x3Cscript>" / "\x3C/script>" 拼接。
   注意闭标签原本写作 <\/script> 所以没被误判,只有开标签要处理。
   修完第一版又把解释写进注释、注释里带了字面量开标签,于是换了条错误
   (`Unexpected "。"`)继续报;这次注释也改成不带字面量的写法。

2) .pnpm-store 被 Vite 的 watcher 一起监听
   项目根目录下的 .pnpm-store 是 pnpm 内容寻址仓库(54269 个文件 / 672MB,
   已被 .gitignore 忽略),Vite 默认 watch 项目根,直接撑爆 inotify
   (max_user_watches = 65536),启动后无限刷
   `ENOSPC: System limit for number of file watchers reached`。
   -> astro.config.mjs 加 vite.server.watch.ignored: ["**/.pnpm-store/**"]。

顺带:package.json 加 "type": "module",消掉 Node 对
src/plugins/*.js 的 MODULE_TYPELESS_PACKAGE_JSON 警告(两个文件本来就是 ESM)。

验证
- 删掉 node_modules/.vite 强制重新做依赖扫描后启动 pnpm dev:
  ERROR 0 / Failed to scan 0 / ENOSPC 0,ready in 496ms
  /、/bookshelf/、/bookshelf/books/ 均 200
- pnpm build 退出码 0,MODULE_TYPELESS 警告 0
- 仅剩 [WARN] glob-loader 提示 src/content/studies 为空,属预期
- 操作指南补了这条 FAQ,说明两个原因和"注释里也不能写"这个坑
2026-09-15 12:22:44 +08:00
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