chore: 清理 SSR 改造后的历史遗留死代码与误提交产物

- 删除图形验证码整条死链：service/captcha.go、APICaptcha、 GET /api/captcha、CaptchaService 装配、ErrCaptchaInvalid 及前端 api.captcha()（注册/登录已改用邮箱验证码，Verify 无任何调用方） - 删除 GET /api/posts/hot 死路由：APIHotPosts + PostService.HotPosts （热门排序走 /api/posts?sort=hot） - 删除 GET /api/posts/:id/revisions/:revId 死路由： APIPostRevisionDetail + PostService.GetRevision + ErrRevisionNotFound 及前端 api.postRevision()（历史面板仅用列表接口） - 停止跟踪误提交的 27.5MB Linux 二进制 jiang13-linux-amd64 与 .vite 依赖缓存；.gitignore 补充对应规则并移除已失效的 embed_static 条目
feat(ssr): 扩展 SSR 覆盖至 /page/:slug 与 /user/:id
2026-09-11 00:39:58 +08:00 · 2026-09-10 19:26:14 +08:00 · 2026-09-10 05:04:31 +08:00 · 2026-09-09 20:53:28 +08:00 · 2026-09-09 02:54:56 +08:00 · 2026-09-09 02:48:28 +08:00
169 changed files with 11114 additions and 8079 deletions
--- a/.dockerignore
+++ b/.dockerignore
@@ -14,7 +14,6 @@ tmp-cookie.txt
 dist/
 frontend/node_modules/
 frontend/dist/
-embed_static/static/spa/
 node_modules/
 .vite/

--- a/.gitignore
+++ b/.gitignore
@@ -8,11 +8,12 @@
 /node_modules/
 /frontend/node_modules/
 /frontend/dist/
-/embed_static/static/spa/
+/.vite/

 # Go 编译产物
 /dist/
 *.exe
+/jiang13-*

 # 临时文件
 tmp-cookie.txt
@@ -20,9 +21,10 @@ tmp-cookie.txt
 # 编辑器 / OS
 .idea/
 .vscode/
+.trae/documents/
+.trae/chat/
+.trae/image/
 *.swp
 Thumbs.db
 .DS_Store

-# Lucide path <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD>
-frontend/tmp-lucide-paths.json
--- a/.trae/documents/emoji-effect-adjustment.md
+++ b/.trae/documents/emoji-effect-adjustment.md
@@ -1,151 +0,0 @@
-# 表情效果调整计划
-
-## 问题分析
-
-当前实现存在 5 个问题，根因如下：
-
-### 1. 插入表情后有选择状态（蓝色高亮）
- **根因**: Tiptap `setImage` 插入图片节点后，节点处于 "node-selected" 状态，显示蓝色选中框
- **位置**: [CommentEditor.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentEditor.tsx) L155-163
-
-### 2. 输入框表情太大
- **根因**: CSS 选择器 `img[src^="data:image/svg"]` 只匹配旧 SVG data URI，不匹配新的 AVIF URL（`/stickers/tieba/tb_01.avif`），导致表情图片无尺寸约束，以原始大尺寸渲染
- **位置**: [global.css](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/styles/global.css) L5584-5603
-
-### 3. 插入表情后光标换行
- **根因**: `ArticleImage.configure({ inline: false })` 使图片为块级节点，插入后自动换行
- **位置**: [CommentEditor.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentEditor.tsx) L92
-
-### 4. 表情栏目太宽松
- **根因**: Grid 仅 6 列，gap 4px，padding 10px
- **位置**: [global.css](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/styles/global.css) L5502-5510
-
-### 5. 颜文字太小
- **根因**: `.sticker-picker-text` 的 `font-size: 8px`，极小
- **位置**: [global.css](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/styles/global.css) L5606-5616
-
-## 改动方案
-
-### 文件 1: CommentEditor.tsx
-**改动 A — 图片改为内联** (L92):
-```typescript
-// 旧
-ArticleImage.configure({ inline: false, allowBase64: true }),
-// 新
-ArticleImage.configure({ inline: true, allowBase64: true }),
-```
-
-**改动 B — insertSticker 插入后取消选中和换行** (L155-163):
-```typescript
-const insertSticker = useCallback((sticker: Sticker) => {
-  if (!editor) return;
-  if (sticker.type === 'text' && sticker.text) {
-    editor.chain().focus().insertContent(sticker.text).run();
-  } else if (sticker.url) {
-    // 插入内联图片 + 尾随零宽空格，确保光标在图片后面而非选中图片
-    editor.chain().focus().insertContent([
-      { type: 'image', attrs: { src: sticker.url, alt: sticker.name } },
-      { type: 'text', text: '\u200b' },
-    ]).run();
-  }
-  setShowSticker(false);
-}, [editor]);
-```
-> 用 `insertContent` + 零宽空格替代 `setImage`，避免 node-selected 状态，光标自然落在图片后。
-
-### 文件 2: StickerPicker.tsx
-**改动 C — 键盘导航列数匹配新网格** (L44):
-```typescript
-// 旧
-const cols = 6;
-// 新
-const cols = 8;
-```
-
-### 文件 3: global.css
-**改动 D — 表情选择器密度提升** (L5502-5510):
-```css
-.sticker-picker-grid {
-  display: grid;
-  grid-template-columns: repeat(8, 1fr);  /* 6 → 8 */
-  gap: 2px;                                /* 4px → 2px */
-  padding: 6px;                            /* 10px → 6px */
-  overflow-y: auto;
-  flex: 1;
-  min-height: 0;
-}
-```
-
-**改动 E — 选择器项缩小** (L5512-5522):
-```css
-.sticker-picker-item {
-  padding: 2px;   /* 4px → 2px */
-  /* 其余不变 */
-}
-```
-
-**改动 F — 颜文字字体放大** (L5606-5616):
-```css
-.sticker-picker-text {
-  font-size: 14px;   /* 8px → 14px */
-  line-height: 1.4;  /* 1.2 → 1.4 */
-  /* 其余不变 */
-}
-```
-
-**改动 G — 替换旧 SVG 选择器为通用贴纸选择器** (L5584-5603):
-
-删除旧的 `img[src^="data:image/svg"]` 选择器，替换为基于 `/stickers/` 路径的选择器：
-
-```css
-/* 编辑器内贴纸 img 尺寸约束 */
-.comment-editor .article-prosemirror img[src*="/stickers/"],
-.comment-editor .article-editor-content img[src*="/stickers/"] {
-  display: inline-block;
-  width: 28px;
-  height: 28px;
-  vertical-align: middle;
-  margin: 0 1px;
-  border-radius: 4px;
-  object-fit: contain;
-}
-
-/* 评论正文中的贴纸 img */
-.floor-body img[src*="/stickers/"],
-.comment-body img[src*="/stickers/"] {
-  display: inline-block;
-  vertical-align: middle;
-  width: 28px;
-  height: 28px;
-  margin: 0 1px;
-  background: transparent;
-  border-radius: 4px;
-  object-fit: contain;
-}
-```
-
-**改动 H — 移动端网格也改为 8 列** (L5619-5624):
-```css
-@media (max-width: 640px) {
-  .sticker-picker { max-height: 240px; }
-  .sticker-picker-grid { grid-template-columns: repeat(6, 1fr); } /* 移动端 6 列 */
-  .sticker-picker-tab { padding: 6px 10px; font-size: 12px; }
-  .comment-editor .article-tool-btn { width: 30px; height: 30px; }
-}
-```
-> 移动端保持 6 列（屏幕窄），桌面端 8 列。
-
-## 不改动
- `ArticleImageExtension.tsx` — 无需修改，`inline: true` 通过 `configure()` 传入即可
- `kaomoji.ts` / `emojiData.ts` / `hot.ts` — 数据层不变
- `CommentContent.tsx` — 渲染层不变（CSS 覆盖即可）
- PostEditor（帖子编辑器）— 不受影响，仍使用 `inline: false`
-
-## 验证
-1. `npm run build` 无报错
-2. 浏览器验证：
-   - 选择表情后插入无蓝色选中框
-   - 表情在输入框中显示 28px，内联在文字中
-   - 插入表情后光标紧跟表情后方，不换行
-   - 表情选择器 8 列密度更高
-   - 颜文字标签内字体清晰可读
--- a/.trae/documents/emoji_rich_comment_plan.md
+++ b/.trae/documents/emoji_rich_comment_plan.md
@@ -1,597 +0,0 @@
-# 评论表情包改造 + 富文本评论编辑器计划
-
-## 一、摘要
-
-将评论系统从「纯文本 textarea + Unicode Emoji」升级为「Tiptap 富文本编辑器 + 姜十三专属 SVG 贴纸」，实现：
-1. 去除所有 Unicode Emoji，替换为自定义 SVG 贴纸（懒加载）
-2. 姜十三专属表情包：萌系吉祥物表情 + 中文网络流行语文字气泡（混合风格）
-3. 评论复用帖子编辑器核心能力（精简变体），支持代码块、链接、图片、格式化等
-
---
-
-## 二、当前状态分析
-
-### 2.1 评论输入：纯文本 textarea
-
-[CommentBox.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentBox.tsx) 使用 `<textarea>` 输入评论，功能包括：
- `@` 用户提及（textarea 选区扫描 + API 搜索用户）
- Unicode Emoji 面板（[EmojiPicker.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/EmojiPicker.tsx) + [emojis.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/emojis.ts)）
- 隐私评论开关
- 无富文本格式化能力
-
-### 2.2 评论渲染：纯文本转义
-
-[CommentContent.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentContent.tsx) 通过 [content.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/content.ts) 的 `highlightMentions()` 渲染评论：
- `escapeWithBreaks()` 转义 HTML 并将 `\n` 转为 `<br>`
- 正则匹配 `@username` 包裹为可点击 `<span class="mention">`
- 不支持 HTML/Markdown 渲染
-
-### 2.3 评论编辑：纯 textarea
-
-[CommentThreadList.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentThreadList.tsx#L276-L297) 编辑模式使用 `<textarea>` 直接修改文本。
-
-### 2.4 帖子编辑器：Tiptap 富文本
-
-[ArticleEditor.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/ArticleEditor.tsx) 是功能完整的 Tiptap 编辑器（900 行），包含：
- 富文本模式 + Markdown 模式切换
- 工具栏：标题/加粗/斜体/下划线/删除线/分割线/引用/列表/代码块/表格/链接/图片/图组
- 门控区块：登录可见/回复可见/积分可见
- 全屏模式
- `forwardRef` 暴露 `getHTML()` / `isEmpty()` / `focus()`
- 使用 `DOMPurify` + `POST_CONTENT_PURIFY_CONFIG` 净化 HTML
-
-### 2.5 后端评论存储
-
- [models.go](file:///c:/Users/freefire/Documents/jiang13-forum/model/models.go#L143-L164): `Comment.Content` 字段类型为 `text`，存储纯文本
- [comment.go](file:///c:/Users/freefire/Documents/jiang13-forum/service/comment.go#L172-L176): `Create()` 仅做 `TrimSpace` + 敏感词过滤，**无 HTML 净化**
- [handlers.go](file:///c:/Users/freefire/Documents/jiang13-forum/handler/handlers.go#L508-L530): `APICreateComment` 从 FormData 取 `content` 字段
- [sanitize_html.go](file:///c:/Users/freefire/Documents/jiang13-forum/service/sanitize_html.go): `SanitizePostHTML` 已有 HTML 白名单策略（bluemonday），但**仅用于帖子，未用于评论**
-
-### 2.6 表情数据
-
-[emojis.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/emojis.ts) 定义约 160 个 Unicode Emoji 字符，无分类、无搜索。
-
---
-
-## 三、修改方案
-
-### Part A：姜十三专属 SVG 贴纸系统
-
-#### A1. 贴纸数据定义
-
-**新建** `frontend/src/data/stickers.ts`
-
-```typescript
-export interface Sticker {
-  id: string;          // 唯一ID，如 "j13-happy"
-  name: string;        // 名称，如 "开心"
-  category: StickerCategory;
-  aliases?: string[];  // 搜索别名
-  svg: string;         // 完整 SVG 字符串（含 viewBox 0 0 64 64）
-}
-
-export type StickerCategory = '热门' | '姜十三' | '文字气泡';
-
-export const STICKER_CATEGORIES: StickerCategory[] = ['热门', '姜十三', '文字气泡'];
-export const STICKERS: Sticker[] = [ /* ... */ ];
-```
-
-**贴纸内容设计（约 40 个）：**
-
-| 分类 | 数量 | 内容 |
-|------|------|------|
-| 姜十三 | 16 | 萌系姜色（ginger色 #D4A574）圆脸吉祥物，额头带"13"标记，各种表情：开心/大笑/哭泣/生气/惊讶/思考/点赞/心心眼/睡觉/疑惑/酷/捂脸/送花/鼓掌/加油/拜托 |
-| 文字气泡 | 16 | 圆角气泡 + 中文网络流行语：666/大佬/同问/给力/沙发/学习了/已赞/佩服/妙啊/牛批/感谢/收藏了/围观/催更/瑞思拜/芜湖 |
-| 热门 | 8 | 从上述两类中精选最常用的 8 个 |
-
-**SVG 设计规范：**
- `viewBox="0 0 64 64"` 统一尺寸
- 所有 fill 使用内联颜色（不依赖 CSS 变量）
- 姜十三吉祥物主色系：`#D4A574`（姜色）/ `#FFF3E0`（浅姜）/ `#E8B87C`（深姜）
- 文字气泡：`#FF6B6B`（红）/ `#4ECDC4`（青）/ `#FFE66D`（黄）/ `#95E1D3`（绿）四色循环
- 线条圆润，stroke-linecap: round
-
-#### A2. SVG 贴纸渲染组件
-
-**新建** `frontend/src/components/emoji/StickerSvg.tsx`
-
-```typescript
-interface StickerSvgProps {
-  id: string;
-  size?: number;       // 默认 28
-  className?: string;
-}
-```
-
- 从 `STICKERS` 查找对应 id，渲染 `dangerouslySetInnerHTML={{ __html: sticker.svg }}`
- SVG 已自包含 fill 颜色，无需额外样式
-
-#### A3. 贴纸选择器（懒加载）
-
-**新建** `frontend/src/components/emoji/StickerPicker.tsx`
-
-```typescript
-interface StickerPickerProps {
-  onSelect: (stickerId: string) => void;
-}
-```
-
-**UI 结构：**
-```
-┌──────────────────────────────┐
-│ [热门] [姜十三] [文字气泡]    │ ← 分类 Tab
-├──────────────────────────────┤
-│ [🙂] [😂] [❤️] [👍] [🎉] ... │ ← SVG 贴纸网格（6列桌面/4列移动端）
-└──────────────────────────────┘
-```
-
-**懒加载策略：**
- 贴纸数据按分类拆分为独立 chunk：`data/stickers/j13.ts`、`data/stickers/text.ts`、`data/stickers/hot.ts`
- `StickerPicker` 使用 `React.lazy()` + `Suspense` 按需加载当前分类
- 切换分类时才加载对应 chunk，首次打开只加载"热门"分类
- 每个贴纸 SVG 在组件挂载时渲染（已在数据中内联，无需额外网络请求）
-
-**交互：**
- 分类 Tab 点击切换，带下划线动画
- 贴纸 hover: `transform: scale(1.15)`, 0.1s 过渡
- 点击贴纸触发 `onSelect(sticker.id)`
- 键盘导航：方向键浏览 + Enter 选中
-
-#### A4. 删除旧 Emoji 系统
-
- **删除** [emojis.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/emojis.ts)（`EMOJI_LIST` 导出）
- **删除** [EmojiPicker.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/EmojiPicker.tsx)
- **保留** `.emoji-picker*` CSS 类（避免影响其他可能的引用），新增 `.sticker-picker*` 类
-
---
-
-### Part B：评论富文本编辑器（精简变体）
-
-#### B1. 创建 CommentEditor 组件
-
-**新建** `frontend/src/components/CommentEditor.tsx`
-
-不直接复用 ArticleEditor（900 行，含全屏/Markdown/门控区块等评论不需要的功能），而是创建独立的精简 Tiptap 编辑器，**复用 ArticleEditor 的扩展组件**。
-
-```typescript
-export interface CommentEditorHandle {
-  getHTML: () => string;
-  isEmpty: () => boolean;
-  focus: () => void;
-}
-
-interface CommentEditorProps {
-  value: string;
-  onChange: (html: string) => void;
-  placeholder?: string;
-}
-```
-
-**使用的 Tiptap 扩展（复用现有）：**
- `StarterKit`（含 heading H2-H4、bold/italic/strike、blockquote、bulletList/orderedList、horizontalRule）
- `Underline`（来自 @tiptap/extension-underline，已安装）
- `Link`（来自 @tiptap/extension-link，已安装）
- `ArticleCodeBlock`（来自 [ArticleCodeBlockExtension.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/editor/ArticleCodeBlockExtension.tsx)，复用）
- `Placeholder`（来自 @tiptap/extension-placeholder，已安装）
- `TabIndent`（来自 [TabIndentExtension.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/editor/TabIndentExtension.tsx)，复用）
- `ArticleImage`（来自 [ArticleImageExtension.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/editor/ArticleImageExtension.tsx)，复用，用于插入图片）
-
-**不使用的扩展（评论场景不需要）：**
- ~~TableKit~~（表格）
- ~~ImageGroup~~（图组）
- ~~MembersOnly / ReplyOnly / PointsOnly~~（门控区块）
- ~~ClearFloatParagraph~~（清除浮动段落）
- ~~Markdown 模式~~
- ~~全屏模式~~
-
-**工具栏按钮（精简版）：**
-```
-[H] [B] [I] [U] [S] [引用] [列表] [有序列表] [代码块] [链接] [图片] [贴纸]
-```
-
-**贴纸集成：**
- 工具栏增加贴纸按钮（Lucide `Sticker` 图标）
- 点击弹出 `StickerPicker`
- 选中贴纸后，将 SVG 作为 inline `<img>` 插入编辑器：
-  ```typescript
-  const sticker = STICKERS.find(s => s.id === id);
-  const dataUri = `data:image/svg+xml,${encodeURIComponent(sticker.svg)}`;
-  editor.chain().focus().setImage({ src: dataUri, alt: sticker.name }).run();
-  ```
-
-**HTML 净化：**
- 使用 `DOMPurify.sanitize(html, POST_CONTENT_PURIFY_CONFIG)` 与 ArticleEditor 一致
- `POST_CONTENT_PURIFY_CONFIG` 来自 [postContent.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/postContent.ts)，复用现有配置
-
-#### B2. 改造 CommentBox
-
-**修改** [CommentBox.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentBox.tsx)
-
-**主要变更：**
-1. 用 `CommentEditor` 替换 `<textarea>`
-2. 用 `CommentEditorHandle` ref 替代 `textareaRef`
-3. `content` 状态存储 HTML 而非纯文本
-4. 移除 `EmojiPicker` 导入和使用，贴纸功能已集成到 `CommentEditor`
-5. 移除 `owoRef` 和 `showEmoji` 状态
-6. `@` 提及功能：暂时保留为文本输入（在编辑器中输入 `@username`，渲染时由 `processCommentHtml` 处理高亮），编辑器内自动补全作为后续增强
-7. `insertEmoji` 改为 `insertSticker`，调用 `CommentEditor` ref 方法
-8. 隐私评论开关保留
-9. 发送时 `content` 为 HTML，直接传给 API
-
-**改动前：**
-```tsx
-<textarea ref={textareaRef} value={content} onChange={handleChange} ... />
-<button ref={owoRef} onClick={() => setShowEmoji(v => !v)}>OwO</button>
-{showEmoji && <EmojiPicker onSelect={insertEmoji} />}
-```
-
-**改动后：**
-```tsx
-<CommentEditor ref={editorRef} value={content} onChange={setContent} placeholder="说点什么吧…" />
-```
-
-#### B3. 改造评论编辑模式
-
-**修改** [CommentThreadList.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentThreadList.tsx#L276-L297)
-
-编辑模式从 `<textarea>` 改为 `CommentEditor`：
-```tsx
-// 改动前
-<textarea value={editText} onChange={e => setEditText(e.target.value)} rows={3} />
-
-// 改动后
-<CommentEditor value={editText} onChange={setEditText} placeholder="编辑评论…" />
-```
-
-需要 import `CommentEditor`，并在 `handleSave` 中提交 HTML 内容。
-
---
-
-### Part C：评论内容渲染
-
-#### C1. 更新 content.ts 支持富文本
-
-**修改** [content.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/content.ts)
-
-当前 `highlightMentions()` 处理纯文本（转义 HTML + 换行 + @高亮）。需要新增 HTML 处理能力。
-
-```typescript
-import DOMPurify from 'dompurify';
-import { POST_CONTENT_PURIFY_CONFIG } from '../utils/postContent';
-
-/** 判断内容是否为 HTML（包含常见 HTML 标签） */
-function isHtmlContent(text: string): boolean {
-  return /<(?:p|div|span|br|h[1-6]|ul|ol|li|pre|code|blockquote|a|img|table|strong|em|u|s)\b/i.test(text);
-}
-
-/** 在 HTML 文本节点中高亮 @ 提及（DOM 遍历，避免破坏标签） */
-function processMentionsInHtml(html: string): string {
-  const div = document.createElement('div');
-  div.innerHTML = html;
-  const walker = document.createTreeWalker(div, NodeFilter.SHOW_TEXT);
-  const textNodes: Text[] = [];
-  let node: Node | null;
-  while ((node = walker.nextNode())) {
-    textNodes.push(node as Text);
-  }
-  for (const textNode of textNodes) {
-    const text = textNode.textContent ?? '';
-    if (!/@[\w\u4e00-\u9fa5_-]/.test(text)) continue;
-    const frag = document.createDocumentFragment();
-    const parts = text.split(/(@[\w\u4e00-\u9fa5_-]+)/);
-    for (const part of parts) {
-      const m = part.match(/^@([\w\u4e00-\u9fa5_-]+)$/);
-      if (m) {
-        const span = document.createElement('span');
-        span.className = 'mention';
-        span.setAttribute('data-name', m[1]);
-        span.setAttribute('role', 'link');
-        span.setAttribute('tabindex', '0');
-        span.textContent = part;
-        frag.appendChild(span);
-      } else if (part) {
-        frag.appendChild(document.createTextNode(part));
-      }
-    }
-    textNode.parentNode?.replaceChild(frag, textNode);
-  }
-  return div.innerHTML;
-}
-
-/** 渲染评论内容：HTML 净化 + @提及高亮，兼容旧版纯文本 */
-export function renderCommentContent(content: string): string {
-  if (isHtmlContent(content)) {
-    // 新版 HTML 评论
-    const sanitized = DOMPurify.sanitize(content, POST_CONTENT_PURIFY_CONFIG);
-    return processMentionsInHtml(sanitized);
-  }
-  // 旧版纯文本评论（向后兼容）
-  return escapeWithBreaks(content).replace(
-    /@([\w\u4e00-\u9fa5_-]+)/g,
-    '<span class="mention" data-name="$1" role="link" tabindex="0">@$1</span>',
-  );
-}
-```
-
-保留原 `highlightMentions()` 函数不删除（可能有其他引用），新增 `renderCommentContent()`。
-
-#### C2. 更新 CommentContent 组件
-
-**修改** [CommentContent.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentContent.tsx)
-
-```tsx
-import { renderCommentContent } from '../utils/content';
-
-// 改动前
-dangerouslySetInnerHTML={{ __html: highlightMentions(content) }}
-
-// 改动后
-dangerouslySetInnerHTML={{ __html: renderCommentContent(content) }}
-```
-
-评论内容中的贴纸 `<img>` 标签会被 `POST_CONTENT_PURIFY_CONFIG` 保留（已允许 `<img>` + `src`），自然渲染为 SVG 图。
-
---
-
-### Part D：后端评论 HTML 净化
-
-#### D1. 评论创建时净化
-
-**修改** [comment.go](file:///c:/Users/freefire/Documents/jiang13-forum/service/comment.go#L172-L176)
-
-```go
-func (s *CommentService) Create(in CommentCreateInput) (*model.Comment, error) {
-    content := SanitizePostHTML(strings.TrimSpace(in.Content))  // 新增 HTML 净化
-    content = s.filter.Filter(content)                           // 敏感词过滤
-    // ... 其余不变
-}
-```
-
-#### D2. 评论更新时净化
-
-**修改** [comment.go](file:///c:/Users/freefire/Documents/jiang13-forum/service/comment.go#L354-L376)
-
-```go
-func (s *CommentService) Update(userID, commentID uint, isAdmin, skipModeration bool, content string) (string, bool, error) {
-    // ...
-    content = SanitizePostHTML(strings.TrimSpace(content))  // 新增
-    content = s.filter.Filter(content)                       // 敏感词过滤
-    // ... 其余不变
-}
-```
-
-`SanitizePostHTML` 已在 [sanitize_html.go](file:///c:/Users/freefire/Documents/jiang13-forum/service/sanitize_html.go) 中定义，使用 bluemonday 白名单策略，允许 Tiptap 产出的 HTML 标签和属性，禁止 `<script>`、`<style>` 等。
-
---
-
-### Part E：CSS 样式
-
-#### E1. 贴纸选择器样式
-
-**修改** [global.css](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/styles/global.css#L5427-L5462) 区域
-
-新增样式块（在现有 `.emoji-picker*` 样式之后）：
-
-```css
-/* 贴纸选择器 */
-.sticker-picker {
-  display: flex;
-  flex-direction: column;
-  margin-top: 8px;
-  border: 1px solid var(--j13-border-light);
-  border-radius: 8px;
-  background: var(--j13-bg-surface);
-  max-height: 280px;
-  overflow: hidden;
-  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.08);
-}
-
-.sticker-picker-tabs {
-  display: flex;
-  border-bottom: 1px solid var(--j13-border-light);
-  padding: 0 8px;
-}
-
-.sticker-picker-tab {
-  border: none;
-  background: none;
-  padding: 8px 12px;
-  font-size: 13px;
-  color: var(--color-text-3);
-  cursor: pointer;
-  border-bottom: 2px solid transparent;
-  transition: color 0.15s, border-color 0.15s;
-}
-
-.sticker-picker-tab.active {
-  color: var(--j13-green);
-  border-bottom-color: var(--j13-green);
-}
-
-.sticker-picker-grid {
-  display: grid;
-  grid-template-columns: repeat(6, 1fr);
-  gap: 4px;
-  padding: 10px;
-  overflow-y: auto;
-  flex: 1;
-}
-
-.sticker-picker-item {
-  border: none;
-  background: none;
-  padding: 4px;
-  cursor: pointer;
-  border-radius: 8px;
-  transition: background 0.1s, transform 0.1s;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-
-.sticker-picker-item:hover {
-  background: var(--color-fill-2);
-  transform: scale(1.15);
-}
-
-/* 贴纸加载占位 */
-.sticker-picker-loading {
-  grid-column: 1 / -1;
-  text-align: center;
-  padding: 24px;
-  color: var(--color-text-4);
-  font-size: 13px;
-}
-
-/* 移动端 */
-@media (max-width: 640px) {
-  .sticker-picker-grid {
-    grid-template-columns: repeat(4, 1fr);
-  }
-}
-```
-
-#### E2. 评论编辑器样式
-
-新增 `.comment-editor` 相关样式，复用 `.article-editor-bar`、`.article-tool-btn` 等现有类名，仅做覆盖调整：
-
-```css
-/* 评论富文本编辑器 */
-.comment-editor .article-editor-bar {
-  padding: 4px 8px;
-}
-
-.comment-editor .article-tool-btn {
-  width: 28px;
-  height: 28px;
-}
-
-.comment-editor .article-editor-content {
-  min-height: 80px;
-  max-height: 300px;
-  overflow-y: auto;
-  padding: 8px 12px;
-  font-size: 14px;
-}
-
-.comment-editor .article-editor-status {
-  padding: 4px 10px;
-}
-
-/* 评论内贴纸图片 */
-.comment-sticker {
-  display: inline-block;
-  vertical-align: middle;
-  width: 28px;
-  height: 28px;
-  margin: 0 2px;
-}
-```
-
---
-
-## 四、文件变更清单
-
-### 新增文件
-
-| 文件路径 | 用途 |
-|----------|------|
-| `frontend/src/data/stickers/hot.ts` | 热门贴纸数据（懒加载 chunk） |
-| `frontend/src/data/stickers/j13.ts` | 姜十三吉祥物贴纸数据（懒加载 chunk） |
-| `frontend/src/data/stickers/text.ts` | 文字气泡贴纸数据（懒加载 chunk） |
-| `frontend/src/data/stickers/index.ts` | 贴纸类型定义 + 统一导出 |
-| `frontend/src/components/emoji/StickerSvg.tsx` | SVG 贴纸渲染组件 |
-| `frontend/src/components/emoji/StickerPicker.tsx` | 贴纸选择器（懒加载） |
-| `frontend/src/components/CommentEditor.tsx` | 评论富文本编辑器（精简 Tiptap） |
-
-### 修改文件
-
-| 文件 | 变更 |
-|------|------|
-| [CommentBox.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentBox.tsx) | textarea → CommentEditor，移除 EmojiPicker，content 改为 HTML |
-| [CommentThreadList.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentThreadList.tsx#L276-L297) | 编辑模式 textarea → CommentEditor |
-| [CommentContent.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/CommentContent.tsx) | 使用 `renderCommentContent()` 替代 `highlightMentions()` |
-| [content.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/content.ts) | 新增 `renderCommentContent()` + `processMentionsInHtml()` |
-| [global.css](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/styles/global.css#L5427-L5462) | 新增 `.sticker-picker*` 和 `.comment-editor*` 样式 |
-| [comment.go](file:///c:/Users/freefire/Documents/jiang13-forum/service/comment.go#L172-L176) | Create() 增加 `SanitizePostHTML` |
-| [comment.go](file:///c:/Users/freefire/Documents/jiang13-forum/service/comment.go#L354-L376) | Update() 增加 `SanitizePostHTML` |
-
-### 删除文件
-
-| 文件 | 原因 |
-|------|------|
-| [emojis.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/utils/emojis.ts) | Unicode Emoji 数据不再需要 |
-| [EmojiPicker.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/components/EmojiPicker.tsx) | 被 StickerPicker 替代 |
-
---
-
-## 五、假设与决策
-
-### 5.1 编辑器决策
-
- **不直接复用 ArticleEditor 组件**，而是创建独立的 CommentEditor，原因：
-  - ArticleEditor 900 行，含全屏/Markdown/门控区块等评论不需要的功能
-  - 复用 ArticleEditor 的 Tiptap 扩展组件（ArticleCodeBlock、ArticleImage、TabIndent 等），避免代码重复
-  - CommentEditor 更轻量，每个评论实例加载更快
- **@ 提及**：暂不在编辑器中实现自动补全（需要 Tiptap Mention 扩展或自定义扩展），用户手动输入 `@username`，渲染时由 `processMentionsInHtml` 高亮。后续可增强为 Tiptap Mention 扩展。
-
-### 5.2 贴纸存储格式
-
- 贴纸以 `data:image/svg+xml` URI 内联在 `<img src="...">` 中
- 每个 SVG 约 300-800 字节，单条评论即使 10 个贴纸也仅 ~8KB
- 后端 `SanitizePostHTML` 白名单已允许 `<img src="...">`，无需额外修改
- 旧评论（纯文本）不受影响，`renderCommentContent` 自动检测并兼容
-
-### 5.3 懒加载策略
-
- 贴纸数据按分类拆分为 3 个 chunk（hot/j13/text），`React.lazy()` 动态导入
- 首次打开选择器只加载"热门"chunk（8 个贴纸），切换分类时才加载其他 chunk
- 每个 chunk 约 5-10KB，加载延迟 < 100ms
-
-### 5.4 向后兼容
-
- 旧评论为纯文本，新 `renderCommentContent()` 通过 `isHtmlContent()` 检测自动走旧路径（escapeWithBreaks + 正则高亮）
- 新评论为 HTML，走 DOMPurify 净化 + DOM 遍历高亮路径
- 后端 `SanitizePostHTML` 对纯文本也安全（bluemonday 会保留纯文本，仅过滤危险标签）
-
---
-
-## 六、实施顺序
-
-1. **Part A**：贴纸数据 + 组件（stickers/*.ts → StickerSvg → StickerPicker）
-2. **Part D**：后端评论 HTML 净化（comment.go Create/Update 加 SanitizePostHTML）
-3. **Part B**：CommentEditor 组件 → CommentBox 集成 → CommentThreadList 编辑模式
-4. **Part C**：content.ts 渲染函数 → CommentContent 更新
-5. **Part E**：CSS 样式
-6. 删除旧 EmojiPicker / emojis.ts
-7. 验证测试
-
---
-
-## 七、验证步骤
-
-1. **贴纸系统验证**：
-   - 点击贴纸按钮，选择器弹出，3 个分类 Tab 可切换
-   - 切换分类时加载对应贴纸（Network 面板确认懒加载）
-   - 点击贴纸后编辑器中出现对应 SVG 图
-
-2. **评论编辑器验证**：
-   - 评论框支持加粗/斜体/下划线/删除线/标题/引用/列表/代码块/链接/图片/贴纸
-   - 代码块支持语法高亮和折叠
-   - 图片可上传并插入
-   - 无全屏/Markdown/表格/门控区块按钮
-
-3. **评论渲染验证**：
-   - 新评论 HTML 正确渲染（格式化、代码块、图片、贴纸）
-   - `@username` 在 HTML 评论中正确高亮为可点击链接
-   - 旧评论（纯文本）仍正常渲染
-   - 贴纸图片在评论中正确显示
-
-4. **后端验证**：
-   - 发送含 `<script>alert(1)</script>` 的评论，后端净化后移除 script 标签
-   - 发送正常 HTML 评论，后端存储完整 HTML
-   - 旧纯文本评论正常存储和渲染
-
-5. **编辑模式验证**：
-   - 编辑已有评论时，CommentEditor 正确加载 HTML 内容
-   - 保存后评论更新正确
--- a/.trae/documents/fix-comment-scroll-position-plan.md
+++ b/.trae/documents/fix-comment-scroll-position-plan.md
@@ -1,138 +0,0 @@
-# 修复主页右侧栏评论点击定位问题
-
-## 问题描述
-
-用户在主页右侧栏点击评论时，如果该评论不是帖子的第一个评论（`floor > 0`），页面跳转后没有定位到该评论上。
-
-## 根因分析
-
-### 问题 1：`jumpToFloor` 使用 `scrollIntoView` 而非 `pageRef.scrollTo`
-
-**文件**: [PostDetailPage.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/pages/PostDetailPage.tsx#L235-L242)
-
-当前 `jumpToFloor` 函数使用 `el.scrollIntoView()` 来滚动：
-
-```typescript
-const jumpToFloor = useCallback((floor: number) => {
-  const el = document.getElementById(`floor-${floor}`);
-  if (!el) return;
-  el.scrollIntoView({ behavior: 'smooth', block: 'center' });
-  // ...
-}, []);
-```
-
-但是页面使用了自定义滚动容器 `pageRef`（类名为 `.post-detail-page`），且 `useGlobalWheelScroll` 钩子拦截了滚轮事件，将其转换为对 `pageRef.scrollTop` 的直接操作。这导致原生 `scrollIntoView` 可能无法正确触发滚动。
-
-对比 `jumpToHeadingHash` 函数（第 244-262 行），它正确地使用了 `pageRef.scrollTo()`：
-
-```typescript
-const jumpToHeadingHash = useCallback((hash: string, smooth = false) => {
-  // ...
-  const root = pageRef.current;
-  if (root) {
-    const rootRect = root.getBoundingClientRect();
-    const elRect = el.getBoundingClientRect();
-    const top = root.scrollTop + (elRect.top - rootRect.top) - 12;
-    root.scrollTo({ top: Math.max(0, top), behavior });
-  }
-  // ...
-}, []);
-```
-
-### 问题 2：`#floor-N` 定位缺少重试机制
-
-**文件**: [PostDetailPage.tsx](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/pages/PostDetailPage.tsx#L264-L273)
-
-当前 `#floor-N` 定位只有一次 80ms 延迟，没有重试机制：
-
-```typescript
-useEffect(() => {
-  if (loading || !post) return;
-  const m = location.hash.match(/^#floor-(\d+)$/);
-  if (!m) return;
-  const floor = Number(m[1]);
-  if (!floor) return;
-  const t = window.setTimeout(() => jumpToFloor(floor), 80);
-  return () => clearTimeout(t);
-}, [loading, post, comments, location.hash, jumpToFloor]);
-```
-
-对比 `#heading-N` 定位（第 275-299 行），它有完善的重试机制（最多 30 次，每次 50ms）。
-
-## 修改方案
-
-### 修改 1：修改 `jumpToFloor` 函数使用 `pageRef.scrollTo`
-
-将 `jumpToFloor` 函数改为使用与 `jumpToHeadingHash` 相同的滚动方式：
-
-```typescript
-const jumpToFloor = useCallback((floor: number) => {
-  const el = document.getElementById(`floor-${floor}`);
-  if (!el) return false;
-
-  const root = pageRef.current;
-  if (root) {
-    const rootRect = root.getBoundingClientRect();
-    const elRect = el.getBoundingClientRect();
-    const top = root.scrollTop + (elRect.top - rootRect.top) - 12;
-    root.scrollTo({ top: Math.max(0, top), behavior: 'smooth' });
-  } else {
-    el.scrollIntoView({ behavior: 'smooth', block: 'center' });
-  }
-
-  setHighlightFloor(floor);
-  clearTimeout(highlightTimer.current);
-  highlightTimer.current = setTimeout(() => setHighlightFloor(null), 2000);
-  return true;
-}, []);
-```
-
-### 修改 2：为 `#floor-N` 定位添加重试机制
-
-将 `#floor-N` 定位的 `useEffect` 改为类似 `#heading-N` 的重试机制：
-
-```typescript
-useEffect(() => {
-  if (loading || !post) return;
-  const m = location.hash.match(/^#floor-(\d+)$/);
-  if (!m) return;
-  const floor = Number(m[1]);
-  if (!floor) return;
-
-  let cancelled = false;
-  let attempts = 0;
-  let timer = 0;
-
-  const tryJump = () => {
-    if (cancelled) return;
-    if (jumpToFloor(floor)) return;
-    attempts += 1;
-    if (attempts < 30) {
-      timer = window.setTimeout(tryJump, 50);
-    }
-  };
-
-  timer = window.setTimeout(tryJump, 0);
-  return () => {
-    cancelled = true;
-    window.clearTimeout(timer);
-  };
-}, [loading, post, comments, location.hash, jumpToFloor]);
-```
-
-## 涉及文件
-
- `frontend/src/pages/PostDetailPage.tsx`：修改 `jumpToFloor` 函数和 `#floor-N` 定位的 `useEffect`
-
-## 风险评估
-
- **低风险**：修改仅限于评论定位逻辑，不影响其他功能
- **需测试**：需要验证页面加载时评论定位是否正常工作，以及页面内部导航时是否正常
-
-## 测试步骤
-
-1. 进入主页，点击右侧栏的一个非第一条评论
-2. 验证页面跳转到帖子详情后，是否正确定位到目标评论
-3. 验证评论高亮效果是否正常显示
-4. 测试第一条评论（floor=0）的定位是否仍然正常工作
-5. 在帖子详情页直接加载带 hash 的 URL（如 `/post/123#floor-5`），验证定位效果
--- a/.trae/documents/fix-post-scroll-persist-plan.md
+++ b/.trae/documents/fix-post-scroll-persist-plan.md
@@ -1,117 +0,0 @@
-# 修复：再次进入帖子时滚动位置异常保留
-
-## 问题
-
-浏览帖子滑到下方 → 返回主页 → 再次进入同一帖子，滚动条停在之前阅读的位置，而非顶部。
-
-## 根因
-
-项目未设置 `history.scrollRestoration`（默认 `'auto'`）。浏览器在导航时会对**内部滚动容器**（`overflow: auto` 的 `.page-wrap`）执行滚动位置恢复。虽然 PostDetailPage 重新挂载后 `.page-wrap` 是新 DOM 元素，浏览器仍会在 paint 前将其 `scrollTop` 恢复到上次记录的值。
-
-项目没有 ScrollToTop 机制来覆盖此行为。
-
-## 与刷新恢复的冲突
-
-之前实现的 `useScrollRestoration`（MainLayout mount-only）负责刷新场景的位置恢复。本修复必须与之共存：
-
-| 场景 | 期望行为 | 处理者 |
-|---|---|---|
-| 刷新帖子页 | 恢复到上次位置 | `useScrollRestoration`（sessionStorage + rAF） |
-| SPA 导航进入帖子 | 从顶部开始 | 本修复（重置 scrollTop=0） |
-| `/post/123` → `/post/456` | 从顶部开始 | 本修复（重置 scrollTop=0） |
-
-**区分依据**：`pagehide` 时 `saveScrollPositions` 将当前 URL 的滚动记录存入 sessionStorage。刷新后该记录存在；SPA 导航进入时该记录不存在（从未为此 URL 保存过，或已被 `restoreScrollPositions` 消费清除）。因此 PostDetailPage 渲染 `.page-wrap` 时检查 sessionStorage 是否有当前 URL 的记录即可区分两种场景。
-
-**时序保证**：React 的 effect 执行顺序是子组件先于父组件。PostDetailPage 的 `useLayoutEffect` 在 MainLayout 的 `useEffect`（含 `useScrollRestoration`）之前执行。此时 sessionStorage 记录尚未被消费，`hasPendingScrollRestore()` 返回准确值。
-
-## 改动计划
-
-### 1. `frontend/src/utils/scrollRestore.ts` — 新增 `hasPendingScrollRestore`
-
-在现有文件中新增导出函数：
-
-```ts
-/** 检查 sessionStorage 中是否有指定 URL 的待恢复滚动记录（不消费/不删除） */
-export function hasPendingScrollRestore(url: string = getCurrentUrl()): boolean {
-  try {
-    const raw = sessionStorage.getItem(storageKey(url));
-    if (!raw) return false;
-    const entry = JSON.parse(raw) as SavedPositions;
-    return !!entry?.containers && Object.keys(entry.containers).length > 0;
-  } catch {
-    return false;
-  }
-}
-```
-
-纯读取，不删除记录（`restoreScrollPositions` 的 rAF 循环仍需要它来恢复）。
-
-### 2. 新建 `frontend/src/hooks/useScrollToTopOnMount.ts`
-
-通用 hook，在滚动容器渲染就绪后重置到顶部（刷新场景跳过）：
-
-```ts
-import { useLayoutEffect, useRef, type RefObject } from 'react';
-import { hasPendingScrollRestore } from '../utils/scrollRestore';
-
-/**
- * 滚动容器渲染就绪后重置到顶部。
- * - 首次就绪：刷新场景（sessionStorage 有记录）跳过，让 useScrollRestoration 恢复；
- *   SPA 导航（无记录）重置到顶部。
- * - deps 变化（如 postId 变化）：始终重置到顶部。
- * - 同 deps 的 ready 状态变化（如评论刷新导致 loading 短暂为 true）：不处理，避免误重置。
- */
-export function useScrollToTopOnMount(
-  scrollRef: RefObject<HTMLElement | null>,
-  deps: React.DependencyList,
-  ready: boolean,
-): void {
-  const lastKeyRef = useRef<string | null>(null);
-  const key = JSON.stringify(deps);
-
-  useLayoutEffect(() => {
-    if (!ready || !scrollRef.current) return;
-
-    if (lastKeyRef.current === null) {
-      lastKeyRef.current = key;
-      if (!hasPendingScrollRestore()) {
-        scrollRef.current.scrollTop = 0;
-      }
-      return;
-    }
-
-    if (lastKeyRef.current !== key) {
-      lastKeyRef.current = key;
-      scrollRef.current.scrollTop = 0;
-    }
-  }, [key, ready]); // ready 变化时重新检查
-}
-```
-
-### 3. `frontend/src/pages/PostDetailPage.tsx` — 调用 hook
-
-在 `pageRef` 定义之后（L108 之后）、`useGlobalWheelScroll` 调用处附近添加：
-
-```ts
-import { useScrollToTopOnMount } from '../hooks/useScrollToTopOnMount';
-// ...
-useScrollToTopOnMount(pageRef, [postId], !loading && !!post);
-```
-
- `deps: [postId]` — `/post/123` → `/post/456` 时重置
- `ready: !loading && !!post` — `.page-wrap` 仅在此时渲染（L446 loading return、L447 !post return），pageRef.current 才有效
-
-### 不需要改动的部分
-
- **其他页面**（FavoritesPage、MessagesPage、ProfilePage 等）：用户仅报告了帖子页问题。这些页面内容较短，滚动保留不明显。如后续报告可复用此 hook。
- **MainLayout / AdminLayout**：`useScrollRestoration` 不变。
- **`history.scrollRestoration`**：不设为 `'manual'`，避免影响 back/forward 时其他页面的浏览器原生恢复。
-
-## 验证步骤
-
-1. **SPA 导航进入帖子**：从首页点击帖子 → 滑到下方 → 返回首页 → 再次点击同一帖子 → 应从顶部开始。
-2. **帖子间切换**：`/post/123` 滑到下方 → 直接导航到 `/post/456` → 应从顶部开始。
-3. **刷新保持位置**：在帖子页滑到下方 → F5 刷新 → 应恢复到原位置（`useScrollRestoration` 生效，hook 跳过）。
-4. **硬刷新保持位置**：同上但用 Ctrl+F5 → 应恢复到原位置。
-5. **首次访问**：从未访问过的帖子 → 应从顶部开始（sessionStorage 无记录）。
-6. **诊断无错误**：TypeScript 编译通过。
--- a/.trae/documents/fix-sticker-serving-plan.md
+++ b/.trae/documents/fix-sticker-serving-plan.md
@@ -1,55 +0,0 @@
-# 修复生产环境表情图片无法显示 Implementation Plan
-
-## Repository Research
-
-### 问题分析
-
-表情图片在生产部署后无法加载，原因是 **Go 后端缺少 `/stickers/*` 路由的静态文件服务注册**。
-
-当前架构：
-1. 前端 emoji 数据中的 URL 为 `/stickers/{platform}/{file}.avif`（在 [emojiData.ts](file:///c:/Users/freefire/Documents/jiang13-forum/frontend/src/data/stickers/emojiData.ts) 中通过 `toLocalUrl()` 生成）
-2. Vite 构建时将 `frontend/public/stickers/` 原样复制到 `embed_static/static/spa/stickers/`
-3. Go 的 `//go:embed static/*` 会将 `embed_static/static/` 下所有文件（包括 stickers）打包进二进制
-4. 但 [embed.go](file:///c:/Users/freefire/Documents/jiang13-forum/embed_static/embed.go) 的 `SetupEmbed()` **只注册了 `/assets/*filepath` 路由**（用于 JS/CSS chunk），没有注册 `/stickers/*filepath`
-5. 同时 `IsSPARoute()` 函数也没有排除 `/stickers` 前缀，导致请求被 SPA NoRoute fallback 处理，返回 index.html 而非图片
-
-开发模式之所以正常，是因为 Vite dev server 自动托管了 `public/stickers/` 下的静态文件。
-
-### 当前代码状态
-
- `embed.go` 第 13 行: `//go:embed static/*` — 正确嵌入了所有静态资源（含 stickers）
- `embed.go` 第 33-43 行: `SetupEmbed()` — 只处理了 `static/spa/assets`，缺少 stickers 路由
- `embed.go` 第 63-77 行: `IsSPARoute()` — 缺少 `/stickers` 前缀排除
-
-## Files and Modules
-
- `embed_static/embed.go`: 新增 `/stickers/*filepath` 文件服务路由；在 `IsSPARoute` 中排除 `/stickers` 前缀
-
-## Implementation Steps
-
-1. **在 `SetupEmbed` 中注册 `/stickers` 路由**
-   - 参照现有 `/assets` 路由的模式，添加对 `static/spa/stickers` 子目录的文件服务
-   - 使用 `fs.Sub(staticFS, "static/spa/stickers")` 获取 stickers 子文件系统
-   - 注册 `GET /stickers/*filepath` 路由，直接透传，不设置长期缓存（表情可能更新）
-
-2. **在 `IsSPARoute` 中排除 `/stickers` 前缀**
-   - 在现有 `strings.HasPrefix(path, "/assets")` 附近添加 `strings.HasPrefix(path, "/stickers")`
-   - 确保表情请求不会被 SPA fallback 拦截
-
-## Dependencies and Considerations
-
- stickers 目录下存储的是 `.avif` 图片文件，不需要设置特殊 MIME type（http.FileServer 会根据扩展名自动识别）
- stickers 资源不含哈希指纹，不应设置 `immutable` 缓存头（与 `/assets` 不同），但可以设置短过期缓存
- 需确保 `fs.Sub` 路径与实际构建输出路径一致：`embed_static/static/spa/stickers/`
-
-## Validation
-
- 重新构建前端：`cd frontend && npm run build`
- 重新构建 Go 二进制：`go build -o jiang13-linux-amd64`
- 部署后访问 `/stickers/tieba/tb_01.avif` 应能直接返回图片内容（HTTP 200）
- 在评论框中打开表情选择器，所有平台的表情应正常显示
-
-## Risks
-
- **风险**: 如果未来在 `public/` 下新增其他静态资源目录（如 `avatars/`、`flags/` 等），需要同样在 `embed.go` 中注册对应路由
- **应对**: 可考虑后续重构为自动扫描 `public/` 下所有子目录并自动注册路由，或改为统一的 SPA 静态文件服务方案
--- a/.trae/rules/build-scripts.mdc
+++ b/.trae/rules/build-scripts.mdc
@@ -0,0 +1,36 @@
+---
+description: 编译与构建脚本约定（Windows build.bat/ps1、Makefile、跨平台同步）
+alwaysApply: true
+---
+
+# 编译与构建脚本
+
+Go 单二进制 + `go:embed` 前端；产物在 `dist/`。
+
+## 运行编译（优先用封装命令，不要猜命令）
+
+| 平台 | 命令 |
+|------|------|
+| Windows | `build.bat` 或 `build.bat -Target <target>` |
+| Linux / macOS | `make` 或 `make <target>` |
+
+**不要**在 Windows 上直接运行 `make`（系统自带多为 Embarcadero MAKE，不兼容本项目 Makefile）。
+
+Windows 上**不要**让用户直接 `.\build.ps1`（默认 ExecutionPolicy 会拦截）；应通过 `build.bat`（内部 `-ExecutionPolicy Bypass`）调用。
+
+常用 target：`build`（默认）、`dev`、`run`、`frontend`、`clean`、`build-all`、`build-windows`、`build-linux`、`tidy`、`help`。
+
+## 修改构建脚本时的约定
+
+1. **双轨同步**：`build.ps1` 与 `Makefile` 目标与行为保持一致；改其一须同步另一份。
+2. **`build.bat` 仅用 ASCII 注释**：`.bat` 会被 cmd 按 GBK 解析，UTF-8 中文注释会导致整行乱码、`powershell` 无法执行。
+3. **`build.ps1` 可用 UTF-8**：由 PowerShell 执行，中文注释无妨。
+4. **构建顺序**：先 `frontend` 内 `npm run build`，再 `go build -trimpath -ldflags "-s -w -X main.version=..." -o dist/jiang13 ./cmd/jiang13`。
+5. **入口包**：`./cmd/jiang13`；Windows 产物带 `.exe`。
+
+## 新增 target 检查清单
+
+- [ ] `build.ps1` 的 `ValidateSet` 与 `switch` 分支
+- [ ] `Makefile` 对应 `.PHONY` 与 recipe
+- [ ] `build.bat -Target help` 说明（help 输出在 ps1 内）
+- [ ] README「快速开始」如需对外暴露再更新
--- a/.vite/deps/_metadata.json
+++ b/.vite/deps/_metadata.json
@@ -1,8 +0,0 @@
-{
-  "hash": "de7e4cff",
-  "configHash": "9a7296da",
-  "lockfileHash": "e3b0c442",
-  "browserHash": "8c168d3c",
-  "optimized": {},
-  "chunks": {}
-}
--- a/.vite/deps/package.json
+++ b/.vite/deps/package.json
@@ -1,3 +0,0 @@
-{
-  "type": "module"
-}
--- a/39
+++ b/39
@@ -1,15 +1,20 @@
-# 姜十三论坛 — 多阶段构建：Node 前端 → Go 单二进制 → Alpine 运行镜像
+# 姜十三论坛 — 多阶段构建：Node 前端（Vike SSR）+ Go API，双服务共用镜像
 # 不使用 # syntax=docker/dockerfile:1，避免构建前额外拉取 docker.io/docker/dockerfile
 #
 # 国内网络：默认经 DaoCloud 拉取基础镜像，npm/go 走国内代理
 # 海外或已配置 Docker registry-mirrors 时可传空前缀：
 #   docker build --build-arg IMAGE_PREFIX= ...
+#
+# 运行形态（docker compose 双容器，同一镜像两种角色）：
+#   api —— Go 二进制，纯 API（:3001 内部，/data 数据卷）
+#   web —— Node 渲染服务器（对外 :3000：SSR + 静态资源 + API 反代）
+# 镜像默认入口为 api 角色；web 角色在 compose 中以 node 用户覆盖 entrypoint。

 ARG IMAGE_PREFIX=docker.m.daocloud.io/library/
 ARG VERSION=dev

-# ── Stage 1: 前端构建（Vite → embed_static/static/spa）────────────────────
-FROM ${IMAGE_PREFIX}node:22-bookworm-slim AS frontend
+# ── Stage 1: 前端构建（Vike → dist/client 静态资源 + dist/server SSR 入口）──
+FROM ${IMAGE_PREFIX}node:24-bookworm-slim AS frontend
 WORKDIR /src/frontend
 COPY frontend/package.json frontend/package-lock.json ./
 RUN npm config set registry https://registry.npmmirror.com \
@@ -17,7 +22,7 @@ RUN npm config set registry https://registry.npmmirror.com \
 COPY frontend/ ./
 RUN npm run build

-# ── Stage 2: Go 编译（纯 Go SQLite，CGO_ENABLED=0）────────────────────────
+# ── Stage 2: Go 编译（纯 Go SQLite，CGO_ENABLED=0；仅 API，无内嵌前端）─────
 FROM ${IMAGE_PREFIX}golang:1.26-bookworm AS builder
 ARG VERSION
 ENV GOPROXY=https://goproxy.cn,direct
@@ -25,31 +30,31 @@ WORKDIR /src
 COPY go.mod go.sum ./
 RUN go mod download
 COPY . .
-COPY --from=frontend /src/embed_static/static/spa ./embed_static/static/spa
 RUN CGO_ENABLED=0 go build -trimpath \
    -ldflags "-s -w -X main.version=${VERSION}" \
    -o /out/jiang13 ./cmd/jiang13

-# ── Stage 3: 运行镜像 ───────────────────────────────────────────────────────
-FROM ${IMAGE_PREFIX}alpine:3.21
-RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories \
-    && apk add --no-cache ca-certificates tzdata wget su-exec \
-    && adduser -D -u 1000 -h /app jiang13
+# ── Stage 3: 运行镜像（Node 运行时承载 SSR 渲染与静态资源，附带 Go API 二进制）
+FROM ${IMAGE_PREFIX}node:24-bookworm-slim
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends gosu ca-certificates tzdata \
+    && rm -rf /var/lib/apt/lists/*

-ENV TZ=Asia/Shanghai
+ENV TZ=Asia/Shanghai \
+    NODE_ENV=production

 WORKDIR /app
 COPY --from=builder /out/jiang13 /app/jiang13
+COPY --from=frontend /src/frontend /app/frontend
 COPY docker-entrypoint.sh /docker-entrypoint.sh
-RUN chown jiang13:jiang13 /app/jiang13 \
-    && chmod +x /app/jiang13 /docker-entrypoint.sh
+RUN chmod +x /app/jiang13 /docker-entrypoint.sh

-# 以 root 启动，entrypoint 修正 /data 卷权限后 su-exec 降权为 jiang13
+# 以 root 启动，entrypoint 修正 /data 卷权限后 gosu 降权为 uid 1000（node 用户）
 VOLUME ["/data"]
-EXPOSE 3000
+EXPOSE 3000 3001

 HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
-    CMD wget -qO- http://127.0.0.1:3000/health || exit 1
+    CMD node -e "fetch('http://127.0.0.1:3001/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"

 ENTRYPOINT ["/docker-entrypoint.sh"]
-CMD ["--work-path", "/app", "--data", "/data", "--port", "3000"]
+CMD ["--work-path", "/app", "--data", "/data", "--port", "3001"]
--- a/48
+++ b/48
@@ -5,46 +5,47 @@ APP_NAME    := jiang13
 MAIN_PKG    := ./cmd/jiang13
 BUILD_DIR   := dist
 DEV_DATA_DIR := dist/data
-VERSION     := 1.1.6
+VERSION     := 1.1.8
 LDFLAGS     := -s -w -X main.version=$(VERSION)
 REGISTRY_IMAGE := hangzhang714128/jiang13-forum

 GO          := go
 GOFLAGS     := -trimpath

-.PHONY: all build build-windows build-linux build-darwin clean run dev tidy help frontend frontend-build docker compose-up compose-down
+.PHONY: all build web-build build-windows build-linux build-darwin build-all clean run serve dev tidy help docker compose-up compose-down

 all: build

-frontend-build:
-	cd frontend && npm install && npm run build
+## 前端构建（Vike：产出 frontend/dist/client 静态资源 + dist/server SSR 入口）
+web-build:
+	cd frontend && (test -d node_modules || npm install) && npm run build

-## 编译当前平台二进制（纯 Go SQLite，无需 CGO）
-build: frontend-build
+## 编译当前平台二进制（纯 Go SQLite，无需 CGO；Go 仅含 API，前端由 Node 渲染）
+build:
 	@mkdir -p $(BUILD_DIR)
 	CGO_ENABLED=0 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME) $(MAIN_PKG)
 	@echo "✓ 编译完成: $(BUILD_DIR)/$(APP_NAME)"

-## Windows amd64（先打包前端再 embed）
-build-windows: frontend-build
+## Windows amd64
+build-windows:
 	@mkdir -p $(BUILD_DIR)
 	CGO_ENABLED=0 GOOS=windows GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME).exe $(MAIN_PKG)
 	@echo "✓ Windows: $(BUILD_DIR)/$(APP_NAME).exe"

-## Linux amd64（先打包前端再 embed）
-build-linux: frontend-build
+## Linux amd64
+build-linux:
 	@mkdir -p $(BUILD_DIR)
 	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-linux-amd64 $(MAIN_PKG)
 	@echo "✓ Linux: $(BUILD_DIR)/$(APP_NAME)-linux-amd64"

-## macOS arm64 (Apple Silicon)（先打包前端再 embed）
-build-darwin: frontend-build
+## macOS arm64 (Apple Silicon)
+build-darwin:
 	@mkdir -p $(BUILD_DIR)
 	CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-darwin-arm64 $(MAIN_PKG)
 	@echo "✓ macOS: $(BUILD_DIR)/$(APP_NAME)-darwin-arm64"

-## 跨平台全量编译（frontend-build 只跑一次）
-build-all: frontend-build
+## 跨平台全量编译
+build-all:
 	@mkdir -p $(BUILD_DIR)
 	CGO_ENABLED=0 GOOS=windows GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME).exe $(MAIN_PKG)
 	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-linux-amd64 $(MAIN_PKG)
@@ -56,12 +57,19 @@ build-all: frontend-build
 tidy:
 	$(GO) mod tidy

-## 本地运行（仅后端，使用已 embed 的前端；数据目录与 dist 二进制一致）
+## 本地运行（仅 Go API :3000，无前端页面；数据目录与 dist 二进制一致）
 run:
 	@mkdir -p $(DEV_DATA_DIR)
 	$(GO) run $(MAIN_PKG) --data $(DEV_DATA_DIR)

-## 前端热更新开发（后端 :3000 + Vite :5173，Ctrl+C 同时退出；数据目录与 dist 二进制一致）
+## 生产模式本地运行（Node :3000 对外 SSR + Go API :3001）
+serve: build web-build
+	@mkdir -p $(DEV_DATA_DIR)
+	@trap 'kill 0' INT; \
+	$(BUILD_DIR)/$(APP_NAME) --data $(DEV_DATA_DIR) --port 3001 & \
+	cd frontend && PORT=3000 GO_API_URL=http://127.0.0.1:3001 npm start
+
+## 前端热更新开发（Vike dev :5173 + Go API :3000，Ctrl+C 同时退出；数据目录与 dist 二进制一致）
 dev:
 	@echo "前端热更新: http://localhost:5173"
 	@echo "后端 API  : http://localhost:3000"
@@ -79,7 +87,7 @@ clean:
 docker:
 	docker build --build-arg VERSION=$(VERSION) -t $(REGISTRY_IMAGE):$(VERSION) -t $(REGISTRY_IMAGE):latest .

-## Docker Compose 启动
+## Docker Compose 启动（web :3000 + api :3001 双容器）
 compose-up:
 	docker compose up -d --build

@@ -89,12 +97,14 @@ compose-down:

 help:
 	@echo "姜十三论坛编译命令:"
-	@echo "  make build          - 编译当前平台"
+	@echo "  make build          - 编译 Go API 二进制（当前平台）"
+	@echo "  make web-build      - 构建前端（Vike：client + server 产物）"
+	@echo "  make serve          - 生产模式本地运行（Node :3000 + Go API :3001）"
 	@echo "  make build-windows  - 编译 Windows"
 	@echo "  make build-linux    - 编译 Linux"
 	@echo "  make build-darwin   - 编译 macOS"
 	@echo "  make build-all      - 编译全部平台"
-	@echo "  make run            - 仅启动后端（:3000）"
+	@echo "  make run            - 仅启动 Go API（:3000）"
 	@echo "  make dev            - 前端热更新开发（:5173 + :3000）"
 	@echo "  make docker         - 构建 Docker 镜像"
 	@echo "  make compose-up     - Docker Compose 启动"
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-18a058?style=flat-square)](LICENSE)
 [![Docker](https://img.shields.io/badge/Docker-hangzhang714128%2Fjiang13--forum-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/hangzhang714128/jiang13-forum)
 [![Go](https://img.shields.io/badge/Go-1.26-00ADD8?style=flat-square&logo=go&logoColor=white)](go.mod)
-[![React](https://img.shields.io/badge/React-18-61DAFB?style=flat-square&logo=react&logoColor=white)](frontend/package.json)
+[![React](https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=white)](frontend/package.json)
 [![SQLite](https://img.shields.io/badge/SQLite-内置-003B57?style=flat-square&logo=sqlite&logoColor=white)](#)

 [在线演示](https://bbs.iioio.com/) ·
@@ -114,11 +114,12 @@

 ### 部署体验

- **单二进制** — `go:embed` 打包前端，无需再单独部署静态资源
+- **双服务架构** — Node（:3000 对外：SSR + 静态资源 + API 反代）+ Go（:3001 内部：纯 API），职责单一、可独立扩缩
+- **服务端渲染** — 首页 / 板块 / 帖子详情由 Vike SSR 真渲染，SEO 友好、首屏直出；其余页面 SPA 接管
 - **零依赖数据库** — SQLite 内建，数据目录由 `app.ini` 统一管理
- **跨平台** — Windows / Linux / macOS 一键编译
+- **跨平台** — Windows / Linux / macOS 一键编译 Go API
 - **系统服务** — 内置 Linux systemd / Windows Service 注册
- **Docker 单容器** — 多阶段镜像，挂载 `data/` 即可持久化
+- **Docker 双容器** — 同一镜像两种角色，`docker compose up` 一键起

 ---

@@ -126,7 +127,7 @@

 ### 1. 编译

-**Windows（推荐）：**
+Go API 二进制（不含前端，Windows）：

 ```bat
 build.bat
@@ -142,9 +143,21 @@ make build

 **手动分步（全平台）：**

+```bash
+go build -trimpath -ldflags "-s -w" -o dist/jiang13 ./cmd/jiang13
+```
+
+前端构建（Vike，产出 `frontend/dist/client` + `dist/server`）：
+
 ```bash
 cd frontend && npm install && npm run build
-cd .. && go build -trimpath -ldflags "-s -w" -o dist/jiang13 ./cmd/jiang13
+```
+
+本地生产模式一键起双服务（Node :3000 对外 + Go API :3001）：
+
+```bash
+make serve          # Linux / macOS
+build.bat -Target serve   # Windows
 ```

 跨平台编译：
@@ -180,31 +193,38 @@ make compose-up

 **拉取已构建镜像（Docker Hub）：**

+同一镜像两种角色，建议直接用 `docker-compose.yml`（已含完整配置）：
+
 ```bash
 docker pull hangzhang714128/jiang13-forum:latest
-docker run -d --name jiang13 \
-  -p 3000:3000 \
-  -v jiang13-data:/data \
-  --restart unless-stopped \
-  hangzhang714128/jiang13-forum:latest
+docker compose up -d
 ```

-**数据持久化：** 容器内 `/data` 对应 SQLite、上传、日志与 JWT 密钥，与下方「数据目录」结构一致。可用 Docker volume 或绑定宿主机目录。镜像启动时会自动将 `/data` 卷属主修正为 uid `1000`（`jiang13` 用户），适配 1Panel 等面板挂载的目录。
+Compose 会启动两个容器：
+
+| 容器 | 角色 | 端口 | 说明 |
+|------|------|------|------|
+| `web` | Node 渲染服务器 | `3000` 对外 | Vike SSR + 静态资源 + API 反代（`GO_API_URL=http://api:3001`） |
+| `api` | Go API | `3001` 内部 | 纯 API 服务，持有 `/data` 数据卷 |
+
+**数据持久化：** `api` 容器内 `/data` 对应 SQLite、上传、日志与 JWT 密钥，与下方「数据目录」结构一致。可用 Docker volume 或绑定宿主机目录。镜像启动时会自动将 `/data` 卷属主修正为 uid `1000`，适配 1Panel 等面板挂载的目录。

 **若使用旧版镜像仍报 permission denied**，可在宿主机执行：`chown -R 1000:1000 /你的数据目录`

 **可选环境变量（容器编排）：**

-| 变量 | 说明 |
-|------|------|
-| `JIANG13_HTTP_PORT` | HTTP 端口（默认 `3000`） |
-| `JIANG13_DATA` | 数据目录（默认 `/data`） |
-| `JIANG13_JWT_SECRET` | JWT 密钥（留空则自动生成并写入 `/data/.jwt_secret`） |
-| `JIANG13_CONFIG` | 配置文件路径 |
-| `JIANG13_WORK_PATH` | 工作目录 |
-| `JIANG13_COMMUNITY_HUB` | 维护者选项：设为 `1` 时本站作为社区枢纽收报。官方站 `bbs.iioio.com` 会按域名自动成为枢纽，无需此变量；仅非官网的枢纽镜像 / 预发需要显式开启（见 `app.ini.example`） |
+| 变量 | 容器 | 说明 |
+|------|------|------|
+| `GO_API_URL` | web | Go API 地址（默认 `http://127.0.0.1:3001`，Compose 中为 `http://api:3001`） |
+| `PORT` | web | Node 渲染服务器监听端口（默认 `3000`） |
+| `JIANG13_HTTP_PORT` | api | HTTP 端口（默认 `3000`，Compose 中为 `3001`） |
+| `JIANG13_DATA` | api | 数据目录（默认 `/data`） |
+| `JIANG13_JWT_SECRET` | api | JWT 密钥（留空则自动生成并写入 `/data/.jwt_secret`） |
+| `JIANG13_CONFIG` | api | 配置文件路径 |
+| `JIANG13_WORK_PATH` | api | 工作目录 |
+| `JIANG13_COMMUNITY_HUB` | api | 维护者选项：设为 `1` 时本站作为社区枢纽收报。官方站 `bbs.iioio.com` 会按域名自动成为枢纽，无需此变量；仅非官网的枢纽镜像 / 预发需要显式开启（见 `app.ini.example`） |

-**健康检查：** `GET /health` 返回 `{"status":"ok"}`，供 Docker / 负载均衡探活。
+**健康检查：** Go API `GET /health`、Node 渲染服务器 `GET /healthz`，均返回 200，供 Docker / 负载均衡探活。

 **发布镜像到 Docker Hub（手动）：**

@@ -212,15 +232,15 @@ docker run -d --name jiang13 \
 docker login
 .\build.bat -Target docker          # Windows
 # make docker                       # Linux/macOS
-docker push hangzhang714128/jiang13-forum:1.1.6
+docker push hangzhang714128/jiang13-forum:1.1.7
 docker push hangzhang714128/jiang13-forum:latest
 ```

 或直接构建：

 ```bash
-docker build --build-arg VERSION=1.1.6 -t hangzhang714128/jiang13-forum:1.1.6 -t hangzhang714128/jiang13-forum:latest .
-docker push hangzhang714128/jiang13-forum:1.1.6
+docker build --build-arg VERSION=1.1.7 -t hangzhang714128/jiang13-forum:1.1.7 -t hangzhang714128/jiang13-forum:latest .
+docker push hangzhang714128/jiang13-forum:1.1.7
 docker push hangzhang714128/jiang13-forum:latest
 ```

@@ -238,51 +258,42 @@ docker push hangzhang714128/jiang13-forum:latest

 **1Panel 部署提示：**

-1. 容器镜像填 `hangzhang714128/jiang13-forum:latest`
-2. 端口映射 `3000:3000`
-3. 挂载数据卷到容器内 `/data`（镜像会自动修正目录权限）
+1. 用 Compose 编排（`docker-compose.yml`）或手动创建两个容器：`api`（Go，内部 `3001`，挂载 `/data`）与 `web`（Node，映射 `3000:3000`）
+2. `web` 容器环境变量 `GO_API_URL` 指向 `api` 容器（如 `http://api:3001`）
+3. 数据卷只需挂在 `api` 容器的 `/data`（镜像会自动修正目录权限）
 4. 首次访问 `http://服务器IP:3000/register` 注册管理员

 ### 3. 直接启动（二进制）

-不想自己编译时，从 [Gitea Releases](https://git.iioio.com/freefire/jiang13-forum/releases) 下载与 Docker 同版本号的文件即可：
+Go 二进制仅提供 API，完整站点需同时运行 Node 渲染服务器（构建前端后 `frontend/server/index.mjs`）。最简单的方式是用上面的 Docker Compose，或本地 `make serve` / `build.bat -Target serve` 一键起双进程。
+
+如需手动部署二进制，从 [Gitea Releases](https://git.iioio.com/freefire/jiang13-forum/releases) 下载与 Docker 同版本号的文件：

 | 文件 | 平台 |
 |------|------|
 | `jiang13-*-windows-amd64.exe` | Windows x64 |
 | `jiang13-*-linux-amd64` | Linux x64 |

-当前 **1.1.6：** [Windows](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.6/jiang13-1.1.6-windows-amd64.exe) · [Linux](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.6/jiang13-1.1.6-linux-amd64)
+当前 **1.1.7：** [Windows](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.7/jiang13-1.1.7-windows-amd64.exe) · [Linux](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.7/jiang13-1.1.7-linux-amd64)

-把文件放到目标目录后直接运行（首次会在同目录生成 `app.ini`）：
+两个进程一起跑（Go API :3001 + Node :3000 对外）：

 ```bash
-# Windows
-.\jiang13-1.1.6-windows-amd64.exe
-# 或改名为 jiang13.exe 后：
-.\jiang13.exe
+# 1) 启动 Go API
+./jiang13 --port 3001 --data ./data

-# Linux
-chmod +x jiang13-1.1.6-linux-amd64
-./jiang13-1.1.6-linux-amd64
+# 2) 另开终端，构建并启动 Node 渲染服务器
+cd frontend && npm install && npm run build
+PORT=3000 GO_API_URL=http://127.0.0.1:3001 npm start
 ```

-本地刚编译的产物在 `dist/`：
+Windows：

-```bash
-# Windows
-.\dist\jiang13.exe
-
-# Linux / macOS
-./dist/jiang13
-```
-
-也可先复制示例配置再改端口 / 数据目录：
-
-```bash
-cp app.ini.example /opt/jiang13/app.ini
-# 编辑 app.ini 后：
-./jiang13
+```powershell
+.\jiang13.exe --port 3001 --data .\data
+# 另开 PowerShell：
+cd frontend; npm install; npm run build
+$env:PORT = '3000'; $env:GO_API_URL = 'http://127.0.0.1:3001'; npm start
 ```

 ### 4. 首次使用
@@ -354,16 +365,17 @@ C:\jiang13\jiang13.exe --service start

 | 层级 | 技术 |
 |------|------|
-| **后端** | Go 1.26 · Gin · GORM · SQLite |
-| **前端** | React 18 · TipTap · Radix UI · Tailwind CSS · TanStack Virtual |
-| **构建** | Vite → `go:embed` 内嵌 SPA，单二进制发布 |
+| **后端** | Go 1.26 · Gin · GORM · SQLite（纯 API 服务） |
+| **前端** | React 19 · Vike SSR · react-router · TipTap · Radix UI · Tailwind CSS · TanStack Virtual |
+| **构建** | Vite 8（Rolldown）双构建：`dist/client` 静态资源 + `dist/server` SSR 入口 |
+| **渲染** | Node 24 · Express + Vike `renderPage`（:3000 对外，API 反代至 Go :3001） |
 | **认证** | bcrypt · JWT Cookie · 可选 OIDC Provider |

 ---

 ## 前端开发

-日常改前端不需要重新完整构建，Vite 支持秒级热更新（HMR，热模块替换）：
+日常改前端不需要重新完整构建，Vike dev 支持秒级热更新（HMR，热模块替换）：

 ```bat
 build.bat -Target dev
@@ -373,16 +385,17 @@ build.bat -Target dev
 make dev
 ```

-浏览器访问 `http://localhost:5173`，API 自动代理到 `http://localhost:3000`。
+浏览器访问 `http://localhost:5173`，API 自动代理到 `http://localhost:3000`。首页 / 板块 / 帖子详情在 dev 下同样走 SSR（`vike dev`），与生产行为一致；其余页面为 SPA 壳。

 开发后端与 `dist/jiang13` 共用数据目录 `dist/data`（SQLite、上传、JWT 密钥等），避免 dev 与 dist 运行数据不一致。

 **何时需要完整构建：**

- 修改 Go 代码或要发布单二进制 → `build.bat` / `make build`
+- 修改 Go 代码 → `build.bat` / `make build`（仅编译 Go API）
+- 验证生产 SSR / 发布部署 → `make serve`（构建前端 + 双进程起本地产）
 - 更新 README 界面截图 → 见下方「更新截图」

-> 直接访问 `:3000` 看到的是上次 build 嵌入的前端；开发时请用 `:5173`。
+> 开发时请访问 `:5173`；`:3000` 只有在生产模式（Node 渲染服务器）下才有页面。

 ### 更新截图

@@ -412,17 +425,20 @@ jiang13-forum/
 ├── cmd/jiang13/           # 程序入口（含系统服务注册）
 ├── config/                # app.ini 与命令行配置
 ├── app.ini.example        # 配置文件示例
-├── Dockerfile             # 多阶段 Docker 构建
-├── docker-compose.yml     # 单容器 Compose 部署
-├── docker-entrypoint.sh   # 容器启动脚本（修正 /data 卷权限）
+├── Dockerfile             # 多阶段构建（前端 + Go API 共用镜像，双容器运行）
+├── docker-compose.yml     # 双容器 Compose 部署（web :3000 + api :3001）
+├── docker-entrypoint.sh   # api 容器启动脚本（修正 /data 卷权限）
 ├── .dockerignore
 ├── model/                 # GORM 模型与数据库迁移
 ├── service/               # 业务逻辑
-├── handler/               # HTTP 处理器（前台 + 后台）
+├── handler/               # HTTP 处理器（API + /api/home-boot SSR 聚合端点）
 ├── middleware/            # JWT 鉴权等
-├── router/                # 路由注册
-├── embed_static/          # go:embed 内嵌的 SPA
-├── frontend/              # React 源码（Vite 构建）
+├── router/                # 路由注册（仅 API）
+├── frontend/
+│   ├── pages/             # Vike 页面（feed=SSR 白名单 / spa=catch-all 壳 / _error）
+│   ├── renderer/          # Vike 双端渲染入口（onRenderHtml / onRenderClient）
+│   ├── server/            # Node 渲染服务器（express + renderPage + API 反代）
+│   └── src/               # React 源码（含 src/ssr 服务端取数与作用域管理）
 ├── docs/screenshots/      # README 界面截图
 ├── ROADMAP.md             # 路线图与已知问题
 └── scripts/               # 开发辅助脚本（含截图）
--- a/build.ps1
+++ b/build.ps1
@@ -3,7 +3,7 @@
 #        .\build.ps1 -Target build-windows

 param(
-    [ValidateSet('build', 'build-windows', 'build-linux', 'build-darwin', 'build-all', 'frontend', 'tidy', 'run', 'dev', 'clean', 'docker', 'compose-up', 'compose-down', 'help')]
+    [ValidateSet('build', 'web-build', 'frontend', 'build-windows', 'build-linux', 'build-darwin', 'build-all', 'tidy', 'run', 'serve', 'dev', 'clean', 'docker', 'compose-up', 'compose-down', 'help')]
    [string]$Target = 'build'
 )

@@ -12,7 +12,7 @@ $AppName = 'jiang13'
 $MainPkg = './cmd/jiang13'
 $BuildDir = 'dist'
 $DevDataDir = 'dist/data'
-$Version = '1.1.6'
+$Version = '1.1.8'
 $RegistryImage = 'hangzhang714128/jiang13-forum'
 $Ldlags = "-s -w -X main.version=$Version"

@@ -23,7 +23,7 @@ function Ensure-Dir($path) {
 }

 function Build-Frontend {
-    Write-Host '[frontend] npm run build...' -ForegroundColor Cyan
+    Write-Host '[frontend] npm run build (Vike: client + server)...' -ForegroundColor Cyan
    Push-Location frontend
    try {
        if (-not (Test-Path node_modules)) {
@@ -69,13 +69,14 @@ function Build-Go([string]$OutFile, [string]$GoOS = '', [string]$GoArch = '') {

 switch ($Target) {
    'help' {
-        Write-Host '.\build.ps1                  build current platform'
-        Write-Host '.\build.ps1 -Target frontend  frontend only'
+        Write-Host '.\build.ps1                  build Go API binary (current platform)'
+        Write-Host '.\build.ps1 -Target web-build  build frontend (Vike client + server)'
+        Write-Host '.\build.ps1 -Target serve    production run: Node :3000 + Go API :3001'
        Write-Host '.\build.ps1 -Target build-windows'
        Write-Host '.\build.ps1 -Target build-linux'
        Write-Host '.\build.ps1 -Target build-all'
-        Write-Host '.\build.ps1 -Target run       backend only (port 3000)'
-        Write-Host '.\build.ps1 -Target dev       backend + Vite HMR (recommended for frontend dev)'
+        Write-Host '.\build.ps1 -Target run      Go API only (port 3000, no pages)'
+        Write-Host '.\build.ps1 -Target dev      Vike HMR :5173 + Go API :3000 (recommended for frontend dev)'
        Write-Host '.\build.ps1 -Target tidy'
        Write-Host '.\build.ps1 -Target clean'
        Write-Host '.\build.ps1 -Target docker       build Docker image'
@@ -84,6 +85,7 @@ switch ($Target) {
        Write-Host ''
        Write-Host 'Note: Windows "make" is often Embarcadero MAKE, not GNU Make.'
    }
+    'web-build' { Build-Frontend }
    'frontend' { Build-Frontend }
    'tidy' { go mod tidy }
    'clean' {
@@ -94,11 +96,35 @@ switch ($Target) {
        Ensure-Dir $DevDataDir
        go run $MainPkg --data $DevDataDir
    }
+    'serve' {
+        Build-Frontend
+        Build-Go -OutFile $AppName
+        Ensure-Dir $DevDataDir
+        $root = (Get-Location).Path
+        $goExe = Join-Path $root "$BuildDir\$AppName.exe"
+        Write-Host '[serve] 正在新窗口启动 Go API (:3001)...' -ForegroundColor Cyan
+        Start-Process powershell -ArgumentList @(
+            '-NoExit', '-Command',
+            "Set-Location '$root'; & '$goExe' --data '$DevDataDir' --port 3001"
+        ) | Out-Null
+        Start-Sleep -Seconds 2
+        Write-Host '[serve] 启动 Node 渲染服务器 (:3000)...' -ForegroundColor Cyan
+        Push-Location frontend
+        try {
+            $env:PORT = '3000'
+            $env:GO_API_URL = 'http://127.0.0.1:3001'
+            npm start
+        } finally {
+            Remove-Item Env:PORT -ErrorAction SilentlyContinue
+            Remove-Item Env:GO_API_URL -ErrorAction SilentlyContinue
+            Pop-Location
+        }
+    }
    'dev' {
        $root = (Get-Location).Path
        Ensure-Dir $DevDataDir
        Write-Host ''
-        Write-Host '[dev] 前端开发  : http://localhost:5173  (Vite HMR)' -ForegroundColor Green
+        Write-Host '[dev] 前端开发  : http://localhost:5173  (Vike HMR)' -ForegroundColor Green
        Write-Host '[dev] 后端 API  : http://localhost:3000  (Go)' -ForegroundColor Green
        Write-Host "[dev] 数据目录  : $DevDataDir (与 dist 二进制一致)" -ForegroundColor Green
        Write-Host '[dev] 提示     : 请访问 5173 端口，Vite 会自动代理 API 到 3000' -ForegroundColor Yellow
@@ -117,24 +143,18 @@ switch ($Target) {
        }
    }
    'build' {
-        Build-Frontend
        Build-Go -OutFile $AppName
    }
    'build-windows' {
-        Build-Frontend
        Build-Go -OutFile $AppName -GoOS 'windows' -GoArch 'amd64'
    }
    'build-linux' {
-        Write-Host '[build-linux] will npm run build then go:embed SPA' -ForegroundColor Yellow
-        Build-Frontend
        Build-Go -OutFile "$AppName-linux-amd64" -GoOS 'linux' -GoArch 'amd64'
    }
    'build-darwin' {
-        Build-Frontend
        Build-Go -OutFile "$AppName-darwin-arm64" -GoOS 'darwin' -GoArch 'arm64'
    }
    'build-all' {
-        Build-Frontend
        Build-Go -OutFile $AppName -GoOS 'windows' -GoArch 'amd64'
        Build-Go -OutFile "$AppName-linux-amd64" -GoOS 'linux' -GoArch 'amd64'
        Build-Go -OutFile "$AppName-darwin-arm64" -GoOS 'darwin' -GoArch 'arm64'
--- a/cmd/jiang13/program.go
+++ b/cmd/jiang13/program.go
@@ -12,6 +12,7 @@ import (
 	"github.com/kardianos/service"

 	"git.iioio.com/freefire/jiang13-forum/config"
+	forumsvc "git.iioio.com/freefire/jiang13-forum/service"
 	"git.iioio.com/freefire/jiang13-forum/model"
 	"git.iioio.com/freefire/jiang13-forum/router"
 )
@@ -78,6 +79,9 @@ func (p *program) setup() error {
 	if err := model.InitDB(cfg.DBPath()); err != nil {
 		return fmt.Errorf("数据库初始化失败: %w", err)
 	}
+	if err := forumsvc.BackfillModerationNotifyRefs(); err != nil {
+		log.Printf("待审通知关联字段回填警告: %v", err)
+	}
 	if err := model.InitMonitorDB(cfg.MonitorDBPath()); err != nil {
 		return fmt.Errorf("监控库初始化失败: %w", err)
 	}
@@ -94,7 +98,11 @@ func (p *program) setup() error {
 	}

 	log.Printf("姜十三论坛已启动: http://localhost%s", addr)
-	log.Printf("后台管理地址: http://localhost%s/admin/dashboard", addr)
+	if cfg.DevMode {
+		log.Printf("前端开发服务器: http://localhost:5173 (后台管理: http://localhost:5173/admin/dashboard)")
+	} else {
+		log.Printf("前端由 Node 渲染服务器提供（默认 http://localhost:3000），本服务仅提供 API")
+	}
 	log.Printf("工作目录: %s", cfg.WorkPath)
 	log.Printf("配置文件: %s", cfg.ConfigFile)
 	log.Printf("数据目录: %s", cfg.DataDir)
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,17 +1,17 @@
-# 姜十三论坛 — Docker Compose 单服务部署
+# 姜十三论坛 — Docker Compose 双服务部署
+# 架构：web（Node :3000 对外：Vike SSR + 静态资源 + API 反代） → api（Go :3001 内部：纯 API + /data 数据卷）
 # 启动：docker compose up -d --build
 # 或：make compose-up / build.bat -Target compose-up

 services:
-  jiang13:
+  api:
    image: hangzhang714128/jiang13-forum:latest
    build:
      context: .
      dockerfile: Dockerfile
      args:
        VERSION: dev
-    ports:
-      - "3000:3000"
+    command: ["--work-path", "/app", "--data", "/data", "--port", "3001"]
    volumes:
      - jiang13-data:/data
      # 可选：挂载自定义 app.ini（只读）
@@ -20,10 +20,34 @@ services:
      TZ: Asia/Shanghai
      # 可选：固定 JWT 密钥（留空则自动生成并持久化到 /data/.jwt_secret）
      # JIANG13_JWT_SECRET: your-secret-here
+    expose:
+      - "3001"
    restart: unless-stopped
    stop_grace_period: 15s
    healthcheck:
-      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:3000/health"]
+      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3001/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 15s
+
+  web:
+    image: hangzhang714128/jiang13-forum:latest
+    entrypoint: ["node", "server/index.mjs"]
+    working_dir: /app/frontend
+    user: "1000:1000"
+    ports:
+      - "3000:3000"
+    environment:
+      TZ: Asia/Shanghai
+      PORT: "3000"
+      GO_API_URL: http://api:3001
+    depends_on:
+      api:
+        condition: service_healthy
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3000/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
      interval: 30s
      timeout: 5s
      retries: 3
--- a/docker-entrypoint.sh
+++ b/docker-entrypoint.sh
@@ -1,15 +1,16 @@
 #!/bin/sh
 set -e

+# api 容器入口：默认运行 Go API（web 容器在 compose 中以 node 用户直接覆盖 entrypoint）。
 # 宿主机 / 1Panel 挂载的 volume 常为 root 所有（uid 0），
-# 而应用以 jiang13（uid 1000）运行，需在启动时修正 /data 权限后降权。
+# 而应用以 uid 1000（node 镜像内置用户）运行，需在启动时修正 /data 权限后降权。

 DATA_DIR="/data"

 if [ "$(id -u)" = '0' ]; then
 	mkdir -p "$DATA_DIR"
-	chown -R jiang13:jiang13 "$DATA_DIR"
-	exec su-exec jiang13 /app/jiang13 "$@"
+	chown -R 1000:1000 "$DATA_DIR"
+	exec gosu 1000:1000 /app/jiang13 "$@"
 fi

 exec /app/jiang13 "$@"
--- a/docs/site-posts/README.md
+++ b/docs/site-posts/README.md
@@ -28,6 +28,14 @@

 访问路径：`/page/changelog`。

+## 部署指南（置顶帖）
+
+| 文件 | 标题 | 标签 | 操作 |
+| --- | --- | --- | --- |
+| [deployment-guide.md](./deployment-guide.md) | 从零开始部署姜十三论坛 | `部署` `教程` | **置顶**（可选精华） |
+
+覆盖：服务器选型、宝塔 / 1Panel、Docker / 二进制、域名 HTTPS、备份升级、常见问题。
+
 ## 可选短文

 若站务区希望不止一篇，见 [optional.md](./optional.md)：
--- a/docs/site-posts/changelog.md
+++ b/docs/site-posts/changelog.md
@@ -10,7 +10,7 @@

 Docker 镜像、Windows exe、Linux 单文件 **共用同一版本号**。有新版本时，以本页为准。

-**当前版本：1.1.6**（2026-09-01）
+**当前版本：1.1.8**（2026-09-02）

 ## 去哪看新版本

@@ -18,19 +18,19 @@ Docker 镜像、Windows exe、Linux 单文件 **共用同一版本号**。有新
 | --- | --- | --- |
 | 本页 | 版本号、变更说明、升级注意 | 本站 `/page/changelog` |
 | Docker | 镜像标签（`latest` 与 `1.1.x`） | [Docker Hub · Tags](https://hub.docker.com/r/hangzhang714128/jiang13-forum/tags) |
-| Windows / Linux | 预编译单文件（与 Docker 同版本） | [Gitea Releases](https://git.iioio.com/freefire/jiang13-forum/releases) |
+| Windows / Linux / macOS | 预编译单文件（与 Docker 同版本） | [Gitea Releases](https://git.iioio.com/freefire/jiang13-forum/releases) |
 | 源码 | 提交记录与自行编译 | [Gitea 仓库](https://git.iioio.com/freefire/jiang13-forum) |

-**1.1.6 直接下载：**
+**1.1.8 直接下载：**

- Windows x64：[jiang13-1.1.6-windows-amd64.exe](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.6/jiang13-1.1.6-windows-amd64.exe)
- Linux x64：[jiang13-1.1.6-linux-amd64](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.6/jiang13-1.1.6-linux-amd64)
- 校验文件：[SHA256SUMS.txt](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.6/SHA256SUMS.txt)
+- Windows x64：[jiang13_v1.1.8_windows-amd64.exe](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.8/jiang13_v1.1.8_windows-amd64.exe)
+- Linux x64：[jiang13_v1.1.8_linux-amd64](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.8/jiang13_v1.1.8_linux-amd64)
+- macOS arm64：[jiang13_v1.1.8_darwin-arm64](https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.8/jiang13_v1.1.8_darwin-arm64)

 拉取指定版本镜像：

 ```bash
-docker pull hangzhang714128/jiang13-forum:1.1.6
+docker pull hangzhang714128/jiang13-forum:1.1.8
 # 或始终跟随最新
 docker pull hangzhang714128/jiang13-forum:latest
 ```
@@ -47,7 +47,41 @@ Linux：赋予执行权限后放到原目录覆盖，同样保留 `data/` 与 `a

 ---

-## 1.1.6 — 2026-09-01
+## 📦 v1.1.8 · 2026-09-02
+
+表情选择与评论富文本展示完善，私信表情不再发成图片附件。
+
+**新增 / 调整**
+
+- 表情选择器在评论富文本中可直接插入，与文章编辑器一致
+- 私信页支持表情选择器，点击表情直接插入文本框
+
+**修复**
+
+- 私信中插入的表情改为文本内容发送，不再作为图片附件
+- 消息未读数在多端间同步更及时
+- 帖子详情快照逻辑修复，避免打开旧缓存页
+
+---
+
+## 📦 v1.1.7 · 2026-09-02
+
+私信与开源展柜体验升级，待审通知的审核态更及时。
+
+**新增 / 调整**
+
+- 私信改为飞书风布局：缩略图表情/图片、按会话草稿、用户搜索发起会话
+- 主页「发私信」直达消息页对应会话
+- 开源展柜改为目录式 UI，空列表不再粘滞
+- 消息页体验重构；待审通知打开后实时回填审核态
+
+**修复**
+
+- 帖子详情右栏默认头像改为深绿底白字，与列表默认头像配色一致
+
+---
+
+## 📦 v1.1.6 · 2026-09-01

 编辑器插入体验与首页默认 Feed 排序更合理。

@@ -63,7 +97,9 @@ Linux：赋予执行权限后放到原目录覆盖，同样保留 `data/` 与 `a

 - 帖子目录从正文同步派生，避免预取缓存竞态导致空树

-## 1.1.5 — 2026-09-01
+---
+
+## 📦 v1.1.5 · 2026-09-01

 首页首屏与交互更稳，Feed 排序语义更清楚。  
 本版起同时提供 **Docker 镜像** 与 **Windows / Linux 预编译单文件**（Gitea Release `v1.1.5`）。
@@ -84,30 +120,40 @@ Linux：赋予执行权限后放到原目录覆盖，同样保留 `data/` 与 `a
 - 帖行评论数、列表「共 N 条」右对齐；排序栏数字紧跟标签
 - 手机端 SSR 顶栏 / 页脚与 React 一致，减少闪动

-## 1.1.4 — 2026-08-31
+---
+
+## 📦 v1.1.4 · 2026-08-31

 网站监控的地理信息与口径更准确。

 - 补全 IP2Location（IP 地理位置库）中国城市中文名，同名城市按省消歧
 - 对齐监控概览「双通道」口径文案与诊断抽样说明

-## 1.1.3 — 2026-08-31
+---
+
+## 📦 v1.1.3 · 2026-08-31

 管理后台可看站点访问情况。

 - 新增管理端 **网站监控**：浏览量写入独立 `monitor.db`，与主库分开

-## 1.1.2 — 2026-08-31
+---
+
+## 📦 v1.1.2 · 2026-08-31

 可选接入官方社区展柜。

 - 可选社区上报，以及官方精选展柜（自建站可出现在官方社区列表中）

-## 1.1.1 — 2026-08-31
+---
+
+## 📦 v1.1.1 · 2026-08-31

 - 评论管理操作收进「更多」菜单，管理员界面更干净

-## 1.1.0 — 2026-08-30
+---
+
+## 📦 v1.1.0 · 2026-08-30

 一批社区功能与界面整理，版本号从 1.0 跨到 1.1。

@@ -134,7 +180,9 @@ Linux：赋予执行权限后放到原目录覆盖，同样保留 `data/` 与 `a
 - 页面双指缩放锁死，正文原图与灯箱仍可 pinch（捏合）放大
 - 单页正文排版与帖子详情对齐

-## 1.0.0 — 2026-08-23
+---
+
+## 📦 v1.0.0 · 2026-08-23

 首次发布 Docker 镜像 `hangzhang714128/jiang13-forum:1.0.0`。

--- a/docs/site-posts/deployment-guide.md
+++ b/docs/site-posts/deployment-guide.md
@@ -0,0 +1,244 @@
+# 从零开始部署姜十三论坛
+
+> 建议标题：从零开始部署姜十三论坛
+> 建议 slug：`deploy`
+> 建议操作：发布后设为「置顶」
+> 复制正文时：从下方第一个 `---` **之后**开始粘贴
+
+---
+
+## 为什么选姜十三
+
+单二进制 + 内置 SQLite，**不需要 MySQL、PHP、Redis**。面板（宝塔 / 1Panel）只是帮你更方便地管理，不是必须的。
+
+## 服务器选型
+
+| 部署方式 | CPU | 内存 | 磁盘 |
+| --- | --- | --- | --- |
+| 纯二进制（无面板） | 1 核 | 512MB | 10GB SSD |
+| 二进制 + 宝塔 | 1 核 | 1GB | 20GB SSD |
+| Docker + 1Panel | 2 核 | 2GB | 40GB SSD |
+
+> 推荐 Debian 12 / Ubuntu 22.04。建议直接上 2 核 2G。
+
+## 部署方式对比
+
+| | 1Panel + Docker | 宝塔 + 二进制 | 纯命令行 Docker |
+| --- | --- | --- | --- |
+| 适合 | 新手 / 还要跑其他容器 | 习惯宝塔 / 只跑这一个 | 熟悉 Linux / 资源紧张 |
+| 资源占用 | 较高（自带 Docker） | 低 | 最低 |
+| HTTPS | 面板一键 | 面板一键 | Caddy / certbot |
+| 备份 | 面板计划任务 | 面板计划任务 | `tar` 打包 |
+| 升级 | 面板点一下 | 替换二进制 | `docker pull` + 重启 |
+
+## 前置准备
+
+```bash
+apt update && apt upgrade -y
+apt install -y curl wget ca-certificates
+timedatectl set-timezone Asia/Shanghai
+```
+
+---
+
+## 方式一：1Panel + Docker
+
+### 1. 安装 1Panel
+
+```bash
+curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh \
+  -o quick_start.sh && bash quick_start.sh
+```
+
+- 安装目录：默认 `/opt`
+- 是否装 Docker：**y**（必须）
+- 面板端口 / 安全入口 / 账号密码自定义，记好
+
+安全组放行设置的端口，然后浏览器打开面板。
+
+### 2. 启动姜十三
+
+1Panel 面板 → 容器 → 创建：
+
+| 字段 | 值 |
+| --- | --- |
+| 镜像 | `hangzhang714128/jiang13-forum:latest` |
+| 端口 | `3000:3000` |
+| 数据卷 | 主机目录 → 容器内 **`/data`** |
+| 重启策略 | `unless-stopped` |
+
+浏览器访问 `http://IP:3000` → **首个注册用户自动成为管理员**。
+
+> 若容器报 `permission denied`：`chown -R 1000:1000 /数据目录`
+
+---
+
+## 方式二：宝塔 + 二进制
+
+### 1. 安装宝塔
+
+```bash
+# 正式版 13.0.0（含 AI，需绑定账号）
+if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh KZOqff1mn
+
+# 稳定版 12.0.0（纯净、免绑定）
+url=https://download.bt.cn/install/installStable_12.sh;if [ -f /usr/bin/curl ];then curl -sSO $url;else wget -O installStable_12.sh $url;fi;bash installStable_12.sh 5x59vxy56
+```
+
+安全组放行随机端口，浏览器打开（自签名证书提示 → 高级 → 继续前往）。
+
+### 2. 下载并注册服务
+
+```bash
+mkdir -p /opt/jiang13 && cd /opt/jiang13
+# 版本号以更新日志为准：https://bbs.iioio.com/page/update-log.html
+wget -O jiang13 https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.8/jiang13_v1.1.8_linux-amd64
+chmod +x jiang13
+
+# 注册为 systemd 服务（install 创建 unit 文件，start 启动，enable 开机自启）
+./jiang13 -service install
+./jiang13 -service start
+systemctl enable jiang13
+
+# 日常管理
+./jiang13 -service status    # 查看状态
+./jiang13 -service restart   # 重启
+
+# 验证
+curl http://127.0.0.1:3000/health
+```
+
+> 只是临时跑一下？直接 `./jiang13` 前台启动即可，Ctrl+C 停止，不用 `install`。
+
+### 2.1 升级二进制
+
+```bash
+cd /opt/jiang13
+./jiang13 -service stop
+wget -O jiang13.new https://git.iioio.com/freefire/jiang13-forum/releases/download/v新版本/jiang13_v新版本_linux-amd64
+mv jiang13.new jiang13 && chmod +x jiang13
+./jiang13 -service start
+```
+
+### 3. 宝塔反代 + SSL
+
+网站 → 添加站点（域名，PHP 选**纯静态**）→ 反向代理（目标 `http://127.0.0.1:3000`）→ SSL → Let's Encrypt 一键签发 → 强制 HTTPS。
+
+---
+
+## 方式三：纯 Docker
+
+```bash
+# 安装 Docker
+bash <(curl -sSL https://linuxmirrors.cn/docker.sh)
+
+# 启动姜十三
+docker run -d \
+  --name jiang13 \
+  -p 3000:3000 \
+  -v /opt/jiang13-data:/data \
+  --restart unless-stopped \
+  hangzhang714128/jiang13-forum:latest
+```
+
+或用 docker compose：
+
+```yaml
+services:
+  jiang13:
+    image: hangzhang714128/jiang13-forum:latest
+    ports: ["3000:3000"]
+    volumes: ["./data:/data"]
+    environment: {TZ: Asia/Shanghai}
+    restart: unless-stopped
+```
+
+```bash
+docker compose up -d
+```
+
+HTTPS 用 Caddy 最省心：
+
+```
+bbs.yourdomain.com {
+    reverse_proxy 127.0.0.1:3000
+}
+```
+
+Caddy 自动申请 Let's Encrypt。
+
+---
+
+## 域名 + HTTPS
+
+域名服务商添加 **A 记录**：`bbs` → 服务器公网 IP。
+
+| 方式 | HTTPS 操作 |
+| --- | --- |
+| 1Panel | 网站 → 创建 → 反向代理 → SSL → Let's Encrypt |
+| 宝塔 | 同上 |
+| 纯 Docker | Caddy 自动 / Nginx + certbot |
+
+---
+
+## 数据备份
+
+所有数据（SQLite + 上传 + JWT 密钥）都在**一个目录**里，备份 = 复制目录。
+
+| 方式 | 数据目录 |
+| --- | --- |
+| 1Panel Docker | 你映射的宿主机目录 |
+| 宝塔二进制 | 二进制同目录下 `data/` |
+| 纯 Docker | `-v` 映射的目录 |
+
+```bash
+tar -czf jiang13-backup-$(date +%Y%m%d).tar.gz /数据目录
+```
+
+> ⚠️ `data/.jwt_secret` 务必一起备份，丢了所有用户已登录的 cookie 会失效，需要重新输入密码登录（密码本身存 SQLite 里不受影响）。
+
+---
+
+## 版本升级
+
+版本号以 [更新日志](https://bbs.iioio.com/page/update-log.html) 为准。
+
+| 方式 | 升级 |
+| --- | --- |
+| 1Panel | 容器列表 → 选中 → 镜像更新 |
+| docker compose | `docker compose pull && docker compose up -d` |
+| 二进制 | 见上方「2.1 升级二进制」 |
+
+升级前先备份：`tar -czf backup.tar.gz /数据目录`
+
+---
+
+## 面板常用命令
+
+| 操作 | 宝塔 | 1Panel |
+| --- | --- | --- |
+| 菜单 | `bt` | `1pctl` |
+| 查入口 / 密码 | `bt default` | `1pctl user-info` |
+| 改密码 | `bt 14` | `1pctl update password` |
+| 重启面板 | `bt restart` | — |
+
+## 常见问题
+
+**Q：面板 / 网站打不开？** 安全组有没有放行对应端口？`netstat -tlnp | grep 端口` 看服务在不在监听。
+
+**Q：宝塔 vs 1Panel 怎么选？** 只跑姜十三 → 宝塔 + 二进制（省资源）；还要跑别的 → 1Panel。
+
+**Q：支持邮件 / SSO 吗？** 邮件 SMTP 和 OIDC SSO 都在**管理后台 → 系统设置**里配置。
+
+**Q：源码编译？** 见项目 README。推荐用预编译包。
+
+## 链接
+
+| 项目 | 地址 |
+| --- | --- |
+| 在线演示 | https://bbs.iioio.com/ |
+| 更新日志 | https://bbs.iioio.com/page/update-log.html |
+| Docker Hub | hangzhang714128/jiang13-forum |
+| 预编译下载 | https://git.iioio.com/freefire/jiang13-forum/releases |
+
+有问题欢迎本帖留言。
--- a/embed_static/embed.go
+++ b/embed_static/embed.go
@@ -1,118 +0,0 @@
-package embed_static
-
-import (
-	"embed"
-	"io/fs"
-	"net/http"
-	"regexp"
-	"strings"
-
-	"github.com/gin-gonic/gin"
-)
-
-//go:embed static/*
-var staticFS embed.FS
-
-var (
-	spaTitleRe        = regexp.MustCompile(`(?s)<title>.*?</title>`)
-	spaBrandTitleFn   func() string
-	spaBrandJSONFn    func() []byte // 站点品牌 JSON，注入 window.__J13_BRANDING__
-	spaBrandFaviconFn func() string // 站点 Favicon URL，注入 <link rel="icon">
-)
-
-// SetSPADocumentTitle 注册站点标题提供者，ServeSPA 会注入到入口 HTML，避免刷新闪烁
-func SetSPADocumentTitle(fn func() string) {
-	spaBrandTitleFn = fn
-}
-
-// SetSPABrandingJSON 注册品牌 JSON 提供者（须为合法 JSON 对象），供前端首屏同步读入
-func SetSPABrandingJSON(fn func() []byte) {
-	spaBrandJSONFn = fn
-}
-
-// SetSPAFaviconURL 注册 Favicon URL 提供者，注入到入口 HTML 的 <link rel="icon">
-func SetSPAFaviconURL(fn func() string) {
-	spaBrandFaviconFn = fn
-}
-
-// SetupEmbed 配置内嵌资源：React SPA 静态资源
-func SetupEmbed(r *gin.Engine) error {
-	if sub, err := fs.Sub(staticFS, "static/spa/assets"); err == nil {
-		fileServer := http.StripPrefix("/assets", http.FileServer(http.FS(sub)))
-		r.GET("/assets/*filepath", func(c *gin.Context) {
-			// 仅 200 写 immutable，避免中间层把旧 chunk 的 404 长期缓存
-			w := &cacheOnOKWriter{ResponseWriter: c.Writer, cacheControl: "public, max-age=31536000, immutable"}
-			c.Writer = w
-			fileServer.ServeHTTP(c.Writer, c.Request)
-		})
-	}
-
-	if sub, err := fs.Sub(staticFS, "static/spa/stickers"); err == nil {
-		fileServer := http.StripPrefix("/stickers", http.FileServer(http.FS(sub)))
-		r.GET("/stickers/*filepath", func(c *gin.Context) {
-			// stickers 不含哈希指纹，设置适中的缓存
-			c.Header("Cache-Control", "public, max-age=86400")
-			fileServer.ServeHTTP(c.Writer, c.Request)
-		})
-	}
-	return nil
-}
-
-// cacheOnOKWriter 仅在最终状态码为 200 时写入长期 Cache-Control
-type cacheOnOKWriter struct {
-	gin.ResponseWriter
-	cacheControl string
-	wroteHeader  bool
-}
-
-func (w *cacheOnOKWriter) WriteHeader(code int) {
-	if !w.wroteHeader {
-		w.wroteHeader = true
-		if code == http.StatusOK {
-			w.Header().Set("Cache-Control", w.cacheControl)
-		}
-	}
-	w.ResponseWriter.WriteHeader(code)
-}
-
-func (w *cacheOnOKWriter) Write(b []byte) (int, error) {
-	if !w.wroteHeader {
-		w.WriteHeader(http.StatusOK)
-	}
-	return w.ResponseWriter.Write(b)
-}
-
-// ServeSPA 返回 React SPA 入口（仅注入站点默认标题）
-func ServeSPA(c *gin.Context) {
-	ServeSPAWithMeta(c, nil)
-}
-
-// ServeSPANoIndex 返回带 noindex 的 SPA（登录/后台等私密页）
-func ServeSPANoIndex(c *gin.Context) {
-	title := ""
-	if spaBrandTitleFn != nil {
-		title = strings.TrimSpace(spaBrandTitleFn())
-	}
-	ServeSPAWithMeta(c, &SPAPageMeta{
-		Title:  title,
-		Robots: "noindex,nofollow",
-	})
-}
-
-// IsSPARoute 判断是否应由 SPA 处理
-func IsSPARoute(path string) bool {
-	if path == "/health" || path == "/robots.txt" || path == "/sitemap.xml" {
-		return false
-	}
-	if strings.HasPrefix(path, "/api") ||
-		strings.HasPrefix(path, "/admin") ||
-		strings.HasPrefix(path, "/uploads") ||
-		strings.HasPrefix(path, "/media") ||
-		strings.HasPrefix(path, "/assets") ||
-		strings.HasPrefix(path, "/stickers") ||
-		strings.HasPrefix(path, "/oauth") ||
-		strings.HasPrefix(path, "/.well-known") {
-		return false
-	}
-	return true
-}
--- a/embed_static/spa_meta.go
+++ b/embed_static/spa_meta.go
@@ -1,202 +0,0 @@
-package embed_static
-
-import (
-	"bytes"
-	"encoding/json"
-	"html"
-	"net/http"
-	"regexp"
-	"strings"
-
-	"github.com/gin-gonic/gin"
-)
-
-var spaRootEmptyRe = regexp.MustCompile(`(?s)<div id="root">\s*</div>`)
-
-// SPAPageMeta 注入到 SPA 入口 HTML 的 SEO / 社交预览元数据。
-// 默认不写 #root；首页/板块文档 SSR 可填 RootHTML / BootJSON。
-type SPAPageMeta struct {
-	Title       string // 完整 <title>
-	Description string
-	Keywords    string // meta keywords
-	Canonical   string
-	OGType      string // 默认 website
-	OGImage     string
-	SiteName    string // og:site_name
-	Locale      string // og:locale，默认 zh_CN
-	Robots      string // 如 noindex,nofollow
-	JSONLD      string // 已序列化的 JSON-LD 对象（不含 script 标签）
-	Status      int    // HTTP 状态码，0 视为 200
-	RootHTML    string // 可选：写入 #root 的首屏 HTML（首页文档 SSR）
-	BootJSON    []byte // 可选：window.__J13_HOME_BOOT__ 合法 JSON
-}
-
-// ServeSPAWithMeta 返回带页面级 meta / JSON-LD 的干净 SPA 入口
-func ServeSPAWithMeta(c *gin.Context, meta *SPAPageMeta) {
-	status := http.StatusOK
-	if meta != nil && meta.Status != 0 {
-		status = meta.Status
-	}
-	data, err := staticFS.ReadFile("static/spa/index.html")
-	if err != nil {
-		c.String(http.StatusNotFound, "前端未构建，请运行: cd frontend && npm run build")
-		return
-	}
-	data = applySPAPageMeta(data, meta)
-	// 入口 HTML 禁止缓存，否则发版后仍引用旧 chunk 哈希（部分反代对 no-cache 仍会存）
-	c.Header("Cache-Control", "no-cache, no-store, must-revalidate")
-	c.Header("Pragma", "no-cache")
-	c.Data(status, "text/html; charset=utf-8", data)
-}
-
-func applySPAPageMeta(data []byte, meta *SPAPageMeta) []byte {
-	if meta == nil {
-		meta = &SPAPageMeta{}
-	}
-
-	title := strings.TrimSpace(meta.Title)
-	if title == "" && spaBrandTitleFn != nil {
-		title = strings.TrimSpace(spaBrandTitleFn())
-	}
-	if title != "" {
-		escaped := html.EscapeString(title)
-		data = spaTitleRe.ReplaceAll(data, []byte("<title>"+escaped+"</title>"))
-	}
-
-	// —— 静态 SEO HTML（meta / OG / JSON-LD / favicon），紧跟 </title>，不经 JS ——
-	var seo strings.Builder
-	writeMeta(&seo, "description", meta.Description)
-	writeMeta(&seo, "keywords", meta.Keywords)
-	if canonical := strings.TrimSpace(meta.Canonical); canonical != "" {
-		seo.WriteString(`<link rel="canonical" href="` + html.EscapeString(canonical) + `"/>`)
-	}
-	if favicon := spaFaviconHref(); favicon != "" {
-		seo.WriteString(`<link rel="icon" href="` + html.EscapeString(favicon) + `"/>`)
-		seo.WriteString(`<link rel="shortcut icon" href="` + html.EscapeString(favicon) + `"/>`)
-	}
-	robots := strings.TrimSpace(meta.Robots)
-	if robots != "" {
-		writeMeta(&seo, "robots", robots)
-	}
-
-	ogType := strings.TrimSpace(meta.OGType)
-	if ogType == "" {
-		ogType = "website"
-	}
-	locale := strings.TrimSpace(meta.Locale)
-	if locale == "" {
-		locale = "zh_CN"
-	}
-	writeProp(&seo, "og:type", ogType)
-	writeProp(&seo, "og:site_name", meta.SiteName)
-	writeProp(&seo, "og:locale", locale)
-	writeProp(&seo, "og:title", firstNonEmpty(meta.Title, title))
-	writeProp(&seo, "og:description", meta.Description)
-	writeProp(&seo, "og:url", meta.Canonical)
-	writeProp(&seo, "og:image", meta.OGImage)
-	writeMetaName(&seo, "twitter:card", twitterCard(meta.OGImage))
-	writeMetaName(&seo, "twitter:title", firstNonEmpty(meta.Title, title))
-	writeMetaName(&seo, "twitter:description", meta.Description)
-	writeMetaName(&seo, "twitter:image", meta.OGImage)
-
-	if jsonld := strings.TrimSpace(meta.JSONLD); jsonld != "" {
-		// 常规 HTML 节点；仅转义 < 防止提前闭合，不是用 JS 写入
-		seo.WriteString(`<script type="application/ld+json">`)
-		seo.WriteString(string(bytes.ReplaceAll([]byte(jsonld), []byte("<"), []byte(`\u003c`))))
-		seo.WriteString(`</script>`)
-	}
-
-	if seo.Len() > 0 {
-		data = bytes.Replace(data, []byte("</title>"), []byte("</title>\n"+seo.String()), 1)
-	}
-
-	// —— 可执行 boot 脚本仍放在 </head> 前 ——
-	var boot strings.Builder
-	if s := spaBrandingBootScript(); s != "" {
-		boot.WriteString(s)
-	}
-	if s := spaHomeBootScript(meta.BootJSON); s != "" {
-		boot.WriteString(s)
-	}
-	if boot.Len() > 0 {
-		data = bytes.Replace(data, []byte("</head>"), []byte(boot.String()+"</head>"), 1)
-	}
-
-	if root := strings.TrimSpace(meta.RootHTML); root != "" {
-		data = injectSPARootHTML(data, root)
-	}
-
-	return data
-}
-
-// spaHomeBootScript 生成 window.__J13_HOME_BOOT__=...; 内联脚本（前端灌缓存，非 SEO）
-func spaHomeBootScript(raw []byte) string {
-	raw = bytes.TrimSpace(raw)
-	if len(raw) == 0 || !json.Valid(raw) {
-		return ""
-	}
-	safe := bytes.ReplaceAll(raw, []byte("<"), []byte(`\u003c`))
-	return "<script>window.__J13_HOME_BOOT__=" + string(safe) + ";</script>"
-}
-
-// injectSPARootHTML 将首屏 HTML 写入 #root（允许空白）
-func injectSPARootHTML(data []byte, rootHTML string) []byte {
-	return spaRootEmptyRe.ReplaceAll(data, []byte(`<div id="root">`+rootHTML+`</div>`))
-}
-
-// spaBrandingBootScript 生成 window.__J13_BRANDING__=...; 内联脚本
-func spaBrandingBootScript() string {
-	if spaBrandJSONFn == nil {
-		return ""
-	}
-	raw := bytes.TrimSpace(spaBrandJSONFn())
-	if len(raw) == 0 || !json.Valid(raw) {
-		return ""
-	}
-	safe := bytes.ReplaceAll(raw, []byte("<"), []byte(`\u003c`))
-	return "<script>window.__J13_BRANDING__=" + string(safe) + ";</script>"
-}
-
-func writeMeta(b *strings.Builder, name, content string) {
-	content = strings.TrimSpace(content)
-	if content == "" {
-		return
-	}
-	b.WriteString(`<meta name="` + html.EscapeString(name) + `" content="` + html.EscapeString(content) + `"/>`)
-}
-
-func writeMetaName(b *strings.Builder, name, content string) {
-	writeMeta(b, name, content)
-}
-
-func writeProp(b *strings.Builder, prop, content string) {
-	content = strings.TrimSpace(content)
-	if content == "" {
-		return
-	}
-	b.WriteString(`<meta property="` + html.EscapeString(prop) + `" content="` + html.EscapeString(content) + `"/>`)
-}
-
-func twitterCard(ogImage string) string {
-	if strings.TrimSpace(ogImage) != "" {
-		return "summary_large_image"
-	}
-	return "summary"
-}
-
-func firstNonEmpty(vals ...string) string {
-	for _, v := range vals {
-		if s := strings.TrimSpace(v); s != "" {
-			return s
-		}
-	}
-	return ""
-}
-
-// spaFaviconHref 当前站点配置的 Favicon（相对或绝对 URL）
-func spaFaviconHref() string {
-	if spaBrandFaviconFn == nil {
-		return ""
-	}
-	return strings.TrimSpace(spaBrandFaviconFn())
-}
--- a/frontend/components.json
+++ b/frontend/components.json
@@ -4,7 +4,7 @@
  "rsc": false,
  "tsx": true,
  "tailwind": {
-    "config": "tailwind.config.ts",
+    "config": "",
    "css": "src/styles/global.css",
    "baseColor": "neutral",
    "cssVariables": true,
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -1,48 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
-    <meta name="description" content="拾三一隅，自在交流" />
-    <title>姜十三论坛 - 拾三一隅，自在交流</title>
-    <!-- 样式由 Vite 构建注入外链 CSS，不在此内联 style -->
-    <script>
-      (function () {
-        var theme = localStorage.getItem('j13-theme') || 'light';
-        document.documentElement.classList.toggle('dark', theme === 'dark');
-        document.documentElement.style.colorScheme = theme;
-      })();
-    </script>
-    <script>
-      /* 锁死手机/平板双指与手势缩放；头像裁剪 / 图片灯箱放行 pinch */
-      (function () {
-        function inZoomAllowArea(target) {
-          return !!(
-            target &&
-            target.closest &&
-            target.closest('.avatar-crop-stage, .image-lightbox')
-          );
-        }
-        function blockGesture(e) {
-          if (inZoomAllowArea(e.target)) return;
-          if (e.cancelable) e.preventDefault();
-        }
-        function blockMultiTouch(e) {
-          if (e.touches && e.touches.length > 1) {
-            if (inZoomAllowArea(e.target)) return;
-            if (e.cancelable) e.preventDefault();
-          }
-        }
-        document.addEventListener('gesturestart', blockGesture, { passive: false });
-        document.addEventListener('gesturechange', blockGesture, { passive: false });
-        document.addEventListener('gestureend', blockGesture, { passive: false });
-        document.addEventListener('touchstart', blockMultiTouch, { passive: false });
-        document.addEventListener('touchmove', blockMultiTouch, { passive: false });
-      })();
-    </script>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -4,9 +4,10 @@
  "version": "1.0.0",
  "type": "module",
  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "preview": "vite preview"
+    "dev": "vike dev",
+    "build": "vike build",
+    "preview": "vike preview",
+    "start": "node server/index.mjs"
  },
  "dependencies": {
    "@dnd-kit/core": "^6.3.1",
@@ -21,7 +22,7 @@
    "@radix-ui/react-switch": "^1.3.0",
    "@svg-maps/china": "^2.0.0",
    "@svg-maps/world": "^2.0.0",
-    "@tanstack/react-virtual": "^3.11.2",
+    "@tailwindcss/vite": "^4.3.3",
    "@tiptap/core": "^3.26.1",
    "@tiptap/extension-code-block": "^3.26.1",
    "@tiptap/extension-image": "^3.26.1",
@@ -32,36 +33,44 @@
    "@tiptap/pm": "^3.26.1",
    "@tiptap/react": "^3.26.1",
    "@tiptap/starter-kit": "^3.26.1",
-    "autoprefixer": "^10.5.0",
    "class-variance-authority": "^0.7.1",
    "clsx": "^2.1.1",
+    "compression": "^1.8.1",
    "dayjs": "^1.11.13",
    "diff": "^9.0.0",
    "dompurify": "^3.4.10",
+    "express": "^5.2.1",
    "highlight.js": "^11.11.1",
+    "http-proxy-middleware": "^4.2.0",
+    "linkedom": "^0.18.13",
    "lucide-react": "^1.18.0",
    "marked": "^18.0.5",
-    "postcss": "^8.5.15",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
    "react-easy-crop": "^6.0.2",
    "react-hook-form": "^7.79.0",
-    "react-router-dom": "^6.28.0",
+    "react-router": "^8.3.1",
+    "react-streaming": "^0.4.20",
    "sonner": "^2.0.7",
    "tailwind-merge": "^3.6.0",
-    "tailwindcss": "^3.4.19",
-    "tailwindcss-animate": "^1.0.7",
+    "tailwindcss": "^4.3.3",
    "turndown": "^7.2.4",
+    "tw-animate-css": "^1.4.0",
+    "vike": "^0.4.266",
    "zod": "^4.4.3",
-    "zustand": "^4.5.7"
+    "zustand": "^5.0.15"
  },
  "devDependencies": {
+    "@types/express": "^5.0.6",
    "@types/node": "^25.9.3",
-    "@types/react": "^18.3.12",
-    "@types/react-dom": "^18.3.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.3",
    "@types/turndown": "^5.0.6",
-    "@vitejs/plugin-react": "^4.3.4",
-    "typescript": "^5.6.3",
-    "vite": "^5.4.11"
+    "@vitejs/plugin-react": "^6.1.1",
+    "typescript": "^7.0.2",
+    "vite": "^8.2.2"
+  },
+  "allowScripts": {
+    "esbuild@0.28.2": true
  }
 }
--- a/frontend/pages/+config.ts
+++ b/frontend/pages/+config.ts
@@ -0,0 +1,12 @@
+import type { Config } from 'vike/types';
+
+export default {
+  // pageProps / data（+data 返回的 boot / snapshot / head）透传给客户端供 hydrate seed
+  passToClient: ['pageProps', 'data'],
+  // 自定义集成（无 vike-react）：声明 `ssr` 配置供页面 +ssr.ts 使用（SPA 壳页 ssr: false）
+  meta: {
+    ssr: {
+      env: { server: true },
+    },
+  },
+} satisfies Config;
--- a/frontend/pages/_error/+Page.tsx
+++ b/frontend/pages/_error/+Page.tsx
@@ -0,0 +1,10 @@
+import App from '../../src/App';
+import type { PageContext } from 'vike/types';
+
+export { Page };
+
+/** 错误页：复用 App 壳层与路由树 —— /post/:id 未找到渲染帖子自己的未找到态，未知路径渲染 catch-all NotFoundPage */
+function Page(pageContext: PageContext & { url?: string }) {
+  const url = pageContext.url ?? pageContext.urlOriginal ?? '/';
+  return <App url={url} />;
+}
--- a/frontend/pages/_error/+data.ts
+++ b/frontend/pages/_error/+data.ts
@@ -0,0 +1,24 @@
+import type { PageContextServer } from 'vike/types';
+import type { FeedData } from '../../src/ssr/feedSeed';
+
+export { data };
+
+type NotFoundAbortReason = {
+  head?: FeedData['head'];
+  boot?: FeedData['boot'];
+};
+
+/**
+ * 错误页取数：feed +data 未找到（帖子/板块）时 throw render(404, { head, boot })，
+ * 壳层数据经 abortReason 带过来，保证 404 页也渲染完整站点壳与 noindex head。
+ */
+async function data(pageContext: PageContextServer): Promise<FeedData> {
+  if (!import.meta.env.SSR) return { kind: 'notfound' };
+
+  const reason = pageContext.abortReason as NotFoundAbortReason | undefined;
+  return {
+    kind: 'notfound',
+    head: reason?.head,
+    boot: reason?.boot,
+  };
+}
--- a/frontend/pages/feed/+Page.tsx
+++ b/frontend/pages/feed/+Page.tsx
@@ -0,0 +1,11 @@
+import App from '../../src/App';
+import type { PageContext } from 'vike/types';
+
+export { Page };
+
+/** SSR feed 页：服务端渲染整棵 react-router 树，客户端 hydrate 后接管导航 */
+function Page(pageContext: PageContext & { url?: string }) {
+  // onRenderHtml 透传 url（pathname + search）；urlOriginal 兜底（含 query）
+  const url = pageContext.url ?? pageContext.urlOriginal ?? '/';
+  return <App url={url} />;
+}
--- a/frontend/pages/feed/+data.ts
+++ b/frontend/pages/feed/+data.ts
@@ -0,0 +1,9 @@
+import type { PageContextServer } from 'vike/types';
+import { loadFeedData } from '../../src/ssr/feedData';
+
+export { data };
+
+// SSR 白名单页（/ 、/board/:id 、/post/:id）服务端取数 + head 构建
+async function data(pageContext: PageContextServer) {
+  return await loadFeedData(pageContext);
+}
--- a/frontend/pages/feed/+route.ts
+++ b/frontend/pages/feed/+route.ts
@@ -0,0 +1,11 @@
+import type { PageContext } from 'vike/types';
+import { matchFeedSsrPath } from '../../src/ssr/feedPaths';
+
+export { route };
+
+/** SSR 白名单：`/`、`/board/:id`、`/post/:id`（含 `.html` 伪静态） */
+function route(pageContext: PageContext) {
+  const match = matchFeedSsrPath(pageContext.urlPathname);
+  if (!match) return false;
+  return { routeParams: { kind: match.kind, id: match.id } };
+}
--- a/frontend/pages/spa/+Page.tsx
+++ b/frontend/pages/spa/+Page.tsx
@@ -0,0 +1,8 @@
+import App from '../../src/App';
+
+export { Page };
+
+/** SPA 壳页：客户端整树挂载 react-router（服务端不执行本组件） */
+function Page() {
+  return <App />;
+}
--- a/frontend/pages/spa/+route.ts
+++ b/frontend/pages/spa/+route.ts
@@ -0,0 +1,10 @@
+import type { PageContext } from 'vike/types';
+import { matchFeedSsrPath } from '../../src/ssr/feedPaths';
+
+export { route };
+
+/** catch-all：SSR feed 白名单之外的一切 URL */
+function route(pageContext: PageContext) {
+  if (matchFeedSsrPath(pageContext.urlPathname)) return false;
+  return { routeParams: {} };
+}
--- a/frontend/pages/spa/+ssr.ts
+++ b/frontend/pages/spa/+ssr.ts
@@ -0,0 +1,4 @@
+export { ssr };
+
+/** SPA 壳：服务端只出空壳 HTML，客户端整树挂载 react-router */
+const ssr = false;
--- a/frontend/postcss.config.js
+++ b/frontend/postcss.config.js
@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};
--- a/frontend/renderer/+onRenderClient.tsx
+++ b/frontend/renderer/+onRenderClient.tsx
@@ -0,0 +1,98 @@
+import { StrictMode } from 'react';
+import type { ComponentType } from 'react';
+import { hydrateRoot, createRoot } from 'react-dom/client';
+import type { PageContextClient } from 'vike/types';
+import { applyTheme, getStoredTheme } from '../src/utils/theme';
+import { installZoomGuard } from '../src/utils/zoomGuard';
+import { beginHomeHydrate } from '../src/utils/homeHydrate';
+import { reloadForStaleChunk } from '../src/utils/chunkLoad';
+import { seedFeedData, type FeedData } from '../src/ssr/feedSeed';
+import { ensureColdBootReady, isMainLayoutPath } from '../src/utils/prefetchRoute';
+
+export { onRenderClient };
+
+type PageComponent = ComponentType<{ url?: string }>;
+
+let root: ReturnType<typeof createRoot> | null = null;
+
+function waitForStylesheets(): Promise<void> {
+  const links = Array.from(document.querySelectorAll('link[rel="stylesheet"]'));
+  if (links.length === 0) return Promise.resolve();
+  return Promise.all(
+    links.map(
+      (node) =>
+        new Promise<void>((resolve) => {
+          const link = node as HTMLLinkElement;
+          try {
+            if (link.sheet) {
+              resolve();
+              return;
+            }
+          } catch {
+            /* cross-origin */
+          }
+          const finish = () => resolve();
+          link.addEventListener('load', finish, { once: true });
+          link.addEventListener('error', finish, { once: true });
+        }),
+    ),
+  ).then(() => undefined);
+}
+
+async function onRenderClient(pageContext: PageContextClient) {
+  applyTheme(getStoredTheme());
+  installZoomGuard();
+  // hydrate 前把 +data 结果 seed 进客户端缓存（与服务端渲染前 seed 同构，保证首帧一致）
+  if (pageContext.isHydration) {
+    seedFeedData((pageContext as { data?: FeedData }).data);
+  }
+
+  // Vite modulepreload / 动态 import 失败（发版后旧 hashed URL 404）
+  window.addEventListener('vite:preloadError', (event) => {
+    event.preventDefault();
+    reloadForStaleChunk();
+  });
+
+  const el = document.getElementById('root');
+  if (!el) return;
+
+  // 有 SSR 正文 → hydrate 接管同一 DOM（首帧数据已由 +data seed，无需冷启动预热）；
+  // SPA 壳 / SSR 降级空壳 → createRoot 挂载，挂载前先冷启动预热，避免空白首帧
+  const hydrating = pageContext.isHydration && el.innerHTML.trim() !== '';
+
+  // 仅非 hydrate 路径需要冷启动：SSR 页 seed 已灌入缓存，冷启动只会重复请求并阻塞 hydrate
+  if (!hydrating && isMainLayoutPath(window.location.pathname)) {
+    const path = `${window.location.pathname}${window.location.search}`;
+    await ensureColdBootReady(path);
+  }
+
+  await waitForStylesheets();
+  try {
+    if (document.fonts?.ready) await document.fonts.ready;
+  } catch {
+    /* ignore */
+  }
+
+  if (hydrating) beginHomeHydrate();
+
+  const Page = pageContext.Page as PageComponent;
+  const app = (
+    <StrictMode>
+      <Page />
+    </StrictMode>
+  );
+
+  if (hydrating) {
+    try {
+      hydrateRoot(el, app);
+    } catch (err) {
+      console.warn('[j13] hydrateRoot 失败，回退 createRoot', err);
+      el.innerHTML = '';
+      if (!root) root = createRoot(el);
+      root.render(app);
+    }
+  } else {
+    if (!root) root = createRoot(el);
+    root.render(app);
+  }
+}
--- a/frontend/renderer/+onRenderHtml.tsx
+++ b/frontend/renderer/+onRenderHtml.tsx
@@ -0,0 +1,78 @@
+import type { ComponentType, ReactElement } from 'react';
+import { renderToReadableStream } from 'react-dom/server';
+import { escapeInject, dangerouslySkipEscape } from 'vike/server';
+import type { PageContextServer } from 'vike/types';
+import { createHomeStore } from '../src/store/homeStore';
+import { createRequestScope } from '../src/ssr/scopeTypes';
+import { runWithScope } from '../src/ssr/scope';
+import { seedFeedData, type FeedData } from '../src/ssr/feedSeed';
+import { renderHeadTags } from '../src/ssr/head';
+import { installServerDom } from '../src/ssr/serverDom';
+import { readThemeFromCookie } from '../src/utils/theme';
+import { createSsrApp } from '../src/App';
+
+// 服务端 DOM polyfill：内容处理依赖 DOMParser/document，须在渲染前安装
+installServerDom();
+
+export { onRenderHtml };
+
+type PageComponent = ComponentType<{ url?: string }>;
+
+/** 等 lazy 页面全部渲染完成（allReady）后缓冲为完整 HTML，首字节语义与旧 Go 文档级 SSR 一致 */
+async function renderPageToString(element: ReactElement): Promise<string> {
+  const stream = await renderToReadableStream(element, {
+    onError(err) {
+      console.error('[j13] SSR 渲染错误:', err);
+    },
+  });
+  await stream.allReady;
+  return new Response(stream).text();
+}
+
+async function onRenderHtml(pageContext: PageContextServer) {
+  const Page = pageContext.Page as PageComponent | undefined;
+  const data = (pageContext as { data?: FeedData }).data;
+
+  let pageHtml = '';
+  if (Page) {
+    // SSR feed 页：per-request 作用域 + hydrate 同构变体；渲染失败降级空壳（客户端自行接管），不 500
+    const { pathname, searchOriginal } = pageContext.urlParsed;
+    const url = pathname + (searchOriginal ?? '');
+    const scope = createRequestScope(createHomeStore(), url);
+    scope.hydrating = true;
+    try {
+      pageHtml = await runWithScope(scope, async () => {
+        // 渲染前把 +data 取回的数据 seed 进请求作用域（缓存层按 scope 隔离）
+        seedFeedData(data);
+        // 官方 SSR 路径：await 首导航后 StaticRouterProvider 同步渲染（避免 RouterProvider suspend
+        // 导致内容落入 <div hidden>，禁 JS 爬虫不可见）
+        const app = await createSsrApp(url);
+        return renderPageToString(app);
+      });
+    } catch (err) {
+      console.error('[j13] SSR 渲染失败，降级 SPA 壳:', err);
+      pageHtml = '';
+    }
+  }
+
+  const headTags = renderHeadTags(data?.head);
+
+  // 主题从请求 Cookie 读取，首帧直接渲染到 <html> 上（深色用户无白屏闪烁，无需内联脚本）
+  // headersOriginal 经 Vike 归一化为 pageContext.headers（键全小写）
+  const cookieHeader = (pageContext as { headers?: Record<string, string> | null }).headers?.cookie;
+  const dark = readThemeFromCookie(cookieHeader) === 'dark';
+  const htmlAttrs = dark ? ' class="dark" style="color-scheme:dark"' : '';
+
+  // 404/301 等状态码由 Vike abort 机制（throw render/redirect）原生处理
+  return escapeInject`<!DOCTYPE html>
+<html lang="zh-CN"${dangerouslySkipEscape(htmlAttrs)}>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
+    ${dangerouslySkipEscape(headTags)}
+  </head>
+  <body>
+    <div id="root">${dangerouslySkipEscape(pageHtml)}</div>
+  </body>
+</html>`;
+}
--- a/frontend/scripts/extract-lucide-paths.mjs
+++ b/frontend/scripts/extract-lucide-paths.mjs
@@ -1,60 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-const iconsDir = path.join('node_modules/lucide-react/dist/esm/icons');
-const names = [
-  'search', 'house', 'star', 'folder-git-2', 'link-2', 'earth', 'file-text',
-  'message-circle', 'tags', 'moon', 'clock', 'badge-check', 'sliders-horizontal',
-  'plus', 'sun', 'mail', 'calendar-check', 'check', 'gift', 'panel-right',
-  'user-plus', 'layout-dashboard',
-  'code-2', 'coffee', 'help-circle', 'message-square', 'lightbulb', 'book-open',
-  'gamepad-2', 'palette', 'music', 'camera', 'heart', 'zap', 'globe', 'users',
-  'briefcase', 'graduation-cap', 'shopping-bag', 'map-pin', 'megaphone', 'flame',
-  'folder', 'wrench', 'cpu',
-];
-
-function esc(v) {
-  return String(v).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-}
-
-function nodeToInner(nodes) {
-  return nodes.map(([tag, attrs]) => {
-    let s = `<${tag}`;
-    for (const [k, v] of Object.entries(attrs)) {
-      if (k === 'key') continue;
-      s += ` ${k}="${esc(v)}"`;
-    }
-    return `${s}/>`;
-  }).join('');
-}
-
-function resolveIconFile(name) {
-  let f = path.join(iconsDir, `${name}.mjs`);
-  let src = fs.readFileSync(f, 'utf8');
-  const re = src.match(/export \{ default \} from '\.\/([^']+)';/);
-  if (re) {
-    f = path.join(iconsDir, re[1]);
-    src = fs.readFileSync(f, 'utf8');
-  }
-  return { f, src };
-}
-
-const out = {};
-for (const n of names) {
-  try {
-    const { src } = resolveIconFile(n);
-    const m = src.match(/const __iconNode = (\[[\s\S]*?\]);/);
-    if (!m) {
-      console.error('no node', n);
-      continue;
-    }
-    // eslint-disable-next-line no-eval
-    const nodes = eval(m[1]);
-    out[n] = nodeToInner(nodes);
-  } catch (e) {
-    console.error('fail', n, e.message);
-  }
-}
-
-fs.writeFileSync('tmp-lucide-paths.json', JSON.stringify(out, null, 2));
-console.log('wrote', Object.keys(out).length, 'icons');
--- a/frontend/scripts/gen-ssr-icons.mjs
+++ b/frontend/scripts/gen-ssr-icons.mjs
@@ -1,168 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-const paths = JSON.parse(fs.readFileSync('tmp-lucide-paths.json', 'utf8'));
-
-function splitInner(inner) {
-  const tags = [];
-  const re = /<([a-z]+)([^>]*)\/>/g;
-  let m;
-  while ((m = re.exec(inner))) {
-    tags.push(`<${m[1]}${m[2]}/>`);
-  }
-  return tags;
-}
-
-function goFunc(name, size, key, className = '') {
-  const tags = splitInner(paths[key]);
-  const lines = tags.map((t) => `\t\t\`${t}\`,`).join('\n');
-  if (className) {
-    return `func ${name}() string {\n\treturn ssrSVGWithClass(${size}, "${className}",\n${lines}\n\t)\n}\n\n`;
-  }
-  return `func ${name}() string {\n\treturn ssrSVG(${size},\n${lines}\n\t)\n}\n\n`;
-}
-
-const boardKeys = [
-  'code-2', 'coffee', 'help-circle', 'message-square', 'lightbulb', 'book-open',
-  'gamepad-2', 'palette', 'music', 'camera', 'heart', 'zap', 'globe', 'users',
-  'briefcase', 'graduation-cap', 'shopping-bag', 'map-pin', 'megaphone', 'flame',
-  'star', 'folder', 'wrench', 'cpu',
-];
-const defaults = [
-  'code-2', 'coffee', 'help-circle', 'message-square',
-  'lightbulb', 'book-open', 'gamepad-2', 'palette',
-];
-
-let out = `package handler
-
-import (
-\t"strconv"
-\t"strings"
-\t"time"
-)
-
-// 内联 SVG：path 对齐 lucide-react@1.18（由 scripts/extract-lucide-paths.mjs 抽取）
-
-func ssrSVG(size int, paths ...string) string {
-\treturn ssrSVGWithClass(size, "", paths...)
-}
-
-func ssrSVGWithClass(size int, className string, paths ...string) string {
-\tvar b strings.Builder
-\tb.WriteString(\`<svg xmlns="http://www.w3.org/2000/svg" width="\`)
-\tb.WriteString(strconv.Itoa(size))
-\tb.WriteString(\`" height="\`)
-\tb.WriteString(strconv.Itoa(size))
-\tb.WriteString(\`" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"\`)
-\tif className != "" {
-\t\tb.WriteString(\` class="\`)
-\t\tb.WriteString(className)
-\t\tb.WriteString(\`"\`)
-\t}
-\tb.WriteString(\` aria-hidden="true">\`)
-\tfor _, p := range paths {
-\t\tb.WriteString(p)
-\t}
-\tb.WriteString(\`</svg>\`)
-\treturn b.String()
-}
-
-`;
-
-out += goFunc('ssrIconSearch', 16, 'search', 'header-search-icon');
-out += goFunc('ssrIconSliders', 15, 'sliders-horizontal');
-out += goFunc('ssrIconPlus', 16, 'plus');
-out += goFunc('ssrIconMoon', 18, 'moon');
-out += goFunc('ssrIconSun', 18, 'sun');
-out += goFunc('ssrIconMail', 18, 'mail');
-out += goFunc('ssrIconHome', 18, 'house');
-out += goFunc('ssrIconStar', 18, 'star');
-out += goFunc('ssrIconFolderGit', 18, 'folder-git-2');
-out += goFunc('ssrIconLink2', 18, 'link-2');
-out += goFunc('ssrIconEarth', 18, 'earth');
-out += goFunc('ssrIconFileText', 18, 'file-text');
-out += goFunc('ssrIconLayoutDashboard', 18, 'layout-dashboard');
-out += goFunc('ssrIconMessageCircle', 16, 'message-circle');
-out += goFunc('ssrIconClock', 16, 'clock');
-out += goFunc('ssrIconBadgeCheck', 16, 'badge-check');
-out += goFunc('ssrIconTags', 16, 'tags');
-out += goFunc('ssrIconUserPlus', 16, 'user-plus');
-out += goFunc('ssrIconCalendarCheck', 18, 'calendar-check');
-out += goFunc('ssrIconCheck', 18, 'check');
-out += goFunc('ssrIconGift', 15, 'gift');
-out += goFunc('ssrIconPanelRight', 18, 'panel-right');
-
-out += '// 板块图标 path（key 对齐 BOARD_ICON_OPTIONS / AllowedBoardIcons）\nvar ssrBoardIconInner = map[string]string{\n';
-for (const k of boardKeys) {
-  out += `\t"${k}": \`${paths[k]}\`,\n`;
-}
-out += '}\n\n';
-
-out += '// 与前端 DEFAULT_ICONS 顺序一致（按 themeIndex 回退）\nvar ssrBoardDefaultIcons = []string{\n';
-for (const k of defaults) {
-  out += `\t"${k}",\n`;
-}
-out += '}\n\n';
-
-out += `// ssrBoardIconSVG 输出板块 Lucide 图标；class 打在 svg 上（与 React BoardIconDisplay 一致）
-func ssrBoardIconSVG(icon string, themeIndex int, className string) string {
-\tkey := strings.TrimSpace(strings.ToLower(icon))
-\tinner, ok := ssrBoardIconInner[key]
-\tif !ok || inner == "" {
-\t\tif themeIndex < 0 {
-\t\t\tthemeIndex = 0
-\t\t}
-\t\tkey = ssrBoardDefaultIcons[themeIndex%len(ssrBoardDefaultIcons)]
-\t\tinner = ssrBoardIconInner[key]
-\t}
-\treturn ssrSVGWithClass(18, className, inner)
-}
-
-// formatSSRRelativeTime 与前端 formatTime 同规则
-func formatSSRRelativeTime(t time.Time) string {
-\tif t.IsZero() {
-\t\treturn ""
-\t}
-\tnow := time.Now()
-\tdiffSec := now.Sub(t).Seconds()
-\tif diffSec < 0 {
-\t\tdiffSec = 0
-\t}
-\tif diffSec < 60 {
-\t\treturn "刚刚"
-\t}
-\tif diffSec < 3600 {
-\t\treturn strconv.Itoa(int(diffSec/60)) + "分钟前"
-\t}
-\tif diffSec < 86400 {
-\t\treturn strconv.Itoa(int(diffSec/3600)) + "小时前"
-\t}
-\tdiffDay := int(diffSec / 86400)
-\tif diffDay < 30 {
-\t\treturn strconv.Itoa(diffDay) + "天前"
-\t}
-\tif t.Year() == now.Year() {
-\t\treturn strconv.Itoa(int(t.Month())) + "月" + strconv.Itoa(t.Day()) + "日"
-\t}
-\treturn strconv.Itoa(t.Year()) + "年" + strconv.Itoa(int(t.Month())) + "月" + strconv.Itoa(t.Day()) + "日"
-}
-
-// formatSSRShortDateTime 与前端 formatShortDateTime 同规则（MM-DD HH:mm）
-func formatSSRShortDateTime(t time.Time) string {
-\tif t.IsZero() {
-\t\treturn ""
-\t}
-\tlocal := t.Local()
-\tpad := func(n int) string {
-\t\tif n < 10 {
-\t\t\treturn "0" + strconv.Itoa(n)
-\t\t}
-\t\treturn strconv.Itoa(n)
-\t}
-\treturn pad(int(local.Month())) + "-" + pad(local.Day()) + " " + pad(local.Hour()) + ":" + pad(local.Minute())
-}
-`;
-
-const outPath = path.join('..', 'handler', 'ssr_icons.go');
-fs.writeFileSync(outPath, out);
-console.log('wrote', outPath, Object.keys(paths).length, 'icons');
--- a/frontend/server/index.mjs
+++ b/frontend/server/index.mjs
@@ -0,0 +1,121 @@
+/**
+ * Node 渲染服务器（生产模式）。
+ *
+ * 双进程架构对外单点：
+ * - Node :3000 —— 前端静态资源 + Vike SSR（/、/board/:id、/post/:id 真渲染，其余 SPA 壳）
+ * - Go   :3001 —— 纯 API（/api、/uploads、/media、/oauth、robots/sitemap/favicon 反代至此）
+ *
+ * dev 模式不经过本文件：`npm run dev`（vike dev :5173）+ Go dev（API :3000）。
+ */
+import { Readable } from 'node:stream';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fs from 'node:fs';
+import express from 'express';
+import compression from 'compression';
+import { createProxyMiddleware } from 'http-proxy-middleware';
+
+// 本文件仅用于生产（dev 走 `vike dev`）；须在加载 vike/server 前定型环境
+process.env.NODE_ENV ??= 'production';
+const { renderPage } = await import('vike/server');
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(__dirname, '..');
+const distClient = path.join(root, 'dist', 'client');
+
+const port = Number(process.env.PORT || 3000);
+const goApiUrl = process.env.GO_API_URL || 'http://127.0.0.1:3001';
+
+/** 反代到 Go 的前缀（对齐旧 Go ServePublicSPA 的资源分发面） */
+const GO_PROXY_PREFIXES = [
+  '/api',
+  '/uploads',
+  '/media',
+  '/oauth',
+  '/.well-known',
+  '/robots.txt',
+  '/sitemap.xml',
+  '/favicon.ico',
+];
+
+if (!fs.existsSync(distClient)) {
+  console.error(`[j13-web] 未找到构建产物 ${distClient}，请先执行 npm run build`);
+  process.exit(1);
+}
+
+const app = express();
+app.disable('x-powered-by');
+app.use(compression());
+
+// Node 自身探活（不依赖 Go，供容器健康检查）
+app.get('/healthz', (_req, res) => {
+  res.status(200).send('ok');
+});
+
+// Go 反代：透传 method/headers/body；xfwd 附加 X-Forwarded-*，供 Go 推导站点 base URL。
+// express app.use(prefix) 会剥掉挂载前缀（req.url 不含 prefix），故 target 须补回对应前缀
+for (const prefix of GO_PROXY_PREFIXES) {
+  app.use(
+    prefix,
+    createProxyMiddleware({
+      target: `${goApiUrl}${prefix}`,
+      xfwd: true,
+    }),
+  );
+}
+
+// 前端静态资源：dist/client（含 /assets 与 /stickers），assets 带 contenthash → immutable；
+// HTML 用 no-cache（每次协商），避免 no-store/max-age=0 导致浏览器丢弃历史滚动状态（F5 不恢复位置）
+app.use(
+  express.static(distClient, {
+    cacheControl: false, // 关闭 send 自动写入的 Cache-Control，统一由 setHeaders 决定
+    setHeaders(res, filePath) {
+      if (filePath.includes(`${path.sep}assets${path.sep}`)) {
+        res.setHeader('Cache-Control', 'public, max-age=31536000, immutable');
+      } else {
+        res.setHeader('Cache-Control', 'no-cache');
+      }
+    },
+  }),
+);
+
+// 其余路径交给 Vike：feed 页 SSR 文档，spa 页输出壳（客户端接管）
+app.use(async (req, res, next) => {
+  try {
+    const pageContext = await renderPage({
+      urlOriginal: req.originalUrl,
+      headersOriginal: req.headers,
+    });
+    const { httpResponse } = pageContext;
+    if (!httpResponse) return next();
+
+    const { statusCode, headers, body } = httpResponse;
+    res.statusCode = statusCode;
+    for (const [name, value] of headers) res.setHeader(name, value);
+    // Vike 默认对 HTML 发 no-store：会使浏览器丢弃该历史条目的滚动恢复状态（F5 回到顶部）。
+    // 改为 no-cache：文档仍每次重新验证/渲染，但保留浏览器原生 scroll restoration。
+    res.setHeader('Cache-Control', 'no-cache');
+    if (typeof body === 'string') {
+      res.send(body);
+    } else {
+      Readable.fromWeb(body).pipe(res);
+    }
+  } catch (err) {
+    // feedData/onRenderHtml 已内置降级（Go 不可达 → SPA 壳），此处仅兜 renderPage 本身的异常
+    console.error('[j13-web] renderPage 失败:', err);
+    if (!res.headersSent) {
+      res
+        .status(500)
+        .type('html')
+        .send(
+          '<!DOCTYPE html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>服务器错误</title><body><p>页面渲染失败，请刷新重试。</p></body></html>',
+        );
+    } else {
+      res.end();
+    }
+  }
+});
+
+app.listen(port, () => {
+  console.log(`[j13-web] Node 渲染服务器已启动: http://localhost:${port} (Go API: ${goApiUrl})`);
+});
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -1,114 +1,43 @@
-import { Suspense } from 'react';
-import {
-  createBrowserRouter,
-  createRoutesFromElements,
-  RouterProvider,
-  Route,
-  Navigate,
-} from 'react-router-dom';
-import './styles/global.css';
-import { AuthProvider } from './hooks/useAuth';
-import { ThemeProvider } from './hooks/useTheme';
-import MainLayout from './layouts/MainLayout';
-import AdminLayout from './layouts/AdminLayout';
-import ErrorBoundary from './components/ErrorBoundary';
-import AppRouteError from './components/AppRouteError';
-import PageLoader from './components/PageLoader';
-import AuthPageFallback from './components/AuthPageFallback';
-import { Toaster } from './components/ui/sonner';
-import PullToRefresh from './components/PullToRefresh';
-import TopProgressBar from './components/TopProgressBar';
-import { lazyWithRetry } from './utils/lazyWithRetry';
+import { BrowserRouter, StaticRouter, useRoutes } from 'react-router';
+import AppShell from './AppShell';
+import { appRoutes } from './AppRoutes';

-const HomePage = lazyWithRetry(() => import('./pages/HomePage'));
-const PostDetailPage = lazyWithRetry(() => import('./pages/PostDetailPage'));
-const LoginPage = lazyWithRetry(() => import('./pages/LoginPage'));
-const RegisterPage = lazyWithRetry(() => import('./pages/RegisterPage'));
-const ForgotPasswordPage = lazyWithRetry(() => import('./pages/ForgotPasswordPage'));
-const ComposePage = lazyWithRetry(() => import('./pages/ComposePage'));
-const BoardsManagePage = lazyWithRetry(() => import('./pages/BoardsManagePage'));
-const ProfilePage = lazyWithRetry(() => import('./pages/ProfilePage'));
-const UserProfilePage = lazyWithRetry(() => import('./pages/UserProfilePage'));
-const FavoritesPage = lazyWithRetry(() => import('./pages/FavoritesPage'));
-const MessagesPage = lazyWithRetry(() => import('./pages/MessagesPage'));
-const ProjectsPage = lazyWithRetry(() => import('./pages/ProjectsPage'));
-const LinksPage = lazyWithRetry(() => import('./pages/LinksPage'));
-const ShowcasePage = lazyWithRetry(() => import('./pages/ShowcasePage'));
-const AdminDashboardPage = lazyWithRetry(() => import('./pages/admin/AdminDashboardPage'));
-const AdminPostsPage = lazyWithRetry(() => import('./pages/admin/AdminPostsPage'));
-const AdminCommentsPage = lazyWithRetry(() => import('./pages/admin/AdminCommentsPage'));
-const AdminReportsPage = lazyWithRetry(() => import('./pages/admin/AdminReportsPage'));
-const AdminUsersPage = lazyWithRetry(() => import('./pages/admin/AdminUsersPage'));
-const AdminBadgesPage = lazyWithRetry(() => import('./pages/admin/AdminBadgesPage'));
-const AdminMediaPage = lazyWithRetry(() => import('./pages/admin/AdminMediaPage'));
-const AdminMonitorPage = lazyWithRetry(() => import('./pages/admin/AdminMonitorPage'));
-const AdminPagesPage = lazyWithRetry(() => import('./pages/admin/AdminPagesPage'));
-const AdminSitePageEditPage = lazyWithRetry(() => import('./pages/admin/AdminSitePageEditPage'));
-const AdminLinksPage = lazyWithRetry(() => import('./pages/admin/AdminLinksPage'));
-const SitePageView = lazyWithRetry(() => import('./pages/SitePageView'));
-const AdminSettingsPage = lazyWithRetry(() => import('./pages/admin/AdminSettingsPage'));
-const AdminCommunityPage = lazyWithRetry(() => import('./pages/admin/AdminCommunityPage'));
-const NotFoundPage = lazyWithRetry(() => import('./pages/NotFoundPage'));
+/**
+ * 路由树：使用低层 router（useRoutes）而非 data router（RouterProvider）。
+ *
+ * 原因：data router 的 RouterProvider/StaticRouterProvider 内部订阅路由状态，
+ * 服务端 Fizz 渲染会产生 Suspense pending boundary（内容落入 <div hidden> +
+ * 脚本替换的流式格式，禁 JS 爬虫/SEO 工具看不到帖子）。本项目数据全部由
+ * Vike +data 预取并 seed 进请求作用域，不使用 loader/action，低层路由首帧
+ * 即可同步渲染完整 HTML，SSR/CSR 行为一致。
+ */
+function AppRoutes() {
+  return useRoutes(appRoutes);
+}

-const router = createBrowserRouter(
-  createRoutesFromElements(
-    <Route errorElement={<AppRouteError />}>
-      <Route path="/login" element={<Suspense fallback={<AuthPageFallback />}><LoginPage /></Suspense>} />
-      <Route path="/register" element={<Suspense fallback={<AuthPageFallback />}><RegisterPage /></Suspense>} />
-      <Route path="/forgot-password" element={<Suspense fallback={<AuthPageFallback />}><ForgotPasswordPage /></Suspense>} />
-      <Route path="/boards" element={<Navigate to="/admin/boards" replace />} />
-      <Route path="/admin" element={<AdminLayout />}>
-        <Route index element={<Navigate to="/admin/dashboard" replace />} />
-        <Route path="dashboard" element={<Suspense fallback={<PageLoader />}><AdminDashboardPage /></Suspense>} />
-        <Route path="boards" element={<Suspense fallback={<PageLoader />}><BoardsManagePage /></Suspense>} />
-        <Route path="pages/new" element={<Suspense fallback={<PageLoader />}><AdminSitePageEditPage /></Suspense>} />
-        <Route path="pages/:id/edit" element={<Suspense fallback={<PageLoader />}><AdminSitePageEditPage /></Suspense>} />
-        <Route path="pages" element={<Suspense fallback={<PageLoader />}><AdminPagesPage /></Suspense>} />
-        <Route path="links" element={<Suspense fallback={<PageLoader />}><AdminLinksPage /></Suspense>} />
-        <Route path="community" element={<Suspense fallback={<PageLoader />}><AdminCommunityPage /></Suspense>} />
-        <Route path="posts" element={<Suspense fallback={<PageLoader />}><AdminPostsPage /></Suspense>} />
-        <Route path="comments" element={<Suspense fallback={<PageLoader />}><AdminCommentsPage /></Suspense>} />
-        <Route path="reports" element={<Suspense fallback={<PageLoader />}><AdminReportsPage /></Suspense>} />
-        <Route path="users" element={<Suspense fallback={<PageLoader />}><AdminUsersPage /></Suspense>} />
-        <Route path="badges" element={<Suspense fallback={<PageLoader />}><AdminBadgesPage /></Suspense>} />
-        <Route path="media" element={<Suspense fallback={<PageLoader />}><AdminMediaPage /></Suspense>} />
-        <Route path="monitor" element={<Suspense fallback={<PageLoader />}><AdminMonitorPage /></Suspense>} />
-        <Route path="settings" element={<Suspense fallback={<PageLoader />}><AdminSettingsPage /></Suspense>} />
-        <Route path="*" element={<Suspense fallback={<PageLoader />}><NotFoundPage title="后台页面不存在" /></Suspense>} />
-      </Route>
-      <Route element={<MainLayout />}>
-        <Route path="/" element={<HomePage />} />
-        <Route path="/board/:id" element={<HomePage />} />
-        {/* :id 可为 123 或 123.html（伪静态后缀由后台配置） */}
-        <Route path="/post/:id" element={<PostDetailPage />} />
-        <Route path="/compose" element={<ComposePage />} />
-        <Route path="/post/:id/edit" element={<ComposePage />} />
-        <Route path="/profile" element={<ProfilePage />} />
-        <Route path="/user/:id" element={<UserProfilePage />} />
-        <Route path="/favorites" element={<FavoritesPage />} />
-        <Route path="/projects" element={<ProjectsPage />} />
-        <Route path="/links" element={<LinksPage />} />
-        <Route path="/showcase" element={<Suspense fallback={null}><ShowcasePage /></Suspense>} />
-        <Route path="/messages" element={<MessagesPage />} />
-        <Route path="/page/:slug" element={<Suspense fallback={null}><SitePageView /></Suspense>} />
-        <Route path="*" element={<Suspense fallback={null}><NotFoundPage /></Suspense>} />
-      </Route>
-      <Route path="*" element={<Suspense fallback={<PageLoader fullScreen />}><NotFoundPage standalone /></Suspense>} />
-    </Route>,
-  ),
-);
-
-export default function App() {
+/**
+ * 应用根组件：Vike +Page 与客户端入口共用（浏览器侧）。
+ */
+export default function App(_props: { url?: string }) {
  return (
-    <ThemeProvider>
-      <AuthProvider>
-        <ErrorBoundary>
-          <RouterProvider router={router} />
-          <TopProgressBar />
-          <PullToRefresh />
-          <Toaster />
-        </ErrorBoundary>
-      </AuthProvider>
-    </ThemeProvider>
+    <BrowserRouter>
+      <AppShell>
+        <AppRoutes />
+      </AppShell>
+    </BrowserRouter>
+  );
+}
+
+/**
+ * SSR 应用工厂：低层 StaticRouter + useRoutes，location 一次性给定，
+ * 整棵树同步渲染（无首导航异步、无状态订阅 suspend）。
+ */
+export async function createSsrApp(url: string) {
+  return (
+    <StaticRouter location={url}>
+      <AppShell>
+        <AppRoutes />
+      </AppShell>
+    </StaticRouter>
  );
 }
--- a/frontend/src/AppRoutes.tsx
+++ b/frontend/src/AppRoutes.tsx
@@ -0,0 +1,89 @@
+import { Suspense } from 'react';
+import { createRoutesFromElements, Route, Navigate } from 'react-router';
+import MainLayout from './layouts/MainLayout';
+import AdminLayout from './layouts/AdminLayout';
+import AppRouteError from './components/AppRouteError';
+import PageLoader from './components/PageLoader';
+import AuthPageFallback from './components/AuthPageFallback';
+import { lazyWithRetry } from './utils/lazyWithRetry';
+// SSR 页面（/、/board/:id、/post/:id）必须静态导入：React.lazy 在服务端首帧必然
+// suspend，会使内容落入 <div hidden> + 脚本替换的流式格式，禁 JS 爬虫/SEO 工具看不到内容。
+import HomePage from './pages/HomePage';
+import PostDetailPage from './pages/PostDetailPage';
+
+const LoginPage = lazyWithRetry(() => import('./pages/LoginPage'));
+const RegisterPage = lazyWithRetry(() => import('./pages/RegisterPage'));
+const ForgotPasswordPage = lazyWithRetry(() => import('./pages/ForgotPasswordPage'));
+const ComposePage = lazyWithRetry(() => import('./pages/ComposePage'));
+const BoardsManagePage = lazyWithRetry(() => import('./pages/BoardsManagePage'));
+const ProfilePage = lazyWithRetry(() => import('./pages/ProfilePage'));
+const UserProfilePage = lazyWithRetry(() => import('./pages/UserProfilePage'));
+const FavoritesPage = lazyWithRetry(() => import('./pages/FavoritesPage'));
+const MessagesPage = lazyWithRetry(() => import('./pages/MessagesPage'));
+const ProjectsPage = lazyWithRetry(() => import('./pages/ProjectsPage'));
+const LinksPage = lazyWithRetry(() => import('./pages/LinksPage'));
+const ShowcasePage = lazyWithRetry(() => import('./pages/ShowcasePage'));
+const AdminDashboardPage = lazyWithRetry(() => import('./pages/admin/AdminDashboardPage'));
+const AdminPostsPage = lazyWithRetry(() => import('./pages/admin/AdminPostsPage'));
+const AdminCommentsPage = lazyWithRetry(() => import('./pages/admin/AdminCommentsPage'));
+const AdminReportsPage = lazyWithRetry(() => import('./pages/admin/AdminReportsPage'));
+const AdminUsersPage = lazyWithRetry(() => import('./pages/admin/AdminUsersPage'));
+const AdminBadgesPage = lazyWithRetry(() => import('./pages/admin/AdminBadgesPage'));
+const AdminMediaPage = lazyWithRetry(() => import('./pages/admin/AdminMediaPage'));
+const AdminMonitorPage = lazyWithRetry(() => import('./pages/admin/AdminMonitorPage'));
+const AdminPagesPage = lazyWithRetry(() => import('./pages/admin/AdminPagesPage'));
+const AdminSitePageEditPage = lazyWithRetry(() => import('./pages/admin/AdminSitePageEditPage'));
+const AdminLinksPage = lazyWithRetry(() => import('./pages/admin/AdminLinksPage'));
+const SitePageView = lazyWithRetry(() => import('./pages/SitePageView'));
+const AdminSettingsPage = lazyWithRetry(() => import('./pages/admin/AdminSettingsPage'));
+const AdminCommunityPage = lazyWithRetry(() => import('./pages/admin/AdminCommunityPage'));
+const NotFoundPage = lazyWithRetry(() => import('./pages/NotFoundPage'));
+
+/** 全量 react-router 路由树（Vike 页面壳与浏览器共用同一棵树） */
+export const appRoutes = createRoutesFromElements(
+  <Route errorElement={<AppRouteError />}>
+    <Route path="/login" element={<Suspense fallback={<AuthPageFallback />}><LoginPage /></Suspense>} />
+    <Route path="/register" element={<Suspense fallback={<AuthPageFallback />}><RegisterPage /></Suspense>} />
+    <Route path="/forgot-password" element={<Suspense fallback={<AuthPageFallback />}><ForgotPasswordPage /></Suspense>} />
+    <Route path="/boards" element={<Navigate to="/admin/boards" replace />} />
+    <Route path="/admin" element={<AdminLayout />}>
+      <Route index element={<Navigate to="/admin/dashboard" replace />} />
+      <Route path="dashboard" element={<Suspense fallback={<PageLoader />}><AdminDashboardPage /></Suspense>} />
+      <Route path="boards" element={<Suspense fallback={<PageLoader />}><BoardsManagePage /></Suspense>} />
+      <Route path="pages/new" element={<Suspense fallback={<PageLoader />}><AdminSitePageEditPage /></Suspense>} />
+      <Route path="pages/:id/edit" element={<Suspense fallback={<PageLoader />}><AdminSitePageEditPage /></Suspense>} />
+      <Route path="pages" element={<Suspense fallback={<PageLoader />}><AdminPagesPage /></Suspense>} />
+      <Route path="links" element={<Suspense fallback={<PageLoader />}><AdminLinksPage /></Suspense>} />
+      <Route path="community" element={<Suspense fallback={<PageLoader />}><AdminCommunityPage /></Suspense>} />
+      <Route path="posts" element={<Suspense fallback={<PageLoader />}><AdminPostsPage /></Suspense>} />
+      <Route path="comments" element={<Suspense fallback={<PageLoader />}><AdminCommentsPage /></Suspense>} />
+      <Route path="reports" element={<Suspense fallback={<PageLoader />}><AdminReportsPage /></Suspense>} />
+      <Route path="users" element={<Suspense fallback={<PageLoader />}><AdminUsersPage /></Suspense>} />
+      <Route path="badges" element={<Suspense fallback={<PageLoader />}><AdminBadgesPage /></Suspense>} />
+      <Route path="media" element={<Suspense fallback={<PageLoader />}><AdminMediaPage /></Suspense>} />
+      <Route path="monitor" element={<Suspense fallback={<PageLoader />}><AdminMonitorPage /></Suspense>} />
+      <Route path="settings" element={<Suspense fallback={<PageLoader />}><AdminSettingsPage /></Suspense>} />
+      <Route path="*" element={<Suspense fallback={<PageLoader />}><NotFoundPage title="后台页面不存在" /></Suspense>} />
+    </Route>
+    <Route element={<MainLayout />}>
+      <Route path="/" element={<HomePage />} />
+      <Route path="/board/:id" element={<HomePage />} />
+      {/* :id 可为 123 或 123.html（伪静态后缀由后台配置） */}
+      <Route path="/post/:id" element={<PostDetailPage />} />
+      {/* 懒加载页面各自包裹 Suspense：Suspense 边界不得包裹 SSR 静态内容
+          （React 19 会把边界内大体积/含 <img> 的内容 outlining 为 hidden chunk） */}
+      <Route path="/compose" element={<Suspense fallback={<PageLoader />}><ComposePage /></Suspense>} />
+      <Route path="/post/:id/edit" element={<Suspense fallback={<PageLoader />}><ComposePage /></Suspense>} />
+      <Route path="/profile" element={<Suspense fallback={<PageLoader />}><ProfilePage /></Suspense>} />
+      <Route path="/user/:id" element={<Suspense fallback={<PageLoader />}><UserProfilePage /></Suspense>} />
+      <Route path="/favorites" element={<Suspense fallback={<PageLoader />}><FavoritesPage /></Suspense>} />
+      <Route path="/projects" element={<Suspense fallback={<PageLoader />}><ProjectsPage /></Suspense>} />
+      <Route path="/links" element={<Suspense fallback={<PageLoader />}><LinksPage /></Suspense>} />
+      <Route path="/showcase" element={<Suspense fallback={<PageLoader />}><ShowcasePage /></Suspense>} />
+      <Route path="/messages" element={<Suspense fallback={<PageLoader />}><MessagesPage /></Suspense>} />
+      <Route path="/page/:slug" element={<Suspense fallback={<PageLoader />}><SitePageView /></Suspense>} />
+      <Route path="*" element={<Suspense fallback={<PageLoader />}><NotFoundPage /></Suspense>} />
+    </Route>
+    <Route path="*" element={<Suspense fallback={<PageLoader fullScreen />}><NotFoundPage standalone /></Suspense>} />
+  </Route>,
+);
--- a/frontend/src/AppShell.tsx
+++ b/frontend/src/AppShell.tsx
@@ -0,0 +1,24 @@
+import type { ReactNode } from 'react';
+import './styles/global.css';
+import { AuthProvider } from './hooks/useAuth';
+import { ThemeProvider } from './hooks/useTheme';
+import ErrorBoundary from './components/ErrorBoundary';
+import { Toaster } from './components/ui/sonner';
+import PullToRefresh from './components/PullToRefresh';
+import TopProgressBar from './components/TopProgressBar';
+
+/** 与路由无关的应用壳：Provider + 全局挂件（SSR 服务端 / 客户端共用） */
+export default function AppShell({ children }: { children: ReactNode }) {
+  return (
+    <ThemeProvider>
+      <AuthProvider>
+        <ErrorBoundary>
+          {children}
+          <TopProgressBar />
+          <PullToRefresh />
+          <Toaster />
+        </ErrorBoundary>
+      </AuthProvider>
+    </ThemeProvider>
+  );
+}
--- a/frontend/src/api/client.ts
+++ b/frontend/src/api/client.ts
@@ -154,12 +154,12 @@ export const api = {
  },
  adminApprovePost: (id: number) =>
    request<{ message: string; status: string }>(`/api/admin/posts/${id}/approve`, { method: 'POST' }),
-  adminPinPost: (id: number, pinned: boolean) =>
-    request<{ message: string; pinned: boolean }>(`/api/admin/posts/${id}/pin`, {
+  adminPinPost: (id: number, pinned: number) =>
+    request<{ message: string; pinned: number }>(`/api/admin/posts/${id}/pin`, {
      method: 'POST', body: JSON.stringify({ pinned }),
    }),
-  adminBoardPinPost: (id: number, boardPinned: boolean) =>
-    request<{ message: string; board_pinned: boolean }>(`/api/admin/posts/${id}/board-pin`, {
+  adminBoardPinPost: (id: number, boardPinned: number) =>
+    request<{ message: string; board_pinned: number }>(`/api/admin/posts/${id}/board-pin`, {
      method: 'POST', body: JSON.stringify({ board_pinned: boardPinned }),
    }),
  adminFeaturePost: (id: number, featured: boolean) =>
@@ -264,8 +264,6 @@ export const api = {
    }),
  postRevisions: (id: number) =>
    request<{ revisions: PostRevision[] }>(`/api/posts/${id}/revisions`),
-  postRevision: (id: number, revId: number) =>
-    request<{ revision: PostRevision }>(`/api/posts/${id}/revisions/${revId}`),
  adminDeletePost: (id: number) => request(`/api/admin/posts/${id}`, { method: 'DELETE' }),
  adminTrashPosts: (params: { page?: number; keyword?: string }) => {
    const q = new URLSearchParams();
@@ -582,7 +580,6 @@ export const api = {
      `/api/users/search?${sp}`,
    );
  },
-  captcha: () => request<{ id: string; image: string }>('/api/captcha'),
  logout: () => request('/api/logout', { method: 'POST' }),
  like: (id: number) => request<{ liked: boolean; like_count: number }>(`/api/posts/${id}/like`, { method: 'POST' }),
  likeComment: (id: number) => request<{ liked: boolean; like_count: number }>(`/api/comments/${id}/like`, { method: 'POST' }),
@@ -664,6 +661,8 @@ export const api = {
  },
  markNotificationsRead: () =>
    request<{ message: string }>('/api/messages/notifications/read', { method: 'POST' }),
+  markMessageRead: (id: number) =>
+    request<{ message: string }>(`/api/messages/${id}/read`, { method: 'POST' }),
  sendMessage: (body: { to_user_id: number; subject?: string; content: string }) =>
    request<{ message: PrivateMessage }>('/api/messages', {
      method: 'POST', body: JSON.stringify(body),
--- a/frontend/src/api/serverClient.ts
+++ b/frontend/src/api/serverClient.ts
@@ -0,0 +1,40 @@
+/**
+ * 服务端 API 客户端：Vike +data 在 Node 侧调用 Go API 用（仅 SSR 打包引用）。
+ *
+ * - GO_API_URL 指向 Go 服务（dev 默认与 Vite proxy 一致；生产由环境变量给 :3001）
+ * - 转发浏览器 cookie 以透传登录态
+ * - 转发 host / X-Forwarded-* 让 Go 推导正确的站点 base URL（canonical/og:url 等）
+ * - 5s 超时；任何失败返回 null，调用方降级为 SPA 壳，不阻断渲染
+ *
+ * 本模块仅允许被 SSR 侧代码（pages 下的 +data、src/ssr/feedData）引用；
+ * 顶层 process.env 读取以 import.meta.env.SSR 守卫，防止误入客户端包时求值崩溃。
+ */
+
+const GO_API_URL = import.meta.env.SSR
+  ? process.env.GO_API_URL || `http://127.0.0.1:${process.env.VITE_API_PORT || '3000'}`
+  : '';
+
+export type ServerApiOptions = {
+  /** 浏览器请求的 cookie 原样转发 */
+  cookie?: string;
+  /** 额外转发给 Go 的请求头（host / x-forwarded-* 等） */
+  headers?: Record<string, string>;
+  timeoutMs?: number;
+};
+
+export async function serverApi<T>(path: string, opts?: ServerApiOptions): Promise<T | null> {
+  try {
+    const res = await fetch(`${GO_API_URL}${path}`, {
+      headers: {
+        ...(opts?.cookie ? { cookie: opts.cookie } : {}),
+        ...(opts?.headers ?? {}),
+      },
+      signal: AbortSignal.timeout(opts?.timeoutMs ?? 5000),
+      cache: 'no-store',
+    });
+    if (!res.ok) return null;
+    return (await res.json()) as T;
+  } catch {
+    return null;
+  }
+}
--- a/frontend/src/api/types.ts
+++ b/frontend/src/api/types.ts
@@ -83,7 +83,12 @@ export interface PostItem {
  board_id: number;
  user_id: number;
  title: string;
+  /** 完整正文；列表接口不下发（为空），仅帖子详情等场景有值 */
  content?: string;
+  /** 列表接口预算的纯文本摘要（60 字），列表页直接使用无需解析 content */
+  excerpt?: string;
+  /** 列表接口预算的正文首图 URL（缩略图模式用） */
+  first_image?: string;
  tags: string;
  /** normal=讨论 | question=问答 | poll=投票 | bounty=悬赏 | lottery=抽奖 */
  post_type?: 'normal' | 'question' | 'poll' | 'bounty' | 'lottery' | string;
@@ -94,9 +99,9 @@ export interface PostItem {
  bounty_comment_id?: number;
  lottery_winner_count?: number;
  lottery_status?: 'open' | 'drawn' | string;
-  pinned: boolean;
+  pinned: number;
  /** 板块内置顶（仅板块列表抬升，首页不抬升） */
-  board_pinned?: boolean;
+  board_pinned?: number;
  featured?: boolean;
  edit_locked?: boolean;
  /** 禁止新评论（结贴） */
@@ -717,9 +722,13 @@ export interface PrivateMessage {
  to_user_id: number;
  subject: string;
  content: string;
-  kind: 'user' | 'system' | 'reject' | 'report_result' | string;
+  kind: 'user' | 'system' | 'reject' | 'report_result' | 'reply' | 'mention' | 'moderation' | string;
  related_post_id?: number;
  related_report_id?: number;
+  related_comment_id?: number;
+  related_floor?: number;
+  /** 待审目标实时状态：pending|published|rejected|deleted */
+  related_status?: string;
  is_read: boolean;
  created_at: string;
  from_user?: User;
--- a/frontend/src/components/AppRouteError.tsx
+++ b/frontend/src/components/AppRouteError.tsx
@@ -1,5 +1,5 @@
 import { useEffect } from 'react';
-import { isRouteErrorResponse, useRouteError } from 'react-router-dom';
+import { isRouteErrorResponse, useRouteError } from 'react-router';
 import { Button } from '@/components/ui/button';
 import { isChunkLoadError, reloadForStaleChunk } from '../utils/chunkLoad';

--- a/frontend/src/components/ArticleEditor.tsx
+++ b/frontend/src/components/ArticleEditor.tsx
@@ -1,5 +1,6 @@
 import {
-  useRef, useEffect, useImperativeHandle, forwardRef, useCallback, useState, useMemo, type ReactNode,
+  useRef, useEffect, useImperativeHandle, forwardRef, useCallback, useState, useMemo,
+  type ReactNode, type Ref,
 } from 'react';
 import { useEditor, EditorContent, type Editor } from '@tiptap/react';
 import { TextSelection, NodeSelection } from '@tiptap/pm/state';
@@ -8,7 +9,7 @@ import Link from '@tiptap/extension-link';
 import Placeholder from '@tiptap/extension-placeholder';
 import Underline from '@tiptap/extension-underline';
 import { TableKit } from '@tiptap/extension-table';
-import DOMPurify from 'dompurify';
+import { sanitizeHtml as sanitizeContentHtml } from '../utils/purify';
 import {
  Bold, Italic, Underline as UnderlineIcon, Strikethrough, Link as LinkIcon, Code, Quote,
  List, ListOrdered, Image as ImageIcon, Minus, LockKeyhole,
@@ -37,7 +38,10 @@ import { ReplyOnly } from './editor/ReplyOnlyExtension';
 import { PointsOnly } from './editor/PointsOnlyExtension';
 import { TabIndent } from './editor/TabIndentExtension';
 import { ArticleImage, type ImageDisplay } from './editor/ArticleImageExtension';
+import { ArticleSticker } from './editor/ArticleStickerExtension';
 import { ImageGroup, suggestImageGroupLayout } from './editor/ImageGroupExtension';
+import StickerPicker from './emoji/StickerPicker';
+import type { Sticker } from '../data/stickers';
 import { ClearFloatParagraph, ClearFloatSync } from './editor/ClearFloatParagraph';
 import { ArticleLinkDialog, type ArticleLinkConfirm } from './editor/ArticleLinkDialog';
 import { ArticleImagePickerDialog } from './editor/ArticleImagePickerDialog';
@@ -84,6 +88,7 @@ interface ToolBtn {
  align?: 'start' | 'center' | 'end';
  active?: boolean;
  className?: string;
+  buttonRef?: Ref<HTMLButtonElement>;
  action: () => void;
 }

@@ -116,12 +121,20 @@ function buildMarkdownTableSnippet(opts: TableInsertOptions): string {

 /** 净化编辑器 HTML，保留 members-only 自定义标签 */
 function sanitizeHtml(html: string): string {
-  return DOMPurify.sanitize(html, POST_CONTENT_PURIFY_CONFIG);
+  return sanitizeContentHtml(html, POST_CONTENT_PURIFY_CONFIG);
 }

-/** 判断编辑器内容是否为空 */
+/** 判断编辑器内容是否为空（纯贴纸/图片也算有内容） */
 function isEditorEmpty(editor: Editor): boolean {
-  return editor.state.doc.textContent.trim().length === 0;
+  if (editor.state.doc.textContent.trim().length > 0) return false;
+  let hasMedia = false;
+  editor.state.doc.descendants((node) => {
+    if (node.type.name === 'image' || node.type.name === 'sticker' || node.type.name === 'imageGroup') {
+      hasMedia = true;
+      return false;
+    }
+  });
+  return !hasMedia;
 }

 /**
@@ -177,10 +190,12 @@ function renderToolButtons(tools: ToolBtn[]) {
      ) : null}
      <Tooltip content={t.title} hint={t.hint} align={t.align} side="bottom">
        <button
+          ref={t.buttonRef}
          type="button"
          className={`article-tool-btn${t.active ? ' active' : ''}${t.className ? ` ${t.className}` : ''}`}
          onMouseDown={e => e.preventDefault()}
          onClick={t.action}
+          aria-pressed={t.active || undefined}
        >
          {t.icon}
        </button>
@@ -213,7 +228,10 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
  const [tableDialogOpen, setTableDialogOpen] = useState(false);
  const [tableTarget, setTableTarget] = useState<TableTarget>('rich');
  const [tableEditing, setTableEditing] = useState(false);
+  const [showSticker, setShowSticker] = useState(false);
  const markdownRef = useRef<HTMLTextAreaElement>(null);
+  const editorBoxRef = useRef<HTMLDivElement>(null);
+  const stickerBtnRef = useRef<HTMLButtonElement>(null);

  const editor = useEditor({
    extensions: [
@@ -246,16 +264,20 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
        },
      }),
      ArticleImage.configure({ inline: false, allowBase64: false }),
+      ArticleSticker,
      ImageGroup,
      Placeholder.configure({
        placeholder: ({ node }) => {
-          if (node.type.name === 'paragraph' && node.parent?.type.name === 'membersOnly') {
+          // prosemirror 未公开 parent 字段，这里仅读父节点类型名
+          const parentName = (node as unknown as { parent?: { type?: { name?: string } } })
+            .parent?.type?.name;
+          if (node.type.name === 'paragraph' && parentName === 'membersOnly') {
            return MEMBERS_ONLY_PLACEHOLDER;
          }
-          if (node.type.name === 'paragraph' && node.parent?.type.name === 'replyOnly') {
+          if (node.type.name === 'paragraph' && parentName === 'replyOnly') {
            return REPLY_ONLY_PLACEHOLDER;
          }
-          if (node.type.name === 'paragraph' && node.parent?.type.name === 'pointsOnly') {
+          if (node.type.name === 'paragraph' && parentName === 'pointsOnly') {
            return '此处内容需积分解锁后可见…';
          }
          return placeholder;
@@ -322,23 +344,42 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
    placeCaretInFirstTextblock(editor);
  }, [value, editor, mode]);

-  // 全屏时锁定页面滚动，Esc 退出
+  // 全屏时锁定页面滚动；Esc 先关表情面板，再退出全屏
  useEffect(() => {
-    if (!fullscreen) return undefined;
+    if (!fullscreen && !showSticker) return undefined;

-    const prevOverflow = document.body.style.overflow;
-    document.body.style.overflow = 'hidden';
+    const prevOverflow = fullscreen ? document.body.style.overflow : null;
+    if (fullscreen) document.body.style.overflow = 'hidden';

    const onKeyDown = (e: KeyboardEvent) => {
-      if (e.key === 'Escape') setFullscreen(false);
+      if (e.key !== 'Escape') return;
+      if (showSticker) {
+        setShowSticker(false);
+        stickerBtnRef.current?.focus();
+        return;
+      }
+      if (fullscreen) setFullscreen(false);
    };
    window.addEventListener('keydown', onKeyDown);

    return () => {
-      document.body.style.overflow = prevOverflow;
+      if (prevOverflow !== null) document.body.style.overflow = prevOverflow;
      window.removeEventListener('keydown', onKeyDown);
    };
-  }, [fullscreen]);
+  }, [fullscreen, showSticker]);
+
+  // 点击编辑器外关闭贴纸面板
+  useEffect(() => {
+    if (!showSticker) return;
+    const onPointer = (e: MouseEvent) => {
+      if (editorBoxRef.current && !editorBoxRef.current.contains(e.target as Node)) {
+        setShowSticker(false);
+        stickerBtnRef.current?.focus();
+      }
+    };
+    document.addEventListener('mousedown', onPointer);
+    return () => document.removeEventListener('mousedown', onPointer);
+  }, [showSticker]);

  useImperativeHandle(ref, () => ({
    getHTML: () => {
@@ -523,6 +564,30 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
    editor.chain().focus().extendMarkRange('link').unsetLink().run();
  }, [editor]);

+  const insertSticker = useCallback((sticker: Sticker) => {
+    if (mode === 'markdown') {
+      const textarea = markdownRef.current;
+      if (!textarea) return;
+      const snippet = (sticker.type === 'text' && sticker.text)
+        ? sticker.text
+        : (sticker.url ? `![${sticker.name || '表情'}](${sticker.url})` : '');
+      if (!snippet) return;
+      insertAtCursor(textarea, markdownSource, snippet, handleMarkdownChange);
+      setShowSticker(false);
+      return;
+    }
+    if (!editor) return;
+    if (sticker.type === 'text' && sticker.text) {
+      editor.chain().focus().insertContent(sticker.text).run();
+    } else if (sticker.url) {
+      editor.chain().focus().insertContent([
+        { type: 'sticker', attrs: { src: sticker.url, alt: sticker.name } },
+        { type: 'text', text: ' ' },
+      ]).run();
+    }
+    setShowSticker(false);
+  }, [editor, mode, markdownSource, handleMarkdownChange]);
+
  const openImagePicker = useCallback((target: ImagePickerTarget) => {
    setImagePickerTarget(target);
    setImagePickerOpen(true);
@@ -614,6 +679,7 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
    const html = sanitizeHtml(editor.getHTML());
    lastValueRef.current = html;
    setMarkdownSource(htmlToMarkdown(html));
+    setShowSticker(false);
    setMode('markdown');
  }, [editor]);

@@ -626,6 +692,7 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
      editor.commands.setContent(html || '', { emitUpdate: false });
      placeCaretInFirstTextblock(editor);
    }
+    setShowSticker(false);
    setMode('rich');
  }, [editor, markdownSource, onChange]);

@@ -676,6 +743,15 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
        active: groupActive,
        action: wrapSelectedAsGroup,
      },
+      {
+        icon: <span className="article-tool-btn__owo">OwO</span>,
+        title: '表情 OwO',
+        hint: '插入贴纸或颜文字',
+        active: showSticker,
+        className: 'article-tool-btn--owo',
+        buttonRef: stickerBtnRef,
+        action: () => setShowSticker(v => !v),
+      },
    ];

    if (editor.isActive('table')) {
@@ -760,7 +836,7 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
    }

    return tools;
-  }, [editor, enableContentGates, openLinkDialog, openCodeBlockDialog, openTableDialog, openImagePicker, wrapMembersOnly, wrapReplyOnly, wrapPointsOnly, wrapSelectedAsGroup, setImageDisplay]);
+  }, [editor, enableContentGates, showSticker, openLinkDialog, openCodeBlockDialog, openTableDialog, openImagePicker, wrapMembersOnly, wrapReplyOnly, wrapPointsOnly, wrapSelectedAsGroup, setImageDisplay]);

  const buildMarkdownTools = useCallback((): ToolBtn[] => {
    const tools: ToolBtn[] = [
@@ -782,6 +858,15 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
        hint: '上传、链接或从已上传中选择',
        action: () => openImagePicker('markdown'),
      },
+      {
+        icon: <span className="article-tool-btn__owo">OwO</span>,
+        title: '表情 OwO',
+        hint: '插入贴纸或颜文字',
+        active: showSticker,
+        className: 'article-tool-btn--owo',
+        buttonRef: stickerBtnRef,
+        action: () => setShowSticker(v => !v),
+      },
    ];
    if (enableContentGates) {
      tools.push(
@@ -809,7 +894,7 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
      );
    }
    return tools;
-  }, [enableContentGates, withMarkdown, openLinkDialog, openCodeBlockDialog, openTableDialog, openImagePicker]);
+  }, [enableContentGates, showSticker, withMarkdown, openLinkDialog, openCodeBlockDialog, openTableDialog, openImagePicker]);

  const tools = mode === 'rich' ? buildRichTools() : buildMarkdownTools();
  const words = mode === 'markdown'
@@ -817,12 +902,16 @@ const ArticleEditor = forwardRef<ArticleEditorHandle, Props>(function ArticleEdi
    : (editor ? countWords(editor.getText()) : 0);

  return (
-    <div className={`article-editor article-editor--${mode}${fullscreen ? ' article-editor--fullscreen' : ''}`}>
+    <div
+      ref={editorBoxRef}
+      className={`article-editor article-editor--${mode}${fullscreen ? ' article-editor--fullscreen' : ''}`}
+    >
      <div className="article-editor-bar">
        <div className="article-editor-tools">
          {renderToolButtons(tools)}
        </div>
      </div>
+      {showSticker && <StickerPicker onSelect={insertSticker} />}

      <div className="article-editor-body">
        {mode === 'rich' ? (
--- a/frontend/src/components/AsideCheckInStrip.tsx
+++ b/frontend/src/components/AsideCheckInStrip.tsx
@@ -1,5 +1,5 @@
 import { CalendarCheck, Check, Gift, Loader2 } from 'lucide-react';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import { useCheckIn } from '../hooks/useCheckIn';
 import { useAuth } from '../hooks/useAuth';
 import { loginPath } from '../utils/authRedirect';
--- a/frontend/src/components/BackToTop.tsx
+++ b/frontend/src/components/BackToTop.tsx
@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { useLocation } from 'react-router-dom';
+import { useLocation } from 'react-router';
 import { ArrowUp, MessageSquare } from 'lucide-react';

 /** 滚动超过该距离后显示按钮 */
@@ -10,7 +10,8 @@ const BIND_RETRY_MS = 50;

 /**
 * 定位当前真正滚动的容器。
- * 前台：手机 Feed 整栏 / .post-list-scroll / .page-wrap / .main-content--compose
+ * Feed 文档滚动模式（.app-shell--doc-scroll）：滚动根为窗口（document.scrollingElement）。
+ * 其余前台：手机 Feed 整栏 / .post-list-scroll / .page-wrap / .main-content--compose
 * 后台：.admin-main
 */
 function pickScrollEl(scope: ParentNode): HTMLElement | null {
@@ -52,7 +53,7 @@ export default function BackToTop() {
    let cancelled = false;
    let attempts = 0;
    let retryTimer: ReturnType<typeof setTimeout> | undefined;
-    let bound: HTMLElement | null = null;
+    let bound: EventTarget | null = null;

    const onScroll = () => {
      if (!cancelled) syncVisible();
@@ -80,6 +81,15 @@ export default function BackToTop() {

    const tryBind = () => {
      if (cancelled) return;
+      // Feed 文档滚动模式：滚动根是窗口，scroll 事件落在 document 上
+      if (document.querySelector('.app-shell--doc-scroll')) {
+        unbind();
+        bound = document;
+        scrollElRef.current = document.scrollingElement as HTMLElement | null;
+        document.addEventListener('scroll', onScroll, { passive: true });
+        onScroll();
+        return;
+      }
      const scope = findScrollScope();
      if (!scope) {
        setVisible(false);
--- a/frontend/src/components/CommentBox.tsx
+++ b/frontend/src/components/CommentBox.tsx
@@ -1,5 +1,5 @@
 import { useState, useRef, useEffect } from 'react';
-import { Link } from 'react-router-dom';
+import { Link } from 'react-router';
 import { Send } from 'lucide-react';
 import { Switch } from '@/components/ui/switch';
 import { Button } from '@/components/ui/button';
--- a/frontend/src/components/CommentContent.tsx
+++ b/frontend/src/components/CommentContent.tsx
@@ -1,15 +1,19 @@
-import { useNavigate } from 'react-router-dom';
+import { useMemo, useCallback } from 'react';
+import { useNavigate } from 'react-router';
 import { api } from '../api/client';
 import { renderCommentContent } from '../utils/content';
+import { handleMdCodeBlockUiClick } from '../utils/enhanceCodeBlocks';
 import { userPath } from '../utils/userPath';
+import { notify } from '@/lib/notify';

 interface Props {
  content: string;
 }

-/** 渲染评论正文（支持正文内 @ 高亮与点击跳转） */
+/** 渲染评论正文（支持正文内 @ 高亮、代码块阅读态与点击跳转） */
 export default function CommentContent({ content }: Props) {
  const nav = useNavigate();
+  const html = useMemo(() => renderCommentContent(content), [content]);

  const openMention = async (name: string) => {
    try {
@@ -26,17 +30,29 @@ export default function CommentContent({ content }: Props) {
    }
  };

+  const onClick = useCallback(async (e: React.MouseEvent) => {
+    try {
+      if (await handleMdCodeBlockUiClick(e.target)) {
+        e.preventDefault();
+        return;
+      }
+    } catch {
+      notify.error('复制失败');
+      return;
+    }
+
+    const el = (e.target as HTMLElement).closest('.mention') as HTMLElement | null;
+    if (!el) return;
+    const name = el.getAttribute('data-name');
+    if (!name) return;
+    e.preventDefault();
+    void openMention(name);
+  }, [nav]);
+
  return (
    <div
-      className="floor-body"
-      onClick={(e) => {
-        const el = (e.target as HTMLElement).closest('.mention') as HTMLElement | null;
-        if (!el) return;
-        const name = el.getAttribute('data-name');
-        if (!name) return;
-        e.preventDefault();
-        void openMention(name);
-      }}
+      className="floor-body post-detail-content"
+      onClick={(e) => { void onClick(e); }}
      onKeyDown={(e) => {
        if (e.key !== 'Enter' && e.key !== ' ') return;
        const el = e.target as HTMLElement;
@@ -46,9 +62,7 @@ export default function CommentContent({ content }: Props) {
        e.preventDefault();
        void openMention(name);
      }}
-      dangerouslySetInnerHTML={{
-        __html: renderCommentContent(content),
-      }}
+      dangerouslySetInnerHTML={{ __html: html }}
    />
  );
 }
--- a/frontend/src/components/CommentEditor.tsx
+++ b/frontend/src/components/CommentEditor.tsx
@@ -6,7 +6,7 @@ import StarterKit from '@tiptap/starter-kit';
 import Link from '@tiptap/extension-link';
 import Placeholder from '@tiptap/extension-placeholder';
 import Underline from '@tiptap/extension-underline';
-import DOMPurify from 'dompurify';
+import { sanitizeHtml as sanitizeContentHtml } from '../utils/purify';
 import {
  Bold, Italic, Underline as UnderlineIcon, Strikethrough,
  List, ListOrdered, Code, Link as LinkIcon, Image as ImageIcon,
@@ -36,7 +36,7 @@ interface Props {
 }

 function sanitizeHtml(html: string): string {
-  return DOMPurify.sanitize(html, POST_CONTENT_PURIFY_CONFIG);
+  return sanitizeContentHtml(html, POST_CONTENT_PURIFY_CONFIG);
 }

 function isEditorEmpty(editor: Editor): boolean {
@@ -148,7 +148,9 @@ const CommentEditor = forwardRef<CommentEditorHandle, Props>(function CommentEdi
  useImperativeHandle(ref, () => ({
    getHTML: () => editor ? sanitizeHtml(editor.getHTML()) : value,
    isEmpty: () => editor ? isEditorEmpty(editor) : !value.trim(),
-    focus: (options?: { preventScroll?: boolean }) => { editor?.commands.focus(options); },
+    focus: (options?: { preventScroll?: boolean }) => {
+      editor?.commands.focus(undefined, { scrollIntoView: !options?.preventScroll });
+    },
  }), [editor, value]);

  const insertSticker = useCallback((sticker: Sticker) => {
--- a/frontend/src/components/FeedHeader.tsx
+++ b/frontend/src/components/FeedHeader.tsx
@@ -1,4 +1,4 @@
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import { navigateFeed } from '../utils/feedCache';

 interface Props {
--- a/frontend/src/components/FeedSortBar.tsx
+++ b/frontend/src/components/FeedSortBar.tsx
@@ -1,5 +1,5 @@
 import { useMemo, useRef } from 'react';
-import { useParams, useSearchParams } from 'react-router-dom';
+import { useParams, useSearchParams } from 'react-router';
 import { boardPath, parsePermalinkID, type PermalinkOpts } from '../utils/permalink';
 import { getCachedForumLimits, useForumLimits } from '../hooks/useForumLimits';
 import { Clock, MessageCircle, BadgeCheck, Loader2 } from 'lucide-react';
--- a/frontend/src/components/PmComposerInput.tsx
+++ b/frontend/src/components/PmComposerInput.tsx
@@ -0,0 +1,227 @@
+import { forwardRef, useCallback, useEffect, useImperativeHandle, useRef } from 'react';
+import type { Sticker } from '../data/stickers';
+
+export type PmComposerInputHandle = {
+  insertSticker: (sticker: Sticker) => void;
+  insertText: (text: string) => void;
+  focus: () => void;
+};
+
+type Props = {
+  value: string;
+  onChange: (next: string) => void;
+  placeholder?: string;
+  maxLength?: number;
+  disabled?: boolean;
+  onSubmit?: () => void;
+};
+
+/** 站点内置贴纸路径（评论/私信共用） */
+export function isPmStickerSrc(src: string) {
+  return src.includes('/stickers/');
+}
+
+function escapeHtml(s: string) {
+  return s
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+function draftToHtml(text: string): string {
+  if (!text) return '';
+  const parts = text.split(/(!\[[^\]]*]\([^)]+\))/g);
+  return parts.map((part) => {
+    const m = part.match(/^!\[([^\]]*)]\(([^)]+)\)$/);
+    if (m) {
+      const alt = escapeHtml(m[1] || '表情');
+      const src = escapeHtml(m[2]);
+      const cls = isPmStickerSrc(m[2]) ? 'pm-composer__sticker' : 'pm-composer__inline-img';
+      return `<img class="${cls}" src="${src}" alt="${alt}" draggable="false">`;
+    }
+    return escapeHtml(part).replace(/\n/g, '<br>');
+  }).join('');
+}
+
+function serializeComposer(root: HTMLElement): string {
+  let out = '';
+
+  const walk = (node: Node) => {
+    if (node.nodeType === Node.TEXT_NODE) {
+      out += node.textContent || '';
+      return;
+    }
+    if (node.nodeType !== Node.ELEMENT_NODE) return;
+    const el = node as HTMLElement;
+    const tag = el.tagName;
+    if (tag === 'IMG') {
+      const src = el.getAttribute('src') || '';
+      const alt = el.getAttribute('alt') || '表情';
+      out += `![${alt}](${src})`;
+      return;
+    }
+    if (tag === 'BR') {
+      out += '\n';
+      return;
+    }
+    if (tag === 'DIV' || tag === 'P') {
+      if (out.length > 0 && !out.endsWith('\n')) out += '\n';
+      el.childNodes.forEach(walk);
+      return;
+    }
+    el.childNodes.forEach(walk);
+  };
+
+  root.childNodes.forEach(walk);
+  return out.replace(/\n$/, '');
+}
+
+function placeCaretAfter(node: Node) {
+  const sel = window.getSelection();
+  if (!sel) return;
+  const range = document.createRange();
+  range.setStartAfter(node);
+  range.collapse(true);
+  sel.removeAllRanges();
+  sel.addRange(range);
+}
+
+/** 私信输入框：可内联插入贴纸（与评论编辑器一致），序列化为 markdown 图片语法 */
+const PmComposerInput = forwardRef<PmComposerInputHandle, Props>(function PmComposerInput(
+  { value, onChange, placeholder, maxLength = 4000, disabled, onSubmit },
+  ref,
+) {
+  const elRef = useRef<HTMLDivElement>(null);
+  const savedRangeRef = useRef<Range | null>(null);
+  const valueRef = useRef(value);
+  valueRef.current = value;
+
+  const emit = useCallback(() => {
+    const el = elRef.current;
+    if (!el) return;
+    const next = serializeComposer(el);
+    if (maxLength && next.length > maxLength) {
+      el.innerHTML = draftToHtml(valueRef.current);
+      return;
+    }
+    el.dataset.empty = next ? 'false' : 'true';
+    if (next !== valueRef.current) onChange(next);
+  }, [maxLength, onChange]);
+
+  const restoreRange = useCallback(() => {
+    const el = elRef.current;
+    if (!el) return;
+    el.focus();
+    const sel = window.getSelection();
+    if (!sel) return;
+    const saved = savedRangeRef.current;
+    if (saved && el.contains(saved.startContainer)) {
+      sel.removeAllRanges();
+      sel.addRange(saved);
+      return;
+    }
+    const range = document.createRange();
+    range.selectNodeContents(el);
+    range.collapse(false);
+    sel.removeAllRanges();
+    sel.addRange(range);
+  }, []);
+
+  const saveRange = useCallback(() => {
+    const el = elRef.current;
+    const sel = window.getSelection();
+    if (!el || !sel || sel.rangeCount === 0) return;
+    if (!el.contains(sel.anchorNode)) return;
+    savedRangeRef.current = sel.getRangeAt(0).cloneRange();
+  }, []);
+
+  const insertNodes = useCallback((nodes: Node[]) => {
+    const el = elRef.current;
+    if (!el || !nodes.length) return;
+    restoreRange();
+    const sel = window.getSelection();
+    if (!sel) return;
+    const range = sel.rangeCount > 0 ? sel.getRangeAt(0) : document.createRange();
+    range.deleteContents();
+    const frag = document.createDocumentFragment();
+    nodes.forEach((n) => frag.appendChild(n));
+    const last = nodes[nodes.length - 1];
+    range.insertNode(frag);
+    placeCaretAfter(last);
+    saveRange();
+    emit();
+  }, [emit, restoreRange, saveRange]);
+
+  useImperativeHandle(ref, () => ({
+    insertSticker(sticker) {
+      if (!sticker.url) return;
+      const img = document.createElement('img');
+      img.className = 'pm-composer__sticker';
+      img.src = sticker.url;
+      img.alt = sticker.name || '表情';
+      img.draggable = false;
+      // 尾随空格，光标可停在贴纸右侧（对齐评论编辑器）
+      insertNodes([img, document.createTextNode(' ')]);
+    },
+    insertText(text) {
+      if (!text) return;
+      insertNodes([document.createTextNode(text)]);
+    },
+    focus() {
+      restoreRange();
+    },
+  }), [insertNodes, restoreRange]);
+
+  // 外部改 value（切会话 / 发送清空）时回填；输入过程中 serialize 与 value 一致则不重绘
+  useEffect(() => {
+    const el = elRef.current;
+    if (!el) return;
+    if (serializeComposer(el) === value) {
+      el.dataset.empty = value ? 'false' : 'true';
+      return;
+    }
+    el.innerHTML = draftToHtml(value);
+    el.dataset.empty = value ? 'false' : 'true';
+  }, [value]);
+
+  useEffect(() => {
+    const onSel = () => saveRange();
+    document.addEventListener('selectionchange', onSel);
+    return () => document.removeEventListener('selectionchange', onSel);
+  }, [saveRange]);
+
+  return (
+    <div
+      ref={elRef}
+      className="pm-composer__input"
+      role="textbox"
+      aria-multiline="true"
+      aria-label="私信内容"
+      contentEditable={!disabled}
+      data-placeholder={placeholder || ''}
+      data-empty={value ? 'false' : 'true'}
+      suppressContentEditableWarning
+      onInput={emit}
+      onBlur={saveRange}
+      onPaste={(e) => {
+        e.preventDefault();
+        const text = e.clipboardData.getData('text/plain');
+        if (text) insertNodes([document.createTextNode(text)]);
+      }}
+      onDrop={(e) => {
+        // 禁止把文件拖成「大图附件」；贴纸只走选择器
+        if (e.dataTransfer?.files?.length) e.preventDefault();
+      }}
+      onKeyDown={(e) => {
+        if (e.nativeEvent.isComposing) return;
+        if (e.key === 'Enter' && !e.shiftKey) {
+          e.preventDefault();
+          onSubmit?.();
+        }
+      }}
+    />
+  );
+});
+
+export default PmComposerInput;
--- a/frontend/src/components/PostAuthorCard.tsx
+++ b/frontend/src/components/PostAuthorCard.tsx
@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import { Eye, FileText, Heart, Mail, MessageCircle, UserRound } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { Badge } from '@/components/ui/badge';
@@ -9,13 +9,15 @@ import { useAuth } from '../hooks/useAuth';
 import { loginPath } from '../utils/authRedirect';
 import { formatTime } from '../utils/content';
 import { userPath } from '../utils/userPath';
-import ComposeMessageDialog from './ComposeMessageDialog';
 import UserLink from './UserLink';

 interface Props {
  author?: User | null;
  publishedAt?: string;
  viewCount?: number;
+  /** SSR/预热快照携带的作者主页资料与统计：首帧直接渲染，避免挂载后再拉 /api/users/:id */
+  initialProfile?: UserPublic | null;
+  initialStats?: UserActivityStats | null;
 }

 /** 帖子详情右栏：作者信息卡（私信 / 主页 / 统计） */
@@ -23,12 +25,13 @@ export default function PostAuthorCard({
  author,
  publishedAt,
  viewCount,
+  initialProfile = null,
+  initialStats = null,
 }: Props) {
  const nav = useNavigate();
  const { user: me } = useAuth();
-  const [profile, setProfile] = useState<UserPublic | null>(null);
-  const [stats, setStats] = useState<UserActivityStats | null>(null);
-  const [msgOpen, setMsgOpen] = useState(false);
+  const [profile, setProfile] = useState<UserPublic | null>(initialProfile);
+  const [stats, setStats] = useState<UserActivityStats | null>(initialStats);

  useEffect(() => {
    if (!author?.id) {
@@ -36,6 +39,12 @@ export default function PostAuthorCard({
      setStats(null);
      return;
    }
+    // 快照（SSR / 客户端预热 / 换帖）已带完整资料：同步即可，不再发请求
+    if (initialProfile && initialStats) {
+      setProfile(initialProfile);
+      setStats(initialStats);
+      return;
+    }
    let cancelled = false;
    api.userProfile(author.id)
      .then((r) => {
@@ -50,7 +59,7 @@ export default function PostAuthorCard({
        setStats(null);
      });
    return () => { cancelled = true; };
-  }, [author?.id]);
+  }, [author?.id, initialProfile, initialStats]);

  if (!author?.id) {
    return (
@@ -78,7 +87,7 @@ export default function PostAuthorCard({
      nav(loginPath(profileHref));
      return;
    }
-    setMsgOpen(true);
+    nav(`/messages?peer=${author.id}`);
  };

  return (
@@ -159,16 +168,6 @@ export default function PostAuthorCard({
          </Button>
        </div>
      </div>
-
-      {!isSelf && (
-        <ComposeMessageDialog
-          open={msgOpen}
-          onOpenChange={setMsgOpen}
-          toUserId={author.id}
-          toNickname={nick}
-          onSent={() => nav(`/messages?peer=${author.id}`)}
-        />
-      )}
    </div>
  );
 }
--- a/frontend/src/components/PostContent.tsx
+++ b/frontend/src/components/PostContent.tsx
@@ -1,6 +1,7 @@
 import { useMemo, useCallback, useState } from 'react';
-import { useNavigate, useParams } from 'react-router-dom';
+import { useNavigate, useParams } from 'react-router';
 import { renderPostContentHtml } from '../utils/postContent';
+import { handleMdCodeBlockUiClick } from '../utils/enhanceCodeBlocks';
 import { loginPath, registerPath } from '../utils/authRedirect';
 import { useForumLimits } from '../hooks/useForumLimits';
 import { notify } from '@/lib/notify';
@@ -105,40 +106,12 @@ export default function PostContent({
      }
      return;
    }
-    const foldBtn = target.closest<HTMLElement>('[data-code-fold]');
-    if (foldBtn) {
-      e.preventDefault();
-      const block = foldBtn.closest('.md-codeblock');
-      if (!block) return;
-      const collapsed = block.classList.toggle('md-codeblock--collapsed');
-      const lineCount = parseInt(block.getAttribute('data-line-count') || '0', 10)
-        || block.querySelectorAll('.md-code-line').length
-        || 1;
-      if (collapsed && lineCount <= 5) block.classList.add('md-codeblock--short');
-      else block.classList.remove('md-codeblock--short');
-      foldBtn.textContent = collapsed ? '展开' : '收起';
-      return;
-    }
-    const copyBtn = target.closest<HTMLElement>('[data-code-copy]');
-    if (copyBtn) {
-      e.preventDefault();
-      const block = copyBtn.closest('.md-codeblock');
-      const bodies = block?.querySelectorAll('.md-code-line__body');
-      const text = bodies && bodies.length
-        ? [...bodies].map(el => el.textContent ?? '').join('\n')
-        : (block?.querySelector('pre')?.textContent ?? '');
-      try {
-        await navigator.clipboard.writeText(text);
-        const prev = copyBtn.textContent;
-        copyBtn.textContent = '已复制';
-        copyBtn.classList.add('is-copied');
-        window.setTimeout(() => {
-          copyBtn.textContent = prev || '复制';
-          copyBtn.classList.remove('is-copied');
-        }, 1600);
-      } catch {
-        notify.error('复制失败');
+    try {
+      if (await handleMdCodeBlockUiClick(target)) {
+        e.preventDefault();
      }
+    } catch {
+      notify.error('复制失败');
    }
  }, [nav, openLightbox, onRequestReply, onUnlocked, postId, unlocking]);

--- a/frontend/src/components/PostListItem.tsx
+++ b/frontend/src/components/PostListItem.tsx
@@ -1,5 +1,5 @@
 import { memo } from 'react';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import { MessageCircle } from 'lucide-react';
 import BoardBadge from '@/components/BoardBadge';
 import FeaturedIcon from '@/components/FeaturedIcon';
@@ -39,9 +39,10 @@ function PostListItem({ post, sort = 'latest', boardId = 0, onSelect }: Props) {
  const showLastReply = !!post.last_reply_at && (!!post.last_reply_user || !!lastReplyName);
  const commentCount = post.comment_count ?? 0;
  const href = postPath(post.id);
-  const firstImage = firstImageFromHTML(post.content || '');
+  // 列表接口已预算摘要/首图且不下发正文；content 仅在详情等非列表场景有值时兜底
+  const firstImage = post.first_image || firstImageFromHTML(post.content || '');
  const thumbSrc = showThumb && firstImage ? toPostImageThumbSrc(firstImage) : null;
-  const excerpt = showExcerpt ? excerptFromHTML(post.content || '', 60) : '';
+  const excerpt = showExcerpt ? (post.excerpt || excerptFromHTML(post.content || '', 60)) : '';
  const showBoardBadge = !!post.board && boardId !== post.board.id;

  const openPost = () => onSelect(post.id);
@@ -71,10 +72,10 @@ function PostListItem({ post, sort = 'latest', boardId = 0, onSelect }: Props) {

  const titleRow = (
    <div className="post-title-row">
-      {post.pinned && (
+      {post.pinned > 0 && (
        <span className="post-pin-badge" title="全局置顶">全局置顶</span>
      )}
-      {post.board_pinned && (
+      {(post.board_pinned ?? 0) > 0 && (
        <span className="post-pin-badge post-pin-badge--board" title="板块置顶">板块置顶</span>
      )}
      {post.featured && (
--- a/frontend/src/components/PostListSkeleton.tsx
+++ b/frontend/src/components/PostListSkeleton.tsx
@@ -1,12 +0,0 @@
-import type { ForumLimitsPublic } from '../api/types';
-
-export type FeedListStyle = ForumLimitsPublic['feed_list_style'];
-
-/** 虚拟列表行高预估值 */
-export function feedListRowEstimate(style: FeedListStyle): number {
-  switch (style) {
-    case 'excerpt': return 68;
-    case 'thumbnail': return 72;
-    default: return 64;
-  }
-}
--- a/frontend/src/components/PostManageMenu.tsx
+++ b/frontend/src/components/PostManageMenu.tsx
@@ -151,11 +151,11 @@ export default function PostManageMenu({
            </DropdownMenuItem>
            <DropdownMenuItem onSelect={onPin}>
              <Pin size={14} aria-hidden />
-              {post.pinned ? '取消全局置顶' : '全局置顶'}
+              {post.pinned > 0 ? '取消全局置顶' : '全局置顶'}
            </DropdownMenuItem>
            <DropdownMenuItem onSelect={onBoardPin}>
              <Pin size={14} aria-hidden />
-              {post.board_pinned ? '取消板块置顶' : '板块置顶'}
+              {(post.board_pinned ?? 0) > 0 ? '取消板块置顶' : '板块置顶'}
            </DropdownMenuItem>
            <DropdownMenuSeparator />

--- a/frontend/src/components/PullToRefresh.tsx
+++ b/frontend/src/components/PullToRefresh.tsx
@@ -21,6 +21,12 @@ function pickScrollEl(): HTMLElement | null {
    return null;
  }

+  // Feed 文档滚动模式（.app-shell--doc-scroll）：滚动根是 document（html）。
+  // 触摸事件会冒泡到 html，scrollTop 即窗口滚动量。
+  if (document.querySelector('.app-shell--doc-scroll')) {
+    return document.scrollingElement as HTMLElement | null;
+  }
+
  // 手机 Feed 整栏滚动（板块 / 排序栏可滚走）
  const mobileFeed = document.querySelector<HTMLElement>('.main-content--feed-mobile-scroll');
  if (mobileFeed) return mobileFeed;
@@ -31,7 +37,7 @@ function pickScrollEl(): HTMLElement | null {
  const page = document.querySelector<HTMLElement>('.page-wrap:not(.page-wrap--feed)');
  if (page) return page;

-  const showcase = document.querySelector<HTMLElement>('.showcase-page');
+  const showcase = document.querySelector<HTMLElement>('.showcase-panel');
  if (showcase) return showcase.closest<HTMLElement>('.main-content') ?? showcase;

  const admin = document.querySelector<HTMLElement>('.admin-main');
--- a/frontend/src/components/RightPanel.tsx
+++ b/frontend/src/components/RightPanel.tsx
@@ -1,7 +1,7 @@
 import { useMemo } from 'react';
 import { ListTree, MessageCircle, Tags, Link2, UserPlus } from 'lucide-react';
-import { useLocation, useSearchParams, useNavigate } from 'react-router-dom';
-import type { AsideWidget, RecentComment, RecentUser, TagCount, User, ForumStats, FriendLink } from '../api/types';
+import { useLocation, useSearchParams, useNavigate } from 'react-router';
+import type { AsideWidget, RecentComment, RecentUser, TagCount, User, UserActivityStats, UserPublic, ForumStats, FriendLink } from '../api/types';
 import type { PostHeading } from '../utils/postHeadings';
 import { useSiteBranding } from '../hooks/useSiteBranding';
 import { formatShortDateTime, formatTime } from '../utils/content';
@@ -20,6 +20,9 @@ export type PostDetailAside = {
  headings: PostHeading[];
  scrollRoot?: HTMLElement | null;
  outlineTitle?: string;
+  /** SSR/预热快照携带的作者主页资料与统计（首帧直接渲染，缺省卡片自行拉取） */
+  authorProfile?: UserPublic | null;
+  authorStats?: UserActivityStats | null;
 };

 interface Props {
@@ -237,6 +240,8 @@ export default function RightPanel({
              author={postDetail.author}
              publishedAt={postDetail.publishedAt}
              viewCount={postDetail.viewCount}
+              initialProfile={postDetail.authorProfile ?? null}
+              initialStats={postDetail.authorStats ?? null}
            />
          ) : null}
          <div className="widget-card widget-card--outline">
--- a/frontend/src/components/ShowcaseAsideWidget.tsx
+++ b/frontend/src/components/ShowcaseAsideWidget.tsx
@@ -1,6 +1,6 @@
 import { useEffect, useState } from 'react';
 import { Globe2 } from 'lucide-react';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import { api } from '../api/client';
 import type { CommunityShowcaseItem } from '../api/types';
 import { getSessionSnapshot, setSessionSnapshot } from '../utils/sessionPageCache';
@@ -19,12 +19,14 @@ export default function ShowcaseAsideWidget() {
  useEffect(() => {
    let cancelled = false;
    const hit = getSessionSnapshot<CommunityShowcaseItem[]>(SHOWCASE_KEY);
-    if (hit !== undefined) {
+    // 非空快照直接用；空数组可能是启动竞态假空，仍再拉
+    if (hit !== undefined && hit.length > 0) {
      setItems(hit);
      setLoading(false);
      return;
    }
-    setLoading(true);
+    if (hit !== undefined) setItems(hit);
+    setLoading(hit === undefined);
    api.communityShowcase()
      .then((r) => {
        if (cancelled) return;
@@ -33,10 +35,8 @@ export default function ShowcaseAsideWidget() {
        setItems(next);
      })
      .catch(() => {
-        if (!cancelled) {
-          setSessionSnapshot(SHOWCASE_KEY, []);
-          setItems([]);
-        }
+        // 失败不写空快照，避免假空粘死
+        if (!cancelled && hit === undefined) setItems([]);
      })
      .finally(() => {
        if (!cancelled) setLoading(false);
@@ -54,17 +54,13 @@ export default function ShowcaseAsideWidget() {
          setItems(next);
        })
        .catch(() => {
-          if (opts.showLoading) {
-            setSessionSnapshot(SHOWCASE_KEY, []);
-            setItems([]);
-          }
-          // 软刷新失败：保持旧 UI
+          // 软刷新 / 强刷失败：保持旧 UI，不写空快照
        })
        .finally(() => setLoading(false));
    };
    const applyHitOrReload = (showLoading: boolean) => {
      const hit = getSessionSnapshot<CommunityShowcaseItem[]>(SHOWCASE_KEY);
-      if (hit !== undefined) {
+      if (hit !== undefined && hit.length > 0) {
        setItems(hit);
        setLoading(false);
        return;
--- a/frontend/src/components/Sidebar.tsx
+++ b/frontend/src/components/Sidebar.tsx
@@ -1,7 +1,7 @@
 import {
  Home, Star, LayoutDashboard, FolderGit2, FolderKanban, ArrowLeft, FileText, Link2, Globe2,
 } from 'lucide-react';
-import { useNavigate, useLocation, useSearchParams, Link } from 'react-router-dom';
+import { useNavigate, useLocation, useSearchParams, Link } from 'react-router';
 import type { Board } from '../api/types';
 import type { PostHeading } from '../utils/postHeadings';
 import { useAuth } from '../hooks/useAuth';
--- a/frontend/src/components/SiteFooter.tsx
+++ b/frontend/src/components/SiteFooter.tsx
@@ -1,6 +1,6 @@
 import { useSiteBranding } from '../hooks/useSiteBranding';
 import { useMediaQuery } from '../hooks/useTheme';
-import { Link } from 'react-router-dom';
+import { Link } from 'react-router';
 import { useSitePages } from '../hooks/useSitePages';
 import { pagePath } from '../utils/permalink';
 import { useForumLimits } from '../hooks/useForumLimits';
--- a/frontend/src/components/StaticFeedList.tsx
+++ b/frontend/src/components/StaticFeedList.tsx
@@ -1,227 +0,0 @@
-import type { PostItem } from '../api/types';
-import type { FeedSort } from './FeedSortBar';
-import { getBoardThemeIndex } from '../utils/boardTheme';
-import { postPath } from '../utils/permalink';
-import { useForumLimits } from '../hooks/useForumLimits';
-
-import { formatTime } from '../utils/content';
-import { MessageCircle } from 'lucide-react';
-
-/** 与 Go formatSSRRelativeTime / 前端 formatTime 对齐的列表时间 */
-
-function stripHtmlPlain(html: string): string {
-  if (!html) return '';
-  const t = html
-    .replace(/<script[\s\S]*?<\/script>/gi, ' ')
-    .replace(/<style[\s\S]*?<\/style>/gi, ' ')
-    .replace(/<[^>]+>/g, ' ')
-    .replace(/&nbsp;/gi, ' ')
-    .replace(/\s+/g, ' ')
-    .trim();
-  return t;
-}
-
-function truncateRunes(s: string, max: number): string {
-  const chars = Array.from(s);
-  if (chars.length <= max) return s;
-  return chars.slice(0, max).join('');
-}
-
-function firstImageSrc(html: string): string {
-  const m = html.match(/<img[^>]+src=["']([^"']+)["']/i);
-  const src = m?.[1]?.trim() || '';
-  if (!src || src.startsWith('data:')) return '';
-  return src;
-}
-
-function displayName(post: PostItem): string {
-  const n = post.user?.nickname?.trim() || post.user?.username?.trim();
-  return n || '用户';
-}
-
-type Props = {
-  posts: PostItem[];
-  sort: FeedSort;
-  boardId: number;
-};
-
-/** 与 Go writeSSRPostRow 同构的静态列表（hydrate 首帧专用） */
-export default function StaticFeedList({ posts, sort, boardId }: Props) {
-  const { limits } = useForumLimits();
-  const style = limits.feed_list_style ?? 'title';
-  const titleOnly = style === 'title';
-  const needExcerpt = style === 'excerpt' || style === 'thumbnail';
-  const needThumb = style === 'thumbnail';
-
-  return (
-    <div className="post-list-scroll post-list-scroll--ssr">
-      <div className="content-surface content-surface--ssr">
-        {posts.length === 0 ? (
-          <div className="feed-empty">暂无帖子</div>
-        ) : (
-          posts.map((post) => {
-            const href = postPath(post.id, limits);
-            const author = displayName(post);
-            const initial = Array.from(author)[0] || '?';
-            let excerpt = '';
-            let thumb = '';
-            if (needExcerpt || needThumb) {
-              excerpt = truncateRunes(stripHtmlPlain(post.content || ''), 120);
-            }
-            if (needThumb) thumb = firstImageSrc(post.content || '');
-
-            const rowClass = [
-              'post-row',
-              'post-row--v2',
-              titleOnly ? 'post-row--title-only' : '',
-              thumb ? 'post-row--has-thumb' : '',
-            ].filter(Boolean).join(' ');
-
-            let timeLabel = formatTime(post.created_at);
-            if (sort === 'reply' && !post.last_reply_at) {
-              timeLabel = '暂无回复';
-            }
-            const lastReplyName = post.last_reply_user?.nickname?.trim()
-              || post.last_reply_user?.username?.trim()
-              || post.last_reply_guest_nick?.trim()
-              || '';
-            const showLastReply = !!post.last_reply_at && (!!post.last_reply_user || !!lastReplyName);
-            const commentCount = post.comment_count ?? 0;
-
-            const hasTypeBadge = post.post_type === 'question'
-              || post.post_type === 'poll'
-              || post.post_type === 'lottery'
-              || (post.post_type === 'bounty' && (
-                (post.bounty_status === 'open' && (post.bounty_points ?? 0) > 0)
-                || post.bounty_status === 'awarded'
-              ));
-
-            const titleRow = (
-              <div className="post-title-row">
-                {post.pinned ? (
-                  <span className="post-pin-badge" title="全局置顶">全局置顶</span>
-                ) : null}
-                {post.board_pinned ? (
-                  <span className="post-pin-badge post-pin-badge--board" title="板块置顶">板块置顶</span>
-                ) : null}
-                {post.featured ? <span className="post-feature-badge" title="推荐">推荐</span> : null}
-                {post.status === 'pending' ? (
-                  <span className="post-status-badge post-status-badge--pending" title="审核中">审核中</span>
-                ) : null}
-                {post.status === 'rejected' ? (
-                  <span className="post-status-badge post-status-badge--rejected" title="未通过">未通过</span>
-                ) : null}
-                <span className="post-title">{post.title}</span>
-                {hasTypeBadge ? (
-                  <span className="post-title-type-badges">
-                    {post.post_type === 'question' ? (
-                      <span
-                        className={`post-qa-badge${post.question_resolved ? ' post-qa-badge--resolved' : ' post-qa-badge--open'}`}
-                        title={post.question_resolved ? '已解决' : '未解决'}
-                      >
-                        {post.question_resolved ? '已解决' : '未解决'}
-                      </span>
-                    ) : null}
-                    {post.post_type === 'poll' ? (
-                      <span className="post-type-badge post-type-badge--poll" title="投票">投票</span>
-                    ) : null}
-                    {post.post_type === 'bounty' && post.bounty_status === 'open' && (post.bounty_points ?? 0) > 0 ? (
-                      <span className="post-bounty-badge post-bounty-badge--open" title="悬赏">
-                        悬赏 {post.bounty_points}
-                      </span>
-                    ) : null}
-                    {post.post_type === 'bounty' && post.bounty_status === 'awarded' ? (
-                      <span className="post-bounty-badge post-bounty-badge--awarded" title="已采纳">已采纳</span>
-                    ) : null}
-                    {post.post_type === 'lottery' ? (
-                      <span className="post-type-badge post-type-badge--lottery" title="抽奖">
-                        {post.lottery_status === 'drawn' ? '已开奖' : '抽奖'}
-                      </span>
-                    ) : null}
-                  </span>
-                ) : null}
-              </div>
-            );
-
-            const metaLeft = (
-              <div className="post-meta-left">
-                {boardId === 0 && post.board?.id ? (
-                  <span className="post-list-board-btn">
-                    <span
-                      className={`post-list-board-badge board-badge board-badge--${getBoardThemeIndex(post.board)}`}
-                    >
-                      {post.board.name}
-                    </span>
-                  </span>
-                ) : null}
-                <span className="post-meta-author">{author}</span>
-                <span className="post-meta-sep post-meta-sep--before-time" aria-hidden>·</span>
-                <span className="post-meta-time post-meta-time--created">{timeLabel}</span>
-                {showLastReply ? (
-                  <span className="post-meta-last-reply">
-                    <span className="post-meta-last-reply-arrow" aria-hidden>←</span>
-                    {/* 外层是 <a class="post-row">，禁止嵌套 a */}
-                    <span className="post-meta-last-reply-user">{lastReplyName}</span>
-                    <span className="post-meta-last-reply-time">{formatTime(post.last_reply_at!)}</span>
-                  </span>
-                ) : null}
-              </div>
-            );
-
-            const stats = (
-              <div className="post-stats">
-                <span
-                  className={`post-stat${commentCount === 0 ? ' post-stat--zero' : ''}`}
-                  title="评论"
-                >
-                  <MessageCircle aria-hidden />
-                  {commentCount}
-                </span>
-              </div>
-            );
-
-            return (
-              <a key={post.id} className={rowClass} href={href}>
-                {post.user?.avatar ? (
-                  <span className="post-avatar user-link--avatar-only">
-                    <img src={post.user.avatar} alt="" loading="lazy" decoding="async" />
-                  </span>
-                ) : (
-                  <span className="post-avatar user-link--avatar-only">{initial}</span>
-                )}
-                {thumb ? (
-                  <div className="post-main post-main--with-thumb">
-                    <div className="post-content">
-                      {titleRow}
-                      {excerpt ? <p className="post-excerpt">{excerpt}</p> : null}
-                      <div className="post-meta post-meta--inline">
-                        {metaLeft}
-                        {stats}
-                      </div>
-                    </div>
-                    <div className="post-aside">
-                      <div className="post-thumb" aria-hidden>
-                        <img src={thumb} alt="" loading="lazy" decoding="async" />
-                      </div>
-                    </div>
-                  </div>
-                ) : (
-                  <div className="post-main">
-                    <div className="post-text">
-                      {titleRow}
-                      {excerpt ? <p className="post-excerpt">{excerpt}</p> : null}
-                    </div>
-                    <div className="post-meta">
-                      {metaLeft}
-                      {stats}
-                    </div>
-                  </div>
-                )}
-              </a>
-            );
-          })
-        )}
-      </div>
-    </div>
-  );
-}
--- a/frontend/src/components/TagCloud.tsx
+++ b/frontend/src/components/TagCloud.tsx
@@ -1,5 +1,5 @@
 import { useMemo } from 'react';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import type { TagCount } from '../api/types';
 import { cn } from '@/lib/utils';

--- a/frontend/src/components/UserLink.tsx
+++ b/frontend/src/components/UserLink.tsx
@@ -1,5 +1,5 @@
 import type { MouseEvent, ReactNode } from 'react';
-import { Link } from 'react-router-dom';
+import { Link } from 'react-router';
 import { cn } from '@/lib/utils';
 import type { UserBadge } from '../api/types';
 import { userPath } from '../utils/userPath';
--- a/frontend/src/components/VirtualPostList.tsx
+++ b/frontend/src/components/VirtualPostList.tsx
@@ -1,316 +0,0 @@
-import { useRef, useEffect, useLayoutEffect, useState, useCallback } from 'react';
-import { useNavigate } from 'react-router-dom';
-import { useVirtualizer } from '@tanstack/react-virtual';
-import { Inbox, SearchX } from 'lucide-react';
-import { Button } from '@/components/ui/button';
-import PostListItem from './PostListItem';
-import { feedListRowEstimate } from './PostListSkeleton';
-import FeedPagination from './FeedPagination';
-import { InFlowSiteFooter } from './SiteFooter';
-import { useAuth } from '../hooks/useAuth';
-import { useForumLimits } from '../hooks/useForumLimits';
-import { useMediaQuery } from '../hooks/useTheme';
-import { loginPath } from '../utils/authRedirect';
-import { dispatchOpenPostSearch } from '../hooks/usePostSearch';
-import type { PostItem } from '../api/types';
-import type { FeedSort } from './FeedSortBar';
-import { getDefaultFeedSortFromCache } from './FeedSortBar';
-
-interface Props {
-  posts: PostItem[];
-  sort?: FeedSort;
-  loading: boolean;
-  /** 当前页之后是否还有更多 */
-  hasMore: boolean;
-  /** 是否显示底部分页控件 */
-  showPagination: boolean;
-  page: number;
-  totalPages: number;
-  postTotal: number;
-  onPageChange: (page: number) => void;
-  onSelect: (id: number) => void;
-  restoreScrollTop?: number | null;
-  resetScrollKey?: number;
-  onScrollTopChange?: (top: number) => void;
-  onScrollRestored?: () => void;
-  /** 搜索关键词（用于空态文案） */
-  keyword?: string;
-  /** 是否为帖子搜索（区别于标签筛选） */
-  isSearchMode?: boolean;
-  searchKeyword?: string;
-  searchAuthor?: string;
-  searchTitleOnly?: boolean;
-  searchScopeBoardId?: number;
-  onClearSearch?: () => void;
-  /** 当前板块 id，0 表示全部 */
-  boardId?: number;
-  /** 当前板块名 */
-  boardName?: string;
-  /** 站点是否尚无任何板块（全新安装） */
-  noBoards?: boolean;
-}
-
-/** 手机 Feed 整栏滚动时的容器 */
-function getMobileFeedScrollEl(): HTMLElement | null {
-  return document.querySelector('.main-content--feed-mobile-scroll');
-}
-
-export default function VirtualPostList({
-  posts,
-  sort = getDefaultFeedSortFromCache(),
-  loading,
-  hasMore,
-  showPagination,
-  page,
-  totalPages,
-  postTotal,
-  onPageChange,
-  onSelect,
-  restoreScrollTop,
-  resetScrollKey = 0,
-  onScrollTopChange,
-  onScrollRestored,
-  keyword = '',
-  isSearchMode = false,
-  searchKeyword = '',
-  searchAuthor = '',
-  searchTitleOnly = false,
-  searchScopeBoardId = 0,
-  onClearSearch,
-  boardId = 0,
-  boardName = '',
-  noBoards = false,
-}: Props) {
-  const nav = useNavigate();
-  const { user } = useAuth();
-  const { limits } = useForumLimits();
-  const isMobile = useMediaQuery('(max-width: 768px)');
-  const feedStyle = limits.feed_list_style ?? 'title';
-  const rowEstimate = feedListRowEstimate(feedStyle);
-  const parentRef = useRef<HTMLDivElement>(null);
-  const restoredRef = useRef(false);
-  const onScrollTopChangeRef = useRef(onScrollTopChange);
-  const onScrollRestoredRef = useRef(onScrollRestored);
-  onScrollTopChangeRef.current = onScrollTopChange;
-  onScrollRestoredRef.current = onScrollRestored;
-
-  const [scrollMargin, setScrollMargin] = useState(0);
-
-  const getScrollElement = useCallback(() => {
-    if (isMobile) {
-      return getMobileFeedScrollEl() ?? parentRef.current;
-    }
-    return parentRef.current;
-  }, [isMobile]);
-
-  /** 列表相对整栏滚动容器顶部的偏移，供虚拟列表对齐 */
-  useLayoutEffect(() => {
-    if (!isMobile) {
-      setScrollMargin(0);
-      return;
-    }
-    const main = getMobileFeedScrollEl();
-    const list = parentRef.current;
-    if (!main || !list) return;
-
-    const update = () => {
-      // 相对 main 内容顶（含当前 scrollTop），避免 offsetParent 链不准
-      const next = Math.max(
-        0,
-        Math.round(list.getBoundingClientRect().top - main.getBoundingClientRect().top + main.scrollTop),
-      );
-      setScrollMargin(prev => (prev === next ? prev : next));
-    };
-    update();
-
-    const ro = new ResizeObserver(update);
-    ro.observe(main);
-    const boardBar = main.querySelector('.mobile-board-bar');
-    const feedTop = main.querySelector('.feed-top');
-    if (boardBar) ro.observe(boardBar);
-    if (feedTop) ro.observe(feedTop);
-    return () => ro.disconnect();
-  }, [isMobile, posts.length, loading, keyword, boardId]);
-
-  const virtualizer = useVirtualizer({
-    count: posts.length,
-    getScrollElement,
-    estimateSize: () => rowEstimate,
-    overscan: 8,
-    scrollMargin: isMobile ? scrollMargin : 0,
-    measureElement:
-      typeof window !== 'undefined' && !navigator.userAgent.includes('Firefox')
-        ? (el) => el.getBoundingClientRect().height
-        : undefined,
-  });
-
-  const showEnd = !hasMore && !showPagination && posts.length > 0 && !loading;
-  const isInitialLoad = loading && posts.length === 0;
-  const isEmpty = !loading && posts.length === 0;
-  const isSearchEmpty = isEmpty && (isSearchMode || !!keyword.trim());
-  const composeTarget = boardId > 0 ? `/compose?board=${boardId}` : '/compose';
-  const isAdmin = user?.role === 'admin';
-
-  useLayoutEffect(() => {
-    if (resetScrollKey <= 0) return;
-    const el = getScrollElement();
-    if (el) {
-      el.scrollTop = 0;
-      virtualizer.scrollToOffset(0);
-    }
-    restoredRef.current = true;
-    onScrollTopChangeRef.current?.(0);
-  }, [resetScrollKey, virtualizer, getScrollElement]);
-
-  useLayoutEffect(() => {
-    // 收到新的恢复目标时允许再次 restore；null 表示已消费，勿动标记
-    if (restoreScrollTop == null) return;
-    restoredRef.current = false;
-  }, [restoreScrollTop]);
-
-  useLayoutEffect(() => {
-    if (restoreScrollTop == null || restoredRef.current || posts.length === 0) return;
-    const el = getScrollElement();
-    if (el) {
-      el.scrollTop = restoreScrollTop;
-    } else {
-      virtualizer.scrollToOffset(restoreScrollTop);
-    }
-    restoredRef.current = true;
-    onScrollRestoredRef.current?.();
-  }, [restoreScrollTop, posts.length, virtualizer, getScrollElement]);
-
-  useEffect(() => {
-    const el = getScrollElement();
-    if (!el) return;
-    const onScroll = () => {
-      onScrollTopChangeRef.current?.(el.scrollTop);
-    };
-    el.addEventListener('scroll', onScroll, { passive: true });
-    return () => el.removeEventListener('scroll', onScroll);
-  }, [getScrollElement, isMobile]);
-
-  const searchSummaryParts: string[] = [];
-  if (searchKeyword.trim()) searchSummaryParts.push(`关键词「${searchKeyword.trim()}」`);
-  if (searchAuthor.trim()) searchSummaryParts.push(`作者 ${searchAuthor.trim()}`);
-  if (searchTitleOnly && searchKeyword.trim()) searchSummaryParts.push('仅标题');
-  if (searchScopeBoardId > 0 && boardName) searchSummaryParts.push(`板块 ${boardName}`);
-
-  const emptyActions = (
-    <div className="empty-feed-actions">
-      {noBoards ? (
-        isAdmin ? (
-          <Button type="button" size="sm" onClick={() => nav('/admin/boards')}>
-            去创建板块
-          </Button>
-        ) : (
-          <Button type="button" size="sm" variant="outline" onClick={() => nav('/')}>
-            刷新看看
-          </Button>
-        )
-      ) : isSearchEmpty ? (
-        <>
-          <Button type="button" size="sm" variant="outline" onClick={dispatchOpenPostSearch}>
-            修改搜索
-          </Button>
-          <Button type="button" size="sm" variant="outline" onClick={() => (onClearSearch ? onClearSearch() : nav('/'))}>
-            清除筛选
-          </Button>
-          <Button type="button" size="sm" variant="outline" onClick={() => nav('/')}>
-            返回全部帖子
-          </Button>
-        </>
-      ) : (
-        <>
-          {boardId > 0 && (
-            <Button type="button" size="sm" variant="outline" onClick={() => nav('/')}>
-              看看其他板块
-            </Button>
-          )}
-          {user ? (
-            <Button type="button" size="sm" onClick={() => nav(composeTarget)}>
-              {boardName ? `成为「${boardName}」第一帖` : '发第一帖'}
-            </Button>
-          ) : (
-            <Button type="button" size="sm" onClick={() => nav(loginPath(composeTarget))}>
-              登录后发帖
-            </Button>
-          )}
-        </>
-      )}
-    </div>
-  );
-
-  return (
-    <div className="post-list-scroll" ref={parentRef}>
-      {isInitialLoad ? null : isEmpty ? (
-        <div className="empty-feed" role="status">
-          {isSearchEmpty
-            ? <SearchX className="empty-feed-icon" aria-hidden size={36} strokeWidth={1.5} />
-            : <Inbox className="empty-feed-icon" aria-hidden size={36} strokeWidth={1.5} />}
-          <p>
-            {noBoards
-              ? '暂无板块'
-              : isSearchEmpty
-                ? '没有匹配的帖子'
-                : '暂无帖子'}
-          </p>
-          <p className="empty-feed-hint">
-            {noBoards
-              ? (isAdmin ? '创建第一个板块后即可开始发帖' : '管理员创建板块后即可参与讨论')
-              : isSearchEmpty
-                ? (searchSummaryParts.length > 0
-                  ? `当前筛选：${searchSummaryParts.join(' · ')}。试试更短的关键词或放宽条件。`
-                  : '试试更短的关键词，或浏览标签云 / 板块')
-                : boardName
-                  ? `「${boardName}」还没有内容，来发第一篇吧`
-                  : '换个板块看看，或发第一篇内容'}
-          </p>
-          {emptyActions}
-        </div>
-      ) : (
-        <>
-          <div className="content-surface" style={{ height: virtualizer.getTotalSize(), position: 'relative' }}>
-            {virtualizer.getVirtualItems().map(vi => {
-              const post = posts[vi.index];
-              if (!post) return null;
-              // scrollMargin 模式下 start 含偏移，需减回才能在列表内绝对定位
-              const offsetY = isMobile ? vi.start - scrollMargin : vi.start;
-              return (
-                <div
-                  key={vi.key}
-                  data-index={vi.index}
-                  ref={virtualizer.measureElement}
-                  style={{
-                    position: 'absolute',
-                    top: 0,
-                    left: 0,
-                    width: '100%',
-                    transform: `translateY(${offsetY}px)`,
-                  }}
-                >
-                  <PostListItem post={post} sort={sort} boardId={boardId} onSelect={onSelect} />
-                </div>
-              );
-            })}
-          </div>
-          {showPagination && (
-            <div className="feed-list-footer feed-list-footer--pagination">
-              <FeedPagination
-                page={page}
-                totalPages={totalPages}
-                postTotal={postTotal}
-                loading={loading}
-                onPageChange={onPageChange}
-              />
-            </div>
-          )}
-          {showEnd && (
-            <div className="feed-list-footer feed-list-footer--end">— 已加载全部 —</div>
-          )}
-        </>
-      )}
-      <InFlowSiteFooter />
-    </div>
-  );
-}
--- a/frontend/src/components/editor/ArticleImageExtension.tsx
+++ b/frontend/src/components/editor/ArticleImageExtension.tsx
@@ -1,5 +1,6 @@
 import Image from '@tiptap/extension-image';
 import { mergeAttributes } from '@tiptap/core';
+import { isStickerSrc } from './ArticleStickerExtension';

 /** 单图展示形态（对齐 Notion / Medium 常见选项） */
 export type ImageDisplay = 'default' | 'wide' | 'float-left' | 'float-right';
@@ -19,6 +20,19 @@ declare module '@tiptap/core' {
 export const ArticleImage = Image.extend({
  name: 'image',

+  parseHTML() {
+    return [
+      {
+        tag: this.options.allowBase64 ? 'img[src]' : 'img[src]:not([src^="data:"])',
+        getAttrs: (node) => {
+          if (typeof node === 'string') return false;
+          if (isStickerSrc(node.getAttribute('src'))) return false;
+          return null;
+        },
+      },
+    ];
+  },
+
  addAttributes() {
    return {
      ...this.parent?.(),
--- a/frontend/src/components/editor/ArticleStickerExtension.ts
+++ b/frontend/src/components/editor/ArticleStickerExtension.ts
@@ -0,0 +1,54 @@
+import { Node, mergeAttributes } from '@tiptap/core';
+
+/** 贴纸资源路径：评论、私信、发帖共用 /stickers/ */
+export function isStickerSrc(src: string | null | undefined): boolean {
+  return typeof src === 'string' && src.includes('/stickers/');
+}
+
+/**
+ * 行内表情贴纸。文章 Image 是 block，不能拿来插表情，否则会独自占一段。
+ * 解析 HTML 时优先于普通 img，避免贴纸被收成通栏大图。
+ */
+export const ArticleSticker = Node.create({
+  name: 'sticker',
+  group: 'inline',
+  inline: true,
+  atom: true,
+  selectable: true,
+  draggable: true,
+  priority: 60,
+
+  addAttributes() {
+    return {
+      src: { default: null },
+      alt: { default: '' },
+    };
+  },
+
+  parseHTML() {
+    return [
+      {
+        tag: 'img[src]',
+        getAttrs: (node) => {
+          if (typeof node === 'string') return false;
+          const src = node.getAttribute('src') || '';
+          if (!isStickerSrc(src)) return false;
+          return {
+            src,
+            alt: node.getAttribute('alt') || '',
+          };
+        },
+      },
+    ];
+  },
+
+  renderHTML({ HTMLAttributes }) {
+    return [
+      'img',
+      mergeAttributes(HTMLAttributes, {
+        class: 'article-sticker',
+        draggable: 'false',
+      }),
+    ];
+  },
+});
--- a/frontend/src/components/emoji/StickerPicker.tsx
+++ b/frontend/src/components/emoji/StickerPicker.tsx
@@ -36,17 +36,58 @@ export default function StickerPicker({ onSelect }: Props) {
  }, [active]);

  useEffect(() => {
-    const el = gridRef.current?.querySelectorAll<HTMLElement>('[role="option"]')[focusIndex];
-    el?.focus();
-  }, [focusIndex, stickers]);
+    if (loading || stickers.length === 0) return;
+    gridRef.current?.focus();
+  }, [loading, stickers]);

  const onKeyDown = useCallback((e: React.KeyboardEvent) => {
-    const cols = 8;
-    if (e.key === 'ArrowRight') { e.preventDefault(); setFocusIndex((i) => Math.min(stickers.length - 1, i + 1)); }
-    else if (e.key === 'ArrowLeft') { e.preventDefault(); setFocusIndex((i) => Math.max(0, i - 1)); }
-    else if (e.key === 'ArrowDown') { e.preventDefault(); setFocusIndex((i) => Math.min(stickers.length - 1, i + cols)); }
-    else if (e.key === 'ArrowUp') { e.preventDefault(); setFocusIndex((i) => Math.max(0, i - cols)); }
-    else if (e.key === 'Enter' || e.key === ' ') {
+    const items = gridRef.current?.querySelectorAll<HTMLElement>('[role="option"]');
+    if (!items?.length) return;
+
+    const moveTo = (next: number) => {
+      e.preventDefault();
+      const i = Math.max(0, Math.min(items.length - 1, next));
+      setFocusIndex(i);
+      items[i]?.focus();
+    };
+
+    if (e.key === 'ArrowRight') {
+      moveTo(focusIndex + 1);
+      return;
+    }
+    if (e.key === 'ArrowLeft') {
+      moveTo(focusIndex - 1);
+      return;
+    }
+    if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
+      // 颜文字宽度不固定，按视觉行列找下一格，避免按固定 8 列错位
+      e.preventDefault();
+      const cur = items[focusIndex];
+      if (!cur) return;
+      const cr = cur.getBoundingClientRect();
+      const cx = cr.left + cr.width / 2;
+      const cy = cr.top + cr.height / 2;
+      const dir = e.key === 'ArrowDown' ? 1 : -1;
+      let best = -1;
+      let bestScore = Infinity;
+      items.forEach((el, i) => {
+        if (i === focusIndex) return;
+        const r = el.getBoundingClientRect();
+        const dy = (r.top + r.height / 2) - cy;
+        if (dy * dir <= 6) return;
+        const score = Math.abs(dy) * 24 + Math.abs((r.left + r.width / 2) - cx);
+        if (score < bestScore) {
+          bestScore = score;
+          best = i;
+        }
+      });
+      if (best >= 0) {
+        setFocusIndex(best);
+        items[best]?.focus();
+      }
+      return;
+    }
+    if (e.key === 'Enter' || e.key === ' ') {
      e.preventDefault();
      const s = stickers[focusIndex];
      if (s) onSelect(s);
@@ -73,6 +114,7 @@ export default function StickerPicker({ onSelect }: Props) {
        ref={gridRef}
        className="sticker-picker-grid"
        role="listbox"
+        tabIndex={0}
        aria-label={`${active}贴纸`}
        aria-activedescendant={`${autoId}-opt-${focusIndex}`}
        onKeyDown={onKeyDown}
@@ -82,33 +124,35 @@ export default function StickerPicker({ onSelect }: Props) {
        ) : stickers.length === 0 ? (
          <div className="sticker-picker-loading">暂无贴纸</div>
        ) : (
-          stickers.map((s, i) => (
-            <button
-              key={s.id}
-              id={`${autoId}-opt-${i}`}
-              type="button"
-              role="option"
-              tabIndex={focusIndex === i ? 0 : -1}
-              aria-selected={focusIndex === i}
-              aria-label={s.name}
-              className="sticker-picker-item"
-              onClick={() => onSelect(s)}
-              onFocus={() => setFocusIndex(i)}
-            >
-              {s.type === 'text' && s.text ? (
-                <span className="sticker-picker-text">{s.text}</span>
-              ) : (
-                <img
-                  src={s.url}
-                  alt={s.name}
-                  width={32}
-                  height={32}
-                  style={{ width: 32, height: 32, objectFit: 'contain' }}
-                  loading="lazy"
-                />
-              )}
-            </button>
-          ))
+          stickers.map((s, i) => {
+            const isText = s.type === 'text' && !!s.text;
+            return (
+              <button
+                key={s.id}
+                id={`${autoId}-opt-${i}`}
+                type="button"
+                role="option"
+                tabIndex={focusIndex === i ? 0 : -1}
+                aria-selected={focusIndex === i}
+                aria-label={s.name}
+                className={isText ? 'sticker-picker-item sticker-picker-item--text' : 'sticker-picker-item sticker-picker-item--image'}
+                onClick={() => onSelect(s)}
+                onFocus={() => setFocusIndex(i)}
+              >
+                {isText ? (
+                  <span className="sticker-picker-text">{s.text}</span>
+                ) : (
+                  <img
+                    src={s.url}
+                    alt={s.name}
+                    width={32}
+                    height={32}
+                    loading="lazy"
+                  />
+                )}
+              </button>
+            );
+          })
        )}
      </div>
    </div>
--- a/frontend/src/data/stickers/hot.ts
+++ b/frontend/src/data/stickers/hot.ts
@@ -15,10 +15,7 @@ export async function loadHotStickers(): Promise<Sticker[]> {
  const allEmoji = getAllStickers();
  const all = [...allEmoji, ...KAOMOJI_STICKERS];
  return all
-    .filter((s) => {
-      if (s.category === '颜文字') return true;
-      return s.aliases?.some((a) => HOT_KEYWORDS.includes(a)) || HOT_KEYWORDS.includes(s.name);
-    })
+    .filter((s) => s.aliases?.some((a) => HOT_KEYWORDS.includes(a)) || HOT_KEYWORDS.includes(s.name))
    .slice(0, 30)
    .map((s) => ({ ...s, category: '热门' as const }));
 }
--- a/frontend/src/data/stickers/kaomoji.ts
+++ b/frontend/src/data/stickers/kaomoji.ts
@@ -3,30 +3,54 @@ import type { Sticker } from './index';
 /** 颜文字贴纸 — 纯文本类型，选择器和编辑器中均作为纯文本显示 */

 export const KAOMOJI_STICKERS: Sticker[] = [
-  { id: 'km-happy', name: '开心', category: '颜文字', type: 'text', text: '(ノ´∀`)ノ', aliases: ['哈哈', '开心'] },
-  { id: 'km-laugh', name: '大笑', category: '颜文字', type: 'text', text: '(≧∇≦)ﾉ', aliases: ['哈哈哈', '笑死'] },
-  { id: 'km-cry', name: '哭', category: '颜文字', type: 'text', text: '(´；ω；`)', aliases: ['呜呜', '伤心'] },
-  { id: 'km-angry', name: '生气', category: '颜文字', type: 'text', text: 'ヽ(｀⌒´)ﾉ', aliases: ['怒', '气死'] },
-  { id: 'km-shrug', name: '无奈', category: '颜文字', type: 'text', text: '╮(°-°)╭', aliases: ['呵呵', '无语'] },
-  { id: 'km-determined', name: '加油', category: '颜文字', type: 'text', text: '(๑•̀ㅁ•́ฅ)', aliases: ['冲', '奥利给'] },
-  { id: 'km-sad', name: '难过', category: '颜文字', type: 'text', text: '( ´･ω･`)', aliases: ['失落', '低落'] },
-  { id: 'km-sparkle', name: '兴奋', category: '颜文字', type: 'text', text: '(ﾉ´ヮ`)ﾉ*: ･ﾟ', aliases: ['太棒了', '耶'] },
-  { id: 'km-tear', name: '泪奔', category: '颜文字', type: 'text', text: '(╥﹏╥)', aliases: ['泪流', '呜呜'] },
-  { id: 'km-love', name: '喜欢', category: '颜文字', type: 'text', text: '(◕ᴗ◕✿)', aliases: ['爱', '心动'] },
-  { id: 'km-cool', name: '酷', category: '颜文字', type: 'text', text: '(⌐■_■)', aliases: ['帅', '墨镜'] },
-  { id: 'km-stare', name: '盯', category: '颜文字', type: 'text', text: 'ಠ_ಠ', aliases: ['凝视', '盯着看'] },
-  { id: 'km-tableflip', name: '掀桌', category: '颜文字', type: 'text', text: '(╯°□°）╯︵ ┻━┻', aliases: ['掀桌', '愤怒'] },
-  { id: 'km-bow', name: '拜托', category: '颜文字', type: 'text', text: '(人･ω･)💦', aliases: ['求求', '拜托了'] },
-  { id: 'km-proud', name: '得意', category: '颜文字', type: 'text', text: '(￣▽￣)"', aliases: ['嘿嘿', '自满'] },
-  { id: 'km-sleep', name: '困', category: '颜文字', type: 'text', text: '(-ω-)Zzz', aliases: ['睡觉', '晚安'] },
-  { id: 'km-wave', name: '招手', category: '颜文字', type: 'text', text: '(´・ω・)ノ', aliases: ['你好', '拜拜'] },
-  { id: 'km-wink', name: '眨眼', category: '颜文字', type: 'text', text: '(◠‿◠)', aliases: ['抛媚眼', '嘿嘿'] },
-  { id: 'km-sorry', name: '抱歉', category: '颜文字', type: 'text', text: 'm(._.)m', aliases: ['对不起', '跪了'] },
-  { id: 'km-doubt', name: '疑惑', category: '颜文字', type: 'text', text: '(╬ Ò _ Ó)', aliases: ['什么', '???'] },
-  { id: 'km-hungry', name: '饿了', category: '颜文字', type: 'text', text: '(๑´ㅂ`๑)', aliases: ['想吃', '吃货'] },
-  { id: 'km-gameover', name: 'GG', category: '颜文字', type: 'text', text: '(╯︿╰﹀ )', aliases: ['GG', '完了'] },
-  { id: 'km-gift', name: '送花', category: '颜文字', type: 'text', text: '(✿◠‿◠)', aliases: ['送花', '谢谢'] },
-  { id: 'km-clap', name: '鼓掌', category: '颜文字', type: 'text', text: 'ヾ(´▽｀;)ゝ', aliases: ['呱唧', '鼓掌'] },
-  { id: 'km-cheer', name: '加油', category: '颜文字', type: 'text', text: '＼(^ω^＼)', aliases: ['冲鸭', 'go'] },
-  { id: 'km-please', name: '拜托了', category: '颜文字', type: 'text', text: '( ´･ω･`)', aliases: ['嘤嘤', '求求了'] },
+  { id: 'km-wave-half', name: '勉强挥手', category: '颜文字', type: 'text', text: '(￣▽￣)ノ', aliases: ['挥手', '嗨'] },
+  { id: 'km-shrug-ascii', name: '摊手', category: '颜文字', type: 'text', text: '¯\\_(ツ)_/¯', aliases: ['摊手', '无奈'] },
+  { id: 'km-eyeroll', name: '翻白眼', category: '颜文字', type: 'text', text: '(¬_¬)', aliases: ['白眼', '嫌弃'] },
+  { id: 'km-speechless', name: '无语凝噎', category: '颜文字', type: 'text', text: '(；一_一)', aliases: ['无语', '沉默'] },
+  { id: 'km-shock-idle', name: '震惊但不想管', category: '颜文字', type: 'text', text: '(　ﾟдﾟ)', aliases: ['震惊', '惊讶'] },
+  { id: 'km-dead-inside', name: '心死', category: '颜文字', type: 'text', text: '（。_。）', aliases: ['心死', '无力'] },
+  { id: 'km-lazy', name: '懒得动', category: '颜文字', type: 'text', text: '( ˘ω˘ )', aliases: ['懒', '摆烂'] },
+  { id: 'km-awkward-smile', name: '尴尬微笑', category: '颜文字', type: 'text', text: '(￣ω￣;)', aliases: ['尴尬', '呵呵'] },
+  { id: 'km-sob', name: '哭到抽搐', category: '颜文字', type: 'text', text: '(´；ω；｀)', aliases: ['哭', '大哭'] },
+  { id: 'km-grievance', name: '委屈巴巴', category: '颜文字', type: 'text', text: '(๑•́ ₃ •̀๑)', aliases: ['委屈', '嘤嘤'] },
+  { id: 'km-blush-blur', name: '害羞到糊掉', category: '颜文字', type: 'text', text: '(⁄ ⁄•⁄ω⁄•⁄ ⁄)', aliases: ['害羞', '脸红'] },
+  { id: 'km-grit', name: '咬牙切齿', category: '颜文字', type: 'text', text: '(╬ ￣皿￣)', aliases: ['怒', '生气'] },
+  { id: 'km-short-rage', name: '暴怒短号', category: '颜文字', type: 'text', text: '(｀Д´)', aliases: ['怒', '气死'] },
+  { id: 'km-fist-rage', name: '气到挥拳', category: '颜文字', type: 'text', text: '٩(๑`^´๑)۶', aliases: ['怒', '挥拳'] },
+  { id: 'km-grit-spark', name: '憋屈但要干', category: '颜文字', type: 'text', text: '(๑•̀ㅂ•́)و✧', aliases: ['冲', '加油'] },
+  { id: 'km-weep', name: '哭唧唧', category: '颜文字', type: 'text', text: '( ˃̣̣̥ω˂̣̣̥ )', aliases: ['哭', '呜呜'] },
+  { id: 'km-scamper', name: '撒欢跑走', category: '颜文字', type: 'text', text: 'ᕕ( ᐛ )ᕗ', aliases: ['跑', '溜了'] },
+  { id: 'km-star-throw', name: '丢星星', category: '颜文字', type: 'text', text: '(ﾉ≧∀≦)ﾉ ‥…━━━★', aliases: ['耶', '星星'] },
+  { id: 'km-flee', name: '落荒而逃', category: '颜文字', type: 'text', text: 'ε=ε=ε=┌(;*´Д`)ﾉ', aliases: ['逃', '溜'] },
+  { id: 'km-unflip', name: '把桌摆回去', category: '颜文字', type: 'text', text: '┬─┬ノ( º _ ºノ)', aliases: ['摆桌', '冷静'] },
+  { id: 'km-flip-hard', name: '狠掀桌', category: '颜文字', type: 'text', text: '(┛ಠ_ಠ)┛彡┻━┻', aliases: ['掀桌', '怒'] },
+  { id: 'km-victory-l', name: '胜利举手', category: '颜文字', type: 'text', text: '┏(＾0＾)┛', aliases: ['胜利', '耶'] },
+  { id: 'km-victory-r', name: '对面胜利', category: '颜文字', type: 'text', text: '┗(＾0＾)┓', aliases: ['胜利', '嗨'] },
+  { id: 'km-point', name: '指你呢', category: '颜文字', type: 'text', text: '(☞ﾟヮﾟ)☞', aliases: ['指', '就是你'] },
+  { id: 'km-point-back', name: '指回去', category: '颜文字', type: 'text', text: '☜(ﾟヮﾟ☜)', aliases: ['指回去', '你才'] },
+  { id: 'km-cat', name: '猫', category: '颜文字', type: 'text', text: '(=^･ω･^=)', aliases: ['猫', '喵'] },
+  { id: 'km-cat-round', name: '圆眼猫', category: '颜文字', type: 'text', text: '(ΦωΦ)', aliases: ['猫', '圆眼'] },
+  { id: 'km-bear', name: '熊', category: '颜文字', type: 'text', text: 'ʕ•ᴥ•ʔ', aliases: ['熊', '抱抱'] },
+  { id: 'km-flower-ear', name: '花耳', category: '颜文字', type: 'text', text: '◕‿◕✿', aliases: ['花', '可爱'] },
+  { id: 'km-angry-bird', name: '怒鸟', category: '颜文字', type: 'text', text: '（ꐦ°᷄д°᷅）', aliases: ['怒', '生气'] },
+  { id: 'km-smug-wolf', name: '狼尾得意', category: '颜文字', type: 'text', text: '( •̀ ω •́ )✧', aliases: ['得意', '酷'] },
+  { id: 'km-cat-wave', name: '猫招手', category: '颜文字', type: 'text', text: '~(=^‥^)ノ', aliases: ['猫', '招手'] },
+  { id: 'km-hehe', name: '呵呵', category: '颜文字', type: 'text', text: '( ´_ゝ｀)', aliases: ['呵呵', '滑稽'] },
+  { id: 'km-server-down', name: '服务器炸了', category: '颜文字', type: 'text', text: '(；´Д｀)', aliases: ['炸了', '宕机'] },
+  { id: 'km-double-shock', name: '双重震惊', category: '颜文字', type: 'text', text: '(ﾟДﾟ≡ﾟдﾟ)!?', aliases: ['震惊', '惊讶'] },
+  { id: 'km-cold-sweat', name: '冷汗惊恐', category: '颜文字', type: 'text', text: 'Σ(°△°|||)︴', aliases: ['惊恐', '惊讶'] },
+  { id: 'km-hang', name: '宕机', category: '颜文字', type: 'text', text: '(；°○° )', aliases: ['宕机', '卡死'] },
+  { id: 'km-pass-box', name: '递箱子', category: '颜文字', type: 'text', text: '( ﾟ∀ﾟ)つ□', aliases: ['递', '补丁'] },
+  { id: 'km-shoulder', name: '拍对方肩', category: '颜文字', type: 'text', text: '( ´▽｀)σ)Д`)', aliases: ['拍肩', '兄弟'] },
+  { id: 'km-silent-crash', name: '无声崩溃', category: '颜文字', type: 'text', text: '(-_-;)・・・', aliases: ['崩溃', '尴尬'] },
+  { id: 'km-blank', name: '呆滞', category: '颜文字', type: 'text', text: '(｡ŏ_ŏ)', aliases: ['发呆', '呆'] },
+  { id: 'km-side-eye', name: '眯眼嫌弃', category: '颜文字', type: 'text', text: '(๑¯ω¯๑)', aliases: ['嫌弃', '眯眼'] },
+  { id: 'km-lick', name: '舔嘴', category: '颜文字', type: 'text', text: '(๑´ڡ`๑)', aliases: ['好吃', '馋'] },
+  { id: 'km-round-laugh', name: '圆滚滚笑', category: '颜文字', type: 'text', text: '( ˶˚ ᗨ ˚˶ )', aliases: ['哈哈', '大笑'] },
+  { id: 'km-hug-ask', name: '求抱抱', category: '颜文字', type: 'text', text: '(っ˘̩╭╮˘̩)っ', aliases: ['抱抱', '求抱'] },
+  { id: 'km-rage-yi', name: '暴怒益字', category: '颜文字', type: 'text', text: '(╬ಠ益ಠ)', aliases: ['怒', '生气'] },
+  { id: 'km-fight', name: '对线准备', category: '颜文字', type: 'text', text: "(ง'̀-'́)ง", aliases: ['对线', '来战'] },
+  { id: 'km-cat-minimal', name: '极简猫', category: '颜文字', type: 'text', text: 'ᓚᘏᗢ', aliases: ['猫', '喵'] },
+  { id: 'km-pounce', name: '飞扑拥抱', category: '颜文字', type: 'text', text: '(づ｡◕‿‿◕｡)づ', aliases: ['拥抱', '爱'] },
+  { id: 'km-suspect', name: '怀疑人生', category: '颜文字', type: 'text', text: '( ◔ ʖ̯ ◔ )', aliases: ['怀疑', '思考'] },
 ];
--- a/frontend/src/hooks/useAuth.tsx
+++ b/frontend/src/hooks/useAuth.tsx
@@ -36,9 +36,13 @@ export function AuthProvider({ children }: { children: ReactNode }) {
    }
  }, []);

-  // 有 SSR 种子时仍后台校验；无种子则首屏拉取
+  // SSR +data / 冷启动预热已注入登录态种子（含已确认访客 null）时首屏不重复请求；
+  // 无种子（纯 SPA 且未预热）才首屏拉取。登录/退出均显式更新状态，不依赖 mount 校验。
  // 不清空 auth 种子：StrictMode 重挂会再次跑 useState initializer，破坏性 clear 会导致 user 空窗闪动
-  useEffect(() => { void refresh(); }, [refresh]);
+  useEffect(() => {
+    if (peekAuthSeed().hasSeed) return;
+    void refresh();
+  }, [refresh]);

  const prevUserId = useRef<number | null | 'init'>('init');
  useEffect(() => {
--- a/frontend/src/hooks/useForumLimits.ts
+++ b/frontend/src/hooks/useForumLimits.ts
@@ -2,6 +2,7 @@ import { useEffect, useState } from 'react';
 import { api } from '../api/client';
 import type { ForumLimitsPublic } from '../api/types';
 import { DEFAULT_ASIDE_WIDGETS, DEFAULT_FEED_SORT_TABS } from '../api/types';
+import { getScope } from '../ssr/scope';

 const DEFAULT_LIMITS: ForumLimitsPublic = {
  post_title_max: 128,
@@ -38,6 +39,11 @@ let inflight: Promise<ForumLimitsPublic> | null = null;
 let cacheEpoch = 0;
 const listeners = new Set<() => void>();

+/** 当前生效的论坛限制：SSR 读请求作用域，客户端读模块缓存 */
+function currentLimits(): ForumLimitsPublic | null {
+  return getScope()?.limits ?? cached;
+}
+
 function fetchLimits(): Promise<ForumLimitsPublic> {
  if (cached) return Promise.resolve(cached);
  if (inflight) return inflight;
@@ -53,8 +59,9 @@ function fetchLimits(): Promise<ForumLimitsPublic> {

 /** 获取前台可见的论坛限制配置 */
 export function useForumLimits() {
-  const [limits, setLimits] = useState<ForumLimitsPublic>(cached ?? DEFAULT_LIMITS);
-  const [loading, setLoading] = useState(!cached);
+  const [limits, setLimits] = useState<ForumLimitsPublic>(currentLimits() ?? DEFAULT_LIMITS);
+  const [loading, setLoading] = useState(!currentLimits());
+
  const [epoch, setEpoch] = useState(cacheEpoch);

  useEffect(() => {
@@ -94,8 +101,13 @@ export async function ensureForumLimitsLoaded(opts?: { force?: boolean }): Promi
  return limits;
 }

-/** 文档 SSR / 管理端：同步写入 limits 模块缓存 */
+/** 文档 SSR / 管理端：同步写入 limits 模块缓存（SSR 时只写请求作用域） */
 export function seedForumLimitsCache(limits: ForumLimitsPublic) {
+  const scope = getScope();
+  if (scope) {
+    scope.limits = limits;
+    return;
+  }
  cached = limits;
  cacheEpoch += 1;
  listeners.forEach(fn => fn());
@@ -110,5 +122,5 @@ export function invalidateForumLimitsCache() {

 /** 同步读取已缓存的论坛限制（供路径生成等非 hook 场景） */
 export function getCachedForumLimits(): ForumLimitsPublic {
-  return cached ?? DEFAULT_LIMITS;
+  return currentLimits() ?? DEFAULT_LIMITS;
 }
--- a/frontend/src/hooks/useGlobalWheelScroll.ts
+++ b/frontend/src/hooks/useGlobalWheelScroll.ts
@@ -1,62 +0,0 @@
-import { useEffect, type RefObject } from 'react';
-
-/** 判断元素是否可在指定方向继续滚动 */
-function canElementScroll(el: HTMLElement, deltaY: number): boolean {
-  const { overflowY } = getComputedStyle(el);
-  if (overflowY !== 'auto' && overflowY !== 'scroll' && overflowY !== 'overlay') {
-    return false;
-  }
-  if (el.scrollHeight <= el.clientHeight + 1) return false;
-  if (deltaY < 0) return el.scrollTop > 0;
-  return el.scrollTop + el.clientHeight < el.scrollHeight - 1;
-}
-
-/** 从目标节点向上查找首个可滚动容器 */
-function findScrollable(start: HTMLElement | null, deltaY: number, boundary: HTMLElement): HTMLElement | null {
-  let el = start;
-  while (el && el !== boundary) {
-    if (canElementScroll(el, deltaY)) return el;
-    el = el.parentElement;
-  }
-  return null;
-}
-
-/**
- * 文章页：鼠标在页面任意位置滚轮时，统一滚动主内容区。
- * 保留 textarea、表情面板等主内容区内部可滚动元素的独立滚动。
- */
-export function useGlobalWheelScroll(scrollRef: RefObject<HTMLElement | null>, enabled = true) {
-  useEffect(() => {
-    if (!enabled) return;
-    const scrollEl = scrollRef.current;
-    if (!scrollEl) return;
-
-    const root = scrollEl.closest('.app-shell') as HTMLElement | null;
-    if (!root) return;
-
-    const onWheel = (e: WheelEvent) => {
-      // Ctrl/⌘ + 滚轮用于浏览器缩放，不拦截
-      if (e.ctrlKey || e.metaKey) return;
-
-      const target = e.target instanceof HTMLElement ? e.target : null;
-      if (!target) return;
-
-      const inner = findScrollable(target, e.deltaY, root);
-      // 主内容区内部嵌套滚动（如 textarea、表情面板）保留原生行为
-      if (inner && inner !== scrollEl && scrollEl.contains(inner)) return;
-      // 主内容区外的独立滚动区（如右侧目录）保留原生行为，避免滚轮被抢走
-      if (inner && !scrollEl.contains(inner)) return;
-      // 鼠标已在主滚动容器上时，交给浏览器原生处理
-      if (inner === scrollEl) return;
-
-      const prev = scrollEl.scrollTop;
-      scrollEl.scrollTop += e.deltaY;
-      if (scrollEl.scrollTop !== prev) {
-        e.preventDefault();
-      }
-    };
-
-    root.addEventListener('wheel', onWheel, { passive: false });
-    return () => root.removeEventListener('wheel', onWheel);
-  }, [scrollRef, enabled]);
-}
--- a/frontend/src/hooks/useMonitorPageview.ts
+++ b/frontend/src/hooks/useMonitorPageview.ts
@@ -1,5 +1,5 @@
 import { useEffect, useRef } from 'react';
-import { useLocation } from 'react-router-dom';
+import { useLocation } from 'react-router';
 import { api } from '../api/client';
 import { useForumLimits } from './useForumLimits';

--- a/frontend/src/hooks/usePostSearch.ts
+++ b/frontend/src/hooks/usePostSearch.ts
@@ -1,5 +1,5 @@
 import { useCallback, useMemo } from 'react';
-import { useLocation, useNavigate, useSearchParams } from 'react-router-dom';
+import { useLocation, useNavigate, useSearchParams } from 'react-router';
 import { buildHomeUrl } from '../components/FeedSortBar';
 import { navigateFeed } from '../utils/feedCache';
 import { transitionTo } from '../utils/spaTransition';
--- a/frontend/src/hooks/useSessionResource.ts
+++ b/frontend/src/hooks/useSessionResource.ts
@@ -13,15 +13,22 @@ type Fetcher<T> = () => Promise<T>;
 * 会话快照数据源：有缓存则跳过请求；无缓存时保留上一份画面直到新数据返回。
 * 手机下拉软刷新 commit / PAGE_FORCE_REFRESH_EVENT 会应用新快照。
 */
+function isEmptyArray(value: unknown): boolean {
+  return Array.isArray(value) && value.length === 0;
+}
+
 export function useSessionResource<T>(
  key: string | null,
  fetcher: Fetcher<T>,
  opts?: {
    enabled?: boolean;
    onError?: (e: unknown) => void;
+    /** 缓存为空数组时仍后台再拉，避免启动竞态假空粘死 */
+    revalidateEmpty?: boolean;
  },
 ) {
  const enabled = opts?.enabled !== false;
+  const revalidateEmpty = opts?.revalidateEmpty === true;
  const fetcherRef = useRef(fetcher);
  fetcherRef.current = fetcher;
  const onErrorRef = useRef(opts?.onError);
@@ -49,7 +56,7 @@ export function useSessionResource<T>(
    }

    const hit = getSessionSnapshot<T>(key);
-    if (hit !== undefined) {
+    if (hit !== undefined && !(revalidateEmpty && isEmptyArray(hit))) {
      setData(hit);
      setLoading(false);
      setPending(false);
@@ -57,9 +64,16 @@ export function useSessionResource<T>(
    }

    const seq = ++seqRef.current;
-    const keep = dataRef.current !== undefined;
-    if (keep) setPending(true);
-    else setLoading(true);
+    const keep = dataRef.current !== undefined || (hit !== undefined && isEmptyArray(hit));
+    if (hit !== undefined && isEmptyArray(hit)) {
+      setData(hit);
+      setPending(true);
+      setLoading(false);
+    } else if (keep && dataRef.current !== undefined) {
+      setPending(true);
+    } else {
+      setLoading(true);
+    }

    fetcherRef.current()
      .then((next) => {
@@ -70,6 +84,7 @@ export function useSessionResource<T>(
      .catch((e: unknown) => {
        if (seq !== seqRef.current) return;
        onErrorRef.current?.(e);
+        // 失败不写空快照；已有画面则保留
        if (!keep) setData(undefined);
      })
      .finally(() => {
@@ -81,7 +96,7 @@ export function useSessionResource<T>(
    return () => {
      seqRef.current += 1;
    };
-  }, [key, enabled]);
+  }, [key, enabled, revalidateEmpty]);

  const replace = useCallback((next: T | ((prev: T | undefined) => T)) => {
    setData((prev) => {
@@ -99,18 +114,20 @@ export function useSessionResource<T>(
    const reload = (opts: { allowLoading: boolean }) => {
      if (!key || !enabled) return;
      const warm = getSessionSnapshot<T>(key);
-      if (warm !== undefined) {
+      if (warm !== undefined && !(revalidateEmpty && isEmptyArray(warm))) {
        setData(warm);
        setLoading(false);
        setPending(false);
        return;
      }
      const seq = ++seqRef.current;
-      const keep = dataRef.current !== undefined;
+      const keep = dataRef.current !== undefined || (warm !== undefined && isEmptyArray(warm));
      if (opts.allowLoading) {
        deleteSessionSnapshot(key);
        if (keep) setPending(true);
        else setLoading(true);
+      } else if (warm !== undefined && isEmptyArray(warm)) {
+        setPending(true);
      }
      fetcherRef.current()
        .then((next) => {
@@ -138,7 +155,7 @@ export function useSessionResource<T>(
      window.removeEventListener(PAGE_FORCE_REFRESH_EVENT, onForce);
      window.removeEventListener(PAGE_SOFT_REFRESH_COMMIT_EVENT, onCommit);
    };
-  }, [key, enabled]);
+  }, [key, enabled, revalidateEmpty]);

  return { data, loading, pending, replace, invalidate };
 }
--- a/frontend/src/hooks/useSiteBranding.ts
+++ b/frontend/src/hooks/useSiteBranding.ts
@@ -1,6 +1,7 @@
 import { useEffect, useState } from 'react';
 import { api } from '../api/client';
 import type { SiteBranding } from '../api/types';
+import { getScope } from '../ssr/scope';

 export const DEFAULT_BRANDING: SiteBranding = {
  name: '姜十三论坛',
@@ -30,8 +31,8 @@ export function siteMetaDescription(brand: SiteBranding): string {
  return brand.slogan?.trim() ?? '';
 }

-/** 从服务端注入的 boot 数据同步初始化，避免首屏闪默认站名 */
 function readBootBranding(): SiteBranding | null {
+  if (typeof window === 'undefined') return null;
  try {
    const boot = window.__J13_BRANDING__;
    if (!boot || typeof boot !== 'object') return null;
@@ -50,13 +51,20 @@ let cacheEpoch = 0;
 let preferCacheOnce = false;
 const listeners = new Set<() => void>();

+/** 当前生效的品牌配置：SSR 读请求作用域，客户端读模块缓存 */
+function currentBranding(): SiteBranding | null {
+  return getScope()?.branding ?? cached;
+}
+
 function fetchBranding(): Promise<SiteBranding> {
  if (preferCacheOnce && cached) {
    preferCacheOnce = false;
    return Promise.resolve(cached);
  }
+  // SSR +data / 冷启动预热已 seed 品牌配置时首屏直接复用，不重复请求；
+  // 最新配置同步由显式刷新（refetchSiteBranding / ensureSiteBrandingLoaded force）触发
+  if (cached) return Promise.resolve(cached);
  if (inflight) return inflight;
-  // 有 boot/缓存时首屏已可用；仍请求 API 以同步最新配置
  inflight = api.siteBranding()
    .then(b => {
      cached = { ...DEFAULT_BRANDING, ...b };
@@ -96,13 +104,13 @@ function applyDocumentBrand(brand: SiteBranding) {

 /** 同步读取已缓存的品牌配置（供 SEO 等非 hook 场景） */
 export function getCachedSiteBranding(): SiteBranding {
-  return cached ?? DEFAULT_BRANDING;
+  return currentBranding() ?? DEFAULT_BRANDING;
 }

 /** 获取站点品牌配置（名称、Logo 等） */
 export function useSiteBranding() {
-  const [branding, setBranding] = useState<SiteBranding>(cached ?? DEFAULT_BRANDING);
-  const [loading, setLoading] = useState(!cached);
+  const [branding, setBranding] = useState<SiteBranding>(currentBranding() ?? DEFAULT_BRANDING);
+  const [loading, setLoading] = useState(!currentBranding());
  const [epoch, setEpoch] = useState(cacheEpoch);

  useEffect(() => {
@@ -131,6 +139,7 @@ export function useSiteBranding() {

 /** 保留当前画面，后台重拉品牌配置（下拉刷新等） */
 export function refetchSiteBranding() {
+  cached = null;
  inflight = null;
  cacheEpoch += 1;
  listeners.forEach(fn => fn());
@@ -140,6 +149,7 @@ export function refetchSiteBranding() {
 export async function ensureSiteBrandingLoaded(opts?: { force?: boolean }): Promise<SiteBranding> {
  if (!opts?.force && cached) return cached;
  if (opts?.force) {
+    cached = null;
    inflight = null;
    preferCacheOnce = false;
  }
@@ -160,9 +170,15 @@ export function invalidateSiteBrandingCache() {
  listeners.forEach(fn => fn());
 }

-/** 用管理端刚保存的值立即更新缓存与文档标题 */
+/** 用管理端刚保存的值立即更新缓存与文档标题（SSR 时只写请求作用域） */
 export function seedSiteBrandingCache(brand: SiteBranding) {
-  cached = { ...DEFAULT_BRANDING, ...brand };
+  const merged: SiteBranding = { ...DEFAULT_BRANDING, ...brand };
+  const scope = getScope();
+  if (scope) {
+    scope.branding = merged;
+    return;
+  }
+  cached = merged;
  applyDocumentBrand(cached);
  cacheEpoch += 1;
  listeners.forEach(fn => fn());
--- a/frontend/src/hooks/useSitePages.ts
+++ b/frontend/src/hooks/useSitePages.ts
@@ -1,19 +1,26 @@
 import { useEffect, useState } from 'react';
 import { api } from '../api/client';
 import type { SitePageSummary } from '../api/types';
+import { getScope } from '../ssr/scope';
 import { PAGE_FORCE_REFRESH_EVENT } from '../utils/feedCache';
 import { PAGE_SOFT_REFRESH_COMMIT_EVENT } from '../utils/softRefresh';

 let cache: SitePageSummary[] | null = null;
 let pending: Promise<SitePageSummary[]> | null = null;

+/** 当前生效的站点页摘要：SSR 读请求作用域，客户端读模块缓存 */
+function currentPages(): SitePageSummary[] | null {
+  return getScope()?.pages ?? cache;
+}
+
 /** 拉取或复用站点页摘要缓存（供冷启动门闩与 hook 共用） */
 export function ensureSitePagesLoaded(opts?: { force?: boolean }): Promise<SitePageSummary[]> {
+  const cur = currentPages();
  if (opts?.force) {
    cache = null;
    pending = null;
  }
-  if (cache) return Promise.resolve(cache);
+  if (cur) return Promise.resolve(cur);
  if (!pending) {
    pending = api.pages()
      .then(d => {
@@ -31,7 +38,7 @@ export function ensureSitePagesLoaded(opts?: { force?: boolean }): Promise<SiteP

 /** 已发布单页摘要（页脚/侧栏导航） */
 export function useSitePages() {
-  const [pages, setPages] = useState<SitePageSummary[]>(cache ?? []);
+  const [pages, setPages] = useState<SitePageSummary[]>(currentPages() ?? []);

  useEffect(() => {
    const load = () => {
@@ -68,8 +75,14 @@ export function invalidateSitePagesCache() {
  cache = null;
 }

-/** 文档 SSR：同步写入站点页摘要缓存 */
+/** 文档 SSR：同步写入站点页摘要缓存（SSR 时只写请求作用域） */
 export function seedSitePagesCache(pages: SitePageSummary[]) {
-  cache = Array.isArray(pages) ? pages : [];
+  const list = Array.isArray(pages) ? pages : [];
+  const scope = getScope();
+  if (scope) {
+    scope.pages = list;
+    return;
+  }
+  cache = list;
  pending = null;
 }
--- a/frontend/src/hooks/useTheme.tsx
+++ b/frontend/src/hooks/useTheme.tsx
@@ -23,13 +23,23 @@ export function ThemeProvider({ children }: { children: ReactNode }) {

 export const useTheme = () => useContext(ThemeContext);

+/**
+ * 媒体查询 Hook（hydration 安全）。
+ *
+ * SSR 永远输出桌面三栏布局，因此服务端与 hydrate 首帧统一返回 false，
+ * 保证首帧 React 树与服务端 DOM 完全同构（窄屏若首帧就读 matchMedia，
+ * 会与 SSR 桌面布局不一致，导致 React 丢弃整棵 SSR DOM 全量重建）。
+ * hydration 提交后的 layout effect 在首帧绘制前同步真实值并监听变化，
+ * 窄屏用户无闪烁地切换到移动布局。
+ */
 export function useMediaQuery(query: string) {
-  const [match, setMatch] = useState(() => window.matchMedia(query).matches);
+  const [match, setMatch] = useState(false);
  useLayoutEffect(() => {
    const m = window.matchMedia(query);
-    const fn = () => setMatch(m.matches);
-    m.addEventListener('change', fn);
-    return () => m.removeEventListener('change', fn);
+    const sync = () => setMatch(m.matches);
+    sync();
+    m.addEventListener('change', sync);
+    return () => m.removeEventListener('change', sync);
  }, [query]);
  return match;
 }
--- a/frontend/src/hooks/useUnsavedChangesGuard.ts
+++ b/frontend/src/hooks/useUnsavedChangesGuard.ts
@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { useBlocker } from 'react-router-dom';
+import { useBlocker } from 'react-router';

 interface Options {
  /** 是否存在未保存的修改 */
--- a/frontend/src/layouts/AdminLayout.tsx
+++ b/frontend/src/layouts/AdminLayout.tsx
@@ -1,5 +1,5 @@
 import { useEffect, useState, useCallback, useRef } from 'react';
-import { Outlet, NavLink, useNavigate, useLocation } from 'react-router-dom';
+import { Outlet, NavLink, useNavigate, useLocation } from 'react-router';
 import {
  LayoutDashboard, FolderKanban, FileText, MessageSquare, Flag, Users, Images, Settings, ArrowLeft, Moon, Sun, Menu, X, Award, Link2, BookOpen, Globe2, Activity,
 } from 'lucide-react';
--- a/frontend/src/layouts/MainLayout.tsx
+++ b/frontend/src/layouts/MainLayout.tsx
@@ -1,5 +1,5 @@
-import { useState, useEffect, useCallback, useRef, useMemo, Suspense, startTransition } from 'react';
-import { Outlet, useNavigate, useSearchParams, useLocation } from 'react-router-dom';
+import { useState, useEffect, useCallback, useRef, useMemo } from 'react';
+import { Outlet, useNavigate, useSearchParams, useLocation } from 'react-router';
 import { Menu, Moon, Sun, Search, Plus, PanelRight, X, Mail, SlidersHorizontal } from 'lucide-react';
 import {
  DropdownMenu,
@@ -12,13 +12,16 @@ import { useAuth } from '../hooks/useAuth';
 import { useTheme, useMediaQuery } from '../hooks/useTheme';
 import { useOverlayA11y, moveTabIndex } from '../hooks/useOverlayA11y';
 import { api } from '../api/client';
-import type { Board, RecentComment, RecentUser, ForumStats, TagCount, User } from '../api/types';
-import type { PostHeading } from '../utils/postHeadings';
+import type { Board, RecentComment, RecentUser, ForumStats, SitePage, TagCount, User, UserActivityStats, UserPublic } from '../api/types';
+import { extractHeadingsFromHtml, type PostHeading } from '../utils/postHeadings';
+import { renderPostContentHtml } from '../utils/postContent';
+import { getSessionSnapshot } from '../utils/sessionPageCache';
+import { postDetailCacheKey, type PostDetailSnapshot } from '../utils/homeBoot';
 import { getCachedBoards, getCachedStats, getCachedRecentComments, getCachedRecentUsers, getCachedTags, hasCachedAside, setCachedBoards, setCachedStats, setCachedRecentComments, setCachedRecentUsers, setCachedTags } from '../utils/layoutCache';
 import Sidebar, { isNeutralSidebarRoute } from '../components/Sidebar';
 import RightPanel from '../components/RightPanel';
 import BackToTop from '../components/BackToTop';
-import { useForumLimits } from '../hooks/useForumLimits';
+import { getCachedForumLimits, useForumLimits } from '../hooks/useForumLimits';
 import { resolveAsideWidgets } from '../utils/asideWidgets';
 import { buildHomeUrl, parseFeedSort } from '../components/FeedSortBar';
 import { navigateFeed, PAGE_FORCE_REFRESH_EVENT } from '../utils/feedCache';
@@ -44,44 +47,83 @@ import { userPath } from '../utils/userPath';
 import { parsePermalinkID } from '../utils/permalink';
 import { ensureSitePagesLoaded } from '../hooks/useSitePages';
 import { endHomeHydrate, isHomeHydrating } from '../utils/homeHydrate';
-import { getBootUnread } from '../utils/authBoot';
+import { getBootUnread, peekAuthSeed } from '../utils/authBoot';

 export default function MainLayout() {
  const { user, loading: authLoading, logout } = useAuth();
  const { theme, toggle } = useTheme();
  const { branding } = useSiteBranding();
  useMonitorPageview();
-  const mqMobile = useMediaQuery('(max-width: 768px)');
+  // 响应式分支首帧恒为桌面（useMediaQuery hydration 安全），layout effect 绘制前同步真实值
+  const isMobile = useMediaQuery('(max-width: 768px)');
  const hideAside = useMediaQuery('(max-width: 1100px)');
-  /** hydrate 首帧强制桌面布局（SSR 为桌面三栏），随后再跟 matchMedia */
-  const [forceDesktop, setForceDesktop] = useState(() => isHomeHydrating());
-  const isMobile = forceDesktop ? false : mqMobile;
  const nav = useNavigate();
  const loc = useLocation();
  const [params] = useSearchParams();
  const isCompose = loc.pathname.startsWith('/compose') || /\/post\/\d+\/edit$/.test(loc.pathname);

+  /** hydrate 首帧提交后清除同构标志（shellReady/冷启动门闩在首帧渲染期读取） */
  useEffect(() => {
-    if (!forceDesktop) return;
    endHomeHydrate();
-    startTransition(() => setForceDesktop(false));
-  }, [forceDesktop]);
+  }, []);

  const [boards, setBoards] = useState<Board[]>(() => getCachedBoards());
  const [stats, setStats] = useState<ForumStats | null>(() => getCachedStats());
  const [recentComments, setRecentComments] = useState<RecentComment[]>(() => getCachedRecentComments());
  const [recentUsers, setRecentUsers] = useState<RecentUser[]>(() => getCachedRecentUsers());
  const [unreadMessages, setUnreadMessages] = useState(() => getBootUnread());
+  const [dmUnread, setDmUnread] = useState(0);
+  const [notifyUnread, setNotifyUnread] = useState(0);
  const [tags, setTags] = useState<TagCount[]>(() => getCachedTags());
  const [tagsLoading, setTagsLoading] = useState(() => getCachedTags().length === 0);
-  const [postOutline, setPostOutline] = useState<{
-    headings: PostHeading[];
-    scrollRoot: HTMLElement | null;
-    title?: string;
-    author?: User | null;
-    publishedAt?: string;
-    viewCount?: number;
-  } | null>(null);
+  // SSR / hydrate 首帧：详情页快照已在渲染前 seed（onRenderHtml / onRenderClient），
+  // 直接从中派生右栏作者与目录——子组件的 setPostOutline 在 effect 中，SSR 不执行，
+  // 不走这一步作者卡/目录会整体退化为客户端挂载。首帧后的 SPA 导航仍由 effect 上报。
+  const [postOutline, setPostOutline] = useState<PostOutlineState>(() => {
+    const openLinks = getCachedForumLimits()?.open_content_links_in_new_tab;
+    // 帖子详情：从 post 快照派生作者卡 + 目录
+    const postM = loc.pathname.match(/^\/post\/(\d+)/);
+    if (postM && !/\/edit$/.test(loc.pathname)) {
+      const id = Number(postM[1]);
+      if (id) {
+        const snap = getSessionSnapshot<PostDetailSnapshot>(postDetailCacheKey(id));
+        if (snap?.post) {
+          const content = snap.post.content ?? '';
+          const rendered = content.trim()
+            ? renderPostContentHtml(content, !!user, { openLinksInNewTab: openLinks })
+            : '';
+          return {
+            headings: extractHeadingsFromHtml(rendered),
+            scrollRoot: null,
+            title: '文章目录',
+            author: snap.post.user ?? null,
+            publishedAt: snap.post.created_at,
+            viewCount: snap.post.view_count,
+            authorProfile: snap.authorProfile ?? null,
+            authorStats: snap.authorStats ?? null,
+          };
+        }
+      }
+    }
+    // 自定义单页：从 sitepage 快照派生目录（无作者卡）
+    const pageM = loc.pathname.match(/^\/page\/([^/]+?)(?:\.html?)?$/);
+    if (pageM) {
+      const slug = pageM[1];
+      const page = getSessionSnapshot<SitePage>(`sitepage:${slug}`);
+      if (page) {
+        const content = page.content ?? '';
+        const rendered = content.trim()
+          ? renderPostContentHtml(content, !!user, { openLinksInNewTab: openLinks })
+          : '';
+        return {
+          headings: extractHeadingsFromHtml(rendered),
+          scrollRoot: null,
+          title: '文章目录',
+        };
+      }
+    }
+    return null;
+  });
  const [asideOpen, setAsideOpen] = useState(false);
  const [sidebarOpen, setSidebarOpen] = useState(false);
  const [searchPanelOpen, setSearchPanelOpen] = useState(false);
@@ -90,9 +132,9 @@ export default function MainLayout() {
  const [boardsLoading, setBoardsLoading] = useState(() => getCachedBoards().length === 0);
  const [layoutRefreshTick, setLayoutRefreshTick] = useState(0);
  const asideEverLoaded = useRef(false);
-  /** 冷启动门闩：main.tsx 已预热则可同步放行；否则等齐再呈现 */
-  const [shellReady, setShellReady] = useState(() => isCompose || wasColdBootEnsured());
-  const coldBootDone = useRef(isCompose || wasColdBootEnsured());
+  /** 冷启动门闩：main.tsx 已预热则可同步放行；SSR/hydrate 首帧数据已由 +data seed，直接放行保持同构 */
+  const [shellReady, setShellReady] = useState(() => isCompose || wasColdBootEnsured() || isHomeHydrating());
+  const coldBootDone = useRef(isCompose || wasColdBootEnsured() || isHomeHydrating());
  const bootGen = useRef(0);
  const [boardId, setBoardId] = useState(() => {
    const m = loc.pathname.match(/^\/board\/(\d+(?:\.[A-Za-z0-9]{1,16})?)$/);
@@ -212,7 +254,11 @@ export default function MainLayout() {
  }, []);

  useEffect(() => {
-    refreshBoards();
+    // SSR +data 已 seed boards/stats（或 SPA 冷启动已预热）时跳过首拉，避免重复请求；
+    // 后台操作 / 手动刷新经 boards-refresh 事件强制重拉
+    if (getCachedBoards().length === 0 || getCachedStats() === null) {
+      void refreshBoards();
+    }
    const onRefresh = () => refreshBoards();
    window.addEventListener('boards-refresh', onRefresh);
    return () => window.removeEventListener('boards-refresh', onRefresh);
@@ -309,15 +355,38 @@ export default function MainLayout() {
  const refreshUnreadMessages = useCallback(() => {
    if (!user) {
      setUnreadMessages(0);
+      setDmUnread(0);
+      setNotifyUnread(0);
      return;
    }
    api.messageUnreadCount()
-      .then((r) => setUnreadMessages(r.count || 0))
-      .catch(() => setUnreadMessages(0));
+      .then((r) => {
+        setUnreadMessages(r.count || 0);
+        setDmUnread(r.dm_count ?? 0);
+        setNotifyUnread(r.notify_count ?? 0);
+      })
+      .catch(() => {
+        setUnreadMessages(0);
+        setDmUnread(0);
+        setNotifyUnread(0);
+      });
  }, [user]);

+  /** 仅有通知未读时直达通知 Tab，避免先看到空私信列表 */
+  const openMessages = useCallback(() => {
+    const path = notifyUnread > 0 && dmUnread === 0 ? '/messages?tab=notify' : '/messages';
+    void transitionTo(nav, path);
+  }, [nav, notifyUnread, dmUnread]);
+
+  // 仅首屏跳过一次：SSR/冷启动种子已带未读数（state 从 getBootUnread 初始化），不重复请求；
+  // 之后 user 变化（登录/退出）、事件刷新与 60s 轮询照常
+  const unreadImmediateSkipped = useRef(false);
  useEffect(() => {
-    refreshUnreadMessages();
+    if (!unreadImmediateSkipped.current && peekAuthSeed().hasSeed) {
+      unreadImmediateSkipped.current = true;
+    } else {
+      refreshUnreadMessages();
+    }
    const onRefresh = () => refreshUnreadMessages();
    window.addEventListener('messages-unread-refresh', onRefresh);
    const timer = window.setInterval(refreshUnreadMessages, 60_000);
@@ -368,6 +437,13 @@ export default function MainLayout() {
  // 标签云：进页/离开发帖页时拉取；不跟 posts-refresh 联动（置顶/推荐等不改标签）
  useEffect(() => {
    if (isCompose || !showTagCloud) return;
+    // SSR +data / 冷启动预热已 seed 侧栏数据（含空数组）时首屏直接复用，不重复请求；
+    // 下拉强制刷新（layoutRefreshTick 递增）时仍重拉最新
+    if (layoutRefreshTick === 0 && hasCachedAside()) {
+      setTags(getCachedTags());
+      setTagsLoading(false);
+      return;
+    }
    let cancelled = false;
    // 有 session 缓存则静默刷新（软刷新不卸空白）
    if (getCachedTags().length === 0) setTagsLoading(true);
@@ -388,6 +464,14 @@ export default function MainLayout() {
  const needRecentComments = needAsideData && showRecentComments;
  useEffect(() => {
    if (!needRecentComments) return;
+    // SSR +data / 冷启动预热已 seed：首屏同步缓存进 state，不重复请求；
+    // 下拉强制刷新（layoutRefreshTick 递增）时仍重拉最新
+    if (layoutRefreshTick === 0 && hasCachedAside()) {
+      setRecentComments(getCachedRecentComments());
+      asideEverLoaded.current = true;
+      setAsideLoading(false);
+      return;
+    }
    let cancelled = false;
    // 无缓存时才显示加载态，有缓存则静默刷新，避免抽屉高度跳动
    if (!asideEverLoaded.current && !hasCachedAside()) {
@@ -414,6 +498,12 @@ export default function MainLayout() {
  const needRecentUsers = needAsideData && showRecentUsers;
  useEffect(() => {
    if (!needRecentUsers) return;
+    if (layoutRefreshTick === 0 && hasCachedAside()) {
+      setRecentUsers(getCachedRecentUsers());
+      asideEverLoaded.current = true;
+      setAsideLoading(false);
+      return;
+    }
    let cancelled = false;
    if (!asideEverLoaded.current && !hasCachedAside()) {
      setAsideLoading(true);
@@ -484,14 +574,7 @@ export default function MainLayout() {
  const isArticleAside = isPostDetail || isSitePage;
  // 帖子有作者 →「作者与目录」；单页仅目录
  const articleAsideLabel = isPostDetail ? '作者与目录' : '文章目录';
-  const setPostOutlineSafe = useCallback((outline: {
-    headings: PostHeading[];
-    scrollRoot: HTMLElement | null;
-    title?: string;
-    author?: User | null;
-    publishedAt?: string;
-    viewCount?: number;
-  } | null) => {
+  const setPostOutlineSafe = useCallback((outline: PostOutlineState) => {
    setPostOutline(outline);
  }, []);
  const layoutCtx = useMemo<LayoutCtx>(() => ({
@@ -523,7 +606,8 @@ export default function MainLayout() {
  };

  return (
-    <div className={cn('app-shell', forceDesktop && 'ssr-home')}>
+    // Feed / 帖子详情用文档滚动：F5 / 前进后退的滚动位置由浏览器原生历史恢复
+    <div className={cn('app-shell', !isCompose && (isFeedHome || isPostDetail) && 'app-shell--doc-scroll')}>
      <div className="app-frame">
      <header className="app-header">
        <div className="header-inner">
@@ -667,7 +751,7 @@ export default function MainLayout() {
                  className="header-icon-btn header-msg-btn"
                  title={unreadMessages > 0 ? `${unreadMessages} 条未读消息` : '站内消息'}
                  aria-label={unreadMessages > 0 ? `站内消息，${unreadMessages} 条未读` : '站内消息'}
-                  onClick={() => void transitionTo(nav, '/messages')}
+                  onClick={openMessages}
                >
                  <Mail size={18} aria-hidden />
                  {unreadMessages > 0 && (
@@ -691,7 +775,7 @@ export default function MainLayout() {
                    <DropdownMenuItem onClick={() => void transitionTo(nav, '/profile')}>
                      账号设置{typeof user.points === 'number' ? ` · ${user.points} 积分` : ''}
                    </DropdownMenuItem>
-                    <DropdownMenuItem onClick={() => void transitionTo(nav, '/messages')}>
+                    <DropdownMenuItem onClick={openMessages}>
                      站内消息{unreadMessages > 0 ? ` (${unreadMessages})` : ''}
                    </DropdownMenuItem>
                    <DropdownMenuItem onClick={() => void transitionTo(nav, '/favorites')}>我的收藏</DropdownMenuItem>
@@ -802,11 +886,10 @@ export default function MainLayout() {
              })}
            </div>
          )}
-          {shellReady ? (
-            <Suspense fallback={null}>
-              <Outlet context={layoutCtx} />
-            </Suspense>
-          ) : null}
+          {/* 不在此处包 Suspense：React 19 Fizz 会把 Suspense 边界内大体积/含 <img>
+              的同步内容 outlining 为 <div hidden> 分块（禁 JS 爬虫不可见）。
+              懒加载路由的 Suspense 已在 AppRoutes 各路由 element 上就近声明。 */}
+          {shellReady ? <Outlet context={layoutCtx} /> : null}
        </main>

        {!isCompose && (
@@ -829,6 +912,8 @@ export default function MainLayout() {
              headings: postOutline?.headings ?? [],
              scrollRoot: postOutline?.scrollRoot ?? null,
              outlineTitle: postOutline?.title,
+              authorProfile: postOutline?.authorProfile ?? null,
+              authorStats: postOutline?.authorStats ?? null,
            } : null}
          />
          )}
@@ -948,6 +1033,8 @@ export default function MainLayout() {
                  headings: postOutline?.headings ?? [],
                  scrollRoot: postOutline?.scrollRoot ?? null,
                  outlineTitle: postOutline?.title,
+                  authorProfile: postOutline?.authorProfile ?? null,
+                  authorStats: postOutline?.authorStats ?? null,
                } : null}
              />
            </div>
@@ -960,6 +1047,19 @@ export default function MainLayout() {
  );
 }

+/** 详情页/单页上报到右栏的文章目录与作者信息 */
+export type PostOutlineState = {
+  headings: PostHeading[];
+  scrollRoot: HTMLElement | null;
+  title?: string;
+  author?: User | null;
+  publishedAt?: string;
+  viewCount?: number;
+  /** SSR/预热快照携带的作者主页资料与统计（作者卡首帧直接渲染，缺省由卡片自行拉取） */
+  authorProfile?: UserPublic | null;
+  authorStats?: UserActivityStats | null;
+} | null;
+
 export type LayoutCtx = {
  boardId: number;
  keyword: string;
@@ -970,12 +1070,5 @@ export type LayoutCtx = {
  refreshBoards: () => void;
  isMobile: boolean;
  /** 详情页上报作者与目录，供右侧栏展示 */
-  setPostOutline: (outline: {
-    headings: PostHeading[];
-    scrollRoot: HTMLElement | null;
-    title?: string;
-    author?: User | null;
-    publishedAt?: string;
-    viewCount?: number;
-  } | null) => void;
+  setPostOutline: (outline: PostOutlineState) => void;
 };
--- a/frontend/src/main.tsx
+++ b/frontend/src/main.tsx
@@ -1,96 +0,0 @@
-import React from 'react';
-import { hydrateRoot, createRoot } from 'react-dom/client';
-import { applyTheme, getStoredTheme } from './utils/theme';
-import App from './App';
-import { consumeHomeBoot } from './utils/homeBoot';
-import { beginHomeHydrate } from './utils/homeHydrate';
-import { reloadForStaleChunk } from './utils/chunkLoad';
-import { ensureColdBootReady, isMainLayoutPath } from './utils/prefetchRoute';
-
-applyTheme(getStoredTheme());
-consumeHomeBoot();
-
-// Vite modulepreload / 动态 import 失败（发版后旧 hashed URL 404）
-window.addEventListener('vite:preloadError', (event) => {
-  event.preventDefault();
-  reloadForStaleChunk();
-});
-
-function hasSSRHome(): boolean {
-  return !!document.querySelector('#root .ssr-home');
-}
-
-function waitForStylesheets(): Promise<void> {
-  const links = Array.from(document.querySelectorAll('link[rel="stylesheet"]'));
-  if (links.length === 0) return Promise.resolve();
-  return Promise.all(
-    links.map(
-      (node) =>
-        new Promise<void>((resolve) => {
-          const link = node as HTMLLinkElement;
-          try {
-            if (link.sheet) {
-              resolve();
-              return;
-            }
-          } catch {
-            /* cross-origin */
-          }
-          const finish = () => resolve();
-          link.addEventListener('load', finish, { once: true });
-          link.addEventListener('error', finish, { once: true });
-        }),
-    ),
-  ).then(() => undefined);
-}
-
-function renderApp() {
-  return (
-    <React.StrictMode>
-      <App />
-    </React.StrictMode>
-  );
-}
-
-function mountCreateRoot(el: HTMLElement) {
-  createRoot(el).render(renderApp());
-}
-
-/** 有 SSR 正文：hydrate 接管同一 DOM；失败则回退 createRoot */
-function mountHydrateHome(el: HTMLElement) {
-  beginHomeHydrate();
-  try {
-    hydrateRoot(el, renderApp());
-  } catch (err) {
-    console.warn('[j13] hydrateRoot 失败，回退 createRoot', err);
-    el.innerHTML = '';
-    mountCreateRoot(el);
-  }
-}
-
-async function boot() {
-  const path = `${window.location.pathname}${window.location.search}`;
-  const ssr = hasSSRHome();
-
-  await waitForStylesheets();
-  try {
-    if (document.fonts?.ready) await document.fonts.ready;
-  } catch {
-    /* ignore */
-  }
-
-  if (isMainLayoutPath(window.location.pathname)) {
-    await ensureColdBootReady(path);
-  }
-
-  const root = document.getElementById('root');
-  if (!root) return;
-
-  if (ssr) {
-    mountHydrateHome(root);
-  } else {
-    mountCreateRoot(root);
-  }
-}
-
-void boot();
--- a/frontend/src/pages/BoardsManagePage.tsx
+++ b/frontend/src/pages/BoardsManagePage.tsx
@@ -1,5 +1,5 @@
 import { useState, useEffect } from 'react';
-import { useForm } from 'react-hook-form';
+import { useForm, type Resolver } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
 import { Plus, FolderKanban } from 'lucide-react';
@@ -52,8 +52,9 @@ export default function BoardsManagePage() {
  const [submitting, setSubmitting] = useState(false);
  const [reordering, setReordering] = useState(false);

+  // z.coerce 的 input 类型为 unknown，这里显式断言对齐 output 类型
  const form = useForm<BoardFormValues>({
-    resolver: zodResolver(boardSchema),
+    resolver: zodResolver(boardSchema) as Resolver<BoardFormValues>,
    defaultValues: { name: '', description: '', sort_order: 1, icon: '', color_index: -1 },
  });

--- a/frontend/src/pages/ComposePage.tsx
+++ b/frontend/src/pages/ComposePage.tsx
@@ -1,5 +1,5 @@
 import { useState, useEffect, useMemo, useRef } from 'react';
-import { useNavigate, useSearchParams, useParams, useOutletContext } from 'react-router-dom';
+import { useNavigate, useSearchParams, useParams, useOutletContext } from 'react-router';
 import { Pencil } from 'lucide-react';
 import { notify } from '@/lib/notify';
 import { api } from '../api/client';
--- a/frontend/src/pages/FavoritesPage.tsx
+++ b/frontend/src/pages/FavoritesPage.tsx
@@ -1,5 +1,5 @@
 import { useEffect } from 'react';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import { ArrowLeft, Star } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { Spinner } from '@/components/ui/spinner';
--- a/frontend/src/pages/ForgotPasswordPage.tsx
+++ b/frontend/src/pages/ForgotPasswordPage.tsx
@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { useNavigate, Link } from 'react-router-dom';
+import { useNavigate, Link } from 'react-router';
 import { useForm } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
--- a/frontend/src/pages/HomePage.tsx
+++ b/frontend/src/pages/HomePage.tsx
@@ -1,4 +1,4 @@
-import { useState, useEffect, useCallback, useRef, useMemo, startTransition as reactStartTransition } from 'react';
+import { useState, useEffect, useCallback, useRef, useMemo, useLayoutEffect } from 'react';
 import {
  useNavigate,
  useOutletContext,
@@ -6,18 +6,23 @@ import {
  useLocation,
  useParams,
  useNavigationType,
-} from 'react-router-dom';
+} from 'react-router';
+import { Inbox, SearchX } from 'lucide-react';
 import { notify } from '@/lib/notify';
+import { Button } from '@/components/ui/button';
+import { useAuth } from '../hooks/useAuth';
+import { loginPath } from '../utils/authRedirect';
 import { api } from '../api/client';
 import type { PostItem } from '../api/types';
 import type { LayoutCtx } from '../layouts/MainLayout';
-import VirtualPostList from '../components/VirtualPostList';
-import StaticFeedList from '../components/StaticFeedList';
+import PostListItem from '../components/PostListItem';
+import FeedPagination from '../components/FeedPagination';
+import { InFlowSiteFooter } from '../components/SiteFooter';
 import FeedHeader from '../components/FeedHeader';
 import FeedSearchFilters from '../components/search/FeedSearchFilters';
 import FeedSortBar, { parseFeedSort, buildHomeUrl, type FeedSort } from '../components/FeedSortBar';
 import { useForumLimits } from '../hooks/useForumLimits';
-import { parseSearchFromUrl, usePostSearch } from '../hooks/usePostSearch';
+import { parseSearchFromUrl, usePostSearch, dispatchOpenPostSearch } from '../hooks/usePostSearch';
 import {
  navigateFeed,
  FEED_RESET_EVENT,
@@ -29,7 +34,6 @@ import { feedCacheKey, getHomeStoreState } from '../store/homeStore';
 import { enabledFeedSortTabs, getDefaultFeedSort } from '../utils/feedSortTabs';
 import { openForumPost } from '../utils/openPost';
 import { startTransition, doneTransition } from '../utils/spaTransition';
-import { isHomeHydrating } from '../utils/homeHydrate';
 import { joinSEOKeywords, usePageSEO } from '../hooks/usePageSEO';
 import { siteMetaDescription, useSiteBranding } from '../hooks/useSiteBranding';
 import { boardPath, canonicalRedirectPath, parsePermalinkID } from '../utils/permalink';
@@ -49,7 +53,6 @@ type FeedHydrate = {
  posts: PostItem[];
  postTotal: number;
  page: number;
-  scrollTop: number;
  loading: boolean;
 };

@@ -69,11 +72,10 @@ function readHydrate(
      posts: cached.posts,
      postTotal: cached.postTotal,
      page: cached.page,
-      scrollTop: cached.scrollTop,
      loading: false,
    };
  }
-  return { posts: [], postTotal: 0, page: 1, scrollTop: 0, loading: true };
+  return { posts: [], postTotal: 0, page: 1, loading: true };
 }

 export default function HomePage() {
@@ -83,6 +85,7 @@ export default function HomePage() {
  const { id: boardRouteId } = useParams();
  const [params] = useSearchParams();
  const ctx = useOutletContext<LayoutCtx>();
+  const { user } = useAuth();
  const { branding } = useSiteBranding();
  const { limits, loading: limitsLoading } = useForumLimits();
  const postSearch = usePostSearch(limits);
@@ -187,25 +190,14 @@ export default function HomePage() {
    titleOnly,
  });
  const [listPending, setListPending] = useState(false);
-  const [restoreScrollTop, setRestoreScrollTop] = useState<number | null>(
-    initial.posts.length > 0 ? initial.scrollTop : null,
-  );
+  /** 翻页 / 切筛选 / 强制刷新后置顶信号（由布局 effect 消费） */
  const [listResetKey, setListResetKey] = useState(0);
-  /** hydrate 首帧用静态列表；完成后升级 VirtualPostList */
-  const [useVirtualList, setUseVirtualList] = useState(() => !isHomeHydrating());

-  useEffect(() => {
-    if (useVirtualList) return;
-    reactStartTransition(() => setUseVirtualList(true));
-  }, [useVirtualList]);
-
-  const scrollTopRef = useRef(initial.scrollTop);
  const fetchSeqRef = useRef(0);
  const pageRef = useRef(initial.page);
  const cacheKeyRef = useRef(cacheKey);
  const viewKeyRef = useRef(view.cacheKey);
  const postsRef = useRef(posts);
-  const scrollRafRef = useRef(0);
  /** 当前筛选键是否已完成「进入页」水合（避免 effect 重跑时反复 setRestoreScrollTop） */
  const hydratedKeyRef = useRef<string | null>(null);
  /** 强制刷新已发起 loadFirst：消费 refreshFeed 后 effect 再跑时勿因空缓存重复请求 */
@@ -223,8 +215,6 @@ export default function HomePage() {
    setPostTotal(next.postTotal);
    setPage(next.page);
    pageRef.current = next.page;
-    scrollTopRef.current = next.scrollTop;
-    setRestoreScrollTop(next.posts.length > 0 ? next.scrollTop : null);
    setLoading(next.loading);
    setListPending(false);
    setView(meta);
@@ -254,10 +244,10 @@ export default function HomePage() {
  const totalPages = Math.max(1, Math.ceil(Math.max(postTotal, 0) / pageSize));
  const showPagination = totalPages > 1 && posts.length > 0;
  const hasMore = page < totalPages;
+  // 首帧静态列表与 VirtualPostList 同规则：无更多页、无分页、有帖子且非加载中时显示结束提示
+  const showEnd = !hasMore && !showPagination && posts.length > 0 && !loading;

  const resetFeedView = useCallback(() => {
-    setRestoreScrollTop(null);
-    scrollTopRef.current = 0;
    setListResetKey(k => k + 1);
  }, []);

@@ -266,12 +256,12 @@ export default function HomePage() {
    resetFeedView();
  }, [resetFeedView]);

-  /** 把当前列表写入 Zustand（滚动位置用 ref，避免闭包过期） */
+  /** 把当前列表写入 Zustand */
  const persistFeed = useCallback((
    nextPosts: PostItem[],
    nextTotal: number,
    nextPage: number,
-    opts?: { scrollTop?: number; touchFetchTime?: boolean; key?: string },
+    opts?: { touchFetchTime?: boolean; key?: string },
  ) => {
    const key = opts?.key ?? cacheKeyRef.current;
    const prev = getHomeStoreState().getFeed(key);
@@ -279,7 +269,6 @@ export default function HomePage() {
      posts: nextPosts,
      postTotal: nextTotal,
      page: nextPage,
-      scrollTop: opts?.scrollTop ?? scrollTopRef.current,
      lastFetchTime: opts?.touchFetchTime === false
        ? (prev?.lastFetchTime ?? Date.now())
        : Date.now(),
@@ -309,10 +298,7 @@ export default function HomePage() {
      const batch = Array.isArray(data.posts) ? data.posts : [];
      const total = data.total ?? 0;
      const jumpTop = opts?.resetScroll || (keepView && requestKey !== viewKeyRef.current);
-      const scrollTop = jumpTop ? 0 : scrollTopRef.current;
      if (jumpTop) {
-        setRestoreScrollTop(null);
-        scrollTopRef.current = 0;
        setListResetKey(k => k + 1);
      }
      setPosts(batch);
@@ -320,7 +306,7 @@ export default function HomePage() {
      setPage(p);
      pageRef.current = p;
      setView({ cacheKey: requestKey, sort, boardId, keyword, tag, author, titleOnly });
-      persistFeed(batch, total, p, { scrollTop, touchFetchTime: true, key: requestKey });
+      persistFeed(batch, total, p, { touchFetchTime: true, key: requestKey });
    } catch (e: unknown) {
      if (seq !== fetchSeqRef.current) return;
      if (!silent) {
@@ -352,8 +338,6 @@ export default function HomePage() {
  }, [fetchPage, postTotal, pageSize]);

  const handleSelectPost = useCallback((id: number) => {
-    // 离开前再写一次滚动，确保详情页返回可还原
-    getHomeStoreState().patchScroll(viewKeyRef.current, scrollTopRef.current);
    openForumPost(nav, id, limits.open_posts_in_new_tab);
  }, [nav, limits.open_posts_in_new_tab]);

@@ -399,7 +383,6 @@ export default function HomePage() {
          posts: cached.posts,
          postTotal: cached.postTotal,
          page: cached.page,
-          scrollTop: cached.scrollTop,
          loading: false,
        }, { cacheKey, sort, boardId, keyword, tag, author, titleOnly });
      } else {
@@ -415,10 +398,6 @@ export default function HomePage() {
    }

    hydratedKeyRef.current = cacheKey;
-    if (postsRef.current.length === 0) {
-      setRestoreScrollTop(null);
-      scrollTopRef.current = 0;
-    }
    loadFirst();
  }, [
    limitsLoading,
@@ -466,7 +445,6 @@ export default function HomePage() {
          posts: warm.posts,
          postTotal: warm.postTotal,
          page: warm.page,
-          scrollTop: 0,
          loading: false,
        }, { cacheKey: key, sort, boardId, keyword, tag, author, titleOnly });
        setListResetKey((k) => k + 1);
@@ -495,20 +473,21 @@ export default function HomePage() {
    sort, boardId, keyword, tag, author, titleOnly,
  ]);

-  // 卸载时取消未执行的 scroll rAF
-  useEffect(() => () => {
-    if (scrollRafRef.current) cancelAnimationFrame(scrollRafRef.current);
-  }, []);
+  // 滚动位置完全交给浏览器原生历史恢复（feed 为文档滚动，见 .app-shell--doc-scroll）：
+  // - F5 整页刷新：SSR 输出静态 DOM + 响应头 no-cache，浏览器按历史记录恢复窗口滚动；
+  // - SPA 前进/后退：列表 DOM 在 SSR/hydrate/客户端全程同构，浏览器同样自动恢复。
+  // 仅翻页 / 切筛选 / 强制刷新这类「换新内容」场景主动置顶。
+  useLayoutEffect(() => {
+    if (listResetKey <= 0) return;
+    window.scrollTo(0, 0);
+  }, [listResetKey]);

-  const handleScrollTopChange = useCallback((top: number) => {
-    scrollTopRef.current = top;
-    // rAF 节流写入 store，避免每个 scroll 事件都触发订阅者
-    if (scrollRafRef.current) return;
-    scrollRafRef.current = requestAnimationFrame(() => {
-      scrollRafRef.current = 0;
-      getHomeStoreState().patchScroll(viewKeyRef.current, scrollTopRef.current);
-    });
-  }, []);
+  // PUSH 进入新筛选（切板块 / 搜索 / 标签）：文档滚动置顶；
+  // POP（F5 初始载入、后退前进）不干预，交给浏览器原生恢复。
+  useEffect(() => {
+    if (navType === 'POP') return;
+    window.scrollTo(0, 0);
+  }, [cacheKey, navType]);

  const handleSortChange = (next: FeedSort) => {
    const url = buildHomeUrl(boardId, next, { keyword, tag, author, titleOnly, permalink: limits });
@@ -527,6 +506,32 @@ export default function HomePage() {
  const searchFilters = parseSearchFromUrl(location.pathname, params);
  const isSearchActive = !!(view.keyword || view.author);

+  // 空态（加载中且无列表时已在上方 return null，此处只处理真空态）
+  const viewBoardName = ctx?.boards?.find(b => b.id === view.boardId)?.name || '';
+  const noBoards = !ctx?.boardsLoading && (ctx?.boards?.length ?? 0) === 0;
+  const isSearchEmpty = posts.length === 0 && !loading
+    && (isSearchActive || !!view.tag || !!(view.keyword || '').trim());
+  const composeTarget = view.boardId > 0 ? `/compose?board=${view.boardId}` : '/compose';
+  const isAdmin = user?.role === 'admin';
+  const searchSummaryParts: string[] = [];
+  const kw = (view.keyword || view.tag || '').trim();
+  if (kw) searchSummaryParts.push(`关键词「${kw}」`);
+  if (view.author?.trim()) searchSummaryParts.push(`作者「${view.author.trim()}」`);
+  if (view.titleOnly) searchSummaryParts.push('仅标题');
+  if (searchFilters.scopeBoardId) {
+    const bn = ctx?.boards?.find(b => b.id === searchFilters.scopeBoardId)?.name || '';
+    if (bn) searchSummaryParts.push(`板块「${bn}」`);
+  }
+  const emptyHint = noBoards
+    ? (isAdmin
+      ? '网站还没有任何板块。你可以创建第一个板块，给帖子们一个归属。'
+      : '网站刚刚创建，管理员还没有添加板块。稍后再来看看吧。')
+    : isSearchEmpty
+      ? `${searchSummaryParts.join(' · ')}${searchSummaryParts.length ? '。' : ''}换个关键词试试，或清除当前筛选条件。`
+      : (view.boardId > 0
+        ? `板块「${viewBoardName}」还没有帖子。看看其他板块，或发表这个板块的第一帖。`
+        : '成为第一个发帖的人，开始讨论吧。');
+
  if (isInvalidBoardRoute || isMissingBoard) {
    return (
      <NotFoundPage
@@ -546,25 +551,13 @@ export default function HomePage() {
      <div className="feed-panel">
        <div className="feed-top">
          <div className="feed-top__bar">
-            {!useVirtualList ? (
-              (view.keyword || view.tag || view.author) ? (
-                <h1 className="feed-header-title">
-                  {view.tag
-                    ? `#${view.tag}`
-                    : view.keyword
-                      ? `搜索：${view.keyword}`
-                      : `作者：${view.author}`}
-                </h1>
-              ) : null
-            ) : (
-              <FeedHeader
-                keyword={view.keyword}
-                tag={view.tag}
-                author={view.author}
-                postTotal={postTotal}
-                titleAs={isSiteHome ? 'h2' : 'h1'}
-              />
-            )}
+            <FeedHeader
+              keyword={view.keyword}
+              tag={view.tag}
+              author={view.author}
+              postTotal={postTotal}
+              titleAs={isSiteHome ? 'h2' : 'h1'}
+            />
            {showSortBar && (
              <FeedSortBar
                value={view.sort}
@@ -583,36 +576,79 @@ export default function HomePage() {
            />
          )}
        </div>
-        {!useVirtualList ? (
-          <StaticFeedList posts={posts} sort={view.sort} boardId={view.boardId} />
-        ) : (
-          <VirtualPostList
-            posts={posts}
-            sort={view.sort}
-            loading={listPending ? false : (loading || limitsLoading)}
-            hasMore={hasMore}
-            showPagination={showPagination}
-            page={page}
-            totalPages={totalPages}
-            postTotal={postTotal}
-            onPageChange={goToPage}
-            onSelect={handleSelectPost}
-            restoreScrollTop={restoreScrollTop}
-            resetScrollKey={listResetKey}
-            onScrollTopChange={handleScrollTopChange}
-            onScrollRestored={() => setRestoreScrollTop(null)}
-            keyword={view.keyword || view.tag || view.author}
-            isSearchMode={!!(view.keyword || view.author)}
-            searchKeyword={view.keyword}
-            searchAuthor={view.author}
-            searchTitleOnly={view.titleOnly}
-            searchScopeBoardId={searchFilters.scopeBoardId}
-            onClearSearch={postSearch.clearSearch}
-            boardId={view.boardId}
-            boardName={ctx?.boards?.find(b => b.id === view.boardId)?.name || ''}
-            noBoards={!ctx?.boardsLoading && (ctx?.boards?.length ?? 0) === 0}
-          />
-        )}
+        {/*
+          列表始终静态流式渲染：SSR 输出与 hydration 后 DOM 完全一致（不包 Suspense、
+          不切虚拟列表），使浏览器原生 scroll restoration 在 F5 后直接生效，
+          也避免「JS 执行后重渲染内容区」被 SEO 工具误判为 CSR。
+        */}
+        <div className="post-list-scroll post-list-scroll--ssr">
+          {posts.length === 0 ? (
+            <div className="empty-feed" role="status">
+              {isSearchEmpty
+                ? <SearchX className="empty-feed-icon" aria-hidden size={36} strokeWidth={1.5} />
+                : <Inbox className="empty-feed-icon" aria-hidden size={36} strokeWidth={1.5} />}
+              <p>{noBoards ? '暂无板块' : isSearchEmpty ? '没有匹配的帖子' : '暂无帖子'}</p>
+              <p className="empty-feed-hint">{emptyHint}</p>
+              <div className="empty-feed-actions">
+                {noBoards ? (
+                  isAdmin ? (
+                    <Button variant="default" onClick={() => nav('/admin#boards')}>去创建板块</Button>
+                  ) : (
+                    <Button variant="ghost" onClick={() => nav('/')}>刷新看看</Button>
+                  )
+                ) : isSearchEmpty ? (
+                  <>
+                    <Button variant="default" onClick={() => dispatchOpenPostSearch()}>修改搜索</Button>
+                    <Button variant="ghost" onClick={postSearch.clearSearch}>清除筛选条件</Button>
+                    <Button variant="ghost" onClick={() => nav('/')}>返回全部帖子</Button>
+                  </>
+                ) : view.boardId > 0 ? (
+                  <>
+                    <Button variant="ghost" onClick={() => nav('/')}>看看其他板块</Button>
+                    {user ? (
+                      <Button variant="default" onClick={() => nav(composeTarget)}>发第一帖</Button>
+                    ) : (
+                      <Button variant="default" onClick={() => nav(loginPath(composeTarget))}>登录后发帖</Button>
+                    )}
+                  </>
+                ) : user ? (
+                  <Button variant="default" onClick={() => nav(composeTarget)}>发第一帖</Button>
+                ) : (
+                  <Button variant="default" onClick={() => nav(loginPath(composeTarget))}>登录后发帖</Button>
+                )}
+              </div>
+            </div>
+          ) : (
+            <>
+              <div className="content-surface content-surface--ssr">
+                {posts.map((post) => (
+                  <PostListItem
+                    key={post.id}
+                    post={post}
+                    sort={view.sort}
+                    boardId={view.boardId}
+                    onSelect={handleSelectPost}
+                  />
+                ))}
+              </div>
+              {showPagination && (
+                <div className="feed-list-footer feed-list-footer--pagination">
+                  <FeedPagination
+                    page={page}
+                    totalPages={totalPages}
+                    postTotal={postTotal}
+                    loading={loading}
+                    onPageChange={goToPage}
+                  />
+                </div>
+              )}
+              {showEnd && (
+                <div className="feed-list-footer feed-list-footer--end">— 已加载全部 —</div>
+              )}
+              <InFlowSiteFooter />
+            </>
+          )}
+        </div>
      </div>
    </div>
  );
--- a/frontend/src/pages/LinksPage.tsx
+++ b/frontend/src/pages/LinksPage.tsx
@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
-import { Link, useNavigate, useSearchParams } from 'react-router-dom';
+import { Link, useNavigate, useSearchParams } from 'react-router';
 import { ArrowLeft, Link2, Pencil, Plus, Trash2 } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { Badge } from '@/components/ui/badge';
--- a/frontend/src/pages/LoginPage.tsx
+++ b/frontend/src/pages/LoginPage.tsx
@@ -1,5 +1,5 @@
 import { useState } from 'react';
-import { useNavigate, Link, useSearchParams } from 'react-router-dom';
+import { useNavigate, Link, useSearchParams } from 'react-router';
 import { useForm } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
--- a/frontend/src/pages/MessagesPage.tsx
+++ b/frontend/src/pages/MessagesPage.tsx
--- a/frontend/src/pages/NotFoundPage.tsx
+++ b/frontend/src/pages/NotFoundPage.tsx
@@ -1,4 +1,4 @@
-import { useNavigate } from 'react-router-dom';
+import { useNavigate } from 'react-router';
 import { FileQuestion, Home } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { usePageSEO } from '../hooks/usePageSEO';
--- a/frontend/src/pages/PostDetailPage.tsx
+++ b/frontend/src/pages/PostDetailPage.tsx
@@ -1,5 +1,5 @@
 import { useState, useEffect, useLayoutEffect, useRef, useCallback, useMemo } from 'react';
-import { useParams, useNavigate, useOutletContext, useLocation, useNavigationType } from 'react-router-dom';
+import { useParams, useNavigate, useOutletContext, useLocation, useNavigationType } from 'react-router';
 import { ArrowLeft, ThumbsUp, Star, Lock, MessageSquare, MessageSquareOff, Flag, MoreHorizontal } from 'lucide-react';
 import FeaturedIcon from '@/components/FeaturedIcon';
 import { Button } from '@/components/ui/button';
@@ -33,7 +33,7 @@ import {
 } from '@/components/ui/dialog';
 import { notify } from '@/lib/notify';
 import { api } from '../api/client';
-import type { PostItem, Comment, ReportReason, PollView, PostLotteryView } from '../api/types';
+import type { PostItem, Comment, PollView, PostLotteryView, ReportReason } from '../api/types';
 import { REPORT_REASON_OPTIONS } from '../utils/report';
 import CommentThreadList from '../components/CommentThreadList';
 import CommentBox, { type CommentSubmitData } from '../components/CommentBox';
@@ -48,15 +48,15 @@ import ArticleOutline from '../components/ArticleOutline';
 import { useAuth } from '../hooks/useAuth';
 import { joinSEOKeywords, usePageSEO } from '../hooks/usePageSEO';
 import { getCachedSiteBranding } from '../hooks/useSiteBranding';
-import { formatDateTime, isTimeDiffSignificant } from '../utils/content';
+import { formatDateTime } from '../utils/content';
 import { collectCommentSubtreeIds } from '../utils/comment';
 import { loadMyCommentIds } from '../utils/guest';
 import { clearAllFeedCache, PAGE_FORCE_REFRESH_EVENT } from '../utils/feedCache';
 import { PAGE_SOFT_REFRESH_COMMIT_EVENT } from '../utils/softRefresh';
 import { deleteSessionSnapshot, getSessionSnapshot, setSessionSnapshot } from '../utils/sessionPageCache';
-import { useGlobalWheelScroll } from '../hooks/useGlobalWheelScroll';
 import { loginPath } from '../utils/authRedirect';
 import { excerptFromHTML, firstImageFromHTML } from '../utils/seoText';
+import { buildPostDetailSnapshot, postDetailCacheKey, type PostDetailSnapshot } from '../utils/homeBoot';
 import { canonicalRedirectPath, parsePermalinkID, postPath } from '../utils/permalink';
 import { useForumLimits } from '../hooks/useForumLimits';
 import type { LayoutCtx } from '../layouts/MainLayout';
@@ -65,27 +65,6 @@ import { renderPostContentHtml } from '../utils/postContent';
 import { InFlowSiteFooter } from '../components/SiteFooter';
 import NotFoundPage from './NotFoundPage';

-type PostDetailSnapshot = {
-  post: PostItem;
-  comments: Comment[];
-  poll: PollView | null;
-  lottery: PostLotteryView | null;
-  liked: boolean;
-  favorited: boolean;
-  canEdit: boolean;
-  isEdited: boolean;
-  editBlockReason: string;
-  editWindowHours: number;
-  bountyCanRefund: boolean;
-  bountyRefundBlockReason: string;
-  bountyEligibleReplyCount: number;
-  scrollTop: number;
-};
-
-function postDetailCacheKey(id: number) {
-  return `post:${id}`;
-}
-
 /** 格式化剩余可编辑时间 */
 function formatEditRemaining(createdAt: string, windowHours: number): string {
  if (windowHours <= 0) return '';
@@ -109,7 +88,7 @@ export default function PostDetailPage() {
  const { limits } = useForumLimits();
  const { setPostOutline, isMobile } = useOutletContext<LayoutCtx>();

-  const initialSnap = (postId && !Number.isNaN(postId))
+  const initialSnap = (postId && !Number.isNaN(postId) && navType === 'POP')
    ? getSessionSnapshot<PostDetailSnapshot>(postDetailCacheKey(postId))
    : undefined;

@@ -145,24 +124,17 @@ export default function PostDetailPage() {
  const [bountyCanRefund, setBountyCanRefund] = useState(initialSnap?.bountyCanRefund ?? true);
  const [bountyRefundBlockReason, setBountyRefundBlockReason] = useState(initialSnap?.bountyRefundBlockReason ?? '');
  const [bountyEligibleReplyCount, setBountyEligibleReplyCount] = useState(initialSnap?.bountyEligibleReplyCount ?? 0);
-  /** 仅浏览器后退/前进还原滚动；从列表再次点进帖子从顶部开始 */
-  const [restoreScrollTop, setRestoreScrollTop] = useState<number | null>(() => {
-    if (!initialSnap) return null;
-    if (navType === 'POP' && !location.hash) return initialSnap.scrollTop;
-    return 0;
-  });
+  const [authorProfile, setAuthorProfile] = useState<PostDetailSnapshot['authorProfile']>(initialSnap?.authorProfile ?? null);
+  const [authorStats, setAuthorStats] = useState<PostDetailSnapshot['authorStats']>(initialSnap?.authorStats ?? null);

-  const pageRef = useRef<HTMLDivElement>(null);
  const commentSectionRef = useRef<HTMLDivElement>(null);
  const commentBoxRef = useRef<HTMLDivElement>(null);
-  const highlightTimer = useRef<ReturnType<typeof setTimeout>>();
+  const highlightTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
  const postRef = useRef<PostItem | null>(null);
-  const scrollTopRef = useRef(
-    initialSnap && navType === 'POP' && !location.hash ? initialSnap.scrollTop : 0,
-  );
  postRef.current = post;

-  useGlobalWheelScroll(pageRef, !loading && !!post);
+  // 滚动位置完全交给浏览器原生历史恢复（详情页为文档滚动，见 .app-shell--doc-scroll），
+  // 会话快照只缓存数据让 POP 后退时内容即时渲染、文档即刻够高，原生恢复才有正确落点。

  // SPA 内跳转时纠正非规范伪静态路径
  useEffect(() => {
@@ -212,14 +184,16 @@ export default function PostDetailPage() {
    }
    setPostOutline({
      headings,
-      scrollRoot: pageRef.current,
+      scrollRoot: null,
      title: '文章目录',
      author: post.user ?? null,
      publishedAt: post.created_at,
      viewCount: post.view_count,
+      authorProfile,
+      authorStats,
    });
    return () => setPostOutline(null);
-  }, [headings, loading, post, setPostOutline]);
+  }, [headings, loading, post, authorProfile, authorStats, setPostOutline]);

  const loadSeq = useRef(0);
  const detailPath = postPath(postId, limits);
@@ -237,16 +211,12 @@ export default function PostDetailPage() {
    setBountyCanRefund(snap.bountyCanRefund);
    setBountyRefundBlockReason(snap.bountyRefundBlockReason);
    setBountyEligibleReplyCount(snap.bountyEligibleReplyCount);
+    setAuthorProfile(snap.authorProfile ?? null);
+    setAuthorStats(snap.authorStats ?? null);
    setComments(snap.comments);
-    if (opts?.restoreScroll) {
-      scrollTopRef.current = snap.scrollTop;
-      setRestoreScrollTop(snap.scrollTop);
-    } else {
-      scrollTopRef.current = 0;
-      // 同组件换帖时容器可能仍停在上一帖位置；初次进入已是 0 则不动，避免覆盖 #floor-N
-      const el = pageRef.current;
-      if (el && el.scrollTop !== 0) setRestoreScrollTop(0);
-    }
+    // POP（后退/前进）不干预，交给浏览器原生恢复；
+    // PUSH 换帖 / 强制刷新是「换新内容」场景，文档滚动置顶
+    if (!opts?.restoreScroll) window.scrollTo(0, 0);
  }, []);

  const loadPostRef = useRef<(mode: 'auto' | 'force') => void>(() => {});
@@ -259,7 +229,7 @@ export default function PostDetailPage() {
    if (mode === 'force') {
      deleteSessionSnapshot(postDetailCacheKey(postId));
    }
-    const cached = mode === 'force'
+    const cached = mode === 'force' || navType !== 'POP'
      ? undefined
      : getSessionSnapshot<PostDetailSnapshot>(postDetailCacheKey(postId));
    if (cached) {
@@ -290,29 +260,13 @@ export default function PostDetailPage() {
        ]);
        if (seq !== loadSeq.current) return;
        const commentsList = Array.isArray(comm.comments) ? comm.comments : [];
-        const snap: PostDetailSnapshot = {
-          post: detail.post,
-          comments: commentsList,
-          poll: detail.poll ?? null,
-          lottery: detail.lottery ?? null,
-          liked: detail.liked,
-          favorited: detail.favorited,
-          canEdit: detail.can_edit ?? false,
-          isEdited: detail.is_edited ?? isTimeDiffSignificant(detail.post.created_at, detail.post.updated_at ?? detail.post.created_at),
-          editBlockReason: detail.edit_block_reason ?? '',
-          editWindowHours: detail.post_edit_window_hours ?? 0,
-          bountyCanRefund: detail.bounty_can_refund ?? true,
-          bountyRefundBlockReason: detail.bounty_refund_block_reason ?? '',
-          bountyEligibleReplyCount: detail.bounty_eligible_reply_count ?? 0,
-          scrollTop: 0,
-        };
+        // 作者主页资料一并拉取（右栏作者卡首帧完整；失败降级为卡片自行拉取）
+        const authorResp = detail.post.user_id
+          ? await api.userProfile(detail.post.user_id).catch(() => null)
+          : null;
+        const snap = buildPostDetailSnapshot(detail, commentsList, authorResp);
        setSessionSnapshot(postDetailCacheKey(postId), snap);
        applySnapshot(snap, { restoreScroll: false });
-        if (mode === 'force') {
-          const el = pageRef.current;
-          if (el) el.scrollTop = 0;
-          scrollTopRef.current = 0;
-        }
        void refresh();
      } catch {
        if (seq !== loadSeq.current) return;
@@ -329,19 +283,9 @@ export default function PostDetailPage() {
  }, [postId]);

  useEffect(() => {
-    // 下拉已预热则应用快照；否则强制重拉
+    // 下拉/软刷新：始终强制重拉，确保拿到最新数据
    const onForce = () => {
      if (!postId || Number.isNaN(postId)) return;
-      const warm = getSessionSnapshot<PostDetailSnapshot>(postDetailCacheKey(postId));
-      if (warm) {
-        loadSeq.current += 1;
-        applySnapshot(warm, { restoreScroll: false });
-        setLoading(false);
-        const el = pageRef.current;
-        if (el) el.scrollTop = 0;
-        scrollTopRef.current = 0;
-        return;
-      }
      loadPostRef.current('force');
    };
    window.addEventListener(PAGE_FORCE_REFRESH_EVENT, onForce);
@@ -352,23 +296,6 @@ export default function PostDetailPage() {
    };
  }, [postId, applySnapshot]);

-  useEffect(() => {
-    const el = pageRef.current;
-    if (!el || loading || !post) return;
-    const onScroll = () => {
-      scrollTopRef.current = el.scrollTop;
-    };
-    el.addEventListener('scroll', onScroll, { passive: true });
-    return () => el.removeEventListener('scroll', onScroll);
-  }, [loading, post]);
-
-  useLayoutEffect(() => {
-    if (restoreScrollTop == null || !pageRef.current || loading || !post) return;
-    pageRef.current.scrollTop = restoreScrollTop;
-    scrollTopRef.current = restoreScrollTop;
-    setRestoreScrollTop(null);
-  }, [restoreScrollTop, loading, post]);
-
  useEffect(() => {
    if (!post || post.id !== postId || loading) return;
    setSessionSnapshot(postDetailCacheKey(post.id), {
@@ -385,22 +312,16 @@ export default function PostDetailPage() {
      bountyCanRefund,
      bountyRefundBlockReason,
      bountyEligibleReplyCount,
-      scrollTop: scrollTopRef.current,
+      authorProfile,
+      authorStats,
+      scrollTop: 0,
    });
  }, [
    post, comments, poll, lottery, liked, favorited, canEdit, isEdited,
    editBlockReason, editWindowHours, bountyCanRefund, bountyRefundBlockReason,
-    bountyEligibleReplyCount, postId, loading,
+    bountyEligibleReplyCount, authorProfile, authorStats, postId, loading,
  ]);

-  useEffect(() => () => {
-    const p = postRef.current;
-    if (!p) return;
-    const prev = getSessionSnapshot<PostDetailSnapshot>(postDetailCacheKey(p.id));
-    if (!prev) return;
-    setSessionSnapshot(postDetailCacheKey(p.id), { ...prev, scrollTop: scrollTopRef.current });
-  }, []);
-
  const reloadComments = useCallback(async () => {
    const myIds = user ? [] : loadMyCommentIds();
    const comm = await api.comments(postId, myIds);
@@ -470,102 +391,55 @@ export default function PostDetailPage() {
    return () => root.removeEventListener('focusout', onFocusOut);
  }, [isMobile, composerOpen]);

+  /**
+   * 详情页为窗口滚动：scroll-margin-top 预留 sticky 顶栏空间。
+   * 首屏图片/字体加载会持续改变布局，落点需短暂校正；用户手动滚动立即让位。
+   */
+  const scrollAnchorIntoView = useCallback((el: HTMLElement) => {
+    el.scrollIntoView({ block: 'start' });
+
+    let interrupted = false;
+    const yieldToUser = () => { interrupted = true; };
+    window.addEventListener('wheel', yieldToUser, { passive: true });
+    window.addEventListener('touchmove', yieldToUser, { passive: true });
+
+    const start = Date.now();
+    (function correct() {
+      window.removeEventListener('wheel', yieldToUser);
+      window.removeEventListener('touchmove', yieldToUser);
+      if (interrupted || !el.isConnected || Date.now() - start > 1500) return;
+      const margin = parseFloat(getComputedStyle(el).scrollMarginTop) || 0;
+      if (Math.abs(el.getBoundingClientRect().top - margin) > 4) {
+        el.scrollIntoView({ block: 'start' });
+      }
+      window.addEventListener('wheel', yieldToUser, { passive: true });
+      window.addEventListener('touchmove', yieldToUser, { passive: true });
+      window.setTimeout(correct, 120);
+    })();
+  }, []);
+
  const jumpToFloor = useCallback((floor: number) => {
    const el = document.getElementById(`floor-${floor}`);
    if (!el) return false;

-    const root = pageRef.current;
-    if (!root) return false;
-
-    // 直接计算目标滚动位置
-    const rootRect = root.getBoundingClientRect();
-    const elRect = el.getBoundingClientRect();
-    const relativeTop = elRect.top - rootRect.top;
-    const initialMaxScrollTop = root.scrollHeight - root.clientHeight;
-    const targetTop = root.scrollTop + relativeTop - 24;
-
-    // 如果 relativeTop 非常异常（如 NaN 或 Infinity），说明布局可能还没完成
-    if (!isFinite(targetTop) || targetTop < -500) return false;
-
-    const clampedTop = Math.max(0, Math.min(targetTop, initialMaxScrollTop));
-
-    // 直接设置滚动位置（不使用平滑滚动，避免动画干扰）
-    root.scrollTop = clampedTop;
-
-    // 验证滚动结果，如果不准确则再次调整
-    // 注意：使用动态计算的 currentMaxScrollTop，因为评论可能在之后才渲染完成
-    const verifyAndFix = () => {
-      const currentElRect = el.getBoundingClientRect();
-      const currentRootRect = root.getBoundingClientRect();
-      const currentRelativeTop = currentElRect.top - currentRootRect.top;
-      const currentMaxScrollTop = root.scrollHeight - root.clientHeight;
-
-      // 如果元素在视口内但位置不准确，进行修正
-      if (root.scrollTop > 0 && Math.abs(currentRelativeTop - 24) > 10) {
-        const correction = currentRelativeTop - 24;
-        const newTarget = Math.max(0, Math.min(root.scrollTop + correction, currentMaxScrollTop));
-        root.scrollTop = newTarget;
-      }
-    };
-
-    // 在多个时间点验证和调整
-    requestAnimationFrame(verifyAndFix);
-    setTimeout(verifyAndFix, 50);
-    setTimeout(verifyAndFix, 150);
+    scrollAnchorIntoView(el);

    setHighlightFloor(floor);
    clearTimeout(highlightTimer.current);
    highlightTimer.current = setTimeout(() => setHighlightFloor(null), 2000);
    return true;
-  }, []);
+  }, [scrollAnchorIntoView]);

-  /** 正文标题锚点：滚动容器是 pageRef，原生 hash 定位无效，需手动滚 */
-  const jumpToHeadingHash = useCallback((hash: string, smooth = false) => {
+  /** 正文标题锚点：等正文进 DOM 后由调用方重试 */
+  const jumpToHeadingHash = useCallback((hash: string) => {
    const id = decodeURIComponent((hash || '').replace(/^#/, '')).trim();
    if (!id || /^floor-\d+$/.test(id)) return false;
    const el = document.getElementById(id);
    if (!el) return false;

-    const root = pageRef.current;
-    if (!root) return false;
-
-    // 直接计算目标滚动位置
-    const rootRect = root.getBoundingClientRect();
-    const elRect = el.getBoundingClientRect();
-    const relativeTop = elRect.top - rootRect.top;
-    const initialMaxScrollTop = root.scrollHeight - root.clientHeight;
-    const targetTop = root.scrollTop + relativeTop - 12;
-
-    // 如果 relativeTop 非常异常（如 NaN 或 Infinity），说明布局可能还没完成
-    if (!isFinite(targetTop) || targetTop < -500) return false;
-
-    const clampedTop = Math.max(0, Math.min(targetTop, initialMaxScrollTop));
-
-    // 直接设置滚动位置
-    root.scrollTop = clampedTop;
-
-    // 验证滚动结果，如果不准确则再次调整
-    const verifyAndFix = () => {
-      const currentElRect = el.getBoundingClientRect();
-      const currentRootRect = root.getBoundingClientRect();
-      const currentRelativeTop = currentElRect.top - currentRootRect.top;
-      const currentMaxScrollTop = root.scrollHeight - root.clientHeight;
-
-      if (root.scrollTop > 0 && Math.abs(currentRelativeTop - 12) > 10) {
-        const correction = currentRelativeTop - 12;
-        const newTarget = Math.max(0, Math.min(root.scrollTop + correction, currentMaxScrollTop));
-        root.scrollTop = newTarget;
-      }
-    };
-
-    requestAnimationFrame(verifyAndFix);
-    if (smooth) {
-      setTimeout(verifyAndFix, 50);
-      setTimeout(verifyAndFix, 150);
-    }
-
+    scrollAnchorIntoView(el);
    return true;
-  }, []);
+  }, [scrollAnchorIntoView]);

  // 从 #floor-N 定位到对应评论（右栏最新评论等入口）；等评论进 DOM 后重试，避免首屏 hash 失效
  useEffect(() => {
@@ -607,7 +481,7 @@ export default function PostDetailPage() {

    const tryJump = () => {
      if (cancelled) return;
-      if (jumpToHeadingHash(hash, false)) return;
+      if (jumpToHeadingHash(hash)) return;
      attempts += 1;
      if (attempts < 30) {
        timer = window.setTimeout(tryJump, 50);
@@ -816,7 +690,8 @@ export default function PostDetailPage() {
  const handlePin = async () => {
    if (!post) return;
    try {
-      const r = await api.adminPinPost(postId, !post.pinned);
+      const next = post.pinned > 0 ? 0 : 1;
+      const r = await api.adminPinPost(postId, next);
      setPost(p => p ? { ...p, pinned: r.pinned } : p);
      clearAllFeedCache();
      window.dispatchEvent(new Event('posts-refresh'));
@@ -829,7 +704,8 @@ export default function PostDetailPage() {
  const handleBoardPin = async () => {
    if (!post) return;
    try {
-      const r = await api.adminBoardPinPost(postId, !post.board_pinned);
+      const next = (post.board_pinned ?? 0) > 0 ? 0 : 1;
+      const r = await api.adminBoardPinPost(postId, next);
      setPost(p => p ? { ...p, board_pinned: r.board_pinned } : p);
      clearAllFeedCache();
      window.dispatchEvent(new Event('posts-refresh'));
@@ -954,7 +830,7 @@ export default function PostDetailPage() {
  };

  return (
-    <article className="page-wrap post-detail-page" ref={pageRef}>
+    <article className="page-wrap post-detail-page">
      <div className="post-detail-header">
        <div className="post-detail-nav">
          <div className="post-detail-nav-left">
@@ -1005,10 +881,10 @@ export default function PostDetailPage() {

        <div className="post-detail-head">
          <h1 className="post-detail-title">
-            {post.pinned && (
+            {post.pinned > 0 && (
              <span className="post-pin-badge post-pin-badge--detail" title="全局置顶">全局置顶</span>
            )}
-            {post.board_pinned && (
+            {(post.board_pinned ?? 0) > 0 && (
              <span className="post-pin-badge post-pin-badge--board post-pin-badge--detail" title="板块置顶">板块置顶</span>
            )}
            {post.featured && <FeaturedIcon className="mr-2" size={18} />}
@@ -1091,7 +967,6 @@ export default function PostDetailPage() {
            <summary>文章目录（{headings.length}）</summary>
            <ArticleOutline
              headings={headings}
-              scrollRoot={pageRef.current}
              title="目录"
            />
          </details>
--- a/frontend/src/pages/ProfilePage.tsx
+++ b/frontend/src/pages/ProfilePage.tsx
@@ -1,5 +1,5 @@
 import { useState, useRef, useEffect, useCallback } from 'react';
-import { useNavigate, useSearchParams } from 'react-router-dom';
+import { useNavigate, useSearchParams } from 'react-router';
 import { useForm } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
@@ -91,7 +91,7 @@ export default function ProfilePage() {
  const [idCopied, setIdCopied] = useState(false);
  const fileRef = useRef<HTMLInputElement>(null);
  const dragCounter = useRef(0);
-  const copyTimer = useRef<ReturnType<typeof setTimeout>>();
+  const copyTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
  const sigSectionRef = useRef<HTMLDivElement>(null);
  const pendingFocusSig = useRef(false);

--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
freefire	20aee9c566	chore: 清理 SSR 改造后的历史遗留死代码与误提交产物 - 删除图形验证码整条死链：service/captcha.go、APICaptcha、 GET /api/captcha、CaptchaService 装配、ErrCaptchaInvalid 及前端 api.captcha()（注册/登录已改用邮箱验证码，Verify 无任何调用方） - 删除 GET /api/posts/hot 死路由：APIHotPosts + PostService.HotPosts （热门排序走 /api/posts?sort=hot） - 删除 GET /api/posts/:id/revisions/:revId 死路由： APIPostRevisionDetail + PostService.GetRevision + ErrRevisionNotFound 及前端 api.postRevision()（历史面板仅用列表接口） - 停止跟踪误提交的 27.5MB Linux 二进制 jiang13-linux-amd64 与 .vite 依赖缓存；.gitignore 补充对应规则并移除已失效的 embed_static 条目	2026-09-11 00:39:58 +08:00
freefire	45cc864971	feat(ssr): 扩展 SSR 覆盖至 /page/:slug 与 /user/:id - feedPaths 白名单加入自定义单页与用户主页（兼容 .html 伪静态） - head.ts 新增 buildPageHead（ogType=article, WebPage JSON-LD）与 buildUserHead（ogType=profile, Person JSON-LD） - feedData 新增 loadPageData / loadUserData，并行取页面/用户数据 + 壳层，404 走 buildNotFoundHead + noindex - feedSeed 按 useSessionResource 的 key 约定 seed： sitepage:${slug}、user:${id}、user:${id}:posts:1:${size}，使 SitePageView / UserProfilePage 首帧直接命中快照渲染 - MainLayout postOutline 首帧派生扩展 /page/:slug 分支，文章目录随正文一同 SSR - 验证：两页 SSR HTML 含完整内容与 head，0 hydration 错误， hydration 后仅剩 pageview 请求；404 正确；已有页面无回归	2026-09-10 19:26:14 +08:00
freefire	3c6d8cb891	feat(ssr): 帖子页全量 SSR——作者卡/目录首帧服务端渲染，消除冗余首屏请求 - 帖子快照携带作者主页资料与统计（authorProfile/authorStats）， SSR 端与客户端预热均取 /api/users/:id；PostAuthorCard 首帧直接渲染，不再挂载后请求，统计数字不再显示 — 占位 - MainLayout 首帧从已 seed 的帖子快照派生右栏 outline（作者卡+文章目录），修复 outline 仅靠 effect 上报导致 SSR 不渲染右栏的问题 - 壳层首屏请求门控：useAuth 有种子跳过 /api/me、branding 缓存命中不重拉、侧栏三个区块首屏用 seed 缓存、未读数首屏跳过即时请求（轮询/事件刷新保留） - serverDom(linkedom) 修复：DOMParser 片段包裹、属性顺序、SVG 自闭合展开 - 验证：首页与帖子页 hydration 后仅剩 pageview 上报，0 hydration 错误	2026-09-10 05:04:31 +08:00
freefire	2392768868	feat(ssr): 真 SSR 收尾——干净 hydration 与浏览器原生滚动恢复 - 修复 onRenderClient 引入 serverClient 导致浏览器 process is not defined：抽出双端安全的 ssr/feedSeed.ts 作为唯一数据播种入口，serverClient 加 SSR 守卫 - 修复 React 19 Fizz Suspense Outlining：Suspense 边界从布局 Outlet 下移到各懒加载路由，SSR 输出不再出现 <!--$?--> / $RB / template 探针标记 - 修复窄屏 React #418 hydration 致命错误：useMediaQuery 首帧恒 false， useLayoutEffect 绘制前同步真实值；主题改 cookie 存储供 SSR 直出， head 内联防闪烁/缩放脚本移除（缩放锁改为客户端 zoomGuard 模块） - 清理假 SSR 残留：删除 StaticFeedList 镜像组件、SSR 图标生成脚本、探针与死代码；列表接口裁剪正文，仅下发 excerpt/first_image - Feed 与帖子详情改为窗口滚动（app-shell--doc-scroll）：删除虚拟列表、自研滚动快照与全局滚轮 hack；F5/前进后退滚动位置全部交给浏览器原生历史恢复，HTML 响应头 no-cache 配合；锚点/楼层用 scrollIntoView + scroll-margin-top 适配 sticky 顶栏	2026-09-09 20:53:28 +08:00
freefire	3702e3d1f2	chore: Tailwind CSS 3.4 迁移到 4.x（CSS-first 配置 + @tailwindcss/vite） - 升级 tailwindcss@4.3 + @tailwindcss/vite，移除 postcss/autoprefixer/tailwindcss-animate - tailwindcss-animate 替换为 tw-animate-css（v4 兼容的 animate-in/out 工具类） - global.css 改用 @import "tailwindcss" + @theme inline 映射 shadcn 设计令牌 - @custom-variant dark 替代 darkMode:'class'；@source 显式纳入 pages/ 目录 - 删除 tailwind.config.ts / postcss.config.js，components.json 同步 v4 约定 - vite.config.ts 接入 tailwindcss 插件，__dirname 改 import.meta.dirname	2026-09-09 02:54:56 +08:00
freefire	230006a905	chore: Docker 双服务 + Makefile/build.ps1 双进程目标 + README 架构更新 - Dockerfile 改为 Node 24 运行时：Vike 产物 + Go API 二进制共用镜像 - docker-compose 双容器：web(:3000 对外 SSR) + api(:3001 内部，持 /data 卷) - entrypoint 改用 gosu 降权（Debian 基础镜像），健康检查用 node fetch - Makefile/build.ps1：build 不再打包前端，新增 serve（本地双进程）与 web-build - README 同步双服务架构、端口/环境变量、部署与开发说明	2026-09-09 02:48:28 +08:00
freefire	ba39376a0e	refactor: Go 端收缩，移除 SPA 服务与 embed_static - 删除 embed_static（内嵌 SPA 静态资源）与 handler/ssr_home.go、ssr_icons.go - router 移除前端页面服务，NoRoute 统一返回 404 JSON - seo.go 仅保留 robots.txt / sitemap.xml / favicon.ico - 数据聚合逻辑迁移到 handler/home_boot.go（/api/home-boot） - 启动日志改为提示前端由 Node 渲染服务器提供	2026-09-09 02:41:53 +08:00
freefire	1ce0f123fa	feat: Node 渲染服务器（express + renderPage + API 反代） - server/index.mjs：生产模式 Express 服务，静态资源 immutable 缓存 - /api /uploads /media 等前缀反代到 Go API，xfwd 透传客户端 IP - Vike renderPage 承接 SSR，渲染失败返回 500 兜底页 - /healthz 健康检查端点	2026-09-09 02:41:39 +08:00
freefire	c99238c1e7	feat: Vike +data 服务端取数 / SEO Head 移植 / 404 错误页 / 服务端 DOM 模拟 - feedData.ts 聚合首页/板块/帖子详情数据，缺失内容 throw render(404) - Go 侧 spa_meta/seo 的 head 生成逻辑移植到 src/ssr/head.ts - _error 页复用站点壳渲染 404，+data 从 abortReason 恢复壳层数据 - linkedom 模拟服务端 DOM，DOMPurify 封装为 SSR 透传的 sanitizeHtml - 新增 /api/home-boot 聚合端点（handler/home_boot.go）供 SSR 冷启动灌缓存	2026-09-09 02:41:30 +08:00
freefire	e71c77b5ca	feat: Vike 骨架（pages feed+spa / renderer 双端入口 / AppShell 拆分 / serverClient） vite.config 接入 vike 插件并改产出 dist/client+dist/server；feed 白名单 route 匹配 /、/board/:id、/post/:id(.html)；spa catch-all ssr:false；onRenderHtml renderToReadableStream 等 allReady 输出完整 HTML 并带主题/缩放脚本；onRenderClient 沿用样式表等待+冷启动预热+hydrate 回退；getHomeStoreState 作用域 + hydrating 变体入 RequestScope；删除 index.html 与 main.tsx	2026-09-09 01:21:58 +08:00
freefire	27132e89c2	feat: SSR 安全防卫与缓存作用域化（branding/limits/pages/auth/session） theme/useTheme 服务端防卫 window/document；branding/limits/pages 缓存读请求作用域、seed 只写作用域；homeBoot 拆出 seedHomeBoot 与帖子详情快照构建器供 prefetchRoute 复用；getHomeStoreState 改返回 state 修复命令式访问	2026-09-09 01:05:12 +08:00
freefire	86a317c862	feat: SSR 请求级作用域（AsyncLocalStorage）+ homeStore 工厂化 + layoutCache 作用域适配	2026-09-09 00:35:19 +08:00
freefire	52d328ffc3	chore: 工具链升级到最新版本（Vite 8 / React 19 / react-router 8 / TS 7 / Go 1.26 依赖更新） - 前端：vite ^8.2.2、react/react-dom ^19.2.8、react-router ^8.3.1（移除 react-router-dom）、typescript ^7.0.2、zustand ^5.0.15；适配升级带来的类型变化（react-hook-form Resolver、ProseMirror node.parent、tiptap focus 参数、timer undefined 等） - 后端：升级 gin/jwt/minio-go/gorm/modernc-sqlite/x-crypto 等直接依赖至最新；gowebp v0.1.1 已是最新版本 - tsconfig 移除 baseUrl，paths 改为相对路径以兼容 TS7	2026-09-09 00:14:12 +08:00
freefire	711cd8b759	feat: 帖子全局/板块置顶支持权重排序，优化列表与详情渲染	2026-09-08 23:54:03 +08:00
freefire	de2f5e8be8	docs: changelog 排版优化，每个版本统一分隔线 + 📦 图标 + 日期格式统一	2026-09-02 19:51:12 +08:00
freefire	5c774f9a83	docs: 更新 changelog 为 v1.1.8	2026-09-02 19:49:13 +08:00
freefire	f3f50d7e90	chore: bump version to 1.1.8	2026-09-02 19:40:35 +08:00
freefire	67bef6dc08	chore: 同步 Cursor 构建规则到 Trae，优化 .gitignore - 新增 .trae/rules/build-scripts.mdc，与 Cursor 的 .cursor/rules/build-scripts.mdc 保持一致 - .gitignore 从忽略整个 .trae/ 改为仅忽略 .trae/documents/、.trae/chat/、.trae/image/ 等临时产物 - 保留 .trae/rules/ 可被 git 追踪，规则可跨机器同步 - 取消追踪已存在的 .trae/documents/ 临时规划文档	2026-09-02 19:34:49 +08:00
freefire	23e304ac53	chore: 在 .gitignore 中添加 .trae/ 目录	2026-09-02 19:30:33 +08:00
freefire	cad53942e8	fix: 修复消息未读数同步和帖子详情快照逻辑 - MessagesPage: 新增 updateConvUnread 统一更新会话未读数及 session 缓存，缓存命中时仍调用 markConversationRead 并触发未读刷新，全部标为已读时同步更新 session 缓存避免 stale 数据 - PostDetailPage: 仅 POP 导航类型使用 session 快照恢复，非 POP 导航和下拉刷新始终强制重拉确保拿到最新数据	2026-09-02 19:29:01 +08:00
freefire	76be8926f2	feat: 完善表情选择与评论富文本展示发帖编辑器支持 OwO 贴纸；评论区复用文章列表、段落与代码块阅读态，并优化表情面板间距与悬停反馈。 Co-authored-by: Cursor <cursoragent@cursor.com>	2026-09-02 03:57:41 +08:00
freefire	4d93e455f9	fix: 私信表情插入编辑框，不再作为图片附件发送 Co-authored-by: Cursor <cursoragent@cursor.com>	2026-09-02 03:12:33 +08:00
freefire	c958dcfd80	chore: 发布 Docker 镜像版本 1.1.7 Co-authored-by: Cursor <cursoragent@cursor.com>	2026-09-02 03:01:36 +08:00
freefire	84bfbd9a3e	fix: 帖子详情右栏默认头像与全站配色一致作者卡占位头像改为深绿底白字，与 post-avatar 默认样式统一。	2026-09-02 02:50:23 +08:00
freefire	500e452c2f	feat: 重设计私信页并优化开源展柜体验私信改为飞书风布局，支持缩略图表情/图片、按会话草稿与用户搜索发起会话；主页发私信直达消息页。开源展柜修复空列表粘滞并改版目录式 UI。	2026-09-02 02:45:29 +08:00
freefire	1c0f7ede55	fix: 待审通知实时回填审核态并重构消息页体验	2026-09-02 01:39:27 +08:00