Merge branch 'dev' of https://github.com/mtvpls/moontvplus-dev into dev

2026-03-21 10:33:16 +08:00
parent b61865fb49 5a1e578f82
commit c10e28f5ae
7 changed files with 294 additions and 209 deletions
--- a/24
+++ b/24
@@ -1,3 +1,27 @@
+## [215.0.0] - 2026-03-20
+### Added
+- 增加主动恢复进度按钮
+- 新增播放记录面板
+- 弹幕搜索面板标题增加tooltip
+- 影视搜索新增列表视图
+- pansou增加重试按钮
+- 新增ai评论生成
+- 增加一键render部署
+- 电视直播增加三种代理模式
+
+### Changed
+- 优化直链播放m3u8体验
+- 搜索页面海量数据下使用虚拟滚动提高性能
+- 优化emby代理内存泄漏问题
+- 电视直播代理控制权从用户端改为管理端
+- 获取视频源详情不再依赖title
+
+### Fixed
+- 修复search页面僵尸历史记录tag
+- 修复弹幕搜索框挤压
+- 修复搜索页面加载条显示顺序错误
+- 修复继续观看渐进式加载的一些问题
+
 ## [214.1.0] - 2026-03-10
 ### Changed
 - emby兼容jellyfin
--- a/VERSION.txt
+++ b/VERSION.txt
@@ -1,2 +1,2 @@
-214.1.0
+215.0.0

