From ee0bec4a782b86f290b49a9a9c21b2b5ab60cc77 Mon Sep 17 00:00:00 2001
From: limitcool <initcoool@gmail.com>
Date: Thu, 2 Apr 2026 00:55:34 +0800
Subject: [PATCH] test: add full playwright ui regression coverage

---
 .gitea/workflows/ui-regression.yml      |  167 ++
 README.md                               |   17 +-
 admin/src/App.tsx                       |   62 +
 admin/src/components/ui/select.tsx      |   13 +-
 admin/src/lib/post-draft-window.ts      |   34 +-
 admin/src/pages/categories-page.tsx     |    7 +-
 admin/src/pages/comments-page.tsx       |    4 +
 admin/src/pages/media-page.tsx          |   45 +-
 admin/src/pages/post-compare-page.tsx   |   39 +-
 admin/src/pages/post-preview-page.tsx   |   19 +-
 admin/src/pages/posts-page.tsx          |  286 +-
 admin/src/pages/reviews-page.tsx        |    8 +
 admin/src/pages/revisions-page.tsx      |    9 +-
 admin/src/pages/site-settings-page.tsx  |    9 +-
 admin/src/pages/subscriptions-page.tsx  |   14 +-
 admin/src/pages/tags-page.tsx           |    7 +-
 frontend/src/lib/reviews.ts             |   92 +
 frontend/src/lib/utils/data.ts          |  194 --
 frontend/src/pages/reviews/[id].astro   |  384 +++
 frontend/src/pages/reviews/index.astro  |  137 +-
 frontend/src/pages/sitemap.xml.ts       |   10 +-
 package.json                            |    5 +
 playwright-smoke/.gitignore             |    3 +
 playwright-smoke/README.md              |   33 +
 playwright-smoke/mock-server.mjs        | 3211 +++++++++++++++++++++++
 playwright-smoke/package.json           |   17 +
 playwright-smoke/playwright.config.ts   |   92 +
 playwright-smoke/pnpm-lock.yaml         |   77 +
 playwright-smoke/tests/admin.spec.ts    |  309 +++
 playwright-smoke/tests/frontend.spec.ts |   89 +
 playwright-smoke/tests/helpers.ts       |   29 +
 playwright-smoke/tsconfig.json          |   14 +
 32 files changed, 5100 insertions(+), 336 deletions(-)
 create mode 100644 .gitea/workflows/ui-regression.yml
 create mode 100644 frontend/src/lib/reviews.ts
 delete mode 100644 frontend/src/lib/utils/data.ts
 create mode 100644 frontend/src/pages/reviews/[id].astro
 create mode 100644 playwright-smoke/.gitignore
 create mode 100644 playwright-smoke/README.md
 create mode 100644 playwright-smoke/mock-server.mjs
 create mode 100644 playwright-smoke/package.json
 create mode 100644 playwright-smoke/playwright.config.ts
 create mode 100644 playwright-smoke/pnpm-lock.yaml
 create mode 100644 playwright-smoke/tests/admin.spec.ts
 create mode 100644 playwright-smoke/tests/frontend.spec.ts
 create mode 100644 playwright-smoke/tests/helpers.ts
 create mode 100644 playwright-smoke/tsconfig.json

diff --git a/.gitea/workflows/ui-regression.yml b/.gitea/workflows/ui-regression.yml
new file mode 100644
index 0000000..e09241e
--- /dev/null
+++ b/.gitea/workflows/ui-regression.yml
@@ -0,0 +1,167 @@
+name: ui-regression
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - admin/**
+      - frontend/**
+      - playwright-smoke/**
+      - .gitea/workflows/ui-regression.yml
+  pull_request:
+    paths:
+      - admin/**
+      - frontend/**
+      - playwright-smoke/**
+      - .gitea/workflows/ui-regression.yml
+  workflow_dispatch:
+
+jobs:
+  playwright-regression:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+          cache-dependency-path: |
+            frontend/pnpm-lock.yaml
+            admin/pnpm-lock.yaml
+            playwright-smoke/pnpm-lock.yaml
+
+      - name: Install frontend deps
+        working-directory: frontend
+        run: pnpm install --frozen-lockfile
+
+      - name: Install admin deps
+        working-directory: admin
+        run: pnpm install --frozen-lockfile
+
+      - name: Install Playwright deps
+        working-directory: playwright-smoke
+        run: pnpm install --frozen-lockfile
+
+      - name: Install Playwright browsers
+        working-directory: playwright-smoke
+        run: pnpm exec playwright install --with-deps chromium
+
+      - name: Typecheck Playwright suite
+        working-directory: playwright-smoke
+        run: pnpm exec tsc -p tsconfig.json --noEmit
+
+      - name: Prepare Playwright artifact folders
+        run: |
+          rm -rf playwright-smoke/.artifacts
+          mkdir -p playwright-smoke/.artifacts/frontend
+          mkdir -p playwright-smoke/.artifacts/admin
+
+      - name: Run frontend UI regression suite
+        id: ui_frontend
+        working-directory: playwright-smoke
+        continue-on-error: true
+        run: pnpm test:frontend
+
+      - name: Collect frontend Playwright artifacts
+        if: always()
+        run: |
+          if [ -d playwright-smoke/playwright-report ]; then
+            cp -R playwright-smoke/playwright-report playwright-smoke/.artifacts/frontend/playwright-report
+          fi
+          if [ -d playwright-smoke/test-results ]; then
+            cp -R playwright-smoke/test-results playwright-smoke/.artifacts/frontend/test-results
+          fi
+          rm -rf playwright-smoke/playwright-report playwright-smoke/test-results
+
+      - name: Run admin UI regression suite
+        id: ui_admin
+        working-directory: playwright-smoke
+        continue-on-error: true
+        run: pnpm test:admin
+
+      - name: Collect admin Playwright artifacts
+        if: always()
+        run: |
+          if [ -d playwright-smoke/playwright-report ]; then
+            cp -R playwright-smoke/playwright-report playwright-smoke/.artifacts/admin/playwright-report
+          fi
+          if [ -d playwright-smoke/test-results ]; then
+            cp -R playwright-smoke/test-results playwright-smoke/.artifacts/admin/test-results
+          fi
+
+      - name: Upload frontend HTML report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-html-report-frontend
+          path: playwright-smoke/.artifacts/frontend/playwright-report
+          retention-days: 14
+          if-no-files-found: ignore
+
+      - name: Upload admin HTML report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-html-report-admin
+          path: playwright-smoke/.artifacts/admin/playwright-report
+          retention-days: 14
+          if-no-files-found: ignore
+
+      - name: Upload frontend raw results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-raw-results-frontend
+          path: playwright-smoke/.artifacts/frontend/test-results
+          retention-days: 14
+          if-no-files-found: ignore
+
+      - name: Upload admin raw results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-raw-results-admin
+          path: playwright-smoke/.artifacts/admin/test-results
+          retention-days: 14
+          if-no-files-found: ignore
+
+      - name: Upload frontend failure screenshots / videos / traces
+        if: steps.ui_frontend.outcome != 'success'
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-failure-artifacts-frontend
+          path: |
+            playwright-smoke/.artifacts/frontend/test-results/**/*.png
+            playwright-smoke/.artifacts/frontend/test-results/**/*.webm
+            playwright-smoke/.artifacts/frontend/test-results/**/*.zip
+            playwright-smoke/.artifacts/frontend/test-results/**/error-context.md
+          retention-days: 21
+          if-no-files-found: ignore
+
+      - name: Upload admin failure screenshots / videos / traces
+        if: steps.ui_admin.outcome != 'success'
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-failure-artifacts-admin
+          path: |
+            playwright-smoke/.artifacts/admin/test-results/**/*.png
+            playwright-smoke/.artifacts/admin/test-results/**/*.webm
+            playwright-smoke/.artifacts/admin/test-results/**/*.zip
+            playwright-smoke/.artifacts/admin/test-results/**/error-context.md
+          retention-days: 21
+          if-no-files-found: ignore
+
+      - name: Mark workflow failed when any suite failed
+        if: steps.ui_frontend.outcome != 'success' || steps.ui_admin.outcome != 'success'
+        run: exit 1
diff --git a/README.md b/README.md
index 464736b..43473ab 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,7 @@ Monorepo for the Termi blog system.
 From the repository root:
 
 ```powershell
-npm run dev
+pnpm dev
 ```
 
 This starts `frontend + admin + backend` in a single Windows Terminal window with multiple tabs.
@@ -30,13 +30,14 @@ This starts `frontend + admin + backend` in a single Windows Terminal window wit
 Common shortcuts:
 
 ```powershell
-npm run dev:mcp
-npm run dev:frontend
-npm run dev:admin
-npm run dev:backend
-npm run dev:mcp-only
-npm run stop
-npm run restart
+pnpm dev:mcp
+pnpm dev:frontend
+pnpm dev:admin
+pnpm dev:backend
+pnpm dev:mcp-only
+pnpm stop
+pnpm restart
+pnpm test:ui
 ```
 
 ### PowerShell entrypoint
diff --git a/admin/src/App.tsx b/admin/src/App.tsx
index bb51203..aee3dbf 100644
--- a/admin/src/App.tsx
+++ b/admin/src/App.tsx
@@ -38,6 +38,18 @@ const PostsPage = lazy(async () => {
   const mod = await import('@/pages/posts-page')
   return { default: mod.PostsPage }
 })
