mirror of
https://github.com/ialley-workshop-open/uni-halo.git
synced 2026-09-12 16:40:40 +08:00
feat: 新增收藏功能与多项体验优化
- 新增本地收藏store与工具函数,支持文章/瞬间收藏持久化 - 重构插件可用性检查hook,统一管理依赖插件状态 - 替换旧数据加载hook为新的状态管理方案 - 优化首页布局与加载逻辑,调整公告组件样式 - 为瞬间详情页添加点赞、评论与收藏功能 - 新增文本处理工具,支持HTML/Markdown转纯文本与摘要截断 - 修复评论弹窗适配瞬间类型的参数问题
This commit is contained in:
@@ -0,0 +1,104 @@
|
||||
/**
|
||||
* 收藏快照:把文章(IPost)/瞬间(IMoment)组装为统一收藏项 IFavoriteItem
|
||||
* 纯函数层,快照自包含(纯文本摘要截断),供 store 与三处收藏按钮共用
|
||||
*/
|
||||
import type { IMoment, IPost } from '@/api/types/halo'
|
||||
import { checkAvatarUrl, checkImageUrl } from '@/utils/url'
|
||||
import { extractPlainExcerpt } from '@/utils/text'
|
||||
|
||||
/** 收藏内容类型 */
|
||||
export type FavoriteKind = 'post' | 'moment'
|
||||
|
||||
/** 收藏项作者快照 */
|
||||
export interface IFavoriteOwner {
|
||||
/** post: owner.metadata.name;moment: owner.name */
|
||||
id?: string
|
||||
displayName: string
|
||||
avatar: string
|
||||
}
|
||||
|
||||
/** 统一收藏项(文章/瞬间,纯本地) */
|
||||
export interface IFavoriteItem {
|
||||
kind: FavoriteKind
|
||||
/** 详情 id(metadata.name) */
|
||||
id: string
|
||||
/** 封面(仅文章) */
|
||||
cover?: string
|
||||
/** 标题(仅文章) */
|
||||
title?: string
|
||||
/** 纯文本摘要:文章 excerpt/正文抽 120 字;瞬间正文抽 200 字 */
|
||||
content: string
|
||||
/** 收藏时刻(ISO 字符串) */
|
||||
createTime: string
|
||||
owner: IFavoriteOwner
|
||||
}
|
||||
|
||||
/** 文章正文/摘要截断字数 */
|
||||
const POST_EXCERPT_MAX = 120
|
||||
/** 瞬间正文截断字数 */
|
||||
const MOMENT_EXCERPT_MAX = 200
|
||||
|
||||
/** 取文章摘要文本(excerpt 优先,兜底从正文抽取) */
|
||||
function getPostExcerptText(post: IPost): string {
|
||||
return extractPlainExcerpt(post.spec.excerpt || post.content?.content || post.content?.raw, POST_EXCERPT_MAX)
|
||||
}
|
||||
|
||||
/** 文章 → 收藏快照 */
|
||||
export function buildPostFavoriteItem(post: IPost, now: Date = new Date()): IFavoriteItem {
|
||||
const owner = post.owner
|
||||
const cover = post.spec.cover ? checkImageUrl(post.spec.cover) : undefined
|
||||
return {
|
||||
kind: 'post',
|
||||
id: post.metadata.name,
|
||||
cover,
|
||||
title: post.spec.title,
|
||||
content: getPostExcerptText(post),
|
||||
createTime: now.toISOString(),
|
||||
owner: {
|
||||
id: owner.metadata?.name,
|
||||
displayName: owner.displayName || '',
|
||||
avatar: checkAvatarUrl(owner.avatar),
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
/** 瞬间 → 收藏快照(无封面/标题) */
|
||||
export function buildMomentFavoriteItem(moment: IMoment, now: Date = new Date()): IFavoriteItem {
|
||||
const owner = moment.owner
|
||||
// moment.owner 含 index signature,metadata 需显式收窄
|
||||
const ownerMeta = owner?.metadata as { name?: string } | undefined
|
||||
return {
|
||||
kind: 'moment',
|
||||
id: moment.metadata.name,
|
||||
content: extractPlainExcerpt(moment.spec.content?.html || moment.spec.content?.raw, MOMENT_EXCERPT_MAX),
|
||||
createTime: now.toISOString(),
|
||||
owner: {
|
||||
id: owner?.name || ownerMeta?.name,
|
||||
displayName: owner?.displayName || '',
|
||||
avatar: checkAvatarUrl(owner?.avatar),
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
/** 收藏唯一键(kind 与 id 拼接,两域 metadata.name 可能撞名) */
|
||||
export function favoriteKey(kind: FavoriteKind, id: string): string {
|
||||
return `${kind}:${id}`
|
||||
}
|
||||
|
||||
/**
|
||||
* 持久化读回数据为真边界数据,入库/展示前校验结构
|
||||
* 仅校验关键字段,非法项直接丢弃
|
||||
*/
|
||||
export function isValidFavoriteItem(item: unknown): item is IFavoriteItem {
|
||||
if (!item || typeof item !== 'object')
|
||||
return false
|
||||
const target = item as Partial<IFavoriteItem>
|
||||
const kindOk = target.kind === 'post' || target.kind === 'moment'
|
||||
const idOk = typeof target.id === 'string' && target.id !== ''
|
||||
const contentOk = typeof target.content === 'string'
|
||||
const createTimeOk = typeof target.createTime === 'string'
|
||||
const ownerOk = !!target.owner
|
||||
&& typeof target.owner === 'object'
|
||||
&& typeof (target.owner as IFavoriteOwner).displayName === 'string'
|
||||
return kindOk && idOk && contentOk && createTimeOk && ownerOk
|
||||
}
|
||||
Reference in New Issue
Block a user