@xingwangzhe/stalux 1.55.5 → 1.55.7

package/src/components/stalux/tags/tagsCloud.astro

@@ -22,41 +22,49 @@ const tagLinks = tagList.map((t) => ({
 ---
 
 <!-- 移动端：SSR 卡片 -->
-<div class="stalux-cloud-cards" id="tags-cards" data-stalux-tag-cards data-stalux-motion-content>
+<!-- Modern Web Guidance (html): 标签是一组条目 => <ul>/<li>；空态是纯文字 => <p>。 -->
+<section
+    class="stalux-cloud-cards"
+    id="tags-cards"
+    data-stalux-tag-cards
+    data-stalux-motion-content
+    aria-label={t("tags.title")}
+>
     {tagList.length > 0 ? (
         tagGroups.map((group) => (
-            <div class="stalux-cloud-tag-group" data-stalux-reveal>
+            <ul class="stalux-cloud-tag-group" data-stalux-reveal>
                 {group.map(({ name, count }) => (
-                    <a
-                        href={`/tags/${name}/`}
-                        class="stalux-cloud-tag-card"
-                        data-stalux-card
-                        data-stalux-tag-card
-                        data-stalux-control="tag-card"
-                        data-stalux-reveal-item
-                        data-count={count}
-                        data-astro-prefetch
-                    >
-                        <span class="stalux-cloud-tag-name">{name}</span>
-                        <span class="stalux-cloud-tag-count">{count}</span>
-                    </a>
+                    <li data-stalux-reveal-item>
+                        <a
+                            href={`/tags/${name}/`}
+                            class="stalux-cloud-tag-card"
+                            data-stalux-card
+                            data-stalux-tag-card
+                            data-stalux-control="tag-card"
+                            data-count={count}
+                            data-astro-prefetch
+                        >
+                            <span class="stalux-cloud-tag-name">{name}</span>
+                            <span class="stalux-cloud-tag-count">{count}</span>
+                        </a>
+                    </li>
                 ))}
-            </div>
+            </ul>
         ))
     ) : (
-        <div class="stalux-cloud-no-tags">{t("tags.noTags")}</div>
+        <p class="stalux-cloud-no-tags">{t("tags.noTags")}</p>
     )}
-</div>
+</section>
 
-<!-- 桌面端：Canvas 标签云 -->
-<div
+<!-- 桌面端：Canvas 标签云（可视化整体，用 <figure> 承载；内部节点是脚本挂载点） -->
+<figure
     class="stalux-cloud-canvas-frame"
     data-stalux-tag-canvas
     style={{ "--cloud-density": cloudDensity }}
     data-stalux-motion-content
 >
     <div class="stalux-cloud-canvas" id="tags-canvas" data-tags={JSON.stringify(tagLinks)}></div>
-</div>
+</figure>
 
 <script>
 import "../../../scripts/tags-cloud";

package/src/components/stalux/words/wordCard.astro

@@ -25,9 +25,11 @@ const machineDate = date && timezone ? toMachineDateTime(date, timezone) : date;
     id={abbrlink ? `word-${abbrlink}` : undefined}
 >
     <Quote class="stalux-word-mark" size={28} stroke-width={1.4} aria-hidden="true" />
-    <div class="stalux-word-body stalux-prose" data-pagefind-body>
+    <!-- Modern Web Guidance (html): 语录正文本身就是引用 => <blockquote>；
+         来源与日期是脚注性文字 => <footer> + <p>。 -->
+    <blockquote class="stalux-word-body stalux-prose" data-pagefind-body>
         <Content />
-    </div>
+    </blockquote>
     {(date || source || sourceDate || abbrlink) && (
         <footer class="stalux-word-footer">
             {abbrlink ? (
@@ -47,7 +49,7 @@ const machineDate = date && timezone ? toMachineDateTime(date, timezone) : date;
                 <span />
             )}
             {(source || sourceDate) && (
-                <div class="stalux-word-source-meta">
+                <p class="stalux-word-source-meta">
                     {sourceDate && <span class="stalux-word-source-date">{sourceDate}</span>}
                     {source &&
                         (link ? (
@@ -62,7 +64,7 @@ const machineDate = date && timezone ? toMachineDateTime(date, timezone) : date;
                         ) : (
                             <span class="stalux-word-source-text">— {source}</span>
                         ))}
-                </div>
+                </p>
             )}
         </footer>
     )}

package/src/internal/style-names.generated.ts

@@ -48,181 +48,183 @@ export const styleNames: { classes: Record<string, string>; variables: Record<st
         "stalux-badge-group": "s18",
         "stalux-badge-group-arrow": "s19",
         "stalux-badge-group-hint": "s1a",
-        "stalux-badge-group-items": "s1b",
-        "stalux-badge-group-summary": "s1c",
-        "stalux-badge-group-title": "s1d",
-        "stalux-badges": "s1e",
-        "stalux-badges-wrapper": "s1f",
-        "stalux-beian-beian-info": "s1g",
-        "stalux-beian-public-security-beian": "s1h",
-        "stalux-byline-author-bio": "s1i",
-        "stalux-byline-author-card": "s1j",
-        "stalux-byline-author-section": "s1k",
-        "stalux-byline-sidebar-container": "s1l",
-        "stalux-card-post-categories": "s1m",
-        "stalux-card-post-category": "s1n",
-        "stalux-card-post-cover": "s1o",
-        "stalux-card-post-date": "s1p",
-        "stalux-card-post-description": "s1q",
-        "stalux-card-post-meta": "s1r",
-        "stalux-card-post-tag": "s1s",
-        "stalux-card-post-tags": "s1t",
-        "stalux-card-post-title": "s1u",
-        "stalux-card-post-updated": "s1v",
-        "stalux-card-read-more": "s1w",
-        "stalux-card-time": "s1x",
-        "stalux-categories": "s1y",
-        "stalux-category-card": "s1z",
-        "stalux-category-content": "s20",
-        "stalux-category-icon": "s21",
-        "stalux-category-shell": "s22",
-        "stalux-categoryheader": "s23",
-        "stalux-cloud-canvas": "s24",
-        "stalux-cloud-canvas-frame": "s25",
-        "stalux-cloud-cards": "s26",
-        "stalux-cloud-no-tags": "s27",
-        "stalux-cloud-tag-card": "s28",
-        "stalux-cloud-tag-count": "s29",
-        "stalux-cloud-tag-group": "s2a",
-        "stalux-cloud-tag-name": "s2b",
-        "stalux-copyright": "s2c",
-        "stalux-footer": "s2d",
-        "stalux-footer-content": "s2e",
-        "stalux-home-body": "s2f",
-        "stalux-home-title": "s2g",
-        "stalux-license-author": "s2h",
-        "stalux-license-box": "s2i",
-        "stalux-license-content": "s2j",
-        "stalux-license-icon": "s2k",
-        "stalux-license-license": "s2l",
-        "stalux-license-title": "s2m",
-        "stalux-license-url": "s2n",
-        "stalux-license-watermark": "s2o",
-        "stalux-link-card": "s2p",
-        "stalux-link-card-avatar": "s2q",
-        "stalux-link-card-content": "s2r",
-        "stalux-link-card-description": "s2s",
-        "stalux-link-card-title": "s2t",
-        "stalux-link-list-item": "s2u",
-        "stalux-link-shell": "s2v",
-        "stalux-links": "s2w",
-        "stalux-main": "s2x",
-        "stalux-nav-container": "s2y",
-        "stalux-nav-item": "s2z",
-        "stalux-nav-link": "s30",
-        "stalux-nav-list": "s31",
-        "stalux-nav-overlay": "s32",
-        "stalux-nav-scroll-btn": "s33",
-        "stalux-nav-text": "s34",
-        "stalux-nav-toggle": "s35",
-        "stalux-page-description": "s36",
-        "stalux-page-title": "s37",
-        "stalux-pagination": "s38",
-        "stalux-pagination-arrow": "s39",
-        "stalux-pagination-content": "s3a",
-        "stalux-pagination-disabled": "s3b",
-        "stalux-pagination-inner": "s3c",
-        "stalux-pagination-label": "s3d",
-        "stalux-pagination-link": "s3e",
-        "stalux-pagination-next-post": "s3f",
-        "stalux-pagination-prev-post": "s3g",
-        "stalux-pagination-title": "s3h",
-        "stalux-post-article-footer": "s3i",
-        "stalux-post-article-header": "s3j",
-        "stalux-post-body": "s3k",
-        "stalux-post-card": "s3l",
-        "stalux-post-card-shell": "s3m",
-        "stalux-post-footer-content": "s3n",
-        "stalux-post-layout": "s3o",
-        "stalux-post-list-container": "s3p",
-        "stalux-post-meta-item": "s3q",
-        "stalux-post-meta-row": "s3r",
-        "stalux-post-metadata": "s3s",
-        "stalux-post-page": "s3t",
-        "stalux-post-page-stats": "s3u",
-        "stalux-post-reading-time": "s3v",
-        "stalux-post-source-link": "s3w",
-        "stalux-post-source-link-row": "s3x",
-        "stalux-post-taxonomy-container": "s3y",
-        "stalux-post-taxonomy-empty": "s3z",
-        "stalux-post-taxonomy-item-column": "s40",
-        "stalux-post-taxonomy-item-pill": "s41",
-        "stalux-post-taxonomy-list": "s42",
-        "stalux-post-taxonomy-list-column": "s43",
-        "stalux-post-taxonomy-list-wrap": "s44",
-        "stalux-post-taxonomy-title": "s45",
-        "stalux-post-title": "s46",
-        "stalux-prose": "s47",
-        "stalux-random-container": "s48",
-        "stalux-random-error": "s49",
-        "stalux-random-header": "s4a",
-        "stalux-random-list": "s4b",
-        "stalux-random-loading": "s4c",
-        "stalux-random-no-more": "s4d",
-        "stalux-random-refresh": "s4e",
-        "stalux-random-rotating": "s4f",
-        "stalux-random-title": "s4g",
-        "stalux-root": "s4h",
-        "stalux-sidebar": "s4i",
-        "stalux-sidebar-container": "s4j",
-        "stalux-sidebar-right": "s4k",
-        "stalux-site-header": "s4l",
-        "stalux-site-nav": "s4m",
-        "stalux-social": "s4n",
-        "stalux-social-custom-icon": "s4o",
-        "stalux-social-icon-container": "s4p",
-        "stalux-stats-site-build-time": "s4q",
-        "stalux-stats-site-stats": "s4r",
-        "stalux-stats-stats-separator": "s4s",
-        "stalux-tag-back-link": "s4t",
-        "stalux-tag-category-icon": "s4u",
-        "stalux-tag-category-name": "s4v",
-        "stalux-tag-header": "s4w",
-        "stalux-tag-page-description": "s4x",
-        "stalux-tag-page-title": "s4y",
-        "stalux-theme-info": "s4z",
-        "stalux-toc-active": "s50",
-        "stalux-toc-depth-1": "s51",
-        "stalux-toc-depth-2": "s52",
-        "stalux-toc-depth-3": "s53",
-        "stalux-toc-depth-4": "s54",
-        "stalux-toc-depth-5": "s55",
-        "stalux-toc-depth-6": "s56",
-        "stalux-toc-empty": "s57",
-        "stalux-toc-item": "s58",
-        "stalux-toc-list": "s59",
-        "stalux-toc-title": "s5a",
-        "stalux-typewriter": "s5b",
-        "stalux-typewriter-accessible": "s5c",
-        "stalux-typewriter-reserve": "s5d",
-        "stalux-typewriter-text": "s5e",
-        "stalux-u-flex": "s5f",
-        "stalux-u-flex-col": "s5g",
-        "stalux-u-flex-wrap": "s5h",
-        "stalux-u-items-center": "s5i",
-        "stalux-u-justify-center": "s5j",
-        "stalux-u-min-w-0": "s5k",
-        "stalux-u-text-center": "s5l",
-        "stalux-u-w-full": "s5m",
-        "stalux-weather": "s5n",
-        "stalux-weather-footer": "s5o",
-        "stalux-weather-heading": "s5p",
-        "stalux-weather-location": "s5q",
-        "stalux-weather-main": "s5r",
-        "stalux-weather-source": "s5s",
-        "stalux-weather-status": "s5t",
-        "stalux-word-body": "s5u",
-        "stalux-word-card": "s5v",
-        "stalux-word-date": "s5w",
-        "stalux-word-footer": "s5x",
-        "stalux-word-list-item": "s5y",
-        "stalux-word-list-list": "s5z",
-        "stalux-word-mark": "s60",
-        "stalux-word-permalink": "s61",
-        "stalux-word-source-date": "s62",
-        "stalux-word-source-link": "s63",
-        "stalux-word-source-meta": "s64",
-        "stalux-word-source-text": "s65"
+        "stalux-badge-group-item": "s1b",
+        "stalux-badge-group-items": "s1c",
+        "stalux-badge-group-summary": "s1d",
+        "stalux-badge-group-title": "s1e",
+        "stalux-badges": "s1f",
+        "stalux-badges-wrapper": "s1g",
+        "stalux-beian-beian-info": "s1h",
+        "stalux-beian-public-security-beian": "s1i",
+        "stalux-byline-author-bio": "s1j",
+        "stalux-byline-author-card": "s1k",
+        "stalux-byline-author-section": "s1l",
+        "stalux-byline-sidebar-container": "s1m",
+        "stalux-card-post-categories": "s1n",
+        "stalux-card-post-category": "s1o",
+        "stalux-card-post-cover": "s1p",
+        "stalux-card-post-date": "s1q",
+        "stalux-card-post-description": "s1r",
+        "stalux-card-post-meta": "s1s",
+        "stalux-card-post-tag": "s1t",
+        "stalux-card-post-tags": "s1u",
+        "stalux-card-post-title": "s1v",
+        "stalux-card-post-updated": "s1w",
+        "stalux-card-read-more": "s1x",
+        "stalux-card-time": "s1y",
+        "stalux-categories": "s1z",
+        "stalux-category-card": "s20",
+        "stalux-category-content": "s21",
+        "stalux-category-icon": "s22",
+        "stalux-category-shell": "s23",
+        "stalux-categoryheader": "s24",
+        "stalux-cloud-canvas": "s25",
+        "stalux-cloud-canvas-frame": "s26",
+        "stalux-cloud-cards": "s27",
+        "stalux-cloud-no-tags": "s28",
+        "stalux-cloud-tag-card": "s29",
+        "stalux-cloud-tag-count": "s2a",
+        "stalux-cloud-tag-group": "s2b",
+        "stalux-cloud-tag-name": "s2c",
+        "stalux-copyright": "s2d",
+        "stalux-footer": "s2e",
+        "stalux-footer-content": "s2f",
+        "stalux-home-body": "s2g",
+        "stalux-home-title": "s2h",
+        "stalux-license-author": "s2i",
+        "stalux-license-box": "s2j",
+        "stalux-license-content": "s2k",
+        "stalux-license-icon": "s2l",
+        "stalux-license-license": "s2m",
+        "stalux-license-title": "s2n",
+        "stalux-license-url": "s2o",
+        "stalux-license-watermark": "s2p",
+        "stalux-link-card": "s2q",
+        "stalux-link-card-avatar": "s2r",
+        "stalux-link-card-content": "s2s",
+        "stalux-link-card-description": "s2t",
+        "stalux-link-card-title": "s2u",
+        "stalux-link-list-item": "s2v",
+        "stalux-link-shell": "s2w",
+        "stalux-links": "s2x",
+        "stalux-main": "s2y",
+        "stalux-nav-container": "s2z",
+        "stalux-nav-item": "s30",
+        "stalux-nav-link": "s31",
+        "stalux-nav-list": "s32",
+        "stalux-nav-overlay": "s33",
+        "stalux-nav-scroll-btn": "s34",
+        "stalux-nav-text": "s35",
+        "stalux-nav-toggle": "s36",
+        "stalux-page-description": "s37",
+        "stalux-page-title": "s38",
+        "stalux-pagination": "s39",
+        "stalux-pagination-arrow": "s3a",
+        "stalux-pagination-content": "s3b",
+        "stalux-pagination-disabled": "s3c",
+        "stalux-pagination-inner": "s3d",
+        "stalux-pagination-item": "s3e",
+        "stalux-pagination-label": "s3f",
+        "stalux-pagination-link": "s3g",
+        "stalux-pagination-next-post": "s3h",
+        "stalux-pagination-prev-post": "s3i",
+        "stalux-pagination-title": "s3j",
+        "stalux-post-article-footer": "s3k",
+        "stalux-post-article-header": "s3l",
+        "stalux-post-body": "s3m",
+        "stalux-post-card": "s3n",
+        "stalux-post-card-shell": "s3o",
+        "stalux-post-footer-content": "s3p",
+        "stalux-post-layout": "s3q",
+        "stalux-post-list-container": "s3r",
+        "stalux-post-meta-item": "s3s",
+        "stalux-post-meta-row": "s3t",
+        "stalux-post-metadata": "s3u",
+        "stalux-post-page": "s3v",
+        "stalux-post-page-stats": "s3w",
+        "stalux-post-reading-time": "s3x",
+        "stalux-post-source-link": "s3y",
+        "stalux-post-source-link-row": "s3z",
+        "stalux-post-taxonomy-container": "s40",
+        "stalux-post-taxonomy-empty": "s41",
+        "stalux-post-taxonomy-item-column": "s42",
+        "stalux-post-taxonomy-item-pill": "s43",
+        "stalux-post-taxonomy-list": "s44",
+        "stalux-post-taxonomy-list-column": "s45",
+        "stalux-post-taxonomy-list-wrap": "s46",
+        "stalux-post-taxonomy-title": "s47",
+        "stalux-post-title": "s48",
+        "stalux-prose": "s49",
+        "stalux-random-container": "s4a",
+        "stalux-random-error": "s4b",
+        "stalux-random-header": "s4c",
+        "stalux-random-list": "s4d",
+        "stalux-random-loading": "s4e",
+        "stalux-random-no-more": "s4f",
+        "stalux-random-refresh": "s4g",
+        "stalux-random-rotating": "s4h",
+        "stalux-random-title": "s4i",
+        "stalux-root": "s4j",
+        "stalux-sidebar": "s4k",
+        "stalux-sidebar-container": "s4l",
+        "stalux-sidebar-right": "s4m",
+        "stalux-site-header": "s4n",
+        "stalux-site-nav": "s4o",
+        "stalux-social": "s4p",
+        "stalux-social-custom-icon": "s4q",
+        "stalux-social-icon-container": "s4r",
+        "stalux-stats-site-build-time": "s4s",
+        "stalux-stats-site-stats": "s4t",
+        "stalux-stats-stats-separator": "s4u",
+        "stalux-tag-back-link": "s4v",
+        "stalux-tag-category-icon": "s4w",
+        "stalux-tag-category-name": "s4x",
+        "stalux-tag-header": "s4y",
+        "stalux-tag-page-description": "s4z",
+        "stalux-tag-page-title": "s50",
+        "stalux-theme-info": "s51",
+        "stalux-toc-active": "s52",
+        "stalux-toc-depth-1": "s53",
+        "stalux-toc-depth-2": "s54",
+        "stalux-toc-depth-3": "s55",
+        "stalux-toc-depth-4": "s56",
+        "stalux-toc-depth-5": "s57",
+        "stalux-toc-depth-6": "s58",
+        "stalux-toc-empty": "s59",
+        "stalux-toc-item": "s5a",
+        "stalux-toc-list": "s5b",
+        "stalux-toc-title": "s5c",
+        "stalux-typewriter": "s5d",
+        "stalux-typewriter-accessible": "s5e",
+        "stalux-typewriter-reserve": "s5f",
+        "stalux-typewriter-text": "s5g",
+        "stalux-u-flex": "s5h",
+        "stalux-u-flex-col": "s5i",
+        "stalux-u-flex-wrap": "s5j",
+        "stalux-u-items-center": "s5k",
+        "stalux-u-justify-center": "s5l",
+        "stalux-u-min-w-0": "s5m",
+        "stalux-u-text-center": "s5n",
+        "stalux-u-w-full": "s5o",
+        "stalux-weather": "s5p",
+        "stalux-weather-footer": "s5q",
+        "stalux-weather-heading": "s5r",
+        "stalux-weather-location": "s5s",
+        "stalux-weather-main": "s5t",
+        "stalux-weather-source": "s5u",
+        "stalux-weather-status": "s5v",
+        "stalux-word-body": "s5w",
+        "stalux-word-card": "s5x",
+        "stalux-word-date": "s5y",
+        "stalux-word-footer": "s5z",
+        "stalux-word-list-item": "s60",
+        "stalux-word-list-list": "s61",
+        "stalux-word-mark": "s62",
+        "stalux-word-permalink": "s63",
+        "stalux-word-source-date": "s64",
+        "stalux-word-source-link": "s65",
+        "stalux-word-source-meta": "s66",
+        "stalux-word-source-text": "s67"
     },
     "variables": {
         "--accent-20p": "--s0",

package/src/pages/404.astro

@@ -14,7 +14,9 @@ const { t } = createTranslator(siteConfig.lang || "zh-CN");
     title={`${t("page404.title")} | ${siteConfig.title}`}
     description={t("page404.description")}
 >
-    <div
+    <!-- Modern Web Guidance (html): 404 提示是一个内容分组 => <section>；
+         内层保留一个纯排版容器（居中 + motion-region），没有语义对等元素。 -->
+    <section
         class="stalux-404-error-container stalux-u-flex stalux-u-items-center stalux-u-justify-center stalux-u-text-center"
         data-pagefind-ignore
     >
@@ -45,7 +47,7 @@ const { t } = createTranslator(siteConfig.lang || "zh-CN");
                 >{t("page404.backHome")}</a
             >
         </div>
-    </div>
+    </section>
 
     <script src="../scripts/countdown.ts"></script>
 </Stalux>

package/src/pages/about.astro

@@ -28,8 +28,8 @@ const author = authorConfig.name;
     title={`${aboutPage.data.title} | ${siteConfig.title}`}
     description={aboutPage.data.description}
 >
-    <div style="height: 3em;"></div>
-    <div style="max-width: 900px; margin: 2rem auto; padding: 0 1rem;">
+    <!-- Modern Web Guidance (html): 顶部留白并入容器自身的 margin，不再用空占位 <div>。 -->
+    <section style="max-width: 900px; margin: 5rem auto 2rem; padding: 0 1rem;">
         <PostContent
             title={aboutPage.data.title}
             transitionName="about-content"
@@ -54,5 +54,5 @@ const author = authorConfig.name;
                 />
             )}
         </PostContent>
-    </div>
+    </section>
 </Stalux>

package/src/pages/categories/[category].astro

@@ -32,8 +32,8 @@ const props = Astro.props as Props;
         count: props.count,
     })}
 >