+const PostPreviewPage = lazy(async () => {
+  const mod = await import('@/pages/post-preview-page')
+  return { default: mod.PostPreviewPage }
+})
+const PostComparePage = lazy(async () => {
+  const mod = await import('@/pages/post-compare-page')
+  return { default: mod.PostComparePage }
+})
+const PostPolishPage = lazy(async () => {
+  const mod = await import('@/pages/post-polish-page')
+  return { default: mod.PostPolishPage }
+})
 const CategoriesPage = lazy(async () => {
   const mod = await import('@/pages/categories-page')
   return { default: mod.CategoriesPage }
@@ -223,6 +235,56 @@ function AppRoutes() {
   return (
     <Routes>
       <Route path="/login" element={<PublicOnly />} />
+      <Route
+        path="/posts/preview"
+        element={
+          <RequireAuth>
+            <LazyRoute>
+              <PostPreviewPage />
+            </LazyRoute>
+          </RequireAuth>
+        }
+      />
+      <Route
+        path="/posts/:slug/preview"
+        element={
+          <RequireAuth>
+            <LazyRoute>
+              <PostPreviewPage />
+            </LazyRoute>
+          </RequireAuth>
+        }
+      />
+      <Route
+        path="/posts/compare"
+        element={
+          <RequireAuth>
+            <LazyRoute>
+              <PostComparePage />
+            </LazyRoute>
+          </RequireAuth>
+        }
+      />
+      <Route
+        path="/posts/:slug/compare"
+        element={
+          <RequireAuth>
+            <LazyRoute>
+              <PostComparePage />
+            </LazyRoute>
+          </RequireAuth>
+        }
+      />
+      <Route
+        path="/posts/polish"
+        element={
+          <RequireAuth>
+            <LazyRoute>
+              <PostPolishPage />
+            </LazyRoute>
+          </RequireAuth>
+        }
+      />
       <Route
         path="/"
         element={
diff --git a/admin/src/components/ui/select.tsx b/admin/src/components/ui/select.tsx
index e0248c5..4ebd842 100644
--- a/admin/src/components/ui/select.tsx
+++ b/admin/src/components/ui/select.tsx
@@ -4,7 +4,9 @@ import { Check, ChevronDown } from 'lucide-react'
 
 import { cn } from '@/lib/utils'
 
-type NativeSelectProps = React.ComponentProps<'select'>
+type NativeSelectProps = React.ComponentProps<'select'> & {
+  'data-testid'?: string
+}
 
 type SelectOption = {
   value: string
@@ -78,8 +80,11 @@ function getNextEnabledIndex(options: SelectOption[], currentIndex: number, dire
 const Select = React.forwardRef<HTMLSelectElement, NativeSelectProps>(
   (
     {
+      'aria-label': ariaLabel,
+      'aria-labelledby': ariaLabelledby,
       children,
       className,
+      'data-testid': dataTestId,
       defaultValue,
       disabled = false,
       id,
@@ -434,6 +439,9 @@ const Select = React.forwardRef<HTMLSelectElement, NativeSelectProps>(
           className="pointer-events-none absolute h-0 w-0 opacity-0"
           defaultValue={defaultValue}
           disabled={disabled}
+          aria-label={ariaLabel}
+          aria-labelledby={ariaLabelledby}
+          data-testid={dataTestId}
           id={id}
           onBlur={onBlur}
           onFocus={onFocus}
@@ -454,8 +462,11 @@ const Select = React.forwardRef<HTMLSelectElement, NativeSelectProps>(
         <button
           aria-controls={open ? menuId : undefined}
           aria-expanded={open}
+          aria-label={ariaLabel}
+          aria-labelledby={ariaLabelledby}
           aria-haspopup="listbox"
           className={triggerClasses}
+          data-testid={dataTestId}
           data-state={open ? 'open' : 'closed'}
           disabled={disabled}
           onBlur={(event) => {
diff --git a/admin/src/lib/post-draft-window.ts b/admin/src/lib/post-draft-window.ts
index 353d907..9e2cd3d 100644
--- a/admin/src/lib/post-draft-window.ts
+++ b/admin/src/lib/post-draft-window.ts
@@ -61,22 +61,38 @@ export function savePolishWindowResult(
   return payload
 }
 
-export function consumePolishWindowResult(key: string | null) {
-  if (!key) {
-    return null
-  }
-
-  const storageKey = `${POLISH_RESULT_PREFIX}${key}`
-  const raw = window.localStorage.getItem(storageKey)
+function parsePolishWindowResult(raw: string | null) {
   if (!raw) {
     return null
   }
 
-  window.localStorage.removeItem(storageKey)
-
   try {
     return JSON.parse(raw) as PolishWindowResult
   } catch {
     return null
   }
 }
+
+export function readPolishWindowResult(key: string | null) {
+  if (!key) {
+    return null
+  }
+
+  const storageKey = `${POLISH_RESULT_PREFIX}${key}`
+  return parsePolishWindowResult(window.localStorage.getItem(storageKey))
+}
+
+export function consumePolishWindowResult(key: string | null) {
+  if (!key) {
+    return null
+  }
+
+  const storageKey = `${POLISH_RESULT_PREFIX}${key}`
+  const parsed = parsePolishWindowResult(window.localStorage.getItem(storageKey))
+  if (!parsed) {
+    return null
+  }
+
+  window.localStorage.removeItem(storageKey)
+  return parsed
+}
diff --git a/admin/src/pages/categories-page.tsx b/admin/src/pages/categories-page.tsx
index 9d7b4cf..8fe10cc 100644
--- a/admin/src/pages/categories-page.tsx
+++ b/admin/src/pages/categories-page.tsx
@@ -218,6 +218,7 @@ export function CategoriesPage() {
           </CardHeader>
           <CardContent className="space-y-4">
             <Input
+              data-testid="categories-search"
               placeholder="按分类名 / slug / 描述搜索"
               value={searchTerm}
               onChange={(event) => setSearchTerm(event.target.value)}
@@ -229,6 +230,7 @@ export function CategoriesPage() {
                   <button
                     key={item.id}
                     type="button"
+                    data-testid={`category-item-${item.slug}`}
                     onClick={() => {
                       setSelectedId(item.id)
                       setForm(toFormState(item))
@@ -286,6 +288,7 @@ export function CategoriesPage() {
             <div className="grid gap-4 lg:grid-cols-2">
               <FormField label="分类名称" hint="例如：前端工程、随笔、工具链。">
                 <Input
+                  data-testid="category-name-input"
                   value={form.name}
                   onChange={(event) => setForm((current) => ({ ...current, name: event.target.value }))}
                   placeholder="输入分类名称"
@@ -293,6 +296,7 @@ export function CategoriesPage() {
               </FormField>
               <FormField label="分类 slug" hint="留空时自动从英文名称生成；中文建议手填。">
                 <Input
+                  data-testid="category-slug-input"
                   value={form.slug}
                   onChange={(event) => setForm((current) => ({ ...current, slug: event.target.value }))}
                   placeholder="frontend-engineering"
@@ -377,7 +381,7 @@ export function CategoriesPage() {
             </div>
 
             <div className="flex flex-wrap items-center gap-3">
-              <Button onClick={() => void handleSave()} disabled={saving}>
+              <Button onClick={() => void handleSave()} disabled={saving} data-testid="category-save">
                 <Save className="h-4 w-4" />
                 {saving ? '保存中...' : selectedItem ? '保存分类' : '创建分类'}
               </Button>
@@ -388,6 +392,7 @@ export function CategoriesPage() {
                 variant="ghost"
                 onClick={() => void handleDelete()}
                 disabled={!selectedItem || deleting}
+                data-testid="category-delete"
                 className="text-rose-600 hover:text-rose-600"
               >
                 <Trash2 className="h-4 w-4" />
diff --git a/admin/src/pages/comments-page.tsx b/admin/src/pages/comments-page.tsx
index d6c2d8a..be47221 100644
--- a/admin/src/pages/comments-page.tsx
+++ b/admin/src/pages/comments-page.tsx
@@ -898,6 +898,7 @@ export function CommentsPage() {
                           setManualMatcherValue('')
                         }}
                         disabled={!manualMatcherValue.trim()}
+                        data-testid="comment-blacklist-add"
                       >
                         <Shield className="h-4 w-4" />
                         新增
@@ -908,6 +909,7 @@ export function CommentsPage() {
                       {blacklist.map((item) => (
                         <div
                           key={item.id}
+                          data-testid={`blacklist-item-${item.id}`}
                           className="rounded-2xl border border-border/70 bg-background/40 p-3"
                         >
                           <div className="flex flex-wrap items-center justify-between gap-2">
@@ -929,6 +931,7 @@ export function CommentsPage() {
                               size="sm"
                               variant="outline"
                               disabled={actingBlacklistId === item.id}
+                              data-testid={`blacklist-toggle-${item.id}`}
                               onClick={async () => {
                                 try {
                                   setActingBlacklistId(item.id)
@@ -959,6 +962,7 @@ export function CommentsPage() {
                               size="sm"
                               variant="danger"
                               disabled={actingBlacklistId === item.id}
+                              data-testid={`blacklist-delete-${item.id}`}
                               onClick={async () => {
                                 if (!window.confirm('确定删除这条黑名单规则吗？')) {
                                   return
diff --git a/admin/src/pages/media-page.tsx b/admin/src/pages/media-page.tsx
index 88b3f43..85e2f56 100644
--- a/admin/src/pages/media-page.tsx
+++ b/admin/src/pages/media-page.tsx
@@ -58,6 +58,24 @@ const defaultMetadataForm: MediaMetadataFormState = {
   notes: '',
 }
 
+function normalizeMediaTags(value: unknown): string[] {
+  if (!Array.isArray(value)) {
+    return []
+  }
+
+  return value
+    .filter((item): item is string => typeof item === 'string')
+    .map((item) => item.trim())
+    .filter(Boolean)
+}
+
+function normalizeMediaItem(item: AdminMediaObjectResponse): AdminMediaObjectResponse {
+  return {
+    ...item,
+    tags: normalizeMediaTags(item.tags),
+  }
+}
+
 function toMetadataForm(item: AdminMediaObjectResponse | null): MediaMetadataFormState {
   if (!item) {
     return defaultMetadataForm
@@ -67,7 +85,7 @@ function toMetadataForm(item: AdminMediaObjectResponse | null): MediaMetadataFor
     title: item.title ?? '',
     altText: item.alt_text ?? '',
     caption: item.caption ?? '',
-    tags: item.tags.join(', '),
+    tags: normalizeMediaTags(item.tags).join(', '),
     notes: item.notes ?? '',
   }
 }
@@ -111,8 +129,9 @@ export function MediaPage() {
       }
       const prefix = prefixFilter === 'all' ? undefined : prefixFilter
       const result = await adminApi.listMediaObjects({ prefix, limit: 200 })
+      const normalizedItems = result.items.map(normalizeMediaItem)
       startTransition(() => {
-        setItems(result.items)
+        setItems(normalizedItems)
         setProvider(result.provider)
         setBucket(result.bucket)
       })
@@ -219,6 +238,7 @@ export function MediaPage() {
           <Button
             variant="danger"
             disabled={!selectedKeys.length || batchDeleting}
+            data-testid="media-batch-delete"
             onClick={async () => {
               if (!window.confirm(`确定批量删除 ${selectedKeys.length} 个对象吗？`)) {
                 return
@@ -267,6 +287,7 @@ export function MediaPage() {
               <option value="uploads/">上传到通用目录</option>
             </Select>
             <Input
+              data-testid="media-search"
               placeholder="按对象 key 搜索"
               value={searchTerm}
               onChange={(event) => setSearchTerm(event.target.value)}
@@ -275,6 +296,7 @@ export function MediaPage() {
 
           <div className="grid gap-3 lg:grid-cols-[1fr_auto_auto_auto]">
             <Input
+              data-testid="media-upload-input"
               type="file"
               multiple
               accept="image/*"
@@ -300,6 +322,7 @@ export function MediaPage() {
             />
             <Button
               disabled={!uploadFiles.length || uploading}
+              data-testid="media-upload"
               onClick={async () => {
                 try {
                   setUploading(true)
@@ -399,6 +422,7 @@ export function MediaPage() {
                 <div className="flex flex-wrap items-center gap-3">
                   <Button
                     disabled={metadataSaving}
+                    data-testid="media-save-metadata"
                     onClick={async () => {
                       if (!activeItem) {
                         return
@@ -423,7 +447,7 @@ export function MediaPage() {
                                     title: result.title,
                                     alt_text: result.alt_text,
                                     caption: result.caption,
-                                    tags: result.tags,
+                                    tags: normalizeMediaTags(result.tags),
                                     notes: result.notes,
                                   }
                                 : item,
@@ -473,10 +497,12 @@ export function MediaPage() {
           {filteredItems.map((item, index) => {
             const selected = selectedKeys.includes(item.key)
             const replaceInputId = `replace-media-${index}`
+            const itemTags = normalizeMediaTags(item.tags)
 
             return (
               <Card
                 key={item.key}
+                data-testid={`media-item-${index}`}
                 className={`overflow-hidden ${activeKey === item.key ? 'ring-1 ring-primary/40' : ''}`}
               >
                 <div className="relative aspect-[16/9] overflow-hidden bg-muted/30">
@@ -504,9 +530,9 @@ export function MediaPage() {
                       {item.last_modified ? <span>{item.last_modified}</span> : null}
                     </div>
                     {item.title ? <p className="text-sm text-foreground">{item.title}</p> : null}
-                    {item.tags.length ? (
+                    {itemTags.length ? (
                       <div className="flex flex-wrap gap-2">
-                        {item.tags.slice(0, 4).map((tag) => (
+                        {itemTags.slice(0, 4).map((tag) => (
                           <Badge key={`${item.key}-${tag}`} variant="outline">
                             {tag}
                           </Badge>
@@ -515,7 +541,12 @@ export function MediaPage() {
                     ) : null}
                   </div>
                   <div className="flex flex-wrap gap-2">
-                    <Button size="sm" variant="outline" onClick={() => setActiveKey(item.key)}>
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      onClick={() => setActiveKey(item.key)}
+                      data-testid={`media-edit-${index}`}
+                    >
                       元数据
                     </Button>
                     <Button
@@ -541,6 +572,7 @@ export function MediaPage() {
                     </Button>
                     <input
                       id={replaceInputId}
+                      data-testid={`media-replace-input-${index}`}
                       className="hidden"
                       type="file"
                       accept="image/*"
@@ -583,6 +615,7 @@ export function MediaPage() {
                       size="sm"
                       variant="danger"
                       disabled={deletingKey === item.key || replacingKey === item.key}
+                      data-testid={`media-delete-${index}`}
                       onClick={async () => {
                         if (!window.confirm(`确定删除 ${item.key} 吗？`)) {
                           return
diff --git a/admin/src/pages/post-compare-page.tsx b/admin/src/pages/post-compare-page.tsx
index 8727437..fac6ec1 100644
--- a/admin/src/pages/post-compare-page.tsx
+++ b/admin/src/pages/post-compare-page.tsx
@@ -1,5 +1,6 @@
 import { GitCompareArrows, RefreshCcw } from 'lucide-react'
 import { startTransition, useEffect, useMemo, useState } from 'react'
+import { useParams } from 'react-router-dom'
 
 import { MarkdownWorkbench } from '@/components/markdown-workbench'
 import { Badge } from '@/components/ui/badge'
@@ -17,15 +18,6 @@ type CompareState = {
   draftMarkdown: string
 }
 
-function resolveSlugFromPathname() {
-  if (typeof window === 'undefined') {
-    return ''
-  }
-
-  const match = window.location.pathname.match(/^\/posts\/([^/]+)\/compare\/?$/)
-  return match?.[1] ? decodeURIComponent(match[1]) : ''
-}
-
 function getDraftKey() {
   if (typeof window === 'undefined') {
     return null
@@ -35,7 +27,8 @@ function getDraftKey() {
 }
 
 export function PostComparePage({ slugOverride }: { slugOverride?: string }) {
-  const slug = slugOverride ?? resolveSlugFromPathname()
+  const { slug: routeSlug } = useParams<{ slug?: string }>()
+  const slug = slugOverride ?? routeSlug ?? ''
   const [state, setState] = useState<CompareState | null>(null)
   const [loading, setLoading] = useState(true)
   const [error, setError] = useState<string | null>(null)
@@ -49,6 +42,28 @@ export function PostComparePage({ slugOverride }: { slugOverride?: string }) {
         setError(null)
 
         const draft = loadDraftWindowSnapshot(getDraftKey())
+
+        if (draft && (!slug || draft.slug === slug)) {
+          if (!active) {
+            return
+          }
+
+          startTransition(() => {
+            setState({
+              title: draft.title,
+              slug: draft.slug,
+              path: draft.path,
+              savedMarkdown: draft.savedMarkdown,
+              draftMarkdown: draft.markdown,
+            })
+          })
+          return
+        }
+
+        if (!slug) {
+          throw new Error('缺少文章 slug，无法加载改动对比。')
+        }
+
         const [post, markdown] = await Promise.all([
           adminApi.getPostBySlug(slug),
           adminApi.getPostMarkdown(slug),
@@ -63,8 +78,8 @@ export function PostComparePage({ slugOverride }: { slugOverride?: string }) {
             title: post.title ?? slug,
             slug,
             path: markdown.path,
-            savedMarkdown: draft?.savedMarkdown ?? markdown.markdown,
-            draftMarkdown: draft?.markdown ?? markdown.markdown,
+            savedMarkdown: markdown.markdown,
+            draftMarkdown: markdown.markdown,
           })
         })
       } catch (loadError) {
diff --git a/admin/src/pages/post-preview-page.tsx b/admin/src/pages/post-preview-page.tsx
index a216700..01c2d6c 100644
--- a/admin/src/pages/post-preview-page.tsx
+++ b/admin/src/pages/post-preview-page.tsx
@@ -1,5 +1,6 @@
 import { ExternalLink, RefreshCcw } from 'lucide-react'
 import { startTransition, useEffect, useState } from 'react'
+import { useParams } from 'react-router-dom'
 
 import { MarkdownPreview } from '@/components/markdown-preview'
 import { MarkdownWorkbench } from '@/components/markdown-workbench'
@@ -17,15 +18,6 @@ type PreviewState = {
   markdown: string
 }
 
-function resolveSlugFromPathname() {
-  if (typeof window === 'undefined') {
-    return ''
-  }
-
-  const match = window.location.pathname.match(/^\/posts\/([^/]+)\/preview\/?$/)
-  return match?.[1] ? decodeURIComponent(match[1]) : ''
-}
-
 function getDraftKey() {
   if (typeof window === 'undefined') {
     return null
@@ -35,7 +27,8 @@ function getDraftKey() {
 }
 
 export function PostPreviewPage({ slugOverride }: { slugOverride?: string }) {
-  const slug = slugOverride ?? resolveSlugFromPathname()
+  const { slug: routeSlug } = useParams<{ slug?: string }>()
+  const slug = slugOverride ?? routeSlug ?? ''
   const [state, setState] = useState<PreviewState | null>(null)
   const [loading, setLoading] = useState(true)
   const [error, setError] = useState<string | null>(null)
@@ -50,7 +43,7 @@ export function PostPreviewPage({ slugOverride }: { slugOverride?: string }) {
 
         const draft = loadDraftWindowSnapshot(getDraftKey())
 
-        if (draft && draft.slug === slug) {
+        if (draft && (!slug || draft.slug === slug)) {
           if (!active) {
             return
           }
@@ -66,6 +59,10 @@ export function PostPreviewPage({ slugOverride }: { slugOverride?: string }) {
           return
         }
 
+        if (!slug) {
+          throw new Error('缺少文章 slug，无法加载独立预览。')
+        }
+
         const [post, markdown] = await Promise.all([
           adminApi.getPostBySlug(slug),
           adminApi.getPostMarkdown(slug),
diff --git a/admin/src/pages/posts-page.tsx b/admin/src/pages/posts-page.tsx
index 0efbeef..e691a13 100644
--- a/admin/src/pages/posts-page.tsx
+++ b/admin/src/pages/posts-page.tsx
@@ -4,9 +4,11 @@ import {
   ChevronLeft,
   ChevronRight,
   Download,
+  ExternalLink,
   FilePlus2,
   FileUp,
   FolderOpen,
+  GitCompareArrows,
   PencilLine,
   RefreshCcw,
   RotateCcw,
@@ -54,6 +56,13 @@ import {
 import { buildMarkdownDocument, parseMarkdownDocument } from '@/lib/markdown-document'
 import { countLineDiff, normalizeMarkdown } from '@/lib/markdown-diff'
 import { applySelectedDiffHunks, computeDiffHunks, type DiffHunk } from '@/lib/markdown-merge'
+import {
+  consumePolishWindowResult,
+  readPolishWindowResult,
+  saveDraftWindowSnapshot,
+  type DraftWindowSnapshot,
+  type PolishWindowResult,
+} from '@/lib/post-draft-window'
 import { buildFrontendUrl } from '@/lib/frontend-url'
 import { cn } from '@/lib/utils'
 import type {
@@ -206,6 +215,14 @@ const defaultCreateForm: CreatePostFormState = {
 const defaultWorkbenchPanels: MarkdownWorkbenchPanel[] = ['edit']
 const orderedWorkbenchPanels: MarkdownWorkbenchPanel[] = ['edit', 'preview', 'diff']
 const POSTS_PAGE_SIZE_OPTIONS = [12, 24, 48] as const
+const ADMIN_BASENAME =
+  ((import.meta.env.VITE_ADMIN_BASENAME as string | undefined)?.trim() || '').replace(/\/$/, '')
+const POLISH_RESULT_STORAGE_PREFIX = 'termi-admin-post-polish-result:'
+
+function buildAdminRoute(path: string) {
+  const normalizedPath = path.startsWith('/') ? path : `/${path}`
+  return `${ADMIN_BASENAME}${normalizedPath}` || normalizedPath
+}
 
 function formatWorkbenchPanelLabel(panel: MarkdownWorkbenchPanel) {
   switch (panel) {
@@ -828,6 +845,8 @@ export function PostsPage() {
   const [sortKey, setSortKey] = useState('updated_at_desc')
   const [totalPosts, setTotalPosts] = useState(0)
   const [totalPages, setTotalPages] = useState(1)
+  const editorPolishDraftKeyRef = useRef<string | null>(null)
+  const createPolishDraftKeyRef = useRef<string | null>(null)
 
   const { sortBy, sortOrder } = useMemo(() => {
     switch (sortKey) {
@@ -930,6 +949,7 @@ export function PostsPage() {
   useEffect(() => {
     setEditorMode('workspace')
     setEditorPanels(defaultWorkbenchPanels)
+    editorPolishDraftKeyRef.current = null
 
     if (!slug) {
       setEditor(null)
@@ -942,6 +962,12 @@ export function PostsPage() {
     void loadEditor(slug)
   }, [loadEditor, slug])
 
+  useEffect(() => {
+    if (!createDialogOpen) {
+      createPolishDraftKeyRef.current = null
+    }
+  }, [createDialogOpen])
+
   useEffect(() => {
     if (!metadataDialog && !slug && !createDialogOpen) {
       return
@@ -1024,6 +1050,175 @@ export function PostsPage() {
       normalizeMarkdown(buildCreateMarkdownForWindow(defaultCreateForm)),
     [createForm],
   )
+
+  const buildEditorDraftSnapshot = useCallback((): Omit<DraftWindowSnapshot, 'createdAt'> | null => {
+    if (!editor) {
+      return null
+    }
+
+    return {
+      title: editor.title.trim() || editor.slug,
+      slug: editor.slug,
+      path: editor.path,
+      markdown: buildDraftMarkdownForWindow(editor),
+      savedMarkdown: editor.savedMarkdown,
+    }
+  }, [editor])
+
+  const buildCreateDraftSnapshot = useCallback((): Omit<DraftWindowSnapshot, 'createdAt'> => {
+    const fallbackSlug = createForm.slug.trim() || 'new-post'
+
+    return {
+      title: createForm.title.trim() || createForm.slug.trim() || '新建草稿',
+      slug: fallbackSlug,
+      path: buildVirtualPostPath(fallbackSlug),
+      markdown: buildCreateMarkdownForWindow(createForm),
+      savedMarkdown: buildCreateMarkdownForWindow(defaultCreateForm),
+    }
+  }, [createForm])
+
+  const openDraftWorkbenchWindow = useCallback(
+    (
+      path: string,
+      snapshot: Omit<DraftWindowSnapshot, 'createdAt'>,
+      extraQuery?: Record<string, string>,
+    ) => {
+      const draftKey = saveDraftWindowSnapshot(snapshot)
+      const url = new URL(buildAdminRoute(path), window.location.origin)
+      url.searchParams.set('draftKey', draftKey)
+
+      Object.entries(extraQuery ?? {}).forEach(([key, value]) => {
+        if (value) {
+          url.searchParams.set(key, value)
+        }
+      })
+
+      const popup = window.open(
+        url.toString(),
+        '_blank',
+        'popup=yes,width=1560,height=980,resizable=yes,scrollbars=yes',
+      )
+
+      if (!popup) {
+        toast.error('浏览器拦截了独立工作台窗口，请允许当前站点打开新窗口后重试。')
+        return null
+      }
+
+      popup.focus()
+      return draftKey
+    },
+    [],
+  )
+
+  const applyExternalPolishResult = useCallback(
+    (result: PolishWindowResult) => {
+      if (result.target === 'editor') {
+        if (!editor) {
+          return false
+        }
+
+        startTransition(() => {
+          setEditor((current) =>
+            current ? applyPolishedEditorState(current, result.markdown) : current,
+          )
+          setEditorPolish(null)
+          setEditorMode('workspace')
+        })
+        toast.success('独立 AI 润色结果已回填到当前文章。')
+        return true
+      }
+
+      if (!createDialogOpen) {
+        return false
+      }
+
+      startTransition(() => {
+        setCreateForm((current) => applyPolishedCreateState(current, result.markdown))
+        setCreatePolish(null)
+        setCreateMode('workspace')
+      })
+      toast.success('独立 AI 润色结果已回填到新建草稿。')
+      return true
+    },
+    [createDialogOpen, editor],
+  )
+
+  const flushPendingPolishResult = useCallback(
+    (draftKey: string | null) => {
+      const pending = readPolishWindowResult(draftKey)
+      if (!pending || !applyExternalPolishResult(pending)) {
+        return false
+      }
+
+      consumePolishWindowResult(draftKey)
+      return true
+    },
+    [applyExternalPolishResult],
+  )
+
+  useEffect(() => {
+    const tryFlushAll = () => {
+      if (flushPendingPolishResult(editorPolishDraftKeyRef.current)) {
+        editorPolishDraftKeyRef.current = null
+      }
+      if (flushPendingPolishResult(createPolishDraftKeyRef.current)) {
+        createPolishDraftKeyRef.current = null
+      }
+    }
+
+    const handleMessage = (event: MessageEvent) => {
+      if (event.origin !== window.location.origin || !event.data) {
+        return
+      }
+
+      const payload = event.data as Partial<PolishWindowResult> & { type?: string }
+      if (
+        payload.type !== 'termi-admin-post-polish-apply' ||
+        typeof payload.draftKey !== 'string' ||
+        typeof payload.markdown !== 'string'
+      ) {
+        return
+      }
+
+      const result: PolishWindowResult = {
+        draftKey: payload.draftKey,
+        markdown: payload.markdown,
+        target: payload.target === 'create' ? 'create' : 'editor',
+        createdAt: typeof payload.createdAt === 'number' ? payload.createdAt : Date.now(),
+      }
+
+      if (!applyExternalPolishResult(result)) {
+        return
+      }
+
+      consumePolishWindowResult(result.draftKey)
+      if (result.target === 'editor') {
+        editorPolishDraftKeyRef.current = null
+      } else {
+        createPolishDraftKeyRef.current = null
+      }
+    }
+
+    const handleStorage = (event: StorageEvent) => {
+      if (!event.key?.startsWith(POLISH_RESULT_STORAGE_PREFIX)) {
+        return
+      }
+
+      tryFlushAll()
+    }
+
+    window.addEventListener('message', handleMessage)
+    window.addEventListener('storage', handleStorage)
+    window.addEventListener('focus', tryFlushAll)
+    tryFlushAll()
+
+    return () => {
+      window.removeEventListener('message', handleMessage)
+      window.removeEventListener('storage', handleStorage)
+      window.removeEventListener('focus', tryFlushAll)
+    }
+  }, [applyExternalPolishResult, flushPendingPolishResult])
+
   const compareStats = useMemo(() => {
     if (!editor) {
       return {
@@ -1324,6 +1519,60 @@ export function PostsPage() {
     }
   }, [])
 
+  const openEditorPreviewWindow = useCallback(() => {
+    const snapshot = buildEditorDraftSnapshot()
+    if (!snapshot) {
+      toast.error('请先打开一篇文章，再启动独立预览窗口。')
+      return
+    }
+
+    openDraftWorkbenchWindow(`/posts/${encodeURIComponent(snapshot.slug)}/preview`, snapshot)
+  }, [buildEditorDraftSnapshot, openDraftWorkbenchWindow])
+
+  const openEditorCompareWindow = useCallback(() => {
+    const snapshot = buildEditorDraftSnapshot()
+    if (!snapshot) {
+      toast.error('请先打开一篇文章，再启动独立对比窗口。')
+      return
+    }
+
+    openDraftWorkbenchWindow(`/posts/${encodeURIComponent(snapshot.slug)}/compare`, snapshot)
+  }, [buildEditorDraftSnapshot, openDraftWorkbenchWindow])
+
+  const openEditorPolishWindow = useCallback(() => {
+    const snapshot = buildEditorDraftSnapshot()
+    if (!snapshot) {
+      toast.error('请先打开一篇文章，再启动独立 AI 润色工作台。')
+      return
+    }
+
+    const draftKey = openDraftWorkbenchWindow('/posts/polish', snapshot, {
+      target: 'editor',
+    })
+
+    if (draftKey) {
+      editorPolishDraftKeyRef.current = draftKey
+    }
+  }, [buildEditorDraftSnapshot, openDraftWorkbenchWindow])
+
+  const openCreatePreviewWindow = useCallback(() => {
+    openDraftWorkbenchWindow('/posts/preview', buildCreateDraftSnapshot())
+  }, [buildCreateDraftSnapshot, openDraftWorkbenchWindow])
+
+  const openCreateCompareWindow = useCallback(() => {
+    openDraftWorkbenchWindow('/posts/compare', buildCreateDraftSnapshot())
+  }, [buildCreateDraftSnapshot, openDraftWorkbenchWindow])
+
+  const openCreatePolishWindow = useCallback(() => {
+    const draftKey = openDraftWorkbenchWindow('/posts/polish', buildCreateDraftSnapshot(), {
+      target: 'create',
+    })
+
+    if (draftKey) {
+      createPolishDraftKeyRef.current = draftKey
+    }
+  }, [buildCreateDraftSnapshot, openDraftWorkbenchWindow])
+
   const editorPolishHunks = useMemo(
     () =>
       editorPolish
@@ -1877,7 +2126,7 @@ export function PostsPage() {
         </div>
 
         <div className="flex flex-wrap items-center gap-3">
-          <Button variant="outline" onClick={openCreateDialog}>
+          <Button variant="outline" onClick={openCreateDialog} data-testid="posts-open-create">
             <FilePlus2 className="h-4 w-4" />
             新建草稿
           </Button>
@@ -1919,6 +2168,7 @@ export function PostsPage() {
             <div className="grid gap-3">
               <div className="flex flex-col gap-3 lg:flex-row">
                 <Input
+                  data-testid="posts-search"
                   className="flex-1"
                   placeholder="搜索标题、slug、分类、标签或摘要"
                   value={searchTerm}
@@ -1990,6 +2240,7 @@ export function PostsPage() {
                       <button
                         key={post.id}
                         type="button"
+                        data-testid={`post-item-${post.slug}`}
                         onClick={() => navigate(`/posts/${post.slug}`)}
                         className={cn(
                           'w-full rounded-[1.45rem] border px-4 py-3.5 text-left transition-all',
@@ -2099,7 +2350,7 @@ export function PostsPage() {
                     </div>
                   </div>
                   <div className="flex flex-wrap items-center gap-2">
-                    <Button variant="outline" onClick={closeEditorDialog}>
+                    <Button variant="outline" onClick={closeEditorDialog} data-testid="post-editor-close">
                       <ArrowLeft className="h-4 w-4" />
                       返回文章列表
                     </Button>
@@ -2148,6 +2399,7 @@ export function PostsPage() {
                 <CardContent className="space-y-4">
                   <FormField label="标题">
                     <Input
+                      data-testid="post-editor-title"
                       value={editor.title}
                       onChange={(event) =>
                         setEditor((current) =>
@@ -2439,6 +2691,18 @@ export function PostsPage() {
                     <Bot className="h-4 w-4" />
                     {generatingEditorMetadataProposal ? '分析中...' : 'AI 元信息'}
                   </Button>
+                  <Button variant="outline" onClick={openEditorPreviewWindow}>
+                    <ExternalLink className="h-4 w-4" />
+                    独立预览
+                  </Button>
+                  <Button variant="outline" onClick={openEditorCompareWindow}>
+                    <GitCompareArrows className="h-4 w-4" />
+                    独立对比
+                  </Button>
+                  <Button variant="outline" onClick={openEditorPolishWindow}>
+                    <WandSparkles className="h-4 w-4" />
+                    独立润色
+                  </Button>
                   <Button
                     variant="outline"
                     onClick={() => {
@@ -2474,11 +2738,12 @@ export function PostsPage() {
                     <RotateCcw className="h-4 w-4" />
                     恢复
                   </Button>
-                  <Button onClick={() => void saveEditor()} disabled={saving}>
+                  <Button onClick={() => void saveEditor()} disabled={saving} data-testid="post-editor-save">
                     <Save className="h-4 w-4" />
                     {saving ? '保存中...' : '保存'}
                   </Button>
                   <Button
+                    data-testid="post-editor-delete"
                     variant="danger"
                     onClick={async () => {
                       if (!window.confirm(`确定删除“${editor.title || editor.slug}”吗？`)) {
@@ -2614,6 +2879,7 @@ export function PostsPage() {
                 <CardContent className="space-y-4">
                   <FormField label="标题">
                     <Input
+                      data-testid="post-create-title"
                       value={createForm.title}
                       onChange={(event) =>
                         setCreateForm((current) => ({ ...current, title: event.target.value }))
@@ -2622,6 +2888,7 @@ export function PostsPage() {
                   </FormField>
                   <FormField label="Slug" hint="留空则根据标题自动生成。">
                     <Input
+                      data-testid="post-create-slug"
                       value={createForm.slug}
                       onChange={(event) =>
                         setCreateForm((current) => ({ ...current, slug: event.target.value }))
@@ -2871,6 +3138,18 @@ export function PostsPage() {
                   </CardDescription>
                 </div>
                 <div className="flex flex-wrap items-center gap-2">
+                  <Button variant="outline" onClick={openCreatePreviewWindow}>
+                    <ExternalLink className="h-4 w-4" />
+                    独立预览
+                  </Button>
+                  <Button variant="outline" onClick={openCreateCompareWindow}>
+                    <GitCompareArrows className="h-4 w-4" />
+                    独立对比
+                  </Button>
+                  <Button variant="outline" onClick={openCreatePolishWindow}>
+                    <WandSparkles className="h-4 w-4" />
+                    独立润色
+                  </Button>
                   <Button
                     variant="outline"
                     onClick={() => {
@@ -2907,6 +3186,7 @@ export function PostsPage() {
                     恢复模板
                   </Button>
                   <Button
+                    data-testid="post-create-submit"
                     onClick={async () => {
                       if (!createForm.title.trim()) {
                         toast.error('创建文章时必须填写标题。')
diff --git a/admin/src/pages/reviews-page.tsx b/admin/src/pages/reviews-page.tsx
index 6be4b66..6b7e5f4 100644
--- a/admin/src/pages/reviews-page.tsx
+++ b/admin/src/pages/reviews-page.tsx
@@ -305,6 +305,7 @@ export function ReviewsPage() {
                   <button
                     key={review.id}
                     type="button"
+                    data-testid={`review-item-${review.id}`}
                     onClick={() => {
                       setSelectedId(review.id)
                       setForm(toFormState(review))
@@ -363,6 +364,7 @@ export function ReviewsPage() {
             </div>
             <div className="flex flex-wrap items-center gap-3">
               <Button
+                data-testid="review-save"
                 onClick={async () => {
                   if (!form.title.trim()) {
                     toast.error('标题不能为空。')
@@ -411,6 +413,7 @@ export function ReviewsPage() {
               {selectedReview ? (
                 <Button
                   variant="danger"
+                  data-testid="review-delete"
                   disabled={deleting}
                   onClick={async () => {
                     if (!window.confirm('确定删除这条评测吗？')) {
@@ -453,6 +456,7 @@ export function ReviewsPage() {
             <div className="grid gap-5 lg:grid-cols-2">
               <FormField label="标题">
                 <Input
+                  data-testid="review-title"
                   value={form.title}
                   onChange={(event) =>
                     setForm((current) => ({ ...current, title: event.target.value }))
@@ -487,6 +491,7 @@ export function ReviewsPage() {
               </FormField>
               <FormField label="评测日期">
                 <Input
+                  data-testid="review-date"
                   type="date"
                   value={form.reviewDate}
                   onChange={(event) =>
@@ -583,6 +588,7 @@ export function ReviewsPage() {
                         <Button
                           size="sm"
                           variant="outline"
+                          data-testid="review-ai-polish"
                           onClick={() => void requestDescriptionPolish()}
                           disabled={polishingDescription}
                         >
@@ -603,6 +609,7 @@ export function ReviewsPage() {
                     </div>
 
                     <Textarea
+                      data-testid="review-description"
                       value={form.description}
                       onChange={(event) => {
                         const nextDescription = event.target.value
@@ -625,6 +632,7 @@ export function ReviewsPage() {
                           <div className="flex flex-wrap items-center gap-2">
                             <Button
                               size="sm"
+                              data-testid="review-ai-adopt"
                               onClick={() => {
                                 setForm((current) => ({
                                   ...current,
diff --git a/admin/src/pages/revisions-page.tsx b/admin/src/pages/revisions-page.tsx
index 475e863..0f7ad66 100644
--- a/admin/src/pages/revisions-page.tsx
+++ b/admin/src/pages/revisions-page.tsx
@@ -248,6 +248,7 @@ export function RevisionsPage() {
 
         <div className="flex flex-wrap items-center gap-3">
           <Input
+            data-testid="revisions-slug-filter"
             value={slugFilter}
             onChange={(event) => setSlugFilter(event.target.value)}
             placeholder="按 slug 过滤，例如 hello-world"
@@ -304,7 +305,12 @@ export function RevisionsPage() {
                     </TableCell>
                     <TableCell className="text-muted-foreground">{item.created_at}</TableCell>
                     <TableCell className="text-right">
-                      <Button variant="outline" size="sm" onClick={() => void openDetail(item.id)}>
+                      <Button
+                        variant="outline"
+                        size="sm"
+                        onClick={() => void openDetail(item.id)}
+                        data-testid={`revision-open-${item.id}`}
+                      >
                         <History className="h-4 w-4" />
                         查看 / 对比
                       </Button>
@@ -371,6 +377,7 @@ export function RevisionsPage() {
                           key={mode}
                           size="sm"
                           disabled={restoring !== null || !selected.item.has_markdown}
+                          data-testid={`revision-restore-${mode}`}
                           onClick={() => void runRestore(mode)}
                         >
                           <RotateCcw className="h-4 w-4" />
diff --git a/admin/src/pages/site-settings-page.tsx b/admin/src/pages/site-settings-page.tsx
index ce8bbc0..a760dac 100644
--- a/admin/src/pages/site-settings-page.tsx
+++ b/admin/src/pages/site-settings-page.tsx
@@ -485,13 +485,14 @@ export function SiteSettingsPage() {
         </div>
 
         <div className="flex flex-wrap items-center gap-3">
-          <Button variant="outline" onClick={() => void loadSettings(true)}>
+          <Button variant="outline" onClick={() => void loadSettings(true)} data-testid="site-settings-refresh">
             <RefreshCcw className="h-4 w-4" />
             刷新
           </Button>
           <Button
             variant="secondary"
             disabled={reindexing}
+            data-testid="site-settings-reindex"
             onClick={async () => {
               try {
                 setReindexing(true)
@@ -510,6 +511,7 @@ export function SiteSettingsPage() {
           </Button>
           <Button
             disabled={saving}
+            data-testid="site-settings-save"
             onClick={async () => {
               try {
                 setSaving(true)
@@ -543,6 +545,7 @@ export function SiteSettingsPage() {
           <CardContent className="grid gap-6 lg:grid-cols-2">
             <Field label="站点名称">
               <Input
+                data-testid="site-settings-site-name"
                 value={form.site_name ?? ''}
                 onChange={(event) => updateField('site_name', event.target.value)}
               />
@@ -724,6 +727,7 @@ export function SiteSettingsPage() {
               <div className="grid gap-4 lg:grid-cols-2">
                 <Field label="弹窗标题" hint="建议直接传达价值，例如“订阅更新”或“别错过新文章”。">
                   <Input
+                    data-testid="site-settings-popup-title"
                     value={form.subscription_popup_title}
                     onChange={(event) =>
                       updateField('subscription_popup_title', event.target.value)
@@ -1105,6 +1109,7 @@ export function SiteSettingsPage() {
                             <Button
                               type="button"
                               variant="outline"
+                              data-testid="site-settings-test-provider"
                               disabled={testingProvider}
                               onClick={async () => {
                                 try {
@@ -1243,6 +1248,7 @@ export function SiteSettingsPage() {
                     <Button
                       type="button"
                       variant="outline"
+                      data-testid="site-settings-test-image-provider"
                       disabled={testingImageProvider}
                       onClick={async () => {
                         try {
@@ -1396,6 +1402,7 @@ export function SiteSettingsPage() {
                 <Button
                   type="button"
                   variant="outline"
+                  data-testid="site-settings-test-storage"
                   disabled={testingR2Storage}
                   onClick={async () => {
                     try {
diff --git a/admin/src/pages/subscriptions-page.tsx b/admin/src/pages/subscriptions-page.tsx
index a6f4031..cb2da5f 100644
--- a/admin/src/pages/subscriptions-page.tsx
+++ b/admin/src/pages/subscriptions-page.tsx
@@ -188,6 +188,7 @@ export function SubscriptionsPage() {
           <Button
             variant="secondary"
             disabled={digesting !== null}
+            data-testid="subscriptions-send-weekly"
             onClick={async () => {
               try {
                 setDigesting('weekly')
@@ -206,6 +207,7 @@ export function SubscriptionsPage() {
           </Button>
           <Button
             disabled={digesting !== null}
+            data-testid="subscriptions-send-monthly"
             onClick={async () => {
               try {
                 setDigesting('monthly')
@@ -314,7 +316,12 @@ export function SubscriptionsPage() {
               />
             </div>
             <div className="flex flex-wrap gap-3">
-              <Button className="flex-1" disabled={submitting} onClick={() => void submitForm()}>
+              <Button
+                className="flex-1"
+                disabled={submitting}
+                onClick={() => void submitForm()}
+                data-testid="subscriptions-save"
+              >
                 {editingId ? <Save className="h-4 w-4" /> : <MailPlus className="h-4 w-4" />}
                 {submitting ? '保存中...' : editingId ? '保存修改' : '保存订阅目标'}
               </Button>
@@ -349,7 +356,7 @@ export function SubscriptionsPage() {
               </TableHeader>
               <TableBody>
                 {subscriptions.map((item) => (
-                  <TableRow key={item.id}>
+                  <TableRow key={item.id} data-testid={`subscription-row-${item.id}`}>
                     <TableCell>
                       <div className="space-y-1">
                         <div className="font-medium">{item.display_name ?? item.channel_type}</div>
@@ -382,6 +389,7 @@ export function SubscriptionsPage() {
                         <Button
                           variant="outline"
                           size="sm"
+                          data-testid={`subscription-edit-${item.id}`}
                           onClick={() => {
                             setEditingId(item.id)
                             setForm({
@@ -402,6 +410,7 @@ export function SubscriptionsPage() {
                           variant="outline"
                           size="sm"
                           disabled={actioningId === item.id}
+                          data-testid={`subscription-test-${item.id}`}
                           onClick={async () => {
                             try {
                               setActioningId(item.id)
@@ -422,6 +431,7 @@ export function SubscriptionsPage() {
                           variant="ghost"
                           size="sm"
                           disabled={actioningId === item.id}
+                          data-testid={`subscription-delete-${item.id}`}
                           onClick={async () => {
                             try {
                               setActioningId(item.id)
diff --git a/admin/src/pages/tags-page.tsx b/admin/src/pages/tags-page.tsx
index dbbc283..719c048 100644
--- a/admin/src/pages/tags-page.tsx
+++ b/admin/src/pages/tags-page.tsx
@@ -218,6 +218,7 @@ export function TagsPage() {
           </CardHeader>
           <CardContent className="space-y-4">
             <Input
+              data-testid="tags-search"
               placeholder="按标签名 / slug / 描述搜索"
               value={searchTerm}
               onChange={(event) => setSearchTerm(event.target.value)}
@@ -229,6 +230,7 @@ export function TagsPage() {
                   <button
                     key={item.id}
                     type="button"
+                    data-testid={`tag-item-${item.slug}`}
                     onClick={() => {
                       setSelectedId(item.id)
                       setForm(toFormState(item))
@@ -286,6 +288,7 @@ export function TagsPage() {
             <div className="grid gap-4 lg:grid-cols-2">
               <FormField label="标签名称" hint="例如：astro、rust、workflow。">
                 <Input
+                  data-testid="tag-name-input"
                   value={form.name}
                   onChange={(event) => setForm((current) => ({ ...current, name: event.target.value }))}
                   placeholder="输入标签名称"
@@ -293,6 +296,7 @@ export function TagsPage() {
               </FormField>
               <FormField label="标签 slug" hint="留空时自动从英文名称生成；中文建议手填。">
                 <Input
+                  data-testid="tag-slug-input"
                   value={form.slug}
                   onChange={(event) => setForm((current) => ({ ...current, slug: event.target.value }))}
                   placeholder="astro"
@@ -377,7 +381,7 @@ export function TagsPage() {
             </div>
 
             <div className="flex flex-wrap items-center gap-3">
-              <Button onClick={() => void handleSave()} disabled={saving}>
+              <Button onClick={() => void handleSave()} disabled={saving} data-testid="tag-save">
                 <Save className="h-4 w-4" />
                 {saving ? '保存中...' : selectedItem ? '保存标签' : '创建标签'}
               </Button>
@@ -388,6 +392,7 @@ export function TagsPage() {
                 variant="ghost"
                 onClick={() => void handleDelete()}
                 disabled={!selectedItem || deleting}
+                data-testid="tag-delete"
                 className="text-rose-600 hover:text-rose-600"
               >
                 <Trash2 className="h-4 w-4" />
diff --git a/frontend/src/lib/reviews.ts b/frontend/src/lib/reviews.ts
new file mode 100644
index 0000000..2bbcffe
--- /dev/null
+++ b/frontend/src/lib/reviews.ts
@@ -0,0 +1,92 @@
+import type { Review } from './api/client';
+
+export type ReviewStatus = 'completed' | 'in-progress' | 'dropped';
+
+export type ParsedReview = Omit<Review, 'tags'> & {
+  tags: string[];
+  normalizedStatus: ReviewStatus;
+  coverIsImage: boolean;
+  coverUrl: string | null;
+  linkUrl: string | null;
+  externalLink: boolean;
+};
+
+const reviewCoverCatalog: Record<string, string> = {
+  '《漫长的季节》': '/review-covers/the-long-season.svg',
+  '《十三邀》': '/review-covers/thirteen-invites.svg',
+  '《黑神话：悟空》': '/review-covers/black-myth-wukong.svg',
+  '《置身事内》': '/review-covers/placed-within.svg',
+  '《宇宙探索编辑部》': '/review-covers/journey-to-the-west-editorial.svg',
+  '《疲惫生活中的英雄梦想》': '/review-covers/hero-dreams-in-tired-life.svg',
+};
+
+export function normalizeReviewStatus(status: string | null | undefined): ReviewStatus {
+  const normalized = String(status || '').trim().toLowerCase();
+
+  if (normalized === 'published' || normalized === 'completed' || normalized === 'done') {
+    return 'completed';
+  }
+
+  if (
+    normalized === 'draft' ||
+    normalized === 'in-progress' ||
+    normalized === 'watching' ||
+    normalized === 'reading' ||
+    normalized === 'listening'
+  ) {
+    return 'in-progress';
+  }
+
+  if (normalized === 'dropped' || normalized === 'abandoned') {
+    return 'dropped';
+  }
+
+  return 'completed';
+}
+
+export function parseReviewTags(value: string | null | undefined): string[] {
+  if (!value) {
+    return [];
+  }
+
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item): item is string => typeof item === 'string') : [];
+  } catch {
+    return [];
+  }
+}
+
+export function isImageCover(cover: string | null | undefined) {
+  const normalized = String(cover || '').trim();
+  return /^(https?:)?\/\//.test(normalized) || normalized.startsWith('/');
+}
+
+export function resolveReviewCover(review: Pick<Review, 'cover' | 'title'>) {
+  if (isImageCover(review.cover)) {
+    return String(review.cover).trim();
+  }
+
+  return reviewCoverCatalog[review.title] || null;
+}
+
+export function normalizeLinkUrl(value: string | null | undefined) {
+  const trimmed = String(value || '').trim();
+  return trimmed ? trimmed : null;
+}
+
+export function isExternalLink(value: string | null | undefined) {
+  return /^(https?:)?\/\//.test(String(value || '').trim());
+}
+
+export function parseReview(review: Review): ParsedReview {
+  return {
+    ...review,
+    tags: parseReviewTags(review.tags),
+    normalizedStatus: normalizeReviewStatus(review.status),
+    coverIsImage: isImageCover(review.cover),
+    coverUrl: resolveReviewCover(review),
+    linkUrl: normalizeLinkUrl(review.link_url),
+    externalLink: isExternalLink(review.link_url),
+  };
+}
diff --git a/frontend/src/lib/utils/data.ts b/frontend/src/lib/utils/data.ts
deleted file mode 100644
index caf3729..0000000
--- a/frontend/src/lib/utils/data.ts
+++ /dev/null
@@ -1,194 +0,0 @@
-import type { Post, Category, Tag, FriendLink } from '../types';
-
-// Mock data for static site generation
-export const mockPosts: Post[] = [
-  {
-    id: '1',
-    slug: 'welcome-to-termi',
-    title: '欢迎来到 Termi 终端博客',
-    description: '这是一个基于终端风格的现代博客平台，结合了极客美学与极致性能。',
-    date: '2024-03-20',
-    readTime: '3 分钟',
-    type: 'article',
-    tags: ['astro', 'svelte', 'tailwind'],
-    category: '技术',
-    pinned: true,
-    image: 'https://picsum.photos/1200/600?random=1'
-  },
-  {
-    id: '2',
-    slug: 'astro-ssg-guide',
-    title: 'Astro 静态站点生成指南',
-    description: '学习如何使用 Astro 构建高性能的静态网站，掌握群岛架构的核心概念。',
-    date: '2024-03-18',
-    readTime: '5 分钟',
-    type: 'article',
-    tags: ['astro', 'ssg', 'performance'],
-    category: '前端'
-  },
-  {
-    id: '3',
-    slug: 'tailwind-v4-features',
-    title: 'Tailwind CSS v4 新特性解析',
-    description: '探索 Tailwind CSS v4 带来的全新特性，包括改进的性能和更简洁的配置。',
-    date: '2024-03-15',
-    readTime: '4 分钟',
-    type: 'article',
-    tags: ['tailwind', 'css', 'design'],
-    category: '前端'
-  },
-  {
-    id: '4',
-    slug: 'daily-thought-1',
-    title: '关于代码与咖啡的思考',
-    description: '写代码就像冲咖啡，需要耐心和恰到好处的温度。今天尝试了几款新豆子，每一杯都有不同的风味。',
-    date: '2024-03-14',
-    readTime: '1 分钟',
-    type: 'tweet',
-    tags: ['life', 'coding'],
-    category: '随笔',
-    images: [
-      'https://images.unsplash.com/photo-1495474472287-4d71bcdd2085?w=400&h=400&fit=crop',
-      'https://images.unsplash.com/photo-1509042239860-f550ce710b93?w=400&h=400&fit=crop',
-      'https://images.unsplash.com/photo-1514432324607-a09d9b4aefdd?w=400&h=400&fit=crop'
-    ]
-  },
-  {
-    id: '5',
-    slug: 'svelte-5-runes',
-    title: 'Svelte 5 Runes 完全指南',
-    description: '深入了解 Svelte 5 的 Runes 系统，掌握下一代响应式编程范式。',
-    date: '2024-03-10',
-    readTime: '8 分钟',
-    type: 'article',
-    tags: ['svelte', 'javascript', 'frontend'],
-    category: '前端'
-  }
-];
-
-export const mockCategories: Category[] = [
-  { id: '1', name: '技术', slug: 'tech', icon: 'fa-code', count: 3 },
-  { id: '2', name: '前端', slug: 'frontend', icon: 'fa-laptop-code', count: 3 },
-  { id: '3', name: '随笔', slug: 'essay', icon: 'fa-pen', count: 1 },
-  { id: '4', name: '生活', slug: 'life', icon: 'fa-coffee', count: 1 }
-];
-
-export const mockTags: Tag[] = [
-  { id: '1', name: 'astro', slug: 'astro', count: 1 },
-  { id: '2', name: 'svelte', slug: 'svelte', count: 2 },
-  { id: '3', name: 'tailwind', slug: 'tailwind', count: 2 },
-  { id: '4', name: 'frontend', slug: 'frontend', count: 2 },
-  { id: '5', name: 'ssg', slug: 'ssg', count: 1 },
-  { id: '6', name: 'css', slug: 'css', count: 1 },
-  { id: '7', name: 'javascript', slug: 'javascript', count: 1 },
-  { id: '8', name: 'life', slug: 'life', count: 1 },
-  { id: '9', name: 'coding', slug: 'coding', count: 1 }
-];
-
-export const mockFriendLinks: FriendLink[] = [
-  {
-    id: '1',
-    name: 'Astro 官网',
-    url: 'https://astro.build',
-    avatar: 'https://astro.build/favicon.svg',
-    description: '极速内容驱动的网站框架',
-    category: '技术博客'
-  },
-  {
-    id: '2',
-    name: 'Svelte 官网',
-    url: 'https://svelte.dev',
-    avatar: 'https://svelte.dev/favicon.png',
-    description: '控制论增强的 Web 应用',
-    category: '技术博客'
-  },
-  {
-    id: '3',
-    name: 'Tailwind CSS',
-    url: 'https://tailwindcss.com',
-    avatar: 'https://tailwindcss.com/favicons/favicon-32x32.png',
-    description: '实用优先的 CSS 框架',
-    category: '技术博客'
-  }
-];
-
-export const mockSiteConfig = {
-  name: 'Termi',
-  description: '终端风格的内容平台',
-  author: 'InitCool',
-  url: 'https://termi.dev',
-  social: {
-    github: 'https://github.com',
-    twitter: 'https://twitter.com',
-    email: 'mailto:hello@termi.dev'
-  }
-};
-
-export const mockSystemStats = [
-  { label: 'Last Update', value: '2024-03-20' },
-  { label: 'Posts', value: '12' },
-  { label: 'Visitors', value: '1.2k' }
-];
-
-export const mockTechStack = [
-  { name: 'Astro' },
-  { name: 'Svelte' },
-  { name: 'Tailwind CSS' },
-  { name: 'TypeScript' },
-  { name: 'Vercel' }
-];
-
-export const mockHomeAboutIntro = '一名热爱技术的前端开发者，专注于构建高性能、优雅的用户界面。相信代码不仅是工具，更是一种艺术表达。';
-
-// Helper functions
-export function getPinnedPost(): Post | null {
-  return mockPosts.find(p => p.pinned) || null;
-}
-
-export function getRecentPosts(limit: number = 5): Post[] {
-  return mockPosts.slice(0, limit);
-}
-
-export function getAllPosts(): Post[] {
-  return mockPosts;
-}
-
-export function getPostBySlug(slug: string): Post | undefined {
-  return mockPosts.find(p => p.slug === slug);
-}
-
-export function getPostsByTag(tag: string): Post[] {
-  return mockPosts.filter(p => p.tags.includes(tag));
-}
-
-export function getPostsByCategory(category: string): Post[] {
-  return mockPosts.filter(p => p.category === category);
-}
-
-export function getAllCategories(): Category[] {
-  return mockCategories;
-}
-
-export function getAllTags(): Tag[] {
-  return mockTags;
-}
-
-export function getAllFriendLinks(): FriendLink[] {
-  return mockFriendLinks;
-}
-
-export function getSiteConfig() {
-  return mockSiteConfig;
-}
-
-export function getSystemStats() {
-  return mockSystemStats;
-}
-
-export function getTechStack() {
-  return mockTechStack;
-}
-
-export function getHomeAboutIntro() {
-  return mockHomeAboutIntro;
-}
diff --git a/frontend/src/pages/reviews/[id].astro b/frontend/src/pages/reviews/[id].astro
new file mode 100644
index 0000000..b5d7d08
--- /dev/null
+++ b/frontend/src/pages/reviews/[id].astro
@@ -0,0 +1,384 @@
+---
+import BaseLayout from '../../layouts/BaseLayout.astro';
+import TerminalWindow from '../../components/ui/TerminalWindow.astro';
+import CommandPrompt from '../../components/ui/CommandPrompt.astro';
+import ResponsiveImage from '../../components/ui/ResponsiveImage.astro';
+import { apiClient, DEFAULT_SITE_SETTINGS } from '../../lib/api/client';
+import { getI18n } from '../../lib/i18n';
+import { parseReview } from '../../lib/reviews';
+
+export const prerender = false;
+
+const { locale, t } = getI18n(Astro);
+const copy =
+  locale === 'en'
+    ? {
+        summary: 'Review note',
+        metadata: 'Metadata',
+        notes: 'Notes',
+        tags: 'Tags',
+        back: 'Back to reviews',
+        openLink: 'Open related link',
+        notFoundTitle: 'Review not found',
+        notFoundDescription:
+          'The requested review does not exist or is temporarily unavailable.',
+        rating: 'Rating',
+        type: 'Type',
+        status: 'Status',
+        reviewDate: 'Review date',
+        updatedAt: 'Updated at',
+      }
+    : {
+        summary: '评价摘要',
+        metadata: '元信息',
+        notes: '记录内容',
+        tags: '标签',
+        back: '返回评价列表',
+        openLink: '打开相关链接',
+        notFoundTitle: '评价不存在',
+        notFoundDescription: '当前请求的评价不存在，或者暂时无法从后端读取。',
+        rating: '评分',
+        type: '类型',
+        status: '状态',
+        reviewDate: '记录日期',
+        updatedAt: '更新时间',
+      };
+
+let siteSettings = DEFAULT_SITE_SETTINGS;
+try {
+  siteSettings = await apiClient.getSiteSettings();
+} catch (error) {
+  console.error('Failed to load site settings for review detail:', error);
+}
+
+const reviewId = Number(Astro.params.id);
+let review = null;
+
+if (Number.isFinite(reviewId)) {
+  try {
+    review = parseReview(await apiClient.getReview(reviewId));
+  } catch (error) {
+    console.error(`Failed to load review ${reviewId}:`, error);
+  }
+}
+
+if (!review) {
+  Astro.response.status = 404;
+}
+
+const typeLabels: Record<string, string> = {
+  game: t('reviews.typeGame'),
+  anime: t('reviews.typeAnime'),
+  music: t('reviews.typeMusic'),
+  book: t('reviews.typeBook'),
+  movie: t('reviews.typeMovie'),
+};
+
+const statusLabels = {
+  completed: t('reviews.statusCompleted'),
+  'in-progress': t('reviews.statusInProgress'),
+  dropped: t('reviews.statusDropped'),
+};
+
+const pageTitle = review
+  ? `${review.title} | ${t('reviews.title')} | ${siteSettings.siteShortName}`
+  : `${copy.notFoundTitle} | ${siteSettings.siteShortName}`;
+const pageDescription = review?.description || copy.notFoundDescription;
+const canonical = review ? `/reviews/${review.id}` : '/reviews';
+const jsonLd = review
+  ? {
+      '@context': 'https://schema.org',
+      '@type': 'Review',
+      name: review.title,
+      reviewBody: review.description,
+      datePublished: review.review_date,
+      dateModified: review.updated_at,
+      reviewRating: {
+        '@type': 'Rating',
+        ratingValue: review.rating,
+        bestRating: 5,
+        worstRating: 1,
+      },
+      itemReviewed: {
+        '@type': 'CreativeWork',
+        name: review.title,
+        genre: typeLabels[review.review_type] || review.review_type,
+      },
+      url: new URL(`/reviews/${review.id}`, siteSettings.siteUrl).toString(),
+    }
+  : undefined;
+---
+
+<BaseLayout
+  title={pageTitle}
+  description={pageDescription}
+  siteSettings={siteSettings}
+  canonical={canonical}
+  ogImage={review?.coverUrl || undefined}
+  ogType={review ? 'article' : 'website'}
+  jsonLd={jsonLd}
+>
+  <div class="max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+    <TerminalWindow title={review ? `~/reviews/${review.id}` : '~/reviews/not-found'} class="w-full">
+      <div class="space-y-6 px-4 py-4">
+        <div class="space-y-4">
+          <CommandPrompt
+            command={review ? `sed -n '1,160p' ./reviews/${review.id}.md` : 'ls ./reviews'}
+            path="~/reviews"
+          />
+
+          <div class="terminal-panel ml-4">
+            <div class="terminal-kicker">{copy.summary}</div>
+            <div class="terminal-section-title mt-4">
+              <span class="terminal-section-icon">
+                <i class={`fas ${review ? 'fa-star' : 'fa-triangle-exclamation'}`}></i>
+              </span>
+              <div>
+                <h1 class="text-2xl font-bold text-[var(--title-color)]">
+                  {review ? review.title : copy.notFoundTitle}
+                </h1>
+                <p class="mt-2 text-sm leading-6 text-[var(--text-secondary)]">
+                  {review ? review.description : copy.notFoundDescription}
+                </p>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        {review ? (
+          <>
+            <div>
+              <CommandPrompt command="jq '.meta' review.json" path="~/reviews" />
+              <div class="review-detail-shell ml-4 mt-2">
+                <div class="review-detail-cover terminal-panel">
+                  {review.coverUrl ? (
+                    <ResponsiveImage
+                      src={review.coverUrl}
+                      alt={`${review.title} cover`}
+                      pictureClass="block h-full w-full"
+                      imgClass="review-detail-cover__image"
+                      widths={[640, 960, 1280, 1600]}
+                      sizes="(min-width: 1280px) 42rem, 100vw"
+                    />
+                  ) : (
+                    <div class="review-detail-cover__fallback">
+                      <div class="review-detail-cover__year">{review.review_date.slice(0, 4)}</div>
+                      <div class="review-detail-cover__emoji">{review.cover || '★'}</div>
+                      <div class="review-detail-cover__title">{review.title}</div>
+                    </div>
+                  )}
+                </div>
+
+                <div class="space-y-4">
+                  <div class="terminal-panel review-detail-card">
+                    <div class="review-detail-card__header">
+                      <span class="terminal-kicker">{copy.metadata}</span>
+                      <div class="review-detail-card__rating">
+                        <strong>{review.rating.toFixed(1)}</strong>
+                        <span>/ 5</span>
+                      </div>
+                    </div>
+                    <div class="review-detail-meta-grid">
+                      <div>
+                        <div class="review-detail-meta-grid__label">{copy.type}</div>
+                        <div>{typeLabels[review.review_type] || review.review_type}</div>
+                      </div>
+                      <div>
+                        <div class="review-detail-meta-grid__label">{copy.status}</div>
+                        <div>{statusLabels[review.normalizedStatus]}</div>
+                      </div>
+                      <div>
+                        <div class="review-detail-meta-grid__label">{copy.reviewDate}</div>
+                        <div>{review.review_date}</div>
+                      </div>
+                      <div>
+                        <div class="review-detail-meta-grid__label">{copy.updatedAt}</div>
+                        <div>{review.updated_at}</div>
+                      </div>
+                    </div>
+                  </div>
+
+                  <div class="terminal-panel review-detail-card">
+                    <div class="terminal-kicker">{copy.tags}</div>
+                    <div class="review-detail-tags mt-4">
+                      {review.tags.length ? (
+                        review.tags.map((tag) => (
+                          <span class="terminal-chip text-xs py-1 px-2.5">#{tag}</span>
+                        ))
+                      ) : (
+                        <span class="text-sm text-[var(--text-secondary)]">{t('common.noData')}</span>
+                      )}
+                    </div>
+                  </div>
+
+                  <div class="review-detail-actions">
+                    {review.linkUrl && (
+                      <a
+                        href={review.linkUrl}
+                        class="terminal-action-button"
+                        target={review.externalLink ? '_blank' : undefined}
+                        rel={review.externalLink ? 'noreferrer noopener' : undefined}
+                      >
+                        <i class={`fas ${review.externalLink ? 'fa-arrow-up-right-from-square' : 'fa-arrow-right'}`}></i>
+                        <span>{copy.openLink}</span>
+                      </a>
+                    )}
+                    <a href="/reviews" class="terminal-subtle-link">
+                      <i class="fas fa-chevron-left"></i>
+                      <span class="font-mono">{copy.back}</span>
+                    </a>
+                  </div>
+                </div>
+              </div>
+            </div>
+
+            <div>
+              <CommandPrompt command="cat review.md" path="~/reviews" />
+              <div class="terminal-panel ml-4 mt-2 review-detail-card">
+                <div class="terminal-kicker">{copy.notes}</div>
+                <div class="review-detail-body mt-4">
+                  {review.description}
+                </div>
+              </div>
+            </div>
+          </>
+        ) : (
+          <div class="ml-4 rounded-2xl border border-dashed border-[var(--border-color)] bg-[var(--bg)]/60 px-5 py-8">
+            <p class="text-sm leading-7 text-[var(--text-secondary)]">
+              {copy.notFoundDescription}
+            </p>
+            <a href="/reviews" class="terminal-subtle-link mt-4 inline-flex">
+              <i class="fas fa-chevron-left"></i>
+              <span class="font-mono">{copy.back}</span>
+            </a>
+          </div>
+        )}
+      </div>
+    </TerminalWindow>
+  </div>
+</BaseLayout>
+
+<style>
+  .review-detail-shell {
+    display: grid;
+    gap: 1rem;
+    grid-template-columns: minmax(0, 1.25fr) minmax(280px, 0.75fr);
+  }
+
+  .review-detail-cover {
+    overflow: hidden;
+    min-height: 22rem;
+    padding: 0;
+  }
+
+  .review-detail-cover__image {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    display: block;
+  }
+
+  .review-detail-cover__fallback {
+    min-height: 22rem;
+    height: 100%;
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+    padding: 1.5rem;
+    background:
+      linear-gradient(160deg, color-mix(in oklab, var(--primary) 18%, var(--terminal-bg)), color-mix(in oklab, var(--secondary) 12%, var(--header-bg)) 48%, color-mix(in oklab, var(--terminal-bg) 96%, transparent)),
+      radial-gradient(circle at top right, color-mix(in oklab, var(--primary) 24%, transparent), transparent 44%);
+  }
+
+  .review-detail-cover__year {
+    font-size: 0.72rem;
+    letter-spacing: 0.18em;
+    text-transform: uppercase;
+    color: var(--text-tertiary);
+  }
+
+  .review-detail-cover__emoji {
+    font-size: 4.75rem;
+    line-height: 1;
+    align-self: center;
+  }
+
+  .review-detail-cover__title {
+    font-size: 1.3rem;
+    font-weight: 800;
+    line-height: 1.35;
+    color: var(--title-color);
+  }
+
+  .review-detail-card {
+    padding: 1rem;
+  }
+
+  .review-detail-card__header {
+    display: flex;
+    align-items: flex-start;
+    justify-content: space-between;
+    gap: 1rem;
+  }
+
+  .review-detail-card__rating {
+    display: flex;
+    align-items: baseline;
+    gap: 0.35rem;
+    color: var(--primary);
+  }
+
+  .review-detail-card__rating strong {
+    font-size: 2rem;
+    line-height: 1;
+  }
+
+  .review-detail-meta-grid {
+    margin-top: 1rem;
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 0.9rem;
+    font-size: 0.95rem;
+    color: var(--text-secondary);
+  }
+
+  .review-detail-meta-grid__label {
+    margin-bottom: 0.3rem;
+    font-size: 0.72rem;
+    letter-spacing: 0.14em;
+    text-transform: uppercase;
+    color: var(--text-tertiary);
+  }
+
+  .review-detail-tags {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.5rem;
+  }
+
+  .review-detail-actions {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.85rem;
+    align-items: center;
+  }
+
+  .review-detail-body {
+    white-space: pre-wrap;
+    font-size: 0.98rem;
+    line-height: 1.95;
+    color: var(--text-secondary);
+  }
+
+  @media (max-width: 1024px) {
+    .review-detail-shell {
+      grid-template-columns: minmax(0, 1fr);
+    }
+  }
+
+  @media (max-width: 640px) {
+    .review-detail-meta-grid {
+      grid-template-columns: minmax(0, 1fr);
+    }
+  }
+</style>
diff --git a/frontend/src/pages/reviews/index.astro b/frontend/src/pages/reviews/index.astro
index e6a75b7..8d3e4f4 100644
--- a/frontend/src/pages/reviews/index.astro
+++ b/frontend/src/pages/reviews/index.astro
@@ -6,21 +6,10 @@ import FilterPill from '../../components/ui/FilterPill.astro';
 import ResponsiveImage from '../../components/ui/ResponsiveImage.astro';
 import { apiClient } from '../../lib/api/client';
 import { getI18n } from '../../lib/i18n';
-import type { Review } from '../../lib/api/client';
+import { parseReview, type ParsedReview, type ReviewStatus } from '../../lib/reviews';
 
 export const prerender = false;
 
-type ReviewStatus = 'completed' | 'in-progress' | 'dropped';
-
-type ParsedReview = Omit<Review, 'tags'> & {
-  tags: string[];
-  normalizedStatus: ReviewStatus;
-  coverIsImage: boolean;
-  coverUrl: string | null;
-  linkUrl: string | null;
-  externalLink: boolean;
-};
-
 // Fetch reviews from backend API
 let reviews: Awaited<ReturnType<typeof apiClient.getReviews>> = [];
 const url = new URL(Astro.request.url);
@@ -32,60 +21,7 @@ try {
   console.error('Failed to fetch reviews:', error);
 }
 
-const normalizeReviewStatus = (status: string | null | undefined): ReviewStatus => {
-  const normalized = String(status || '').trim().toLowerCase();
-
-  if (normalized === 'published' || normalized === 'completed' || normalized === 'done') {
-    return 'completed';
-  }
-
-  if (normalized === 'draft' || normalized === 'in-progress' || normalized === 'watching' || normalized === 'reading' || normalized === 'listening') {
-    return 'in-progress';
-  }
-
-  if (normalized === 'dropped' || normalized === 'abandoned') {
-    return 'dropped';
-  }
-
-  return 'completed';
-};
-
-const isImageCover = (cover: string | null | undefined) => /^(https?:)?\/\//.test(String(cover || '').trim()) || String(cover || '').trim().startsWith('/');
-
-const reviewCoverCatalog: Record<string, string> = {
-  '《漫长的季节》': '/review-covers/the-long-season.svg',
-  '《十三邀》': '/review-covers/thirteen-invites.svg',
-  '《黑神话：悟空》': '/review-covers/black-myth-wukong.svg',
-  '《置身事内》': '/review-covers/placed-within.svg',
-  '《宇宙探索编辑部》': '/review-covers/journey-to-the-west-editorial.svg',
-  '《疲惫生活中的英雄梦想》': '/review-covers/hero-dreams-in-tired-life.svg',
-};
-
-const resolveReviewCover = (review: Review) => {
-  if (isImageCover(review.cover)) {
-    return String(review.cover).trim();
-  }
-
-  return reviewCoverCatalog[review.title] || null;
-};
-
-const normalizeLinkUrl = (value: string | null | undefined) => {
-  const trimmed = String(value || '').trim();
-  return trimmed ? trimmed : null;
-};
-
-const isExternalLink = (value: string | null | undefined) => /^(https?:)?\/\//.test(String(value || '').trim());
-
-// Parse tags from JSON string
-const parsedReviews: ParsedReview[] = reviews.map(r => ({
-  ...r,
-  tags: r.tags ? JSON.parse(r.tags) as string[] : [],
-  normalizedStatus: normalizeReviewStatus(r.status),
-  coverIsImage: isImageCover(r.cover),
-  coverUrl: resolveReviewCover(r),
-  linkUrl: normalizeLinkUrl(r.link_url),
-  externalLink: isExternalLink(r.link_url),
-}));
+const parsedReviews: ParsedReview[] = reviews.map(parseReview);
 
 const filteredReviews = selectedType === 'all'
   ? parsedReviews
@@ -290,25 +226,27 @@ const statCards = [
                   style={`--review-accent: ${typeColors[review.review_type] || '#888'};`}
                 >
                   <div class="review-card__poster">
-                    {review.coverUrl ? (
-                      <ResponsiveImage
-                        src={review.coverUrl}
-                        alt={`${review.title} cover`}
-                        pictureClass="block h-full w-full"
-                        imgClass="review-card__poster-image"
-                        widths={[320, 480, 720, 960]}
-                        sizes="(min-width: 1536px) 18vw, (min-width: 1024px) 28vw, (min-width: 640px) 45vw, 100vw"
-                      />
-                    ) : (
-                      <div class="review-card__poster-fallback">
-                        <div class="review-card__poster-kicker">
-                          <span>{typeLabels[review.review_type] || review.review_type}</span>
-                          <span>{review.review_date.slice(0, 4)}</span>
+                    <a href={`/reviews/${review.id}`} class="review-card__poster-link" aria-label={`查看 ${review.title} 详情`}>
+                      {review.coverUrl ? (
+                        <ResponsiveImage
+                          src={review.coverUrl}
+                          alt={`${review.title} cover`}
+                          pictureClass="block h-full w-full"
+                          imgClass="review-card__poster-image"
+                          widths={[320, 480, 720, 960]}
+                          sizes="(min-width: 1536px) 18vw, (min-width: 1024px) 28vw, (min-width: 640px) 45vw, 100vw"
+                        />
+                      ) : (
+                        <div class="review-card__poster-fallback">
+                          <div class="review-card__poster-kicker">
+                            <span>{typeLabels[review.review_type] || review.review_type}</span>
+                            <span>{review.review_date.slice(0, 4)}</span>
+                          </div>
+                          <div class="review-card__poster-emoji">{review.cover || '★'}</div>
+                          <div class="review-card__poster-title">{review.title}</div>
                         </div>
-                        <div class="review-card__poster-emoji">{review.cover || '★'}</div>
-                        <div class="review-card__poster-title">{review.title}</div>
-                      </div>
-                    )}
+                      )}
+                    </a>
                   </div>
 
                   <div class="review-card__body">
@@ -322,7 +260,11 @@ const statCards = [
                             {statusLabels[review.normalizedStatus]}
                           </span>
                         </div>
-                        <h2 class="review-card__title">{review.title}</h2>
+                        <h2 class="review-card__title">
+                          <a href={`/reviews/${review.id}`} class="review-card__title-link">
+                            {review.title}
+                          </a>
+                        </h2>
                       </div>
                       <div class="review-card__rating">
                         <div class="review-card__rating-value">{review.rating || 0}.0</div>
@@ -337,6 +279,10 @@ const statCards = [
                     <p class="review-card__description">{review.description}</p>
 
                     <div class="review-card__meta">
+                      <a href={`/reviews/${review.id}`} class="review-card__link review-card__link--internal">
+                        <i class="fas fa-file-lines"></i>
+                        <span class="font-mono">cat review.md</span>
+                      </a>
                       <span class="terminal-chip text-xs py-1 px-2.5">
                         <i class="fas fa-calendar text-[10px]"></i>
                         <span>{review.review_date}</span>
@@ -629,6 +575,13 @@ const statCards = [
       inset 0 1px 0 rgba(255, 255, 255, 0.08);
   }
 
+  .review-card__poster-link {
+    display: block;
+    height: 100%;
+    color: inherit;
+    text-decoration: none;
+  }
+
   .review-card__poster-image {
     width: 100%;
     height: 100%;
@@ -715,6 +668,16 @@ const statCards = [
     color: var(--title-color);
   }
 
+  .review-card__title-link {
+    color: inherit;
+    text-decoration: none;
+    transition: color 180ms ease;
+  }
+
+  .review-card__title-link:hover {
+    color: var(--review-accent);
+  }
+
   .review-card__rating {
     text-align: right;
     flex-shrink: 0;
@@ -772,6 +735,10 @@ const statCards = [
     background: color-mix(in oklab, var(--review-accent) 16%, var(--terminal-bg));
   }
 
+  .review-card__link--internal {
+    color: var(--title-color);
+  }
+
   .review-card__tags {
     display: flex;
     flex-wrap: wrap;
diff --git a/frontend/src/pages/sitemap.xml.ts b/frontend/src/pages/sitemap.xml.ts
index 3e51c5d..9d60be2 100644
--- a/frontend/src/pages/sitemap.xml.ts
+++ b/frontend/src/pages/sitemap.xml.ts
@@ -23,6 +23,7 @@ export const GET: APIRoute = async ({ request }) => {
 
   let siteSettings = DEFAULT_SITE_SETTINGS
   let posts = await api.getRawPosts().catch(() => [])
+  const reviews = await api.getReviews().catch(() => [])
 
   try {
     siteSettings = await api.getSiteSettings()
@@ -62,7 +63,14 @@ export const GET: APIRoute = async ({ request }) => {
     priority: post.pinned ? '0.9' : '0.7',
   }))
 
-  const xmlBody = [...staticUrls, ...postUrls]
+  const reviewUrls = reviews.map((review) => ({
+    loc: ensureAbsoluteUrl(siteUrl, `/reviews/${review.id}`),
+    lastmod: new Date(review.updated_at || review.created_at).toISOString(),
+    changefreq: 'monthly',
+    priority: '0.6',
+  }))
+
+  const xmlBody = [...staticUrls, ...postUrls, ...reviewUrls]
     .map(
       (item) => `
   <url>
diff --git a/package.json b/package.json
index b929451..61086dd 100644
--- a/package.json
+++ b/package.json
@@ -8,6 +8,11 @@
     "dev:admin": "powershell -ExecutionPolicy Bypass -File ./dev.ps1 -Only admin",
     "dev:backend": "powershell -ExecutionPolicy Bypass -File ./dev.ps1 -Only backend",
     "dev:mcp-only": "powershell -ExecutionPolicy Bypass -File ./dev.ps1 -Only mcp",
+    "test:ui": "pnpm --dir ./playwright-smoke test",
+    "test:ui:frontend": "pnpm --dir ./playwright-smoke test:frontend",
+    "test:ui:admin": "pnpm --dir ./playwright-smoke test:admin",
+    "test:ui:headed": "pnpm --dir ./playwright-smoke test:headed",
+    "test:ui:install-browsers": "pnpm --dir ./playwright-smoke install:browsers",
     "stop": "powershell -ExecutionPolicy Bypass -File ./stop-services.ps1",
     "restart": "powershell -ExecutionPolicy Bypass -File ./restart-services.ps1"
   }
diff --git a/playwright-smoke/.gitignore b/playwright-smoke/.gitignore
new file mode 100644
index 0000000..945fcd0
--- /dev/null
+++ b/playwright-smoke/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+playwright-report/
+test-results/
diff --git a/playwright-smoke/README.md b/playwright-smoke/README.md
new file mode 100644
index 0000000..2610abc
--- /dev/null
+++ b/playwright-smoke/README.md
@@ -0,0 +1,33 @@
+# Playwright 回归测试
+
+## 本地运行
+
+```powershell
+cd playwright-smoke
+pnpm install
+pnpm test
+```
+
+或在仓库根目录直接执行：
+
+```powershell
+pnpm test:ui
+```
+
+## 可用脚本
+
+- `pnpm test`：跑前台 + 后台全量回归
+- `pnpm test:frontend`：只跑前台
+- `pnpm test:admin`：只跑后台
+- `pnpm test:headed`：有界面调试
+
+## 设计说明
+
+- 使用独立 `mock-server.mjs` 提供前台 SSR、前端交互、后台 CRUD 所需的稳定假数据。
+- CI 不依赖真实数据库 / Rust 后端，适合做前后台 UI 回归。
+- 每条用例开始前都会调用 mock reset，避免数据串扰。
+- 本地默认优先走已安装的 `msedge` channel，CI 仍使用 `playwright install chromium`。
+- 当前已覆盖：
+  - 前台：首页过滤、文章详情、评论、搜索、AI 问答、友链申请、订阅确认/管理/退订
+  - 后台：登录、导航、评论审核、友链审核
+  - 后台深度回归：分类 CRUD、标签 CRUD、订阅 CRUD / 测试发送 / weekly & monthly digest、文章创建/保存/版本恢复/删除、媒体上传/元数据/替换/删除、站点设置保存/AI 重建索引/Provider 连通性/存储连通性、评测 CRUD / AI 润色、评论画像与黑名单管理
diff --git a/playwright-smoke/mock-server.mjs b/playwright-smoke/mock-server.mjs
new file mode 100644
index 0000000..f11471f
--- /dev/null
+++ b/playwright-smoke/mock-server.mjs
@@ -0,0 +1,3211 @@
+import { createServer } from 'node:http'
+import { randomUUID } from 'node:crypto'
+
+const PORT = Number(process.env.PLAYWRIGHT_MOCK_PORT || 5159)
+const FRONTEND_ORIGIN =
+  process.env.PLAYWRIGHT_FRONTEND_ORIGIN || 'http://127.0.0.1:4321'
+const ADMIN_ORIGIN =
+  process.env.PLAYWRIGHT_ADMIN_ORIGIN || 'http://127.0.0.1:4322'
+const MOCK_ORIGIN = `http://127.0.0.1:${PORT}`
+const SESSION_COOKIE = 'termi_admin_session'
+const SESSION_VALUE = 'mock-admin-session'
+const CONTENT_TYPES = {
+  json: 'application/json; charset=utf-8',
+  text: 'text/plain; charset=utf-8',
+  sse: 'text/event-stream; charset=utf-8',
+  svg: 'image/svg+xml; charset=utf-8',
+}
+const VALID_LOGIN = {
+  username: 'admin',
+  password: 'admin123',
+}
+const BASE_TS = Date.parse('2026-04-01T09:00:00.000Z')
+
+const categoryCatalog = [
+  {
+    name: '前端工程',
+    slug: 'frontend-engineering',
+    description: '围绕 Astro、Svelte、设计系统与终端风格交互的实现记录。',
+    cover_image: `${MOCK_ORIGIN}/media-files/category-frontend.svg`,
+    accent_color: '#2563eb',
+    seo_title: '前端工程专题',
+    seo_description: 'Astro / Svelte / 终端风格 UI 相关的实现与复盘。',
+  },
+  {
+    name: '测试体系',
+    slug: 'testing-systems',
+    description: '记录 Playwright、CI、回归测试与稳定性治理的落地经验。',
+    cover_image: `${MOCK_ORIGIN}/media-files/category-testing.svg`,
+    accent_color: '#14b8a6',
+    seo_title: '测试体系专题',
+    seo_description: '端到端回归、CI 编排和测试工具链整理。',
+  },
+  {
+    name: '运维值班',
+    slug: 'operations-oncall',
+    description: '备份、恢复、对象存储与上线清单等值班经验。',
+    cover_image: `${MOCK_ORIGIN}/media-files/category-ops.svg`,
+    accent_color: '#f97316',
+    seo_title: '运维值班专题',
+    seo_description: '备份、恢复、发布和值班操作的实践手册。',
+  },
+]
+
+const tagCatalog = [
+  {
+    name: 'Astro',
+    slug: 'astro',
+    description: 'Astro 内容站与 SSR 落地笔记。',
+    cover_image: `${MOCK_ORIGIN}/media-files/tag-astro.svg`,
+    accent_color: '#8b5cf6',
+    seo_title: 'Astro 标签页',
+    seo_description: 'Astro、组件、内容站工程实践。',
+  },
+  {
+    name: 'Playwright',
+    slug: 'playwright',
+    description: 'E2E 回归与浏览器自动化。',
+    cover_image: `${MOCK_ORIGIN}/media-files/tag-playwright.svg`,
+    accent_color: '#10b981',
+    seo_title: 'Playwright 标签页',
+    seo_description: 'Playwright、回归测试与自动化流程。',
+  },
+  {
+    name: 'Svelte',
+    slug: 'svelte',
+    description: 'Svelte 状态管理、组件组织与交互。',
+    cover_image: `${MOCK_ORIGIN}/media-files/tag-svelte.svg`,
+    accent_color: '#f97316',
+    seo_title: 'Svelte 标签页',
+    seo_description: 'Svelte 页面状态和组件模式记录。',
+  },
+  {
+    name: 'AI',
+    slug: 'ai',
+    description: '站内问答、提示词和索引配置实验。',
+    cover_image: `${MOCK_ORIGIN}/media-files/tag-ai.svg`,
+    accent_color: '#ec4899',
+    seo_title: 'AI 标签页',
+    seo_description: 'AI 问答、提示词和检索增强内容。',
+  },
+  {
+    name: 'Docker',
+    slug: 'docker',
+    description: 'Docker 编排、发布和值班脚本。',
+    cover_image: `${MOCK_ORIGIN}/media-files/tag-docker.svg`,
+    accent_color: '#0ea5e9',
+    seo_title: 'Docker 标签页',
+    seo_description: 'Docker 发布、运行时与值班记录。',
+  },
+  {
+    name: 'CI',
+    slug: 'ci',
+    description: 'CI 与工作流编排。',
+    cover_image: `${MOCK_ORIGIN}/media-files/tag-ci.svg`,
+    accent_color: '#22c55e',
+    seo_title: 'CI 标签页',
+    seo_description: 'CI、工作流和自动化执行策略。',
+  },
+]
+
+const postCatalog = [
+  {
+    title: 'Astro 终端博客信息架构实战',
+    slug: 'astro-terminal-blog',
+    description: 'Termi 前台首页、过滤器、文章卡片和终端风格布局的整体拆解。',
+    category: '前端工程',
+    tags: ['Astro', 'Svelte', 'AI'],
+    post_type: 'article',
+    image: '/review-covers/the-long-season.svg',
+    images: ['/review-covers/black-myth-wukong.svg', '/review-covers/thirteen-invites.svg'],
+    pinned: true,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2026-03-28T09:00:00.000Z',
+    updated_at: '2026-03-29T06:00:00.000Z',
+    paragraphs: [
+      'Termi 的首页不是纯展示页，而是把文章、评测、友链和订阅动作压进同一个终端式入口，确保用户第一次进入时就能感知站点的信息密度。',
+      '为了让首页筛选足够顺滑，我们把文章类型、分类和标签都收敛到统一的状态模型里，任何切换都只改 URL 与最小可见集，而不是整页重新渲染。',
+      '这一版改造也顺手补了阅读指标入口，让热门内容、完读率和阅读时长能在前台自然暴露，方便后续继续做推荐与 AI 问答。',
+    ],
+  },
+  {
+    title: 'Playwright 回归工作流设计',
+    slug: 'playwright-regression-workflow',
+    description: 'Termi 前后台共用一套 Playwright smoke 回归，覆盖 CI、mock server 和关键路径。',
+    category: '测试体系',
+    tags: ['Playwright', 'CI', 'Astro'],
+    post_type: 'article',
+    image: '/review-covers/placed-within.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2026-03-20T10:30:00.000Z',
+    updated_at: '2026-03-20T10:30:00.000Z',
+    paragraphs: [
+      'Playwright 套件会同时拉起前台、后台和 mock server，用独立的内存状态来模拟文章、评论、友链、评测和订阅流程。',
+      '这样做的好处是 CI 不再依赖真实 Rust 后端或数据库，也能把前后台的大部分关键交互跑一遍。',
+      '只要 mock 数据结构和接口契约稳定，这套 smoke 就能快速捕获组件改版、表单失效和路由错误。',
+    ],
+  },
+  {
+    title: 'Svelte 状态仓库拆分模式',
+    slug: 'svelte-state-patterns',
+    description: 'Termi 在前台筛选、搜索和订阅弹窗里如何拆分 Svelte 状态与副作用。',
+    category: '前端工程',
+    tags: ['Svelte', 'Astro', 'Playwright'],
+    post_type: 'article',
+    image: '/review-covers/journey-to-the-west-editorial.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2026-02-18T08:10:00.000Z',
+    updated_at: '2026-02-18T08:10:00.000Z',
+    paragraphs: [
+      '搜索模式切换、首页过滤器和订阅弹窗本质上都属于“短生命周期但高交互密度”的状态，适合被拆成局部仓库而不是抬到全局。',
+      '这样每个功能块都能保留独立的 URL 同步和本地缓存逻辑，避免一个页面动作把整个前台状态带乱。',
+    ],
+  },
+  {
+    title: 'AI 搜索提示词调优记录',
+    slug: 'ai-search-prompt-design',
+    description: 'Termi 站内 AI 问答如何平衡检索结果、回答密度和提示词约束。',
+    category: '测试体系',
+    tags: ['AI', 'Playwright', 'CI'],
+    post_type: 'article',
+    image: '/review-covers/hero-dreams-in-tired-life.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2025-12-11T08:00:00.000Z',
+    updated_at: '2025-12-11T08:00:00.000Z',
+    paragraphs: [
+      'AI 问答页的目标不是单纯返回一段答案，而是把引用来源、索引时间和相关度一起暴露给用户。',
+      '我们更关心“这个回答是否足够可追溯”，因此来源卡片、SSE 状态提示和缓存命中都被纳入同一条链路。',
+    ],
+  },
+  {
+    title: 'Docker 发布值班清单',
+    slug: 'docker-rollout-checklist',
+    description: 'Termi 的 CI/CD 与 Docker 发布手册：构建、上传、回滚和对象存储连通性检查。',
+    category: '运维值班',
+    tags: ['Docker', 'CI', 'AI'],
+    post_type: 'article',
+    image: '/review-covers/black-myth-wukong.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2025-10-02T07:20:00.000Z',
+    updated_at: '2025-10-02T07:20:00.000Z',
+    paragraphs: [
+      '值班手册的核心是把部署前检查、发布后验证和回滚策略写清楚，而不是只留下一个 docker compose up。',
+      '在 Termi 里，R2 连通性、备份导出和前后台 smoke 都属于上线前必须执行的低成本检查。',
+    ],
+  },
+  {
+    title: '终端风格内容站封面系统',
+    slug: 'terminal-cover-system',
+    description: 'Termi 如何统一文章封面、评测海报和后台媒体库，减少重复素材治理成本。',
+    category: '前端工程',
+    tags: ['Astro', 'AI', 'Docker'],
+    post_type: 'article',
+    image: '/review-covers/the-long-season.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2025-07-15T11:00:00.000Z',
+    updated_at: '2025-07-16T04:00:00.000Z',
+    paragraphs: [
+      '无论是文章页 hero 图、评测封面还是后台素材库，最终都需要同一套 key、alt、caption 和标签模型。',
+      '这让媒体库不仅能服务前台渲染，也能成为后台创建文章和评测时的统一素材来源。',
+    ],
+  },
+  {
+    title: '内容观测与阅读完成度',
+    slug: 'content-observability-lab',
+    description: 'Termi 的阅读进度、页面访问与完读事件如何反哺首页热门内容和后台分析页。',
+    category: '测试体系',
+    tags: ['AI', 'Playwright', 'Svelte'],
+    post_type: 'article',
+    image: '/review-covers/placed-within.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2025-04-04T06:40:00.000Z',
+    updated_at: '2025-04-05T09:20:00.000Z',
+    paragraphs: [
+      '阅读进度上报看似只是埋点，但如果没有统一会话标识和节流策略，后台分析很快就会被噪音淹没。',
+      'Termi 的做法是把 page view、read progress 和 read complete 统一成同一个内容分析模型。',
+    ],
+  },
+  {
+    title: 'Markdown 导入与版本回滚',
+    slug: 'markdown-import-and-revisions',
+    description: 'Termi 后台的 Markdown 导入、版本快照和回滚流程，方便内容大批量迁移。',
+    category: '运维值班',
+    tags: ['CI', 'Docker', 'Playwright'],
+    post_type: 'article',
+    image: '/review-covers/thirteen-invites.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2024-11-21T10:00:00.000Z',
+    updated_at: '2024-11-21T10:00:00.000Z',
+    paragraphs: [
+      '批量导入 Markdown 时最容易漏掉的是 slug 冲突、元数据缺失和回滚策略，因此版本快照必须和写入动作绑定。',
+      '只要恢复接口能按 full、markdown、metadata 三种模式工作，回归测试就能覆盖大部分内容变更风险。',
+    ],
+  },
+  {
+    title: '前台订阅弹窗节奏实验',
+    slug: 'subscription-popup-experiments',
+    description: 'Termi 订阅弹窗如何控制触发时机、收口文案和确认链路，避免一上来就打断阅读。',
+    category: '测试体系',
+    tags: ['AI', 'Svelte', 'Astro'],
+    post_type: 'article',
+    image: '/review-covers/journey-to-the-west-editorial.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2024-08-08T12:00:00.000Z',
+    updated_at: '2024-08-08T12:00:00.000Z',
+    paragraphs: [
+      '订阅弹窗如果没有上下文，就会被用户当成纯打断；因此我们只在滚动达到阈值或明确点击订阅按钮后再打开。',
+      '邮箱确认页、偏好管理页和退订页也被纳入同一条测试链，确保状态切换能闭环。',
+    ],
+  },
+  {
+    title: '友链申请审核设计稿',
+    slug: 'friend-link-review-workflow',
+    description: 'Termi 友链从前台申请到后台审核的最小闭环，以及分类、状态与前台展示规则。',
+    category: '前端工程',
+    tags: ['Astro', 'Playwright', 'Svelte'],
+    post_type: 'article',
+    image: '/review-covers/hero-dreams-in-tired-life.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2024-06-13T13:20:00.000Z',
+    updated_at: '2024-06-13T13:20:00.000Z',
+    paragraphs: [
+      '友链系统看起来简单，但实际上同时涉及前台表单、后台审核、状态变更和分组展示。',
+      '把这条链路纳入 Playwright 回归后，能很快发现表单字段映射和审核按钮失效的问题。',
+    ],
+  },
+  {
+    title: '值班手册：备份与恢复演练',
+    slug: 'ops-backup-runbook',
+    description: 'Termi 备份导出、导入、媒体清单和恢复演练的操作要点。',
+    category: '运维值班',
+    tags: ['Docker', 'AI', 'CI'],
+    post_type: 'tweet',
+    image: '/review-covers/black-myth-wukong.svg',
+    images: [],
+    pinned: false,
+    status: 'published',
+    visibility: 'public',
+    created_at: '2024-03-03T09:10:00.000Z',
+    updated_at: '2024-03-03T09:10:00.000Z',
+    paragraphs: [
+      '备份不是把 JSON 导出来就结束，恢复演练必须能证明分类、标签、评测、媒体与 Markdown 都能被重新装回。',
+      '我们把这篇值班手册作为 tweet 类型内容保留，用来验证前台类型过滤与后台导出逻辑。',
+    ],
+  },
+  {
+    title: '私有草稿：季度回顾',
+    slug: 'private-quarterly-retrospective',
+    description: '仅后台可见的私有草稿，用于验证预览、保存和独立工作台。',
+    category: '测试体系',
+    tags: ['AI', 'Playwright'],
+    post_type: 'article',
+    image: '/review-covers/the-long-season.svg',
+    images: [],
+    pinned: false,
+    status: 'draft',
+    visibility: 'private',
+    created_at: '2026-03-30T11:00:00.000Z',
+    updated_at: '2026-03-30T11:00:00.000Z',
+    paragraphs: [
+      '这是一个私有草稿，只应出现在后台编辑器与独立预览窗口中。',
+      '用它可以验证 include_private、preview 和 Markdown 更新链路。',
+    ],
+  },
+  {
+    title: '计划中的站点改版路线图',
+    slug: 'scheduled-site-roadmap',
+    description: '一篇已经排期但尚未到发布时间的路线图文章，用于校验后台状态统计。',
+    category: '测试体系',
+    tags: ['CI', 'Astro'],
+    post_type: 'article',
+    image: '/review-covers/placed-within.svg',
+    images: [],
+    pinned: false,
+    status: 'scheduled',
+    visibility: 'public',
+    publish_at: '2026-04-15T03:00:00.000Z',
+    unpublish_at: null,
+    created_at: '2026-04-01T02:00:00.000Z',
+    updated_at: '2026-04-01T02:00:00.000Z',
+    paragraphs: [
+      '这篇文章用于测试定时发布和后台概览统计，不应该出现在前台公开列表里。',
+      '当发布时间未到时，文章仍可在后台独立预览与对比。',
+    ],
+  },
+]
+
+function iso(offsetMinutes = 0) {
+  return new Date(BASE_TS + offsetMinutes * 60_000).toISOString()
+}
+
+function json(res, status, payload, headers = {}) {
+  res.writeHead(status, {
+    'content-type': CONTENT_TYPES.json,
+    'cache-control': 'no-store',
+    ...headers,
+  })
+  res.end(JSON.stringify(payload))
+}
+
+function text(res, status, body, headers = {}) {
+  res.writeHead(status, {
+    'content-type': CONTENT_TYPES.text,
+    'cache-control': 'no-store',
+    ...headers,
+  })
+  res.end(body)
+}
+
+function reflectCors(req, res) {
+  const origin = req.headers.origin
+  if (!origin) {
+    return
+  }
+
+  if ([FRONTEND_ORIGIN, ADMIN_ORIGIN].includes(origin)) {
+    res.setHeader('access-control-allow-origin', origin)
+    res.setHeader('vary', 'Origin')
+    res.setHeader('access-control-allow-credentials', 'true')
+    res.setHeader(
+      'access-control-allow-headers',
+      'Content-Type, Authorization, X-Requested-With',
+    )
+    res.setHeader(
+      'access-control-allow-methods',
+      'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+    )
+  }
+}
+
+function readRequestBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = []
+    req.on('data', (chunk) => chunks.push(chunk))
+    req.on('end', () => resolve(Buffer.concat(chunks)))
+    req.on('error', reject)
+  })
+}
+
+function safeJsonParse(raw, fallback = {}) {
+  try {
+    return JSON.parse(raw)
+  } catch {
+    return fallback
+  }
+}
+
+function parseMultipartBody(buffer, contentType) {
+  const boundaryMatch = contentType.match(/boundary=(?:"([^"]+)"|([^;]+))/i)
+  const boundary = boundaryMatch?.[1] || boundaryMatch?.[2]
+  if (!boundary) {
+    return { fields: {}, files: [] }
+  }
+
+  const source = buffer.toString('latin1')
+  const parts = source.split(`--${boundary}`)
+  const fields = {}
+  const files = []
+
+  for (const part of parts) {
+    const trimmed = part.trim()
+    if (!trimmed || trimmed === '--') {
+      continue
+    }
+
+    const [rawHeaders, ...bodyChunks] = part.split('\r\n\r\n')
+    if (!rawHeaders || !bodyChunks.length) {
+      continue
+    }
+
+    const body = bodyChunks.join('\r\n\r\n').replace(/\r\n$/, '')
+    const headerLines = rawHeaders
+      .split('\r\n')
+      .map((line) => line.trim())
+      .filter(Boolean)
+    const disposition = headerLines.find((line) =>
+      line.toLowerCase().startsWith('content-disposition:'),
+    )
+
+    if (!disposition) {
+      continue
+    }
+
+    const nameMatch = disposition.match(/name="([^"]+)"/i)
+    const filenameMatch = disposition.match(/filename="([^"]*)"/i)
+    const fieldName = nameMatch?.[1]
+
+    if (!fieldName) {
+      continue
+    }
+
+    const contentTypeLine = headerLines.find((line) =>
+      line.toLowerCase().startsWith('content-type:'),
+    )
+    const fileName = filenameMatch?.[1]
+
+    if (fileName !== undefined) {
+      files.push({
+        fieldName,
+        filename: fileName,
+        contentType: contentTypeLine?.split(':')[1]?.trim() || 'application/octet-stream',
+        size: Buffer.from(body, 'latin1').length,
+        text: Buffer.from(body, 'latin1').toString('utf8'),
+      })
+      continue
+    }
+
+    if (fieldName in fields) {
+      const current = fields[fieldName]
+      if (Array.isArray(current)) {
+        current.push(body)
+      } else {
+        fields[fieldName] = [current, body]
+      }
+    } else {
+      fields[fieldName] = body
+    }
+  }
+
+  return { fields, files }
+}
+
+async function parseRequest(req) {
+  const body = await readRequestBody(req)
+  const contentType = String(req.headers['content-type'] || '')
+
+  if (!body.length) {
+    return { body, json: {}, fields: {}, files: [] }
+  }
+
+  if (contentType.includes('application/json')) {
+    return { body, json: safeJsonParse(body.toString('utf8'), {}), fields: {}, files: [] }
+  }
+
+  if (contentType.includes('multipart/form-data')) {
+    const parsed = parseMultipartBody(body, contentType)
+    return { body, json: {}, ...parsed }
+  }
+
+  return { body, json: {}, fields: {}, files: [] }
+}
+
+function getCookies(req) {
+  return String(req.headers.cookie || '')
+    .split(';')
+    .map((item) => item.trim())
+    .filter(Boolean)
+    .reduce((acc, item) => {
+      const index = item.indexOf('=')
+      if (index === -1) {
+        return acc
+      }
+      acc[item.slice(0, index)] = item.slice(index + 1)
+      return acc
+    }, {})
+}
+
+function isAuthenticated(req) {
+  return getCookies(req)[SESSION_COOKIE] === SESSION_VALUE
+}
+
+function ensureAdmin(req, res) {
+  if (isAuthenticated(req)) {
+    return true
+  }
+
+  json(res, 401, {
+    error: 'unauthorized',
+    description: '当前未登录后台。',
+  })
+  return false
+}
+
+function slugify(value) {
+  return String(value || '')
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+}
+
+function normalizeText(value) {
+  return String(value || '').trim()
+}
+
+function toBoolean(value, fallback = false) {
+  if (value === undefined || value === null || value === '') {
+    return fallback
+  }
+  if (typeof value === 'boolean') {
+    return value
+  }
+  return ['1', 'true', 'yes', 'on'].includes(String(value).trim().toLowerCase())
+}
+
+function parseJsonArray(value) {
+  if (Array.isArray(value)) {
+    return value
+  }
+
+  if (!value) {
+    return []
+  }
+
+  if (typeof value === 'string') {
+    try {
+      const parsed = JSON.parse(value)
+      return Array.isArray(parsed) ? parsed : []
+    } catch {
+      return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean)
+    }
+  }
+
+  return []
+}
+
+function buildMarkdown(title, paragraphs) {
+  return `# ${title}\n\n${paragraphs.join('\n\n')}\n`
+}
+
+function normalizeParagraphText(textValue) {
+  return textValue.replace(/\s+/g, ' ').trim().toLowerCase()
+}
+
+function fnv1aHash(value) {
+  let hash = 0x811c9dc5
+
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.charCodeAt(index)
+    hash = Math.imul(hash, 0x01000193)
+  }
+
+  return (hash >>> 0).toString(16).padStart(8, '0')
+}
+
+function extractParagraphDescriptors(markdown) {
+  const occurrences = new Map()
+  const content = String(markdown || '')
+    .replace(/^#\s+.+\n+/, '')
+    .split(/\n{2,}/)
+    .map((block) => block.trim())
+    .filter((block) => block && !block.startsWith('#') && !block.startsWith('!['))
+
+  return content.map((paragraph) => {
+    const normalized = normalizeParagraphText(paragraph)
+    const hash = fnv1aHash(normalized)
+    const occurrence = (occurrences.get(hash) || 0) + 1
+    occurrences.set(hash, occurrence)
+
+    return {
+      key: `p-${hash}-${occurrence}`,
+      excerpt: paragraph.length <= 120 ? paragraph : `${paragraph.slice(0, 120).trimEnd()}...`,
+      text: paragraph,
+    }
+  })
+}
+
+function clone(value) {
+  return JSON.parse(JSON.stringify(value))
+}
+
+function createSessionResponse(authenticated) {
+  return {
+    authenticated,
+    username: authenticated ? VALID_LOGIN.username : null,
+    email: authenticated ? 'admin@termi.test' : null,
+    auth_source: authenticated ? 'mock-local' : null,
+    auth_provider: authenticated ? 'mock-session' : null,
+    groups: authenticated ? ['admin'] : [],
+    proxy_auth_enabled: false,
+    local_login_enabled: true,
+    can_logout: authenticated,
+  }
+}
+
+const NOW_ISO = iso(0)
+
+const reviewCatalog = [
+  {
+    title: '《漫长的季节》',
+    review_type: 'anime',
+    rating: 5,
+    review_date: '2026-03-21',
+    status: 'completed',
+    description: '把东北工业景观、家庭裂痕和悬疑节奏揉进一起，后劲非常强。',
+    tags: ['悬疑', '现实主义', '年度最佳'],
+    cover: '/review-covers/the-long-season.svg',
+    link_url: 'https://example.invalid/reviews/the-long-season',
+  },
+  {
+    title: '《黑神话：悟空》',
+    review_type: 'game',
+    rating: 4,
+    review_date: '2026-03-18',
+    status: 'completed',
+    description: '美术和动作系统都足够能打，流程细节还有继续打磨空间。',
+    tags: ['动作', '国产', '年度观察'],
+    cover: '/review-covers/black-myth-wukong.svg',
+    link_url: 'https://example.invalid/reviews/black-myth-wukong',
+  },
+  {
+    title: '《置身事内》',
+    review_type: 'book',
+    rating: 5,
+    review_date: '2026-02-02',
+    status: 'completed',
+    description: '适合把财政、土地与地方治理如何互相牵引一次性理顺。',
+    tags: ['财政', '中国', '社会观察'],
+    cover: '/review-covers/placed-within.svg',
+    link_url: '/articles/playwright-regression-workflow',
+  },
+  {
+    title: '《宇宙探索编辑部》',
+    review_type: 'movie',
+    rating: 4,
+    review_date: '2026-01-12',
+    status: 'in-progress',
+    description: '荒诞感和理想主义都很讨喜，适合放进终端风格站点做海报实验。',
+    tags: ['电影', '公路片', '荒诞'],
+    cover: '/review-covers/journey-to-the-west-editorial.svg',
+    link_url: '',
+  },
+]
+
+const friendLinkCatalog = [
+  {
+    site_name: 'InitCool Docs',
+    site_url: 'https://docs.init.cool',
+    description: '收纳部署、值班与研发工具链的工程手册站。',
+    category: 'tech',
+    status: 'approved',
+  },
+  {
+    site_name: 'Svelte Terminal Lab',
+    site_url: 'https://svelte-terminal.example',
+    description: '记录 Svelte、Astro 与终端式交互实验。',
+    category: 'design',
+    status: 'approved',
+  },
+  {
+    site_name: 'Pending Link Review',
+    site_url: 'https://pending-link.example',
+    description: '待后台审核的新友链申请。',
+    category: 'other',
+    status: 'pending',
+  },
+]
+
+const mediaCatalog = [
+  {
+    key: 'covers/the-long-season.svg',
+    title: '漫长的季节封面',
+    alt_text: '终端风格的蓝色封面海报',
+    caption: '首页推荐位封面',
+    tags: ['cover', 'anime'],
+    notes: '默认 mock 素材库',
+    size_bytes: 1824,
+  },
+  {
+    key: 'posts/playwright-workflow.svg',
+    title: 'Playwright 工作流配图',
+    alt_text: '回归测试流程图',
+    caption: 'CI 与 smoke server 关系图',
+    tags: ['diagram', 'playwright'],
+    notes: '用于文章配图',
+    size_bytes: 2048,
+  },
+]
+
+function createSiteSettings() {
+  return {
+    id: 1,
+    site_name: 'InitCool',
+    site_short_name: 'Termi',
+    site_url: FRONTEND_ORIGIN,
+    site_title: 'InitCool - 终端风格的内容平台',
+    site_description: '一个基于终端美学的个人内容站，记录代码、设计和生活。',
+    hero_title: '欢迎来到我的极客终端博客',
+    hero_subtitle: '这里记录技术、代码和内容运营的持续迭代。',
+    owner_name: 'InitCool',
+    owner_title: 'Rust / Go / Frontend Builder',
+    owner_bio: '偏好用最小系统把内容、测试、值班和自动化串起来。',
+    owner_avatar_url: null,
+    social_github: 'https://github.com/initcool',
+    social_twitter: '',
+    social_email: 'mailto:initcool@example.com',
+    location: 'Hong Kong',
+    tech_stack: ['Astro', 'Svelte', 'React', 'Rust', 'Playwright', 'Docker'],
+    music_playlist: [
+      {
+        title: '山中来信',
+        artist: 'InitCool Radio',
+        album: '站点默认歌单',
+        url: 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3',
+        cover_image_url: `${MOCK_ORIGIN}/media-files/playlist-1.svg`,
+        accent_color: '#2f6b5f',
+        description: '适合文章阅读时循环播放的轻氛围曲。',
+      },
+    ],
+    ai_enabled: true,
+    paragraph_comments_enabled: true,
+    comment_verification_mode: 'captcha',
+    comment_turnstile_enabled: false,
+    subscription_verification_mode: 'off',
+    subscription_turnstile_enabled: false,
+    web_push_enabled: false,
+    turnstile_site_key: null,
+    turnstile_secret_key: null,
+    web_push_vapid_public_key: null,
+    web_push_vapid_private_key: null,
+    web_push_vapid_subject: null,
+    ai_provider: 'mock-openai',
+    ai_api_base: 'https://api.mock.invalid/v1',
+    ai_api_key: 'mock-key',
+    ai_chat_model: 'gpt-mock-4.1',
+    ai_image_provider: 'mock-images',
+    ai_image_api_base: 'https://images.mock.invalid/v1',
+    ai_image_api_key: 'mock-image-key',
+    ai_image_model: 'mock-image-1',
+    ai_providers: [
+      {
+        id: 'default',
+        name: 'Mock Provider',
+        provider: 'openai',
+        api_base: 'https://api.mock.invalid/v1',
+        api_key: 'mock-key',
+        chat_model: 'gpt-mock-4.1',
+        image_model: 'mock-image-1',
+      },
+    ],
+    ai_active_provider_id: 'default',
+    ai_embedding_model: 'text-embedding-mock-3',
+    ai_system_prompt: '你是 Termi 的 mock AI 助手。',
+    ai_top_k: 6,
+    ai_chunk_size: 800,
+    ai_last_indexed_at: iso(-90),
+    ai_chunks_count: 128,
+    ai_local_embedding: 'disabled',
+    media_storage_provider: 'mock-r2',
+    media_r2_account_id: 'mock-account',
+    media_r2_bucket: 'termi-playwright',
+    media_r2_public_base_url: `${MOCK_ORIGIN}/media`,
+    media_r2_access_key_id: 'mock-access-key',
+    media_r2_secret_access_key: 'mock-secret',
+    seo_default_og_image: `${MOCK_ORIGIN}/media-files/default-og.svg`,
+    seo_default_twitter_handle: '@initcool',
+    notification_webhook_url: 'https://notify.mock.invalid/termi',
+    notification_channel_type: 'webhook',
+    notification_comment_enabled: true,
+    notification_friend_link_enabled: true,
+    subscription_popup_enabled: true,
+    subscription_popup_title: '订阅更新',
+    subscription_popup_description: '有新文章、周报和友链通知时，通过邮件第一时间收到提醒。',
+    subscription_popup_delay_seconds: 2,
+    search_synonyms: ['playwright,e2e,regression', 'ai,ask,assistant'],
+  }
+}
+
+function parseHeadingAndDescription(markdown, fallbackTitle = 'Untitled') {
+  const normalized = String(markdown || '').replace(/\r\n/g, '\n').trim()
+  const titleMatch = normalized.match(/^#\s+(.+)$/m)
+  const bodyText = normalized
+    .replace(/^#\s+.+\n+/, '')
+    .split(/\n{2,}/)
+    .map((item) => item.trim())
+    .find(Boolean)
+
+  return {
+    title: normalizeText(titleMatch?.[1] || fallbackTitle) || fallbackTitle,
+    description: normalizeText(bodyText || ''),
+  }
+}
+
+function makePostRecord(entry, id) {
+  const markdown = buildMarkdown(entry.title, entry.paragraphs)
+  const { title, description } = parseHeadingAndDescription(markdown, entry.title)
+  return {
+    id,
+    title,
+    slug: entry.slug,
+    description,
+    content: markdown,
+    category: entry.category,
+    tags: [...entry.tags],
+    post_type: entry.post_type,
+    image: entry.image || null,
+    images: entry.images?.length ? [...entry.images] : [],
+    pinned: Boolean(entry.pinned),
+    status: entry.status || 'published',
+    visibility: entry.visibility || 'public',
+    publish_at: entry.publish_at || null,
+    unpublish_at: entry.unpublish_at || null,
+    canonical_url: null,
+    noindex: false,
+    og_image: null,
+    redirect_from: [],
+    redirect_to: null,
+    created_at: entry.created_at || NOW_ISO,
+    updated_at: entry.updated_at || entry.created_at || NOW_ISO,
+  }
+}
+
+function buildReviewRecord(entry, id) {
+  return {
+    id,
+    title: entry.title,
+    review_type: entry.review_type,
+    rating: entry.rating,
+    review_date: entry.review_date,
+    status: entry.status,
+    description: entry.description,
+    tags: JSON.stringify(entry.tags || []),
+    cover: entry.cover || '',
+    link_url: entry.link_url || null,
+    created_at: iso(-id * 15),
+    updated_at: iso(-id * 10),
+  }
+}
+
+function createSubscriptionRecord(id, overrides = {}) {
+  return {
+    created_at: iso(-id * 6),
+    updated_at: iso(-id * 5),
+    id,
+    channel_type: 'email',
+    target: `user${id}@example.com`,
+    display_name: `订阅用户 ${id}`,
+    status: 'active',
+    filters: {
+      event_types: ['post.published', 'digest.weekly'],
+      categories: ['前端工程'],
+      tags: ['Playwright'],
+    },
+    metadata: {
+      source: 'seed',
+    },
+    secret: null,
+    notes: 'seed subscription',
+    confirm_token: `confirm-token-${id}`,
+    manage_token: `manage-token-${id}`,
+    verified_at: iso(-id * 4),
+    last_notified_at: iso(-id * 2),
+    failure_count: 0,
+    last_delivery_status: 'delivered',
+    ...overrides,
+  }
+}
+
+function createMediaRecord(item, index) {
+  const url = `${MOCK_ORIGIN}/media/${encodeURIComponent(item.key)}`
+  return {
+    key: item.key,
+    url,
+    size_bytes: item.size_bytes,
+    last_modified: iso(-index * 7),
+    title: item.title,
+    alt_text: item.alt_text,
+    caption: item.caption,
+    tags: [...item.tags],
+    notes: item.notes,
+    body: `mock media body for ${item.key}`,
+    content_type: item.key.endsWith('.svg') ? CONTENT_TYPES.svg : CONTENT_TYPES.text,
+  }
+}
+
+function createInitialState() {
+  const site_settings = createSiteSettings()
+  const categories = categoryCatalog.map((item, index) => ({
+    id: index + 1,
+    name: item.name,
+    slug: item.slug,
+    count: 0,
+    description: item.description,
+    cover_image: item.cover_image,
+    accent_color: item.accent_color,
+    seo_title: item.seo_title,
+    seo_description: item.seo_description,
+    created_at: iso(-(index + 1) * 20),
+    updated_at: iso(-(index + 1) * 10),
+  }))
+  const tags = tagCatalog.map((item, index) => ({
+    id: index + 1,
+    name: item.name,
+    slug: item.slug,
+    count: 0,
+    description: item.description,
+    cover_image: item.cover_image,
+    accent_color: item.accent_color,
+    seo_title: item.seo_title,
+    seo_description: item.seo_description,
+    created_at: iso(-(index + 1) * 18),
+    updated_at: iso(-(index + 1) * 8),
+  }))
+  const posts = postCatalog.map((item, index) => makePostRecord(item, index + 1))
+  const reviews = reviewCatalog.map((item, index) => buildReviewRecord(item, index + 1))
+  const friend_links = friendLinkCatalog.map((item, index) => ({
+    id: index + 1,
+    site_name: item.site_name,
+    site_url: item.site_url,
+    avatar_url: null,
+    description: item.description,
+    category: item.category,
+    status: item.status,
+    created_at: iso(-(index + 1) * 12),
+    updated_at: iso(-(index + 1) * 6),
+  }))
+  const subscriptions = [
+    createSubscriptionRecord(1, {
+      target: 'watcher@example.com',
+      display_name: '产品订阅',
+      filters: {
+        event_types: ['post.published', 'digest.weekly'],
+        categories: ['测试体系'],
+        tags: ['Playwright', 'CI'],
+      },
+    }),
+    createSubscriptionRecord(2, {
+      target: 'ops@example.com',
+      display_name: '值班通知',
+      filters: {
+        event_types: ['digest.monthly', 'friend_link.created'],
+        categories: ['运维值班'],
+        tags: ['Docker'],
+      },
+    }),
+  ]
+  const media = mediaCatalog.map((item, index) => createMediaRecord(item, index + 1))
+  const articlePost = posts.find((item) => item.slug === 'astro-terminal-blog') || posts[0]
+  const paragraph = extractParagraphDescriptors(articlePost.content)[0]
+  const comments = [
+    {
+      id: 1,
+      post_id: String(articlePost.id),
+      post_slug: articlePost.slug,
+      author: 'Alice',
+      email: 'alice@example.com',
+      avatar: null,
+      ip_address: '10.0.0.8',
+      user_agent: 'MockBrowser/1.0',
+      referer: `${FRONTEND_ORIGIN}/articles/${articlePost.slug}`,
+      content: '首页筛选和终端风格结合得很好，想看更多实现细节。',
+      reply_to: null,
+      reply_to_comment_id: null,
+      scope: 'article',
+      paragraph_key: null,
+      paragraph_excerpt: null,
+      approved: true,
+      created_at: iso(-40),
+      updated_at: iso(-40),
+    },
+    {
+      id: 2,
+      post_id: String(articlePost.id),
+      post_slug: articlePost.slug,
+      author: 'Bob',
+      email: 'bob@example.com',
+      avatar: null,
+      ip_address: '10.0.0.9',
+      user_agent: 'MockBrowser/1.0',
+      referer: `${FRONTEND_ORIGIN}/articles/${articlePost.slug}`,
+      content: '这里的 URL 同步策略很实用。',
+      reply_to: null,
+      reply_to_comment_id: null,
+      scope: 'paragraph',
+      paragraph_key: paragraph?.key || null,
+      paragraph_excerpt: paragraph?.excerpt || null,
+      approved: true,
+      created_at: iso(-35),
+      updated_at: iso(-35),
+    },
+    {
+      id: 3,
+      post_id: String(articlePost.id),
+      post_slug: articlePost.slug,
+      author: 'Carol',
+      email: 'carol@example.com',
+      avatar: null,
+      ip_address: '10.0.0.10',
+      user_agent: 'MockBrowser/1.0',
+      referer: `${FRONTEND_ORIGIN}/articles/${articlePost.slug}`,
+      content: '这条评论默认待审核，用来验证后台审核流程。',
+      reply_to: null,
+      reply_to_comment_id: null,
+      scope: 'article',
+      paragraph_key: null,
+      paragraph_excerpt: null,
+      approved: false,
+      created_at: iso(-25),
+      updated_at: iso(-25),
+    },
+  ]
+
+  return {
+    site_settings,
+    categories,
+    tags,
+    posts,
+    reviews,
+    friend_links,
+    subscriptions,
+    media,
+    comments,
+    audit_logs: [],
+    post_revisions: [],
+    comment_blacklist: [
+      {
+        id: 1,
+        matcher_type: 'email',
+        matcher_value: 'blocked@example.com',
+        reason: 'seed rule',
+        active: true,
+        expires_at: null,
+        created_at: iso(-12),
+        updated_at: iso(-12),
+        effective: true,
+      },
+    ],
+    comment_persona_logs: [],
+    deliveries: [],
+    ai_events: [],
+    content_events: [],
+    captcha_tokens: new Map(),
+    next_ids: {
+      post: posts.length + 1,
+      category: categories.length + 1,
+      tag: tags.length + 1,
+      comment: comments.length + 1,
+      friend_link: friend_links.length + 1,
+      review: reviews.length + 1,
+      subscription: subscriptions.length + 1,
+      audit: 1,
+      revision: 1,
+      delivery: 1,
+      blacklist: 2,
+      persona_log: 1,
+      ai_event: 1,
+    },
+  }
+}
+
+let state = createInitialState()
+
+function nextId(bucket) {
+  const value = state.next_ids[bucket]
+  state.next_ids[bucket] += 1
+  return value
+}
+
+function isPostVisible(post, options = {}) {
+  const includePrivate = toBoolean(options.include_private, false)
+  const preview = toBoolean(options.preview, false)
+  const includeRedirects = toBoolean(options.include_redirects, false)
+  const now = BASE_TS
+
+  if (!post) return false
+  if (!includeRedirects && post.redirect_to) return false
+  if (preview) return true
+  if (post.status !== 'published') return false
+  if (post.visibility === 'private' && !includePrivate) return false
+  if (post.visibility === 'private') return false
+  if (post.publish_at && Date.parse(post.publish_at) > now) return false
+  if (post.unpublish_at && Date.parse(post.unpublish_at) <= now) return false
+  return true
+}
+
+function recalculateTaxonomyCounts() {
+  const categoryCounts = new Map()
+  const tagCounts = new Map()
+
+  for (const post of state.posts.filter((item) => isPostVisible(item))) {
+    if (post.category) {
+      categoryCounts.set(post.category, (categoryCounts.get(post.category) || 0) + 1)
+    }
+    for (const tag of post.tags || []) {
+      tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1)
+    }
+  }
+
+  for (const category of state.categories) {
+    category.count = categoryCounts.get(category.name) || 0
+  }
+  for (const tag of state.tags) {
+    tag.count = tagCounts.get(tag.name) || 0
+  }
+}
+
+function addAuditLog(action, target_type, target_label, target_id = null, metadata = null) {
+  state.audit_logs.unshift({
+    id: nextId('audit'),
+    created_at: iso(-1),
+    updated_at: iso(-1),
+    actor_username: VALID_LOGIN.username,
+    actor_email: 'admin@termi.test',
+    actor_source: 'mock-admin',
+    action,
+    target_type,
+    target_id: target_id === null ? null : String(target_id),
+    target_label: target_label || null,
+    metadata,
+  })
+}
+
+function addPostRevision(post, operation = 'update', reason = null) {
+  state.post_revisions.unshift({
+    id: nextId('revision'),
+    post_slug: post.slug,
+    post_title: post.title,
+    operation,
+    revision_reason: reason,
+    actor_username: VALID_LOGIN.username,
+    actor_email: 'admin@termi.test',
+    actor_source: 'mock-admin',
+    created_at: iso(-1),
+    has_markdown: true,
+    metadata: { category: post.category, tags: post.tags, status: post.status },
+    markdown: post.content,
+    snapshot: clone(post),
+  })
+}
+
+function createNotificationDelivery({
+  subscription,
+  eventType,
+  status = 'queued',
+  responseText = 'queued by mock server',
+  payload = null,
+}) {
+  return {
+    created_at: iso(-1),
+    updated_at: iso(-1),
+    id: nextId('delivery'),
+    subscription_id: subscription?.id ?? null,
+    channel_type: subscription?.channel_type ?? 'email',
+    target: subscription?.target ?? 'unknown@example.com',
+    event_type: eventType,
+    status,
+    provider: 'mock-delivery',
+    response_text: responseText,
+    payload,
+    attempts_count: status === 'queued' ? 0 : 1,
+    next_retry_at: status === 'retry_pending' ? iso(10) : null,
+    last_attempt_at: status === 'queued' ? null : iso(-1),
+    delivered_at: status === 'sent' ? iso(-1) : null,
+  }
+}
+
+function sanitizeFilename(value, fallback = 'upload.bin') {
+  const normalized = String(value || '').split(/[\\/]/).pop() || fallback
+  return normalized.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || fallback
+}
+
+function makeMediaRecordFromUpload(key, file) {
+  return {
+    key,
+    url: `${MOCK_ORIGIN}/media/${encodeURIComponent(key)}`,
+    size_bytes: file?.size ?? Buffer.byteLength(file?.body || ''),
+    last_modified: iso(-1),
+    title: sanitizeFilename(file?.filename || key),
+    alt_text: null,
+    caption: null,
+    tags: [],
+    notes: 'uploaded by playwright mock',
+    body: file?.body?.toString('utf8') || `mock media body for ${key}`,
+    content_type: String(file?.contentType || '').includes('svg')
+      ? CONTENT_TYPES.svg
+      : String(file?.contentType || '').includes('image/')
+        ? String(file.contentType)
+        : CONTENT_TYPES.text,
+  }
+}
+
+function upsertPostFromPayload(current, payload) {
+  const next = current ? { ...current } : {}
+  const title = normalizeText(payload.title) || normalizeText(current?.title) || '未命名文章'
+  const slug = normalizeText(payload.slug) || normalizeText(current?.slug) || slugify(title)
+  const content = payload.content ?? current?.content ?? buildMarkdown(title, ['待补充内容。'])
+  const parsed = parseHeadingAndDescription(content, title)
+
+  next.title = title || parsed.title
+  next.slug = slug
+  next.description = normalizeText(payload.description) || parsed.description || current?.description || ''
+  next.content = content
+  next.category = normalizeText(payload.category) || null
+  next.tags = Array.isArray(payload.tags) ? payload.tags.filter(Boolean) : current?.tags || []
+  next.post_type = normalizeText(payload.post_type || payload.postType) || current?.post_type || 'article'
+  next.image = normalizeText(payload.image) || null
+  next.images = Array.isArray(payload.images) ? payload.images.filter(Boolean) : current?.images || []
+  next.pinned = Object.hasOwn(payload, 'pinned') ? Boolean(payload.pinned) : Boolean(current?.pinned)
+  next.status =
+    normalizeText(payload.status) ||
+    (Object.hasOwn(payload, 'published') ? (payload.published ? 'published' : 'draft') : '') ||
+    current?.status ||
+    'draft'
+  next.visibility = normalizeText(payload.visibility) || current?.visibility || 'public'
+  next.publish_at = normalizeText(payload.publish_at || payload.publishAt) || null
+  next.unpublish_at = normalizeText(payload.unpublish_at || payload.unpublishAt) || null
+  next.canonical_url = normalizeText(payload.canonical_url || payload.canonicalUrl) || null
+  next.noindex = Object.hasOwn(payload, 'noindex') ? Boolean(payload.noindex) : Boolean(current?.noindex)
+  next.og_image = normalizeText(payload.og_image || payload.ogImage) || null
+  next.redirect_from = Array.isArray(payload.redirect_from || payload.redirectFrom)
+    ? (payload.redirect_from || payload.redirectFrom).filter(Boolean)
+    : current?.redirect_from || []
+  next.redirect_to = normalizeText(payload.redirect_to || payload.redirectTo) || null
+  next.created_at = current?.created_at || iso(-1)
+  next.updated_at = iso(-1)
+
+  return next
+}
+
+function makeTaxonomyRecord(bucket, payload, current = null) {
+  return {
+    id: current?.id ?? nextId(bucket),
+    name: normalizeText(payload.name) || current?.name || '',
+    slug: normalizeText(payload.slug) || slugify(payload.name || current?.name || ''),
+    count: current?.count ?? 0,
+    description: normalizeText(payload.description) || null,
+    cover_image: normalizeText(payload.cover_image || payload.coverImage) || null,
+    accent_color: normalizeText(payload.accent_color || payload.accentColor) || null,
+    seo_title: normalizeText(payload.seo_title || payload.seoTitle) || null,
+    seo_description: normalizeText(payload.seo_description || payload.seoDescription) || null,
+    created_at: current?.created_at || iso(-1),
+    updated_at: iso(-1),
+  }
+}
+
+function findRevisionById(id) {
+  return state.post_revisions.find((item) => item.id === id) || null
+}
+
+function resetState() {
+  state = createInitialState()
+  recalculateTaxonomyCounts()
+  addAuditLog('seed.bootstrap', 'workspace', 'playwright-smoke', 'seed', {
+    posts: state.posts.length,
+    reviews: state.reviews.length,
+  })
+  for (const post of state.posts.slice().reverse()) {
+    addPostRevision(post, 'seed', '初始 mock 数据')
+  }
+}
+
+resetState()
+
+function normalizePostResponse(post) {
+  return {
+    created_at: post.created_at,
+    updated_at: post.updated_at,
+    id: post.id,
+    title: post.title,
+    slug: post.slug,
+    description: post.description,
+    content: post.content,
+    category: post.category,
+    tags: [...(post.tags || [])],
+    post_type: post.post_type,
+    image: post.image,
+    images: [...(post.images || [])],
+    pinned: post.pinned,
+    status: post.status,
+    visibility: post.visibility,
+    publish_at: post.publish_at,
+    unpublish_at: post.unpublish_at,
+    canonical_url: post.canonical_url,
+    noindex: post.noindex,
+    og_image: post.og_image,
+    redirect_from: [...(post.redirect_from || [])],
+    redirect_to: post.redirect_to,
+  }
+}
+
+function sortItems(items, sortBy = 'created_at', sortOrder = 'desc') {
+  const direction = String(sortOrder || 'desc').toLowerCase() === 'asc' ? 1 : -1
+  const key = sortBy || 'created_at'
+
+  return [...items].sort((left, right) => {
+    const leftValue = left[key] ?? ''
+    const rightValue = right[key] ?? ''
+    if (leftValue < rightValue) return -1 * direction
+    if (leftValue > rightValue) return 1 * direction
+    return (right.id || 0) - (left.id || 0)
+  })
+}
+
+function filterPostsForQuery(items, searchParams) {
+  const slug = normalizeText(searchParams.get('slug'))
+  const category = normalizeText(searchParams.get('category'))
+  const tag = normalizeText(searchParams.get('tag'))
+  const search = normalizeText(searchParams.get('search'))
+  const postType = normalizeText(searchParams.get('type'))
+  const status = normalizeText(searchParams.get('status'))
+  const visibility = normalizeText(searchParams.get('visibility'))
+  const pinned = searchParams.get('pinned')
+
+  return items.filter((post) => {
+    if (slug && post.slug !== slug) return false
+    if (category && normalizeText(post.category).toLowerCase() !== category.toLowerCase()) return false
+    if (tag && !(post.tags || []).some((item) => normalizeText(item).toLowerCase() === tag.toLowerCase())) {
+      return false
+    }
+    if (postType && normalizeText(post.post_type).toLowerCase() !== postType.toLowerCase()) return false
+    if (status && normalizeText(post.status).toLowerCase() !== status.toLowerCase()) return false
+    if (visibility && normalizeText(post.visibility).toLowerCase() !== visibility.toLowerCase()) return false
+    if (pinned !== null && String(post.pinned) !== pinned) return false
+    if (!search) return true
+
+    const haystack = [
+      post.title,
+      post.slug,
+      post.description,
+      post.content,
+      post.category,
+      ...(post.tags || []),
+    ]
+      .filter(Boolean)
+      .join('\n')
+      .toLowerCase()
+
+    return haystack.includes(search.toLowerCase())
+  })
+}
+
+function buildPagedResponse(items, searchParams, mapper = (value) => value) {
+  const page = Math.max(1, Number.parseInt(searchParams.get('page') || '1', 10) || 1)
+  const pageSize = Math.max(1, Number.parseInt(searchParams.get('page_size') || '10', 10) || 10)
+  const sortBy = searchParams.get('sort_by') || 'created_at'
+  const sortOrder = searchParams.get('sort_order') || 'desc'
+  const sorted = sortItems(items, sortBy, sortOrder)
+  const total = sorted.length
+  const totalPages = Math.max(1, Math.ceil(total / pageSize))
+  const safePage = Math.min(page, totalPages)
+  const start = (safePage - 1) * pageSize
+
+  return {
+    items: sorted.slice(start, start + pageSize).map(mapper),
+    page: safePage,
+    page_size: pageSize,
+    total,
+    total_pages: totalPages,
+    sort_by: sortBy,
+    sort_order: sortOrder,
+  }
+}
+
+function makeSearchResult(post, rank) {
+  return {
+    id: post.id,
+    title: post.title,
+    slug: post.slug,
+    description: post.description,
+    content: post.content,
+    category: post.category,
+    tags: [...(post.tags || [])],
+    post_type: post.post_type,
+    image: post.image,
+    pinned: post.pinned,
+    created_at: post.created_at,
+    updated_at: post.updated_at,
+    rank,
+  }
+}
+
+function searchPosts(query, filters = {}) {
+  const normalizedQuery = normalizeText(query).toLowerCase()
+  let items = state.posts.filter((post) => isPostVisible(post))
+  if (filters.category) {
+    items = items.filter((post) => normalizeText(post.category).toLowerCase() === normalizeText(filters.category).toLowerCase())
+  }
+  if (filters.tag) {
+    items = items.filter((post) =>
+      (post.tags || []).some((item) => normalizeText(item).toLowerCase() === normalizeText(filters.tag).toLowerCase()),
+    )
+  }
+  if (filters.type) {
+    items = items.filter((post) => normalizeText(post.post_type).toLowerCase() === normalizeText(filters.type).toLowerCase())
+  }
+
+  return items
+    .map((post) => {
+      const haystack = [post.title, post.description, post.content, post.category, ...(post.tags || [])]
+        .filter(Boolean)
+        .join('\n')
+        .toLowerCase()
+      let score = 0
+      if (normalizedQuery && haystack.includes(normalizedQuery)) score += 20
+      if (post.title.toLowerCase().includes(normalizedQuery)) score += 30
+      if ((post.tags || []).some((tag) => tag.toLowerCase().includes(normalizedQuery))) score += 10
+      if (post.pinned) score += 5
+      return { post, score }
+    })
+    .filter((item) => item.score > 0)
+    .sort((left, right) => right.score - left.score || right.post.id - left.post.id)
+    .map((item) => makeSearchResult(item.post, item.score))
+}
+
+function issueCaptcha() {
+  const token = randomUUID()
+  state.captcha_tokens.set(token, { answer: '7', question: '3 + 4 = ?' })
+  return { token, question: '3 + 4 = ?', expires_in_seconds: 300 }
+}
+
+function verifyCaptcha(token, answer) {
+  const challenge = state.captcha_tokens.get(String(token || ''))
+  return Boolean(challenge) && normalizeText(answer) === String(challenge.answer)
+}
+
+function getCommentMatcherValue(comment, matcherType) {
+  if (matcherType === 'email') return normalizeText(comment.email).toLowerCase()
+  if (matcherType === 'user_agent') return normalizeText(comment.user_agent).toLowerCase()
+  return normalizeText(comment.ip_address).toLowerCase()
+}
+
+function isBlacklistedComment(comment) {
+  return state.comment_blacklist.some((item) => {
+    if (!item.active) return false
+    return getCommentMatcherValue(comment, item.matcher_type) === normalizeText(item.matcher_value).toLowerCase()
+  })
+}
+
+function createMockImageSvg(label, accent = '#14b8a6') {
+  const safeLabel = String(label || 'mock asset')
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="675" viewBox="0 0 1200 675"><defs><linearGradient id="bg" x1="0" x2="1" y1="0" y2="1"><stop offset="0%" stop-color="#0f172a"/><stop offset="100%" stop-color="${accent}"/></linearGradient></defs><rect width="1200" height="675" fill="url(#bg)"/><text x="80" y="180" fill="#e2e8f0" font-family="monospace" font-size="44">${safeLabel}</text><text x="80" y="585" fill="#cbd5e1" font-family="monospace" font-size="24">playwright mock asset</text></svg>`
+}
+
+function sendSvg(res, label, accent) {
+  text(res, 200, createMockImageSvg(label, accent), {
+    'content-type': CONTENT_TYPES.svg,
+    'cache-control': 'public, max-age=60',
+  })
+}
+
+function writeEmpty(res, status = 204, headers = {}) {
+  res.writeHead(status, headers)
+  res.end()
+}
+
+function notFound(res, message = 'not found') {
+  json(res, 404, { error: 'not_found', description: message })
+}
+
+function badRequest(res, message) {
+  json(res, 400, { error: 'bad_request', description: message })
+}
+
+function latestDebugState() {
+  return {
+    site_settings: clone(state.site_settings),
+    categories: state.categories.map((item) => clone(item)),
+    tags: state.tags.map((item) => clone(item)),
+    posts: state.posts.map((item) => ({
+      id: item.id,
+      slug: item.slug,
+      title: item.title,
+      category: item.category,
+      tags: [...(item.tags || [])],
+      status: item.status,
+      visibility: item.visibility,
+      content: item.content,
+      updated_at: item.updated_at,
+    })),
+    reviews: state.reviews.map((item) => clone(item)),
+    subscriptions: state.subscriptions.map((item) => ({
+      id: item.id,
+      target: item.target,
+      display_name: item.display_name,
+      channel_type: item.channel_type,
+      confirm_token: item.confirm_token,
+      manage_token: item.manage_token,
+      status: item.status,
+      filters: clone(item.filters),
+    })),
+    deliveries: state.deliveries.map((item) => clone(item)),
+    media: state.media.map((item) => ({
+      key: item.key,
+      title: item.title,
+      alt_text: item.alt_text,
+      tags: [...item.tags],
+      url: item.url,
+      size_bytes: item.size_bytes,
+    })),
+    friend_links: state.friend_links.map((item) => ({
+      id: item.id,
+      site_name: item.site_name,
+      status: item.status,
+    })),
+    comments: state.comments.map((item) => ({
+      id: item.id,
+      post_slug: item.post_slug,
+      scope: item.scope,
+      approved: item.approved,
+      author: item.author,
+    })),
+    comment_blacklist: state.comment_blacklist.map((item) => clone(item)),
+    post_revisions: state.post_revisions.map((item) => ({
+      id: item.id,
+      post_slug: item.post_slug,
+      operation: item.operation,
+      revision_reason: item.revision_reason,
+      created_at: item.created_at,
+    })),
+    audit_logs: state.audit_logs.map((item) => clone(item)),
+  }
+}
+
+function getHomePayload() {
+  const visiblePosts = state.posts.filter((post) => isPostVisible(post))
+  const content_ranges = [
+    {
+      key: '24h',
+      label: '24h',
+      days: 1,
+      overview: { page_views: 18, read_completes: 4, avg_read_progress: 61, avg_read_duration_ms: 42000 },
+      popular_posts: [
+        {
+          slug: 'astro-terminal-blog',
+          title: 'Astro 终端博客信息架构实战',
+          page_views: 12,
+          read_completes: 3,
+          avg_progress_percent: 76,
+          avg_duration_ms: 51000,
+        },
+      ],
+    },
+    {
+      key: '7d',
+      label: '7d',
+      days: 7,
+      overview: { page_views: 142, read_completes: 57, avg_read_progress: 74, avg_read_duration_ms: 58400 },
+      popular_posts: [
+        {
+          slug: 'playwright-regression-workflow',
+          title: 'Playwright 回归工作流设计',
+          page_views: 48,
+          read_completes: 25,
+          avg_progress_percent: 83,
+          avg_duration_ms: 61000,
+        },
+        {
+          slug: 'astro-terminal-blog',
+          title: 'Astro 终端博客信息架构实战',
+          page_views: 38,
+          read_completes: 18,
+          avg_progress_percent: 71,
+          avg_duration_ms: 54000,
+        },
+      ],
+    },
+    {
+      key: '30d',
+      label: '30d',
+      days: 30,
+      overview: { page_views: 580, read_completes: 223, avg_read_progress: 69, avg_read_duration_ms: 50000 },
+      popular_posts: [
+        {
+          slug: 'playwright-regression-workflow',
+          title: 'Playwright 回归工作流设计',
+          page_views: 152,
+          read_completes: 79,
+          avg_progress_percent: 81,
+          avg_duration_ms: 63000,
+        },
+        {
+          slug: 'docker-rollout-checklist',
+          title: 'Docker 发布值班清单',
+          page_views: 118,
+          read_completes: 42,
+          avg_progress_percent: 64,
+          avg_duration_ms: 47000,
+        },
+      ],
+    },
+  ]
+
+  return {
+    site_settings: clone(state.site_settings),
+    posts: visiblePosts.map(normalizePostResponse),
+    tags: state.tags.map((item) => clone(item)),
+    friend_links: state.friend_links.map((item) => clone(item)),
+    categories: state.categories.map((item) => clone(item)),
+    content_overview: {
+      total_page_views: 1642,
+      page_views_last_24h: 18,
+      page_views_last_7d: 142,
+      total_read_completes: 628,
+      read_completes_last_7d: 57,
+      avg_read_progress_last_7d: 74,
+      avg_read_duration_ms_last_7d: 58400,
+    },
+    popular_posts: content_ranges[1].popular_posts,
+    content_ranges,
+  }
+}
+
+const server = createServer(async (req, res) => {
+  reflectCors(req, res)
+
+  if (req.method === 'OPTIONS') {
+    writeEmpty(res, 204)
+    return
+  }
+
+  const url = new URL(req.url || '/', MOCK_ORIGIN)
+  const { pathname, searchParams } = url
+
+  if (pathname === '/__playwright/health') {
+    json(res, 200, { ok: true })
+    return
+  }
+
+  if (pathname === '/__playwright/reset' && req.method === 'POST') {
+    resetState()
+    json(res, 200, { ok: true })
+    return
+  }
+
+  if (pathname === '/__playwright/state') {
+    json(res, 200, latestDebugState())
+    return
+  }
+
+  if (pathname.startsWith('/media-files/') || pathname.startsWith('/review-covers/') || pathname.startsWith('/generated/')) {
+    sendSvg(res, pathname.split('/').pop()?.replace(/\.(svg|png|jpg|jpeg)$/i, '') || 'asset')
+    return
+  }
+
+  if (pathname.startsWith('/media/')) {
+    const key = decodeURIComponent(pathname.replace('/media/', ''))
+    const media = state.media.find((item) => item.key === key)
+    if (!media) {
+      notFound(res, '媒体不存在。')
+      return
+    }
+    if (media.content_type === CONTENT_TYPES.svg) {
+      sendSvg(res, media.title || media.key, '#8b5cf6')
+      return
+    }
+    text(res, 200, media.body, { 'content-type': media.content_type })
+    return
+  }
+
+  if (pathname === '/api/admin/session' && req.method === 'GET') {
+    json(res, 200, createSessionResponse(isAuthenticated(req)))
+    return
+  }
+
+  if (pathname === '/api/admin/session/login' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    if (
+      normalizeText(payload.username) !== VALID_LOGIN.username ||
+      normalizeText(payload.password) !== VALID_LOGIN.password
+    ) {
+      badRequest(res, '用户名或密码错误。')
+      return
+    }
+    json(res, 200, createSessionResponse(true), {
+      'set-cookie': `${SESSION_COOKIE}=${SESSION_VALUE}; Path=/; HttpOnly; SameSite=Lax`,
+    })
+    return
+  }
+
+  if (pathname === '/api/admin/session' && req.method === 'DELETE') {
+    json(res, 200, createSessionResponse(false), {
+      'set-cookie': `${SESSION_COOKIE}=; Path=/; Max-Age=0; HttpOnly; SameSite=Lax`,
+    })
+    return
+  }
+
+  if (pathname === '/api/site_settings' && req.method === 'GET') {
+    json(res, 200, clone(state.site_settings))
+    return
+  }
+
+  if (pathname === '/api/site_settings/home' && req.method === 'GET') {
+    json(res, 200, getHomePayload())
+    return
+  }
+
+  if (pathname === '/api/categories' && req.method === 'GET') {
+    json(res, 200, state.categories.map((item) => clone(item)))
+    return
+  }
+
+  if (pathname === '/api/tags' && req.method === 'GET') {
+    json(res, 200, state.tags.map((item) => clone(item)))
+    return
+  }
+
+  if (pathname === '/api/reviews' && req.method === 'GET') {
+    json(res, 200, state.reviews.map((item) => clone(item)))
+    return
+  }
+
+  if (pathname === '/api/reviews' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const title = normalizeText(payload.title)
+    if (!title) {
+      badRequest(res, '评测标题不能为空。')
+      return
+    }
+
+    const record = {
+      id: nextId('review'),
+      title,
+      review_type: normalizeText(payload.review_type) || 'book',
+      rating: Number(payload.rating) || 4,
+      review_date: normalizeText(payload.review_date) || '2026-04-01',
+      status: normalizeText(payload.status) || 'draft',
+      description: normalizeText(payload.description) || '',
+      tags: JSON.stringify(Array.isArray(payload.tags) ? payload.tags.filter(Boolean) : []),
+      cover: normalizeText(payload.cover) || '',
+      link_url: normalizeText(payload.link_url) || null,
+      created_at: iso(-1),
+      updated_at: iso(-1),
+    }
+
+    state.reviews.unshift(record)
+    addAuditLog('review.create', 'review', record.title, record.id)
+    json(res, 201, clone(record))
+    return
+  }
+
+  if (pathname.match(/^\/api\/reviews\/\d+$/) && req.method === 'GET') {
+    const id = Number(pathname.split('/').pop())
+    const review = state.reviews.find((item) => item.id === id)
+    if (!review) {
+      notFound(res, '评测不存在。')
+      return
+    }
+    json(res, 200, clone(review))
+    return
+  }
+
+  if (pathname.match(/^\/api\/reviews\/\d+$/) && req.method === 'PUT') {
+    const id = Number(pathname.split('/').pop())
+    const record = state.reviews.find((item) => item.id === id)
+    if (!record) {
+      notFound(res, '评测不存在。')
+      return
+    }
+    const { json: payload } = await parseRequest(req)
+    record.title = normalizeText(payload.title) || record.title
+    record.review_type = normalizeText(payload.review_type) || record.review_type
+    record.rating = Number(payload.rating) || record.rating
+    record.review_date = normalizeText(payload.review_date) || record.review_date
+    record.status = normalizeText(payload.status) || record.status
+    record.description = normalizeText(payload.description) || ''
+    record.tags = JSON.stringify(Array.isArray(payload.tags) ? payload.tags.filter(Boolean) : [])
+    record.cover = normalizeText(payload.cover) || ''
+    record.link_url = normalizeText(payload.link_url) || null
+    record.updated_at = iso(-1)
+    addAuditLog('review.update', 'review', record.title, record.id)
+    json(res, 200, clone(record))
+    return
+  }
+
+  if (pathname.match(/^\/api\/reviews\/\d+$/) && req.method === 'DELETE') {
+    const id = Number(pathname.split('/').pop())
+    const index = state.reviews.findIndex((item) => item.id === id)
+    if (index === -1) {
+      notFound(res, '评测不存在。')
+      return
+    }
+    const [removed] = state.reviews.splice(index, 1)
+    addAuditLog('review.delete', 'review', removed.title, removed.id)
+    writeEmpty(res, 204)
+    return
+  }
+
+  if (pathname === '/api/friend_links' && req.method === 'GET') {
+    let items = [...state.friend_links]
+    const status = normalizeText(searchParams.get('status'))
+    const category = normalizeText(searchParams.get('category'))
+    if (status) items = items.filter((item) => normalizeText(item.status).toLowerCase() === status.toLowerCase())
+    if (category) items = items.filter((item) => normalizeText(item.category).toLowerCase() === category.toLowerCase())
+    json(res, 200, items.map((item) => clone(item)))
+    return
+  }
+
+  if (pathname === '/api/friend_links' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const record = {
+      id: nextId('friend_link'),
+      site_name: normalizeText(payload.siteName || payload.site_name),
+      site_url: normalizeText(payload.siteUrl || payload.site_url),
+      avatar_url: null,
+      description: normalizeText(payload.description) || null,
+      category: normalizeText(payload.category) || 'other',
+      status: normalizeText(payload.status) || 'pending',
+      created_at: iso(-1),
+      updated_at: iso(-1),
+    }
+    if (!record.site_name || !record.site_url) {
+      badRequest(res, '站点名称和 URL 不能为空。')
+      return
+    }
+    state.friend_links.unshift(record)
+    addAuditLog('friend_link.create', 'friend_link', record.site_name, record.id, { status: record.status })
+    json(res, 201, clone(record))
+    return
+  }
+
+  if (pathname === '/api/comments/captcha' && req.method === 'GET') {
+    json(res, 200, issueCaptcha())
+    return
+  }
+
+  if (pathname === '/api/comments/paragraphs/summary' && req.method === 'GET') {
+    const postSlug = normalizeText(searchParams.get('post_slug'))
+    const counts = new Map()
+    for (const comment of state.comments) {
+      if (comment.post_slug !== postSlug || comment.scope !== 'paragraph' || !comment.approved) continue
+      if (!comment.paragraph_key) continue
+      counts.set(comment.paragraph_key, (counts.get(comment.paragraph_key) || 0) + 1)
+    }
+    json(res, 200, Array.from(counts.entries()).map(([paragraph_key, count]) => ({ paragraph_key, count })))
+    return
+  }
+
+  if (pathname === '/api/comments' && req.method === 'GET') {
+    let items = [...state.comments]
+    const postSlug = normalizeText(searchParams.get('post_slug'))
+    const scope = normalizeText(searchParams.get('scope'))
+    const paragraphKey = normalizeText(searchParams.get('paragraph_key'))
+    const approved = searchParams.get('approved')
+    if (postSlug) items = items.filter((item) => item.post_slug === postSlug)
+    if (scope) items = items.filter((item) => item.scope === scope)
+    if (paragraphKey) items = items.filter((item) => item.paragraph_key === paragraphKey)
+    if (approved !== null) items = items.filter((item) => String(Boolean(item.approved)) === approved)
+    json(res, 200, items.map((item) => clone(item)))
+    return
+  }
+
+  if (pathname === '/api/comments' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const post = state.posts.find((item) => item.slug === normalizeText(payload.postSlug))
+    if (!post) {
+      notFound(res, '文章不存在。')
+      return
+    }
+    if (state.site_settings.comment_verification_mode === 'captcha' && !verifyCaptcha(payload.captchaToken, payload.captchaAnswer)) {
+      badRequest(res, '验证码错误。')
+      return
+    }
+    const record = {
+      id: nextId('comment'),
+      post_id: String(post.id),
+      post_slug: post.slug,
+      author: normalizeText(payload.nickname) || '匿名访客',
+      email: normalizeText(payload.email) || null,
+      avatar: null,
+      ip_address: '10.0.0.88',
+      user_agent: String(req.headers['user-agent'] || 'Playwright'),
+      referer: String(req.headers.referer || ''),
+      content: normalizeText(payload.content),
+      reply_to: null,
+      reply_to_comment_id: payload.replyToCommentId === null || payload.replyToCommentId === undefined ? null : Number(payload.replyToCommentId),
+      scope: normalizeText(payload.scope) || 'article',
+      paragraph_key: normalizeText(payload.paragraphKey) || null,
+      paragraph_excerpt: normalizeText(payload.paragraphExcerpt) || null,
+      approved: false,
+      created_at: iso(-1),
+      updated_at: iso(-1),
+    }
+    if (!record.content) {
+      badRequest(res, '评论内容不能为空。')
+      return
+    }
+    if (isBlacklistedComment(record)) {
+      json(res, 403, { error: 'comment_blocked', description: '该评论命中了黑名单规则，已被拒绝。' })
+      return
+    }
+    state.comments.unshift(record)
+    addAuditLog('comment.create', 'comment', record.author, record.id, { scope: record.scope, approved: record.approved })
+    json(res, 201, clone(record))
+    return
+  }
+
+  if (pathname === '/api/posts' && req.method === 'GET') {
+    const candidates = state.posts.filter((post) =>
+      isPostVisible(post, {
+        include_private: searchParams.get('include_private'),
+        preview: searchParams.get('preview'),
+        include_redirects: searchParams.get('include_redirects'),
+      }),
+    )
+    const filtered = filterPostsForQuery(candidates, searchParams)
+    json(res, 200, filtered.map(normalizePostResponse))
+    return
+  }
+
+  if (pathname === '/api/posts/page' && req.method === 'GET') {
+    const candidates = state.posts.filter((post) =>
+      isPostVisible(post, {
+        include_private: searchParams.get('include_private'),
+        preview: searchParams.get('preview'),
+        include_redirects: searchParams.get('include_redirects'),
+      }),
+    )
+    const filtered = filterPostsForQuery(candidates, searchParams)
+    json(res, 200, buildPagedResponse(filtered, searchParams, normalizePostResponse))
+    return
+  }
+
+  if (pathname.match(/^\/api\/posts\/\d+$/) && req.method === 'GET') {
+    const id = Number(pathname.split('/').pop())
+    const post = state.posts.find((item) => item.id === id)
+    if (!post || !isPostVisible(post, { preview: true, include_private: true, include_redirects: true })) {
+      notFound(res, '文章不存在。')
+      return
+    }
+    json(res, 200, normalizePostResponse(post))
+    return
+  }
+
+  if (pathname.match(/^\/api\/posts\/slug\/[^/]+$/) && req.method === 'GET') {
+    const slug = decodeURIComponent(pathname.split('/')[4])
+    const post = state.posts.find((item) => item.slug === slug)
+    if (!post || !isPostVisible(post, {
+      include_private: searchParams.get('include_private'),
+      preview: searchParams.get('preview'),
+      include_redirects: searchParams.get('include_redirects'),
+    })) {
+      notFound(res, '文章不存在。')
+      return
+    }
+    json(res, 200, normalizePostResponse(post))
+    return
+  }
+
+  if (pathname === '/api/posts/markdown' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const record = upsertPostFromPayload(
+      {
+        id: nextId('post'),
+        created_at: iso(-1),
+        updated_at: iso(-1),
+      },
+      payload,
+    )
+    if (!record.slug || !record.title) {
+      badRequest(res, '文章标题不能为空。')
+      return
+    }
+
+    state.posts.unshift(record)
+    recalculateTaxonomyCounts()
+    addAuditLog('post.create', 'post', record.title, record.id, { slug: record.slug })
+    addPostRevision(record, 'create', '创建草稿')
+    json(res, 201, {
+      slug: record.slug,
+      path: `content/posts/${record.slug}.md`,
+      markdown: record.content,
+    })
+    return
+  }
+
+  if (pathname === '/api/posts/markdown/import' && req.method === 'POST') {
+    const { files } = await parseRequest(req)
+    const slugs = []
+
+    for (const file of files) {
+      const source = file.body?.toString('utf8') || '# Imported Post\n\nImported by playwright.'
+      const { title, description } = parseHeadingAndDescription(source, sanitizeFilename(file.filename, 'imported'))
+      const slug = slugify(title || sanitizeFilename(file.filename, 'imported'))
+      const record = {
+        id: nextId('post'),
+        title,
+        slug,
+        description,
+        content: source,
+        category: '测试体系',
+        tags: ['Playwright'],
+        post_type: 'article',
+        image: null,
+        images: [],
+        pinned: false,
+        status: 'draft',
+        visibility: 'public',
+        publish_at: null,
+        unpublish_at: null,
+        canonical_url: null,
+        noindex: false,
+        og_image: null,
+        redirect_from: [],
+        redirect_to: null,
+        created_at: iso(-1),
+        updated_at: iso(-1),
+      }
+      state.posts.unshift(record)
+      addPostRevision(record, 'import', `导入 ${file.filename}`)
+      slugs.push(slug)
+    }
+
+    recalculateTaxonomyCounts()
+    addAuditLog('post.import', 'workspace', 'markdown import', String(slugs.length), { slugs })
+    json(res, 200, { count: slugs.length, slugs })
+    return
+  }
+
+  if (pathname.match(/^\/api\/posts\/\d+$/) && req.method === 'PATCH') {
+    const id = Number(pathname.split('/').pop())
+    const record = state.posts.find((item) => item.id === id)
+    if (!record) {
+      notFound(res, '文章不存在。')
+      return
+    }
+    const { json: payload } = await parseRequest(req)
+    const updated = upsertPostFromPayload(record, payload)
+    Object.assign(record, updated)
+    recalculateTaxonomyCounts()
+    addAuditLog('post.update', 'post', record.title, record.id, { slug: record.slug })
+    addPostRevision(record, 'update', '保存文章属性')
+    json(res, 200, normalizePostResponse(record))
+    return
+  }
+
+  if (pathname === '/api/search' && req.method === 'GET') {
+    const q = searchParams.get('q') || ''
+    const limit = Math.max(1, Number.parseInt(searchParams.get('limit') || '20', 10) || 20)
+    json(res, 200, searchPosts(q).slice(0, limit))
+    return
+  }
+
+  if (pathname === '/api/search/page' && req.method === 'GET') {
+    const q = searchParams.get('q') || ''
+    const results = searchPosts(q, {
+      category: searchParams.get('category'),
+      tag: searchParams.get('tag'),
+      type: searchParams.get('type'),
+    })
+    json(res, 200, { query: q, ...buildPagedResponse(results, searchParams) })
+    return
+  }
+
+  if (pathname === '/api/subscriptions' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const id = nextId('subscription')
+    const record = createSubscriptionRecord(id, {
+      target: normalizeText(payload.email) || `subscriber-${id}@example.com`,
+      display_name: normalizeText(payload.displayName) || null,
+      status: 'pending_confirmation',
+      filters: { event_types: ['post.published', 'digest.weekly'], categories: [], tags: [] },
+      metadata: { source: normalizeText(payload.source) || 'popup' },
+      verified_at: null,
+      last_notified_at: null,
+      last_delivery_status: null,
+      created_at: iso(-1),
+      updated_at: iso(-1),
+    })
+    state.subscriptions.unshift(record)
+    addAuditLog('subscription.create', 'subscription', record.target, record.id, { status: record.status })
+    json(res, 200, {
+      ok: true,
+      subscription_id: record.id,
+      status: record.status,
+      requires_confirmation: true,
+      message: '订阅已登记，请前往确认页完成激活。',
+    })
+    return
+  }
+
+  if (pathname === '/api/subscriptions/confirm' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const record = state.subscriptions.find((item) => item.confirm_token === normalizeText(payload.token))
+    if (!record) {
+      badRequest(res, '确认令牌无效。')
+      return
+    }
+    record.status = 'active'
+    record.verified_at = iso(-1)
+    record.updated_at = iso(-1)
+    json(res, 200, { ok: true, subscription: clone(record) })
+    return
+  }
+
+  if (pathname === '/api/subscriptions/manage' && req.method === 'GET') {
+    const token = normalizeText(searchParams.get('token'))
+    const record = state.subscriptions.find((item) => item.manage_token === token)
+    if (!record) {
+      badRequest(res, '管理令牌无效。')
+      return
+    }
+    json(res, 200, { ok: true, subscription: clone(record) })
+    return
+  }
+
+  if (pathname === '/api/subscriptions/manage' && req.method === 'PATCH') {
+    const { json: payload } = await parseRequest(req)
+    const record = state.subscriptions.find((item) => item.manage_token === normalizeText(payload.token))
+    if (!record) {
+      badRequest(res, '管理令牌无效。')
+      return
+    }
+    record.display_name = payload.displayName ?? record.display_name
+    record.status = normalizeText(payload.status) || record.status
+    record.filters = payload.filters ?? record.filters
+    record.updated_at = iso(-1)
+    json(res, 200, { ok: true, subscription: clone(record) })
+    return
+  }
+
+  if (pathname === '/api/subscriptions/unsubscribe' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const record = state.subscriptions.find((item) => item.manage_token === normalizeText(payload.token))
+    if (!record) {
+      badRequest(res, '管理令牌无效。')
+      return
+    }
+    record.status = 'unsubscribed'
+    record.updated_at = iso(-1)
+    json(res, 200, { ok: true, subscription: clone(record) })
+    return
+  }
+
+  if (pathname === '/api/analytics/content' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    state.content_events.unshift({ ...payload, created_at: iso(-1) })
+    writeEmpty(res, 204)
+    return
+  }
+
+  if (pathname === '/api/ai/ask/stream' && req.method === 'POST') {
+    const { json: payload } = await parseRequest(req)
+    const question = normalizeText(payload.question) || '未提供问题'
+    const completePayload = {
+      question,
+      answer:
+        'Termi 的内容主要集中在前端工程、回归测试、值班运维和 AI 工作流。\n\n你可以优先看 Playwright 回归工作流、Astro 终端博客信息架构，以及 Docker 发布值班清单这三篇。',
+      sources: state.posts.filter((item) => isPostVisible(item)).slice(0, 3).map((item, index) => ({
+        slug: item.slug,
+        href: `${FRONTEND_ORIGIN}/articles/${item.slug}`,
+        title: item.title,
+        excerpt: item.description,
+        score: 0.94 - index * 0.07,
+        chunk_index: index,
+      })),
+      indexed_chunks: state.site_settings.ai_chunks_count,
+      last_indexed_at: state.site_settings.ai_last_indexed_at,
+    }
+    res.writeHead(200, {
+      'content-type': CONTENT_TYPES.sse,
+      'cache-control': 'no-store',
+      connection: 'keep-alive',
+    })
+    res.write(`event: status\ndata: ${JSON.stringify({ stage: 'searching' })}\n\n`)
+    for (const chunk of [
+      'Termi 的内容主要集中在前端工程、回归测试、值班运维和 AI 工作流。',
+      '\n\n你可以优先看 Playwright 回归工作流、Astro 终端博客信息架构，',
+      '以及 Docker 发布值班清单这三篇。',
+    ]) {
+      res.write(`event: delta\ndata: ${JSON.stringify({ delta: chunk })}\n\n`)
+    }
+    res.write(`event: complete\ndata: ${JSON.stringify(completePayload)}\n\n`)
+    res.end()
+    return
+  }
+
+  if (pathname.startsWith('/api/admin/')) {
+    if (!ensureAdmin(req, res)) return
+
+    if (pathname === '/api/admin/dashboard' && req.method === 'GET') {
+      const pendingComments = state.comments.filter((item) => !item.approved)
+      const pendingFriendLinks = state.friend_links.filter((item) => item.status === 'pending')
+      json(res, 200, {
+        stats: {
+          total_posts: state.posts.length,
+          total_comments: state.comments.length,
+          pending_comments: pendingComments.length,
+          draft_posts: state.posts.filter((item) => item.status === 'draft').length,
+          scheduled_posts: state.posts.filter((item) => item.status === 'scheduled').length,
+          offline_posts: 0,
+          expired_posts: 0,
+          private_posts: state.posts.filter((item) => item.visibility === 'private').length,
+          unlisted_posts: state.posts.filter((item) => item.visibility === 'unlisted').length,
+          total_categories: state.categories.length,
+          total_tags: state.tags.length,
+          total_reviews: state.reviews.length,
+          total_links: state.friend_links.length,
+          pending_links: pendingFriendLinks.length,
+          ai_chunks: state.site_settings.ai_chunks_count,
+          ai_enabled: state.site_settings.ai_enabled,
+        },
+        site: {
+          site_name: state.site_settings.site_name,
+          site_url: state.site_settings.site_url,
+          ai_enabled: state.site_settings.ai_enabled,
+          ai_chunks: state.site_settings.ai_chunks_count,
+          ai_last_indexed_at: state.site_settings.ai_last_indexed_at,
+        },
+        recent_posts: state.posts.slice(0, 5).map((item) => ({
+          id: item.id,
+          title: item.title,
+          slug: item.slug,
+          category: item.category,
+          post_type: item.post_type,
+          pinned: item.pinned,
+          status: item.status,
+          visibility: item.visibility,
+          created_at: item.created_at,
+        })),
+        pending_comments: pendingComments.slice(0, 5).map((item) => ({
+          id: item.id,
+          author: item.author,
+          post_slug: item.post_slug,
+          scope: item.scope,
+          excerpt: item.content?.slice(0, 80) || '',
+          approved: Boolean(item.approved),
+          created_at: item.created_at,
+        })),
+        pending_friend_links: pendingFriendLinks.slice(0, 5).map((item) => ({
+          id: item.id,
+          site_name: item.site_name,
+          site_url: item.site_url,
+          category: item.category,
+          status: item.status,
+          created_at: item.created_at,
+        })),
+        recent_reviews: state.reviews.slice(0, 5).map((item) => ({
+          id: item.id,
+          title: item.title,
+          review_type: item.review_type,
+          rating: item.rating,
+          status: item.status,
+          review_date: item.review_date,
+        })),
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/analytics' && req.method === 'GET') {
+      json(res, 200, {
+        overview: {
+          total_searches: 218,
+          total_ai_questions: 64,
+          searches_last_24h: 12,
+          ai_questions_last_24h: 5,
+          searches_last_7d: 66,
+          ai_questions_last_7d: 18,
+          unique_search_terms_last_7d: 21,
+          unique_ai_questions_last_7d: 9,
+          avg_search_results_last_7d: 5.4,
+          avg_ai_latency_ms_last_7d: 286,
+        },
+        content_overview: {
+          total_page_views: 1642,
+          page_views_last_24h: 18,
+          page_views_last_7d: 142,
+          total_read_completes: 628,
+          read_completes_last_7d: 57,
+          avg_read_progress_last_7d: 74,
+          avg_read_duration_ms_last_7d: 58400,
+        },
+        top_search_terms: [{ query: 'playwright', count: 22, last_seen_at: iso(-8) }],
+        top_ai_questions: [{ query: '这个博客主要写什么内容？', count: 8, last_seen_at: iso(-6) }],
+        recent_events: [],
+        providers_last_7d: [{ provider: 'mock-openai', count: 18 }],
+        top_referrers: [{ referrer: 'homepage', count: 44 }],
+        popular_posts: getHomePayload().popular_posts,
+        daily_activity: [{ date: '2026-04-01', searches: 9, ai_questions: 5 }],
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/categories' && req.method === 'GET') {
+      json(res, 200, state.categories.map((item) => clone(item)))
+      return
+    }
+
+    if (pathname === '/api/admin/categories' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const record = makeTaxonomyRecord('category', payload)
+      state.categories.unshift(record)
+      recalculateTaxonomyCounts()
+      addAuditLog('category.create', 'category', record.name, record.id)
+      json(res, 201, clone(record))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/categories\/\d+$/) && req.method === 'PATCH') {
+      const id = Number(pathname.split('/').pop())
+      const index = state.categories.findIndex((item) => item.id === id)
+      if (index === -1) {
+        notFound(res, '分类不存在。')
+        return
+      }
+      const current = state.categories[index]
+      const { json: payload } = await parseRequest(req)
+      const previousName = current.name
+      const updated = makeTaxonomyRecord('category', payload, current)
+      state.categories[index] = updated
+      if (previousName !== updated.name) {
+        state.posts.forEach((post) => {
+          if (post.category === previousName) {
+            post.category = updated.name
+          }
+        })
+      }
+      recalculateTaxonomyCounts()
+      addAuditLog('category.update', 'category', updated.name, updated.id)
+      json(res, 200, clone(updated))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/categories\/\d+$/) && req.method === 'DELETE') {
+      const id = Number(pathname.split('/').pop())
+      const index = state.categories.findIndex((item) => item.id === id)
+      if (index === -1) {
+        notFound(res, '分类不存在。')
+        return
+      }
+      const [removed] = state.categories.splice(index, 1)
+      state.posts.forEach((post) => {
+        if (post.category === removed.name) {
+          post.category = null
+        }
+      })
+      recalculateTaxonomyCounts()
+      addAuditLog('category.delete', 'category', removed.name, removed.id)
+      writeEmpty(res, 204)
+      return
+    }
+
+    if (pathname === '/api/admin/tags' && req.method === 'GET') {
+      json(res, 200, state.tags.map((item) => clone(item)))
+      return
+    }
+
+    if (pathname === '/api/admin/tags' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const record = makeTaxonomyRecord('tag', payload)
+      state.tags.unshift(record)
+      recalculateTaxonomyCounts()
+      addAuditLog('tag.create', 'tag', record.name, record.id)
+      json(res, 201, clone(record))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/tags\/\d+$/) && req.method === 'PATCH') {
+      const id = Number(pathname.split('/').pop())
+      const index = state.tags.findIndex((item) => item.id === id)
+      if (index === -1) {
+        notFound(res, '标签不存在。')
+        return
+      }
+      const current = state.tags[index]
+      const { json: payload } = await parseRequest(req)
+      const previousName = current.name
+      const updated = makeTaxonomyRecord('tag', payload, current)
+      state.tags[index] = updated
+      if (previousName !== updated.name) {
+        state.posts.forEach((post) => {
+          post.tags = (post.tags || []).map((tag) => (tag === previousName ? updated.name : tag))
+        })
+      }
+      recalculateTaxonomyCounts()
+      addAuditLog('tag.update', 'tag', updated.name, updated.id)
+      json(res, 200, clone(updated))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/tags\/\d+$/) && req.method === 'DELETE') {
+      const id = Number(pathname.split('/').pop())
+      const index = state.tags.findIndex((item) => item.id === id)
+      if (index === -1) {
+        notFound(res, '标签不存在。')
+        return
+      }
+      const [removed] = state.tags.splice(index, 1)
+      state.posts.forEach((post) => {
+        post.tags = (post.tags || []).filter((tag) => tag !== removed.name)
+      })
+      recalculateTaxonomyCounts()
+      addAuditLog('tag.delete', 'tag', removed.name, removed.id)
+      writeEmpty(res, 204)
+      return
+    }
+
+    if (pathname === '/api/admin/site-settings' && req.method === 'GET') {
+      json(res, 200, clone(state.site_settings))
+      return
+    }
+
+    if (pathname === '/api/admin/site-settings' && req.method === 'PATCH') {
+      const { json: payload } = await parseRequest(req)
+      const fieldMap = {
+        siteName: 'site_name',
+        siteShortName: 'site_short_name',
+        siteUrl: 'site_url',
+        siteTitle: 'site_title',
+        siteDescription: 'site_description',
+        heroTitle: 'hero_title',
+        heroSubtitle: 'hero_subtitle',
+        ownerName: 'owner_name',
+        ownerTitle: 'owner_title',
+        ownerBio: 'owner_bio',
+        ownerAvatarUrl: 'owner_avatar_url',
+        socialGithub: 'social_github',
+        socialTwitter: 'social_twitter',
+        socialEmail: 'social_email',
+        location: 'location',
+        techStack: 'tech_stack',
+        musicPlaylist: 'music_playlist',
+        aiEnabled: 'ai_enabled',
+        paragraphCommentsEnabled: 'paragraph_comments_enabled',
+        commentVerificationMode: 'comment_verification_mode',
+        commentTurnstileEnabled: 'comment_turnstile_enabled',
+        subscriptionVerificationMode: 'subscription_verification_mode',
+        subscriptionTurnstileEnabled: 'subscription_turnstile_enabled',
+        webPushEnabled: 'web_push_enabled',
+        turnstileSiteKey: 'turnstile_site_key',
+        turnstileSecretKey: 'turnstile_secret_key',
+        webPushVapidPublicKey: 'web_push_vapid_public_key',
+        webPushVapidPrivateKey: 'web_push_vapid_private_key',
+        webPushVapidSubject: 'web_push_vapid_subject',
+        aiProvider: 'ai_provider',
+        aiApiBase: 'ai_api_base',
+        aiApiKey: 'ai_api_key',
+        aiChatModel: 'ai_chat_model',
+        aiImageProvider: 'ai_image_provider',
+        aiImageApiBase: 'ai_image_api_base',
+        aiImageApiKey: 'ai_image_api_key',
+        aiImageModel: 'ai_image_model',
+        aiProviders: 'ai_providers',
+        aiActiveProviderId: 'ai_active_provider_id',
+        aiEmbeddingModel: 'ai_embedding_model',
+        aiSystemPrompt: 'ai_system_prompt',
+        aiTopK: 'ai_top_k',
+        aiChunkSize: 'ai_chunk_size',
+        mediaStorageProvider: 'media_storage_provider',
+        mediaR2AccountId: 'media_r2_account_id',
+        mediaR2Bucket: 'media_r2_bucket',
+        mediaR2PublicBaseUrl: 'media_r2_public_base_url',
+        mediaR2AccessKeyId: 'media_r2_access_key_id',
+        mediaR2SecretAccessKey: 'media_r2_secret_access_key',
+        seoDefaultOgImage: 'seo_default_og_image',
+        seoDefaultTwitterHandle: 'seo_default_twitter_handle',
+        notificationWebhookUrl: 'notification_webhook_url',
+        notificationChannelType: 'notification_channel_type',
+        notificationCommentEnabled: 'notification_comment_enabled',
+        notificationFriendLinkEnabled: 'notification_friend_link_enabled',
+        subscriptionPopupEnabled: 'subscription_popup_enabled',
+        subscriptionPopupTitle: 'subscription_popup_title',
+        subscriptionPopupDescription: 'subscription_popup_description',
+        subscriptionPopupDelaySeconds: 'subscription_popup_delay_seconds',
+        searchSynonyms: 'search_synonyms',
+      }
+
+      for (const [sourceKey, targetKey] of Object.entries(fieldMap)) {
+        if (Object.hasOwn(payload, sourceKey)) {
+          state.site_settings[targetKey] = payload[sourceKey]
+        }
+      }
+      addAuditLog('site_settings.update', 'site_settings', state.site_settings.site_name, '1')
+      json(res, 200, clone(state.site_settings))
+      return
+    }
+
+    if (pathname === '/api/admin/audit-logs' && req.method === 'GET') {
+      json(res, 200, state.audit_logs.map((item) => clone(item)))
+      return
+    }
+
+    if (pathname === '/api/admin/post-revisions' && req.method === 'GET') {
+      let items = [...state.post_revisions]
+      const slug = normalizeText(searchParams.get('slug'))
+      const limit = Number.parseInt(searchParams.get('limit') || '0', 10) || 0
+      if (slug) {
+        items = items.filter((item) => item.post_slug === slug)
+      }
+      if (limit > 0) {
+        items = items.slice(0, limit)
+      }
+      json(res, 200, items.map((item) => ({
+        id: item.id,
+        post_slug: item.post_slug,
+        post_title: item.post_title,
+        operation: item.operation,
+        revision_reason: item.revision_reason,
+        actor_username: item.actor_username,
+        actor_email: item.actor_email,
+        actor_source: item.actor_source,
+        created_at: item.created_at,
+        has_markdown: item.has_markdown,
+        metadata: clone(item.metadata),
+      })))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/post-revisions\/\d+$/) && req.method === 'GET') {
+      const id = Number(pathname.split('/').pop())
+      const revision = findRevisionById(id)
+      if (!revision) {
+        notFound(res, '版本不存在。')
+        return
+      }
+      json(res, 200, {
+        item: {
+          id: revision.id,
+          post_slug: revision.post_slug,
+          post_title: revision.post_title,
+          operation: revision.operation,
+          revision_reason: revision.revision_reason,
+          actor_username: revision.actor_username,
+          actor_email: revision.actor_email,
+          actor_source: revision.actor_source,
+          created_at: revision.created_at,
+          has_markdown: revision.has_markdown,
+          metadata: clone(revision.metadata),
+        },
+        markdown: revision.markdown,
+      })
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/post-revisions\/\d+\/restore$/) && req.method === 'POST') {
+      const id = Number(pathname.split('/')[4])
+      const revision = findRevisionById(id)
+      if (!revision) {
+        notFound(res, '版本不存在。')
+        return
+      }
+      const { json: payload } = await parseRequest(req)
+      const mode = normalizeText(payload.mode) || 'full'
+      const post = state.posts.find((item) => item.slug === revision.post_slug)
+      if (!post) {
+        notFound(res, '原文章不存在。')
+        return
+      }
+      if (mode === 'full') {
+        Object.assign(post, clone(revision.snapshot))
+      }
+      if (mode === 'metadata') {
+        const snapshot = revision.snapshot || {}
+        Object.assign(post, {
+          title: snapshot.title,
+          description: snapshot.description,
+          category: snapshot.category,
+          tags: clone(snapshot.tags || []),
+          post_type: snapshot.post_type,
+          image: snapshot.image,
+          images: clone(snapshot.images || []),
+          pinned: snapshot.pinned,
+          status: snapshot.status,
+          visibility: snapshot.visibility,
+          publish_at: snapshot.publish_at,
+          unpublish_at: snapshot.unpublish_at,
+          canonical_url: snapshot.canonical_url,
+          noindex: snapshot.noindex,
+          og_image: snapshot.og_image,
+          redirect_from: clone(snapshot.redirect_from || []),
+          redirect_to: snapshot.redirect_to,
+        })
+      }
+      if (mode === 'markdown') {
+        post.content = revision.markdown
+      }
+      post.updated_at = iso(-1)
+      recalculateTaxonomyCounts()
+      addAuditLog('post.restore', 'post', post.title, post.id, { revision_id: id, mode })
+      addPostRevision(post, 'restore', `从版本 #${id} 恢复（${mode}）`)
+      json(res, 200, { restored: true, revision_id: id, post_slug: post.slug, mode })
+      return
+    }
+
+    if (pathname === '/api/admin/comments/blacklist' && req.method === 'GET') {
+      json(res, 200, state.comment_blacklist.map((item) => clone(item)))
+      return
+    }
+
+    if (pathname === '/api/admin/comments/blacklist' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const record = {
+        id: nextId('blacklist'),
+        matcher_type: normalizeText(payload.matcher_type) || 'ip',
+        matcher_value: normalizeText(payload.matcher_value),
+        reason: normalizeText(payload.reason) || null,
+        active: Object.hasOwn(payload, 'active') ? Boolean(payload.active) : true,
+        expires_at: normalizeText(payload.expires_at) || null,
+        created_at: iso(-1),
+        updated_at: iso(-1),
+        effective: Object.hasOwn(payload, 'active') ? Boolean(payload.active) : true,
+      }
+      state.comment_blacklist.unshift(record)
+      addAuditLog('comment_blacklist.create', 'comment_blacklist', record.matcher_value, record.id)
+      json(res, 201, clone(record))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/comments\/blacklist\/\d+$/) && req.method === 'PATCH') {
+      const id = Number(pathname.split('/').pop())
+      const record = state.comment_blacklist.find((item) => item.id === id)
+      if (!record) {
+        notFound(res, '黑名单规则不存在。')
+        return
+      }
+      const { json: payload } = await parseRequest(req)
+      if (Object.hasOwn(payload, 'reason')) record.reason = normalizeText(payload.reason) || null
+      if (Object.hasOwn(payload, 'active')) record.active = Boolean(payload.active)
+      if (Object.hasOwn(payload, 'expires_at')) record.expires_at = normalizeText(payload.expires_at) || null
+      if (payload.clear_expires_at) record.expires_at = null
+      record.updated_at = iso(-1)
+      record.effective = Boolean(record.active) && !record.expires_at
+      addAuditLog('comment_blacklist.update', 'comment_blacklist', record.matcher_value, record.id)
+      json(res, 200, clone(record))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/comments\/blacklist\/\d+$/) && req.method === 'DELETE') {
+      const id = Number(pathname.split('/').pop())
+      const index = state.comment_blacklist.findIndex((item) => item.id === id)
+      if (index === -1) {
+        notFound(res, '黑名单规则不存在。')
+        return
+      }
+      const [removed] = state.comment_blacklist.splice(index, 1)
+      addAuditLog('comment_blacklist.delete', 'comment_blacklist', removed.matcher_value, removed.id)
+      json(res, 200, { deleted: true, id })
+      return
+    }
+
+    if (pathname === '/api/admin/comments/analyze' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const matcherType = normalizeText(payload.matcher_type) || 'ip'
+      const matcherValue = normalizeText(payload.matcher_value)
+      const matches = state.comments.filter((comment) =>
+        getCommentMatcherValue(comment, matcherType) === matcherValue.toLowerCase(),
+      )
+      const analysis = `该来源共出现 ${matches.length} 条评论，其中待审核 ${
+        matches.filter((item) => !item.approved).length
+      } 条；建议保持观察并视情况加入黑名单。`
+      const log = {
+        id: nextId('persona_log'),
+        matcher_type: matcherType,
+        matcher_value: matcherValue,
+        from_at: matches.at(-1)?.created_at ?? null,
+        to_at: matches[0]?.created_at ?? null,
+        total_comments: matches.length,
+        pending_comments: matches.filter((item) => !item.approved).length,
+        distinct_posts: new Set(matches.map((item) => item.post_slug)).size,
+        analysis,
+        samples: matches.slice(0, 3).map((item) => ({
+          id: item.id,
+          created_at: item.created_at,
+          post_slug: item.post_slug,
+          author: item.author,
+          email: item.email,
+          approved: Boolean(item.approved),
+          content_preview: String(item.content || '').slice(0, 80),
+        })),
+        created_at: iso(-1),
+      }
+      state.comment_persona_logs.unshift(log)
+      addAuditLog('comment_persona.analyze', 'comment_persona', matcherValue, log.id)
+      json(res, 200, {
+        matcher_type: log.matcher_type,
+        matcher_value: log.matcher_value,
+        total_comments: log.total_comments,
+        pending_comments: log.pending_comments,
+        first_seen_at: log.from_at,
+        latest_seen_at: log.to_at,
+        distinct_posts: log.distinct_posts,
+        analysis: log.analysis,
+        samples: clone(log.samples),
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/comments/analyze/logs' && req.method === 'GET') {
+      const matcherType = normalizeText(searchParams.get('matcher_type'))
+      const matcherValue = normalizeText(searchParams.get('matcher_value'))
+      const limit = Number.parseInt(searchParams.get('limit') || '0', 10) || 0
+      let items = [...state.comment_persona_logs]
+      if (matcherType) {
+        items = items.filter((item) => item.matcher_type === matcherType)
+      }
+      if (matcherValue) {
+        items = items.filter((item) => item.matcher_value === matcherValue)
+      }
+      if (limit > 0) {
+        items = items.slice(0, limit)
+      }
+      json(res, 200, items.map((item) => clone(item)))
+      return
+    }
+
+    if (pathname === '/api/admin/subscriptions' && req.method === 'GET') {
+      json(res, 200, { subscriptions: state.subscriptions.map((item) => clone(item)) })
+      return
+    }
+
+    if (pathname === '/api/admin/subscriptions' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const id = nextId('subscription')
+      const record = createSubscriptionRecord(id, {
+        channel_type: normalizeText(payload.channelType) || 'email',
+        target: normalizeText(payload.target) || `user${id}@example.com`,
+        display_name: normalizeText(payload.displayName) || null,
+        status: normalizeText(payload.status) || 'active',
+        filters: payload.filters ?? null,
+        metadata: payload.metadata ?? null,
+        secret: normalizeText(payload.secret) || null,
+        notes: normalizeText(payload.notes) || null,
+        created_at: iso(-1),
+        updated_at: iso(-1),
+      })
+      state.subscriptions.unshift(record)
+      addAuditLog('subscription.admin_create', 'subscription', record.target, record.id)
+      json(res, 201, clone(record))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/subscriptions\/\d+$/) && req.method === 'PATCH') {
+      const id = Number(pathname.split('/').pop())
+      const record = state.subscriptions.find((item) => item.id === id)
+      if (!record) {
+        notFound(res, '订阅目标不存在。')
+        return
+      }
+      const { json: payload } = await parseRequest(req)
+      if (Object.hasOwn(payload, 'channelType')) record.channel_type = normalizeText(payload.channelType) || record.channel_type
+      if (Object.hasOwn(payload, 'target')) record.target = normalizeText(payload.target) || record.target
+      if (Object.hasOwn(payload, 'displayName')) record.display_name = normalizeText(payload.displayName) || null
+      if (Object.hasOwn(payload, 'status')) record.status = normalizeText(payload.status) || record.status
+      if (Object.hasOwn(payload, 'filters')) record.filters = payload.filters ?? null
+      if (Object.hasOwn(payload, 'metadata')) record.metadata = payload.metadata ?? null
+      if (Object.hasOwn(payload, 'secret')) record.secret = normalizeText(payload.secret) || null
+      if (Object.hasOwn(payload, 'notes')) record.notes = normalizeText(payload.notes) || null
+      record.updated_at = iso(-1)
+      addAuditLog('subscription.update', 'subscription', record.target, record.id)
+      json(res, 200, clone(record))
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/subscriptions\/\d+$/) && req.method === 'DELETE') {
+      const id = Number(pathname.split('/').pop())
+      const index = state.subscriptions.findIndex((item) => item.id === id)
+      if (index === -1) {
+        notFound(res, '订阅目标不存在。')
+        return
+      }
+      const [removed] = state.subscriptions.splice(index, 1)
+      addAuditLog('subscription.delete', 'subscription', removed.target, removed.id)
+      writeEmpty(res, 204)
+      return
+    }
+
+    if (pathname.match(/^\/api\/admin\/subscriptions\/\d+\/test$/) && req.method === 'POST') {
+      const id = Number(pathname.split('/')[4])
+      const record = state.subscriptions.find((item) => item.id === id)
+      if (!record) {
+        notFound(res, '订阅目标不存在。')
+        return
+      }
+      const delivery = createNotificationDelivery({
+        subscription: record,
+        eventType: 'subscription.test',
+        status: 'queued',
+      })
+      state.deliveries.unshift(delivery)
+      record.last_delivery_status = delivery.status
+      record.last_notified_at = iso(-1)
+      addAuditLog('subscription.test', 'subscription', record.target, record.id)
+      json(res, 200, { queued: true, id: record.id, delivery_id: delivery.id })
+      return
+    }
+
+    if (pathname === '/api/admin/subscriptions/deliveries' && req.method === 'GET') {
+      const limit = Number.parseInt(searchParams.get('limit') || '0', 10) || 0
+      const items = limit > 0 ? state.deliveries.slice(0, limit) : state.deliveries
+      json(res, 200, { deliveries: items.map((item) => clone(item)) })
+      return
+    }
+
+    if (pathname === '/api/admin/subscriptions/digest' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const period = normalizeText(payload.period) || 'weekly'
+      const activeSubscriptions = state.subscriptions.filter((item) => item.status === 'active')
+      activeSubscriptions.forEach((subscription) => {
+        state.deliveries.unshift(
+          createNotificationDelivery({
+            subscription,
+            eventType: `digest.${period}`,
+            status: 'queued',
+            payload: { period },
+          }),
+        )
+        subscription.last_delivery_status = 'queued'
+        subscription.last_notified_at = iso(-1)
+      })
+      addAuditLog('subscription.digest', 'subscription', period, String(activeSubscriptions.length))
+      json(res, 200, {
+        period,
+        post_count: state.posts.filter((item) => item.status === 'published').length,
+        queued: activeSubscriptions.length,
+        skipped: state.subscriptions.length - activeSubscriptions.length,
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/media' && req.method === 'GET') {
+      const prefix = normalizeText(searchParams.get('prefix'))
+      const limit = Number.parseInt(searchParams.get('limit') || '0', 10) || 0
+      const items = state.media
+        .filter((item) => !prefix || item.key.startsWith(prefix))
+        .slice(0, limit > 0 ? limit : undefined)
+      json(res, 200, {
+        provider: state.site_settings.media_storage_provider,
+        bucket: state.site_settings.media_r2_bucket,
+        public_base_url: state.site_settings.media_r2_public_base_url,
+        items: items.map((item) => ({
+          key: item.key,
+          url: item.url,
+          size_bytes: item.size_bytes,
+          last_modified: item.last_modified,
+          title: item.title,
+          alt_text: item.alt_text,
+          caption: item.caption,
+          tags: [...item.tags],
+          notes: item.notes,
+        })),
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/media' && req.method === 'POST') {
+      const { fields, files } = await parseRequest(req)
+      const prefix = normalizeText(fields.prefix) || 'uploads/'
+      const uploaded = files.map((file, index) => {
+        const key = `${prefix}${Date.now()}-${index}-${sanitizeFilename(file.filename)}`
+        const record = makeMediaRecordFromUpload(key, file)
+        state.media.unshift(record)
+        return {
+          key: record.key,
+          url: record.url,
+          size_bytes: record.size_bytes,
+        }
+      })
+      addAuditLog('media.upload', 'media', prefix, String(uploaded.length))
+      json(res, 200, { uploaded })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/media' && req.method === 'DELETE') {
+      const key = decodeURIComponent(searchParams.get('key') || '')
+      const index = state.media.findIndex((item) => item.key === key)
+      if (index === -1) {
+        notFound(res, '媒体对象不存在。')
+        return
+      }
+      state.media.splice(index, 1)
+      addAuditLog('media.delete', 'media', key, key)
+      json(res, 200, { deleted: true, key })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/media/batch-delete' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const deleted = []
+      const failed = []
+      for (const key of Array.isArray(payload.keys) ? payload.keys : []) {
+        const index = state.media.findIndex((item) => item.key === key)
+        if (index === -1) {
+          failed.push(key)
+          continue
+        }
+        state.media.splice(index, 1)
+        deleted.push(key)
+      }
+      addAuditLog('media.batch_delete', 'media', `${deleted.length} deleted`, String(deleted.length), { deleted, failed })
+      json(res, 200, { deleted, failed })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/media/replace' && req.method === 'POST') {
+      const { fields, files } = await parseRequest(req)
+      const key = normalizeText(fields.key)
+      const record = state.media.find((item) => item.key === key)
+      if (!record) {
+        notFound(res, '媒体对象不存在。')
+        return
+      }
+      const file = files[0]
+      if (file) {
+        record.body = file.body?.toString('utf8') || record.body
+        record.size_bytes = file.size ?? record.size_bytes
+        record.content_type = String(file.contentType || record.content_type)
+      }
+      record.last_modified = iso(-1)
+      addAuditLog('media.replace', 'media', key, key)
+      json(res, 200, { key: record.key, url: `${record.url}?v=${Date.now()}` })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/media/metadata' && req.method === 'PATCH') {
+      const { json: payload } = await parseRequest(req)
+      const key = normalizeText(payload.key)
+      const record = state.media.find((item) => item.key === key)
+      if (!record) {
+        notFound(res, '媒体对象不存在。')
+        return
+      }
+      record.title = normalizeText(payload.title) || null
+      record.alt_text = normalizeText(payload.alt_text) || null
+      record.caption = normalizeText(payload.caption) || null
+      record.tags = Array.isArray(payload.tags) ? payload.tags.filter(Boolean) : []
+      record.notes = normalizeText(payload.notes) || null
+      record.last_modified = iso(-1)
+      addAuditLog('media.metadata.update', 'media', key, key)
+      json(res, 200, {
+        saved: true,
+        key: record.key,
+        title: record.title,
+        alt_text: record.alt_text,
+        caption: record.caption,
+        tags: [...record.tags],
+        notes: record.notes,
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/review-cover' && req.method === 'POST') {
+      const { files } = await parseRequest(req)
+      const file = files[0]
+      if (!file) {
+        badRequest(res, '缺少封面文件。')
+        return
+      }
+      const key = `review-covers/${Date.now()}-${sanitizeFilename(file.filename, 'review-cover.svg')}`
+      const record = makeMediaRecordFromUpload(key, file)
+      state.media.unshift(record)
+      addAuditLog('review.cover.upload', 'media', key, key)
+      json(res, 200, { key: record.key, url: record.url })
+      return
+    }
+
+    if (pathname === '/api/admin/ai/reindex' && req.method === 'POST') {
+      state.site_settings.ai_last_indexed_at = iso(-1)
+      state.site_settings.ai_chunks_count += 3
+      json(res, 200, {
+        indexed_chunks: state.site_settings.ai_chunks_count,
+        last_indexed_at: state.site_settings.ai_last_indexed_at,
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/ai/post-metadata' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const markdown = String(payload.markdown || '')
+      const { title, description } = parseHeadingAndDescription(markdown, 'Playwright Mock Draft')
+      json(res, 200, {
+        title,
+        description,
+        category: '测试体系',
+        tags: ['Playwright', 'CI'],
+        slug: slugify(title),
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/ai/polish-post' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const markdown = String(payload.markdown || '').trim()
+      const polishedMarkdown = markdown.includes('【AI 润色】')
+        ? markdown
+        : `${markdown}\n\n【AI 润色】这是一段由 mock server 追加的润色说明。`
+      json(res, 200, { polished_markdown: polishedMarkdown })
+      return
+    }
+
+    if (pathname === '/api/admin/ai/polish-review' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const description = normalizeText(payload.description) || '暂无点评。'
+      json(res, 200, {
+        polished_description: `${description}\n\n（AI 润色）整体表达更凝练，也更适合作为首页卡片摘要。`,
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/ai/post-cover' && req.method === 'POST') {
+      const { json: payload } = await parseRequest(req)
+      const slug = normalizeText(payload.slug) || slugify(payload.title || 'mock-cover')
+      json(res, 200, {
+        image_url: `${MOCK_ORIGIN}/generated/${slug}-cover.svg`,
+        prompt: `Generate a mock cover for ${normalizeText(payload.title) || slug}`,
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/ai/test-provider' && req.method === 'POST') {
+      json(res, 200, {
+        provider: 'openai',
+        endpoint: 'https://api.mock.invalid/v1',
+        chat_model: 'gpt-mock-4.1',
+        reply_preview: 'Mock provider connection looks good.',
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/ai/test-image-provider' && req.method === 'POST') {
+      json(res, 200, {
+        provider: 'mock-images',
+        endpoint: 'https://images.mock.invalid/v1',
+        image_model: 'mock-image-1',
+        result_preview: `${MOCK_ORIGIN}/generated/image-provider-preview.svg`,
+      })
+      return
+    }
+
+    if (pathname === '/api/admin/storage/r2/test' && req.method === 'POST') {
+      json(res, 200, {
+        bucket: state.site_settings.media_r2_bucket,
+        public_base_url: state.site_settings.media_r2_public_base_url,
+      })
+      return
+    }
+  }
+
+  if (pathname.match(/^\/api\/posts\/slug\/[^/]+\/markdown$/) && req.method === 'GET') {
+    const slug = decodeURIComponent(pathname.split('/')[4])
+    const post = state.posts.find((item) => item.slug === slug)
+    if (!post) {
+      notFound(res, '文章不存在。')
+      return
+    }
+    json(res, 200, { slug: post.slug, path: `content/posts/${post.slug}.md`, markdown: post.content })
+    return
+  }
+
+  if (pathname.match(/^\/api\/posts\/slug\/[^/]+\/markdown$/) && req.method === 'PATCH') {
+    const slug = decodeURIComponent(pathname.split('/')[4])
+    const post = state.posts.find((item) => item.slug === slug)
+    if (!post) {
+      notFound(res, '文章不存在。')
+      return
+    }
+    const { json: payload } = await parseRequest(req)
+    post.content = String(payload.markdown || post.content || '')
+    const parsed = parseHeadingAndDescription(post.content, post.title || post.slug)
+    post.title = post.title || parsed.title
+    if (!normalizeText(post.description)) {
+      post.description = parsed.description
+    }
+    post.updated_at = iso(-1)
+    addAuditLog('post.markdown.update', 'post', post.title, post.id, { slug: post.slug })
+    addPostRevision(post, 'markdown', '保存 Markdown')
+    json(res, 200, { slug: post.slug, path: `content/posts/${post.slug}.md`, markdown: post.content })
+    return
+  }
+
+  if (pathname.match(/^\/api\/posts\/slug\/[^/]+\/markdown$/) && req.method === 'DELETE') {
+    const slug = decodeURIComponent(pathname.split('/')[4])
+    const index = state.posts.findIndex((item) => item.slug === slug)
+    if (index === -1) {
+      notFound(res, '文章不存在。')
+      return
+    }
+    const [removed] = state.posts.splice(index, 1)
+    recalculateTaxonomyCounts()
+    addAuditLog('post.delete', 'post', removed.title, removed.id, { slug: removed.slug })
+    addPostRevision(removed, 'delete', '删除文章')
+    json(res, 200, { slug: removed.slug, deleted: true })
+    return
+  }
+
+  if (pathname.match(/^\/api\/comments\/\d+$/) && req.method === 'PATCH') {
+    if (!ensureAdmin(req, res)) return
+    const id = Number(pathname.split('/').pop())
+    const record = state.comments.find((item) => item.id === id)
+    if (!record) {
+      notFound(res, '评论不存在。')
+      return
+    }
+    const { json: payload } = await parseRequest(req)
+    if (Object.hasOwn(payload, 'approved')) record.approved = Boolean(payload.approved)
+    record.updated_at = iso(-1)
+    addAuditLog('comment.update', 'comment', record.author, record.id, { approved: record.approved })
+    json(res, 200, clone(record))
+    return
+  }
+
+  if (pathname.match(/^\/api\/comments\/\d+$/) && req.method === 'DELETE') {
+    if (!ensureAdmin(req, res)) return
+    const id = Number(pathname.split('/').pop())
+    const index = state.comments.findIndex((item) => item.id === id)
+    if (index === -1) {
+      notFound(res, '评论不存在。')
+      return
+    }
+    const [record] = state.comments.splice(index, 1)
+    addAuditLog('comment.delete', 'comment', record.author, record.id)
+    writeEmpty(res, 204)
+    return
+  }
+
+  if (pathname.match(/^\/api\/friend_links\/\d+$/) && req.method === 'PATCH') {
+    if (!ensureAdmin(req, res)) return
+    const id = Number(pathname.split('/').pop())
+    const record = state.friend_links.find((item) => item.id === id)
+    if (!record) {
+      notFound(res, '友链不存在。')
+      return
+    }
+    const { json: payload } = await parseRequest(req)
+    record.site_name = normalizeText(payload.site_name || payload.siteName) || record.site_name
+    record.site_url = normalizeText(payload.site_url || payload.siteUrl) || record.site_url
+    record.description = normalizeText(payload.description) || record.description
+    record.category = normalizeText(payload.category) || record.category
+    record.status = normalizeText(payload.status) || record.status
+    record.updated_at = iso(-1)
+    addAuditLog('friend_link.update', 'friend_link', record.site_name, record.id, { status: record.status })
+    json(res, 200, clone(record))
+    return
+  }
+
+  if (pathname.match(/^\/api\/friend_links\/\d+$/) && req.method === 'DELETE') {
+    if (!ensureAdmin(req, res)) return
+    const id = Number(pathname.split('/').pop())
+    const index = state.friend_links.findIndex((item) => item.id === id)
+    if (index === -1) {
+      notFound(res, '友链不存在。')
+      return
+    }
+    const [record] = state.friend_links.splice(index, 1)
+    addAuditLog('friend_link.delete', 'friend_link', record.site_name, record.id)
+    writeEmpty(res, 204)
+    return
+  }
+
+  notFound(res, `未匹配到 mock 接口：${req.method} ${pathname}`)
+})
+
+server.listen(PORT, '127.0.0.1')
diff --git a/playwright-smoke/package.json b/playwright-smoke/package.json
new file mode 100644
index 0000000..7b64b80
--- /dev/null
+++ b/playwright-smoke/package.json
@@ -0,0 +1,17 @@
+{
+  "name": "termi-playwright-smoke",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "playwright test",
+    "test:frontend": "playwright test --project=frontend",
+    "test:admin": "playwright test --project=admin",
+    "test:headed": "playwright test --headed",
+    "install:browsers": "playwright install --with-deps chromium"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.55.0",
+    "@types/node": "^24.7.2",
+    "typescript": "^5.9.3"
+  }
+}
diff --git a/playwright-smoke/playwright.config.ts b/playwright-smoke/playwright.config.ts
new file mode 100644
index 0000000..c80dc66
--- /dev/null
+++ b/playwright-smoke/playwright.config.ts
@@ -0,0 +1,92 @@
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { defineConfig, devices } from '@playwright/test'
+
+const mockBaseUrl = 'http://127.0.0.1:5159'
+const frontendBaseUrl = 'http://127.0.0.1:4321'
+const adminBaseUrl = 'http://127.0.0.1:4322'
+const isCi = Boolean(process.env.CI)
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const repoRoot = path.resolve(__dirname, '..')
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: false,
+  workers: 1,
+  timeout: 60_000,
+  expect: {
+    timeout: 12_000,
+  },
+  reporter: [['list'], ['html', { open: 'never' }]],
+  use: {
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure',
+    headless: true,
+  },
+  projects: [
+    {
+      name: 'frontend',
+      testMatch: /frontend\.spec\.ts/,
+      use: {
+        ...devices['Desktop Chrome'],
+        channel: isCi ? undefined : 'msedge',
+        baseURL: frontendBaseUrl,
+      },
+    },
+    {
+      name: 'admin',
+      testMatch: /admin\.spec\.ts/,
+      use: {
+        ...devices['Desktop Chrome'],
+        channel: isCi ? undefined : 'msedge',
+        baseURL: adminBaseUrl,
+      },
+    },
+  ],
+  webServer: [
+    {
+      command: 'node ./mock-server.mjs',
+      cwd: __dirname,
+      url: `${mockBaseUrl}/__playwright/health`,
+      reuseExistingServer: !isCi,
+      stdout: 'pipe',
+      stderr: 'pipe',
+      env: {
+        ...process.env,
+        PLAYWRIGHT_MOCK_PORT: '5159',
+        PLAYWRIGHT_FRONTEND_ORIGIN: frontendBaseUrl,
+        PLAYWRIGHT_ADMIN_ORIGIN: adminBaseUrl,
+      },
+    },
+    {
+      command: 'pnpm dev --host 127.0.0.1 --port 4321',
+      cwd: path.resolve(repoRoot, 'frontend'),
+      url: frontendBaseUrl,
+      reuseExistingServer: !isCi,
+      stdout: 'pipe',
+      stderr: 'pipe',
+      env: {
+        ...process.env,
+        PUBLIC_API_BASE_URL: `${mockBaseUrl}/api`,
+        INTERNAL_API_BASE_URL: `${mockBaseUrl}/api`,
+        PUBLIC_IMAGE_ALLOWED_HOSTS: '127.0.0.1:5159,127.0.0.1',
+      },
+    },
+    {
+      command: 'pnpm dev --host 127.0.0.1 --port 4322',
+      cwd: path.resolve(repoRoot, 'admin'),
+      url: adminBaseUrl,
+      reuseExistingServer: !isCi,
+      stdout: 'pipe',
+      stderr: 'pipe',
+      env: {
+        ...process.env,
+        VITE_API_BASE: mockBaseUrl,
+        VITE_FRONTEND_BASE_URL: frontendBaseUrl,
+      },
+    },
+  ],
+})
diff --git a/playwright-smoke/pnpm-lock.yaml b/playwright-smoke/pnpm-lock.yaml
new file mode 100644
index 0000000..9988a37
--- /dev/null
+++ b/playwright-smoke/pnpm-lock.yaml
@@ -0,0 +1,77 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    devDependencies:
+      '@playwright/test':
+        specifier: ^1.55.0
+        version: 1.59.0
+      '@types/node':
+        specifier: ^24.7.2
+        version: 24.12.0
+      typescript:
+        specifier: ^5.9.3
+        version: 5.9.3
+
+packages:
+
+  '@playwright/test@1.59.0':
+    resolution: {integrity: sha512-TOA5sTLd49rTDaZpYpvCQ9hGefHQq/OYOyCVnGqS2mjMfX+lGZv2iddIJd0I48cfxqSPttS9S3OuLKyylHcO1w==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  '@types/node@24.12.0':
+    resolution: {integrity: sha512-GYDxsZi3ChgmckRT9HPU0WEhKLP08ev/Yfcq2AstjrDASOYCSXeyjDsHg4v5t4jOj7cyDX3vmprafKlWIG9MXQ==}
+
+  fsevents@2.3.2:
+    resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  playwright-core@1.59.0:
+    resolution: {integrity: sha512-PW/X/IoZ6BMUUy8rpwHEZ8Kc0IiLIkgKYGNFaMs5KmQhcfLILNx9yCQD0rnWeWfz1PNeqcFP1BsihQhDOBCwZw==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  playwright@1.59.0:
+    resolution: {integrity: sha512-wihGScriusvATUxmhfENxg0tj1vHEFeIwxlnPFKQTOQVd7aG08mUfvvniRP/PtQOC+2Bs52kBOC/Up1jTXeIbw==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  typescript@5.9.3:
+    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  undici-types@7.16.0:
+    resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
+
+snapshots:
+
+  '@playwright/test@1.59.0':
+    dependencies:
+      playwright: 1.59.0
+
+  '@types/node@24.12.0':
+    dependencies:
+      undici-types: 7.16.0
+
+  fsevents@2.3.2:
+    optional: true
+
+  playwright-core@1.59.0: {}
+
+  playwright@1.59.0:
+    dependencies:
+      playwright-core: 1.59.0
+    optionalDependencies:
+      fsevents: 2.3.2
+
+  typescript@5.9.3: {}
+
+  undici-types@7.16.0: {}
diff --git a/playwright-smoke/tests/admin.spec.ts b/playwright-smoke/tests/admin.spec.ts
new file mode 100644
index 0000000..4160c23
--- /dev/null
+++ b/playwright-smoke/tests/admin.spec.ts
@@ -0,0 +1,309 @@
+import { expect, test, type Page } from '@playwright/test'
+
+import { getDebugState, loginAdmin, resetMockState } from './helpers'
+
+test.beforeEach(async ({ request }) => {
+  await resetMockState(request)
+})
+
+function acceptNextDialog(page: Page) {
+  page.once('dialog', async (dialog) => {
+    await dialog.accept()
+  })
+}
+
+function buildSvgPayload(name: string, label: string) {
+  return {
+    name,
+    mimeType: 'image/svg+xml',
+    buffer: Buffer.from(
+      `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="675" viewBox="0 0 1200 675"><rect width="1200" height="675" fill="#111827"/><text x="80" y="180" fill="#f8fafc" font-family="monospace" font-size="40">${label}</text></svg>`,
+      'utf8',
+    ),
+  }
+}
+
+test('后台登录、导航与关键模块页面可加载', async ({ page }) => {
+  await loginAdmin(page)
+
+  const routes = [
+    { label: '概览', url: /\/$/, text: 'Astro 终端博客信息架构实战' },
+    { label: '数据分析', url: /\/analytics$/, text: 'playwright' },
+    { label: '文章', url: /\/posts$/, text: 'playwright-regression-workflow' },
+    { label: '分类', url: /\/categories$/, text: '前端工程' },
+    { label: '标签', url: /\/tags$/, text: 'Playwright' },
+    { label: '备份', url: /\/backups$/, text: '导出' },
+    { label: '版本', url: /\/revisions$/, text: 'astro-terminal-blog' },
+    { label: '评论', url: /\/comments$/, text: 'Carol' },
+    { label: '友链', url: /\/friend-links$/, text: 'Pending Link Review' },
+    { label: '评测', url: /\/reviews$/, text: '《漫长的季节》' },
+    { label: '媒体库', url: /\/media$/, text: '漫长的季节封面' },
+    { label: '订阅', url: /\/subscriptions$/, text: 'watcher@example.com' },
+    { label: '审计', url: /\/audit$/, text: 'playwright-smoke' },
+    { label: '设置', url: /\/settings$/, text: 'InitCool' },
+  ]
+
+  for (const route of routes) {
+    await page.getByRole('link', { name: route.label }).click()
+    await expect(page).toHaveURL(route.url)
+    await expect(page.locator('main')).toContainText(route.text)
+  }
+})
+
+test('后台可以审核评论和友链，并更新站点设置', async ({ page }) => {
+  await loginAdmin(page)
+
+  await page.getByRole('link', { name: '评论' }).click()
+  await expect(page.locator('main')).toContainText('Carol')
+  await page.getByRole('button', { name: '通过' }).first().click()
+
+  await page.getByRole('link', { name: '友链' }).click()
+  await expect(page.locator('main')).toContainText('Pending Link Review')
+  await page.getByRole('button', { name: '通过' }).first().click()
+
+  await page.getByRole('link', { name: '设置' }).click()
+  await expect(page.locator('main')).toContainText('InitCool')
+  await expect(page.getByTestId('site-settings-save')).toBeVisible()
+})
+
+test('后台可完成分类与标签的创建、更新、删除', async ({ page, request }) => {
+  await loginAdmin(page)
+
+  await page.getByRole('link', { name: '分类' }).click()
+  await page.getByTestId('category-name-input').fill('Playwright 深回归分类')
+  await page.getByTestId('category-slug-input').fill('playwright-deep-category')
+  await page.getByPlaceholder('介绍这个分类主要收录哪些内容。').fill('用于后台深度回归的分类。')
+  await page.getByTestId('category-save').click()
+  await expect(page.getByTestId('category-item-playwright-deep-category')).toBeVisible()
+
+  await page.getByTestId('category-item-playwright-deep-category').click()
+  await page.getByPlaceholder('前端工程专题 - Termi').fill('Playwright 深回归分类 SEO')
+  await page.getByTestId('category-save').click()
+
+  let state = await getDebugState(request)
+  expect(
+    state.categories.some(
+      (item: { slug: string; seo_title: string }) =>
+        item.slug === 'playwright-deep-category' &&
+        item.seo_title === 'Playwright 深回归分类 SEO',
+    ),
+  ).toBeTruthy()
+
+  acceptNextDialog(page)
+  await page.getByTestId('category-delete').click()
+  await expect(page.getByTestId('category-item-playwright-deep-category')).toHaveCount(0)
+
+  await page.getByRole('link', { name: '标签' }).click()
+  await page.getByTestId('tag-name-input').fill('Playwright 深回归标签')
+  await page.getByTestId('tag-slug-input').fill('playwright-deep-tag')
+  await page.getByPlaceholder('介绍这个标签常见主题、适合谁看。').fill('用于后台深度回归的标签。')
+  await page.getByTestId('tag-save').click()
+  await expect(page.getByTestId('tag-item-playwright-deep-tag')).toBeVisible()
+
+  await page.getByTestId('tag-item-playwright-deep-tag').click()
+  await page.getByPlaceholder('Astro 相关文章 - Termi').fill('Playwright 深回归标签 SEO')
+  await page.getByTestId('tag-save').click()
+
+  state = await getDebugState(request)
+  expect(
+    state.tags.some(
+      (item: { slug: string; seo_title: string }) =>
+        item.slug === 'playwright-deep-tag' && item.seo_title === 'Playwright 深回归标签 SEO',
+    ),
+  ).toBeTruthy()
+
+  acceptNextDialog(page)
+  await page.getByTestId('tag-delete').click()
+  await expect(page.getByTestId('tag-item-playwright-deep-tag')).toHaveCount(0)
+})
+
+test('后台可完成订阅 CRUD、测试投递与 digest 入队', async ({ page, request }) => {
+  await loginAdmin(page)
+  await page.getByRole('link', { name: '订阅' }).click()
+
+  await page.getByPlaceholder('name@example.com').fill('deep-regression@example.com')
+  await page.getByPlaceholder('例如 站长邮箱 / Discord 运维群').fill('Deep Regression')
+  await page.getByTestId('subscriptions-save').click()
+
+  const row = page
+    .locator('[data-testid^="subscription-row-"]')
+    .filter({ hasText: 'deep-regression@example.com' })
+  await expect(row).toBeVisible()
+
+  await row.getByTestId(/subscription-edit-/).click()
+  await page.getByPlaceholder('例如 站长邮箱 / Discord 运维群').fill('Deep Regression Updated')
+  await page.getByTestId('subscriptions-save').click()
+  await expect(row).toContainText('Deep Regression Updated')
+
+  await row.getByTestId(/subscription-test-/).click()
+  await page.getByTestId('subscriptions-send-weekly').click()
+  await page.getByTestId('subscriptions-send-monthly').click()
+
+  let state = await getDebugState(request)
+  expect(
+    state.deliveries.some((item: { event_type: string; target: string }) =>
+      item.event_type === 'subscription.test' && item.target === 'deep-regression@example.com'),
+  ).toBeTruthy()
+  expect(state.deliveries.some((item: { event_type: string }) => item.event_type === 'digest.weekly')).toBeTruthy()
+  expect(state.deliveries.some((item: { event_type: string }) => item.event_type === 'digest.monthly')).toBeTruthy()
+
+  await row.getByTestId(/subscription-delete-/).click()
+  await expect(row).toHaveCount(0)
+
+  state = await getDebugState(request)
+  expect(
+    state.subscriptions.some((item: { target: string }) => item.target === 'deep-regression@example.com'),
+  ).toBeFalsy()
+})
+
+test('后台可完成文章创建、保存、版本恢复与删除', async ({ page, request }) => {
+  await loginAdmin(page)
+  await page.getByRole('link', { name: '文章' }).click()
+
+  await page.getByTestId('posts-open-create').click()
+  await page.getByTestId('post-create-title').fill('Playwright 深回归文章')
+  await page.getByTestId('post-create-slug').fill('playwright-deep-post')
+  await page.getByTestId('post-create-submit').click()
+
+  await expect(page).toHaveURL(/\/posts\/playwright-deep-post$/)
+  await expect(page.getByTestId('post-editor-title')).toHaveValue('Playwright 深回归文章')
+
+  await page.getByTestId('post-editor-title').fill('Playwright 深回归文章（已更新）')
+  await page.getByTestId('post-editor-save').click()
+  await expect(page.getByTestId('post-editor-title')).toHaveValue('Playwright 深回归文章（已更新）')
+
+  let state = await getDebugState(request)
+  expect(
+    state.posts.some(
+      (item: { slug: string; title: string }) =>
+        item.slug === 'playwright-deep-post' && item.title === 'Playwright 深回归文章（已更新）',
+    ),
+  ).toBeTruthy()
+
+  await page.getByTestId('post-editor-close').click()
+  state = await getDebugState(request)
+  const createRevision = state.post_revisions.find(
+    (item: { id: number; post_slug: string; operation: string }) =>
+      item.post_slug === 'playwright-deep-post' && item.operation === 'create',
+  )
+  expect(createRevision).toBeTruthy()
+
+  await page.getByRole('link', { name: '版本' }).click()
+  await page.getByTestId('revisions-slug-filter').fill('playwright-deep-post')
+  await page.getByTestId(`revision-open-${createRevision.id}`).click()
+  await page.getByTestId('revision-restore-full').click()
+
+  await page.getByRole('link', { name: '文章' }).click()
+  await page.getByTestId('post-item-playwright-deep-post').click()
+  await expect(page.getByTestId('post-editor-title')).toHaveValue('Playwright 深回归文章')
+
+  acceptNextDialog(page)
+  await page.getByTestId('post-editor-delete').click()
+  await expect(page).toHaveURL(/\/posts$/)
+
+  state = await getDebugState(request)
+  expect(state.posts.some((item: { slug: string }) => item.slug === 'playwright-deep-post')).toBeFalsy()
+})
+
+test('后台可完成媒体库上传/元数据/替换/删除，并执行设置页关键动作', async ({ page, request }) => {
+  await loginAdmin(page)
+
+  await page.getByRole('link', { name: '媒体库' }).click()
+  await page.getByTestId('media-upload-input').setInputFiles([
+    buildSvgPayload('deep-regression-cover.svg', 'deep-upload'),
+  ])
+  await page.getByTestId('media-upload').click()
+  await expect(page.getByTestId('media-item-0')).toContainText('deep-regression-cover.svg')
+
+  await page.getByTestId('media-edit-0').click()
+  await page.getByPlaceholder('文章封面 / 站点横幅').fill('Deep Regression Cover')
+  await page.getByPlaceholder('夜色下的终端风格博客封面').fill('Deep Regression Alt')
+  await page.getByPlaceholder('cover, astro, terminal').fill('playwright, regression')
+  await page.getByTestId('media-save-metadata').click()
+
+  let state = await getDebugState(request)
+  expect(
+    state.media.some(
+      (item: { title: string; alt_text: string; tags: string[] }) =>
+        item.title === 'Deep Regression Cover' &&
+        item.alt_text === 'Deep Regression Alt' &&
+        item.tags.includes('playwright'),
+    ),
+  ).toBeTruthy()
+
+  await page.getByTestId('media-replace-input-0').setInputFiles([
+    buildSvgPayload('deep-regression-cover.svg', 'deep-replaced'),
+  ])
+
+  acceptNextDialog(page)
+  await page.getByTestId('media-delete-0').click()
+
+  state = await getDebugState(request)
+  expect(state.media.some((item: { title: string }) => item.title === 'Deep Regression Cover')).toBeFalsy()
+
+  await page.getByRole('link', { name: '设置' }).click()
+  await page.getByTestId('site-settings-site-name').fill('InitCool Deep Regression')
+  await page.getByTestId('site-settings-popup-title').fill('订阅深回归')
+  await page.getByTestId('site-settings-save').click()
+  await page.getByTestId('site-settings-reindex').click()
+  await page.getByTestId('site-settings-test-provider').click()
+  await page.getByTestId('site-settings-test-image-provider').click()
+  await page.getByTestId('site-settings-test-storage').click()
+
+  state = await getDebugState(request)
+  expect(state.site_settings.site_name).toBe('InitCool Deep Regression')
+  expect(state.site_settings.subscription_popup_title).toBe('订阅深回归')
+  expect(state.site_settings.ai_chunks_count).toBeGreaterThan(128)
+})
+
+test('后台可完成评测 CRUD、AI 润色，以及评论画像/黑名单管理', async ({ page, request }) => {
+  await loginAdmin(page)
+
+  await page.getByRole('link', { name: '评测' }).click()
+  await page.getByTestId('review-title').fill('Playwright 深评测')
+  await page.getByTestId('review-date').fill('2026-04-01')
+  await page.getByTestId('review-description').fill('这是一段用于深度回归的评测简介。')
+  await page.getByTestId('review-save').click()
+  await expect(page.locator('main')).toContainText('Playwright 深评测')
+
+  await page.getByTestId('review-ai-polish').click()
+  await expect(page.getByText('AI 点评润色对比')).toBeVisible()
+  await page.getByTestId('review-ai-adopt').click()
+  await page.getByTestId('review-save').click()
+
+  let state = await getDebugState(request)
+  expect(
+    state.reviews.some((item: { title: string }) => item.title === 'Playwright 深评测'),
+  ).toBeTruthy()
+
+  acceptNextDialog(page)
+  await page.getByTestId('review-delete').click()
+  state = await getDebugState(request)
+  expect(
+    state.reviews.some((item: { title: string }) => item.title === 'Playwright 深评测'),
+  ).toBeFalsy()
+
+  await page.getByRole('link', { name: '评论' }).click()
+  await page.getByRole('button', { name: 'AI 分析' }).click()
+  await expect(page.locator('main')).toContainText('建议保持观察')
+
+  await page.getByPlaceholder('输入要封禁的值').fill('203.0.113.55')
+  await page.getByPlaceholder('原因（可选）').first().fill('playwright deep regression')
+  await page.getByTestId('comment-blacklist-add').click()
+
+  state = await getDebugState(request)
+  const createdRule = state.comment_blacklist.find(
+    (item: { id: number; matcher_value: string }) => item.matcher_value === '203.0.113.55',
+  )
+  expect(createdRule).toBeTruthy()
+
+  await page.getByTestId(`blacklist-toggle-${createdRule.id}`).click()
+  await page.getByTestId(`blacklist-toggle-${createdRule.id}`).click()
+  acceptNextDialog(page)
+  await page.getByTestId(`blacklist-delete-${createdRule.id}`).click()
+
+  state = await getDebugState(request)
+  expect(
+    state.comment_blacklist.some((item: { matcher_value: string }) => item.matcher_value === '203.0.113.55'),
+  ).toBeFalsy()
+})
diff --git a/playwright-smoke/tests/frontend.spec.ts b/playwright-smoke/tests/frontend.spec.ts
new file mode 100644
index 0000000..438a858
--- /dev/null
+++ b/playwright-smoke/tests/frontend.spec.ts
@@ -0,0 +1,89 @@
+import { expect, test } from '@playwright/test'
+
+import { getDebugState, resetMockState } from './helpers'
+
+test.beforeEach(async ({ request }) => {
+  await resetMockState(request)
+})
+
+test('首页过滤、热门区和文章详情链路可用', async ({ page }) => {
+  await page.goto('/')
+
+  await expect(page.locator('#home-results-count')).toContainText(/条结果/)
+
+  await page.locator('[data-home-category-filter="测试体系"]').click()
+  await expect(page.locator('#home-active-category-text')).toHaveText('测试体系')
+
+  await page.locator('[data-home-tag-filter="Playwright"]').click()
+  await expect(page.locator('#home-active-tag-text')).toHaveText('Playwright')
+
+  await page.locator('[data-home-popular-range="30d"]').click()
+  await expect(page.locator('#home-stats-window-pill')).toHaveText('30d')
+
+  await page.locator('a[href="/articles/playwright-regression-workflow"]').first().click()
+  await expect(page).toHaveURL(/\/articles\/playwright-regression-workflow$/)
+  await expect(page.getByRole('heading', { name: 'Playwright 回归工作流设计' })).toBeVisible()
+  await expect(page.locator('.paragraph-comment-marker').first()).toBeVisible()
+})
+
+test('文章评论、搜索和 AI 问答链路可用', async ({ page, request }) => {
+  await page.goto('/articles/astro-terminal-blog')
+
+  await page.locator('#toggle-comment-form').click()
+  await page.locator('#comment-form input[name="nickname"]').fill('Playwright Visitor')
+  await page.locator('#comment-form input[name="email"]').fill('visitor@example.com')
+  await page.locator('#comment-form textarea[name="content"]').fill('这是一条来自回归测试的新评论。')
+  await page.locator('#comment-form input[name="captchaAnswer"]').fill('7')
+  await page.getByRole('button', { name: '提交' }).click()
+  await expect(page.locator('#comment-message')).toContainText('提交')
+
+  const commentState = await getDebugState(request)
+  expect(commentState.comments.some((item: { author: string }) => item.author === 'Playwright Visitor')).toBeTruthy()
+
+  await page.goto('/search?q=playwright')
+  await expect(page.getByText('Playwright 回归工作流设计')).toBeVisible()
+
+  await page.goto('/ask')
+  await page.locator('#ai-question').fill('这个博客主要写什么内容？')
+  await page.locator('#ai-submit').click()
+  await expect(page.locator('#ai-answer')).toContainText('Playwright 回归工作流')
+})
+
+test('友链申请与订阅确认/偏好/退订链路可用', async ({ page, request }) => {
+  await page.goto('/friends')
+
+  await page.locator('input[name="siteName"]').fill('Playwright Friend')
+  await page.locator('input[name="siteUrl"]').fill('https://playwright-friend.example')
+  await page.locator('textarea[name="description"]').fill('回归测试用的友链申请。')
+  await page.locator('label', { hasText: '[其他]' }).click()
+  await page.locator('#has-reciprocal').check()
+  await page.getByRole('button', { name: '提交申请' }).click()
+  await expect(page.locator('#form-message')).toContainText('提交')
+
+  const friendState = await getDebugState(request)
+  expect(friendState.friend_links.some((item: { site_name: string }) => item.site_name === 'Playwright Friend')).toBeTruthy()
+
+  await page.goto('/')
+  await page.locator('[data-subscription-popup-open]').click()
+  await page.locator('[data-subscription-popup-email]').fill('playwright-subscriber@example.com')
+  await page.locator('[data-subscription-popup-form] button[type="submit"]').click()
+  await expect(page.locator('[data-subscription-popup-status]')).toContainText('订阅')
+
+  const subscriptionState = await getDebugState(request)
+  const latest = subscriptionState.subscriptions.find(
+    (item: { target: string }) => item.target === 'playwright-subscriber@example.com',
+  )
+  expect(latest).toBeTruthy()
+
+  await page.goto(`/subscriptions/confirm?token=${encodeURIComponent(latest.confirm_token)}`)
+  await expect(page.getByText('订阅已确认')).toBeVisible()
+
+  await page.goto(`/subscriptions/manage?token=${encodeURIComponent(latest.manage_token)}`)
+  await page.getByRole('textbox', { name: '称呼' }).fill('回归通知')
+  await page.getByRole('button', { name: '保存偏好' }).click()
+  await expect(page.locator('[data-manage-status]')).toContainText('偏好已保存')
+
+  await page.goto(`/subscriptions/unsubscribe?token=${encodeURIComponent(latest.manage_token)}`)
+  await page.getByRole('button', { name: '确认退订' }).click()
+  await expect(page.locator('[data-unsubscribe-status]')).toContainText('成功退订')
+})
diff --git a/playwright-smoke/tests/helpers.ts b/playwright-smoke/tests/helpers.ts
new file mode 100644
index 0000000..02849d9
--- /dev/null
+++ b/playwright-smoke/tests/helpers.ts
@@ -0,0 +1,29 @@
+import { expect, type APIRequestContext, type Page } from '@playwright/test'
+
+export const MOCK_BASE_URL = 'http://127.0.0.1:5159'
+export const ADMIN_COOKIE = {
+  name: 'termi_admin_session',
+  value: 'mock-admin-session',
+  domain: '127.0.0.1',
+  path: '/',
+}
+
+export async function resetMockState(request: APIRequestContext) {
+  const response = await request.post(`${MOCK_BASE_URL}/__playwright/reset`)
+  expect(response.ok()).toBeTruthy()
+}
+
+export async function getDebugState(request: APIRequestContext) {
+  const response = await request.get(`${MOCK_BASE_URL}/__playwright/state`)
+  expect(response.ok()).toBeTruthy()
+  return response.json()
+}
+
+export async function loginAdmin(page: Page) {
+  await page.goto('/login')
+  await page.getByLabel('用户名').fill('admin')
+  await page.getByLabel('密码').fill('admin123')
+  await page.getByRole('button', { name: '进入后台' }).click()
+  await expect(page).toHaveURL(/\/$/)
+  await expect(page.getByText('当前登录：admin')).toBeVisible()
+}
diff --git a/playwright-smoke/tsconfig.json b/playwright-smoke/tsconfig.json
new file mode 100644
index 0000000..47d925a
--- /dev/null
+++ b/playwright-smoke/tsconfig.json
@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM"],
+    "types": ["node", "@playwright/test"],
+    "strict": true,
+    "noEmit": true,
+    "allowJs": false,
+    "resolveJsonModule": true
+  },
+  "include": ["playwright.config.ts", "tests/**/*.ts"]
+}