LanMountainDesktop/LanMontainDesktop/.trae/specs/remove-video-wallpaper-feature/tasks.md

移除视频壁纸功能 - 编码任务清单

任务概览

本文档将技术设计分解为可执行的编码任务，按依赖关系排序执行。

---

任务 1: 移除项目依赖

优先级: P0 (最高)
依赖: 无
预估工作量: 5 分钟

描述

从项目文件中移除 LibVLC 相关的 NuGet 包引用。

输入

• LanMountainDesktop/LanMountainDesktop.csproj

输出

• 修改后的 LanMountainDesktop.csproj，移除以下包引用：
  • LibVLCSharp.Avalonia
  • VideoLAN.LibVLC.Windows
  • VideoLAN.LibVLC.Mac

验收标准

• 项目文件中不再包含 LibVLC 相关包引用
• 执行 dotnet restore 成功

执行提示

编辑 LanMountainDesktop.csproj，移除以下 PackageReference 节点：
1. <PackageReference Include="LibVLCSharp.Avalonia" Version="3.9.5" />
2. <PackageReference Include="VideoLAN.LibVLC.Windows" ... />
3. <PackageReference Include="VideoLAN.LibVLC.Mac" ... />

---

任务 2: 移除主窗口 XAML 视频控件

优先级: P0
依赖: 任务 1
预估工作量: 10 分钟

描述

从 MainWindow.axaml 中移除视频壁纸相关的 XAML 控件和命名空间声明。

输入

• LanMountainDesktop/Views/MainWindow.axaml

输出

• 移除 LibVLC 命名空间声明
• 移除 DesktopVideoWallpaperImage 控件
• 移除 DesktopVideoWallpaperView 控件

验收标准

• XAML 中无 xmlns:vlc 命名空间
• XAML 中无 DesktopVideoWallpaperImage 元素
• XAML 中无 DesktopVideoWallpaperView 元素

执行提示

编辑 MainWindow.axaml：
1. 移除第 9 行: xmlns:vlc="clr-namespace:LibVLCSharp.Avalonia;assembly=LibVLCSharp.Avalonia"
2. 移除第 126-131 行: <Image x:Name="DesktopVideoWallpaperImage" ... />
3. 移除第 133-137 行: <vlc:VideoView x:Name="DesktopVideoWallpaperView" ... />

---

任务 3: 移除主窗口代码视频字段

优先级: P0
依赖: 任务 1
预估工作量: 15 分钟

描述

从 MainWindow.axaml.cs 中移除视频壁纸相关的字段声明。

输入

• LanMountainDesktop/Views/MainWindow.axaml.cs

输出

• 移除 SupportedVideoExtensions 静态字段
• 移除所有视频相关实例字段

验收标准

• 无 SupportedVideoExtensions 字段
• 无 _videoWallpaperPosterBitmap 字段
• 无 _videoWallpaperPosterPath 字段
• 无 _wallpaperVideoPath 字段
• 无 _libVlc 字段
• 无 _videoWallpaperPlayer 字段
• 无 _videoWallpaperMedia 字段
• 无 _desktopVideoFrameSync 及相关视频帧处理字段

执行提示

编辑 MainWindow.axaml.cs：
1. 移除第 68-71 行的 SupportedVideoExtensions 定义
2. 移除第 123-146 行的所有视频相关字段

---

任务 4: 移除主窗口 OnClosed 清理代码

优先级: P0
依赖: 任务 3
预估工作量: 5 分钟

描述

从 MainWindow.axaml.cs 的 OnClosed 方法中移除视频相关清理代码。

输入

• LanMountainDesktop/Views/MainWindow.axaml.cs (OnClosed 方法)

输出

• 简化的 OnClosed 方法，无视频清理逻辑

验收标准

• OnClosed 方法中无 StopVideoWallpaper() 调用
• OnClosed 方法中无 _videoWallpaperMedia 相关清理
• OnClosed 方法中无 _videoWallpaperPlayer 相关清理
• OnClosed 方法中无 _libVlc 相关清理

