@xingwangzhe/stalux 1.13.0 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.13.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/scripts/webmcp.ts

@@ -180,10 +180,12 @@ function listPostsTool(): WebMCPTool {
         description: pick(
             "分页列出博客的全部已发布文章，返回标题、永久链接（abbrlink）、日期、分类、标签、摘要与文章页 URL。" +
                 "需要浏览全站文章、确认某篇文章的 abbrlink 时使用；不返回正文，" +
-                "只要某篇元信息用 stalux_get_post，读正文请用 stalux_read_post。",
+                "只要某篇元信息用 stalux_get_post，读正文请用 stalux_read_post。" +
+                "pageSize 建议设 50 一次拿完，减少翻页；页码越界时会自动返回最后一页（clamped 标记）。",
             "Paginated list of all published posts, returning title, permanent link (abbrlink), date, categories, tags, description and post page URL. " +
                 "Use it to browse the whole blog or find a post's abbrlink; it does not return body content — " +
-                "use stalux_get_post for one post's metadata, or stalux_read_post for the full body.",
+                "use stalux_get_post for one post's metadata, or stalux_read_post for the full body. " +
+                "Prefer pageSize 50 to fetch everything in one call; out-of-range pages clamp to the last page (clamped flag).",
         ),
         annotations: { readOnlyHint: true, untrustedContentHint: false },
         inputSchema: {
@@ -222,23 +224,16 @@ function listPostsTool(): WebMCPTool {
                 );
             const total = list.length;
             const totalPages = Math.ceil(total / pageSize) || 1;
-            const start = (page - 1) * pageSize;
-            if (start >= total) {
-                return err(
-                    "OUT_OF_RANGE",
-                    pick(
-                        "第 " + page + " 页没有文章（共 " + totalPages + " 页）",
-                        "Page " + page + " has no posts (" + totalPages + " pages total)",
-                    ),
-                    {
-                        page,
-                        totalPages,
-                        total,
-                    },
-                );
+            // 越界时自动回退到最后一页（而非报错），agent 翻过头也能拿到数据
+            let clamped = false;
+            let resolvedPage = page;
+            if (page > totalPages) {
+                resolvedPage = totalPages;
+                clamped = true;
             }
+            const start = (resolvedPage - 1) * pageSize;
             const posts = list.slice(start, start + pageSize).map(briefMeta);
-            return { ok: true, page, pageSize, total, totalPages, posts };
+            return { ok: true, page: resolvedPage, pageSize, total, totalPages, clamped, posts };
         },
     };
 }

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,
+            },
+        };
+    });
 }