feat: storybook stories

Author: wkylin

src/components/SmartVideoPlayer/SmartVideoPlayer.mdx

@@ -2,13 +2,39 @@
 title: SmartVideoPlayer
 ---
 
+import { Meta, Canvas, Story, ArgTypes, Controls } from '@storybook/addon-docs/blocks'
+import * as SmartVideoPlayerStories from './SmartVideoPlayer.stories'
+
+<Meta of={SmartVideoPlayerStories} />
+
 # SmartVideoPlayer
 
 统一的播放器封装（HTML5 / YouTube / Embed），内置设置面板、字幕/倍速、HLS（原生优先 + hls.js 动态加载）等能力。
 
 - “界面语言”只影响 SmartVideoPlayer 自身（不影响全站 i18n）
 - 语言通过 `localStorage: svpUiLanguage` 持久化（刷新后仍生效）
 
+## 组件预览
+
+<Canvas>
+  <Story of={SmartVideoPlayerStories.Html5Mp4} />
+</Canvas>
+
+<Canvas>
+  <Story of={SmartVideoPlayerStories.YouTube} />
+</Canvas>
+
+## Props（可调参数）
+
+<ArgTypes />
+
+<Controls />
+
+## 说明
+
+- “界面语言”只影响 SmartVideoPlayer 自身（不影响全站 i18n）
+- 语言通过 localStorage 的 svpUiLanguage 持久化（刷新后仍生效）
+
 ## 基本使用
 
 ### HTML5（MP4）

src/components/SmartVideoPlayer/SmartVideoPlayer.stories.tsx

@@ -26,8 +26,94 @@ const meta = {
   },
   argTypes: {
     provider: {
+      description: '播放提供方：HTML5 / YouTube / Embed。不同 provider 会使用不同的输入参数。',
       control: { type: 'select' },
       options: ['html5', 'youtube', 'embed'],
+      table: { type: { summary: '"html5" | "youtube" | "embed"' } },
+    },
+
+    title: {
+      description: '标题（用于可访问性/Embed iframe title/文案展示）。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' } },
+    },
+
+    src: {
+      description: 'HTML5 视频地址（MP4 / HLS m3u8）。仅 provider=html5 时生效。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' } },
+    },
+
+    youtubeId: {
+      description: 'YouTube 视频 ID。仅 provider=youtube 时生效。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' } },
+    },
+
+    embedUrl: {
+      description: 'Embed iframe URL。仅 provider=embed 时生效。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' } },
+    },
+
+    getEmbedUrl: {
+      description: '动态生成 embed URL：getEmbedUrl(config) => string。优先级高于 embedUrl/youtubeId。',
+      control: false,
+      table: { type: { summary: '(config) => string' } },
+    },
+
+    externalUrl: {
+      description: '点击“新窗口打开”时使用的外部 URL（优先级高于 sourceUrl/自动推导）。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' } },
+    },
+
+    sourceUrl: {
+      description: '源地址/落地页 URL（用于“新窗口打开”的兜底）。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' } },
+    },
+
+    trackSrc: {
+      description: '字幕 VTT 地址（可选）。未传时会尝试从 mp4 src 推导同名 .vtt。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' } },
+    },
+
+    trackLang: {
+      description: '字幕语言（用于 track srcLang/label）。',
+      control: { type: 'text' },
+      table: { type: { summary: 'string' }, defaultValue: { summary: '"en"' } },
+    },
+
+    initialConfig: {
+      description: '初始配置（非受控）。包含：lazyPlay/miniPlayer/autoPlay/autoMute/playbackRate/ytControls。',
+      control: { type: 'object' },
+      table: { type: { summary: 'Partial<Config>' } },
+    },
+
+    config: {
+      description: '受控配置（传入即受控）。',
+      control: { type: 'object' },
+      table: { type: { summary: 'Config' } },
+    },
+
+    onConfigChange: {
+      description: '受控模式下配置变化回调。',
+      control: false,
+      table: { type: { summary: '(nextConfig) => void' } },
+    },
+
+    onError: {
+      description: '播放错误回调（含 provider/src/youtubeId/embedUrl 等上下文）。',
+      control: false,
+      table: { type: { summary: '(err) => void' } },
+    },
+
+    onEvent: {
+      description: '可观测事件回调（例如 play/pause/seek/hlsError/embedTimeout 等）。',
+      control: false,
+      table: { type: { summary: '(name, detail) => void' } },
     },
   },
   render: (args) => {