合并对设置系统的更新 (#11)

* Add Windows system chrome patchers (Harmony)

Introduce support for toggling the system chrome on Windows using Harmony patchers. Adds Lib.Harmony.Thin to package props and project, new patcher infrastructure (ChromePatchState, PatcherEntrance) and two Harmony patches that disable FluentAvalonia's Windows chrome when configured. Program.cs now loads the chrome setting and installs patchers conditionally on Windows/x86-x64. Settings viewmodel and view updated: expose IsWindowsOs, require restart on appearance changes, migrate SettingsWindow to FAAppWindow and adapt titlebar/layout (include Windows caption placeholder and footer menu items). Also add a .gitkeep and a build log file.

* Refactor settings window UI and theming

Improve theming and layout for the Settings window and related services.

- MaterialSurfaceService: add special material parameters for SettingsWindowBackground (lower alpha, no blur) and avoid hot-switching real backdrops for non-settings windows.
- GlassEffectService: add AdaptiveSettingsWindowTintBrush + ResolveSettingsWindowTintAlpha to provide optional content tinting tied to system material mode.
- SettingsWindowService: refactor theme application into ApplyThemeVariantAndResources, ensure settings window material is applied at show/activate times, and tidy theme/resource application flow.
- SettingsWindow.axaml / .axaml.cs: restructure title bar (separate Grid.Row=0 border) and FANavigationView host, add pane-footer toggle button for :minimal layout, use dynamic corner radius resource, and update toggle/visibility/icon logic and responsive layout code.
- SettingsPages: remove some IconText usages and adjust margins; use DesignCornerRadiusLg for update card corner radius.
- Add NuGet.Config to set local globalPackagesFolder and ignore .nuget/packages in .gitignore.

These changes aim to improve visuals, avoid backdrop overdraw, and make the settings window behavior consistent across themes and layouts.

* Add localization and localize settings pages

Add many new localization keys (en-US and zh-CN) for notifications, developer tools, about page, status bar, and video wallpaper. Update Notification, Dev, About and StatusBar view models to use LocalizationService, expose localized ObservableProperties, and refresh localized text at construction. Localize selection options and test notification texts, and fix notification severity handling. Wire up XAML to the new localized properties (About/Dev/StatusBar pages) and update the settings page title for notifications. Also adjust copyright line generation and replace hardcoded placeholders with bound Watermark properties.

* Redesign settings window with fluent shell & search

Rebuild the settings window as a Fluent shell: adds a custom 48-DIP titlebar with Back, pane toggle, icon/title, search box, restart/more menu, and caption-button spacer; moves compact pane toggle into the titlebar and preserves FANavigationView as the primary navigation surface. Introduces a SettingsSearchService (with UI AutoComplete integration, search indexing, navigation-by-result, and search result highlighting) plus focused tests for search filtering and theme material normalization. Adds navigation history/back stack, updates SettingsViewModels for new bindings and localization keys, and updates General/Apearance pages to expose new strings and options. Implements an "auto" system material mode: default in AppSettingsSnapshot, new MaterialAuto constants and normalization/resolution logic in ThemeAppearanceValues, WindowMaterialService and MaterialSurfaceService adjustments to prefer Mica on Win11 and Acrylic on Win10 using TransparencyLevelHint. GlassEffectService and AppearanceThemeService updated to use effective material mode and to track live theme state changes. Adds localization entries (en-US, zh-CN), spec/tasks docs, and other UI/style tweaks to support the redesign.

* fix.修折叠与展开按钮

* Add OOBE startup presentation and settings merge

Introduce a new OOBE step for "Startup & Presentation" that exposes startup and UI preferences in OobeWindow (toggles for taskbar, slide/fade transitions, fused popup, and autostart). Add HostAppSettingsOobeMerger to read/write Host settings.json (PascalCase fields) and MergeStartupPresentation behavior, plus LauncherWindowsStartupService to sync the current Launcher into the Windows Run key on Windows. Wire UI handlers, persist choices on Next, and load defaults when entering the step. Include unit tests for the merger, adjust SettingsWindow navigation pane/toggle handling, and update docs/LAUNCHER.md to describe the new OOBE step and implementation files.

* Move whiteboard persistence to file storage

Switch whiteboard note storage from legacy DB rows to per-note JSON files and add migration support. Update WhiteboardNoteSnapshot schema (version bump, viewport, canvas, expires, PathSvgData) and change IWhiteboardNotePersistenceService.SaveNote to return bool to surface write failures (e.g. read-only files). Implement file-based WhiteboardNotePersistenceService with legacy DB migration/cleanup, retention handling, and logging. Add comprehensive unit tests for persistence, stroke path builder, SVG import and viewport helper. Also add ThirdParty/DotNetCampus.InkCanvas project and reference it in the main csproj, and bump PostHog package to 2.6.0.

* Introduce render gate and chart caching

Replace UI DispatcherTimer polling with a StudySnapshotRenderGate across multiple widgets to queue and apply only the latest analytics snapshot; components updated include StudyDeductionReasonsWidget, StudyEnvironmentWidget, StudyInterruptDensityWidget, StudyNoiseCurveWidget. Add StudySnapshotRenderGate implementation to coordinate rendering and monitoring leases and update subscription/lease lifecycle handling (subscribe/unsubscribe, Acquire/Dispose leases, Clear/Dispose gate). Rewrite chart controls (StudyNoiseCurveChartControl and StudyNoiseDistributionScatterChartControl) to use stable logical-time origins, split series into static vs dynamic tails, add geometry/sample caching, stable jitter/coordinate mapping helpers, and expose internal helpers & counts for testing. Add unit tests (StudyComponentRenderingTests) covering the render gate and chart behaviors (layer counts, logical X mapping, stable jitter, cache rebuild). These changes improve rendering correctness and performance by avoiding redundant renders and enabling deterministic chart layout.

* Use MaterialColorSnapshot in appearance flow

Introduce unified material/color spec and tests, and refactor appearance plumbing to use MaterialColorSnapshot as the single source of truth. Add .trae material-color-service spec/checklist/tasks and integration/unit tests for plugin mapping and appearance VM behavior. AppearanceChangedEvent extended with new appearance change flags and HasChanged logic. ComponentEditorMaterialThemeAdapter rewritten to accept MaterialColorSnapshot and derive palette from snapshot data. Simplify AppearanceSettingsPageViewModel and related view code: remove legacy preview/custom-seed UI logic, preserve material/color fields when updating theme or corner radius, and update save calls to use with-expressions. Update ComponentEditorWindow to use adapter-provided OnPrimary brush and minor docs updates.

* Add material color services, plugin DTOs, and tests

Introduce IPC wire-format appearance DTOs (PluginIsolation.Contracts) and clarify they are distinct from the runtime PluginSdk snapshot. Update PluginSdk comments to document the runtime-facing snapshot shape. Change ComponentColorSchemeHelper to use the HostMaterialColorProvider and add an overload that accepts a MaterialColorSnapshot. Add new services and pipelines (MaterialColorService, MaterialSurfaceService, WindowMaterialService, WallpaperColorPipeline) and refactor AppearanceThemeService to depend on MaterialColorService while removing legacy internal implementations. Add multiple unit tests (ComponentColorSchemeHelper, PluginAppearanceBoundary, SettingsCatalogService, WallpaperSettingsPageViewModel) and update localization resources with new material_color and wallpaper keys.

* Add CODE_WIKI and update localization

Add a comprehensive CODE_WIKI.md documenting project architecture, modules, startup flow, plugin system, testing and developer workflows. Update localization resources (en-US.json, zh-CN.json) with new/translated keys for wallpaper controls (custom color UI), material & color settings (semantic roles, surfaces, refresh/polling state), appearance (corner radius), status bar font size options, privacy policy text, component library labels, clock settings, and new language entry (Korean). Also modify settings-related ViewModels and Settings page views to surface these new features and texts (MaterialColorSettingsPageViewModel.cs, SettingsViewModels.cs, WallpaperSettingsPageViewModel.cs, MainWindow.SettingsHardCut.Stubs.cs, ComponentsSettingsPage.axaml, WallpaperSettingsPage.axaml).

* Add Data settings page and storage scanner

Introduce a new "Data" settings page to visualize and manage local app storage. Adds DataStorageService (scanning, disk info, clean operations), DataSettingsPageViewModel, XAML view and code-behind, and HexToColor/HexToBrush converters; registers converters in App.axaml. Also update localization strings for the new page and add icon mapping so the settings entry uses the Database icon. Enables per-category and global cleaning workflows and formatted size display.

* Add IPC backoff/retries and safer disposal

Introduce exponential backoff, jitter and retry logic across IPC components to improve robustness and avoid tight retry loops; make disposal idempotent and add connection guards. Key changes:
- LauncherCoordinatorIpcServer / LauncherIpcServer: add backoff constants, ComputeBackoff(), consecutive error tracking and delayed retries with jitter.
- LanMountainDesktopIpcClient / LauncherIpcClient: add connect retry loops, timeouts, delayed retries, improved error logging, and use ArrayPool for buffered async writes; ensure proper cleanup on failures.
- PublicIpcHostService: add disposed flag, guard OnPeerConnected and Dispose, and clear connected peers on dispose.
- Add many auto-generated commit analysis docs under docs/auto_commit_md and new scripts for analyzing/generating commit docs.
These changes aim to make IPC connection handling more resilient and resource-safe.

* Add preview controls and settings UI tweaks

Introduce GridPreviewControl and CornerRadiusPreviewControl for visual previews and wire them into the Components settings (add ScreenAspectRatio, CornerRadiusPreviewValue, and screen aspect init). Refactor ComponentsSettingsPage UI to show live previews. Improve DataSettingsPage layout and storage bar logic (use item percentages directly, include remaining segment, adjust visuals and visibility triggers). Simplify LauncherSettingsPage header/appearance layout. Add SECURITY_AUDIT_REPORT.md, analysis summary, mockup HTML, and a local .claude settings file.

* Add install checkpoint/resume and DDSS workflows

Introduce install checkpoint support and resume logic for updates, plus related locking and validation. Adds InstallCheckpoint model, AppJsonContext serialization, and UpdatePaths helpers for deployment lock, apply-in-progress lock and install-checkpoint path. UpdateEngineService gains checkpoint load/save/delete, incoming-state validation, resume logic for PLONDS and legacy updates, apply lock handling, and safer cleanup; ApplyPendingPlondsUpdateAsync and ApplyPendingUpdate flow updated accordingly. Add DeploymentLock contract and extend UpdateState with pause/resume/cancel helpers. Tests updated to cover stale/valid checkpoint resume and legacy/PLONDS flows. CI: enhance ddss-publish to detect release channel, validate S3 assets, prepare and atomically publish channel pointer; add ddss-rollback workflow to publish rollbacks; adjust plonds-build concurrency and release events.

* changed.更了好多

* fix.消息盒子媒体播放器组件服务修复

* change.重做天气，为回到系统提供自定义功能。

* feat.airapp与融合桌面

* feat.动画优化与更新界面

* feat.数字时钟，白板功能修复

* feat.完善了时钟轻应用，为启动器提供了多语言支持

* feat.发布与打包优化

* changed.天气选项卡更新

docs/auto_commit_md/20260513_ada0cd4.md

@@ -0,0 +1,390 @@
+# Git 提交分析报告
+
+## 📋 提交基本信息
+
+| 属性 | 值 |
+|------|-----|
+| **提交哈希** | `ada0cd4a3a627107f2f80d910f3195a05f11a582` |
+| **短哈希** | `ada0cd4` |
+| **作者** | lincube <lincube3@hotmail.com> |
+| **提交时间** | 2026-05-13 07:42:42 +0800 |
+| **提交分支** | (当前分支) |
+
+## 📝 提交信息
+
+```
+change.重做天气，为回到系统提供自定义功能。
+```
+
+## 📊 变更统计
+
+| 指标 | 数值 |
+|------|------|
+| **修改文件总数** | 242 个 |
+| **新增代码行数** | +3,988 行 |
+| **删除代码行数** | -30 行 |
+| **净增行数** | +3,958 行 |
+
+### 文件类型分布
+
+| 文件类型 | 数量 | 说明 |
+|---------|------|------|
+| **新增文件** | ~200+ | 主要为天气图标资源文件 |
+| **新增 .md 文档** | 5 | 设计文档和规范 |
+| **新增 .cs 代码文件** | 15+ | 核心天气组件和服务 |
+| **修改 .cs 代码文件** | 8 | 现有代码调整 |
+| **修改 .json 本地化文件** | 4 | 多语言支持 |
+| **新增 .axaml UI 文件** | 10+ | 天气组件界面 |
+| **二进制资源文件** | ~190+ | 各类天气图标 PNG |
+
+## 🔍 详细变更分析
+
+### 1. 设计文档和规范 (新增)
+
+#### 新增文档文件
+
+- `.trae/documents/weather-widget-material-redesign.md` (+559 行)
+  - 天气组件 Material Design 重新设计规范
+  - 包含视觉设计指南和实现细节
+
+- `.trae/documents/weather-widget-visual-redesign.md` (+342 行)
+  - 天气组件视觉重新设计文档
+  - 涵盖图标风格和主题系统
+
+- `.trae/tasks/dock-back-to-windows-button-display/spec.md` (+29 行)
+  - "回到系统"按钮显示功能规范
+  - 为桌面组件提供自定义返回系统功能
+
+- `.trae/tasks/weather-widget-restyle/checklist.md` (+13 行)
+  - 天气组件样式重构任务清单
+
+#### Desktop Component Render Mode Tests
+
+- `LanMountainDesktop.Tests/DesktopComponentRenderModeTests.cs` (+44 行)
+  - 新增桌面组件渲染模式测试
+  - 涵盖 Live、Design、Preview 等模式
+
+### 2. 天气图标资源包 (大量新增)
+
+#### breezy 风格图标集 (约 70 个文件)
+包含完整的天气状态图标，包括：
+- 晴天 (clear_day/night)
+- 多云 (cloudy/partly_cloudy)
+- 雨天 (rain/thunderstorm)
+- 雪天 (snow/sleet)
+- 雾天 (fog/haze)
+- 大风 (wind)
+- 冰雹 (hail)
+- 每种状态提供多种变体和尺寸 (mini_dark/grey/light)
+
+#### geometric 风格图标集 (约 14 个文件)
+几何风格的天气图标
+
+#### google-weather-v4 风格图标集 (约 65 个文件)
+Google 天气风格第四版图标
+
+#### lemon-flutter 风格图标集 (约 18 个文件)
+Lemon Flutter 应用风格图标
+
+#### 资源元数据
+- `NOTICE.md` - 资源版权声明
+- `SOURCE.md` - 资源来源说明
+
+### 3. 核心服务层变更
+
+#### WeatherIconAssetResolver.cs (新增 +235 行)
+
+**功能职责**：
+- 天气图标资源解析和加载
+- 支持多种图标风格切换
+- 运行时图标资源动态加载
+
+**关键方法**：
+- `LoadIcon()` - 根据样式和天气条件加载图标
+- `ResolveIconKey()` - 解析图标键值
+- 支持动态图标包 ID 规范化
+
+#### WeatherVisualStyleCatalog.cs (新增 +77 行)
+
+**功能职责**：
+- 天气视觉样式目录管理
+- 样式定义和配置
+- 默认样式和可用样式列表
+
+**关键类**：
+- `WeatherVisualStyleCatalog` - 样式目录
+- `WeatherVisualStyle` - 样式定义
+- `WeatherVisualStyleId` - 样式 ID 常量
+
+#### SettingsDomainServices.cs (修改 -3 行)
+
+- 集成新的天气图标包设置
+
+#### WeatherLocationRefreshService.cs (修改 -3 行)
+
+- 优化位置刷新逻辑
+
+### 4. ViewModel 层变更
+
+#### WeatherSettingsPageViewModel.cs (大规模修改 +280 行/-60 行)
+
+**新增功能**：
+- 天气视觉样式选择器
+- 图标包切换功能
+- 实时预览图标更新
+
+**关键变更**：
+```csharp
+// 新增视觉样式相关属性和方法
+VisualStyleHeader/Description
+SelectedVisualStyle
+VisualStyles 列表
+CreateVisualStyles() 方法
+UpdatePreviewIcon() 方法
+```
+
+**设置持久化**：
+- 将 `IconPackId` 从硬编码 `"DefaultWeather"` 改为用户可选择的 `SelectedVisualStyle?.Value`
+- 支持设置导入/导出的图标包配置
+
+### 5. UI 组件层 (大量新增)
+
+#### WeatherWidgetBase.cs (核心基类 +423 行)
+
+**功能职责**：
+- 所有天气组件的抽象基类
+- 统一的数据流和状态管理
+- 响应式布局支持
+
+**核心特性**：
+- **状态管理**：`Loading`、`Ready`、`MissingLocation`、`Error`、`Preview`
+- **生命周期**：自动订阅设置变更、刷新定时器管理
+- **响应式设计**：支持单元格大小自适应 (`ApplyCellSize`)
+- **多模式支持**：
+  - `DesktopComponentRenderMode.Live` - 实时数据
+  - `DesktopComponentRenderMode.Design` - 设计预览
+  - `DesktopComponentRenderMode.Preview` - 静态预览
+
+**接口实现**：
+- `IDesktopComponentWidget`
+- `IDesktopPageVisibilityAwareComponentWidget`
+- `IWeatherInfoAwareComponentWidget`
+- `IComponentRuntimeContextAware`
+- `IComponentPlacementContextAware`
+- `IComponentChromeContextAware`
+
+#### MaterialWeatherSceneControl.cs (场景控制 +382 行)
+
+**功能职责**：
+- Material Design 天气场景渲染控制
+- 动态主题应用
+- 动画状态管理
+
+#### MaterialWeatherVisualTheme.cs (视觉主题 +248 行)
+
+**功能职责**：
+- 天气主题系统
+- 调色板管理
+- 条件解析
+
+**关键枚举**：
+- `MaterialWeatherCondition` - 天气状况
+- `MaterialWeatherPalette` - 颜色调色板
+
+#### WeatherWidget.axaml + WeatherWidget.axaml.cs (主天气组件 +48/+26 行)
+
+继承自 `WeatherWidgetBase` 的主天气组件实现
+
+#### ExtendedWeatherWidget.axaml + .cs (扩展天气组件 +30/+118 行)
+
+扩展功能天气组件
+
+#### HourlyWeatherWidget.axaml + .cs (小时天气组件 +27/+81 行)
+
+逐小时天气预报组件
+
+#### MultiDayWeatherWidget.axaml + .cs (多日天气组件 +24/+88 行)
+
+多日天气预报组件
+
+#### WeatherClockWidget.axaml + .cs (天气时钟组件 +24/+88 行)
+
+集成时钟的天气组件
+
+#### WeatherIconView.cs (图标视图 +30 行)
+
+通用天气图标显示组件
+
+### 6. 设置页面
+
+#### GeneralSettingsPage.axaml (扩展 +115 行)
+
+新增通用设置页面内容
+
+#### WeatherSettingsPage.axaml (扩展 +19 行)
+
+新增天气设置页面内容
+
+### 7. 主窗口和系统集成
+
+#### MainWindow.axaml (扩展 +13 行)
+
+- 新增天气组件引用
+
+#### MainWindow.axaml.cs (大规模修改 +175 行)
+
+- 天气组件初始化和配置
+- 组件注册和管理
+
+#### MainWindow.ComponentSystem.cs (扩展 +5 行)
+
+- 组件系统集成
+
+#### MainWindow.SettingsHardCut.Stubs.cs (修改 -36 行)
+
+- 设置硬切存根调整
+
+#### DesktopComponentRuntimeRegistry.cs (扩展 +20 行)
+
+- 桌面组件运行时注册
+
+### 8. 本地化更新
+
+#### 多语言文件更新
+
+| 语言 | 变更 |
+|------|------|
+| **zh-CN.json** | -22 行 |
+| **en-US.json** | -24 行 |
+| **ja-JP.json** | -22 行 |
+| **ko-KR.json** | -24 行 |
+
+主要涉及天气相关的字符串调整
+
+### 9. 模型层变更
+
+#### AppSettingsSnapshot.cs (修改 +10 行)
+
+- 新增 `IconPackId` 属性
+- 支持天气图标包配置持久化
+
+### 10. 开发工具
+
+#### mocks/weather-widget-mock.html (新增 +209 行)
+
+- 天气组件 HTML 模拟/原型
+- 用于开发和测试预览
+
+## ⚠️ 代码审查要点
+
+### ✅ 优点和亮点
+
+1. **模块化设计优秀**
+   - `WeatherWidgetBase` 作为抽象基类，提供统一的架构
+   - 清晰的职责分离：Resolver、Catalog、SceneControl、VisualTheme 各司其职
+
+2. **多风格图标系统**
+   - 支持 breezy、geometric、google-weather-v4、lemon-flutter 等多种图标风格
+   - 完整的图标变体支持 (day/night、mini variants)
+
+3. **响应式设计**
+   - 支持单元格大小自适应
+   - 多种渲染模式支持 (Live/Design/Preview)
+
+4. **设置系统完善**
+   - 用户可选择天气视觉样式
+   - 设置持久化和导入/导出支持
+
+5. **测试覆盖**
+   - 新增 `DesktopComponentRenderModeTests.cs`
+
+### 🔍 需要关注的问题
+
+1. **提交粒度过大**
+   - 242 个文件、4000+ 行代码的单次提交
+   - 建议拆分为多个更小、更聚焦的提交：
+     - 文档提交
+     - 图标资源提交
+     - 核心服务提交
+     - UI 组件提交
+     - 本地化提交
+
+2. **二进制资源管理**
+   - 190+ 个 PNG 图标文件
+   - 建议考虑使用 Git LFS 优化仓库大小
+
+3. **潜在的依赖问题**
+   - 新增大量组件需要确保构建系统正确处理
+   - 建议运行完整构建验证
+
+4. **测试覆盖**
+   - 仅新增渲染模式测试
+   - 建议补充天气服务、图标解析、设置持久化的单元测试
+
+5. **文档一致性**
+   - 新增的 `spec.md` 需要确保与实现代码同步更新
+
+### 💡 建议改进
+
+1. **提交信息优化**
+   - 当前：`change.重做天气，为回到系统提供自定义功能。`
+   - 建议：`feat(weather): 重做天气组件，支持多视觉风格和自定义图标包`
+   - 包含更多技术细节和影响范围
+
+2. **CHANGELOG 更新**
+   - 如此大的功能变更应记录在 CHANGELOG 中
+
+3. **性能考虑**
+   - 大量图标资源需要懒加载
+   - 确保运行时内存使用可控
+
+4. **可访问性**
+   - 检查天气图标是否有适当的替代文本描述
+   - 确保高对比度模式下的可读性
+
+## 📈 影响范围评估
+
+### 功能模块影响
+
+| 模块 | 影响程度 | 说明 |
+|------|---------|------|
+| **天气组件系统** | 🔴 高 | 核心重做，影响所有天气功能 |
+| **设置系统** | 🟡 中 | 新增样式选择，需兼容性考虑 |
+| **主题系统** | 🟡 中 | 新的 Material 主题集成 |
+| **国际化** | 🟢 低 | 多语言字符串更新 |
+
+### 向后兼容性
+
+- ⚠️ **设置格式变更**：`AppSettingsSnapshot` 新增 `IconPackId` 字段
+- ⚠️ **组件注册变更**：新增组件类型需要注册
+- ✅ **API 兼容性**：新增类和方法，不修改现有公共 API
+
+## 🎯 后续建议
+
+1. **立即执行**
+   - 运行完整构建验证
+   - 运行相关单元测试
+   - 更新 CHANGELOG
+
+2. **短期计划**
+   - 添加天气图标解析和设置的单元测试
+   - 更新相关文档
+   - 考虑启用 Git LFS 管理图标资源
+
+3. **长期考虑**
+   - 建立图标资源自动化压缩流程
+   - 建立设计系统文档站点
+
+## 📄 附件
+
+- 提交-diff 详情：需使用 `git show ada0cd4a3a627107f2f80d910f3195a05f11a582` 查看
+- 设计文档：
+  - `.trae/documents/weather-widget-material-redesign.md`
+  - `.trae/documents/weather-widget-visual-redesign.md`
+  - `.trae/tasks/dock-back-to-windows-button-display/spec.md`
+
+---
+
+**报告生成时间**：2026-05-13  
+**分析工具**：Git + 自定义分析脚本  
+**建议审查者**：技术负责人、UI/UX 负责人