feat: 新增收藏功能与多项体验优化

- 新增本地收藏store与工具函数，支持文章/瞬间收藏持久化 - 重构插件可用性检查hook，统一管理依赖插件状态 - 替换旧数据加载hook为新的状态管理方案 - 优化首页布局与加载逻辑，调整公告组件样式 - 为瞬间详情页添加点赞、评论与收藏功能 - 新增文本处理工具，支持HTML/Markdown转纯文本与摘要截断 - 修复评论弹窗适配瞬间类型的参数问题
2026-09-12 16:40:40 +08:00 · 2026-09-04 17:17:18 +08:00
parent 629b1f9219
commit 62b604644c
28 changed files with 1548 additions and 1387 deletions
@@ -0,0 +1,164 @@
+/**
+ * 插件清单与可用性 hook
+ * 源自旧项目 utils/plugin.js(TS 化)与 utils/plugin.ts,整体迁移至 hooks 目录。
+ * 提供:
+ * - 依赖插件 ID 常量(NeedPluginIds)与插件清单(NeedPlugins)
+ * - 底层可用性检查(checkNeedPluginAvailable)
+ * - 响应式 hook(usePluginAvailable):available 状态 + check 校验函数,页面免 import 直接调用
+ *   (auto-import 已配置 src/hooks,无需手写 import)
+ *
+ * @example
+ * const { available, check } = usePluginAvailable('plugin-vote')
+ * onLoad(async () => {
+ *   await check()
+ *   if (!available.value) return
+ *   handleGetData()
+ * })
+ */
+import { ref } from 'vue'
+import { checkPluginAvailable } from '@/api/halo'
+import { checkUrl } from '@/utils/url'
+
+/** 依赖插件 ID 常量 */
+export const NeedPluginIds = Object.freeze({
+  PluginUniHalo: 'plugin-uni-halo',
+  PluginPhotos: 'PluginPhotos',
+  PluginLinks: 'PluginLinks',
+  PluginMoments: 'PluginMoments',
+  PluginSearchWidget: 'PluginSearchWidget',
+  PluginCommentWidget: 'PluginCommentWidget',
+  PluginVote: 'vote',
+  PluginDataStatistics: 'data-statistics',
+})
+
+export interface IPluginInfo {
+  id: string
+  name: string
+  desc: string
+  logo: string
+  url: string
+}
+
+/** 依赖插件清单 */
+export const NeedPlugins = new Map<string, IPluginInfo>([
+  [
+    NeedPluginIds.PluginUniHalo,
+    {
+      id: 'plugin-uni-halo',
+      name: 'UniHalo配置',
+      desc: 'uni-halo 核心插件，未安装和启用的情况下，将无法使用 uni-halo，请检查是否已安装和启用',
+      logo: checkUrl('/plugins/plugin-uni-halo/assets/logo.png'),
+      url: 'https://www.halo.run/store/apps/app-ryemX',
+    },
+  ],
+  [
+    NeedPluginIds.PluginPhotos,
+    {
+      id: 'PluginPhotos',
+      name: '图库管理',
+      desc: '图库功能模块所需要的插件',
+      logo: checkUrl('/plugins/PluginPhotos/assets/logo.svg'),
+      url: 'https://www.halo.run/store/apps/app-BmQJW',
+    },
+  ],
+  [
+    NeedPluginIds.PluginLinks,
+    {
+      id: 'PluginLinks',
+      name: '链接管理',
+      desc: '链接管理模块，用于网站友情链接功能模块',
+      logo: checkUrl('/plugins/PluginLinks/assets/logo.svg'),
+      url: 'https://www.halo.run/store/apps/app-hfbQg',
+    },
+  ],
+  [
+    NeedPluginIds.PluginMoments,
+    {
+      id: 'PluginMoments',
+      name: '瞬间',
+      desc: '提供一个轻量级的内容图文、视频、音频等内容展示',
+      logo: checkUrl('/plugins/PluginMoments/assets/logo.svg'),
+      url: 'https://www.halo.run/store/apps/app-SnwWD',
+    },
+  ],
+  [
+    NeedPluginIds.PluginSearchWidget,
+    {
+      id: 'PluginSearchWidget',
+      name: '搜索组件',
+      desc: '为应用提供统一的搜索组件',
+      logo: checkUrl('/plugins/PluginSearchWidget/assets/logo.svg'),
+      url: 'https://www.halo.run/store/apps/app-DlacW',
+    },
+  ],
+  [
+    NeedPluginIds.PluginCommentWidget,
+    {
+      id: 'PluginCommentWidget',
+      name: '评论组件',
+      desc: '为用户前台提供完整的评论解决方案',
+      logo: checkUrl('/plugins/PluginCommentWidget/assets/logo.svg'),
+      url: 'https://www.halo.run/store/apps/app-YXyaD',
+    },
+  ],
+  [
+    NeedPluginIds.PluginVote,
+    {
+      id: 'vote',
+      name: '投票管理',
+      desc: '投票模块所需要的插件，用于展示投票和提交投票',
+      logo: checkUrl('/plugins/vote/assets/logo.png'),
+      url: 'https://www.halo.run/store/apps/app-veyvzyhv',
+    },
+  ],
+  [
+    NeedPluginIds.PluginDataStatistics,
+    {
+      id: 'data-statistics',
+      name: '数据看板',
+      desc: '为 Halo2 提供强大的数据可视化统计功能，支持 Umami 流量统计、uptime、网站内部数据图表（标签、分类、文章趋势、评论排行、热门文章等）',
+      logo: checkUrl('/plugins/data-statistics/assets/logo.svg'),
+      url: 'https://www.halo.run/store/apps/app-rtnbbgfk',
+    },
+  ],
+])
+
+/**
+ * 检查插件是否启用、安装
+ * @param pluginId 插件 id
+ * @returns true = 安装、启用;false = 未安装启用
+ */
+export async function checkNeedPluginAvailable(pluginId: string): Promise<boolean> {
+  try {
+    const available = await checkPluginAvailable(pluginId)
+    return available?.data?.available !== false
+  }
+  catch (err) {
+    console.error(`检查插件 ${pluginId} 可用性失败`, err)
+    return false
+  }
+}
+
+export function usePluginAvailable(pluginId: string, initial = true) {
+  /** 插件是否可用(默认 true,避免首帧闪现插件不可用占位;需要先置 false 的页面传 initial=false) */
+  const available = ref(initial)
+  /** 是否校验中 */
+  const checking = ref(false)
+
+  /**
+   * 执行插件可用性校验(刷新 available)
+   * @returns 当前是否可用(与 available.value 一致,便于一次性调用方直接取返回值)
+   */
+  async function check(): Promise<boolean> {
+    checking.value = true
+    try {
+      available.value = await checkNeedPluginAvailable(pluginId)
+      return available.value
+    }
+    finally {
+      checking.value = false
+    }
+  }
+
+  return { available, checking, check }
+}