Zemengzhou Space
ZEMENGZHOU
ZEMENGZHOU SPACE · 专题研讨卷 · 网站建设
VOL. 2026 · NO. 05 · SPRING

关于本站：Zemengzhou Space

择梦舟
择梦舟Founder & Author
10.3k words39 min read

Zemengzhou Space 是一个由 Astro、GitHub、Vercel 与 AI 编程工具共同驱动的个人知识库，记录数学、控制理论、工程项目与生活。

SYNOPSIS · 导言提要

关于本站：Zemengzhou Space

泥嚎，这里是 Zemengzhou Space

这是我的个人博客 Zemengzhou Space。建站时参考了朋友 @Depaser 的博客和记笔记方式；网站设计、功能实现与文章整理也大量使用了 AI，所以如果你觉得 About 有一点“人机味”，判断得没错。

我把这里当作自用知识库，而不是一份需要反复润色的出版物。文章最重要的任务是保存思路，让未来的我能够迅速重新理解一个公式、一种解法或一段项目过程。语言是否精致并不重要，只要内容基本可靠、结构清楚、我自己能看懂就够了。

Zemengzhou Space 网站页面截图
网站首页：数学笔记、控制理论、工程记录与个人生活被整理在同一个空间里。

我怎样记笔记

这套流程是 @Depaser 教我的，我觉得很有意思：

  1. 把学习材料交给 AI，例如课堂截图、题目图片、文档或零散想法。
  2. 让 AI 先完成初步识别、整理与结构化。
  3. 把结果交给 Codex 或 Claude Code，继续总结、补全 Markdown 格式，并放入正确的内容目录。
  4. 由编程 Agent 检查改动、执行构建，再完成 git commit 与 git push。
  5. GitHub 仓库更新后，Vercel 自动构建并发布到 zemengzhou.com。

从一份资料到网站文章，通常不需要手动搬运文件或操作部署面板。很多时候，我只负责说明“想记录什么”和检查结果，其余工程步骤由 Agent 完成。

AI 偶尔也会给出意料之外的简便思路。例如：

AI 的答案并不天然正确，因此这些内容首先是我的学习记录，不应被视为无需验证的标准答案。

每日内容自动化

博客接入了知乎数据开放平台的热榜 API，并使用 GitHub Actions 将 Daily News 与 Friend Circle 合并为每天一次的自动化流程：

  1. 每天北京时间 22:00，GitHub Actions 启动定时任务。
  2. 脚本读取知乎热榜前 30 条数据，并由 DeepSeek API 按固定结构生成 Markdown 日报。
  3. 脚本抓取友链 Feed，生成最新文章聚合数据；文章没有变化时不会写入新的更新时间戳。
  4. 两类生成文件由 github-actions[bot] 一次性提交并推送，只有真实内容变化才会产生提交。
  5. Vercel 检测到仓库更新后重新部署。

生成结果会呈现在 Daily News 和 Friend Circle 页面。

搜索与知识助手

搜索页面 的视觉与交互参考了 Claude 的安静对话式布局，但保留了两种不同入口：

  • Keyword search：读取构建时生成的 /search-index.json，按标题、摘要、标签和正文片段加权检索。
  • AI search：先检索真实站内文章，再把相关内容交给 Agnes 3.0 Flash 生成中文回答，并列出引用文章。

Agent 由 Sapiens AI 的 Agnes 3.0 Flash 驱动，目前作为实验性方案使用。会话支持多轮追问、Markdown、KaTeX 公式和本地历史记录；历史保存在访问者自己的浏览器中。回答被要求以本站内容为依据，但精确结论仍应打开原文核对。

Zemengzhou Space 搜索与知识助手页面
同一入口支持关键词检索与 AI 对话；Agent 回答会附上实际命中的站内文章。

内容方向

  • 高等数学：积分、极限、微分方程与常见解题方法。
  • 自动控制原理：根轨迹、频率响应、稳态误差与系统分析。
  • 课程设计与工程项目：控制柜接线、运动控制与项目过程记录。
  • 数字信号处理与线性代数：课程知识的系统整理。
  • 个人生活：不定期更新。

技术实现

层级当前实现
框架Astro v6；内容页面以静态输出为主
内容Astro Content Collections + Markdown frontmatter
页面切换Astro ClientRouter / View Transitions，保留 SPA 式体验
数学渲染KaTeX、remark-math、rehype-katex
关键词搜索构建时生成 /search-index.json，正文索引截取 600 字
AI 搜索Vercel Function + Agnes 3.0 Flash + 站内内容检索
评论Waline，自建服务端
图片Astro 内建 Sharp 优化、WebP、lazy loading 与显式尺寸
自动日报GitHub Actions + 知乎热榜 API + DeepSeek API
友链聚合GitHub Actions + RSS/Atom 抓取 + 增量缓存
SEO / 订阅Canonical、Open Graph、Twitter Card、RSS、Sitemap
部署GitHub main 分支连接 Vercel，推送后自动发布

页面地图

路径内容
/首页、分类入口、近期文章与站点状态
/archive文章归档、时间线与统计
/tags标签索引
/news自动生成的每日知乎热榜与历史档案
/search关键词搜索与 AI 知识助手
/about本页：网站、工作流与技术实现
/changelog网站更新记录
/kaoyan考研知识库手稿、各科目知识点与错题集索引
/guestbook公共留言板
/links友链与申请入口
/posts/[slug]文章详情、分级目录、系列导航、阅读时长、评论与相关文章
/rss.xml全站文章 RSS
/sitemap-index.xml搜索引擎站点地图

