@flecblog/core-nuxt 0.1.0

package/server/plugins/sitemap.ts

@@ -0,0 +1,170 @@
+// 动态生成 sitemap 路由
+
+interface SitemapArticle {
+  url: string;
+  title?: string;
+  cover?: string;
+  update_time?: string;
+  publish_time?: string;
+}
+
+interface SitemapCategory {
+  url: string;
+}
+
+interface SitemapTag {
+  url: string;
+}
+
+interface ArticlesResponse {
+  data?: {
+    list?: SitemapArticle[];
+  };
+}
+
+interface CategoriesResponse {
+  data?: {
+    list?: SitemapCategory[];
+  };
+}
+
+interface TagsResponse {
+  data?: {
+    list?: SitemapTag[];
+  };
+}
+
+interface SitemapImage {
+  loc: string;
+  caption?: string;
+}
+
+interface SitemapUrl {
+  loc: string;
+  lastmod?: string;
+  changefreq: 'weekly';
+  priority: number;
+  images?: SitemapImage[];
+}
+
+/**
+ * 将日期字符串转换为 W3C 标准的 ISO 8601 格式
+ * @param dateStr - 后端返回的日期字符串 (如 "2026-04-20 12:09:14")
+ * @returns ISO 8601 格式的日期字符串 (如 "2026-04-20T12:09:14+00:00")
+ */
+function formatW3CDate(dateStr: string | undefined): string | undefined {
+  if (!dateStr) return undefined;
+
+  // 将 "2026-04-20 12:09:14" 转换为 Date 对象
+  const date = new Date(dateStr.replace(' ', 'T'));
+
+  if (isNaN(date.getTime())) return undefined;
+
+  // 返回 ISO 8601 格式，带时区偏移
+  return date.toISOString();
+}
+
+/**
+ * 获取构建时间作为静态页面的 lastmod
+ * @returns ISO 8601 格式的构建时间
+ */
+function getBuildTime(): string {
+  // 使用当前时间作为构建时间
+  return new Date().toISOString();
+}
+
+/**
+ * 判断是否为静态页面（非动态内容页面）
+ * @param url - 页面 URL
+ * @returns 是否为静态页面
+ */
+function isStaticPage(url: string): boolean {
+  // 静态页面列表
+  const staticPages = [
+    '/',
+    '/about',
+    '/ask',
+    '/cookies',
+    '/copyright',
+    '/friend',
+    '/message',
+    '/moment',
+    '/privacy',
+    '/statistics',
+    '/categories',
+    '/tags',
+    '/archive',
+  ];
+  return staticPages.includes(url);
+}
+
+export default defineNitroPlugin(async nitroApp => {
+  nitroApp.hooks.hook('sitemap:resolved', async ctx => {
+    try {
+      const config = useRuntimeConfig();
+      const apiUrl = config.public.apiUrl;
+      const buildTime = getBuildTime();
+
+      // 从后端 API 获取文章列表
+      const articlesRes = await $fetch<ArticlesResponse>(`${apiUrl}/articles`).catch(() => null);
+
+      // 添加文章路由到 sitemap
+      const articles = articlesRes?.data?.list || [];
+      articles.forEach((article: SitemapArticle) => {
+        const sitemapUrl: SitemapUrl = {
+          loc: article.url,
+          lastmod: formatW3CDate(article.update_time || article.publish_time),
+          changefreq: 'weekly',
+          priority: 0.8,
+        };
+
+        // 如果有封面图，添加到图片 sitemap
+        if (article.cover) {
+          sitemapUrl.images = [
+            {
+              loc: article.cover,
+              caption: article.title,
+            },
+          ];
+        }
+
+        ctx.urls.push(sitemapUrl);
+      });
+
+      // 添加分类路由
+      const categoriesRes = await $fetch<CategoriesResponse>(`${apiUrl}/categories`).catch(
+        () => null
+      );
+      const categories = categoriesRes?.data?.list || [];
+      categories.forEach((category: SitemapCategory) => {
+        ctx.urls.push({
+          loc: category.url,
+          lastmod: buildTime,
+          changefreq: 'weekly',
+          priority: 0.6,
+        } as SitemapUrl);
+      });
+
+      // 添加标签路由
+      const tagsRes = await $fetch<TagsResponse>(`${apiUrl}/tags`).catch(() => null);
+      const tags = tagsRes?.data?.list || [];
+      tags.forEach((tag: SitemapTag) => {
+        ctx.urls.push({
+          loc: tag.url,
+          lastmod: buildTime,
+          changefreq: 'weekly',
+          priority: 0.5,
+        } as SitemapUrl);
+      });
+
+      // 为已存在的静态页面添加 lastmod（构建时间）
+      ctx.urls.forEach((url: SitemapUrl) => {
+        if (isStaticPage(url.loc) && !url.lastmod) {
+          url.lastmod = buildTime;
+        }
+      });
+    } catch {
+      // sitemap 生成失败不影响应用运行，静默忽略
+    }
+  });
+});

