TimeCrackbot/NewBlog
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
65 Commits 1 Branch 0 Tags
main
Commit Graph
65 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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
dsh 121a03dd85 作者卡片的状态小字挪到 profile.ts，文案可配置 
「正在空降：超级地球」原来硬编码在 sidebar.tsx 里，找起来费劲 ——
个人可见的文案应该和其它个人资料放一起。

- src/data/profile.ts 新增 status 字段，默认值就是原来那句
- sidebar.tsx 改成读 profile.status；值为空字符串时整行（含分隔线）不渲染
- README 里三处 profile.ts 的说明补上「状态小字」

验证：构建产物中该文案仍渲染 1 处。
 2026-09-15 10:13:45 +08:00
dsh 056b5faf98 去重「我的介绍」：页脚改放站点信息卡片，关于页入口只留在侧栏 
「我的介绍」重复
- 页脚原来那栏和侧栏作者卡片是同一份内容（同头像、同站名、同一句签名），
  手机端首页从头刷到尾会看到两次
- 页脚那栏整栏删除，只保留侧栏作者卡片
- 空出来的左侧位置给站点信息卡片

站点信息改成卡片
- 从原来横跨全宽的裸信息带，改成和侧栏作者卡片/分类卡片同一套语言：
  bg-card + border-border/50 + rounded-xl + p-5，标题带那道红色短竖线
- 内部 2 列 × 3 行：建站时间 / 已运行 / 文章 / 偶得 / 总字数 / 最近更新
- 桌面页脚高 529 -> 476px；手机 822 -> 760px（相比最初的 957px 共省 197px）

关于页入口
- 只留在侧栏作者卡片：站名和签名两行包在同一个 <a href="/about/"> 里
- 按要求去掉所有 hover 装饰（原来有头像描边转主色、站名转主色、箭头位移），
  也不再放「关于我 →」提示，两行就是安静的文字链接
- 头像不参与：下面社交图标本身是 <a>，<a> 不能嵌套 <a>

验证（headless Chrome 131，禁用缓存）
- 页脚站点信息卡片计算样式：bg oklch(0.98 0.011 84)、border 1px …/0.5、
  radius 12px、padding 20px，与侧栏卡片一致
- 页脚内已无「时之刃的小站 / 只是将博客作为新的爱好的普通人」字样
- 侧栏 <a> href=/about/，链接文本为「时之刃只是将博客作为新的爱好的普通人！」，
  className 为空（无 hover 类）；点名字跳转 /about/ 正常
- a a 嵌套数 0，无横向溢出；桌面/手机截图正常
 2026-09-15 10:05:55 +08:00
dsh 0cfcbd060e 页脚改版：删掉重复的导航栏，桌面补站点信息；我的介绍可点去关于页 
页脚「导航」栏
- 它是顶部导航的逐项复制（9 条名字和目标完全一样），手机上白占 312px
- 已整栏删除；桌面端改用「最新文章」（最近 4 篇，按发布时间倒序，
  不把置顶提前），把重复变成发现
- 手机端「最新文章」隐藏（上面就是文章列表，再列一遍没意义）
- 不影响 SEO：顶部导航 hidden md:flex 和移动端菜单里的同一批链接
  在每页 HTML 里都还在，爬虫照样抓得到

站点信息（新增）
- 新增 src/lib/site-stats.ts：文章数/偶得数/分类数/标签数/总字数
  在构建期算；「已运行 N 天」「最近更新」由页脚内联脚本按真实时间刷新，
  避免站点久不重建时数字停在构建那天；服务端先渲染构建时兜底值，关 JS 不空
- 页脚加一条站点信息带：建站时间 / 已运行 / 文章 / 偶得 / 总字数 / 最近更新
  桌面 6 列一行，手机 3 列两行
- 实测数值：2026-07-17 建站、已运行 60 天、30 篇文章、8 条偶得、
  2.9 万字、最近更新 59 天前

「我的介绍」跳关于页
- 页脚 BRAND 栏整块包 <a href="/about/">，加 hover 反馈（头像描边转主色、
  站名转主色、右上箭头位移）和常显的「关于我 →」提示（手机没有 hover，
  不能只在 hover 才出现）
