@flecblog/core-nuxt 0.1.0

package/types/stats.ts

@@ -0,0 +1,38 @@
+/**
+ * 网站统计信息
+ */
+export interface SiteStats {
+  total_words: string; // 本站总字数
+  total_visitors: number; // 本站访客数
+  total_page_views: number; // 本站总浏览量
+  online_users: number; // 当前在线人数
+  total_articles: number; // 已发布文章数
+  total_comments: number; // 公开可见评论数
+  total_friends: number; // 友链数
+  total_moments: number; // 动态数
+  total_categories: number; // 已发布文章分类数
+  total_tags: number; // 已发布文章标签数
+
+  // 详细访问统计
+  today_visitors: number; // 今日访客数（UV）
+  today_pageviews: number; // 今日访问量（PV）
+  yesterday_visitors: number; // 昨日访客数（UV）
+  yesterday_pageviews: number; // 昨日访问量（PV）
+  month_pageviews: number; // 本月访问量（PV）
+}
+
+/**
+ * 归档统计项
+ */
+export interface ArchiveItem {
+  year: string;
+  month: string;
+  count: number;
+}
+
+/**
+ * 归档统计数据
+ */
+export interface ArchiveStats {
+  archives: ArchiveItem[];
+}

package/types/sysconfig.ts

@@ -0,0 +1,2 @@
+// 配置分组类型
+export type SettingGroupType = 'basic' | 'ai' | 'oauth' | 'upload';

package/types/tag.ts

@@ -0,0 +1,11 @@
+/**
+ * 标签类型定义
+ */
+export interface Tag {
+  id: number;
+  name: string;
+  slug: string;
+  url: string;
+  description: string;
+  count: number;
+}

package/types/theme.ts

@@ -0,0 +1,26 @@
+/** 菜单项接口 */
+export interface Menu {
+  id: number;
+  title: string;
+  url: string;
+  icon: string;
+  sort: number;
+  is_enabled: boolean;
+  children?: Menu[];
+}
+
+export interface ThemeSchemaResponse {
+  slug: string;
+  name: string;
+  schema: Record<string, unknown>;
+  config: Record<string, unknown>;
+  menus: Record<string, Menu[]>;
+}
+
+export interface ThemeState {
+  slug: string;
+  name: string;
+  schema: Record<string, unknown>;
+  config: Record<string, unknown>;
+  loaded: boolean;
+}

package/types/upload.ts

@@ -0,0 +1,5 @@
+/** 文件上传响应 */
+export interface UploadResponse {
+  original_name: string;
+  file_url: string;
+}

package/types/user.ts

@@ -0,0 +1,106 @@
+/**
+ * 用户角色枚举
+ */
+export type UserRole = 'super_admin' | 'admin' | 'user';
+
+/**
+ * 用户基本信息
+ */
+export interface UserInfo {
+  id: number;
+  email: string;
+  email_hash: string;
+  is_virtual_email: boolean; // 是否为虚拟邮箱（需绑定真实邮箱）
+  avatar?: string;
+  badge?: string;
+  nickname: string;
+  website?: string;
+  last_login?: string;
+  created_at: string;
+  role: UserRole;
+  has_password: boolean;
+  linked_oauths: string[];
+}
+
+/**
+ * 用户资料更新参数（所有字段均为可选）
+ */
+export interface UpdateProfileParams {
+  nickname?: string;
+  email?: string;
+  avatar?: string;
+  badge?: string;
+  website?: string;
+}
+
+/**
+ * 登录请求参数
+ */
+export interface LoginParams {
+  email: string;
+  password: string;
+}
+
+/**
+ * 登录响应数据
+ */
+export interface LoginResponse {
+  access_token: string;
+  user: UserInfo;
+}
+
+/**
+ * 注册请求参数
+ */
+export interface RegisterParams {
+  email: string;
+  nickname: string;
+  password: string;
+  website?: string;
+}
+
+/**
+ * 注册响应数据
+ */
+export interface RegisterResponse {
+  access_token: string;
+  user: UserInfo;
+}
+
+/**
+ * 忘记密码请求参数
+ */
+export interface ForgotPasswordParams {
+  email: string;
+}
+
+/**
+ * 重置密码请求参数
+ */
+export interface ResetPasswordParams {
+  email: string;
+  code: string;
+  password: string;
+}
+
+/**
+ * 修改密码请求参数
+ */
+export interface ChangePasswordParams {
+  old_password: string;
+  new_password: string;
+}
+
+/**
+ * 注销账户请求参数
+ */
+export interface DeactivateAccountParams {
+  password: string;
+}
+
+/**
+ * 刷新Token响应数据
+ */
+export interface RefreshTokenResponse {
+  access_token: string;
+}