package/server/routes/atom.xml.ts

@@ -0,0 +1,21 @@
+export default defineEventHandler(async event => {
+  const config = useRuntimeConfig();
+  const backendUrl = config.public.apiUrl.replace(/\/+$/, '').replace(/\/api\/v\d+$/, '');
+
+  try {
+    const response = await fetch(`${backendUrl}/atom.xml`);
+
+    if (!response.ok) {
+      throw new Error(`Backend returned ${response.status}`);
+    }
+
+    const atomFeed = await response.text();
+    setResponseHeader(event, 'Content-Type', 'application/atom+xml; charset=utf-8');
+    return atomFeed;
+  } catch {
+    throw createError({
+      statusCode: 500,
+      statusMessage: 'Failed to fetch Atom feed',
+    });
+  }
+});

package/server/routes/manifest.json.ts

@@ -0,0 +1,45 @@
+export default defineEventHandler(async event => {
+  try {
+    const config = useRuntimeConfig();
+    const apiUrl = (config.public.apiUrl as string).replace(/\/+$/, '');
+    const res = await $fetch<{ code: number; data: Record<string, string> }>(
+      `${apiUrl}/settings/basic`
+    );
+    const cfg = res.code === 0 ? res.data : {};
+
+    const manifest = {
+      name: cfg.title || 'FlecBlog',
+      short_name: cfg.title?.substring(0, 12) || 'Flec',
+      description: cfg.description || '个人博客',
+      theme_color: '#f7f7f7',
+      background_color: '#ffffff',
+      display: 'standalone',
+      start_url: '/',
+      icons: [
+        {
+          src: cfg.favicon || '/favicon.ico',
+          sizes: '192x192',
+          type: 'image/png',
+        },
+        {
+          src: cfg.favicon || '/favicon.ico',
+          sizes: '512x512',
+          type: 'image/png',
+        },
+      ],
+    };
+
+    setHeader(event, 'Content-Type', 'application/manifest+json');
+    return manifest;
+  } catch {
+    return {
+      name: 'FlecBlog',
+      short_name: 'Flec',
+      theme_color: '#f7f7f7',
+      background_color: '#ffffff',
+      display: 'standalone',
+      start_url: '/',
+      icons: [{ src: '/favicon.ico', sizes: '192x192', type: 'image/png' }],
+    };
+  }
+});

package/server/routes/rss.xml.ts

@@ -0,0 +1,21 @@
+export default defineEventHandler(async event => {
+  const config = useRuntimeConfig();
+  const backendUrl = config.public.apiUrl.replace(/\/+$/, '').replace(/\/api\/v\d+$/, '');
+
+  try {
+    const response = await fetch(`${backendUrl}/rss.xml`);
+
+    if (!response.ok) {
+      throw new Error(`Backend returned ${response.status}`);
+    }
+
+    const rssFeed = await response.text();
+    setResponseHeader(event, 'Content-Type', 'application/rss+xml; charset=utf-8');
+    return rssFeed;
+  } catch {
+    throw createError({
+      statusCode: 500,
+      statusMessage: 'Failed to fetch RSS feed',
+    });
+  }
+});

package/types/article.ts

@@ -0,0 +1,48 @@
+export interface ArticleNav {
+  title: string;
+  url: string;
+}
+
+export interface Article {
+  id: number;
+  title: string;
+  slug?: string;
+  url: string;
+  content?: string;
+  summary: string;
+  ai_summary?: string;
+  excerpt?: string;
+  cover?: string;
+  is_top: boolean;
+  is_essence: boolean;
+  is_outdated?: boolean;
+  view_count?: number;
+  comment_count: number;
+  publish_time: string;
+  update_time: string;
+  location?: string;
+  category: {
+    id: number;
+    name: string;
+    url: string;
+  };
+  tags: Array<{
+    id: number;
+    name: string;
+    url: string;
+  }>;
+  prev?: ArticleNav;
+  next?: ArticleNav;
+}
+
+/**
+ * 文章查询参数（所有参数可选，支持灵活组合）
+ */
+export interface ArticleQuery {
+  page?: number; // 页码；不传返回全部数据
+  page_size?: number; // 每页数量；不传返回全部数据
+  year?: string; // 按年份筛选
+  month?: string; // 按月份筛选
+  category?: string; // 按分类筛选（slug）
+  tag?: string; // 按标签筛选（slug）
+}

