fix(share): add stable short links for Chinese routes

.github/workflows/deploey.yml

@@ -40,6 +40,12 @@ jobs:
             - name: Install dependencies
               run: pnpm install --frozen-lockfile
 
+            - name: Prepare stable share IDs
+              run: pnpm share-links:prepare
+
+            - name: Require generated IDs to be committed
+              run: git diff --exit-code -- .vitepress/data/share-links.json
+
             - name: Check committed secrets
               run: pnpm check:secrets
 
@@ -53,7 +59,7 @@ jobs:
               run: pnpm test
 
     build:
-        name: Build VitePress site
+        name: Build YuuFrag and short-link artifacts
         if: github.event_name != 'pull_request'
         needs: quality
         runs-on: ubuntu-latest
@@ -84,7 +90,21 @@ jobs:
             - name: Build with VitePress
               run: pnpm docs:build
 
-            - name: Upload artifact
+            - name: Verify stable registry remains clean
+              run: git diff --exit-code -- .vitepress/data/share-links.json
+
+            - name: Verify both share-link artifacts
+              run: pnpm share-links:artifacts:check
+
+            - name: Upload standalone short-link archive
+              uses: actions/upload-artifact@v4
+              with:
+                  name: yuufrag-shortlinks
+                  path: .shortlink-dist
+                  if-no-files-found: error
+                  retention-days: 30
+
+            - name: Upload YuuFrag Pages artifact
               uses: actions/upload-pages-artifact@v4
               with:
                   path: .vitepress/dist

.gitignore

@@ -12,6 +12,7 @@
 .vitepress/dist
 .vitepress/.temp
 .vitepress/generated/
+.shortlink-dist/
 public/contributors/
 dist
 cache

.vitepress/config.mts

@@ -20,8 +20,9 @@ import {
     writeLegacyPageRedirects,
 } from "./utilities/page-route-plugin";
 import { createPageRouteRewriter } from "./utilities/route-paths";
+import { ShareLinkManifestPlugin } from "./utilities/share-link-manifest-plugin";
+import { baseUrl } from "./shared/site-config";
 
-const baseUrl = "https://yuufrag.machillka.com";
 const feedUrl = `${baseUrl}/feed.rss`;
 const contributorIndex = await prepareGithubContributors(contributorsConfig);
 
@@ -124,6 +125,7 @@ export default defineConfig({
                 text: "分类",
                 items: ScanCurrentDir("../../posts/", "posts"),
             },
+            { component: "ShareButton" },
         ],
         sidebar: {
             "/guide/": [
@@ -151,6 +153,9 @@ export default defineConfig({
     vite: {
         plugins: [
             PageRoutePlugin(),
+            ShareLinkManifestPlugin({
+                manifestFile: ".vitepress/generated/share-links-manifest.json",
+            }),
             RssPlugin(RSS),
             RssAssetPlugin({ baseUrl, filename: "feed.rss" }),
         ],