执行提示

编辑 MainWindow.axaml.cs 的 OnClosed 方法，移除以下代码行：
- StopVideoWallpaper();
- _videoWallpaperMedia?.Dispose(); _videoWallpaperMedia = null;
- _videoWallpaperPlayer?.Dispose(); _videoWallpaperPlayer = null;
- _desktopVideoFrameRefreshTimer?.Stop(); _desktopVideoFrameRefreshTimer = null;
- _videoWallpaperPosterBitmap?.Dispose(); _videoWallpaperPosterBitmap = null;
- _videoWallpaperPosterPath = null;
- _libVlc?.Dispose(); _libVlc = null;

---

任务 5: 移除主窗口 Stub 方法

优先级: P0
依赖: 任务 1
预估工作量: 20 分钟

描述

从 MainWindow.SettingsHardCut.Stubs.cs 中移除视频壁纸相关方法和 using 声明。

输入

• LanMountainDesktop/Views/MainWindow.SettingsHardCut.Stubs.cs

输出

• 移除 LibVLC using 声明
• 移除 StartVideoWallpaper 方法
• 移除 StopVideoWallpaper 方法
• 移除 TryCaptureVideoWallpaperPosterFrame 方法
• 移除 ApplyVideoWallpaperPosterVisibility 方法

验收标准

• 无 using LibVLCSharp.Shared;
• 无 using LibVLCSharp.Avalonia;
• 无 StartVideoWallpaper 方法定义
• 无 StopVideoWallpaper 方法定义
• 无 TryCaptureVideoWallpaperPosterFrame 方法定义
• 无 ApplyVideoWallpaperPosterVisibility 方法定义

执行提示

编辑 MainWindow.SettingsHardCut.Stubs.cs：
1. 移除第 19-20 行的 using 声明
2. 移除 StartVideoWallpaper 方法（第 337-383 行）
3. 移除 StopVideoWallpaper 方法（第 385-395 行）
4. 移除 ApplyVideoWallpaperPosterVisibility 方法（第 647-664 行）
5. 移除 TryCaptureVideoWallpaperPosterFrame 方法（第 666-751 行）

---

任务 6: 简化壁纸状态处理逻辑

优先级: P0
依赖: 任务 5
预估工作量: 15 分钟

描述

修改 MainWindow.SettingsHardCut.Stubs.cs 中的壁纸状态处理方法，移除视频类型分支。

输入

• LanMountainDesktop/Views/MainWindow.SettingsHardCut.Stubs.cs

输出

• 简化的 SetWallpaperState 方法
• 简化的 UpdateWallpaperDisplay 方法
• 简化的 ApplyWallpaperBrush 方法

验收标准

• SetWallpaperState 中无视频类型检测分支
• SetWallpaperState 中无 _wallpaperVideoPath 赋值
• UpdateWallpaperDisplay 中无 StopVideoWallpaper() 调用
• ApplyWallpaperBrush 中无 ApplyVideoWallpaperPosterVisibility 调用

执行提示

编辑 MainWindow.SettingsHardCut.Stubs.cs：

1. SetWallpaperState 方法：
   - 移除 requestedTypeIsVideo 变量定义
   - 移除视频类型检测 if 块（SupportedVideoExtensions.Contains 检查）

2. UpdateWallpaperDisplay 方法：
   - 移除视频类型分支，仅保留 ApplyWallpaperBrush() 调用

3. ApplyWallpaperBrush 方法：
   - 移除所有 ApplyVideoWallpaperPosterVisibility 调用

---

任务 7: 移除外观主题服务视频提取器

优先级: P1
依赖: 任务 1
预估工作量: 10 分钟

描述

从 AppearanceThemeService.cs 中移除视频壁纸种子提取器接口和实现类。

输入

• LanMountainDesktop/Services/AppearanceThemeService.cs

输出

• 移除 IVideoWallpaperSeedExtractor 接口
• 移除 LibVlcVideoWallpaperSeedExtractor 类

