@xingwangzhe/stalux 1.14.0 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.14.0",
+    "version": "1.15.0",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",
@@ -98,6 +98,7 @@
     },
     "devDependencies": {
         "@types/node": "^26.1.2",
+        "astro": "^7.2.0",
         "knip": "^6.31.0",
         "license-checker-rseidelsohn": "5.0.1",
         "oxfmt": "^0.62.0",
@@ -105,6 +106,6 @@
         "typescript": "^7.0.2"
     },
     "peerDependencies": {
-        "astro": "^7.1.6"
+        "astro": "7.2.0"
     }
 }

package/src/pages/posts/[post].astro

@@ -35,8 +35,16 @@ export async function getStaticPaths() {
         // sorted 按日期降序：sorted[i-1] 比当前新（next），sorted[i+1] 比当前旧（prev）
         const nextPost = i > 0 ? sorted[i - 1] : undefined;
         const prevPost = i < sorted.length - 1 ? sorted[i + 1] : undefined;
+        // 增量构建 cacheKey：含自身与 prev/next 的更新时间，
+        // 任一邻居变化（文章新增/编辑导致前后链接变化）时本页也会失效重渲染
+        const cacheKey = [
+            post.data.updated ?? post.data.date,
+            prevPost ? (prevPost.data.updated ?? prevPost.data.date) : "",
+            nextPost ? (nextPost.data.updated ?? nextPost.data.date) : "",
+        ].join("|");
         return {
             params: { post: post.data.abbrlink },
+            cacheKey,
             props: {
                 post,
                 prev: prevPost

package/src/pages/posts/[post].md.ts

@@ -78,6 +78,7 @@ export const getStaticPaths = (async () => {
     const posts = await getCollection("posts", ({ data }) => !data.draft);
     return posts.map((post) => ({
         params: { post: String(post.data.abbrlink) },
+        cacheKey: post.data.updated ?? post.data.date,
         props: { post },
     }));
 }) satisfies GetStaticPaths;

package/src/utils/taxonomy.ts

@@ -32,13 +32,22 @@ export async function buildTaxonomyStaticPaths(key: TaxonomyKey): Promise<GetSta
         }
     }
 
-    return [...map].map(([name, entry]) => ({
-        params: { [paramName]: name },
-        props: {
-            [paramName]: name,
-            count: entry.posts.length,
-            posts: entry.posts,
-            lastUpdateDate: entry.latestTime,
-        },
-    }));
+    return [...map].map(([name, entry]) => {
+        // 增量构建 cacheKey：该分类/标签下全部文章更新时间拼接，
+        // 任一文章新增/编辑/变更分类都会改变列表输出并失效本页
+        const cacheKey = entry.posts
+            .map((p) => p.data.updated ?? p.data.date)
+            .sort()
+            .join("|");
+        return {
+            params: { [paramName]: name },
+            cacheKey,
+            props: {
+                [paramName]: name,
+                count: entry.posts.length,
+                posts: entry.posts,
+                lastUpdateDate: entry.latestTime,
+            },
+        };
+    });
 }