TimeCrackbot/NewBlog
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
64 Commits 1 Branch 0 Tags
4512d3fb24955efac9d1a7d1dfda27961f7c2e2b
Commit Graph
9 Commits
Author SHA1 Message Date
TimeCrackbot ec80ea7bd0 修复： 回到顶部按钮和进度条不显示的bug 2026-09-21 09:47:35 +08:00
TimeCrackbot f4a49ef94c feat: 支持 Obsidian 风格 callout，并把脚注文案中文化 
Callout
- 接入 satteri-callouts（HAST 插件），用 Obsidian 语法：
    > [!tip] 标题
    > 内容
    > [!warning]- 默认折叠
  类型名大小写不敏感，支持嵌套、可折叠、标题内联 Markdown。
- 样式没有用它自带的主题 CSS（Obsidian 原版是高饱和蓝/青/紫，还靠
  mix-blend-mode 叠底色，在暖纸底上会发脏），改为新建 src/styles/callouts.css，
  复用主题已有的 --admonitions-color-* token，与 .admonition（免责声明块）
  统一成「3px 左边框 + 彩色标题、无底色」。
- 类型映射：tip/hint→tip，note/info/todo/abstract/summary/tldr→note，
  important/example→important，warning/attention/question/help/faq→warning，
  caution→caution，success/check/done→（新增的）success，
  danger/error/failure/fail/missing/bug→destructive，quote/cite→muted-foreground。
- global.css 补一个 --admonitions-color-success（浅色 oklch(0.62 0.16 150) /
  深色 oklch(0.7 0.18 150)），与 tip(180)/note(250)/important(310) 同明度彩度。

脚注中文化
features.gfm.footnotes 设 label「脚注」、backLabel「返回第 {reference} 条」、
backContent「↑」，替换默认的 Footnotes / Back to reference。

正文
- 周末愉快.md：`::: tip 下周计划`（冒号后有空格，从来不是合法指令，
  一直渲染成普通段落）改成 `> [!tip] 下周计划`，任务列表一并加 `>` 前缀。
- 关于价值感和归属感的思考.md 的 `> [!tip] Tip` 本来就合法，一行未改，
  现在自动变成真 callout。

顺带修
autolink-headings 不再给脚注区那个 sr-only 的「脚注」标题加 # 锚点。

验证
- 两处 callout 均正确渲染；callout 内的图片仍带 data-lightbox-src
  （说明 imageLightbox 与 satteriCallouts 的执行顺序没问题）。
- 临时加了一篇带脚注和折叠 callout 的文章验证：脚注文案、返回链接、
  折叠态 <details>/<summary> 结构都正确，验证后已删除。
- 整页对比基线：37/41 一致，4 处差异中 2 处是本次有意的 callout 生效，
  另 2 处是已知的智能标点引号方向（Sätteri 的结果更正确）。
- pnpm build 41 页 + pagefind 通过。
 2026-09-17 18:01:44 +08:00
TimeCrackbot 5e808a9cd4 feat: 接入 KaTeX 渲染，完成 Sätteri 迁移（Phase 3） 
方案：用现成的 satteri-katex（MDAST 插件，40 行，是 rehype-katex 的移植），
而不是自己写。它跑在 MDAST 阶段，天然绕开下面这个坑。

为什么不能用 HAST 阶段做
Sätteri 把块级公式输出成 <pre><code class="language-math math-display">，
而 expressive-code 过滤所有 <pre>，会把它当成未知语言渲染成带行号的
plaintext 代码块 —— 实测 10 个块级公式全部被吃掉（math-display: 0）。
unified 时期没这问题，是因为 rehype-katex 排在 rehypePlugins 第一位，
先把 <pre><code> 换掉了。satteri-katex 的源码注释里记录的是同一个坑。

插件顺序
satteriKatex() 放在 mdastPlugins 最后：它把 math 节点换成 KaTeX 的 html
节点，若排在 reading-time / excerpt 之前，字数统计会把 KaTeX 标记也算进去。

顺带修掉一个之前漏掉的回归
reading-time / excerpt 原本用 ctx.textContent()，但它只拼接纯 text 节点，
会漏掉代码块、行内代码、公式、图片 alt。实测 LaTeX 那篇字数 830 → 488。
改用 mdast-util-to-string 的 toString()（与迁移前的实现一致），字数完全复原。
之前没发现是因为我的对比脚本只截取了 <article> 区域，而字数在它外面的 header 里。
现改为整页对比。

清理依赖（10 个，已确认无引用）
remark-math / rehype-katex / remark-directive /
remark-github-admonitions-to-directives / remark-sectionize / rehype-slug /
rehype-components / rehype-autolink-headings / @astrojs/markdown-remark /
hastscript / unist-util-visit

验证（与 unified() 基线整页对比，41 页）
- 39 页语义完全一致；2 页只剩智能标点在中文/emoji 旁的引号方向差异
  （Sätteri 的结果更正确：把开引号排成 “ 而不是 ”）。
