@@ -56,7 +56,9 @@ npm test
5656- 仓库已忽略 ` node_modules/ ` 、` dist/ ` 、` .astro/ ` 等本地输出目录
5757- 核心数据和页面内容都带构建期校验
5858- 当前单元测试覆盖内容文件顺序、关键静态路由文件存在性,以及 GitHub 项目合并顺序这几类关键逻辑
59- - 站点支持 ` light ` 、` dark ` 、` system ` 三种主题模式,浏览器会记住上次选择
59+ - 站点支持 ` light ` 、` dark ` 、` system ` 三种主题模式,当前默认模式为 ` system `
60+ - 主题切换会记住用户选择;当默认策略升级时,会自动迁移一次本地主题偏好
61+ - 顶部标题栏为固定定位,页面滚动偏移已经在样式层统一处理
6062
6163## 目录结构
6264
@@ -185,6 +187,7 @@ tests/ Node 内置测试
185187- ` /research ` 会展示论文预览,并链接到完整论文页
186188- 每篇论文都支持独立详情页:` /publications/[slug] `
187189- 论文条目按内容文件名顺序展示
190+ - 论文详情页依赖 ` src/pages/publications/[slug].astro ` ,不要误删该静态路由文件
188191
189192### 博客
190193
@@ -200,6 +203,7 @@ tests/ Node 内置测试
200203- 博客列表按照内容文件名顺序展示,不再按日期自动重排
201204- 如果需要调整展示顺序,直接调整文件命名顺序即可
202205- frontmatter 中 ` coverDark ` 为可选字段,用于给深色模式提供独立封面图
206+ - ` /blog ` 、` /blog/[slug] ` 和 ` /blog/page/[page] ` 都是静态页面,缺少对应路由文件会直接导致构建后页面缺失
203207
204208### 动态
205209
@@ -252,6 +256,13 @@ tests/ Node 内置测试
252256- 改卡片、成员卡、项目卡、博客卡、分页,优先看 ` cards.css `
253257- 改研究院、论文、页脚、Markdown 正文,优先看 ` pages.css `
254258- 改断点和移动端样式,优先看 ` responsive.css `
259+ - 改浅色 / 深色模式、主题对比度、标签和链接色,优先看 ` theme.css `
260+
261+ 补充说明:
262+
263+ - 当前浅色模式已经收敛到“接近 GitHub 的高对比白底 + 保留少量灰蓝气质”的方向
264+ - 站点整体采用扁平风格,圆角、阴影和 hover 动效都被刻意压低
265+ - 固定标题栏高度使用 ` --site-header-offset ` 管理,跨断点同步在 ` foundation.css ` 和 ` responsive.css ` 中维护
255266
256267## 常见操作
257268
@@ -309,6 +320,12 @@ links:
309320
310321在 ` src/content/blog/ ` 下新增 Markdown 文件,参考现有 frontmatter。
311322
323+ 说明:
324+
325+ - 列表页、详情页和分页页都已经接回静态路由
326+ - 如果博客发布后出现 404,优先先检查 ` src/pages/blog/index.astro ` 、` src/pages/blog/[slug].astro ` 、` src/pages/blog/page/[page].astro ` 是否仍然存在
327+ - 站内链接统一通过 ` withBase() ` 生成,并会为静态目录页补上尾部 ` / `
328+
312329### 新增一条动态
313330
314331在 ` src/content/updates/ ` 下新增 Markdown 文件。
@@ -351,3 +368,9 @@ npm run build
351368```
352369
353370如果这两步都通过,再手动快速检查一次首页、博客、动态、研究院的移动端布局即可。
371+
372+ 额外建议:
373+
374+ - 浅色模式下至少检查一次首页、项目页、博客页,确认文字对比度和标签可读性
375+ - 检查固定标题栏是否遮挡页面首屏内容和锚点跳转位置
376+ - 检查 ` /blog/ ` 、博客详情页和论文详情页是否都在构建产物中生成
0 commit comments