项目结构

src/
├── content/
│   ├── blog/                  # Markdown 文章与配图
│   ├── briefings/             # 自动生成的每日热榜简报
│   └── kaoyan/                # 考研数学、控制理论、政治等手稿库
├── pages/
│   ├── posts/[...slug].astro  # 文章详情
│   ├── news.astro             # 日报历史日历与概览
│   ├── briefings/[...slug].astro # 日报详情页
│   ├── search.astro           # 双模式搜索与会话界面
│   ├── search-index.json.ts   # 静态全文索引
│   ├── rss.xml.js             # RSS
│   └── ...                    # 首页、归档、标签、About 等
├── layouts/BaseLayout.astro   # 导航、主题、SEO 与页面骨架
├── components/                # TOC、评论、侧栏、音乐播放器等
├── styles/global.css
└── utils/                     # 排序、分组、阅读统计与相关文章
api/
└── ai-search.js               # Agnes 服务端代理与内容约束
.github/workflows/
└── daily-content-refresh.yml   # 每日热榜与友链定时同步
scripts/
├── generate-daily-zhihu-briefing.mjs
└── generate-friend-feed.mjs

写作格式

每篇文章都使用 Markdown，并在文件头声明 frontmatter：

---
title: 文章标题
date: 2026-05-22T21:00:00+08:00
description: 一句话摘要。
tags:
  - 高等数学
draft: false
---

文件名决定 URL slug；draft: true 的文章不会进入列表、搜索、RSS 或站点地图。数学公式行内使用 $...$，块级使用 $$...$$。

数学题目还可以使用专门环境：

:::: choice
选择题题干

::: options
A. 选项一
B. 选项二
C. 选项三
D. 选项四
:::
::::

::: solution
解答过程
:::

填空题使用 ::: blank，解答题使用 ::: written。渲染后，题干、选项和解答会形成清楚的独立区域。

AI 与维护

建站前期主要使用 Claude Code。自 2026 年 6 月 10 日起，Codex 逐渐承担文章更新、页面改版、Bug 修复、构建验证与 Git 推送。原因很简单：Claude 太贵了。

现在，这些工具主要处理三类工作：

  • 建站与改版：实现 Astro 路由、搜索、KaTeX、Waline、TOC、SEO、响应式样式和各类交互。
  • 文章发布：放置文件、补全 frontmatter、检查 Markdown、构建并推送。
  • 日常维护：根据对话修改组件、审阅差异、定位线上错误，再提交修复。

典型发布流程仍然很朴素：

git add .
git commit -m "描述改动"
git push

区别只是，这三行命令现在通常也由 Codex 或 Claude Code 执行。Vercel 收到 GitHub 更新后，会在约一两分钟内完成新版本部署。

联系

我也会在知乎记录内容：知乎 / 择梦舟。如果想讨论文章、指出错误或交换友链，也可以直接使用本站的留言板。

更新日志

2026-09-16 · v2.0.1 — Dual-Brain Architecture & Performance Hardening

  • 落地 Antigravity × ChatGPT 双脑协同工程体系与高交互架构探索器。
    • 发布深度手记《基于 Antigravity 与 ChatGPT 构建协同进化双脑工程系统》，全面拆解超大 Prompt 传输分块、提交状态机因果性重构、跨平台字符防御以及本地实机 CDP 隧道闭环审查机制。
    • 打造 Sanyam 极客风格的高自由度交互组件 DualBrainArchitectureExplorer.astro，支持全站文件树漫游、四层架构实时交互、高亮代码切片展示与终端执行回放。
  • 全站 SSG 构建性能暴增与考研别名极速分流。
    • 考研知识库全面转向客户端智能重定向（src/pages/404.astro），利用 kaoyan-alias-map.json（收录 3,566 条精准映射与别名保全）瞬时分流历史笔记，永久削减 1,490 个冗余静态 HTML（全站页面从 2,142 降至 652，减幅 69.6%）。
    • 全站 Astro 生产构建耗时由 111.7 秒大幅提速至 22.9 秒（构建提速近 80%），重用持久化内容层缓存，新增 npm run build:clean 深度清理命令。
    • 落地全站数据快照单例模式（src/utils/buildSnapshot.ts），将全局导航 5 大集合与更新日志由每页重复 I/O 改为构建期单例 Promise 内存共享，消除 650+ 次磁盘重复遍历。
  • 站内与 AI 搜索全量打通，考研数据管道全方位加固。
    • 修复搜索“双重漏检”：search-index.json 全量打通博客、考研手稿与每日简报，api/ai-search.js 放行考研手稿白名单，全站私有知识检索覆盖面扩大 37 倍。
    • 考研数据防御体系：彻底清洗全站 UTF-8 BOM 字符，修复 63 篇被误写为 --- 的笔记描述；同步脚本（sync-kaoyan-to-astro.mjs）引入数量底线（Fail-Safe）阻断与孤儿删除安全阈值保护，加固二重 frontmatter 正则，杜绝误伤正文分割线。
    • 别名生成器自动化集成：兼容 YAML 多行列表与行内数组语法，增加 Unicode NFC 规范化与别名冲突检测，并在 package.json 中配置 prebuild 自动化守护，确保构建期别名字典与手稿完全同步。
  • 客户端运行时生命周期治理与零流量媒体策略。
    • 音乐播放器（MusicPlayer.astro）落地 preload="none" 惰性装配与零流量网络策略，未点击播放时 0 音频网络请求；加固断点续播时间戳状态记忆与未就绪拖拽定位（pendingSeekRatio）。
    • 3D 角色视口（KazuhaViewer.astro）引入视口交叉观察器（IntersectionObserver）与后台休眠，新增 destroyed 卸载竞态守卫与递归资源销毁，杜绝 SPA 路由快速切换时的 GPU 显存泄漏。
    • 客户端 Mermaid 渲染器（BaseLayout.astro）引入 window.__zemengzhouMermaidBound 幂等守卫，消除 Astro 客户端路由（ClientRouter）多次跳转导致的观察者叠加。

