@xingwangzhe/stalux 1.41.2 → 1.41.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.41.2",
+    "version": "1.41.4",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",

package/src/components/stalux/archives/archivesList.astro

@@ -5,6 +5,7 @@ import { type CollectionEntry, getCollection } from "astro:content";
 import { getSiteData } from "@utils/config-utils";
 import { formatInTimeZone, parseDate, toTimestamp, zonedCalendarParts } from "@utils/dayjs";
 import { createTranslator } from "@utils/i18n";
+import { toMachineDateTime } from "@utils/semantic-time";
 
 interface Props {
     posts?: CollectionEntry<"posts">[];
@@ -81,7 +82,10 @@ const archiveYears = [...archivesByYearMonth.entries()]
                                             <li class="stalux-archive-post-item">
                                                 <time
                                                     class="stalux-archive-post-date"
-                                                    datetime={post.data.date}
+                                                    datetime={toMachineDateTime(
+                                                        post.data.date,
+                                                        timezone,
+                                                    )}
                                                 >
                                                     {formatInTimeZone(
                                                         parseDate(post.data.date, timezone),

package/src/components/stalux/footer/FooterStats.astro

@@ -2,6 +2,7 @@
 import { getCollection } from "astro:content";
 import { getSiteData } from "@utils/config-utils";
 import { createTranslator } from "@utils/i18n";
+import { toMachineDateTime } from "@utils/semantic-time";
 
 interface Props {
     showStats?: boolean;
@@ -13,6 +14,11 @@ const configEntries = await getCollection("config");
 const siteConfig = getSiteData(configEntries);
 const { t } = createTranslator(siteConfig.lang || "zh-CN");
 const { showStats = true, wordCount, buildtime } = Astro.props;
+// buildtime 会被浏览器端 new Date(dataset) 解析：裸串会按访客本地时区解释，
+// 不同时区访客算出的运行时长不同。这里统一转成带站点时区偏移的机器时间。
+const machineBuildtime = buildtime
+    ? toMachineDateTime(buildtime, siteConfig.timezone || "Asia/Shanghai")
+    : undefined;
 ---
 
 {showStats && (
@@ -34,10 +40,10 @@ const { showStats = true, wordCount, buildtime } = Astro.props;
     </p>
 )}
 
-{buildtime && (
+{machineBuildtime && (
     <div
         class="stalux-stats-site-build-time stalux-u-text-center"
-        data-stalux-buildtime={buildtime}
+        data-stalux-buildtime={machineBuildtime}
         data-stalux-runtime-format={t("footer.runtimeFormat")}
     >
         <span>

package/src/schemas/collections.ts

@@ -50,15 +50,42 @@ export interface CollectionPaths {
 // 文章 Schema
 // ---------------------------------------------------------------------------
 
+/**
+ * 日期字段的严格格式：月/日/时/分/秒**必须补零**。
+ *
+ * 允许：`2025-07-04`、`"2025-07-04 18:44:32"`、`2025-05-10T12:00:00+08:00`。
+ * 拒绝：`2026-6-9 9:11:00` 这类未补零写法——站点时区解析器（dayjs.ts
+ * NAIVE_DATE_PATTERN）只认补零形式，未补零会静默回退到 new Date() 按
+ * **构建机器本地时区**解释，导致 RSS/页面时间整体平移（2026-10-24 事故）。
+ * 因此在 schema 层直接拒绝，让构建尽快失败，而不是产出错误时间。
+ */
+export const PADDED_DATETIME_PATTERN =
+    /^\d{4}-\d{2}-\d{2}([ T]\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:?\d{2})?)?$/;
+
+const datetimeField = (label: string) =>
+    z
+        .string({ error: `${label} must be a string` })
+        .regex(
+            PADDED_DATETIME_PATTERN,
+            `${label} 月/日/时/分/秒必须补零，如 "2025-07-04 18:44:32"（拒绝 2026-6-9 9:11:00 这类未补零写法）`,
+        );
+
+/** words 的日期字段：允许空串（模板预留），非空时必须补零 */
+const paddedOrEmpty = (label: string) =>
+    z
+        .string()
+        .refine(
+            (value) => value === "" || PADDED_DATETIME_PATTERN.test(value),
+            `${label} 为空或月/日/时/分/秒必须补零，如 "2025-07-04 18:44:32"`,
+        );
+
 const postSchema = z.object({
     title: z.string().min(1, "title is required"),
     abbrlink: z.union([z.string(), z.number().transform((num) => num.toString())], {
         error: "abbrlink must be a string or number",
     }),
-    date: z
-        .string({ error: "date must be a string" })
-        .min(1, "date is required, format: YYYY-MM-DD HH:mm:ss"),
-    updated: z.string().optional(),
+    date: datetimeField("date"),
+    updated: datetimeField("updated").optional(),
     draft: z.boolean().optional().default(false),
     tags: z.preprocess(
         (val) => (typeof val === "string" ? [val] : val),
@@ -136,9 +163,11 @@ export function defineCollections(paths: CollectionPaths = {}) {
         schema: z.object({
             source: z.string().optional(),
             link: z.url("words.link must be a valid URL").optional(),
+            // sourceDate 是自由文本（如 "1950"、"春秋"），不是机器时间，不做格式约束
             sourceDate: z.string().optional(),
-            date: z.string().optional(),
-            updated: z.string().optional(),
+            // words 允许空串（_template.md 预留字段），非空时必须补零
+            date: paddedOrEmpty("date").optional(),
+            updated: paddedOrEmpty("updated").optional(),
             draft: z.boolean().optional().default(false),
             title: z.string().optional(),
             abbrlink: z.string().optional(),