-    <div id="swup-taxonomy">
+    <section id="swup-taxonomy">
         <TagHeader type={t("taxonomy.category")} name={props.category} count={props.count} />
         <PostList posts={props.posts} />
-    </div>
+    </section>
 </Stalux>

package/src/pages/index.astro

@@ -20,8 +20,13 @@ import { getSiteData } from "@utils/config-utils";
 ---
 
 <Stalux title={siteTitle} description={siteDescription}>
-    <div class="stalux-home-body stalux-u-flex stalux-u-items-center stalux-u-flex-col">
+    <!-- Modern Web Guidance (html): 首页主体是具名内容分组 => <section>；不再用 <div>。 -->
+    <section
+        class="stalux-home-body stalux-u-flex stalux-u-items-center stalux-u-flex-col"
+        aria-labelledby="stalux-home-title"
+    >
         <h1
+            id="stalux-home-title"
             class="stalux-home-title stalux-u-text-center"
             data-stalux-motion-region
             data-stalux-motion-focus
@@ -50,12 +55,12 @@ import { getSiteData } from "@utils/config-utils";
                 mutate data.
             </p>
         </section>
-        <div data-stalux-home-content data-stalux-motion-content>
+        <section data-stalux-home-content data-stalux-motion-content>
             <Author />
             <TextType />
             <DateTime />
             <SocialMedia />
             <ToArchive />