2026-09-14 · v2.0.0 — Editorial Design System & Agnes 3.0 Flash

  • 全站全面落地杂志化排版系统（Editorial Design System 2.0），视觉深度统一。
    • 以 /space/ 漫游空间刊头为基准，抽象出统一的 editorial-system.css 核心样式层与 EditorialMasthead.astro、EditorialSectionHeader.astro、EditorialPostRow.astro 标准刊物组件。
    • 完成 Article（正文与考研手稿）、Archive（归档）、Authors（作者）、Tags（标签）、Category（分类）、Changelog（更新日志）、Links（友链及子板块）与 About（关于）全站核心板块的视觉重塑，统一宣纸肌理、刊头元数据条与低饱和朱砂金错配色。
    • 彻底去除各板块割裂的独立边框与旧式卡片，全面转向纯净杂志流式排版。
  • 作者名录与标签索引页流式交互重构。
    • Authors 作者名录页（authors/index.astro）重构为单列雅致人物流（Single-Column Author Stream），清晰呈现作者简介、知乎主页与代表作列表。
    • Tags 标签索引与分类页还原植物半透明覆层（Botanical Veil）与协调明快的分类标签配色体系。
  • 桌面端 1488px 固定设计画布与视口几何锁定（Desktop Fixed Canvas Geometry）。
    • 确立桌面端 --portal-desktop-width: 1488px 与 --portal-content-width: 1376px 固定设计基准，防止桌面窄窗时出现文字挤压与立绘变形。
    • 锁定 Journal Hero 桌面级版式规范，并新增自动化画布校验脚本（scripts/verify-desktop-canvas.mjs），保障全站视口几何稳定性。
  • 站内双模知识助手升级至 Agnes 3.0 Flash。
    • AI Search 服务端接口全面接入 Sapiens AI 最新一代 agnes-3.0-flash 模型，大幅提升站内私有知识库问答的推理速度、长文摘要与原文检索综合能力。
    • 同步更新全站关于页、技术栈矩阵及架构文档中的模型标识与服务说明，保持全站信息一致性。

2026-09-13 · v1.9.4 — Fixed Desktop Canvas & Terminal Article UI

  • 重构全站响应式策略与移动端隔离体系（Touch-Isolated Responsiveness）。
    • 终结桌面浏览器窄窗（500～800px）误切 Mobile UI 的问题：引入 (hover: hover) and (pointer: fine) 保证桌面端始终维持完整的 Desktop 布局、导航、卡片结构与横向滚动机制。
    • 将全站 25+ 处 max-width 响应式断点（汉堡菜单、移动抽屉、TOC 悬浮胶囊等）严格限定为真实触控设备专用（and (hover: none) and (pointer: coarse)）。
    • 同步重构 TableOfContents.astro 和 index.astro 内的 window.matchMedia 检测，杜绝桌面端视口收缩时意外隐藏侧栏目录或降级动效。
  • 首页落地 1488px 桌面固定设计画布（Desktop Fixed Canvas Composition）。
    • 引入 --portal-desktop-width: 1488px 与 --portal-content-width: 1376px，桌面缩窄浏览器仅缩小可视视口，不重新计算首页构图，彻底消除文字重排与边距挤压。
    • 修复 CSS 声明顺序问题，将桌面固定媒体查询放置于基础样式之后，确保左下山水画（.maple-bg-landscape）锁定 340px 不被覆盖。
    • 彻底解决立绘被挤小问题：舞台高度锁定为 700px、最小宽度 480px，同时移除图片与 <picture> 的 max-width: 100% 约束，立绘不再随列宽等比缩小。
  • 新增技术文章终端会话导引组件（Terminal Article Intro UI）。
    • 打造极客风格的文章篇首终端卡片（TerminalArticleIntro.astro），支持多标签页切换视觉、命令行输出流与动态闪烁光标。
    • 在技术手记文章（如 VPN 与 WireGuard 调试记录）中自动嵌入正文一级切片处，并同步匹配暗色与触控适配规范。