package/utils/avatar.ts

@@ -0,0 +1,21 @@
+import { useSysConfig } from '@/composables/useStores';
+
+const DEFAULT_CRAVATAR_URL = 'https://cravatar.cn/avatar/%s?s=200&d=robohash';
+
+export function getAvatarUrl(user: { avatar?: string; email_hash?: string }, size = 48): string {
+  if (user.avatar) return user.avatar;
+  if (!user.email_hash) {
+    return `data:image/svg+xml,%3Csvg width='${size}' height='${size}' viewBox='0 0 48 48' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Ccircle cx='24' cy='24' r='24' fill='%23E5E7EB'/%3E%3Cpath d='M24 12C17.3726 12 12 17.3726 12 24C12 30.6274 17.3726 36 24 36C30.6274 36 36 30.6274 36 24C36 17.3726 30.6274 12 24 12Z' fill='%239CA3AF'/%3E%3Ccircle cx='24' cy='24' r='8' fill='%236B7280'/%3E%3C/svg%3E`;
+  }
+  let cravatarUrl = DEFAULT_CRAVATAR_URL;
+  try {
+    const { basicConfig } = useSysConfig();
+    if (basicConfig.value.cravatar_url) {
+      cravatarUrl = basicConfig.value.cravatar_url;
+    }
+  } catch {
+    // useSysConfig 可能在非 Nuxt 上下文中调用，使用默认值
+  }
+  const url = cravatarUrl.replace('%s', user.email_hash);
+  return url.replace(/s=\d+/, `s=${size}`);
+}

package/utils/date.ts