验收标准

• 无 IVideoWallpaperSeedExtractor 接口定义
• 无 LibVlcVideoWallpaperSeedExtractor 类定义

执行提示

编辑 AppearanceThemeService.cs：
移除第 92-184 行的接口和类定义：
- IVideoWallpaperSeedExtractor 接口
- LibVlcVideoWallpaperSeedExtractor 类

---

任务 8: 简化壁纸设置页面 XAML

优先级: P1
依赖: 无
预估工作量: 10 分钟

描述

从 WallpaperSettingsPage.axaml 中移除视频预览区域和相关 UI 元素。

输入

• LanMountainDesktop/Views/SettingsPages/WallpaperSettingsPage.axaml

输出

• 移除视频预览 Border 区域
• 移除视频模式提示 TextBlock
• 修改填充方式可见性绑定

验收标准

• 无视频预览 Border（IsVisible="{Binding IsVideo}"）
• 无 VideoModeHintText 绑定的 TextBlock
• 填充方式设置绑定改为 IsVisible="{Binding IsImage}"

执行提示

编辑 WallpaperSettingsPage.axaml：
1. 移除第 29-44 行的视频预览 Border
2. 移除第 150-154 行的视频模式提示 TextBlock
3. 修改第 132 行: IsVisible="{Binding IsImageOrVideo}" 改为 IsVisible="{Binding IsImage}"

---

任务 9: 简化壁纸设置 ViewModel

优先级: P1
依赖: 任务 8
预估工作量: 15 分钟

描述

从 WallpaperSettingsPageViewModel.cs 中移除视频相关属性和方法逻辑。

输入

• LanMountainDesktop/ViewModels/WallpaperSettingsPageViewModel.cs

输出

• 移除 _isImageOrVideo、_isVideo、_videoModeHintText 属性
• 修改 CreateWallpaperTypes 方法
• 修改 UpdateVisibility 方法
• 修改 RefreshLocalizedText 方法

验收标准

• 无 IsImageOrVideo 属性
• 无 IsVideo 属性
• 无 VideoModeHintText 属性
• CreateWallpaperTypes 仅返回 Image 和 SolidColor 选项
• UpdateVisibility 中无 IsVideo、IsImageOrVideo 赋值
• RefreshLocalizedText 中无 VideoModeHintText 赋值

执行提示

编辑 WallpaperSettingsPageViewModel.cs：
1. 移除第 76-77 行的 _isImageOrVideo 字段和属性
2. 移除第 85-86 行的 _isVideo 字段和属性
3. 移除第 94-95 行的 _videoModeHintText 字段和属性
4. 修改 CreateWallpaperTypes 方法，移除 Video 选项
5. 修改 UpdateVisibility 方法，移除 IsVideo 和 IsImageOrVideo 赋值
6. 修改 RefreshLocalizedText 方法，移除 VideoModeHintText 赋值

---

任务 10: 简化壁纸媒体类型枚举

优先级: P1
依赖: 无
预估工作量: 5 分钟

描述

从 SettingsContracts.cs 中移除 WallpaperMediaType 枚举的 Video 值。

输入

• LanMountainDesktop/Services/Settings/SettingsContracts.cs

输出

• 简化的 WallpaperMediaType 枚举

验收标准

• WallpaperMediaType 枚举仅包含 None 和 Image

执行提示

编辑 SettingsContracts.cs：
修改第 11-16 行的枚举定义：
public enum WallpaperMediaType
{
    None,
    Image
}

---

任务 11: 简化壁纸媒体服务

优先级: P1
依赖: 任务 10
预估工作量: 10 分钟

描述

从 SettingsDomainServices.cs 中移除视频扩展名检测逻辑。

输入

• LanMountainDesktop/Services/Settings/SettingsDomainServices.cs

输出

• 移除 VideoExtensions 字段
• 简化 DetectMediaType 方法

验收标准