2026-09-13 · v1.9.3 — Semantic Callout Engine & Pipeline Hardening

  • 架构升级：构建全站语义化 Callout 块解析引擎（Semantic Callout Engine）。
    • 实现基于 mdast 的独立 Remark 插件（src/utils/remark-callouts.mjs），统一支持 GitHub 规范的 5 种基础 Alert（[!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION]）与考研知识库专属的 5 类学术语义块（[!THEOREM]、[!EXAMPLE]、[!SOLUTION]、[!ANALYSIS]、[!SUMMARY]）。
    • 兼容历史手稿中多样化的 Emoji 与中英文括号标记（如 > 💡 **【技巧与方法】**、〖经典例题〗、【SOLUTION】、**【解】** 等），Unicode 正则全面启用 /u 标志安全匹配。
    • 首创标题 AST 行内保留技术，标题中的行内代码与 KaTeX 数学公式（如 $o(\rho)$）能完整解析为 KaTeX 节点，杜绝公式源码裸露。
    • 支持多标记连续引用块（Continuous Blockquote）自动切片，将同一 <blockquote> 内部的例题与解答精准拆分为同级 <aside> 兄弟节点，非标记普通引用严格保留原样 <blockquote>。
    • 采用解耦的语义化属性输出：<aside class="callout callout--{kind}" data-callout="{kind}" data-callout-tone="{tone}">。
  • 视觉呈现：融入暖宣纸茶白与黑漆金错的 10 阶低饱和色彩体系。
    • 为 10 种 Callout 语义音调（neutral、positive、accent、warning、danger、theorem、example、solution、analysis、summary）精调日间暖调与暗黑矿物微光主题变量。
    • theorem（定理）采用 3.5px 学者墨蓝实线，确立公理与核心结论的权威层级。
    • solution（解答）专为长篇数学推导打造高通透微底色（日间 rgba(255, 255, 255, 0.35) / 夜间 rgba(255, 255, 255, 0.02)，移除浓重阴影），从根源消除多步骤大段推导的视觉色块疲劳。
    • 为 Callout 容器内部公式配置 .prose .callout .katex-display { overflow-x: auto; overflow-y: hidden; }，杜绝长公式截断或横向溢出破框，并适配移动端（max-width: 640px）紧凑边距。
  • 代码块元数据与免复制控制管线。
    • 引入 rehype-code-meta.mjs，从 Shiki 高亮节点中提取语言标记并在右上角标准化渲染为大写语言标签（如 POWERSHELL、BASH、WIREGUARD）。
    • 在 astro.config.mjs 中为 Shiki 配置 langAlias，规范 wireguard/wg（映射为 ini）及 output/log/terminal（映射为 text）。
    • 终端命令输出块（output / terminal-output）自动注入 data-code-kind="output"，并在 ArticleTools.astro 层面自动剔除复制按钮，仅保留可执行命令的复制入口。
  • 构建管线加固与 CI 缓存自愈机制。
    • 针对 Astro 5/6 Content Collections（glob loader）基于内容 digest 导致 CI 构建复用旧 AST 缓存的问题，开发跨平台预构建脚本（scripts/clean-content-cache.mjs）。
    • 在 package.json 的 build 阶段前置运行缓存清理，确保在 Vercel 等 CI/CD 自动化构建中任何 Markdown 语法管线改动均能 100% 触发全量重新编译。

2026-09-10 · v1.9.2 — Editorial Typography & Architecture Decoupling

  • 实施核心架构解耦与冗余依赖清理。
    • 彻底移除已下线题库管理相关的遗留代码，包括全部 api/problem-*.js 接口文件与 server/ 下的 GitHub 文件管理、身份鉴权及 Markdown 处理器。
    • 清理工程依赖库，移除未使用的 React（@astrojs/react、react、react-dom）、Tailwind CSS（tailwindcss、@tailwindcss/vite）及 Motion 等依赖与 Vite 插件配置，回归轻量、高效的原生 Astro 架构。
    • 梳理工具函数库，移除数学与博客模块中废弃的未调用函数（如 renderMathText 等）。
    • 完整保留现有文章、图片资源、考研笔记及全部内容素材，2052 个静态页面顺利编译通过。
  • 重构文章详情页标题排版与换行体验。
    • 解决中英混排标题因 text-wrap: balance 导致的非正常断行与右侧留白问题，统一调整为 text-wrap: wrap; word-break: normal; 与舒展的流体字号（clamp(1.75rem, 2.6vw, 2.5rem)）。
    • 优化文章导言提要（SYNOPSIS），移除尾部自动附带的创作者个人格言，保持篇首阅读纯粹专注。
  • 规范卷末落款文案并定制多作者朱砂篆刻印章体系。
    • 简化卷末收录陈述，统一规范为庄重典雅的文人式表述：「本文由 {postAuthor} 执笔撰作，收录于 Zemengzhou Space。」。
    • 在博客工具层（src/utils/blog.ts）引入创作者专属印鉴与主页动态分发机制，支持不同创作者展现专属印章与对应知乎链接。

2026-09-10 · v1.9.1 — Spatial Page-Turn & Model Upgrade

  • 首创「风翻书页，枫叶入笺」跨视口无缝全屏纸张翻页转场（Page-Turn Transitions）。
    • 引入全屏宣纸揭页幕布（PageTurnCurtain.astro）与核心状态机控制器（page-turn.ts），以 130vw 柔和宣纸纹理、双侧折痕微光与横向立体阴影覆盖全视口与播放器，实现首页到空间漫游的物理翻书质感。
    • 深度结合 Astro ClientRouter 生命周期（before-preparation / before-swap / page-load），在首帧绘制前将新页面预置为覆盖态并无缝揭开，免除 SessionStorage 依赖，彻底终结切页白屏与闪烁。
    • 重构首页「循风入卷 · OPEN THE JOURNAL」和风朱砂卡片按键，起风粒子动效与内页网络预载并行，配套超时容错与 AbortSignal 取消保护。
    • 内页 /space/ 刊头永久入驻朱砂枫叶标，从首页进入时自动跳过 720ms 模糊延迟与题辞墨滴动效，题辞开卷即阅，落枫轻盈化为刊头书签。
  • 自动化内容生成模型改用 deepseek-flash。
    • 每日资讯简报生成脚本及 GitHub Actions 工作流全面接入 DeepSeek 官方标准模型 deepseek-flash，降低推理延迟与调用成本，保障内容自动化更新的长期稳定。
  • 实施代码库瘦身与冗余组件清理。
    • 彻底移除已下线的时钟天气挂件（ClockWeatherCard.astro）、旧版归档统计卡片（ArchiveStats.astro）及冗余脚本。
    • 保持全站构建零警告、零残留，2002 个静态页面高效快速生成。