package/types/auth.ts

@@ -0,0 +1,8 @@
+/** 微信扫码登录状态 */
+export interface WechatQRState {
+  visible: boolean;
+  imageUrl: string;
+  scene: string;
+  status: 'idle' | 'loading' | 'scanning' | 'confirmed' | 'expired' | 'error';
+  error: string;
+}

package/types/category.ts

@@ -0,0 +1,12 @@
+/**
+ * 分类类型定义
+ */
+export interface Category {
+  id: number;
+  name: string;
+  slug: string;
+  url: string;
+  description: string;
+  count: number;
+  sort: number;
+}

package/types/comment.ts

@@ -0,0 +1,72 @@
+import type { UserRole } from './user';
+
+/**
+ * 评论目标类型
+ */
+export type CommentTargetType = 'article' | 'page' | 'moment';
+
+/**
+ * 评论数据结构
+ */
+export interface Comment {
+  id: number;
+  content: string;
+  is_deleted: boolean;
+  is_pinned: boolean; // 是否置顶
+  parent_id: number | null;
+  created_at: string;
+  location?: string; // 地理位置
+  browser?: string; // 浏览器内核
+  os?: string; // 操作系统
+  user: {
+    role: UserRole;
+    badge?: string;
+    id: number;
+    email_hash: string;
+    nickname: string;
+    avatar: string;
+    website?: string;
+  };
+  reply_user?: {
+    role: UserRole;
+    badge?: string;
+    id: number;
+    email_hash: string;
+    nickname: string;
+    avatar: string;
+    website?: string;
+  };
+  replies: Comment[];
+}
+
+/**
+ * 创建评论参数
+ */
+export interface CreateCommentParams {
+  target_type: CommentTargetType;
+  target_key: string | number;
+  content: string;
+  parent_id?: number;
+
+  // 游客信息（可选，未登录时使用）
+  nickname?: string;
+  email?: string;
+  website?: string;
+}
+
+/**
+ * 扁平化评论（用于虚拟列表等场景）
+ */
+export interface FlatComment {
+  comment: Comment;
+  depth: number;
+}
+
+/**
+ * 游客信息（本地存储）
+ */
+export interface GuestInfo {
+  nickname: string;
+  email: string;
+  website?: string;
+}

package/types/emoji.ts

@@ -0,0 +1,10 @@
+export interface EmojiItem {
+  key: string;
+  val: string;
+}
+
+export interface EmojiGroup {
+  name: string;
+  type: 'emoji' | 'image' | 'emoticon';
+  items: EmojiItem[];
+}

package/types/feedback.ts

@@ -0,0 +1,31 @@
+// 反馈类型
+export type ReportType = 'copyright' | 'inappropriate' | 'summary' | 'suggestion';
+
+// 反馈状态
+export type FeedbackStatus = 'pending' | 'resolved' | 'closed';
+
+// 反馈对象
+export interface Feedback {
+  id: number;
+  ticket_no: string;
+  report_url: string;
+  report_type: ReportType;
+  form_content: Record<string, unknown>;
+  email: string;
+  status: FeedbackStatus;
+  admin_reply: string;
+  reply_time?: string;
+  user_agent: string;
+  ip: string;
+  feedback_time: string;
+}
+
+// 提交反馈参数
+export interface SubmitFeedbackParams {
+  reportUrl: string;
+  reportType: ReportType;
+  email?: string;
+  description: string;
+  reason?: string;
+  attachmentFiles?: string[];
+}

package/types/friend.ts

@@ -0,0 +1,63 @@
+/**
+ * 友链类型
+ */
+export interface FriendType {
+  id: number;
+  name: string;
+  is_visible: boolean;
+  sort: number;
+}
+
+/**
+ * 友链数据结构
+ */
+export interface Friend {
+  id: number;
+  name: string;
+  url: string;
+  description?: string;
+  avatar?: string;
+  screenshot?: string;
+  sort: number;
+  is_invalid: boolean;
+  type_id?: number;
+  type?: FriendType;
+}
+
+/**
+ * 友链分组（用于展示）
+ */
+export interface FriendGroup {
+  type_id: number | null;
+  type_name: string;
+  type_sort: number;
+  friends: Friend[];
+}
+
+/**
+ * 友链分组响应
+ */
+export interface FriendGroupedResponse {
+  groups: FriendGroup[];
+  total_groups: number;
+  total_friends: number;
+}
+
+/**
+ * 友链查询参数
+ */
+export interface FriendQueryParams {
+  page?: number;
+  page_size?: number;
+}
+
+/**
+ * 友链申请请求
+ */
+export interface FriendApplyRequest {
+  name: string; // 网站名称
+  url: string; // 网站链接
+  description: string; // 网站描述
+  avatar: string; // 网站头像/logo
+  screenshot?: string; // 网站截图（可选）
+}