- LaTeX 页：class="katex" 76、katex-display 10，与基线完全一致；
  块级公式不再被 expressive-code 吞掉。
- 字数/阅读时长与基线逐篇一致（830/4、1042/5、416/2）。
- pnpm build 41 页 + pagefind 通过；astro check 仍是 1 error/0 warnings
  （原有 footer.astro 报错，与本次无关）。
 2026-09-17 17:52:56 +08:00
TimeCrackbot 26e873b9f6 refactor: Markdown 管线迁移到 Sätteri（Phase 1 + Phase 2） 
把 markdown.processor 从 unified() 换成 Astro 7 的默认管线 satteri()，
并把原来 12 个 remark/rehype 插件逐一移植到 Sätteri 的 MDAST/HAST 插件模型。

内置能力直接替代（零代码）
- remark-math      → features.math
- remark-directive → 未启用（见下）
- rehype-slug      → satteriHeadingIdsPlugin()

新增 src/plugins/satteri/（6 个插件，约 200 行）
- reading-time.mjs    after 钩子写 ctx.data.astro.frontmatter.minutes/words
- excerpt.mjs         取第一段写 frontmatter.excerpt
- shift-headings.mjs  工厂按 fileURL 判断，只对 posts 下的文章生效
- sectionize.mjs      remark-sectionize 的等价实现（递归分组 + data.hName）
- autolink-headings.mjs  标题锚点，输出与 rehype-autolink-headings 逐字一致
- image-lightbox.mjs  上一版 rehype 图片灯箱的 HAST 版

删除（已迁移或本就无效）
- remark-reading-time / remark-excerpt / remark-shift-headings /
  remark-directive-rehype / rehype-component-admonition /
  rehype-image-lightbox —— 共 6 个旧插件文件
- 未启用 features.directive：内容里的 `::: tip`（冒号后有空格）和
  `> [!tip] Tip` 在迁移前后都渲染成普通段落/引用，属于死语法；
  保持现状以免升级顺手把它激活。

行为对齐
- smartPunctuation: { dashes: false } —— Astro 的 unified 管线会把直引号
  排成弯引号但不转换 ---，Sätteri 默认会转，显式关掉 dashes 才能逐字一致。

验证（与 unified() 构建逐页对比，41 页）
- 正文 HTML 完全一致 35 页；把 HTML 实体和表格对齐写法归一化后，
  只剩 3 页有差异：1 页是 KaTeX 尚未迁移（见下），2 页是中文/emoji 旁的
  引号方向（Sätteri 的结果更正确）。
- meta description 仍由 excerpt 正确生成；阅读时长与基线一致。
- astro check：1 error / 0 warnings，与迁移前完全相同（原有 footer.astro 报错）。
- pnpm build 41 页通过；dev server 正常。

尚未迁移
- KaTeX：Sätteri 的 math 只负责解析，不渲染。数学公式目前落成
  <code class="language-math">，是可见的回归，Phase 3 处理。
- package.json 里 remark-*/rehype-* 依赖暂未清理，等 Phase 3 确定后再收。
 2026-09-17 17:38:37 +08:00
TimeCrackbot 738fe3175e chore: 升级 Astro 5.16.5 → 7.3.3 
依赖
- astro 5 → 7.3.3，@astrojs/{mdx,react,rss,sitemap,check}、astro-expressive-code
  与 @swup/astro 同步升到最新
- 新增 @astrojs/markdown-remark（Astro 7 默认改用 Sätteri 处理器，
  本项目依赖大量 remark/rehype 插件，故显式固定回 unified 管线）

内容集合迁移到 Content Layer API（Astro 6 已移除旧 API）
- src/content/config.ts → src/content.config.ts，三个集合改用 glob() loader
- z 改从 astro/zod 导入
- 所有 entry.slug → entry.id；entry.render() → render(entry)

Astro 7 兼容
- 修复 bookshelf-content.astro 里多行 {/* */} 注释导致的 Rust 编译器
  "Unterminated regular expression"
- 删除该文件里一处多余的 </div>（旧 Go 编译器会静默纠正，新编译器不会）
- global.css: @import "tailwindcss" → "tailwindcss/index.css"
  （Vite 8 不再解析裸包名的 style 条件）
- astro.config.mjs 显式设置 compressHTML: true，保持 v6 的空白处理行为

验证：构建 41 页通过；与线上（Astro 5 构建）对比 39 个 URL 无一丢失，
仅新增新文章 DIY-computer 的 2 个 URL；逐页渲染文本与线上一致；
pnpm build 与 dev server 均正常。
 2026-09-17 17:14:08 +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 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 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 6f4cc13a20 初始提交：时之刃的小站 
基于 VermilionVoid（朱墨留白）主题的个人博客。
- 站点配置集中在 src/data/site.ts 与 src/data/profile.ts
- 30 篇文章、8 条偶得、相册
- 评论使用自托管 twikoo
- 部署走 deploy.sh（rsync 到树莓派 + 云服务器）
 2026-09-14 20:44:12 +08:00