2026-09-09 · v1.9.0 — Mobile Editorial & Lacquer Aesthetics

  • 落地移动端杂志化信息流（Mobile Editorial Flow），实现首页免跳转沉浸阅读。
    • 重构移动端首屏 Hero，以居中书法徽标搭配淡墨鸟居远山轻量背景，停用触屏下的重型粒子 Canvas 与 3D 倾斜监听，零掉帧且大幅降低设备功耗。
    • 移动端首页新增四大刊物章节：RECENT / 01 无边框杂志文章流、MASTERY / 02 考研四科横向手势滑轨（Scroll Snap）、PROJECTS / 03 精选置顶卡片与分类胶囊、LINKS & ABOUT / 04 精简直达导航。
  • 重构移动端顶栏与刊物级全屏抽屉菜单（Publication Drawer）。
    • 顶栏精简至 56px 并适配 iOS 顶部安全区（env(safe-area-inset-top)），集成全局搜索、明暗主题切换与智能滚动显隐机制。
    • 全屏抽屉菜单采用宣纸质感磨砂背景与纯扁平刊物目录，取代多层级手风琴折叠，支持直达子页面并支持键盘 Escape 快速关闭。
  • 打造移动端悬浮迷你音乐播放器与抽屉式展开面板（Bottom Sheet）。
    • 新增常驻悬浮迷你音乐胶囊，适配底部安全区（safe-area-inset-bottom），支持单击播放/暂停与轻触展开面板。
    • 引入向上滑出的抽屉式完整播放器面板，配备顶部拖拽指示条、方形黑胶唱片封面、进度拖动条与大尺寸触控按键，并完善减少动态效果（prefers-reduced-motion）降级适配。
  • 优化触控人体工学、黑红漆器暗色调与全站基础体验。
    • 规范移动端交互触控热区，导航、操作图标及外链按钮命中区域均调整至 ≥ 44px × 44px。
    • 首页 Portal 确立黑红漆器（Lacquer Dark #0d0b0b 与 朱砂红 #bd2a2a）深色调视觉体系，提升暗色模式下的阅读对比度与边框质感。
    • 更新首页预览截图与站点标语（“择梦舟的奇幻漂流”），规范建站年份为 2026 年，并为每日知乎热榜生成脚本增加备用模型（fallback model）容错机制。

2026-09-05 · v1.8.1 — Reading Tools & Runtime Polish

  • 抽离文章与考研笔记共享阅读工具组件，修复现代 CSS 颜色下的 PDF 导出。
    • 新增 ArticleTools.astro 共享组件，合并文章页（posts/[...slug]）与考研笔记页（kaoyan/[...slug]）的代码复制与 PDF 导出逻辑。
    • 将 html2canvas 替换为支持现代 CSS 颜色函数（如 oklab、color-mix）的 html2canvas-pro，修复客户端 PDF 导出失败问题。
  • 优化页面脚本生命周期与资源加载，提升运行时性能。
    • 优化 Astro 客户端导航（View Transitions）后的脚本生命周期，避免页面切换时导航栏、归档热力图、考研筛选等交互逻辑重复绑定。
    • Waline 评论系统改为接近视口区域时按需懒加载（Intersection Observer），大幅减少首屏客户端 JS 体积与网络请求。
    • 将多个内联脚本重构为 Astro 规范的模块化脚本，音乐播放器（MusicPlayer.astro）改为 ES Module 导入以利于构建打包与缓存复用。
  • 优化首页 Canvas 动画策略并移除强制手势跳转。
    • 移动端设备（max-width: 768px）及开启“减少动态效果（prefers-reduced-motion）”偏好时不运行 Canvas 动画。
    • 页面无交互空闲时自动停止持续重绘（RAF），降低设备发热与 GPU 占用。
    • 移除首页滚轮、触摸滑动及空格键强制跳转至 /space/ 的逻辑，交互更加自然平稳。
  • 完善移动端极窄屏排版适配并清理冗余代码。
    • 修复 320px 与 390px 移动端设备下的横向布局溢出，优化考研笔记卡片与筛选操作栏的排版紧凑度。
    • 清理已废弃的旧版 React 首页组件（HomePage.tsx）及 home-portal.css 中约 100 行无效废弃样式。

2026-09-04 · v1.8.0 — Editorial Feed & Stream Timeline

  • 重构 Archive 归档页，采用双栏极简流式时间轴（Timeline Stream）。
    • 去除右侧多余边栏与冗余考研/站点统计卡片，让归档内容区获得更充裕的横向展示空间。
    • 引入流式时间轴中轴线与年月里程碑节点，增强年份切换与时光脉络的视觉连贯性。
    • 优化热力图点击联动，点击热力方块可平滑定位并高亮对应日期的文章节点，并支持标题 LaTeX 公式渲染。
  • 深度改版 News 每日资讯简报，打造杂志级排版与多维回溯体验。
    • 提取知乎热榜当日高赞摘要与精炼导读，标注核心话题标签，提高每日资讯的扫读效率。
    • 新增月份快速切换标签栏与嵌入式迷你日历视图，强化往期资讯的日期回溯与定位。
    • 优化各平台热度徽章与外部链接交互细节。
  • 重塑 Tags 标签索引页，新增 Tag Mix 分布并精简整体布局。
    • 用 Tag Mix 比例堆叠条与色彩交互芯片替换原有分类折叠菜单，直观呈现全站各话题权重占比。
    • 移除右侧 Site Stats 卡片与多余边栏，将全站标签文章分组扩展为宽幅统一排版。
  • 优化全站侧边栏与桌面首页交互细节。
    • 侧边栏分类卡片采用通透质感的毛玻璃磨砂效果（Frosted Glass），移除冗余的时钟天气挂件。
    • 调整侧边栏栅格宽度，解决英文长分类名折行截断问题。
    • 首页支持滚轮及触摸手势直接平滑过渡至 /space/ 漫游空间。
  • 完善 SSR 水合与视图切换（View Transitions）定时器生命周期。
    • 解决客户端路由切换时的定时器残留与初始渲染白屏闪烁问题。