-        </div>
-    </div>
+        </section>
+    </section>
 </Stalux>

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

@@ -71,7 +71,6 @@ export async function getStaticPaths() {
     categories={props.post.data.categories}
     author={authorConfig.name}
 >
-    <div style="height:3em"></div>
     <PostLayout
         title={props.post.data.title}
         description={autoDesc}

package/src/pages/tags/[tag].astro

@@ -34,8 +34,8 @@ const props = Astro.props as Props;
     })}
     noindex={props.count < 3}
 >
-    <div id="swup-taxonomy">
+    <section id="swup-taxonomy">
         <TagHeader type={t("taxonomy.tag")} name={props.tag} count={props.count} />
         <PostList posts={props.posts} />
-    </div>
+    </section>
 </Stalux>

package/src/pages/words.md.ts

@@ -1,4 +1,9 @@
-import { isMarkdownExportEnabled, loadConfig, renderWordsMd } from "@utils/ai-discovery";
+import {
+    isMarkdownExportEnabled,
+    loadConfig,
+    renderWordsMd,
+    resolveSiteTimezone,
+} from "@utils/ai-discovery";
 import type { APIRoute } from "astro";
 
 export const prerender = true;
@@ -7,7 +12,7 @@ export const GET: APIRoute = async () => {
     const config = await loadConfig();
     if (!isMarkdownExportEnabled(config)) return new Response(null, { status: 404 });
 
-    const text = await renderWordsMd();
+    const text = await renderWordsMd(resolveSiteTimezone(config));
     return new Response(text, {
         headers: {
             "Content-Type": "text/markdown; charset=utf-8",

package/src/scripts/date-time.ts

@@ -3,6 +3,7 @@ import { observeVisibleClock } from "./visible-clock";
 
 const pad2 = (value: number) => String(value).padStart(2, "0");
 
+/** 机器可读值必须与访客本地日历一致，因此按本地时间拼装（toISOString 是 UTC）。 */
 function toMachineDate(date: Date): string {
     return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
 }
@@ -11,15 +12,22 @@ function toMachineTime(date: Date): string {
     return `${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`;
 }
 
+// Modern Web Guidance (javascript): 本地化日期交给 Intl.DateTimeFormat，
+// 按语言缓存 formatter，避免每秒 tick 时重复构造。
+const displayFormatters = new Map<string, Intl.DateTimeFormat>();
+
 function toDisplayDate(date: Date, lang: string): string {
-    if (lang.startsWith("zh")) {
-        return `${date.getFullYear()}年${pad2(date.getMonth() + 1)}月${pad2(date.getDate())}日`;
+    let formatter = displayFormatters.get(lang);
+    if (!formatter) {
+        const zh = lang.toLowerCase().startsWith("zh");
+        formatter = new Intl.DateTimeFormat(lang, {
+            year: "numeric",
+            month: zh ? "long" : "short",
+            day: "2-digit",
+        });
+        displayFormatters.set(lang, formatter);
     }
-    return new Intl.DateTimeFormat("en-US", {
-        year: "numeric",
-        month: "short",
-        day: "2-digit",
-    }).format(date);
+    return formatter.format(date);
 }
 
 registerPageLifecycle("date-time", () => {