@@ -0,0 +1,136 @@
+import dayjs from 'dayjs';
+import 'dayjs/locale/zh-cn';
+import relativeTime from 'dayjs/plugin/relativeTime';
+import customParseFormat from 'dayjs/plugin/customParseFormat';
+
+// 配置 dayjs
+dayjs.locale('zh-cn');
+dayjs.extend(relativeTime);
+dayjs.extend(customParseFormat);
+
+// 后端统一格式
+export const BACKEND_DATE_FORMAT = 'YYYY-MM-DD HH:mm:ss';
+
+/**
+ * 格式化日期为完整的日期时间
+ * @param date 日期字符串或 Date 对象
+ * @returns 格式化后的字符串，如 "2025-10-03 13:46:59"
+ */
+export function formatDateTime(date: string | Date | null | undefined): string {
+  if (!date) return '-';
+  return dayjs(date).format(BACKEND_DATE_FORMAT);
+}
+
+/**
+ * 格式化日期为日期（不含时间）
+ * @param date 日期字符串或 Date 对象
+ * @returns 格式化后的字符串，如 "2025-10-03"
+ */
+export function formatDate(date: string | Date | null | undefined): string {
+  if (!date) return '-';
+  return dayjs(date).format('YYYY-MM-DD');
+}
+
+/**
+ * 格式化为相对时间（如：2小时前）
+ * @param date 日期字符串或 Date 对象
+ * @returns 相对时间字符串
+ */
+export function formatRelativeTime(date: string | Date | null | undefined): string {
+  if (!date) return '-';
+  return dayjs(date).fromNow();
+}
+
+/**
+ * 解析后端日期格式为 Date 对象
+ * @param dateString 后端返回的日期字符串
+ * @returns Date 对象或 null
+ */
+export function parseBackendDate(dateString: string | null | undefined): Date | null {
+  if (!dateString?.trim()) return null;
+  const parsed = dayjs(dateString, BACKEND_DATE_FORMAT, true);
+  return parsed.isValid() ? parsed.toDate() : null;
+}
+
+/**
+ * 将 Date 对象格式化为后端需要的格式
+ * @param date Date 对象
+ * @returns 后端格式的日期字符串
+ */
+export function formatForBackend(date: Date | null | undefined): string {
+  if (!date) return '';
+  return dayjs(date).format(BACKEND_DATE_FORMAT);
+}
+
+/**
+ * 判断日期是否有效
+ * @param date 日期字符串或 Date 对象
+ * @returns 是否有效
+ */
+export function isValidDate(date: string | Date | null | undefined): boolean {
+  return date ? dayjs(date).isValid() : false;
+}
+
+/**
+ * 格式化为友好的显示格式
+ * @param date 日期字符串或 Date 对象
+ * @returns 友好的日期字符串，如 "2025年10月3日"
+ */
+export function formatFriendly(date: string | Date | null | undefined): string {
+  if (!date) return '-';
+
+  const target = dayjs(date);
+
+  // 始终显示完整的年月日
+  return target.format('YYYY年M月D日');
+}
+
+/**
+ * 格式化为动态友好时间
+ * @param date 日期字符串或 Date 对象
+ * @returns 友好时间字符串：n小时前（24小时内）、n天前（3天内）、几月几日（本年）、几年几月几日（非本年）
+ */
+export function formatMomentTime(date: string | Date | null | undefined): string {
+  if (!date) return '-';
+
+  const now = dayjs();
+  const target = dayjs(date);
+  const diffHours = now.diff(target, 'hour');
+  const diffDays = now.diff(target, 'day');
+
+  // 24小时内显示小时
+  if (diffHours < 24) {
+    if (diffHours < 1) {
+      const diffMinutes = now.diff(target, 'minute');
+      return diffMinutes < 1 ? '刚刚' : `${diffMinutes}分钟前`;
+    }
+    return `${diffHours}小时前`;
+  }
+
+  // 3天内显示天数
+  if (diffDays < 3) {
+    return `${diffDays}天前`;
+  }
+
+  // 今年的日期显示月日
+  if (now.year() === target.year()) {
+    return target.format('M月D日');
+  }
+
+  // 其他年份显示年月日
+  return target.format('YYYY年M月D日');
+}
+
+/** 计算从指定日期到今天的运行天数 */
+export function calcRunningDays(dateStr: string): number {
+  const startDate = new Date(dateStr).getTime();
+  return Math.floor((Date.now() - startDate) / 86400000);
+}
+
+/** 将秒数格式化为 mm:ss */
+export function formatDuration(seconds: number): string {
+  if (!isFinite(seconds) || isNaN(seconds)) return '00:00';
+  const mins = Math.floor(seconds / 60);
+  const secs = Math.floor(seconds % 60);
+  return `${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+}

package/utils/download.ts

@@ -0,0 +1,11 @@
+/** 通过 fetch 下载远程文件并触发浏览器保存 */
+export async function downloadFile(url: string, filename?: string): Promise<void> {
+  const blob = await fetch(url).then(r => r.blob());
+  const name = filename || url.split('/').pop() || 'download';
+  const a = Object.assign(document.createElement('a'), {
+    href: URL.createObjectURL(blob),
+    download: name,
+  });
+  a.click();
+  URL.revokeObjectURL(a.href);
+}

package/utils/emoji.ts

@@ -0,0 +1,90 @@
+import type { EmojiGroup } from '@@/types/emoji';
+
+let emojiMapCache: Map<string, string> | null = null;
+let emojiLoadPromise: Promise<Map<string, string>> | null = null;
+let emojiGroupsCache: EmojiGroup[] | null = null;
+let emojiGroupsLoadPromise: Promise<EmojiGroup[]> | null = null;
+
+export async function loadEmojiMap(emojisUrl: string): Promise<Map<string, string>> {
+  if (emojiMapCache) {
+    return emojiMapCache;
+  }
+
+  if (emojiLoadPromise) {
+    return emojiLoadPromise;
+  }
+
+  emojiLoadPromise = (async () => {
+    try {
+      const response = await fetch(emojisUrl);
+      if (!response.ok) throw new Error('加载表情包失败');
+
+      const data: EmojiGroup[] = await response.json();
+      const map = new Map<string, string>();
+
+      for (const group of data) {
+        if (group.type === 'image') {
+          for (const item of group.items) {
+            map.set(item.key, item.val);
+          }
+        }
+      }
+
+      emojiMapCache = map;
+      return map;
+    } catch (error) {
+      console.error('加载表情映射失败:', error);
+      emojiLoadPromise = null;
+      return new Map();
+    }
+  })();
+
+  return emojiLoadPromise;
+}
+
+export function getEmojiMapSync(): Map<string, string> | null {
+  return emojiMapCache;
+}
+
+export function clearEmojiCache(): void {
+  emojiMapCache = null;
+  emojiLoadPromise = null;
+  emojiGroupsCache = null;
+  emojiGroupsLoadPromise = null;
+}
+
+// 加载完整表情分组（供 EmojiPicker 使用）
+export async function loadAllEmojiGroups(emojisUrl: string): Promise<EmojiGroup[]> {
+  if (emojiGroupsCache) return emojiGroupsCache;
+  if (emojiGroupsLoadPromise) return emojiGroupsLoadPromise;
+
+  emojiGroupsLoadPromise = (async () => {
+    try {
+      const response = await fetch(emojisUrl);
+      if (!response.ok) throw new Error('加载表情包失败');
+      const groups: EmojiGroup[] = await response.json();
+      emojiGroupsCache = groups;
+      return groups;
+    } catch (error) {
+      console.error('加载表情分组失败:', error);
+      emojiGroupsLoadPromise = null;
+      return [];
+    }
+  })();
+
+  return emojiGroupsLoadPromise;
+}
+
+export function getAllEmojiGroupsSync(): EmojiGroup[] | null {
+  return emojiGroupsCache;
+}
+
+export function replaceEmojisInText(text: string, emojiMap: Map<string, string>): string {
+  return text.replace(/:([^:\s]+):/g, (match, key) => {
+    const url = emojiMap.get(key);
+    if (url) {
+      return `<img src="${url}" alt="${key}" class="emoji-image" title="${key}" />`;
+    }
+    return match;
+  });
+}

package/utils/format.ts

@@ -0,0 +1,42 @@
+/** 数字缩写：≥1万显示 w，≥1千显示 k */
+export function formatWords(words: string): string {
+  const n = +words;
+  if (n >= 1e4) return (n / 1e4).toFixed(1) + 'w';
+  if (n >= 1e3) return (n / 1e3).toFixed(1) + 'k';
+  return words;
+}
+
+const ROLE_NAMES: Record<string, string> = {
+  super_admin: '超级管理员',
+  admin: '管理员',
+  user: '普通用户',
+};
+
+/** 用户角色显示名称 */
+export function getRoleName(role: string): string {
+  return ROLE_NAMES[role] || role;
+}
+
+const PROVIDER_NAMES: Record<string, string> = {
+  github: 'GitHub',
+  google: 'Google',
+  qq: 'QQ',
+  microsoft: 'Microsoft',
+  oidc: 'OIDC',
+};
+
+/** OAuth 提供商显示名称 */
+export function getProviderName(provider: string): string {
+  return PROVIDER_NAMES[provider] || provider;
+}
+
+const STATUS_LABELS: Record<string, string> = {
+  pending: '待处理',
+  resolved: '已解决',
+  closed: '已关闭',
+};
+
+/** 反馈状态显示标签 */
+export function getStatusLabel(status: string): string {
+  return STATUS_LABELS[status] || status;
+}