2026-07-19 · v1.7.2 — Site Consistency

  • 统一首页内容区、Archive、Tags 与 About 的站点统计数据源。
    • 构建时统一计算文章数、标签数、字数、最早发布日期和最后更新时间，并生成 /site-stats.json。
    • 新增构建后自动校验；首页内容区、Archive 与 About 的统计不一致时直接让构建失败。
  • 将桌面端与移动端导航收敛为同一份全局配置。
    • 补齐 Problems、Circle 等入口，统一 Article、Archive 和 Tags 的命名与说明，并在桌面导航直接显示 Search。
  • 提高站内搜索的可发现性和内容核对体验。
    • 在首页内容区增加关键词搜索框，搜索页默认进入关键词模式，并将 AI Search 标记为 Experimental。
    • 合并重复的新会话概念，空历史时隐藏历史入口，AI 回答默认展开来源并提示打开原文核对。
  • 完善音乐播放器的失败和持久化状态。
    • 音频不可用时隐藏播放器及入口，不再占用阅读版面或暴露开发路径。
    • 记住音量、曲目、播放位置与播放状态，移动端继续默认收起。

2026-07-17 · v1.7.1 — Problem Library

  • 重构公开题库与管理工具的边界，并为题目管理加入服务端身份验证。
    • 新增独立学科页、合集页和管理入口，完善题目发布、更新、删除、恢复、历史记录与部署状态流程。
    • 支持批量整理题目、补充图片和题解图片，并改进截图归档、实时预览与公式显示。
  • 新增并整理多道线性代数与高等数学题目。
    • 补充矩阵秩、线性相关、相似对角化、二次型和积分题目的题面、解答与知识点。 2026-07-16 · v1.7.0 — Problem Capture
  • 上线 Agnes 截图题目整理与多题录入工作流。
    • 支持题目图、解答图分离上传，多题连续处理、分栏实时预览和归档前检查。
  • 改进题库管理与阅读页面。
    • 增加认证发布、题目管理预览和 LaTeX 展示，清理早期示例题并修正已有题目内容。
  • 新增并完善午夜深色主题。
    • 调整深色首页内容、人物图和题库页面的背景层次与阅读对比度。

2026-07-04 · v1.6.1 — Daylight Theme

  • 取消昼夜主题切换，统一使用与站点内容相协调的日间浅色模式。
    • 继续沿用米白背景、暖色玻璃卡片和低对比度配色，让不同页面保持一致、简约的阅读体验。

2026-07-03 · v1.6.0 — Watercolor Portal

  • 重设计首页为水彩流体揭示式入口，并统一首页导航与背景的融合关系。
    • 调整首屏人物、书法标记、内容分布与流体遮罩，让首页过渡和信息层次更自然。
  • 将桌面端二级导航升级为宽幅双栏悬浮面板。
    • 左栏保留栏目入口，右栏分别展示最近文章、题目、新增友联与 Changelog，展开时虚化导航外区域。
  • 优化手机端导航菜单的打开状态。
    • 菜单面板展开及收起动画期间隐藏顶部导航条，避免导航条透过遮罩干扰阅读与操作。

2026-07-02 · v1.5.2 — Homepage and Navigation

  • 重做首页首屏结构，保留圆形头像、站点名和简短入口，弱化其他干扰内容。
    • 让首页作为个人知识库入口继续向下衔接原有内容区，保持浏览路径连贯。
  • 调整导航栏的滚动交互与移动端表现。
    • 顶部导航在滚动时改为更紧凑的浮动状态，并修复移动端二级导航的交互问题。

2026-06-30 · v1.5.1 — Mobile Polish

  • 优化手机端顶栏，只保留站点名、Search、Music、日间夜间切换与更多图标。
    • 移除“更多”文字标签，统一移动端操作区的视觉密度与点击节奏。
  • 修复移动端更多菜单在切换其他板块后无法再次点击的问题。
    • 重新整理页面切换后的菜单初始化与关闭状态，避免事件监听失效。
  • 调整 Links 页面 Friends 区块在手机端的卡片排版。
    • 友链卡片改为完整占满单列宽度，并同步收紧间距与内边距。

2026-06-29 · v1.5.0 — Friend Circle

  • 在 Links 下新增英文的 Circle 页面，聚合除本站外所有友链的最新文章。
    • 统一按发布时间排序，只保留最新 10 篇，并在 Links 首页增加入口卡片预览。
  • 将友链数据抽离为独立数据文件，并新增静态抓取产物，减少页面内联维护成本。
    • 友链聚合结果单独生成，构建时直接读取，不依赖访问时实时请求。
  • 新增 GitHub Actions 定时刷新流程，后续自动抓取友链 Feed 并推送部署。
    • 与每日新闻合并为每天北京时间 22:00 执行，由 github-actions[bot] 自动 commit、push，并由 Vercel 自动重新部署。
    • 友联文章没有变化时保留原更新时间，避免产生无意义的时间戳提交。