• 无 VideoExtensions 字段定义
• DetectMediaType 方法中无视频扩展名检测逻辑

执行提示

编辑 SettingsDomainServices.cs：
1. 移除第 150-153 行的 VideoExtensions 字段定义
2. 修改 DetectMediaType 方法，移除视频检测分支

---

任务 12: 清理本地化文件

优先级: P2
依赖: 无
预估工作量: 5 分钟

描述

从 zh-CN.json 中移除视频壁纸相关的本地化文本。

输入

• LanMountainDesktop/Localization/zh-CN.json

输出

• 移除视频相关本地化键
• 修改壁纸描述文本

验收标准

• 无 settings.wallpaper.type.video 键
• 无 settings.wallpaper.video_applied 键
• 无 settings.wallpaper.video_mode 键
• 无 settings.wallpaper.video_restored 键
• 无 settings.wallpaper.video_not_found 键
• 无 settings.wallpaper.video_player_unavailable 键
• 无 settings.wallpaper.video_play_failed_format 键
• settings.wallpaper.description 文本已更新

执行提示

编辑 zh-CN.json：
1. 移除以下键值对：
   - "settings.wallpaper.type.video"
   - "settings.wallpaper.video_applied"
   - "settings.wallpaper.video_mode"
   - "settings.wallpaper.video_restored"
   - "settings.wallpaper.video_not_found"
   - "settings.wallpaper.video_player_unavailable"
   - "settings.wallpaper.video_play_failed_format"

2. 修改描述文本：
   "settings.wallpaper.description": "选择图片后可立即设为应用窗口壁纸。"

---

任务 13: 构建验证

优先级: P0
依赖: 任务 1-12 全部完成
预估工作量: 10 分钟

描述

验证项目在移除视频壁纸功能后能够正常构建。

输入

• 整个项目

输出

• 构建成功确认

验收标准

• dotnet build 执行成功，无编译错误
• 无 LibVLC 相关类型未定义错误
• 无未使用变量警告（或已处理）

执行提示

在项目根目录执行：
dotnet build LanMountainDesktop/LanMountainDesktop.csproj

检查输出：
- 确认无编译错误
- 确认无 LibVLC 相关类型引用错误

---

任务 14: 功能验证

优先级: P0
依赖: 任务 13
预估工作量: 15 分钟

描述

验证应用在移除视频壁纸功能后核心功能正常工作。

输入

• 构建后的应用

输出

• 功能验证报告

验收标准

• 应用正常启动
• 图片壁纸正常显示
• 纯色壁纸正常显示
• 壁纸设置页面正常打开
• 类型选择器仅显示"图片"和"纯色"选项
• 壁纸导入功能正常工作

执行提示

运行应用：
dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj

手动验证：
1. 应用启动无崩溃
2. 打开设置 -> 壁纸页面
3. 确认类型选择器仅有"图片"和"纯色"
4. 测试选择图片壁纸
5. 测试选择纯色壁纸

---

任务依赖关系图

任务 1 (移除依赖)
  ├── 任务 2 (XAML控件)
  ├── 任务 3 (代码字段)
  │     └── 任务 4 (OnClosed清理)
  ├── 任务 5 (Stub方法)
  │     └── 任务 6 (状态处理逻辑)
  └── 任务 7 (主题服务)

任务 8 (设置页面XAML)
  └── 任务 9 (设置ViewModel)

任务 10 (枚举简化)
  └── 任务 11 (媒体服务)

任务 12 (本地化) - 独立

任务 13 (构建验证) - 依赖所有任务
  └── 任务 14 (功能验证)

---

执行顺序建议

按以下顺序执行可确保依赖关系正确：

1. 第一批 (可并行): 任务 1, 任务 8, 任务 10, 任务 12
2. 第二批 (可并行): 任务 2, 任务 3, 任务 5, 任务 7, 任务 9, 任务 11
3. 第三批 (可并行): 任务 4, 任务 6
4. 第四批: 任务 13
5. 第五批: 任务 14