- 侧栏作者卡片同样处理。注意这里**只包到签名那一段** —— 下面的社交图标
  本身是 <a>，<a> 不能嵌套 <a>；页脚 BRAND 栏没有嵌套链接，所以可以整块包
- 两处都给 aria-label，避免读屏把「头像 alt + 站名 + 签名」念成链接名

工程改动
- footer.tsx -> footer.astro：React 组件不能在构建期 await 统计数据，
  换成 Astro 组件后可以直接取；12 处引用同步改成默认导入
- README 补「页脚」一节，并修正组件路径

验证（headless Chrome 131，禁用缓存）
- 桌面 1280：页脚 529px，三栏（我的介绍/最新文章/联系）+ 站点信息 + 底栏，
  页脚内 nav 链接数 0，无横向溢出
- 手机 390：页脚 822px（原 957），最新文章 display:none，三栏只剩两栏
- 点页脚「我的介绍」-> /about/；点侧栏作者卡片 -> /about/，均正常
- 页面内 `a a` 嵌套数量：页脚 0、侧栏 0
 2026-09-15 09:55:26 +08:00
dsh 5532c35064 浅色改为暖纸底 + 纸纹底 + 移动端分类胶囊条 
浅色配色（global.css，暗色未动）
- 纯白底在屏幕上偏刺眼、大面积纯色没有视觉落点，整套浅色 token
  压到 L*≈96 并给暖黄彩度（oklch hue 84），墨色换成暖褐而非纯黑
- background #f8f3e9 / surface-subtle #f4eee3 / card #fcf8f0（比页面底亮，
  靠明度差拉层次）/ foreground #221d18 / border #dfd9ce
- 对比度仍留足：正文 15:1、content-secondary 7.5:1、muted-foreground 5.3:1、
  主色链接 4.9:1（AA 要求 4.5:1）
- secondary / sidebar / popover 等原来偏中性的 token 一并转暖，避免冷暖打架

纸纹底
- --paper-noise 用内联 SVG feTurbulence 分形噪声，无需图片文件；
  feColorMatrix saturate=0 去饱和得到带随机 alpha 的灰颗粒，
  因此不需要 mix-blend-mode 就能亮暗通用
- body::before 铺成 position:fixed 整屏颗粒，z-index:1（压在正文上、
  页眉 z-50 / 菜单 z-60 之下），pointer-events:none
- 颗粒浓度：亮色 0.2 / 暗色 0.22。实测亮度标准差 0.05→0.7、0.2→1.9、
  0.3→2.9（0=完全平整），选 2 左右这个「看得出是纸但不觉得脏」的档位
- 顺带让 backdrop-filter 有细节可模糊，此前纯色底上磨砂等于不存在

移动端分类胶囊条（article-list.tsx + sidebar.tsx）
- 移动端侧栏被排在文章列表下面（实测首篇 y=999、侧栏 y=3212），
  分类筛选基本摸不到；现在列表顶部多一条吸附胶囊条
- 复用同一份 categories / activeCategory / handleCategoryChange，不写第二套；
  末尾胶囊在「分类 / 标签」间切换；两端渐隐提示可横向滑；滚动条藏掉
- 把当前项自动滚到中间，只操作这条横向容器，不动页面纵向位置
- sidebar.tsx 的分类/标签块加 hidden lg:block，避免同页出现两份

其他
- 新增 --header-h: 69px（页眉实测高度），移动端菜单面板和吸附胶囊条
  都改用它定位，不再各处硬编码 69/76
- README 补「浅色配色」「纸纹底」「移动端分类胶囊条」三节

验证（headless Chrome 131）
- 390px：胶囊条可见、侧栏两块 display:none；点「思考」→ ?category=思考、
  列表 10→4 条、当前项高亮；切到标签模式列出 35 个标签；无横向溢出
- 1280px：胶囊条隐藏、侧栏分类恢复显示（display:block）
- 亮/暗两套截图正常，书架、文章页均无异常
 2026-09-15 09:37:14 +08:00
