refactor: Gitea 式目录改组，移除本分支 SPA 与杂项产物

将 model/service/handler/middleware 迁至 models/services/routers/api/modules/auth，并删除 frontend、embed_static、scripts 及误入库缓存/二进制。

Co-authored-by: Cursor <cursoragent@cursor.com>

.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 列密度更高
-   - 颜文字标签内字体清晰可读

.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 内容
-   - 保存后评论更新正确

.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`），验证定位效果

.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 编译通过。

.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 静态文件服务方案

.vite/deps/_metadata.json

@@ -1,8 +0,0 @@
-{
-  "hash": "de7e4cff",
-  "configHash": "9a7296da",
-  "lockfileHash": "e3b0c442",
-  "browserHash": "8c168d3c",
-  "optimized": {},
-  "chunks": {}
-}

.vite/deps/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "module"
-}

embed_static/embed.go

@@ -1,91 +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__
-)
-
-// SetSPADocumentTitle 注册站点标题提供者，ServeSPA 会注入到入口 HTML，避免刷新闪烁
-func SetSPADocumentTitle(fn func() string) {
-	spaBrandTitleFn = fn
-}
-
-// SetSPABrandingJSON 注册品牌 JSON 提供者（须为合法 JSON 对象），供前端首屏同步读入
-func SetSPABrandingJSON(fn func() []byte) {
-	spaBrandJSONFn = 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) {
-			// hashed 资源可长期缓存；发版后文件名变更，旧 URL 自然 404
-			c.Header("Cache-Control", "public, max-age=31536000, immutable")
-			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
-}
-
-// 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 处理（已迁移的 SSR 路径返回 false）
-func IsSPARoute(path string) bool {
-	if path == "/" || path == "/health" || path == "/robots.txt" || path == "/sitemap.xml" {
-		return false
-	}
-	if strings.HasPrefix(path, "/board/") {
-		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, "/ssr-assets") ||
-		strings.HasPrefix(path, "/stickers") ||
-		strings.HasPrefix(path, "/oauth") ||
-		strings.HasPrefix(path, "/.well-known") {
-		return false
-	}
-	return true
-}

embed_static/spa_meta.go

@@ -1,156 +0,0 @@
-package embed_static
-
-import (
-	"bytes"
-	"encoding/json"
-	"html"
-	"net/http"
-	"strings"
-
-	"github.com/gin-gonic/gin"
-)
-
-// SPAPageMeta 注入到 SPA 入口 HTML 的 SEO / 社交预览元数据（仅 <head>，不写 #root，避免刷新闪屏）
-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
-}
-
-// 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 哈希
-	c.Header("Cache-Control", "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>"))
-	}
-
-	var head strings.Builder
-	writeMeta(&head, "description", meta.Description)
-	writeMeta(&head, "keywords", meta.Keywords)
-	if canonical := strings.TrimSpace(meta.Canonical); canonical != "" {
-		head.WriteString(`<link rel="canonical" href="` + html.EscapeString(canonical) + `"/>`)
-	}
-	robots := strings.TrimSpace(meta.Robots)
-	if robots != "" {
-		writeMeta(&head, "robots", robots)
-	}
-
-	ogType := strings.TrimSpace(meta.OGType)
-	if ogType == "" {
-		ogType = "website"
-	}
-	locale := strings.TrimSpace(meta.Locale)
-	if locale == "" {
-		locale = "zh_CN"
-	}
-	writeProp(&head, "og:type", ogType)
-	writeProp(&head, "og:site_name", meta.SiteName)
-	writeProp(&head, "og:locale", locale)
-	writeProp(&head, "og:title", firstNonEmpty(meta.Title, title))
-	writeProp(&head, "og:description", meta.Description)
-	writeProp(&head, "og:url", meta.Canonical)
-	writeProp(&head, "og:image", meta.OGImage)
-	writeMetaName(&head, "twitter:card", twitterCard(meta.OGImage))
-	writeMetaName(&head, "twitter:title", firstNonEmpty(meta.Title, title))
-	writeMetaName(&head, "twitter:description", meta.Description)
-	writeMetaName(&head, "twitter:image", meta.OGImage)
-
-	if jsonld := strings.TrimSpace(meta.JSONLD); jsonld != "" {
-		head.WriteString(`<script type="application/ld+json">`)
-		head.WriteString(jsonld)
-		head.WriteString(`</script>`)
-	}
-
-	// 同步注入品牌配置，避免 React 首屏用默认名闪一下
-	if boot := spaBrandingBootScript(); boot != "" {
-		head.WriteString(boot)
-	}
-
-	if head.Len() > 0 {
-		data = bytes.Replace(data, []byte("</head>"), []byte(head.String()+"</head>"), 1)
-	}
-
-	return data
-}
-
-// spaBrandingBootScript 生成 window.__J13_BRANDING__=...; 内联脚本
-func spaBrandingBootScript() string {
-	if spaBrandJSONFn == nil {
-		return ""
-	}
-	raw := bytes.TrimSpace(spaBrandJSONFn())
-	if len(raw) == 0 || !json.Valid(raw) {
-		return ""
-	}
-	// 防止 JSON 字符串中的 </script> 提前闭合标签
-	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 ""
-}

frontend/components.json

@@ -1,20 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "default",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "tailwind.config.ts",
-    "css": "src/styles/global.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  }
-}

frontend/index.html

@@ -1,64 +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>
-    <style>
-      /* 关键布局样式：在 JS/CSS 包加载前即固定三栏结构，避免刷新时组件错位 */
-      html { scrollbar-gutter: stable; }
-      html, body, #root { height: 100%; margin: 0; touch-action: pan-x pan-y; }
-      body { overflow: hidden; font-size: 14px; line-height: 1.5; }
-      .app-shell { height: 100%; max-height: 100dvh; display: flex; flex-direction: column; overflow: hidden; touch-action: pan-x pan-y; }
-      .app-frame { flex: 1; min-height: 0; height: 100%; max-width: 1400px; width: 100%; margin: 0 auto; display: flex; flex-direction: column; overflow: hidden; touch-action: pan-x pan-y; }
-      .app-header { height: 56px; flex-shrink: 0; }
-      .site-footer { flex-shrink: 0; }
-      .app-body { flex: 1; display: flex; min-height: 0; width: 100%; overflow: hidden; touch-action: pan-x pan-y; }
-      .content-workspace { flex: 1; display: flex; min-width: 0; min-height: 0; overflow: hidden; touch-action: pan-x pan-y; }
-      .sidebar { width: 210px; flex-shrink: 0; }
-      .main-content { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; touch-action: pan-x pan-y; }
-      .aside-panel { width: 280px; flex-shrink: 0; }
-      @media (max-width: 1100px) { .aside-panel { display: none; } }
-      @media (max-width: 768px) { .sidebar { display: none; } }
-    </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>

frontend/package.json

@@ -1,64 +0,0 @@
-{
-  "name": "jiang13-forum-web",
-  "private": true,
-  "version": "1.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "preview": "vite preview"
-  },
-  "dependencies": {
-    "@dnd-kit/core": "^6.3.1",
-    "@dnd-kit/sortable": "^10.0.0",
-    "@dnd-kit/utilities": "^3.2.2",
-    "@hookform/resolvers": "^5.4.0",
-    "@radix-ui/react-alert-dialog": "^1.1.16",
-    "@radix-ui/react-dialog": "^1.1.16",
-    "@radix-ui/react-dropdown-menu": "^2.1.17",
-    "@radix-ui/react-label": "^2.1.9",
-    "@radix-ui/react-slot": "^1.2.5",
-    "@radix-ui/react-switch": "^1.3.0",
-    "@tanstack/react-virtual": "^3.11.2",
-    "@tiptap/core": "^3.26.1",
-    "@tiptap/extension-code-block": "^3.26.1",
-    "@tiptap/extension-image": "^3.26.1",
-    "@tiptap/extension-link": "^3.26.1",
-    "@tiptap/extension-placeholder": "^3.26.1",
-    "@tiptap/extension-table": "^3.26.1",
-    "@tiptap/extension-underline": "^3.26.1",
-    "@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",
-    "dayjs": "^1.11.13",
-    "diff": "^9.0.0",
-    "dompurify": "^3.4.10",
-    "highlight.js": "^11.11.1",
-    "lucide-react": "^1.18.0",
-    "marked": "^18.0.5",
-    "postcss": "^8.5.15",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "react-easy-crop": "^6.0.2",
-    "react-hook-form": "^7.79.0",
-    "react-router-dom": "^6.28.0",
-    "sonner": "^2.0.7",
-    "tailwind-merge": "^3.6.0",
-    "tailwindcss": "^3.4.19",
-    "tailwindcss-animate": "^1.0.7",
-    "turndown": "^7.2.4",
-    "zod": "^4.4.3"
-  },
-  "devDependencies": {
-    "@types/node": "^25.9.3",
-    "@types/react": "^18.3.12",
-    "@types/react-dom": "^18.3.1",
-    "@types/turndown": "^5.0.6",
-    "@vitejs/plugin-react": "^4.3.4",
-    "typescript": "^5.6.3",
-    "vite": "^5.4.11"
-  }
-}

frontend/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};