--- a/src/app/api/proxy/m3u8/route.ts
+++ b/src/app/api/proxy/m3u8/route.ts
@@ -110,6 +110,10 @@ function rewriteM3U8Content(content: string, baseUrl: string, req: Request, allo
  const host = req.headers.get('host');
  const proxyBase = `${protocol}://${host}/api/proxy`;

+  // 获取 moontv-source 参数
+  const reqUrl = new URL(req.url);
+  const source = reqUrl.searchParams.get('moontv-source') || '';
+
  const lines = content.split('\n');
  const rewrittenLines: string[] = [];

@@ -119,19 +123,19 @@ function rewriteM3U8Content(content: string, baseUrl: string, req: Request, allo
    // 处理 TS 片段 URL 和其他媒体文件
    if (line && !line.startsWith('#')) {
      const resolvedUrl = resolveUrl(baseUrl, line);
-      const proxyUrl = allowCORS ? resolvedUrl : `${proxyBase}/segment?url=${encodeURIComponent(resolvedUrl)}`;
+      const proxyUrl = allowCORS ? resolvedUrl : `${proxyBase}/segment?url=${encodeURIComponent(resolvedUrl)}&moontv-source=${source}`;
      rewrittenLines.push(proxyUrl);
      continue;
    }

    // 处理 EXT-X-MAP 标签中的 URI
    if (line.startsWith('#EXT-X-MAP:')) {
-      line = rewriteMapUri(line, baseUrl, proxyBase, allowCORS);
+      line = rewriteMapUri(line, baseUrl, proxyBase, allowCORS, source);
    }

    // 处理 EXT-X-KEY 标签中的 URI
    if (line.startsWith('#EXT-X-KEY:')) {
-      line = rewriteKeyUri(line, baseUrl, proxyBase, allowCORS);
+      line = rewriteKeyUri(line, baseUrl, proxyBase, allowCORS, source);
    }

    // 处理嵌套的 M3U8 文件 (EXT-X-STREAM-INF)
@@ -143,7 +147,7 @@ function rewriteM3U8Content(content: string, baseUrl: string, req: Request, allo
        const nextLine = lines[i].trim();
        if (nextLine && !nextLine.startsWith('#')) {
          const resolvedUrl = resolveUrl(baseUrl, nextLine);
-          const proxyUrl = `${proxyBase}/m3u8?url=${encodeURIComponent(resolvedUrl)}`;
+          const proxyUrl = `${proxyBase}/m3u8?url=${encodeURIComponent(resolvedUrl)}&moontv-source=${source}`;
          rewrittenLines.push(proxyUrl);
        } else {
          rewrittenLines.push(nextLine);
@@ -158,23 +162,23 @@ function rewriteM3U8Content(content: string, baseUrl: string, req: Request, allo
  return rewrittenLines.join('\n');
 }

-function rewriteMapUri(line: string, baseUrl: string, proxyBase: string, allowCORS: boolean) {
+function rewriteMapUri(line: string, baseUrl: string, proxyBase: string, allowCORS: boolean, source: string) {
  const uriMatch = line.match(/URI="([^"]+)"/);
  if (uriMatch) {
    const originalUri = uriMatch[1];
    const resolvedUrl = resolveUrl(baseUrl, originalUri);
-    const proxyUrl = allowCORS ? resolvedUrl : `${proxyBase}/segment?url=${encodeURIComponent(resolvedUrl)}`;
+    const proxyUrl = allowCORS ? resolvedUrl : `${proxyBase}/segment?url=${encodeURIComponent(resolvedUrl)}&moontv-source=${source}`;
    return line.replace(uriMatch[0], `URI="${proxyUrl}"`);
  }
  return line;
 }

-function rewriteKeyUri(line: string, baseUrl: string, proxyBase: string, allowCORS: boolean) {
+function rewriteKeyUri(line: string, baseUrl: string, proxyBase: string, allowCORS: boolean, source: string) {
  const uriMatch = line.match(/URI="([^"]+)"/);
  if (uriMatch) {
    const originalUri = uriMatch[1];
    const resolvedUrl = resolveUrl(baseUrl, originalUri);
-    const proxyUrl = allowCORS ? resolvedUrl : `${proxyBase}/key?url=${encodeURIComponent(resolvedUrl)}`;
+    const proxyUrl = allowCORS ? resolvedUrl : `${proxyBase}/key?url=${encodeURIComponent(resolvedUrl)}&moontv-source=${source}`;
    return line.replace(uriMatch[0], `URI="${proxyUrl}"`);
  }
  return line;
--- a/src/components/ContinueWatching.tsx
+++ b/src/components/ContinueWatching.tsx
@@ -8,60 +8,71 @@ import { createPortal } from 'react-dom';
 import type { PlayRecord } from '@/lib/db.client';
 import {
  clearAllPlayRecords,
+  getCachedPlayRecordsSnapshot,
  getAllPlayRecords,
  subscribeToDataUpdates,
 } from '@/lib/db.client';

-import VideoCard from '@/components/VideoCard';
 import PlayRecordsPanel from '@/components/PlayRecordsPanel';
+import VideoCard from '@/components/VideoCard';
 import VirtualScrollableRow from '@/components/VirtualScrollableRow';

 interface ContinueWatchingProps {
  className?: string;
 }

+type PlayRecordItem = PlayRecord & { key: string };
+
 export default function ContinueWatching({ className }: ContinueWatchingProps) {
-  const [playRecords, setPlayRecords] = useState<
-    (PlayRecord & { key: string })[]
-  >([]);
+  const storageType = process.env.NEXT_PUBLIC_STORAGE_TYPE || 'localstorage';
+  const cachedDisplayLimit = storageType !== 'localstorage' ? 10 : undefined;
+  const [playRecords, setPlayRecords] = useState<PlayRecordItem[]>([]);
  const [loading, setLoading] = useState(true);
  const [showConfirmDialog, setShowConfirmDialog] = useState(false);
  const [showPlayRecordsPanel, setShowPlayRecordsPanel] = useState(false);

-  // 处理播放记录数据更新的函数
-  const updatePlayRecords = (allRecords: Record<string, PlayRecord>, limit?: number) => {
-    // 将记录转换为数组并根据 save_time 由近到远排序
+  const updatePlayRecords = (
+    allRecords: Record<string, PlayRecord>,
+    limit?: number
+  ) => {
    const recordsArray = Object.entries(allRecords).map(([key, record]) => ({
      ...record,
      key,
    }));

-    // 按 save_time 降序排序（最新的在前面）
-    const sortedRecords = recordsArray.sort(
-      (a, b) => b.save_time - a.save_time
-    );
+    const sortedRecords = recordsArray.sort((a, b) => b.save_time - a.save_time);
+    setPlayRecords(limit ? sortedRecords.slice(0, limit) : sortedRecords);
+  };

-    // 如果指定了 limit，只取前 N 条
-    const finalRecords = limit ? sortedRecords.slice(0, limit) : sortedRecords;
+  const applyCachedSnapshot = () => {
+    const cachedRecords = getCachedPlayRecordsSnapshot();
+    if (Object.keys(cachedRecords).length === 0) {
+      return false;
+    }

-    setPlayRecords(finalRecords);
+    updatePlayRecords(cachedRecords, cachedDisplayLimit);
+    setLoading(false);
+    return true;
  };

  useEffect(() => {
+    const unsubscribe = subscribeToDataUpdates(
+      'playRecordsUpdated',
+      (newRecords: Record<string, PlayRecord>) => {
+        updatePlayRecords(newRecords);
+        setLoading(false);
+      }
+    );
+
    const fetchPlayRecords = async () => {
      try {
-        setLoading(true);
-
-        // 从缓存或API获取所有播放记录
-        const allRecords = await getAllPlayRecords();
-
-        // 非 localStorage 模式下，先只显示前 10 条记录
-        const storageType = process.env.NEXT_PUBLIC_STORAGE_TYPE || 'localstorage';
-        if (storageType !== 'localstorage') {
-          updatePlayRecords(allRecords, 10);
-        } else {
-          updatePlayRecords(allRecords);
+        const hasCachedSnapshot = applyCachedSnapshot();
+        if (!hasCachedSnapshot) {
+          setLoading(true);
        }
+
+        const allRecords = await getAllPlayRecords();
+        updatePlayRecords(allRecords);
      } catch (error) {
        console.error('获取播放记录失败:', error);
        setPlayRecords([]);
@@ -71,37 +82,23 @@ export default function ContinueWatching({ className }: ContinueWatchingProps) {
    };

    fetchPlayRecords();
-
-    // 监听播放记录更新事件
-    const unsubscribe = subscribeToDataUpdates(
-      'playRecordsUpdated',
-      (newRecords: Record<string, PlayRecord>) => {
-        // 同步完成后，加载完整数据（不限制数量）
-        updatePlayRecords(newRecords);
-      }
-    );
-
    return unsubscribe;
-  }, []);
+  }, [cachedDisplayLimit]);

-  // 如果没有播放记录，则不渲染组件
  if (!loading && playRecords.length === 0) {
    return null;
  }

-  // 计算播放进度百分比
  const getProgress = (record: PlayRecord) => {
    if (record.total_time === 0) return 0;
    return (record.play_time / record.total_time) * 100;
  };

-  // 从 key 中解析 source 和 id
  const parseKey = (key: string) => {
    const [source, id] = key.split('+');
    return { source, id };
  };

-  // 处理清空确认
  const handleClearConfirm = async () => {
    await clearAllPlayRecords();
    setPlayRecords([]);
@@ -133,173 +130,170 @@ export default function ContinueWatching({ className }: ContinueWatchingProps) {
            </div>
          )}
        </div>
-      {loading ? (
-        // 加载状态显示灰色占位数据（使用原始 ScrollableRow）
-        <div className="flex gap-2 overflow-x-auto scrollbar-hide pt-2 pb-2">
-          {Array.from({ length: 8 }).map((_, index) => (
-            <div
-              key={index}
-              className='min-w-[180px] w-48 sm:min-w-[200px] sm:w-52'
-            >
-              <div className='relative aspect-[3/2] w-full overflow-hidden rounded-lg bg-gray-200 animate-pulse dark:bg-gray-800'>
-                <div className='absolute inset-0 bg-gray-300 dark:bg-gray-700'></div>
+        {loading ? (
+          <div className='flex gap-2 overflow-x-auto scrollbar-hide pb-2 pt-2'>
+            {Array.from({ length: 8 }).map((_, index) => (
+              <div
+                key={index}
+                className='min-w-[180px] w-48 sm:min-w-[200px] sm:w-52'
+              >
+                <div className='relative aspect-[3/2] w-full overflow-hidden rounded-lg bg-gray-200 animate-pulse dark:bg-gray-800'>
+                  <div className='absolute inset-0 bg-gray-300 dark:bg-gray-700' />
+                </div>
+                <div className='mt-1 h-1 rounded bg-gray-200 animate-pulse dark:bg-gray-800' />
+                <div className='mt-2 h-4 w-3/4 rounded bg-gray-200 animate-pulse dark:bg-gray-800' />
              </div>
-              <div className='mt-1 h-1 bg-gray-200 rounded animate-pulse dark:bg-gray-800'></div>
-              <div className='mt-2 h-4 bg-gray-200 rounded animate-pulse dark:bg-gray-800 w-3/4'></div>
-            </div>
-          ))}
-        </div>
-      ) : (
-        // 使用虚拟滚动显示真实数据
-        <div>
-          <VirtualScrollableRow>
-            {playRecords.map((record) => {
-              const { source, id } = parseKey(record.key);
-              return (
-                <div
-                  key={record.key}
-                  className='min-w-[180px] w-48 sm:min-w-[200px] sm:w-52'
-                  style={{ position: 'relative' }}
-                >
-                  <VideoCard
-                    id={id}
-                    title={record.title}
-                    poster={record.cover}
-                    year={record.year}
-                    source={source}
-                    source_name={record.source_name}
-                    progress={getProgress(record)}
-                    episodes={record.total_episodes}
-                    currentEpisode={record.index}
-                    query={record.search_title}
-                    from='playrecord'
-                    onDelete={() =>
-                      setPlayRecords((prev) =>
-                        prev.filter((r) => r.key !== record.key)
-                      )
-                    }
-                    type={record.total_episodes > 1 ? 'tv' : ''}
-                    origin={record.origin}
-                    orientation='horizontal'
-                    playTime={record.play_time}
-                    totalTime={record.total_time}
-                  />
-                  {/* 新增剧集提示 - 完全独立于 VideoCard */}
-                  {record.new_episodes && record.new_episodes > 0 && (
-                    <div
-                      style={{
-                        position: 'absolute',
-                        top: '-6px',
-                        right: '-6px',
-                        zIndex: 100,
-                        pointerEvents: 'none',
-                        width: '28px',
-                        height: '28px',
-                      }}
-                    >
-                      {/* 水波纹动画 - 第一层 */}
+            ))}
+          </div>
+        ) : (
+          <div>
+            <VirtualScrollableRow>
+              {playRecords.map((record) => {
+                const { source, id } = parseKey(record.key);
+                return (
+                  <div
+                    key={record.key}
+                    className='min-w-[180px] w-48 sm:min-w-[200px] sm:w-52'
+                    style={{ position: 'relative' }}
+                  >
+                    <VideoCard
+                      id={id}
+                      title={record.title}
+                      poster={record.cover}
+                      year={record.year}
+                      source={source}
+                      source_name={record.source_name}
+                      progress={getProgress(record)}
+                      episodes={record.total_episodes}
+                      currentEpisode={record.index}
+                      query={record.search_title}
+                      from='playrecord'
+                      onDelete={() =>
+                        setPlayRecords((prev) =>
+                          prev.filter((item) => item.key !== record.key)
+                        )
+                      }
+                      type={record.total_episodes > 1 ? 'tv' : ''}
+                      origin={record.origin}
+                      orientation='horizontal'
+                      playTime={record.play_time}
+                      totalTime={record.total_time}
+                    />
+                    {record.new_episodes && record.new_episodes > 0 && (
                      <div
                        style={{
                          position: 'absolute',
-                          inset: '0',
-                          borderRadius: '9999px',
-                          backgroundColor: 'rgb(14 165 233)',
-                          animation: 'ping-scale 1.5s cubic-bezier(0, 0, 0.2, 1) infinite',
-                        }}
-                      />
-                      {/* 水波纹动画 - 第二层 */}
-                      <div
-                        style={{
-                          position: 'absolute',
-                          inset: '0',
-                          borderRadius: '9999px',
-                          backgroundColor: 'rgb(14 165 233)',
-                          animation: 'pulse-scale 2.5s cubic-bezier(0.4, 0, 0.6, 1) infinite',
-                        }}
-                      />
-                      {/* 主体徽章 */}
-                      <div
-                        style={{
-                          position: 'absolute',
-                          inset: '0',
-                          borderRadius: '9999px',
-                          background: 'linear-gradient(to bottom right, rgb(14 165 233), rgb(2 132 199))',
-                          color: 'white',
-                          fontSize: '11px',
-                          fontWeight: 'bold',
-                          display: 'flex',
-                          alignItems: 'center',
-                          justifyContent: 'center',
-                          boxShadow: '0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)',
-                          animation: 'badge-scale 2s ease-in-out infinite',
+                          top: '-6px',
+                          right: '-6px',
+                          zIndex: 100,
+                          pointerEvents: 'none',
+                          width: '28px',
+                          height: '28px',
                        }}
                      >
-                        +{record.new_episodes}
+                        <div
+                          style={{
+                            position: 'absolute',
+                            inset: '0',
+                            borderRadius: '9999px',
+                            backgroundColor: 'rgb(14 165 233)',
+                            animation:
+                              'ping-scale 1.5s cubic-bezier(0, 0, 0.2, 1) infinite',
+                          }}
+                        />
+                        <div
+                          style={{
+                            position: 'absolute',
+                            inset: '0',
+                            borderRadius: '9999px',
+                            backgroundColor: 'rgb(14 165 233)',
+                            animation:
+                              'pulse-scale 2.5s cubic-bezier(0.4, 0, 0.6, 1) infinite',
+                          }}
+                        />
+                        <div
+                          style={{
+                            position: 'absolute',
+                            inset: '0',
+                            borderRadius: '9999px',
+                            background:
+                              'linear-gradient(to bottom right, rgb(14 165 233), rgb(2 132 199))',
+                            color: 'white',
+                            fontSize: '11px',
+                            fontWeight: 'bold',
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                            boxShadow:
+                              '0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)',
+                            animation: 'badge-scale 2s ease-in-out infinite',
+                          }}
+                        >
+                          +{record.new_episodes}
+                        </div>
                      </div>
-                    </div>
-                  )}
-                </div>
-              );
-            })}
-          </VirtualScrollableRow>
-        </div>
-      )}
-    </section>
-
-    {/* 确认对话框 */}
-    {showConfirmDialog && createPortal(
-      <div
-        className='fixed inset-0 bg-black bg-opacity-50 z-[9999] flex items-center justify-center p-4 transition-opacity duration-300'
-        onClick={() => setShowConfirmDialog(false)}
-      >
-        <div
-          className='bg-white dark:bg-gray-800 rounded-lg shadow-xl max-w-md w-full border border-red-200 dark:border-red-800 transition-all duration-300'
-          onClick={(e) => e.stopPropagation()}
-        >
-          <div className="p-6">
-            {/* 图标和标题 */}
-            <div className="flex items-start gap-4 mb-4">
-              <div className="flex-shrink-0">
-                <AlertTriangle className="w-8 h-8 text-red-500" />
-              </div>
-              <div className="flex-1">
-                <h3 className="text-lg font-semibold text-gray-900 dark:text-gray-100 mb-2">
-                  清空播放记录
-                </h3>
-                <p className="text-sm text-gray-600 dark:text-gray-400">
-                  确定要清空所有播放记录吗？此操作不可恢复。
-                </p>
-              </div>
-            </div>
-
-            {/* 按钮组 */}
-            <div className="flex gap-3 mt-6">
-              <button
-                onClick={() => setShowConfirmDialog(false)}
-                className="flex-1 px-4 py-2 text-sm font-medium text-gray-700 dark:text-gray-300 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 rounded-lg transition-colors"
-              >
-                取消
-              </button>
-              <button
-                onClick={handleClearConfirm}
-                className="flex-1 px-4 py-2 text-sm font-medium text-white bg-red-600 hover:bg-red-700 rounded-lg transition-colors"
-              >
-                确定清空
-              </button>
-            </div>
+                    )}
+                  </div>
+                );
+              })}
+            </VirtualScrollableRow>
          </div>
-        </div>
-      </div>,
-      document.body
-    )}
+        )}
+      </section>

-    {showPlayRecordsPanel && createPortal(
-      <PlayRecordsPanel
-        isOpen={showPlayRecordsPanel}
-        onClose={() => setShowPlayRecordsPanel(false)}
-      />,
-      document.body
-    )}
-  </>
+      {showConfirmDialog &&
+        createPortal(
+          <div
+            className='fixed inset-0 z-[9999] flex items-center justify-center bg-black bg-opacity-50 p-4 transition-opacity duration-300'
+            onClick={() => setShowConfirmDialog(false)}
+          >
+            <div
+              className='max-w-md w-full rounded-lg border border-red-200 bg-white shadow-xl transition-all duration-300 dark:border-red-800 dark:bg-gray-800'
+              onClick={(event) => event.stopPropagation()}
+            >
+              <div className='p-6'>
+                <div className='mb-4 flex items-start gap-4'>
+                  <div className='flex-shrink-0'>
+                    <AlertTriangle className='h-8 w-8 text-red-500' />
+                  </div>
+                  <div className='flex-1'>
+                    <h3 className='mb-2 text-lg font-semibold text-gray-900 dark:text-gray-100'>
+                      清空播放记录
+                    </h3>
+                    <p className='text-sm text-gray-600 dark:text-gray-400'>
+                      确定要清空所有播放记录吗？此操作不可恢复。
+                    </p>
+                  </div>
+                </div>
+
+                <div className='mt-6 flex gap-3'>
+                  <button
+                    onClick={() => setShowConfirmDialog(false)}
+                    className='flex-1 rounded-lg bg-gray-100 px-4 py-2 text-sm font-medium text-gray-700 transition-colors hover:bg-gray-200 dark:bg-gray-700 dark:text-gray-300 dark:hover:bg-gray-600'
+                  >
+                    取消
+                  </button>
+                  <button
+                    onClick={handleClearConfirm}
+                    className='flex-1 rounded-lg bg-red-600 px-4 py-2 text-sm font-medium text-white transition-colors hover:bg-red-700'
+                  >
+                    确定清空
+                  </button>
+                </div>
+              </div>
+            </div>
+          </div>,
+          document.body
+        )}
+
+      {showPlayRecordsPanel &&
+        createPortal(
+          <PlayRecordsPanel
+            isOpen={showPlayRecordsPanel}
+            onClose={() => setShowPlayRecordsPanel(false)}
+          />,
+          document.body
+        )}
+    </>
  );
 }
--- a/src/lib/changelog.ts
+++ b/src/lib/changelog.ts
@@ -10,6 +10,33 @@ export interface ChangelogEntry {
 }

 export const changelog: ChangelogEntry[] = [
+  {
+    version: "215.0.0",
+    date: "2026-03-20",
+    added: [
+    "增加主动恢复进度按钮",
+    "新增播放记录面板",
+    "弹幕搜索面板标题增加tooltip",
+    "影视搜索新增列表视图",
+    "pansou增加重试按钮",
+    "新增ai评论生成",
+    "增加一键render部署",
+    "电视直播增加三种代理模式"
+    ],
+    changed: [
+    "优化直链播放m3u8体验",
+    "搜索页面海量数据下使用虚拟滚动提高性能",
+    "优化emby代理内存泄漏问题",
+    "电视直播代理控制权从用户端改为管理端",
+    "获取视频源详情不再依赖title"
+    ],
+    fixed: [
+    "修复search页面僵尸历史记录tag",
+    "修复弹幕搜索框挤压",
+    "修复搜索页面加载条显示顺序错误",
+    "修复继续观看渐进式加载的一些问题"
+    ]
+  },
  {
    version: "214.1.0",
    date: "2026-03-10",
--- a/src/lib/db.client.ts
+++ b/src/lib/db.client.ts
@@ -716,6 +716,42 @@ export async function getAllPlayRecords(): Promise<Record<string, PlayRecord>> {
  }
 }

+export function getCachedPlayRecordsSnapshot(): Record<string, PlayRecord> {
+  if (typeof window === 'undefined') {
+    return {};
+  }
+
+  if (STORAGE_TYPE !== 'localstorage') {
+    const cachedRecords = cacheManager.getCachedPlayRecords();
+    if (cachedRecords) {
+      return cachedRecords;
+    }
+
+    try {
+      const username = getAuthInfoFromBrowserCookie()?.username;
+      if (!username) return {};
+
+      const raw = localStorage.getItem(`${CACHE_PREFIX}${username}`);
+      if (!raw) return {};
+
+      const userCache = JSON.parse(raw) as UserCacheStore;
+      return userCache.playRecords?.data || {};
+    } catch (err) {
+      console.error('读取用户播放记录快照失败:', err);
+      return {};
+    }
+  }
+
+  try {
+    const raw = localStorage.getItem(PLAY_RECORDS_KEY);
+    if (!raw) return {};
+    return JSON.parse(raw) as Record<string, PlayRecord>;
+  } catch (err) {
+    console.error('读取本地播放记录快照失败:', err);
+    return {};
+  }
+}
+
 /**
 * 保存播放记录。
 * 数据库存储模式下使用乐观更新：先更新缓存（立即生效），再异步同步到数据库。
--- a/src/lib/version.ts
+++ b/src/lib/version.ts
@@ -1,6 +1,6 @@
 /* eslint-disable no-console */

-const CURRENT_VERSION = '214.1.0';
+const CURRENT_VERSION = '215.0.0';

 // 导出当前版本号供其他地方使用
 export { CURRENT_VERSION };