chore: update files

Author: SWHL

README.md

@@ -43,12 +43,19 @@ http://127.0.0.1:4321/
 npm run build
 ```
 
+运行单元测试：
+
+```bash
+npm test
+```
+
 构建产物输出到 `dist/`。
 
 说明：
 
 - 仓库已忽略 `node_modules/`、`dist/`、`.astro/` 等本地输出目录
 - 核心数据和页面内容都带构建期校验
+- 当前单元测试覆盖内容文件顺序和 GitHub 项目合并顺序这两类关键逻辑
 - 站点支持 `light`、`dark`、`system` 三种主题模式，浏览器会记住上次选择
 
 ## 目录结构
@@ -64,10 +71,13 @@ src/
   types/           共享类型
 public/
   images/          静态资源
+tests/             Node 内置测试
 .github/workflows/
   ci.yml           GitHub Pages 自动部署
 ```
 
+实际测试目录为 `tests/`，使用 Node 自带的 `node:test` 运行，不额外引入测试框架。
+
 ## 数据分层
 
 ### 1. 栏目级配置
@@ -189,6 +199,7 @@ public/
 
 - 博客列表按照内容文件名顺序展示，不再按日期自动重排
 - 如果需要调整展示顺序，直接调整文件命名顺序即可
+- frontmatter 中 `coverDark` 为可选字段，用于给深色模式提供独立封面图
 
 ### 动态
 
@@ -326,3 +337,14 @@ links:
 - 新增重复 UI 时，优先抽组件，不要复制粘贴页面结构
 - 核心数据现在带有构建期校验，重复 key、空字段、排序冲突会在 `npm run build` 时直接报错
 - 涉及预览分享的页面默认带 SEO / OG 元信息，跳转页可以显式设置 `noindex`
+
+## 发布前检查
+
+建议发布前至少执行：
+
+```bash
+npm test
+npm run build
+```
+
+如果这两步都通过，再手动快速检查一次首页、博客、动态、研究院的移动端布局即可。

package.json

@@ -10,9 +10,10 @@
     "dev": "astro dev",
     "start": "astro dev",
     "build": "astro build",
-    "preview": "astro preview"
+    "preview": "astro preview",
+    "test": "node --test tests/*.test.ts"
   },
   "dependencies": {
     "astro": "^6.1.0"
   }
-}
+}

public/images/blog/rapidai-pr-dark.svg

@@ -10,6 +10,7 @@ interface PostEntry {
     author: string;
     tags: string[];
     cover: string;
+    coverDark?: string;
   };
 }
 
@@ -23,10 +24,7 @@ const { posts } = Astro.props;
 <div class="blog-grid">
   {
     posts.map((post) => (
-      <article class="card blog-card">
-        <a class="blog-cover" href={withBase(`/blog/${post.id}`)}>
-          <img src={withBase(post.data.cover)} alt={post.data.title} loading="lazy" />
-        </a>
+      <article class="card blog-card blog-card-compact">
         <div class="blog-card-body">
           <div class="blog-meta-row">
             <span class="timeline-label">{post.data.date.toISOString().slice(0, 10)}</span>

public/images/blog/rapidai-pr.svg

@@ -25,20 +25,24 @@ const { hero } = Astro.props;
     <div class="hero-badges">
       {hero.badges.map((badge) => <span>{badge}</span>)}
     </div>
+    {
+      hero.command && (
+        <a class="hero-command" href={withBase(hero.secondaryAction.href)}>
+          <span class="hero-command-prefix">{hero.command.label}</span>
+          <code>{hero.command.value}</code>
+        </a>
+      )
+    }
   </div>
-  <div class="hero-panel">
-    <div class="panel-grid">
-      {
-        hero.panels.map((panel) => (
-          <div class:list={["mini-card", panel.accent && "mini-card-strong", panel.wide && "mini-card-wide"]}>
-            <span>{panel.tag}</span>
-            <strong>{panel.title}</strong>
-          </div>
-        ))
-      }
-    </div>
-    <div class="hero-panel-foot">
-      <p>{hero.panelFoot}</p>
+  <div class="hero-panel hero-panel-home">
+    <div class="hero-capability-grid">
+      {hero.panels.map((panel) => (
+        <div class:list={["hero-capability-item", panel.accent && "hero-capability-item-strong"]}>
+          <span>{panel.tag}</span>
+          <strong>{panel.title}</strong>
+        </div>
+      ))}
     </div>
+    <p class="hero-panel-foot hero-panel-foot-home">{hero.panelFoot}</p>
   </div>
 </section>

public/images/blog/rapidai-welcome-dark.svg

@@ -11,15 +11,16 @@ interface Props {
   description: string;
   themeClass?: string;
   panel?: HeroPanel;
+  hideEyebrow?: boolean;
 }
 
-const { eyebrow, title, description, themeClass = "", panel } = Astro.props;
+const { eyebrow, title, description, themeClass = "", panel, hideEyebrow = false } = Astro.props;
 const panelClass = themeClass ? `page-hero-panel-${themeClass.replace("page-hero-", "")}` : "";
 ---
 
 <section class:list={["page-hero", themeClass, !panel && "page-hero-single"]}>
   <div>
-    <p class="eyebrow">{eyebrow}</p>
+    {!hideEyebrow && eyebrow && <p class="eyebrow">{eyebrow}</p>}
     <h1>{title}</h1>
     <p>{description}</p>
   </div>

public/images/blog/rapidai-welcome.svg

@@ -11,13 +11,14 @@ interface Props {
   title: string;
   description: string;
   actions?: ActionLink[];
+  hideEyebrow?: boolean;
 }
 
-const { projects, limit, eyebrow, title, description, actions = [] } = Astro.props;
+const { projects, limit, eyebrow, title, description, actions = [], hideEyebrow = false } = Astro.props;
 ---
 
 <section class="content-section">
-  <SectionIntro eyebrow={eyebrow} title={title} description={description} />
+  <SectionIntro eyebrow={eyebrow} title={title} description={description} hideEyebrow={hideEyebrow} />
   {
     actions.length > 0 && (
       <div class:list={["section-actions", actions.length > 1 && "section-actions-dual"]}>