dsh 9d9f87a013 移动端美化：悬浮磨砂导航菜单 + 保守档字号 
菜单（site-header.astro）
- 全屏遮罩居中大链接 -> 仿 Firefly float-panel 的悬浮磨砂卡片：
  fixed top-[76px] 左右各留 12px，rounded-2xl，浅阴影，max-h 兜底防横屏溢出
- 菜单项 30px -> 18px，行高 44px，圆角 hover 底色；外链右侧加 ↗
- 当前页在构建期用 Astro.url.pathname 判定，高亮为主色文字 + 淡主色底
  + 正文标题那道红色短竖线（滑入/当前项显示）
- 入场动画改为「面板落下 + 逐项上浮」，节奏从 420ms 收到 300ms
- 遮罩从纯色全屏改为 background/45% + 极轻模糊，点它关闭
- JS 未改：data-open / ESC / body 滚动锁 / astro:before-swap 复位 / aria 全部沿用
- 补 :focus-visible 自定义焦点环（替掉浏览器默认那圈）、prefers-reduced-motion、
  prefers-reduced-transparency、@supports 回退

磨砂
- global.css 新增 --glass-bg / --glass-border / --glass-blur / --glass-saturate，
  由 --card 派生所以亮暗自动跟随
- 移动端页眉仍保持关闭常驻磨砂（原来就是有意为之），只有点开的菜单面板用

字号（只动 <768px，保守档）
- 正文/引用/列表 16.5px/1.85 -> 15.5px/1.78，行高密度约省 10%
- 文章 h1 30 -> 27px；正文 h2 30 -> 25；h3 24 -> 21；h4 20 -> 18
- 列表区标题 24 -> 21px
- 桌面端用 md: 前缀原样恢复

验证（headless Chrome 131，390x844 + 1280/800/700）
- 390px：正文 15.5/27.59、h1 27、菜单项 18；面板 445px 高、底边 511 < 844
- 1280/800px：正文 16.5/30.525、h1 48px，与改动前一致
- 亮/暗两套截图正常，无横向溢出
 2026-09-15 09:03:24 +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 4810c87d30 修复评论区不渲染：id 全局变量遮蔽导致脚本未加载 
容器是 <div id="twikoo">，浏览器会把带 id 的元素暴露成 window 上的同名
全局变量，所以脚本加载前 window.twikoo 已指向那个 DOM 元素。原守卫
if (window.twikoo) 因此误判「已加载」而直接返回，真正的 twikoo 库从未被加载，
表现为只显示「评论」标题、容器为空。

改为检查真正的 API：typeof window.twikoo?.init === "function"。

验证（jsdom 对线上页面实测）：init 为函数，容器渲染 23040 字节，
提交框/昵称/textarea 齐全，历史评论 |´・ω・)ノ 正常显示，无报错。

另：deploy.sh 的 PI_SITE_PATH 改为 /home/pi/www/Astro_firefly/（覆盖部署）
 2026-09-14 21:08:46 +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
dsh e029c69899 删除 9 个孤儿配图：8.72 MB 
这些文件只出现在 vitepress-blog-guide.md 的代码块示例里，从未被真实渲染。
删除后 public/assets 从 9.1 MB 降到 280 KB。
 2026-09-14 20:47:52 +08:00
dsh 8ecc08cfce 压缩文章配图：9 张转 WebP，1.99 MB -> 0.25 MB 
- 限宽 1920px、质量 82；有真实透明通道的两张（ubuntu-2604-desktop、
  墨菲定律图1）保留 alpha，其余去 alpha 转 RGB
- 同步更新 8 个 markdown 文件中的 9 处引用（含 Caddy 那篇的 frontmatter）
- Caddy.png 1368 KB -> 22.8 KB（原为截图存成 PNG）
- 已核对：全项目 0 处缺失引用
 2026-09-14 20:47:00 +08:00
dsh 6f4cc13a20 初始提交：时之刃的小站 
基于 VermilionVoid（朱墨留白）主题的个人博客。
- 站点配置集中在 src/data/site.ts 与 src/data/profile.ts
- 30 篇文章、8 条偶得、相册
- 评论使用自托管 twikoo
- 部署走 deploy.sh（rsync 到树莓派 + 云服务器）
 2026-09-14 20:44:12 +08:00