package/types/markdown.ts

@@ -0,0 +1,7 @@
+/** 目录项 */
+export interface TocItem {
+  id: string;
+  level: number;
+  text: string;
+  children?: TocItem[];
+}

package/types/moment.ts

@@ -0,0 +1,85 @@
+/**
+ * 视频内容
+ */
+export interface MomentVideo {
+  url: string;
+  platform?: 'youtube' | 'bilibili' | 'local';
+  video_id?: string;
+}
+
+/**
+ * 音频内容
+ */
+export interface MomentAudio {
+  url: string;
+}
+
+/**
+ * 音乐内容
+ */
+export interface MomentMusic {
+  server: 'netease' | 'tencent';
+  type: 'song' | 'playlist' | 'album' | 'artist';
+  id: string;
+}
+
+/**
+ * 链接内容
+ */
+export interface MomentLink {
+  url: string;
+  title: string;
+  favicon?: string;
+}
+
+/**
+ * 动态内容
+ */
+export interface MomentContent {
+  text?: string;
+  images?: string[];
+  location?: string;
+  tags?: string;
+  video?: MomentVideo;
+  audio?: MomentAudio;
+  music?: MomentMusic;
+  link?: MomentLink;
+}
+
+/**
+ * 动态
+ */
+export interface Moment {
+  id: number;
+  content: MomentContent;
+  publish_time: string;
+}
+
+/**
+ * 音乐播放器曲目
+ */
+export interface MusicTrack {
+  name: string;
+  artist: string;
+  url: string;
+  cover: string;
+  lrc?: string;
+}
+
+/**
+ * 歌词行
+ */
+export interface LyricLine {
+  time: number;
+  text: string;
+}
+
+/**
+ * 动态列表响应
+ */
+export interface MomentListResponse {
+  list: Moment[];
+  total: number;
+  page: number;
+  page_size: number;
+}

package/types/notification.ts

@@ -0,0 +1,56 @@
+/**
+ * 通知类型枚举（前台用户）
+ */
+export type NotificationType = 'comment_reply'; // 评论回复
+
+/**
+ * 评论通知数据类型
+ */
+export interface CommentNotificationData {
+  article_title: string;
+  article_slug: string;
+  comment_id: number;
+  comment_content: string;
+  parent_comment_id?: number;
+}
+
+/**
+ * 通知对象（前台用户）
+ */
+export interface Notification {
+  id: number;
+  type: NotificationType;
+  type_text: string; // 类型中文文本（后端提供，前端直接显示）
+
+  // 前端显示字段（直接使用）
+  title: string;
+  content: string;
+  link: string;
+
+  // 详细数据（备用）
+  data: CommentNotificationData | Record<string, unknown>;
+  target_id?: number;
+  is_read: boolean;
+  read_at: string | null;
+  created_at: string;
+  sender: string | null;
+}
+
+/**
+ * 通知列表响应
+ */
+export interface NotificationListResponse {
+  list: Notification[];
+  total: number;
+  page: number;
+  page_size: number;
+  unread_count: number; // 未读数量
+}
+
+/**
+ * 获取通知列表参数
+ */
+export interface GetNotificationsParams {
+  page: number;
+  page_size: number;
+}

package/types/request.ts

@@ -0,0 +1,30 @@
+/**
+ * API响应数据结构
+ * @template T 响应数据类型
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- 泛型默认值，允许调用方不指定类型
+export interface ApiResponse<T = any> {
+  code: number;
+  message: string;
+  data: T;
+}
+
+/**
+ * 分页查询参数
+ */
+export interface PaginationQuery {
+  page?: number;
+  page_size?: number;
+}
+
+/**
+ * 分页响应数据结构
+ * @template T 列表项数据类型
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- 泛型默认值，允许调用方不指定类型
+export interface PaginationData<T = any> {
+  list: T[];
+  total: number;
+  page: number;
+  page_size: number;
+}