2026-06-28 · v1.4.0 — Knowledge Assistant

  • 搜索页升级为关键词搜索与 Agnes AI 双模式，结果统一进入对话流。
    • 支持多轮会话、历史回滚、新建对话、Markdown 与 KaTeX。
    • 回答绑定真实检索结果，并修复空结果与引用文章状态不一致的问题。
  • 文章阅读页改为平面文档布局，重构标题简介和分级目录。
    • 去除正文外层玻璃卡片，恢复独立简介字形并优化各级标题视觉层次。
  • 统一文章、About 与日报的移动端目录，使其与顶部导航融合并支持当前章节展开。
    • 修复目录中的 KaTeX 公式渲染和移动端宽度问题。
  • 重写 About 页面结构、说明文字与配图。
    • 补充网站工作流、技术栈、页面地图、AI 助手和自动日报说明。
  • 修复搜索图标按键后变色放大、引用图片失效和 AI 服务错误提示不明确的问题。

2026-06-27 · v1.3.1 — Newsroom

  • 首页加入悬浮导航和最新日报入口，并统一二级导航样式。
    • 将辅助入口收进顶部菜单，调整悬浮位置、间距和触控区域。
  • Daily News 归档改为日历视图，规范日报标题与发布时间。
    • 首页当天新闻与文章流对齐，恢复日报摘要显示。
  • 优化文章容器、首页间距和子菜单交互。

2026-06-26 · v1.3.0 — Daily Briefing

  • 上线 Daily News 与备考日程页面。
    • 备考日程支持响应式时间表，日报列表采用独立新闻展示方式。
  • 接入知乎热榜 API、DeepSeek 和 GitHub Actions，自动生成每日简报。
    • 固定北京时间 14:00 执行，加入格式校验、失败重试、自动提交和推送。
    • 增强新闻容器、外部链接和日报目录锚点的稳定性。

2026-06-25 · v1.2.1 — Mobile Focus

  • 优化移动端首页布局，在窄屏隐藏拥挤的辅助面板。
    • 保留核心内容流和品牌标题，减少首屏横向溢出。
  • 采用重建后的工程英语复习工具页面，并更新首页封面展示。

2026-06-24 · v1.2.0 — Review Desk

  • 上线独立的工程英语复习工具页面。
    • 支持课程切换、拼写练习、答案显示和键盘快捷键。
  • 修复页面乱码、练习顺序和移动返回操作。
    • 规范静态资源路径、术语数据和按键提示。

2026-06-23 · v1.1.0 — Homeward

  • 重设计首页，加入分类侧栏、公告卡片、站点快照与新的内容流布局。
    • 对齐首页与 Archive 的内容宽度，平衡快照卡片和分类栏比例。
  • 优化友链卡片资源、排序方式和申请页说明。
    • 增加站点截图并修复外链图片显示。

2026-06-22 · v1.0.0 — Friendship Links

  • 正式上线友链列表与友链申请入口，作为网站首个稳定版本。
    • 提供友链展示、申请示例和独立申请路由。
  • 部署自建 Waline 服务，并接入文章评论、留言板和友链申请评论区。
    • 增加默认服务地址和页面切换后的重新初始化逻辑。
    • 提供 Docker Compose、Nginx 与环境变量部署配置。

2026-06-21 · v0.9.3 — Conversation

  • 恢复 Waline 评论组件，为评论、留言板与友链申请功能上线做准备。
    • 统一文章页评论挂载点和客户端样式资源。

2026-06-19 · v0.9.2 — Reading Polish

  • 重整 About 页面文案，并统一代码块的暖色阅读样式。
    • 调整代码背景、边框、语法高亮和移动端横向滚动。

2026-06-18 · v0.9.1 — Chronicle Polish

  • 优化 Changelog 时间线布局、导航和首页近期内容的尺寸层级。
    • 调整更新卡片、统计信息和页面入口的视觉密度。

2026-06-17 · v0.9.0 — Chronicle

  • 将 About 与 Changelog 拆分为独立页面，建立专门的站点更新记录入口。
    • Changelog 从 About 的 Markdown 更新章节读取并生成时间线。

2026-06-16 · v0.8.1 — Site Metrics

  • 统一 Archive 与 Tags 的文章数、标签数、字数和最新更新时间统计。
  • 修复字数计算、中文路径解码和时区显示。
    • 站点状态卡改为显示建站天数与总字数。

2026-06-15 · v0.8.0 — Timeline

  • 重设计 Archive，加入时间线、统计卡片、文章热力图和日期交互。
    • 支持年份/月折叠、日期悬停展开、点击固定和热力图月份导航。
    • 加入动态考试倒计时、当天时间与状态卡片。
  • 音乐播放器增加播放列表与音量控制，并改善深色模式可读性。

2026-06-14 · v0.7.0 — Warm Night

  • 重构桌面导航与暖色玻璃层，加入首页轮换打字效果。
    • 稳定打字动画占位，避免文字切换造成布局跳动。
  • 完善夜间模式的暖棕配色、代码高亮和数学公式显示。
  • 新增移动端音乐播放器并修复音频路径与遮挡问题。
    • 导航栏改为全宽背景并统一激活态。

