@funhub/platform 0.2.29 → 0.2.31

package/dist/components/biz/business/detail/video-detail-recommend/shared.mjs

@@ -1,2 +1,549 @@
 
-"use client";import{formatCompactCount as e}from"../../../../../utils/common.mjs";import{gContentGetGuessYouLikeVideos as t,pContentBatchGetVideoDetail as n}from"../../../../../service/generated/client.mjs";import{useRequest as r}from"../../../../../hooks/query/use-query.mjs";import{useKeepAliveState as i}from"../../../../common/keep-scroll-position/index.mjs";import{normalizeRecommendBadgeUrl as a}from"../../../../common/list/waterfall-recommend/recommend-badge-style.mjs";import{useCardDecoration as o}from"../../../../../hooks/use-card-decoration.mjs";import{buildEditorPreviewRecommendList as s}from"../shared/editor-preview.mjs";import{useVideoDetailMaterialRuntimeContext as ee}from"../shared/runtime-context-provider.mjs";import{applyPlayCountDelta as c,clampColumns as l,limitRecommendDisplayList as te,mergeManualAndPool as ne,normalizeRecommendRuntimeProps as re,resolveRows as ie}from"./utils.mjs";import{useCallback as ae,useEffect as u,useMemo as d,useState as oe}from"react";function f({rows:f,columns:p,smartTagEnabled:m,smartTagIds:h,title:ge,showPlayCount:v,playCountDelta:y,showEpisode:_e,enableInfinite:ve,items:ye,mode:b=`renderer`}){let x=ee()?.detailId||``,be=b===`editor`,S=be,{getVerticalHoCoverImageUrl:C,getTitleText:w}=o(),T=d(()=>re({smartTagEnabled:m,smartTagIds:h,enableInfinite:ve,items:ye}),[ve,ye,m,h]),E=T.smartTagEnabled,D=T.smartTagIds,O=d(()=>T.items??[],[T.items]),k=T.enableInfinite&&!be,A=!E,j=k&&E&&!S,xe=ie(f,k),M=l(p),N=xe*M,P=Math.max(1,N),F=d(()=>[`video-detail-recommend`,x||`unknown`,P,D.join(`,`)].join(`:`),[x,P,D]),[Se,I]=i(`${F}:pool`,[]),[L,R]=i(`${F}:cursor`,void 0),[z,B]=i(`${F}:has-more`,!1),[V,H]=oe(!1),U=d(()=>s(N),[N]),{data:W,isFetching:Ce,isPending:we}=r([`video-detail-recommend`,x,j?`paged`:`all`,P,D.join(`,`)],async()=>S?null:await t({cursor:L,page_size:P,tags:D}),{enabled:!S&&E,refetchOnMount:`always`}),G=d(()=>S?U:se(W?.data?.videos),[W?.data?.videos,U,S]);u(()=>{if(!j){H(!1),R(void 0);return}I(e=>{if(!G.length)return e;if(!e.length)return G;let t=[...G],n=new Set(G.map(e=>e.id).filter(Boolean));return e.forEach(e=>{(!e.id||!n.has(e.id))&&(t.push(e),e.id&&n.add(e.id))}),t});let e=ue(W?.data);R(e);let t=e?!0:le(W?.data?.videos,P);B(e=>e||t),H(!1)},[W?.data,G,P,B,R,I,j]);let K=j?Se:G,q=d(()=>A?Array.from(new Set(O.map(e=>g(e.contentId)).filter(Boolean))):[],[O,A]),{data:Te,isFetching:Ee,isPending:De}=r([`video-detail-recommend-manual-details`,q.join(`,`)],async()=>{if(!q.length)return[];let e=await n({ids:q});return(Array.isArray(e.data?.videos)?e.data.videos:[]).map(e=>ce(e))},{enabled:q.length>0,refetchOnMount:`always`}),Oe=d(()=>A?new Set(O.map(e=>g(e.contentId)).filter(Boolean)):new Set,[O,A]),ke=d(()=>S?K:K.filter(e=>!Oe.has(e.id)),[K,S,Oe]),J=d(()=>{if(!A||!O.length)return[];let e=new Map;return K.forEach(t=>{let n=g(t.id);n&&e.set(n,t)}),(Te||[]).forEach(t=>{let n=g(t.id);n&&e.set(n,t)}),O.map((t,n)=>{let r=S?U[n%Math.max(1,U.length)]:pe(t,n),i=g(t.contentId),o=typeof t.coverUrl==`string`?t.coverUrl.trim():``,s=e.get(i)??{...r,id:i||r.id||`preview-manual-${n+1}`,name:r.name||`猜你喜欢 ${n+1}`,img_y:o||r.img_y,img_x:o||r.img_x},ee=t.titleMode===`custom`?t.title:w(s),c=t.coverMode===`content`?C(s)||o:o||C(s),l=a(t.badge_url);return{info:{...s,name:ee||s.name,img_y:c||s.img_y,img_x:c||s.img_x,badge_url:l||_(s)},config:{showPlayCount:t.showPlayCount,playCountDelta:t.playCountDelta,showEpisode:t.showEpisode}}}).filter(Boolean)},[U,K,w,C,S,Te,O,A]),Y=d(()=>ke.map(e=>({info:e})),[ke]),Ae=A&&O.length>0,je=d(()=>Ae?J:ne(J,Y,N),[Ae,J,N,Y]),Me=d(()=>{if(j||k){if(!J.length)return Y;let e=new Set(J.map(e=>e.info.id).filter(Boolean));return J.concat(Y.filter(t=>!e.has(t.info.id)))}return je},[je,J,Y,k,j]),X=d(()=>te(Me,N,k),[N,Me,k]),Z=z&&X.length>0?Math.max(0,X.length-4):-1,Q=Z>=0?`${F}:${Z}`:``,Ne=String(ge||``).trim(),$=ae(async()=>{if(!(!j||!z||V)){H(!0);try{let e=await t({cursor:L,page_size:P,tags:D}),n=Array.isArray(e.data?.videos)?e.data.videos:[],r=ue(e.data),i=se(n),a=0;I(e=>{let t=new Set(e.map(e=>e.id).filter(Boolean)),n=[...e];return i.forEach(e=>{(!e.id||!t.has(e.id))&&(n.push(e),e.id&&t.add(e.id))}),a=n.length-e.length,n}),R(r),B((r?!0:le(n,P))&&a>0)}catch(e){console.error(`猜你喜欢分页加载失败`,e),B(!1)}finally{H(!1)}}},[z,V,L,P,D,B,R,I,j]);u(()=>{if(!Q||!z||V||!j)return;let e=document.querySelector(`[data-detail-recommend-trigger="${Q}"]`);if(!(e instanceof HTMLElement))return;let t=new IntersectionObserver(e=>{e[0]?.isIntersecting&&!V&&$()});return t.observe(e),()=>{t.disconnect()}},[$,z,V,j,Q]);let Pe=!S&&(V||E&&(Ce||we)||q.length>0&&(Ee||De));return{uiItems:d(()=>X.map((t,n)=>{let r=v!==!1&&(t.config?.showPlayCount??!0),i=Number(t.config?.playCountDelta??y??0),a=t.config?.showEpisode??_e;return{sourceIndex:n,info:t.info,title:w(t.info),coverUrl:C(t.info),badgeImageUrl:_(t.info),detailPath:b===`renderer`?fe(t.info):``,playCountText:e(c(t.info.play_count||0,i)),videoInfoText:de(t.info),showPlayCount:r,showEpisode:a,score:me(t.info.score),cardKind:he(t.info)}}),[X,w,C,b,y,_e,v]),shouldShowLoading:Pe,isPreview:S,resolvedColumns:M,resolvedModuleTitle:Ne,triggerIndex:Z,triggerMarker:Q}}function p(e){let t=e.is_more_link?`y`:`n`;return{id:e.video_id||``,mid:``,name:e.name||``,cat_id:``,cat_name:``,status:`1`,status_text:``,create_time:``,content_type:e.content_type,episode_cnt:e.episode_count||0,show_at:e.show_at??``,position:``,img_type:e.img_type??``,img_x:e.img_x??``,img_y:e.img_y??``,img_width:``,img_height:``,play_count:e.play_count,preview_images:[],duration:String(e.duration??``),score:String(e.score??``),is_more_link:t,update_status:String(e.update_status??``),description:e.description??``,language:``,director:``,actor:``,area:``,issue_date:``,publisher:``,series:``,number:``,tags:[],source_tags:e.source_tags??``,source_actor:[],links:Array.isArray(e.episodes)?e.episodes.map(e=>({id:e.id??``,name:e.name??``,preview_m3u8_url:e.preview_m3u8_url??``,m3u8_url:e.m3u8_url??``})):[],money:``,up_user:``,source_username:``,task_id:``,file_status:``}}function se(e){return Array.isArray(e)?e.map(e=>p(e)):[]}function ce(e){let t=String(e?.id||e?.mid||e?.video_id||``),n=e?.is_more_link===`y`?`y`:`n`,r=Array.isArray(e?.links)?e.links.map(e=>({id:String(e?.id||``),name:String(e?.name||``),preview_m3u8_url:String(e?.preview_m3u8_url||``),m3u8_url:String(e?.m3u8_url||``)})):[],i=Array.isArray(e?.video_episodes)?e.video_episodes.length:0,a=Number(e?.episode_cnt||i||r.length||0);return{id:t,mid:String(e?.mid||t),name:String(e?.name||``),cat_id:String(e?.cat_id||``),cat_name:String(e?.cat_name||``),status:String(e?.status||`1`),status_text:String(e?.status_text||``),create_time:String(e?.create_time||``),content_type:e?.content_type,episode_cnt:Number.isFinite(a)?a:0,show_at:String(e?.show_at||``),position:String(e?.position||``),img_type:String(e?.img_type||``),img_x:String(e?.img_x||``),img_y:String(e?.img_y||``),img_width:String(e?.img_width||``),img_height:String(e?.img_height||``),play_count:Number(e?.play_count??e?.browse_count??0),preview_images:Array.isArray(e?.preview_images)?e.preview_images:[],duration:String(e?.duration||``),score:String(e?.score||``),is_more_link:n,update_status:String(e?.update_status||``),description:String(e?.description||``),language:String(e?.language||``),director:String(e?.director||``),actor:String(e?.actor||``),area:String(e?.area||``),issue_date:String(e?.issue_date||``),publisher:String(e?.publisher||``),series:String(e?.series||``),number:String(e?.number||``),tags:Array.isArray(e?.tags)?e.tags:[],source_tags:String(e?.source_tags||``),source_actor:Array.isArray(e?.source_actor)?e.source_actor:[],links:r,money:String(e?.money||``),up_user:String(e?.up_user||``),source_username:String(e?.source_username||``),task_id:String(e?.task_id||``),file_status:String(e?.file_status||``)}}function le(e,t){if(!Array.isArray(e)||e.length===0)return!1;let n=e[0];if(typeof n?.has_more==`boolean`)return n.has_more;let r=Number(n?.total??0);return Number.isFinite(r)&&r>0?r>t:e.length>=t}function ue(e){let t=e?.cursor;return typeof t==`string`&&t.trim()?t:void 0}function de(e){if(m(e)){let t=Number(e.episode_cnt||e.links?.length||0);return t>0?`全${t}集`:``}return h(Number(e.duration||0))}function m(e){return e.is_more_link===`y`}function h(e){if(!Number.isFinite(e)||e<=0)return``;let t=Math.floor(e),n=Math.floor(t/3600),r=Math.floor(t%3600/60),i=t%60,a=e=>String(e).padStart(2,`0`);return n>0?`${a(n)}:${a(r)}:${a(i)}`:`${a(r)}:${a(i)}`}function fe(e){let t=encodeURIComponent(e.name||``);return`/video/${e.id}/${t}/episode/1`}function g(e){return typeof e==`string`?e.trim():``}function _(e){return a(e.badge_url)}function pe(e,t){let n=g(e.contentId)||`manual-${t+1}`,r=typeof e.coverUrl==`string`?e.coverUrl.trim():``,i=typeof e.title==`string`?e.title.trim():``,a=typeof e.description==`string`?e.description.trim():``;return{id:n,mid:n,name:i||`猜你喜欢 ${t+1}`,cat_id:``,cat_name:``,status:`1`,status_text:``,create_time:``,content_type:1,episode_cnt:0,show_at:``,position:``,img_type:``,img_x:r,img_y:r,img_width:``,img_height:``,play_count:0,preview_images:[],duration:``,score:``,is_more_link:`n`,update_status:``,description:a,language:``,director:``,actor:``,area:``,issue_date:``,publisher:``,series:``,number:``,tags:[],source_tags:``,source_actor:[],links:[],money:``,up_user:``,source_username:``,task_id:``,file_status:``}}function me(e){let t=Number(e);if(!(!Number.isFinite(t)||t<=0))return t>10&&t<=100?t/10:Math.min(t,10)}function he(e){return String(e.img_type??``).trim().toLowerCase()===`long`?`short`:`tall`}export{f as useVideoDetailRecommendData};
+'use client';
+
+import { formatCompactCount } from "../../../../../utils/common.mjs";
+import { gContentGetGuessYouLikeVideos, pContentBatchGetVideoDetail } from "../../../../../service/generated/client.mjs";
+import { useRequest } from "../../../../../hooks/query/use-query.mjs";
+import { useKeepAliveState } from "../../../../common/keep-scroll-position/index.mjs";
+import { normalizeRecommendBadgeUrl } from "../../../../common/list/waterfall-recommend/recommend-badge-style.mjs";
+import { normalizeHomeRecommendRuntimeProps } from "../../home-recommend/shared/home-recommend-runtime-props.mjs";
+import { useCardDecoration } from "../../../../../hooks/use-card-decoration.mjs";
+import { buildEditorPreviewRecommendList } from "../shared/editor-preview.mjs";
+import { useVideoDetailMaterialRuntimeContext } from "../shared/runtime-context-provider.mjs";
+import { applyPlayCountDelta, clampColumns, limitRecommendDisplayList, mergeManualAndPool, resolveRows } from "./utils.mjs";
+import { useCallback, useEffect, useMemo, useState } from "react";
+
+//#region components/biz/business/detail/video-detail-recommend/shared.ts
+const PREFETCH_OFFSET = 4;
+/**
+* 详情页推荐模块共享数据逻辑。
+* 现有卡片推荐与新增瀑布流共同复用这层取数、合并与分页行为。
+*/
+function useVideoDetailRecommendData({ rows, columns, recommendContentConfig, title, showPlayCount, playCountDelta, showEpisode, enableInfinite, items, mode = "renderer" }) {
+	const detailId = useVideoDetailMaterialRuntimeContext()?.detailId || "";
+	const isEditor = mode === "editor";
+	const isPreview = isEditor;
+	const { getVerticalHoCoverImageUrl, getTitleText } = useCardDecoration();
+	const normalizedRuntimeProps = useMemo(() => normalizeHomeRecommendRuntimeProps({
+		recommendContentConfig,
+		enableInfinite,
+		items
+	}), [
+		enableInfinite,
+		items,
+		recommendContentConfig
+	]);
+	const isSmartTagMode = normalizedRuntimeProps.smartLayout?.enabled === true;
+	const resolvedSmartTagIds = useMemo(() => normalizedRuntimeProps.smartLayout?.tagIds ?? [], [normalizedRuntimeProps.smartLayout]);
+	const resolvedItems = useMemo(() => normalizedRuntimeProps.items ?? [], [normalizedRuntimeProps.items]);
+	const resolvedEnableInfinite = normalizedRuntimeProps.enableInfinite && !isEditor;
+	const shouldMergeManualItems = !isSmartTagMode;
+	const shouldRequestNextPage = resolvedEnableInfinite && isSmartTagMode && !isPreview;
+	const resolvedRows = resolveRows(rows, resolvedEnableInfinite);
+	const resolvedColumns = clampColumns(columns);
+	const pageSize = resolvedRows * resolvedColumns;
+	const requestPageSize = Math.max(1, pageSize);
+	const pagingStateKey = useMemo(() => {
+		return [
+			"video-detail-recommend",
+			detailId || "unknown",
+			requestPageSize,
+			resolvedSmartTagIds.join(",")
+		].join(":");
+	}, [
+		detailId,
+		requestPageSize,
+		resolvedSmartTagIds
+	]);
+	const [pagedPool, setPagedPool] = useKeepAliveState(`${pagingStateKey}:pool`, []);
+	const [nextCursor, setNextCursor] = useKeepAliveState(`${pagingStateKey}:cursor`, void 0);
+	const [hasMore, setHasMore] = useKeepAliveState(`${pagingStateKey}:has-more`, false);
+	const [isFetchingNextPage, setIsFetchingNextPage] = useState(false);
+	const editorPreviewPool = useMemo(() => buildEditorPreviewRecommendList(pageSize), [pageSize]);
+	const { data, isFetching: isSmartFetching, isPending: isSmartPending } = useRequest([
+		"video-detail-recommend",
+		detailId,
+		shouldRequestNextPage ? "paged" : "all",
+		requestPageSize,
+		resolvedSmartTagIds.join(",")
+	], async () => {
+		if (isPreview) return null;
+		return await gContentGetGuessYouLikeVideos({
+			cursor: nextCursor,
+			page_size: requestPageSize,
+			tags: resolvedSmartTagIds
+		});
+	}, {
+		enabled: !isPreview && isSmartTagMode,
+		refetchOnMount: "always"
+	});
+	const normalizedPool = useMemo(() => {
+		if (isPreview) return editorPreviewPool;
+		return normalizeGuessYouLikeVideos(data?.data?.videos);
+	}, [
+		data?.data?.videos,
+		editorPreviewPool,
+		isPreview
+	]);
+	useEffect(() => {
+		if (!shouldRequestNextPage) {
+			setIsFetchingNextPage(false);
+			setNextCursor(void 0);
+			return;
+		}
+		setPagedPool((prev) => {
+			if (!normalizedPool.length) return prev;
+			if (!prev.length) return normalizedPool;
+			const merged = [...normalizedPool];
+			const idSet = new Set(normalizedPool.map((item) => item.id).filter(Boolean));
+			prev.forEach((item) => {
+				if (!item.id || !idSet.has(item.id)) {
+					merged.push(item);
+					if (item.id) idSet.add(item.id);
+				}
+			});
+			return merged;
+		});
+		const resolvedNextCursor = resolveGuessLikeCursor(data?.data);
+		setNextCursor(resolvedNextCursor);
+		const resolvedHasMore = resolvedNextCursor ? true : resolveGuessLikeHasMore(data?.data?.videos, requestPageSize);
+		setHasMore((prev) => prev || resolvedHasMore);
+		setIsFetchingNextPage(false);
+	}, [
+		data?.data,
+		normalizedPool,
+		requestPageSize,
+		setHasMore,
+		setNextCursor,
+		setPagedPool,
+		shouldRequestNextPage
+	]);
+	const effectivePool = shouldRequestNextPage ? pagedPool : normalizedPool;
+	const manualContentIds = useMemo(() => {
+		if (!shouldMergeManualItems) return [];
+		return Array.from(new Set(resolvedItems.map((item) => normalizeContentId(item.contentId)).filter(Boolean)));
+	}, [resolvedItems, shouldMergeManualItems]);
+	const { data: manualDetailList, isFetching: isManualFetching, isPending: isManualPending } = useRequest(["video-detail-recommend-manual-details", manualContentIds.join(",")], async () => {
+		if (!manualContentIds.length) return [];
+		const response = await pContentBatchGetVideoDetail({ ids: manualContentIds });
+		return (Array.isArray(response.data?.videos) ? response.data.videos : []).map((item) => normalizeBatchVideoDetail(item));
+	}, {
+		enabled: manualContentIds.length > 0,
+		refetchOnMount: "always"
+	});
+	const manualIdSet = useMemo(() => {
+		if (!shouldMergeManualItems) return /* @__PURE__ */ new Set();
+		return new Set(resolvedItems.map((item) => normalizeContentId(item.contentId)).filter(Boolean));
+	}, [resolvedItems, shouldMergeManualItems]);
+	const filteredPool = useMemo(() => {
+		if (isPreview) return effectivePool;
+		return effectivePool.filter((item) => !manualIdSet.has(item.id));
+	}, [
+		effectivePool,
+		isPreview,
+		manualIdSet
+	]);
+	const manualList = useMemo(() => {
+		if (!shouldMergeManualItems || !resolvedItems.length) return [];
+		const poolMap = /* @__PURE__ */ new Map();
+		effectivePool.forEach((item) => {
+			const normalizedId = normalizeContentId(item.id);
+			if (normalizedId) poolMap.set(normalizedId, item);
+		});
+		(manualDetailList || []).forEach((item) => {
+			const normalizedId = normalizeContentId(item.id);
+			if (normalizedId) poolMap.set(normalizedId, item);
+		});
+		return resolvedItems.map((item, index) => {
+			const fallbackBase = isPreview ? editorPreviewPool[index % Math.max(1, editorPreviewPool.length)] : buildManualFallbackInfo(item, index);
+			const normalizedContentId = normalizeContentId(item.contentId);
+			const configuredCover = typeof item.coverUrl === "string" ? item.coverUrl.trim() : "";
+			const base = poolMap.get(normalizedContentId) ?? {
+				...fallbackBase,
+				id: normalizedContentId || fallbackBase.id || `preview-manual-${index + 1}`,
+				name: fallbackBase.name || `猜你喜欢 ${index + 1}`,
+				img_y: configuredCover || fallbackBase.img_y,
+				img_x: configuredCover || fallbackBase.img_x
+			};
+			const resolvedTitle = item.titleMode === "custom" ? item.title : getTitleText(base);
+			const resolvedCover = item.coverMode === "content" ? getVerticalHoCoverImageUrl(base) || configuredCover : configuredCover || getVerticalHoCoverImageUrl(base);
+			const configuredBadgeUrl = normalizeRecommendBadgeUrl(item.badge_url);
+			return {
+				info: {
+					...base,
+					name: resolvedTitle || base.name,
+					img_y: resolvedCover || base.img_y,
+					img_x: resolvedCover || base.img_x,
+					badge_url: configuredBadgeUrl || resolveRecommendBadgeUrl(base)
+				},
+				config: {
+					showPlayCount: item.showPlayCount,
+					playCountDelta: item.playCountDelta,
+					showEpisode: item.showEpisode
+				}
+			};
+		}).filter(Boolean);
+	}, [
+		editorPreviewPool,
+		effectivePool,
+		getTitleText,
+		getVerticalHoCoverImageUrl,
+		isPreview,
+		manualDetailList,
+		resolvedItems,
+		shouldMergeManualItems
+	]);
+	const poolDisplayItems = useMemo(() => {
+		return filteredPool.map((item) => ({ info: item }));
+	}, [filteredPool]);
+	const hasManualConfigured = shouldMergeManualItems && resolvedItems.length > 0;
+	const baseList = useMemo(() => {
+		if (hasManualConfigured) return manualList;
+		return mergeManualAndPool(manualList, poolDisplayItems, pageSize);
+	}, [
+		hasManualConfigured,
+		manualList,
+		pageSize,
+		poolDisplayItems
+	]);
+	const rawDisplayList = useMemo(() => {
+		if (shouldRequestNextPage || resolvedEnableInfinite) {
+			if (!manualList.length) return poolDisplayItems;
+			const manualInfoIdSet = new Set(manualList.map((item) => item.info.id).filter(Boolean));
+			return manualList.concat(poolDisplayItems.filter((item) => !manualInfoIdSet.has(item.info.id)));
+		}
+		return baseList;
+	}, [
+		baseList,
+		manualList,
+		poolDisplayItems,
+		resolvedEnableInfinite,
+		shouldRequestNextPage
+	]);
+	const displayList = useMemo(() => {
+		return limitRecommendDisplayList(rawDisplayList, pageSize, resolvedEnableInfinite);
+	}, [
+		pageSize,
+		rawDisplayList,
+		resolvedEnableInfinite
+	]);
+	const triggerIndex = hasMore && displayList.length > 0 ? Math.max(0, displayList.length - PREFETCH_OFFSET) : -1;
+	const triggerMarker = triggerIndex >= 0 ? `${pagingStateKey}:${triggerIndex}` : "";
+	const resolvedModuleTitle = String(title || "").trim();
+	const fetchNextPage = useCallback(async () => {
+		if (!shouldRequestNextPage || !hasMore || isFetchingNextPage) return;
+		setIsFetchingNextPage(true);
+		try {
+			const response = await gContentGetGuessYouLikeVideos({
+				cursor: nextCursor,
+				page_size: requestPageSize,
+				tags: resolvedSmartTagIds
+			});
+			const list = Array.isArray(response.data?.videos) ? response.data.videos : [];
+			const resolvedNextCursor = resolveGuessLikeCursor(response.data);
+			const normalizedList = normalizeGuessYouLikeVideos(list);
+			let appendedCount = 0;
+			setPagedPool((prev) => {
+				const idSet = new Set(prev.map((item) => item.id).filter(Boolean));
+				const merged = [...prev];
+				normalizedList.forEach((item) => {
+					if (!item.id || !idSet.has(item.id)) {
+						merged.push(item);
+						if (item.id) idSet.add(item.id);
+					}
+				});
+				appendedCount = merged.length - prev.length;
+				return merged;
+			});
+			setNextCursor(resolvedNextCursor);
+			setHasMore((resolvedNextCursor ? true : resolveGuessLikeHasMore(list, requestPageSize)) && appendedCount > 0);
+		} catch (error) {
+			console.error("猜你喜欢分页加载失败", error);
+			setHasMore(false);
+		} finally {
+			setIsFetchingNextPage(false);
+		}
+	}, [
+		hasMore,
+		isFetchingNextPage,
+		nextCursor,
+		requestPageSize,
+		resolvedSmartTagIds,
+		setHasMore,
+		setNextCursor,
+		setPagedPool,
+		shouldRequestNextPage
+	]);
+	useEffect(() => {
+		if (!triggerMarker || !hasMore || isFetchingNextPage || !shouldRequestNextPage) return;
+		const target = document.querySelector(`[data-detail-recommend-trigger="${triggerMarker}"]`);
+		if (!(target instanceof HTMLElement)) return;
+		const observer = new IntersectionObserver((entries) => {
+			if (entries[0]?.isIntersecting && !isFetchingNextPage) fetchNextPage();
+		});
+		observer.observe(target);
+		return () => {
+			observer.disconnect();
+		};
+	}, [
+		fetchNextPage,
+		hasMore,
+		isFetchingNextPage,
+		shouldRequestNextPage,
+		triggerMarker
+	]);
+	const shouldShowLoading = !isPreview && (isFetchingNextPage || isSmartTagMode && (isSmartFetching || isSmartPending) || manualContentIds.length > 0 && (isManualFetching || isManualPending));
+	return {
+		uiItems: useMemo(() => {
+			return displayList.map((item, index) => {
+				const resolvedShowPlayCount = showPlayCount !== false && (item.config?.showPlayCount ?? true);
+				const resolvedPlayCountDelta = Number(item.config?.playCountDelta ?? playCountDelta ?? 0);
+				const resolvedShowEpisode = item.config?.showEpisode ?? showEpisode;
+				return {
+					sourceIndex: index,
+					info: item.info,
+					title: getTitleText(item.info),
+					coverUrl: getVerticalHoCoverImageUrl(item.info),
+					badgeImageUrl: resolveRecommendBadgeUrl(item.info),
+					detailPath: mode === "renderer" ? buildDetailPath(item.info) : "",
+					playCountText: formatCompactCount(applyPlayCountDelta(item.info.play_count || 0, resolvedPlayCountDelta)),
+					videoInfoText: buildRecommendVideoInfoText(item.info),
+					showPlayCount: resolvedShowPlayCount,
+					showEpisode: resolvedShowEpisode,
+					score: normalizeWaterfallScore(item.info.score),
+					cardKind: resolveWaterfallCardKind(item.info)
+				};
+			});
+		}, [
+			displayList,
+			getTitleText,
+			getVerticalHoCoverImageUrl,
+			mode,
+			playCountDelta,
+			showEpisode,
+			showPlayCount
+		]),
+		shouldShowLoading,
+		isPreview,
+		resolvedColumns,
+		resolvedModuleTitle,
+		triggerIndex,
+		triggerMarker
+	};
+}
+function normalizeGuessYouLikeVideo(raw) {
+	const normalizedIsMoreLink = raw.is_more_link ? "y" : "n";
+	return {
+		id: raw.video_id || "",
+		mid: "",
+		name: raw.name || "",
+		cat_id: "",
+		cat_name: "",
+		status: "1",
+		status_text: "",
+		create_time: "",
+		content_type: raw.content_type,
+		episode_cnt: raw.episode_count || 0,
+		show_at: raw.show_at ?? "",
+		position: "",
+		img_type: raw.img_type ?? "",
+		img_x: raw.img_x ?? "",
+		img_y: raw.img_y ?? "",
+		img_width: "",
+		img_height: "",
+		play_count: raw.play_count,
+		preview_images: [],
+		duration: String(raw.duration ?? ""),
+		score: String(raw.score ?? ""),
+		is_more_link: normalizedIsMoreLink,
+		update_status: String(raw.update_status ?? ""),
+		description: raw.description ?? "",
+		language: "",
+		director: "",
+		actor: "",
+		area: "",
+		issue_date: "",
+		publisher: "",
+		series: "",
+		number: "",
+		tags: [],
+		source_tags: raw.source_tags ?? "",
+		source_actor: [],
+		links: Array.isArray(raw.episodes) ? raw.episodes.map((link) => ({
+			id: link.id ?? "",
+			name: link.name ?? "",
+			preview_m3u8_url: link.preview_m3u8_url ?? "",
+			m3u8_url: link.m3u8_url ?? ""
+		})) : [],
+		money: "",
+		up_user: "",
+		source_username: "",
+		task_id: "",
+		file_status: ""
+	};
+}
+function normalizeGuessYouLikeVideos(list) {
+	if (!Array.isArray(list)) return [];
+	return list.map((item) => normalizeGuessYouLikeVideo(item));
+}
+function normalizeBatchVideoDetail(raw) {
+	const resolvedId = String(raw?.id || raw?.mid || raw?.video_id || "");
+	const normalizedIsMoreLink = raw?.is_more_link === "y" ? "y" : "n";
+	const links = Array.isArray(raw?.links) ? raw.links.map((link) => ({
+		id: String(link?.id || ""),
+		name: String(link?.name || ""),
+		preview_m3u8_url: String(link?.preview_m3u8_url || ""),
+		m3u8_url: String(link?.m3u8_url || "")
+	})) : [];
+	const episodeCntFromProto = Array.isArray(raw?.video_episodes) ? raw.video_episodes.length : 0;
+	const episodeCnt = Number(raw?.episode_cnt || episodeCntFromProto || links.length || 0);
+	return {
+		id: resolvedId,
+		mid: String(raw?.mid || resolvedId),
+		name: String(raw?.name || ""),
+		cat_id: String(raw?.cat_id || ""),
+		cat_name: String(raw?.cat_name || ""),
+		status: String(raw?.status || "1"),
+		status_text: String(raw?.status_text || ""),
+		create_time: String(raw?.create_time || ""),
+		content_type: raw?.content_type,
+		episode_cnt: Number.isFinite(episodeCnt) ? episodeCnt : 0,
+		show_at: String(raw?.show_at || ""),
+		position: String(raw?.position || ""),
+		img_type: String(raw?.img_type || ""),
+		img_x: String(raw?.img_x || ""),
+		img_y: String(raw?.img_y || ""),
+		img_width: String(raw?.img_width || ""),
+		img_height: String(raw?.img_height || ""),
+		play_count: Number(raw?.play_count ?? raw?.browse_count ?? 0),
+		preview_images: Array.isArray(raw?.preview_images) ? raw.preview_images : [],
+		duration: String(raw?.duration || ""),
+		score: String(raw?.score || ""),
+		is_more_link: normalizedIsMoreLink,
+		update_status: String(raw?.update_status || ""),
+		description: String(raw?.description || ""),
+		language: String(raw?.language || ""),
+		director: String(raw?.director || ""),
+		actor: String(raw?.actor || ""),
+		area: String(raw?.area || ""),
+		issue_date: String(raw?.issue_date || ""),
+		publisher: String(raw?.publisher || ""),
+		series: String(raw?.series || ""),
+		number: String(raw?.number || ""),
+		tags: Array.isArray(raw?.tags) ? raw.tags : [],
+		source_tags: String(raw?.source_tags || ""),
+		source_actor: Array.isArray(raw?.source_actor) ? raw.source_actor : [],
+		links,
+		money: String(raw?.money || ""),
+		up_user: String(raw?.up_user || ""),
+		source_username: String(raw?.source_username || ""),
+		task_id: String(raw?.task_id || ""),
+		file_status: String(raw?.file_status || "")
+	};
+}
+function resolveGuessLikeHasMore(list, pageSize) {
+	if (!Array.isArray(list) || list.length === 0) return false;
+	const first = list[0];
+	if (typeof first?.has_more === "boolean") return first.has_more;
+	const total = Number(first?.total ?? 0);
+	if (Number.isFinite(total) && total > 0) return total > pageSize;
+	return list.length >= pageSize;
+}
+function resolveGuessLikeCursor(data) {
+	const cursor = data?.cursor;
+	return typeof cursor === "string" && cursor.trim() ? cursor : void 0;
+}
+function buildRecommendVideoInfoText(info) {
+	if (isSeriesContent(info)) {
+		const totalEpisodes = Number(info.episode_cnt || info.links?.length || 0);
+		return totalEpisodes > 0 ? `全${totalEpisodes}集` : "";
+	}
+	return formatDuration(Number(info.duration || 0));
+}
+function isSeriesContent(info) {
+	return info.is_more_link === "y";
+}
+function formatDuration(duration) {
+	if (!Number.isFinite(duration) || duration <= 0) return "";
+	const totalSeconds = Math.floor(duration);
+	const hours = Math.floor(totalSeconds / 3600);
+	const minutes = Math.floor(totalSeconds % 3600 / 60);
+	const seconds = totalSeconds % 60;
+	const pad = (value) => String(value).padStart(2, "0");
+	if (hours > 0) return `${pad(hours)}:${pad(minutes)}:${pad(seconds)}`;
+	return `${pad(minutes)}:${pad(seconds)}`;
+}
+function buildDetailPath(info) {
+	const encodedName = encodeURIComponent(info.name || "");
+	return `/video/${info.id}/${encodedName}/episode/1`;
+}
+function normalizeContentId(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+/**
+* 解析猜你喜欢卡片的图片角标地址。
+*/
+function resolveRecommendBadgeUrl(info) {
+	return normalizeRecommendBadgeUrl(info.badge_url);
+}
+function buildManualFallbackInfo(item, index) {
+	const fallbackId = normalizeContentId(item.contentId) || `manual-${index + 1}`;
+	const fallbackCover = typeof item.coverUrl === "string" ? item.coverUrl.trim() : "";
+	const fallbackTitle = typeof item.title === "string" ? item.title.trim() : "";
+	const fallbackDescription = typeof item.description === "string" ? item.description.trim() : "";
+	return {
+		id: fallbackId,
+		mid: fallbackId,
+		name: fallbackTitle || `猜你喜欢 ${index + 1}`,
+		cat_id: "",
+		cat_name: "",
+		status: "1",
+		status_text: "",
+		create_time: "",
+		content_type: 1,
+		episode_cnt: 0,
+		show_at: "",
+		position: "",
+		img_type: "",
+		img_x: fallbackCover,
+		img_y: fallbackCover,
+		img_width: "",
+		img_height: "",
+		play_count: 0,
+		preview_images: [],
+		duration: "",
+		score: "",
+		is_more_link: "n",
+		update_status: "",
+		description: fallbackDescription,
+		language: "",
+		director: "",
+		actor: "",
+		area: "",
+		issue_date: "",
+		publisher: "",
+		series: "",
+		number: "",
+		tags: [],
+		source_tags: "",
+		source_actor: [],
+		links: [],
+		money: "",
+		up_user: "",
+		source_username: "",
+		task_id: "",
+		file_status: ""
+	};
+}
+function normalizeWaterfallScore(value) {
+	const numericValue = Number(value);
+	if (!Number.isFinite(numericValue) || numericValue <= 0) return;
+	if (numericValue > 10 && numericValue <= 100) return numericValue / 10;
+	return Math.min(numericValue, 10);
+}
+function resolveWaterfallCardKind(info) {
+	return String(info.img_type ?? "").trim().toLowerCase() === "long" ? "short" : "tall";
+}
+
+//#endregion
+export { useVideoDetailRecommendData };

package/dist/components/biz/business/detail/video-detail-recommend/utils.mjs

@@ -1,2 +1,61 @@
 
-function e(e){if(typeof e==`boolean`)return e;if(typeof e==`number`)return e===1;if(typeof e==`string`){let t=e.trim().toLowerCase();return t===`true`||t===`1`||t===`y`||t===`yes`||t===`on`}return!1}function t(t){let n=e(t.smartTagEnabled),r=Array.isArray(t.smartTagIds)?t.smartTagIds.map(e=>String(e||``).trim()).filter(Boolean):[],i=n?e(t.enableInfinite):!1,a=Array.isArray(t.items)?t.items.filter(Boolean):t.items;return{...t,smartTagEnabled:n,smartTagIds:r,enableInfinite:i,items:a}}function n(e,t){let n=Number(e||1);if(!Number.isFinite(n))return 1;let r=Math.max(1,Math.floor(n));return t?r:Math.min(10,r)}function r(e){let t=Number(e??3);return Number.isFinite(t)?Math.min(6,Math.max(1,Math.floor(t))):3}function i(e,t){let n=Number(e||0),r=Number(t||0);return!Number.isFinite(n)||!Number.isFinite(r)?0:Math.max(0,n+r)}function a(e,t,n){let r=Math.max(0,n),i=e.slice(0,r);return i.length>=r?i:i.concat(t.slice(0,r-i.length))}function o(e,t,n){return n?e:e.slice(0,Math.max(0,t))}export{i as applyPlayCountDelta,r as clampColumns,o as limitRecommendDisplayList,a as mergeManualAndPool,t as normalizeRecommendRuntimeProps,n as resolveRows};
+import { normalizeHomeRecommendRuntimeProps } from "../../home-recommend/shared/home-recommend-runtime-props.mjs";
+
+//#region components/biz/business/detail/video-detail-recommend/utils.ts
+/** 与首页瀑布流智能列表首屏条数对齐。 */
+const VIDEO_DETAIL_SMART_LIST_PAGE_SIZE = 16;
+/**
+* 解析详情页推荐在智能铺设下的服务端/客户端列表 page_size（与 HomeRecommendWaterfall 一致）。
+*/
+function resolveVideoDetailSmartListPageSize(options) {
+	if (options.enableInfinite === true) return VIDEO_DETAIL_SMART_LIST_PAGE_SIZE;
+	const count = Array.isArray(options.items) ? options.items.length : 0;
+	if (count <= 0) return VIDEO_DETAIL_SMART_LIST_PAGE_SIZE;
+	return count;
+}
+/**
+* 计算实际行数。
+*/
+function resolveRows(rows, enableInfinite) {
+	const resolved = Number(rows || 1);
+	if (!Number.isFinite(resolved)) return 1;
+	const normalized = Math.max(1, Math.floor(resolved));
+	if (enableInfinite) return normalized;
+	return Math.min(10, normalized);
+}
+/**
+* 列数限制 1-6。
+*/
+function clampColumns(columns) {
+	const resolved = Number(columns ?? 3);
+	if (!Number.isFinite(resolved)) return 3;
+	return Math.min(6, Math.max(1, Math.floor(resolved)));
+}
+/**
+* 播放量浮动。
+*/
+function applyPlayCountDelta(base, delta) {
+	const resolvedBase = Number(base || 0);
+	const resolvedDelta = Number(delta || 0);
+	if (!Number.isFinite(resolvedBase) || !Number.isFinite(resolvedDelta)) return 0;
+	return Math.max(0, resolvedBase + resolvedDelta);
+}
+/**
+* 手动卡片优先，不足则补推荐池。
+*/
+function mergeManualAndPool(manual, pool, size) {
+	const sliceSize = Math.max(0, size);
+	const manualList = manual.slice(0, sliceSize);
+	if (manualList.length >= sliceSize) return manualList;
+	return manualList.concat(pool.slice(0, sliceSize - manualList.length));
+}
+/**
+* 控制最终展示列表条数。无限下拉不限制，其余场景按 pageSize 截断。
+*/
+function limitRecommendDisplayList(list, pageSize, enableInfinite) {
+	if (enableInfinite) return list;
+	return list.slice(0, Math.max(0, pageSize));
+}
+
+//#endregion
+export { applyPlayCountDelta, clampColumns, limitRecommendDisplayList, mergeManualAndPool, resolveRows, resolveVideoDetailSmartListPageSize };

package/dist/components/biz/business/feature-grid/variants/basic-feature-grid/defaults/default-props.mjs

@@ -1,2 +1,13 @@
 
-const e={titleFontSize:12,iconTitleGap:2,containerPadding:16};export{e as defaultProps};
+//#region components/biz/business/feature-grid/variants/basic-feature-grid/defaults/default-props.ts
+/**
+* BasicFeatureGrid 组件默认 Props 配置
+*/
+const defaultProps = {
+	titleFontSize: 12,
+	iconTitleGap: 2,
+	containerPadding: 16
+};
+
+//#endregion
+export { defaultProps };

package/dist/components/biz/business/feature-grid/variants/basic-feature-grid/index.mjs

@@ -1,2 +1,10 @@
 
-import{defaultProps as e}from"./defaults/default-props.mjs";import t from"./runtime/client.mjs";import{schema as n}from"./schema/index.mjs";var r=t;export{r as default};
+import { defaultProps } from "./defaults/default-props.mjs";
+import BasicFeatureGridClient from "./runtime/client.mjs";
+import { schema } from "./schema/index.mjs";
+
+//#region components/biz/business/feature-grid/variants/basic-feature-grid/index.ts
+var basic_feature_grid_default = BasicFeatureGridClient;
+
+//#endregion
+export { basic_feature_grid_default as default };