2026-06-12 · v0.6.1 — Nebula Polish

  • 将 Tags 页面定稿为知识星云与文章索引结合的响应式知识地图。
  • 优化节点布局、标签配色和页面文字层级。
    • 星云节点颜色与标签系统一致，保留无 Canvas 时的文章索引。

2026-06-11 · v0.6.0 — Structured Notes

  • 新增 Markdown 题目环境，统一选择题、填空题、解答题、选项和答案容器。
    • 自定义 remark 插件负责解析嵌套容器并输出统一题目卡片。
  • Tags 页面首次加入知识星云可视化，并修复 Canvas 渲染。
  • 优化目录行为，非当前章节的子目录自动折叠。

2026-06-08 · v0.5.3 — Embedded Documents

  • 文章页支持直接嵌入公开 PDF，并保留原始矢量清晰度。
    • 静态 PDF 统一从 public 路径提供，修复构建后 404。
  • 完善系列导航数据，使同一项目的多篇记录可以前后切换。

2026-06-07 · v0.5.2 — Comment Reset

  • 完成 Giscus、Waline 方案测试后暂时移除评论功能，避免国内访问异常。
    • 清理失效初始化脚本，保留后续重新接入评论的组件边界。
  • 修复导航与目录标题中的公式渲染和特殊字符路径问题。

2026-06-06 · v0.5.1 — Category Atlas

  • 分类页改为按标签分组的可折叠导航，并新增 Projects 独立分类。
    • 分类导航支持内外层 details，修复 Projects 误显示空状态。
  • 启用 Sharp 图片优化，删除高开销的首页落叶动画。
  • 完善 favicon、author、keywords 与 theme-color 元信息。
  • 修复分类页空状态和目录高亮回跳问题。

2026-06-05 · v0.5.0 — Fast Navigation

  • 启用 Astro ClientRouter 与 View Transitions，获得 SPA 式页面切换体验。
    • 顶部导航在页面切换间持久化，减少整页刷新感。
  • 拆分 KaTeX 资源、瘦身搜索索引并优化评论与目录加载策略。
  • 修复死链、锚点遮挡和移动端导航密度。

2026-06-04 · v0.4.0 — Publishing Foundation

  • 接入 canonical、Open Graph、Twitter Card、RSS 与 Sitemap。
    • 增加默认 1200×630 分享图、robots.txt 和站点订阅入口。
  • 新增相关文章、系列导航和移动端折叠目录。
    • 相关文章按标签关联度计算，系列导航自动生成上下篇与集数入口。
  • 图片切换为 Astro 优化管线，支持 WebP、lazy loading 和显式尺寸。
  • About 页面改为直接渲染站内 Markdown 内容。

2026-06-03 · v0.3.1 — Mobile Header

  • 手机端顶栏改为品牌与导航双行布局，并调整锚点滚动偏移。
  • 优化品牌对齐、导航间距和触控区域。
    • 修复固定顶栏遮挡文章锚点的问题。

2026-06-02 · v0.3.0 — Content Architecture

  • 分类路由增加 Projects，并重构 About 的结构与工作流说明。
    • 侧栏加入 Projects 子分类，课程设计内容从 Other 独立出来。
  • 目录支持链接标题并保留完整文字，修复复杂标题解析。

2026-06-01 · v0.2.4 — Formula Navigation

  • 目录正式支持 KaTeX 公式渲染，恢复标题中的数学表达式。
    • 目录文本与正文标题共享公式渲染结果，避免公式源码直接显示。

2026-05-26 · v0.2.3 — Markdown Cleanup

  • 统一 Markdown 数学定界符、公式块间距和 frontmatter 后的空行。
  • 修复图片路径编码与构建失败问题。
    • 统一代码与公式块周围留白，减少移动端溢出。

2026-05-25 · v0.2.2 — Visual Identity

  • Tags 列表加入数量限制与分页。
    • 标签首页每组显示有限条目，详情页按固定数量分页。
  • 更新 favicon、首页立绘和响应式加载策略，移动端停止预加载大图。
  • 固定浅色主题并清理未使用的视觉依赖。
    • 删除未采用的玫瑰装饰和机器学习抠图依赖。

2026-05-24 · v0.2.0 — Search & Theme

  • 搜索升级为构建时全文索引，支持正文匹配、得分排序、关键词高亮和摘要片段。
    • 搜索栏使用 sticky 定位，索引覆盖标题、标签、摘要和正文。
  • 加入主题系统、代码复制和公式源码复制交互。
    • 支持自动/手动主题选择，并为代码框、搜索框和日历适配主题变量。
  • 接入首版 Giscus 留言板与文章评论，并为全站标题增加 KaTeX 渲染。
  • 建立暖色玻璃背景与全宽磨砂顶栏的视觉基础。

2026-05-23 · v0.1.1 — Navigation Basics

  • 增加文章目录并持续修复公式标题、层级和 Archive 布局。
    • 目录开始支持滚动定位和多级标题结构。
  • 首页、归档和分类入口完成第一轮结构调整。

2026-05-22 · v0.1.0 — First Light

  • 初始化 Zemengzhou Space，建立 Astro 页面路由、内容集合和基础布局。
  • 完成首页、文章页、About、Archive 与基础配色。
    • 建立 Markdown frontmatter、文章标签与日期排序规则。
卷末落款 · COLOPHONSPRING EDITION

本文由 择梦舟 执笔撰作，收录于 Zemengzhou Space。

知识共享许可：CC BY-NC-SA 4.0（署名-非商业性使用-相同方式共享）
知字印章 · 择梦舟
Back to archive

Discussion

Comments

Post

Share questions, corrections, or extra notes about this post.