# Changelog

## 1.3.4 - 2026-07-29

### English

#### Resource Lifecycle and Memory

- **Feature widgets now release their UI**: Disabling Todo, Quick Capture, Music, Weather, or Search closes the corresponding window and releases its content, view model, subscriptions, timers, and feature-owned services while preserving saved data.
- **Settings closes instead of hiding**: Closing Settings now destroys the window and releases its WinUI visual tree. Reopening Settings creates a fresh window.
- **Transient timer ownership fixed**: One-shot capsule timers now detach their handlers when they fire or are cancelled, and music timers, storyboards, and event subscriptions stop with their owning view instead of remaining rooted for the process lifetime.
- **Guarded idle maintenance**: DeskBox can compact managed/native heaps and trim resident pages after full background inactivity. A separate threshold-based maintenance pass can also run while widgets remain visible but DeskBox is not being used; foreground, pointer, resize, search, indexing, and other active work suppress collection.
- **Bounded caches**: File icons, decoded bitmaps, and metadata caches now have count and estimated-memory limits, with diagnostics for verifying their size.

#### Search Responsiveness and Index Residency

- **Search follows its feature switch**: Heavy search services are not initialized at startup when Search is disabled. Turning Search off releases its popup, hotkey registration, custom/USN indexes, history/action services, file metadata service, and icon cache.
- **Popup shell warm-up**: When Search is enabled, DeskBox prepares the empty popup shell during a low-priority idle slice so a desktop-widget click does not have to construct the full WinUI window first.
- **Open-only widget action**: Repeated search-widget clicks now open or refocus the popup and can no longer toggle it closed while queued pointer events are still arriving.
- **Window-first loading**: The native popup is shown and focused before recommendations, result icons, or an idle-unloaded index do work. Index restoration starts when the popup is invoked, not after the user types.
- **Idle index unload**: After five minutes without Search, the large resident custom index is saved and released while lightweight file-system watchers remain active. Changes are collected in a small delta map and reconciled when the popup restores the index.
- **Lower-cost indexing and ranking**: Persisted indexes are streamed instead of building a second full JSON copy; directory strings are pooled; stale scans are cancellable; fresh indexes can be reused; and searches retain only the highest-ranked candidates.
- **Visible result fallbacks**: File and folder results without a decoded Shell icon now display an appropriate fallback glyph instead of an empty icon column.

#### Capsule Mode and Window Layering

- **Idle expansion warm-up**: Collapsed widgets pre-measure their expanded layout during an idle UI slice, reducing the first hover expansion hitch without visibly opening every capsule.
- **First-hover recovery**: Smart hover expansion reads the native cursor position after startup, tray restore, and wake, so a capsule no longer needs an activating click before hover works.
- **No hover-through between capsules**: Smart expansion verifies the native pointer root window before opening. Moving inside an expanded widget can no longer trigger an overlapping collapsed capsule underneath it or let that capsule steal the foreground layer.
- **Foreground-safe hover expansion**: If a capsule is still physically above the desktop after a temporary tray/F7 raise has ended, hover expansion reorders it only among DeskBox windows and keeps the current external application in front.
- **Immediate title-bar collapse**: In click-to-toggle mode, clicking the expanded title bar collapses the widget on the next UI turn without the previous fixed 420 ms delay. Other expansion modes are unchanged.

#### Weather Redesign

- **Responsive information hierarchy**: Mini, compact, and expanded layouts were rebuilt around current conditions, compact metrics, hourly forecast, sunrise/sunset, and a scrollable Week view.
- **Standard and Rich skins**: Standard follows the selected app theme and capsule surface; Rich uses condition-aware gradients and matching compact presentation. Rich is now the default for new users and after reset.
- **Contrast across conditions**: Rich-skin text is selected from the weather backdrop rather than blindly following app light/dark mode, while interaction indicators and daylight details use palettes tuned separately for Standard and Rich surfaces.
- **Cleaner native selection**: Day/Week and current-hour selection use a small system-style bottom indicator without changing label weight or color, and labels no longer clip at compact heights.
- **Compact sunrise arc**: The previous tall divider was replaced by a lower sunrise/sunset arc with a daylight progress marker.
- **Reduced continuous effects**: Decorative perpetual weather animations were removed. Only short, state-driven feedback such as the active refresh rotation remains.
- **Forecast and symbol fixes**: Restored the multi-day forecast in the largest single-day layout and replaced the boxed fog emoji with a compatible cloud symbol.
- **Late-day hourly continuity**: MSN forecasts now continue into following days when the current day has no remaining hourly rows.
- **Reliable city selection**: City search ignores spacing, punctuation, and diacritics, ranks exact text matches before proximity, validates coordinates, and queues a fresh request when the previous city's refresh is still running.

#### Music Stability and Efficiency

- **Stable track handoff**: Bursts of media-property events are settled and generation-checked before display, keeping the previous complete track visible until the next complete title and artist are available.
- **Transient empty-state protection**: Brief empty metadata returned while changing tracks is retried instead of clearing the capsule and rebuilding its text several times.
- **Cover work is deduplicated**: Covers reload only when the session/track signature changes, decode at a bounded size, and discard stale asynchronous results.
- **Inactive animation work stops**: Title marquee and record rotation stop while the widget is hidden or collapsed and are restarted only when the expanded surface is visible. The marquee no longer leaves a flashing trailing clone while paused.
- **Lower-cost progress updates**: Expanded, collapsed, hidden, and non-seekable states use different refresh behavior instead of running the full timeline path continuously.
- **Control sizing polish**: Play is slightly larger in Controls, Record vertical, and Record horizontal layouts; previous/next, playback mode, and volume use a smaller consistent secondary size.
- **Empty-cover corners**: Fixed the soft upper corners around the empty album-art surface in Controls mode.

#### File Icons and Launching

- **Sharper large icons**: Executables and shortcuts request higher-resolution Windows Shell icon sources, fixing visibly blurred enlarged icons for apps such as packaged or custom launchers.
- **Cleaner small icons**: High-quality downsampling reduces the jagged look that appeared after improving large icon extraction.
- **Stack icon scaling**: Icons inside automatic stacks now follow the configured file-icon size.
- **Bounded thumbnail memory**: Decoded icon and thumbnail data is evicted by both item count and estimated bytes.
- **Shortcut launch compatibility**: `.lnk` files use the Windows Shell execution path, avoiding direct-resolution failures and reducing shortcut-specific crashes or long stalls.

#### Widgets and Context Menus

- **Blank-area menus**: Todo and Quick Capture blank content areas now expose the same widget menu as their title bars.
- **File-widget menu completion**: The file content menu includes Title style and Expansion mode, positioned below Auto stack and above Sort by.
- **Conditional Paste**: Paste is omitted when the clipboard does not contain content that the file widget can accept, instead of showing a disabled command.
- **Close from file content**: File and mapped-folder content menus now include the same Close widget command and second-step confirmation used by the title-bar menu, positioned above Refresh.

#### Hotkeys and Product Cleanup

- **Removed low-level keyboard hooks**: Global and Search hotkeys now use standard `RegisterHotKey`/`WM_HOTKEY` handling, avoiding intercepted D-key input, repeats, and latency.
- **RDP modifier recovery**: Modifier key-up recovery prevents Alt/Ctrl/Shift from remaining logically pressed after a Remote Desktop hotkey.
- **Correct Search hotkey lifecycle**: The Search hotkey switch refreshes registration correctly and cannot open Search while the Search widget feature is disabled.
- **Simplified hotkey settings**: Global and Search hotkeys share the top-level Shortcuts & Interaction page in compact expandable cards.
- **Opt-in first-run behavior**: New installations and reset defaults keep capsule mode and the global Search hotkey off until the user enables them.
- **Search widget title default**: Newly created Search widgets use floating title chrome by default, matching Weather and Music.
- **Image widget removed**: The legacy image-gallery widget and its associated services, settings, models, and views were removed.

#### Distribution

- **Version 1.3.4**: Application, file, assembly, MSIX, and installer versions are aligned to 1.3.4.
- **x64 and ARM64 installers**: Both packages are framework-dependent. Setup checks the matching .NET 10 Runtime and Windows App Runtime 2.2 architecture and downloads only a missing dependency.

### 中文

#### 资源生命周期与内存

- **功能格子关闭后释放界面**：关闭待办、随记、音乐、天气或搜索功能时，会关闭对应窗口并释放内容、ViewModel、订阅、定时器和功能专属服务，同时保留已保存数据。
- **设置窗口真正关闭**：关闭设置页时不再只隐藏窗口，而是销毁窗口并释放 WinUI 视觉树；下次打开时重新创建。
- **临时定时器正确释放**：胶囊一次性定时器在触发或取消时会解绑事件；音乐定时器、Storyboard 与订阅跟随所属视图停止，不再被意外保留到进程结束。
- **受保护的空闲整理**：应用完全进入后台后可整理托管堆、原生堆与工作集；即使格子仍显示，只要 DeskBox 未被操作且达到资源阈值，也可执行另一组保守维护。前台、鼠标、缩放、搜索、索引等活动会阻止回收。
- **缓存增加上限**：文件图标、解码位图和元数据缓存同时受条目数与估算内存限制，并增加可观测诊断数据。

#### 搜索响应与索引常驻

- **搜索资源与功能开关联动**：搜索未开启时，启动阶段不初始化重型搜索服务；关闭搜索会释放弹窗、快捷键注册、自定义/USN 索引、历史与操作服务、文件元数据服务和图标缓存。
- **空闲预热弹窗外壳**：搜索开启后，DeskBox 会在低优先级空闲切片中准备空弹窗，点击桌面搜索格子时无需先构造完整 WinUI 窗口。
- **搜索格子只负责打开**：连续点击搜索格子只会打开或重新聚焦弹窗，不会因为排队到达的指针事件把刚打开的窗口再次关闭。
- **窗口优先显示**：先显示并聚焦原生弹窗，再加载推荐内容、结果图标和已卸载索引；索引恢复在弹窗唤起时开始，不再等到用户输入文字。
- **索引空闲卸载**：搜索连续五分钟未使用时，保存并释放常驻的大型自定义索引，但保留轻量文件监听；期间变化进入小型增量表，下次弹窗恢复索引时再合并。
- **降低索引与排序成本**：索引改为流式写入，避免构造第二份完整 JSON；复用目录字符串；过期扫描可取消；可复用新鲜索引；搜索只保留最高排名候选。
- **结果图标占位修复**：无法解码 Shell 图标的文件和文件夹会显示对应的后备图标，不再留下空白图标列。

#### 胶囊模式与窗口层级

- **空闲预热展开布局**：收起的格子会在 UI 空闲切片中预先测量展开布局，改善第一次悬停展开的卡顿，不会在桌面上逐个可见展开。
- **首次悬停恢复**：应用启动、托盘恢复或唤醒后通过原生光标位置同步悬停状态，胶囊无需先点击即可自动展开。
- **相邻胶囊不再穿透误触**：智能展开前会核对原生指针所属窗口；在已展开格子内操作时，不会触发其下方重叠的收起胶囊，也不会让下方胶囊抢占前台层级。
- **悬停展开不越过前台应用**：托盘/F7 临时唤起结束后，如果胶囊仍在桌面上方，悬停展开只调整 DeskBox 格子之间的顺序，不会盖住当前外部前台应用。
- **标题栏立即收起**：点击切换模式下，点击展开格子的标题栏会在下一个 UI 调度立即收起，移除原来的固定 420 ms 延迟；其他展开模式不变。

#### 天气视觉重构

- **重建响应式信息层级**：迷你、紧凑和展开布局围绕当前天气、紧凑指标、逐小时预报、日出日落与可滚动周视图重新组织。
- **标准与高级皮肤**：标准皮肤跟随应用主题和标准胶囊表面；高级皮肤使用随天气变化的渐变，并同步高级胶囊样式。新用户与恢复默认后使用高级皮肤。
- **不同天气下保持对比度**：高级皮肤文字根据天气背景亮度选择，不再简单套用应用明暗模式；交互指示与日照细节也分别适配标准/高级表面。
- **原生化选中状态**：日/周和当前时段仅使用系统风格的底部小横条，不改变文字粗细与颜色，并修复紧凑高度下文字裁切。
- **收紧日出日落圆弧**：用更低的日照进度圆弧替换原先偏高的分隔视觉，并增加日照位置标记。
- **降低持续动效开销**：移除持续运行的装饰性天气动效，仅保留刷新中旋转等短时、状态驱动反馈。
- **预报与符号修复**：恢复最大单日布局中的多日预报，并用兼容性更好的云符号替换会显示成白块的雾 Emoji。
- **跨日小时预报连续显示**：MSN 当天已没有小时数据时，会继续读取后续预报日，避免日视图下方留白。
- **城市选择更可靠**：城市搜索忽略空格、标点和重音符号，精确文本优先于距离排序；同时校验坐标，并在旧城市刷新仍运行时排队刷新新城市。

#### 音乐稳定性与效率

- **切歌信息稳定交接**：媒体属性事件集中到达时先等待稳定并核对代次，在下一首完整歌曲名与歌手名可用前保留上一首完整内容。
- **保护瞬时空数据**：切歌时播放器短暂返回空信息会先重试，不再立刻清空胶囊并让文字重复重排。
- **封面工作去重**：只有媒体会话/歌曲签名变化时才重新加载封面；限制解码尺寸，并丢弃已经过期的异步结果。
- **非活跃时停止动画**：音乐格子隐藏或收起后停止跑马灯和唱片旋转，只在展开表面可见时恢复；暂停后跑马灯尾部副本也不再闪烁。
- **降低进度刷新成本**：展开、收起、隐藏和不可拖动状态使用不同刷新策略，不再持续执行完整时间轴刷新。
- **控制按钮尺寸统一**：控制、唱片竖排、唱片横排中的播放键略微放大；上一首、下一首、播放模式和音量统一使用更小的辅助尺寸。
- **空封面圆角修复**：修复控制模式空封面上方左右圆角发虚。

#### 文件图标与启动

- **大图标更清晰**：可执行文件和快捷方式会请求更高分辨率的 Windows Shell 图标源，改善放大后明显模糊的问题。
- **小图标更平滑**：改进高质量缩小采样，减少大图标优化后小尺寸出现的锯齿。
- **叠放图标同步缩放**：自动叠放中的图标会跟随文件图标尺寸设置。
- **缩略图内存有界**：图标和缩略图解码数据会按条目数与估算字节数淘汰。
- **快捷方式兼容启动**：`.lnk` 使用 Windows Shell 路径打开，避免直接解析启动带来的失败，并降低快捷方式特有的崩溃或长时间等待。

#### 格子与右键菜单

- **空白区域菜单**：待办和随记的空白内容区域现在显示与标题栏一致的格子菜单。
- **补全文件格子菜单**：文件内容区域新增“标题样式”和“展开方式”，位于“自动叠放”下方、“排序方式”上方。
- **按需显示粘贴**：剪贴板没有文件格子可接受的内容时，直接隐藏“粘贴”，不再显示置灰项。
- **内容区域可关闭格子**：文件格子和映射文件夹格子的内容菜单在“刷新”上方加入“关闭格子”，并保留与标题栏一致的二级确认。

#### 热键与功能精简

- **移除低级键盘钩子**：全局与搜索热键改为标准 `RegisterHotKey`/`WM_HOTKEY`，避免 D 键被拦截、重复输入和延迟。
- **远程桌面修饰键恢复**：热键触发后补充修饰键释放，避免 RDP 环境下 Alt/Ctrl/Shift 保持按下状态。
- **搜索热键生命周期修复**：搜索热键开关会正确刷新注册，搜索功能关闭时也无法再唤起搜索弹窗。
- **简化热键设置**：全局和搜索热键统一放到一级“快捷与交互”页面，并使用紧凑的可展开卡片。
- **首次使用按需开启**：新用户安装和恢复默认后，胶囊模式与搜索全局快捷键默认关闭，由用户主动开启。
- **搜索格子标题默认值**：新建搜索格子默认使用与天气、音乐一致的悬浮标题样式。
- **移除图片格子**：删除旧图片画廊格子以及相关服务、设置、模型和界面。

#### 发布

- **版本统一为 1.3.4**：应用、文件、程序集、MSIX 和安装器版本号保持一致。
- **x64 与 ARM64 安装包**：两个包均不内置运行时；安装器会检测匹配架构的 .NET 10 Runtime 与 Windows App Runtime 2.2，只在缺少时下载。

## 1.3.3 - 2026-07-24

### English

#### Drag & Drop Enhancements

- **WeChat file drag-drop**: Drag files and images directly from WeChat chat windows into grid items. A background polling thread reliably detects mouse release during OLE drags, bypassing WinUI 3's unreliable Drop event for non-Chromium drag sources.
- **Browser URL drag-drop**: Dragging images or file links from browsers (Chrome, Edge, Firefox) now downloads the URL to a temporary file and imports it automatically.
- **Folder drop support**: Files dragged onto a folder item within a grid are transferred into that folder.
- **Virtual file fix**: NativeDropTarget now tries `TYMED_ISTREAM` and `TYMED_HGLOBAL` separately for `FileContents`, fixing silent failures on browser virtual file drops.

#### Stack Group Management

- **Rename stacks**: Right-click a stack group header to rename it with an inline text box. Custom names persist across restarts.
- **Reorder stacks**: Move stack groups up or down via the right-click context menu.
- **Disable/restore stacks**: "Don't stack this group" dissolves a stack so its members display as loose items. Disabled groups can be restored from the same menu.

#### Weather Data Source

- **MSN Weather (default)**: Added MSN Weather API as the default data source — the same source used by the Windows weather widget. Provides current conditions, hourly and daily forecasts, sunrise/sunset, and UV index.
- **Open-Meteo fallback**: If the primary source fails, the app automatically falls back to Open-Meteo. Users can also manually select the data source in Settings → Weather.
- **Weather code mapping**: Added reverse mapping from MSN weather description text to WMO codes, so MSN-sourced data reuses the existing emoji/glyph/animation system.

#### F7 Z-Order Reliability Fix

- **Silent restore fix**: `ClearTopMostPreservingForeground` now unconditionally calls `BringWindowToFront(foreground)` instead of gating on `wasTopMost`. Previously, raised widgets used temporary TopMost (TOPMOST→NOTOPMOST), so the gate was always false — the restore state changed but the visual didn't, causing "flicker without collapse" on the next F7 press.
- **Cross-process click detection**: Replaced unreliable low-bit `GetAsyncKeyState` with a 50ms high-bit mouse sampler that detects up→down edges globally. The 200ms restore monitor now consumes an `_outsideMousePressObserved` flag, reliably detecting clicks on foreign windows — including clicks on an already-activated window.
- **Drag poll interference fix**: Reduced the drag-drop background polling timeout from 30s to 5s to minimize interference with `GetAsyncKeyState` low-bit consumption.

#### Search Widget Refinements

- **Clear history button**: Added a clear button in the search widget footer to wipe recent queries and result cards while preserving pinned favorites.
- **Live sync**: The search widget now auto-refreshes when search history changes in the popup.
- **Removed auto-generated recommendations**: The widget body shows only items the user actually opened. Auto-generated Start Menu app shortcuts are no longer shown in the widget body.
- **Simplified placeholder**: Search placeholder changed to "Search files..." for clarity.

#### UI / UX Polish

- **Tray icon label fix**: The "Black" and "White" tray icon labels were swapped — now correctly labeled.
- **Collapsed preview chevron**: Hidden the chevron icon in collapsed stack preview mode for a cleaner look.
- **Search popup**: Removed the "Recommended apps" section header; minor padding adjustment.

#### Localization

- Added new strings for weather data source, stack management, and search clear button across all five supported languages (zh-CN, en-US, ja-JP, de-DE, pt-BR).
- Fixed tray icon color labels in all languages.

### 中文

#### 拖拽增强

- **微信文件拖拽**：可直接从微信聊天窗口拖拽文件和图片到格子内。后台轮询线程可靠检测 OLE 拖拽时的鼠标释放，绕过 WinUI 3 对非 Chromium 拖拽源 Drop 事件不可靠的问题。
- **浏览器链接拖拽**：从浏览器拖拽图片或文件链接时，自动下载 URL 到临时文件并导入。
- **文件夹投放支持**：拖拽文件到格子内的文件夹项目上时，文件会直接传输到该文件夹中。
- **虚拟文件修复**：NativeDropTarget 现在分别尝试 `TYMED_ISTREAM` 和 `TYMED_HGLOBAL` 获取 `FileContents`，修复浏览器虚拟文件拖拽静默失败的问题。

#### 叠放组管理

- **重命名叠放组**：右键叠放组标题可使用内联文本框重命名，自定义名称跨重启保存。
- **叠放组排序**：通过右键菜单上移/下移叠放组。
- **取消/恢复折叠**：可选择"不再折叠此分组"，将叠放组成员显示为散列项目。已取消的分组可从同一菜单恢复。

#### 天气数据源

- **MSN 天气（默认）**：新增 MSN 天气 API 作为默认数据源，与 Windows 天气小组件同源。提供实时天气、逐小时和逐日预报、日出日落和 UV 指数。
- **Open-Meteo 备用源**：主源请求失败时自动切换到 Open-Meteo。用户也可在设置 → 天气中手动选择数据源。
- **天气代码映射**：新增 MSN 天气描述文本到 WMO 代码的反向映射，使 MSN 数据源可复用现有的 emoji/动画系统。

#### F7 层级可靠性修复

- **静默回落修复**：`ClearTopMostPreservingForeground` 现在无条件调用 `BringWindowToFront(foreground)`，不再以 `wasTopMost` 门控。此前唤起的格子使用瞬态置顶，门控恒为 false —— 回落状态变了但画面没变，导致下次按 F7 时"闪烁不收起"。
- **跨进程点击检测**：用 50ms 高位 `GetAsyncKeyState` 采样器（全局物理状态 + up→down 边沿检测）替代不可靠的低位检测。200ms 回落监视器现在消费采样器设置的 `_outsideMousePressObserved` 标志，可靠检测对外部窗口的点击 —— 包括点击已激活窗口这种 Windows 不做 Z-order 变化的情况。
- **拖拽轮询干扰修复**：拖拽后台轮询超时从 30s 缩短到 5s，减少对 `GetAsyncKeyState` 低位消费的干扰。

#### 搜索格子改进

- **清空历史按钮**：搜索格子底部新增清空按钮，可清除最近搜索和结果卡片，保留收藏项。
- **实时同步**：搜索弹窗中历史变化时，搜索格子自动刷新。
- **移除自动推荐**：格子主体现在只显示用户实际打开过的项目。自动生成的开始菜单应用快捷方式不再显示在格子主体中。
- **简化占位符**：搜索占位符改为"搜索文件..."。

#### 界面/体验打磨

- **托盘图标标签修复**："黑色"和"白色"托盘图标标签此前是反的，现已修正。
- **折叠预览箭头**：折叠叠放组预览中隐藏了箭头图标，更简洁。
- **搜索弹窗**：移除"推荐应用"分区标题；微调内边距。

#### 本地化

- 在全部五种语言（zh-CN、en-US、ja-JP、de-DE、pt-BR）中新增天气数据源、叠放组管理和搜索清空按钮的翻译字符串。
- 修复全部语言中托盘图标颜色标签颠倒的问题。

## 1.3.2 - 2026-07-23

### English

#### Search System (New)

- **Full-text desktop search**: Added a complete search infrastructure with a dedicated search popup window, global hotkey activation, and instant result display. Supports searching files, folders, applications, and settings from a single entry point.
- **USN Journal indexing**: Added `UsnJournalIndexService` that reads the NTFS USN change journal for fast, low-overhead file discovery without walking the directory tree.
- **Windows Index integration**: Added `WindowsIndexSearchService` that queries the Windows Indexing Service for content-searchable results including document metadata.
- **Search result ranking**: Added `SearchResultRanker` with a weighted scoring algorithm considering name match position, file type priority, recency, and path depth.
- **Search history**: Added `SearchHistoryService` with recent-search persistence, quick re-execution, and history clearing.
- **Recommended apps panel**: The search popup shows a recommended-apps panel with keyboard navigation (arrow keys + Enter to launch, Space to preview via QuickLook).
- **Type sort and filter**: Search results can be sorted and filtered by type (files, folders, apps, settings).
- **Search widget content**: Added `SearchWidgetContent` and `SearchWidgetContentAdapter` so search can be embedded as a widget content type.
- **Search settings section**: Added a dedicated Search settings page with hotkey configuration, index scope, result count, and recommendation toggles.

#### Multi-Language Expansion

- **Three new languages**: Added Japanese (ja-JP), German (de-DE), and Brazilian Portuguese (pt-BR) localization with 1500+ translated strings each, covering all widgets, settings, onboarding, search, tray menus, dialogs, and status messages.
- **Localization architecture rewrite**: Replaced the legacy `.resw` resource system with a JSON-based `LocalizationService` that loads embedded `Strings/{locale}.json` files at runtime, enabling easier community translation contributions and hot-reload during development.

#### Onboarding Redesign

- **Five-step focused flow**: Rebuilt the first-run guide from the previous multi-panel layout into a focused five-step flow: Welcome, Feature Overview, Storage Setup, Hotkey Configuration, and Completion.
- **Refined layout and animations**: Each step uses purpose-built entrance animations, consistent spacing, and localized content in all five supported languages.

#### Adaptive Tray Animation System

- **Hardware-adaptive controller**: Added `AdaptiveTrayAnimationController` and `HardwareAdaptiveAnimationService` that detect GPU capability and adjust animation complexity accordingly — full composition animations on discrete GPUs, simplified fallbacks on integrated graphics.
- **Batch animation driver**: Added `WidgetTrayBatchAnimationDriver` for synchronized multi-widget tray show/hide, eliminating per-widget timing drift.
- **Smart animation adapter**: Added `SmartAnimationAdapter` that bridges the adaptive controller with existing widget animation paths.
- **Synchronized scheduling**: Replaced fire-and-forget `DispatcherQueue.TryEnqueue` calls with synchronized scheduling, reducing animation tearing on rapid tray toggles.

#### Weather Improvements

- **City database expansion**: Expanded the offline `cities.json` database from ~500 to 5000+ entries covering significantly more small and medium cities worldwide.
- **Improved city search**: `CitySearchService` now uses prefix + fuzzy matching with CJK-aware tokenization for better results in Chinese, Japanese, and other non-Latin scripts.
- **Location service refinement**: Improved `WindowsLocationHelper` with better timeout handling, fallback to last-known position, and clearer error reporting.
- **Weather layout improvements**: Refined `WeatherWidgetContent` layouts for all four size modes with better spacing, icon alignment, and forecast list scrolling.

#### Installer and Updater

- **ARM64 installer**: Added `DeskBox.arm64.iss` and `DeskBox.Dependencies.arm64.iss` for native ARM64 Windows builds.
- **Reliable process kill**: Installer now uses a robust process-termination sequence before overwrite, avoiding file-lock failures.
- **Force-update enforcement**: `AppUpdateService` now enforces mandatory updates when the server flags a version as critical.
- **Helper cleanup**: Stale update-helper directories under `%LocalAppData%\DeskBox\update-helper` are cleaned up automatically.
- **Official download URLs**: Switched all download links to the official GitHub Releases channel.
- **Migration support**: Added `DeskBox.Migration.iss` for handling data migration during major version upgrades.
- **English installer language**: Added `Languages/English.isl` for proper English installer UI on non-Chinese systems.
- **Installer language selection**: The installer now shows a language-selection dialog (Chinese, English, Japanese, German, Brazilian Portuguese) pre-selected to the system locale. The chosen language is written to `HKCU\Software\DeskBox\InstallLanguage`, and DeskBox uses it as the default app language on first run (a manual in-app change still wins).
- **Search popup polish**: The result-list header now aligns with the data rows; the sort header carries a subtle background and shares the menu-bar margins.
- **Weather capsule fix**: Removed a duplicate title icon so capsule mode shows only the weather emoji.
- **Capsule hover mask**: Hidden the semi-transparent right-edge hover mask in capsule mode (interaction unchanged).

#### Architecture and Maintainability

- **App.Tray extraction**: Extracted `App.Tray.cs` (704 lines) from `App.xaml.cs`, consolidating all tray icon, menu, and lifecycle logic.
- **ServiceRegistry**: Added `ServiceRegistry` for centralized service location, reducing constructor parameter explosion.
- **SettingsMigrationService**: Added `SettingsMigrationService` for versioned settings schema migrations.
- **FileMetaService**: Added `FileMetaService` (332 lines) for unified file metadata extraction (icon, type name, size formatting).
- **AppDiagnosticsService**: Added `AppDiagnosticsService` for runtime diagnostics including handle counts, memory pressure, and UI thread responsiveness.
- **User guide**: Added a 10-chapter user guide under `docs/user-guide/` covering getting started, file widgets, todo, quick capture, capsule mode, stacks & QuickLook, appearance, backup, advanced workflows, and troubleshooting.

#### Fixes

- **QuickLook compatibility (critical)**: Fixed a critical issue where DeskBox could crash QuickLook's single-threaded named-pipe server by connecting without sending data (pipe probe in `CanPreview` and raw `CreateFile` fallback). Availability checks now use process enumeration only; the pipe is touched exclusively when sending a Toggle message.
- **Wallpaper loss**: Prevented desktop wallpaper loss caused by repeated `WorkerW` window spawns during widget layer operations in `WidgetLayerService`.
- **Capsule mode defaults**: Aligned `AppSettings` initial values with `ApplyDefaultPreferences` so new installs and global reset produce identical capsule behavior.
- **Tray menu height**: Fixed tray right-click menu height display issue.
- **Dead shortcut cleanup**: Added detection and removal of invalid `.lnk` and `.url` shortcuts (e.g. uninstalled Steam games) that previously showed broken icons in file widgets.
- **Weather code mapping**: Expanded `WeatherCodeMapper` with additional WMO weather codes for more accurate condition descriptions.

### 中文

#### 搜索系统（全新）

- **全文桌面搜索**：新增完整的搜索基础设施，包括专用搜索弹窗、全局快捷键唤起和即时结果展示。支持从单一入口搜索文件、文件夹、应用和设置。
- **USN 日志索引**：新增 `UsnJournalIndexService`，通过读取 NTFS USN 变更日志实现快速、低开销的文件发现，无需遍历目录树。
- **Windows 索引集成**：新增 `WindowsIndexSearchService`，查询 Windows 索引服务获取可内容搜索的结果（包括文档元数据）。
- **搜索结果排序**：新增 `SearchResultRanker`，使用加权评分算法，综合考虑名称匹配位置、文件类型优先级、时间新近度和路径深度。
- **搜索历史**：新增 `SearchHistoryService`，支持最近搜索持久化、快速重新执行和历史清除。
- **推荐应用面板**：搜索弹窗展示推荐应用面板，支持键盘导航（方向键 + Enter 启动，Space 通过 QuickLook 预览）。
- **类型排序和筛选**：搜索结果可按类型（文件、文件夹、应用、设置）排序和筛选。
- **搜索格子内容**：新增 `SearchWidgetContent` 和 `SearchWidgetContentAdapter`，搜索可作为格子内容类型嵌入。
- **搜索设置分区**：新增独立的搜索设置页，支持快捷键配置、索引范围、结果数量和推荐开关。

#### 多语言扩展

- **三种新语言**：新增日语（ja-JP）、德语（de-DE）和巴西葡萄牙语（pt-BR）本地化，每种语言 1500+ 翻译条目，覆盖所有格子、设置、引导、搜索、托盘菜单、对话框和状态消息。
- **本地化架构重写**：将旧的 `.resw` 资源系统替换为基于 JSON 的 `LocalizationService`，运行时加载嵌入的 `Strings/{locale}.json` 文件，便于社区翻译贡献和开发时热重载。

#### 新用户引导重构

- **五步聚焦流程**：将首次启动引导从之前的多面板布局重建为聚焦的五步流程：欢迎、功能概览、收纳设置、快捷键配置和完成。
- **精炼布局与动画**：每步使用专门的入场动画、一致的间距和全部五种支持语言的本地化内容。

#### 自适应托盘动画系统

- **硬件自适应控制器**：新增 `AdaptiveTrayAnimationController` 和 `HardwareAdaptiveAnimationService`，检测 GPU 能力并相应调整动画复杂度——独立显卡使用完整组合动画，集成显卡使用简化回退。
- **批量动画驱动器**：新增 `WidgetTrayBatchAnimationDriver`，用于同步多格子托盘显示/隐藏，消除单格子计时漂移。
- **智能动画适配器**：新增 `SmartAnimationAdapter`，将自适应控制器与现有格子动画路径桥接。
- **同步调度**：将即发即弃的 `DispatcherQueue.TryEnqueue` 调用替换为同步调度，减少快速切换托盘时的动画撕裂。

#### 天气改进

- **城市数据库扩展**：离线 `cities.json` 数据库从约 500 条扩展到 5000+ 条，覆盖更多中小城市。
- **改进城市搜索**：`CitySearchService` 现在使用前缀 + 模糊匹配，并支持 CJK 感知的分词，在中文、日文等非拉丁文字下搜索效果更好。
- **定位服务优化**：改进 `WindowsLocationHelper` 的超时处理、回退到上次已知位置，以及更清晰的错误报告。
- **天气布局改进**：优化 `WeatherWidgetContent` 四种尺寸模式的布局，改善间距、图标对齐和预报列表滚动。

#### 安装器与更新器

- **ARM64 安装器**：新增 `DeskBox.arm64.iss` 和 `DeskBox.Dependencies.arm64.iss`，支持原生 ARM64 Windows 构建。
- **可靠进程关闭**：安装器现在使用健壮的进程终止序列，避免覆盖安装时的文件锁定失败。
- **强制更新机制**：`AppUpdateService` 现在在服务器标记版本为关键时强制执行更新。
- **缓存清理**：自动清理 `%LocalAppData%\DeskBox\update-helper` 下的残留更新缓存目录。
- **正式下载地址**：所有下载链接切换到正式 GitHub Releases 渠道。
- **迁移支持**：新增 `DeskBox.Migration.iss` 处理大版本升级时的数据迁移。
- **英文安装器语言**：新增 `Languages/English.isl`，非中文系统显示英文安装界面。
- **安装器语言选择**：安装器现在提供语言选择对话框（中文、英文、日语、德语、巴西葡萄牙语），默认按系统区域预选。所选语言写入 `HKCU\Software\DeskBox\InstallLanguage`，DeskBox 首次启动会默认使用该语言（手动在应用内切换仍优先）。
- **搜索弹窗打磨**：结果列表表头与数据行现已左对齐；排序表头增加半透明底，并与上方菜单栏左右对齐。
- **天气胶囊修复**：移除了重复的标题图标，胶囊模式下只显示天气 emoji。
- **胶囊悬停遮罩**：隐藏胶囊右侧边缘的半透明悬停遮罩（交互行为不变）。

#### 架构与可维护性

- **App.Tray 提取**：从 `App.xaml.cs` 提取 `App.Tray.cs`（704 行），统一托盘图标、菜单和生命周期逻辑。
- **ServiceRegistry**：新增 `ServiceRegistry` 用于集中服务定位，减少构造函数参数爆炸。
- **SettingsMigrationService**：新增 `SettingsMigrationService` 用于版本化设置架构迁移。
- **FileMetaService**：新增 `FileMetaService`（332 行），统一文件元数据提取（图标、类型名称、大小格式化）。
- **AppDiagnosticsService**：新增 `AppDiagnosticsService` 用于运行时诊断，包括句柄数、内存压力和 UI 线程响应性。
- **用户指南**：在 `docs/user-guide/` 下新增 10 章用户指南，涵盖快速开始、文件格子、待办、随记、胶囊模式、叠放与 QuickLook、外观、备份、高级工作流和故障排除。

#### 修复

- **QuickLook 兼容性（严重）**：修复 DeskBox 可能因空连接（连接后不发送数据）导致 QuickLook 单线程命名管道服务器崩溃的严重问题（`CanPreview` 中的管道探测和 raw `CreateFile` 回退）。可用性检查现在仅使用进程枚举；管道仅在发送 Toggle 消息时才连接。
- **壁纸丢失**：防止 `WidgetLayerService` 格子层级操作期间反复生成 `WorkerW` 窗口导致桌面壁纸丢失。
- **胶囊模式默认值**：将 `AppSettings` 初始值与 `ApplyDefaultPreferences` 对齐，确保新安装和全局重置产生一致的胶囊行为。
- **托盘菜单高度**：修复托盘右键菜单高度显示问题。
- **死快捷方式清理**：新增检测和移除无效 `.lnk` 和 `.url` 快捷方式（如已卸载的 Steam 游戏），此前这些快捷方式会在文件格子中显示损坏图标。
- **天气代码映射**：扩展 `WeatherCodeMapper` 支持更多 WMO 天气代码，提供更准确的天气状况描述。

## 1.3.1 - 2026-07-20

### English

- **High-DPI icon clarity**: Replaced 32×32 `SHGFI_LARGEICON` extraction with `SHGetImageList` Jumbo (256×256) and Extra Large (48×48) fallback, plus `SHDefExtractIcon` for indexed icons. File and shortcut icons now match desktop icon clarity on high-DPI displays.
- **Steam shortcut icons**: Resolved `.url` shortcut icons not displaying by parsing comma-separated icon indices (e.g. `steam.exe,0`), searching for Steam via registry, and falling back to common install locations and system PATH.
- **Animation performance**: Replaced CPU-driven opacity/scale animations with GPU Composition KeyFrame animations. Added `DWMWA_TRANSITIONS_FORCEDISABLED` to prevent DWM interference. Replaced `AppWindow.Move` with direct `SetWindowPos` P/Invoke for lower latency.
- **Black screen transition fix**: Removed backdrop suppression during tray show/hide animations so Mica/Acrylic material remains consistent throughout the animation cycle.
- **Music artwork corner radius**: Fixed asymmetric corner radius on music widget album art in both empty and populated states by dynamically computing `CornerRadius` from widget settings.
- **Duplicate startup entries**: Unified startup registration to a single registry `Run` key. Removed redundant startup shortcut creation from the installer and drag-drop permission service. Added automatic cleanup of legacy startup shortcuts.
- **Capsule mode defaults**: New installs and global reset now default to hover auto-expand, sensitive hover response, and relaxed expand/collapse animation for a smoother first-run experience.
- **Freeze diagnostics**: Added a UI thread watchdog that detects and logs unresponsive periods with handle counts and GC generation. Fixed a sync-over-async deadlock in `StoreStartupService.RequestEnableAsync`.
- **Manual sort improvement**: Any drag-and-drop action in a file widget now automatically switches to manual sort mode. Subsequent sort mode clicks revert to automatic sorting. Removed the explicit "Manual Sort" menu option.

### 中文

- **高 DPI 图标清晰度**：将 32×32 的 `SHGFI_LARGEICON` 提取替换为 `SHGetImageList` Jumbo（256×256）和 Extra Large（48×48）回退，以及 `SHDefExtractIcon` 索引图标提取。文件和快捷方式图标在高 DPI 显示器上现在与桌面图标一样清晰。
- **Steam 快捷方式图标**：修复 `.url` 快捷方式图标不显示的问题，解析逗号分隔的图标索引（如 `steam.exe,0`），通过注册表搜索 Steam 安装路径，并回退到常见安装位置和系统 PATH。
- **动画性能**：将 CPU 驱动的透明度/缩放动画替换为 GPU Composition KeyFrame 动画。添加 `DWMWA_TRANSITIONS_FORCEDISABLED` 防止 DWM 干扰。将 `AppWindow.Move` 替换为直接 `SetWindowPos` P/Invoke 调用，降低延迟。
- **黑屏过渡修复**：移除托盘显示/隐藏动画期间的材质抑制，使 Mica/Acrylic 材质在整个动画周期内保持一致。
- **音乐封面圆角**：修复音乐格子封面在空状态和有值时圆角上下不对称的问题，通过动态计算 `CornerRadius` 解决。
- **重复启动项**：统一开机启动注册为单一注册表 `Run` 键。移除安装器和拖拽权限服务中多余的启动快捷方式创建。新增旧启动快捷方式自动清理。
- **胶囊模式默认值**：新安装和全局重置现在默认使用悬停自动展开、灵敏悬停响应和舒缓的展开/收起动画，提供更流畅的首次使用体验。
- **卡死诊断**：新增 UI 线程看门狗，检测并记录无响应时段的句柄数和 GC 代数。修复 `StoreStartupService.RequestEnableAsync` 中的 sync-over-async 死锁。
- **手动排序改进**：文件格子中任意拖拽操作现在自动切换到手动排序模式。后续排序模式点击恢复为自动排序。移除了显式的"手动排序"菜单选项。

## 1.3.0 - 2026-07-18

### English

- **Capsule mode**: Widgets can now collapse into compact desktop surfaces and expand by click or title-area hover. Compact content supports smart highlights, summaries or icon-and-title only, with an optional privacy mode for Todo and Quick Capture text.
- **Stable compact geometry**: Added aligned and independent width modes, anchored expansion toward the available screen area, separate compact and expanded bounds, resize guides, and per-widget overrides. Dragging content over a compact widget temporarily expands it without permanently moving or resizing either state.
- **Combined capsule layouts**: Compact widgets can remain independently positioned or form a movable combined bar. The bar supports user-defined order, floating or edge placement, automatic direction, adjustable spacing, and reliable restoration of free-layout positions.
- **Automatic file stacks**: File widgets can group related items by type or date without moving the underlying files. Custom extension rules support names, priority ordering, live match previews, thresholds, internal sorting and a configurable unmatched-file policy.
- **Stack interaction and QuickLook compatibility**: Stacks use an in-widget spread/collapse interaction with selection and path-copy commands. When QuickLook is already running, pressing Space on a selected file forwards the preview request without adding settings, startup work or a hard dependency.
- **Todo and Quick Capture workflows**: Added multiple file attachments with link-or-copy storage, attachment-aware clipboard formatting, configurable tab visibility, drag-to-tab actions, new Todo views for Active, This week and This month, adjustable list preview lines, and configurable Enter/Ctrl+Enter save behavior.
- **Appearance and responsive content**: Added Mica Alt and Base acrylic, material intensity, neutral/accent/hidden border colors, compact/standard/relaxed/custom density presets, and forced Cover or Controls layouts for Music. Solid material now remains fully opaque.
- **Windows-style Settings redesign**: Reorganized crowded pages into focused detail pages, moved global search into the title area, improved search matching and result navigation, surfaced important choices directly on entry cards, and made per-page hierarchy and reset behavior more consistent.
- **Backup, restore and attachment health**: Added integrity-checked ZIP export/restore, automatic and pre-restore snapshots, staged restart-safe restore, resilient JSON recovery, and attachment health scans for missing linked files, missing managed files and orphaned managed attachments.
- **Window and animation reliability**: Refined show/hide transitions, detail-page transitions, title-bar collapse actions, hover hit regions, Z-order, multi-monitor bounds restoration, resize alignment and tray menu sizing. Rapid capsule and stack interactions now use guarded state transitions to reduce flicker and stuck intermediate states.
- **Installer upgrades**: The installer now closes a running DeskBox process reliably before replacing application files, avoiding the intermittent Retry / Ignore / Cancel prompt during overwrite installs.
- **Maintainability and tests**: Split the largest window, widget, settings, Todo, Quick Capture, Music and Weather classes into focused modules. Expanded regression coverage across attachments, backup safety, settings migration/search, compact bounds and privacy, stacks, animation and positioning.

### 中文

- **胶囊模式**：格子现在可以收起为紧凑桌面形态，并通过点击或标题区域悬停展开。收起后可显示关键信息、简要摘要或仅图标和标题，也可隐藏待办与随记正文等敏感内容。
- **稳定的收起与展开几何逻辑**：新增保持同宽和独立调整两种宽度关系，并根据屏幕可用区域从胶囊锚点向合适方向展开。胶囊与展开状态分别保存位置和尺寸，支持参考线与单格覆盖；内容拖入时会临时展开，操作结束后不会永久改变两种状态。
- **胶囊组合排列**：胶囊可独立摆放，也可组成能够整体移动的组合栏。组合栏支持自定义顺序、悬浮或贴边位置、自动排列方向、间距调整，并能稳定恢复原来的自由布局位置。
- **文件自动叠放**：文件格子可按文件类型或日期自动分组，不移动真实文件。自定义格式规则支持叠放名称、优先级、实时命中预览、形成数量、内部排序，以及未匹配文件保持散开或收入“其他”。
- **叠放交互与 QuickLook 兼容**：叠放在格子内部散开展开和收回，并支持全选内容与复制路径。若 QuickLook 已经运行，在文件上按空格即可转交预览请求，不增加设置项、启动扫描或强制依赖。
- **待办与随记工作流**：支持一条内容关联多个文件，可选择关联原路径或复制到 DeskBox；复制文本时会按中英文格式附带附件路径。新增标签页显示配置、拖到标签页直接改变状态、待办“进行中/本周/本月”视图、列表预览行数，以及 Enter 与 Ctrl+Enter 保存行为互换。
- **外观与自适应内容**：新增云母 Alt、标准亚克力、材质浓度、中性/主题色/无边框颜色，显示密度支持紧凑、标准、宽松和自定义。音乐可强制使用封面或控制布局，纯色材质固定保持完全不透明。
- **Windows 风格设置重构**：将拥挤页面拆为聚焦的三级页面，把全局搜索移入标题栏并改进匹配与结果跳转；三级入口卡片直接提供最重要的选项，页面层级、前置控制和重置语义更加一致。
- **备份、恢复与附件健康检查**：新增带完整性校验的 ZIP 导出/恢复、自动快照、恢复前快照、重启后安全应用恢复、JSON 损坏回退，以及缺失关联文件、缺失托管附件和孤立附件扫描。
- **窗口与动画稳定性**：优化全局显示/隐藏、详情页进出、标题栏收起操作、悬停命中区域、窗口层级、多显示器位置恢复、调整大小参考线和托盘菜单高度。快速操作胶囊与叠放时使用受控状态切换，减少闪烁和卡在中间状态的问题。
- **覆盖安装体验**：安装器现在会在替换应用文件前可靠关闭正在运行的 DeskBox，避免覆盖安装时偶发弹出“重试 / 忽略 / 取消”提示。
- **可维护性与测试**：拆分体积过大的窗口、格子、设置、待办、随记、音乐和天气类，并扩展附件、备份安全、设置迁移与搜索、胶囊边界与隐私、叠放、动画和窗口定位的回归测试。

## 1.2.9 - 2026-07-13

### English

- **Todo experience rebuilt**: Replaced the dense single-page workflow with a card-based task list and a dedicated full-widget detail view. The detail title is a resizable multiline field, metadata actions use a compact horizontal toolbar, and task cards display up to ten lines.
- **Todo scheduling and organization**: Added eight color markers and filters, due date, reminder, recurrence and attachment workflows, recurring-task history handling, and context-menu shortcuts. Reminder and recurrence stay disabled until a due date exists.
- **Todo selection and batch actions**: Added box selection and batch copy, delete, color, reminder, due-date and recurrence commands. Removed native ListView selection residue after opening or returning from details, including the add-task card focus state.
- **Quick Capture redesign**: Reworked notes into a spacious card list and body-only full-widget editor. Added paper/material styles, image add and replace actions, thumbnails, image-specific copy controls, pin state feedback, and optional creation-time display.
- **Quick Capture sorting and batch actions**: Added animated drag sorting for regular and pinned notes while preserving drag-out copy behavior. Added batch copy, delete, pin and paper commands, and fixed stale image previews after returning from details.
- **Responsive widgets**: Reduced the minimum widget size from 200 x 200 to 150 x 150. Refined Weather layouts for small and medium sizes. Music now switches to an artwork-first layout below 180 px, keeps controls and the title readable, centers artwork cropping, reuses title marquee behavior, and applies a slower nonblank artwork transition.
- **Music simplification**: Removed all spectrum/rhythm visuals, settings, ViewModel state and related code. Unified solid playback icons, button sizing and rounded-rectangle hover surfaces across minimal and medium layouts.
- **File and context-menu improvements**: Simplified the native-style vertical menu order, kept Open and Extract text from image, renamed the Explorer command to Open file location, removed Show more options, and placed Delete last. Added file multi-selection actions and ensured commands close their flyouts immediately.
- **Widget title editing**: Rename commands now enter a focused editor immediately. Double-clicking any widget title starts editing, while clicking the remaining title area commits and exits.
- **Dynamic Z-order fixes**: Reworked tray and hotkey activation so all widgets raise together without a one-second flash, repeated activation hides them consistently, and subsequent foreground changes are managed naturally by Windows. Clicking a title raises all widgets; clicking content raises the current widget.
- **Settings and reset behavior**: Global reset now preserves language, startup and feature-widget switches, resets Quick Capture creation-time visibility and resize snapping correctly, clears per-widget title-style overrides, and uses confirmation dialogs for destructive feature-widget resets. Feature-widget menu wording now represents enable/disable rather than deletion.
- **Default settings updated**: New installs and global reset use Comfortable density, Mica material, Thin border, Round corners, segmented Todo and Quick Capture tabs, and hidden Todo footer counts.
- **Performance and memory**: Reduced unrelated Todo refreshes caused by organizer history writes, suppressed redundant settings broadcasts for file operations, tightened cancellation-token and event cleanup, removed music spectrum allocation paths, and improved repeated language/material/theme change behavior.
- **Reliability fixes**: Fixed Quick Capture clearing removing the add-note entry, image-plus-text copy behavior, created-time visibility, image persistence between list and detail views, completed Todo checkmark contrast, overlapping Todo cards, feature-widget reset completeness, and several tray/hotkey layer edge cases.
- **Tests**: Expanded coverage for Todo recurrence, persistence and batch changes; Quick Capture image, ordering and reset behavior; settings defaults; organizer notification suppression; responsive Music layout; and Weather layout thresholds.

### 中文

- **待办体验重构**：将拥挤的单页操作改为卡片任务列表和格子内完整详情页。详情标题支持多行输入并可拖动调整高度，提醒等元数据改为紧凑横排工具栏，任务卡片最多展示 10 行。
- **待办时间与整理能力**：增加 8 种颜色标记和筛选、截止日期、提醒、重复、附件、重复任务历史及右键快捷操作。未设置截止日期时，提醒和重复保持禁用。
- **待办多选与批量操作**：支持拉框多选，以及批量复制、删除、颜色、提醒、截止日期和重复。修复进入详情再返回后的 ListView 选中残留，以及添加任务卡片误显示选中状态。
- **随记重新设计**：改为更舒展的记录列表和仅保留正文的格子内详情编辑。支持纸张材质、添加/替换图片、缩略图、图片独立复制、固定状态反馈和创建时间显示开关。
- **随记排序与批量操作**：普通与固定列表均支持带动效的拖动排序，同时保留拖出复制。新增批量复制、删除、固定和纸张操作，修复详情返回后图片列表不及时刷新的问题。
- **格子自适应布局**：最小尺寸由 200 x 200 降至 150 x 150。优化天气小尺寸和中等尺寸排版。音乐在小于 180 px 时切换为封面优先布局，保留歌名与播放控制，封面始终居中裁剪，复用跑马灯，并使用更慢且不展示空状态的封面过渡。
- **音乐功能精简**：完整移除频谱/节奏视觉、设置、ViewModel 状态和相关代码。统一最小与中等布局的实心播放图标、按钮尺寸及圆角矩形悬浮背景。
- **文件与右键菜单**：恢复流畅的竖排菜单并重新整理顺序，保留“打开”和“提取图片文字”，资源管理器命令改为“打开文件路径”，删除“显示更多选项”，删除命令固定在底部。文件格子增加多选操作，菜单命令执行后立即关闭。
- **格子标题编辑**：点击重命名后立即聚焦编辑；所有格子支持双击标题进入编辑；点击标题剩余空白区域提交并退出。
- **动态层级修复**：重新整理托盘与快捷键唤起逻辑，确保全部格子同时前置、不再闪烁一秒后置底，再次触发可一致隐藏，之后的前后台层级交还 Windows 管理。点击标题唤起全部格子，点击内容只唤起当前格子。
- **设置与重置行为**：全局重置保留语言、开机启动和功能格子开关，正确重置随记创建时间显示与调整大小吸附，清除格子标题栏独立覆盖值。功能格子完整重置增加二次确认，标题菜单文案改为开关而非删除。
- **默认设置调整**：新安装与全局重置默认使用舒适密度、云母材质、细边框、大圆角、待办/随记分段按钮，并关闭待办底部数量。
- **性能与内存**：减少文件整理历史写入引起的无关待办刷新，文件操作不再广播多余设置变更，完善取消令牌和事件释放，删除音乐频谱分配路径，并优化反复切换语言、材质和明暗模式时的生命周期。
- **稳定性修复**：修复清空随记后添加入口消失、图文复制失败、创建时间开关不生效、列表与详情图片不同步、待办完成勾选对比度、待办内容偶发重叠、功能格子重置不完整，以及多项托盘/快捷键层级边界问题。
- **测试**：扩展待办重复与批量变更、随记图片/排序/重置、设置默认值、整理服务通知抑制、音乐响应式布局和天气布局阈值测试。

## 1.2.8 - 2026-07-11

### English

- **Weather widget**: Added a full-featured weather widget with four layout modes (Mini, Compact, Standard, Detailed), city search with offline `cities.json` database and Windows Location API, auto-location, hourly and weekly forecasts, sunrise/sunset times, UV index, precipitation probability, humidity, wind speed, atmospheric pressure, rich skin backgrounds, and configurable refresh interval. Standard view activates at 250×215 and above. Horizontal scrollbar and mouse wheel support for the hourly temperature list. Week forecast fills remaining space and is scrollable even on small widgets. Loading animation with rotating refresh icon and content hiding during refresh.
- **Resize snap guide**: Added `ResizeGuideOverlayService` that detects edge alignment (8px threshold) with other widgets and work area boundaries during widget resize, showing accent-colored highlight bars on matched edges. Integrated into `WidgetWindow`, `QuickCaptureWidgetWindow`, and `ContentWidgetWindow`.
- **Quick Capture fixes**: Widget reset now properly clears all internal data via `QuickCaptureService.ClearAsync()`. Fixed blank display on first tab switch — data now appears immediately instead of requiring multiple switches. Added `ScheduleTransitionSafetyFallback` to `PlayItemsViewTransition` for more reliable content transitions.
- **Settings defaults unified**: Default appearance changed to Mica material, Medium border, Round corners — consistent across new installs, reset-to-defaults, and `AppSettings` initial values. Global reset (`ApplyDefaultPreferences`) now restores `CustomAccentColor` to `#0078D4` and `FocusClickedWidgetOnRaise` to `false`. Todo widget single-widget reset now restores `TodoReminderEnabled` and `TodoDefaultReminderOffsetMinutes`. Weather widget single-widget reset now clears `WeatherLatitude` and `WeatherLongitude` to prevent inconsistent location behavior.
- **Widget title font size**: Content widget titles now dynamically compute `TitleTextSize` and `TitleIconSize` from user settings (`TextSize`/`IconSize`) instead of using fixed values. Added `RefreshMetrics()` method to update title metrics when settings change.
- **Memory leak fix**: `TodoWidgetViewModel` now implements `IDisposable`, and `TodoWidgetContentAdapter` properly disposes the ViewModel on widget disposal, preventing memory leaks.
- **Delete widget button**: Added delete widget option to the "more" menu for all widget types, not just file widgets. Fixed `ContentWidgetWindow` more flyout placement.
- **Settings UI expansion**: Added standalone material type selector (Mica / Acrylic / Solid) and border style selector (None / Thin / Medium) to the Appearance settings page.
- **Widget layer improvement**: Added `SetWindowToDesktopLevel` method in `WidgetLayerService` that pushes windows to desktop level without using `HWND_BOTTOM`, preventing widgets from being hidden by Win+D while staying at desktop level.
- **Localization simplification**: Shortened drag-and-drop diagnostics text across both Chinese and English for clearer, more concise messaging.
- **FolderWatcherService optimization**: Replaced `CancellationTokenSource`-based debounce with `DispatcherQueueTimer`, reducing thread-pool task creation for file system change notifications.
- **Code refactoring — WidgetWindowBase**: Extracted a new `WidgetWindowBase.cs` (1027 lines) consolidating window setup, backdrop management, layer/Z-order control, drag/resize logic, and display-change restoration. `ContentWidgetWindow` and `QuickCaptureWidgetWindow` now inherit from this shared base, eliminating duplicated window management code.
- **Code refactoring — WidgetWindow**: Split `WidgetWindow.xaml.cs` (~5000 lines) into 6 partial classes: `Rename` (335 lines), `Menus` (677), `ItemSurface` (364), `Clipboard` (249), `Selection` (397), `DragDrop` (806). Main file reduced to 2828 lines.
- **Code refactoring — WidgetManager**: Split `WidgetManager.cs` (3532 lines) into 4 partial classes: `WidgetManager.TrayAnimation.cs` (353 lines, tray show/hide animation), `WidgetManager.ZOrder.cs` (376 lines, Z-order/layer management/mouse hook), `WidgetManager.Storage.cs` (595 lines, managed storage/folder mapping/orphan cleanup), `WidgetManager.FeatureWidgets.cs` (889 lines, Music/Weather/Todo/QuickCapture feature widgets). Core file reduced to 1383 lines.
- **Log rotation**: Added `TryRotateLogFileIfNeeded` with a 5MB size threshold — automatically backs up to `.bak` and cleans up old logs.
- **Atomic settings writes**: `SettingsService.SaveToFileOnlyAsync` now writes to a `.tmp` file first, then moves it to the final path, preventing configuration corruption from interrupted writes.
- **Onboarding redesign**: Simplified onboarding animation API and refined the first-run experience.

### 中文

- **天气格子**：新增完整功能天气格子，支持四种布局模式（迷你、紧凑、标准、详细），城市搜索（离线 `cities.json` 数据库 + Windows Location API）、自动定位、逐小时和每周预报、日出日落时间、紫外线指数、降水概率、湿度、风速、大气压、丰富皮肤背景和可配置刷新频率。标准视图在 250×215 及以上尺寸激活。逐小时温度列表支持横向滚动条和鼠标滚轮。周预报填满剩余空间，小尺寸下也可滚动。刷新时显示旋转加载动画并隐藏内容。
- **调整大小参考线**：新增 `ResizeGuideOverlayService`，在调整格子大小时检测边缘对齐（8px 阈值），与其他格子边缘和工作区边界对齐时显示强调色高亮条。已集成到 `WidgetWindow`、`QuickCaptureWidgetWindow` 和 `ContentWidgetWindow`。
- **随记修复**：格子重置现在通过 `QuickCaptureService.ClearAsync()` 正确清理所有内部数据。修复首次切换 Tab 时空白显示的问题——数据现在立即显示，无需多次切换。为 `PlayItemsViewTransition` 添加 `ScheduleTransitionSafetyFallback` 安全兜底，提升内容切换可靠性。
- **默认设置统一**：默认外观改为云母材质、中等边框、大圆角——新安装、恢复默认和 `AppSettings` 初始值三处保持一致。全局重置（`ApplyDefaultPreferences`）现在恢复 `CustomAccentColor` 为 `#0078D4`、`FocusClickedWidgetOnRaise` 为 `false`。待办格子单格子重置现在恢复 `TodoReminderEnabled` 和 `TodoDefaultReminderOffsetMinutes`。天气格子单格子重置现在清除 `WeatherLatitude` 和 `WeatherLongitude`，避免定位行为不一致。
- **格子标题字号**：功能格子标题现在根据用户设置（`TextSize`/`IconSize`）动态计算 `TitleTextSize` 和 `TitleIconSize`，不再使用固定值。新增 `RefreshMetrics()` 方法在设置变化时更新标题度量。
- **内存泄漏修复**：`TodoWidgetViewModel` 实现 `IDisposable`，`TodoWidgetContentAdapter` 在格子销毁时正确释放 ViewModel，防止内存泄漏。
- **删除格子按钮**：所有类型格子的"更多"菜单中均可删除格子，不再限于文件格子。修复 `ContentWidgetWindow` 更多菜单弹出位置。
- **设置页扩展**：外观设置新增独立的材质类型选择（云母 / 亚克力 / 纯色）和边框样式选择（无边框 / 细 / 中）。
- **格子层级改进**：`WidgetLayerService` 新增 `SetWindowToDesktopLevel` 方法，不使用 `HWND_BOTTOM` 即可将窗口推至桌面层级，防止 Win+D 隐藏格子。
- **本地化文案精简**：精简拖拽诊断相关文案（中英文），表述更简洁明了。
- **FolderWatcherService 优化**：将基于 `CancellationTokenSource` 的防抖替换为 `DispatcherQueueTimer`，减少文件系统变更通知时的线程池任务创建。
- **代码重构 — WidgetWindowBase**：提取新的 `WidgetWindowBase.cs`（1027 行），统一窗口设置、背景管理、层级控制、拖拽/调整大小逻辑和显示器变化恢复。`ContentWidgetWindow` 和 `QuickCaptureWidgetWindow` 现在继承此共享基类，消除重复的窗口管理代码。
- **代码重构 — WidgetWindow**：将 `WidgetWindow.xaml.cs`（约 5000 行）拆分为 6 个 partial 类：`Rename`（335 行）、`Menus`（677）、`ItemSurface`（364）、`Clipboard`（249）、`Selection`（397）、`DragDrop`（806）。主文件降至 2828 行。
- **代码重构 — WidgetManager**：将 `WidgetManager.cs`（3532 行）拆分为 4 个 partial 类：`WidgetManager.TrayAnimation.cs`（353 行，托盘显示/隐藏动画）、`WidgetManager.ZOrder.cs`（376 行，层级管理/鼠标钩子）、`WidgetManager.Storage.cs`（595 行，收纳管理/文件夹映射/孤立清理）、`WidgetManager.FeatureWidgets.cs`（889 行，音乐/天气/待办/随记功能格子）。核心文件降至 1383 行。
- **日志轮转**：新增 `TryRotateLogFileIfNeeded`，基于 5MB 大小阈值自动备份到 `.bak` 并清理旧日志。
- **原子化设置写入**：`SettingsService.SaveToFileOnlyAsync` 改为先写入 `.tmp` 临时文件再移动到最终路径，防止写入中断导致配置损坏。
- **新用户引导优化**：简化引导动画 API，优化首次启动体验。

## 1.2.7 - 2026-07-09

### English

- Replaced the fixed 16ms `DispatcherQueueTimer` in widget tray animation with `CompositionTarget.Rendering`, which is driven by the system VSync. Animations now run at the native display refresh rate — 60fps on 60Hz screens, 144fps on 144Hz screens — eliminating visible stutter on high-refresh-rate displays.
- Replaced the triple `Task.Delay` backdrop refresh pattern with a single staged `DispatcherQueueTimer` (80ms → 240ms → 580ms), reducing thread-pool scheduling overhead and keeping all refresh work on the UI thread.
- Removed an empty `PointerMoved` handler from widget item surfaces and added state guards to `PointerEntered`/`PointerExited` so hover surface updates are skipped while the window is closing, animating, or hidden.
- Stopped the music widget's progress, visualizer, and transition timers when the widget is deactivated, and restarted them on activation, eliminating unnecessary CPU usage when the widget is not visible.
- Added a 200ms debounce to `UISettings.ColorValuesChanged` in `ThemeService` so system accent color and theme changes no longer trigger redundant `RefreshAppearance` calls.
- Reduced the icon cache limit from 500 to 200 entries and set `DecodePixelWidth` before `SetSourceAsync` for both icons (48px) and image thumbnails (80px), lowering memory usage from decoded bitmaps.

### 中文

- 将格子托盘动画的固定 16ms `DispatcherQueueTimer` 替换为系统 VSync 驱动的 `CompositionTarget.Rendering`，动画帧率自动跟随显示器刷新率——60Hz 屏 60fps、144Hz 屏 144fps，消除高刷屏上的可见卡顿。
- 将毛玻璃背景的三次 `Task.Delay` 刷新替换为单个分阶段 `DispatcherQueueTimer`（80ms → 240ms → 580ms），减少线程池调度开销，所有刷新工作在 UI 线程定时器内完成。
- 移除格子项目表面的空 `PointerMoved` 事件处理器，并为 `PointerEntered`/`PointerExited` 增加状态守卫，窗口关闭、动画运行或隐藏时跳过无意义的悬停状态计算。
- 音乐格子失焦时停止进度、频谱和过渡定时器，激活时重新启动，消除不可见时的无效 CPU 占用。
- 为 `ThemeService` 的 `UISettings.ColorValuesChanged` 增加 200ms 防抖，系统强调色和主题变化不再触发多次冗余的 `RefreshAppearance` 调用。
- 图标缓存上限从 500 降至 200，并在 `SetSourceAsync` 之前设置 `DecodePixelWidth`（图标 48px、缩略图 80px），降低解码位图的内存占用。

## 1.2.6 - 2026-07-08

### English

- Improved Todo reminder reliability with per-task reminder offsets, snooze state persistence after app restart, and safer reminder grace handling for overdue tasks.
- Added native notification actions for Todo reminders, including completing a task directly from the notification and choosing snooze options from the reminder surface.
- Refined recurring Todo behavior so completed recurrence history can be folded under the active recurring task instead of filling the main list with repeated completed rows.
- Improved Todo and Quick Capture multi-select workflows, including rectangle selection from blank list space, formatted copy, drag-out text packages, and Escape-to-clear behavior.
- Improved Quick Capture tab switching responsiveness by delaying heavier list refresh work, reducing UI-thread churn, stabilizing empty-state layout, and using a softer content transition.
- Updated Quick Capture clipboard defaults so automatic clipboard capture starts disabled by default, and disabling Quick Capture also disables automatic clipboard and image capture.
- Expanded automated coverage for Todo reminders, recurring tasks, Quick Capture clipboard settings, multi-select behavior, and settings defaults.

### 中文

- 优化待办提醒可靠性：支持每条任务独立提醒偏移，应用重启后可以恢复稍后提醒状态，并改进逾期待办的提醒宽限逻辑。
- 系统通知增加待办操作能力，可直接在通知中标记完成，也可以从提醒界面选择稍后提醒。
- 优化重复待办体验：完成后的重复历史可以折叠在当前重复任务下方，避免主列表被大量已完成记录撑满。
- 补齐待办和随记的多选流程，包括从空白区域框选、格式化复制、拖拽导出文本，以及按 Esc 取消选择。
- 优化随记 Tab 切换性能：延迟较重的列表刷新，减少 UI 线程压力，稳定空状态布局，并使用更自然的内容过渡动画。
- 调整随记剪贴板默认策略：自动复制默认关闭，关闭随记功能时会联动关闭自动复制和图片复制。
- 扩展自动化测试，覆盖待办提醒、重复任务、随记剪贴板设置、多选行为和设置默认值。

## 1.2.5 - 2026-07-08

### English

- Improved the Todo widget with due times that keep hour/minute/second precision, native Windows reminder notifications, overdue suffix labels, completed-item sorting, click-to-copy, multi-select copying, and formatted clipboard output.
- Added Todo and Quick Capture drag/drop conversion so text can be moved between the two feature widgets more naturally.
- Added configurable Todo and Quick Capture tab styles, allowing each widget to use either the indicator-style tab bar or the segmented-button style.
- Added configurable top-right widget hover actions under Appearance -> Window appearance details. Users can choose 1 to 3 actions from lock position, lock size, add, more, and delete.
- Refined widget action icons with Fluent icon shapes, better lock-state icons, compact-title sizing, and clearer rendering. Resetting title styles now clears per-widget overrides so widgets follow the global title style again.
- Improved Music widget details, including a horizontal system-volume flyout, light-theme styling fixes, click-away closing, wider slider behavior, and album-ambience corner alignment with the widget corner setting.
- Added an optional file path tooltip switch under File widgets -> File display.
- Improved Direct and Microsoft Store update-channel behavior and wording, including Store-aware manual checks and clearer Direct fallback guidance.
- Expanded tests for Todo reminders, clipboard formatting, settings defaults, update behavior, and title-style reset behavior.

### 中文

- 优化待办格子：截止时间保留时分秒精度，支持 Windows 原生提醒通知、逾期标识、已完成排序、单击复制、多选复制，以及更适合粘贴到聊天和 Markdown 的复制格式。
- 支持待办和随记之间拖拽转换文本，随记文本可以拖到待办生成任务，待办也可以拖到随记保存为记录。
- 待办和随记新增可配置的顶部切换样式，可以分别选择指示条样式或分段按钮样式。
- 在「外观 -> 窗口外观细节」新增右上角悬浮按钮内容配置，可从锁定位置、锁定尺寸、新增、更多、删除中选择 1 到 3 个操作。
- 继续优化格子操作图标：替换为 Fluent 图标形态，锁定状态有独立图标，紧凑标题下图标更小更清晰；重置标题样式时会清除单个格子的覆盖值，让格子重新跟随全局标题样式。
- 优化音乐格子细节：系统音量浮窗改为横向，补齐浅色模式样式，支持点击空白区域关闭，滑杆更宽，封面氛围背景圆角会跟随格子圆角设置。
- 在「文件格子 -> 文件显示」中新增文件路径提示开关，可关闭鼠标移入文件时的完整路径提示。
- 优化 Direct 和 Microsoft Store 两个更新渠道的文案与行为，商店版使用商店更新语义，Direct 版保留更清楚的备用下载引导。
- 扩展自动化测试，覆盖待办提醒、复制格式、设置默认值、更新逻辑和标题样式重置行为。

## 1.2.4 - 2026-07-06

### English

- Fixed the in-app update installation handoff after an update has been downloaded.
- Runs `DeskBox.Updater.exe` from a detached local update-helper directory before starting the installer, so the installer can safely overwrite the DeskBox install directory.
- Updated installer packaging so old versions can update without the running updater locking `DeskBox.Updater.*`.

### 中文

- 修复应用内更新下载完成后，点击安装、确认弹窗后 DeskBox 退出但安装器没有继续执行的问题。
- 安装更新前会先把 `DeskBox.Updater.exe` 复制到本地更新缓存目录，再从缓存目录启动，避免更新助手锁住 DeskBox 安装目录。
- 调整安装包规则，旧版本通过应用内更新安装新版时，不再覆盖正在运行的 `DeskBox.Updater.*` 文件。

## 1.2.3 - 2026-07-06

### English

- Added a configurable desktop widget layer mode under Settings -> General. Users can keep the existing Dynamic behavior or switch to Desktop pinned mode.
- Improved Desktop pinned behavior so visible widgets are reattached to the desktop layer after Show Desktop / Win+D and display-topology refreshes.
- Updated Settings navigation icons to Fluent color icons and refined several Settings layouts for more consistent spacing and card hierarchy.
- Removed redundant ToggleSwitch on/off text while preserving the native WinUI switch visual style.
- Removed extra decorative icons from the widget title icon setting and update-status rows.

### 中文

- 在「设置 -> 常规」新增桌面格子层级模式，用户可以保留现有动态层级，也可以切换到桌面固定层。
- 优化桌面固定层行为，让已显示的格子在“显示桌面”/ Win+D 和显示环境刷新后继续回到桌面层。
- 设置左侧导航图标换成 Fluent 彩色图标，并继续调整设置页卡片间距和层级。
- 删除 ToggleSwitch 多余的开关文字，同时保留原生 WinUI 开关样式。
- 删除“格子标题图标”和“更新状态”行里多余的装饰图标。

## 1.2.2 - 2026-07-06

### English

- Upgraded the Direct/Inno build baseline to .NET 10 and Windows App SDK 2.2.
- Updated installer runtime dependency detection to .NET 10 Runtime x64 and Windows App Runtime 2.2 x64.

### 中文

- 将 Direct/Inno 版本的底层构建基线升级到 .NET 10 和 Windows App SDK 2.2。
- 安装器运行时依赖检测升级为 .NET 10 Runtime x64 和 Windows App Runtime 2.2 x64。

## 1.2.1 - 2026-07-05

### English

- Improved monitor-aware widget positioning for display topology changes, DPI changes, external display plug/unplug, and 1080p-to-4K display swaps. Visible widgets now restore against the current monitor work area, while hidden widgets are rechecked before being shown.
- Added configurable desktop widget title icons with color, filled mono, line mono, hidden, and localized text-label modes. Color icons are now the default for both new installs and restored default preferences.
- Added title-style selection to the file widget blank-area context menu, matching the existing title-bar menu behavior.
- Refined Settings organization by moving the widget title icon preference under Appearance -> Window appearance details.
- Aligned new-user defaults, reset defaults, and invalid-value fallbacks for animation and title-icon preferences. The default widget animation is now consistently `SlideFade`.
- Moved Quick Capture default-view normalization into the Quick Capture settings normalization path.
- Expanded automated coverage for settings defaults, widget title icon defaults, Quick Capture default-view normalization, and monitor-aware widget positioning.

### 中文

- 优化多屏和 DPI 场景下的格子定位：显示器拓扑变化、缩放变化、外接屏插拔、1080p 更换 4K 显示器时，格子会基于当前屏幕工作区重新恢复；隐藏格子在重新显示前也会重新校验位置。
- 新增桌面格子标题图标配置，支持彩色、面性单色、线性单色、隐藏和多语言文字标签模式。新安装和恢复默认设置都默认使用彩色图标。
- 文件格子空白区域右键菜单新增标题样式选择，和标题栏菜单使用同一套行为。
- 设置页继续整理：将格子标题图标偏好收进「外观 -> 窗口外观细节」。
- 对齐新用户默认值、恢复默认值和无效值兜底逻辑：动效和标题图标默认值保持一致，默认格子动效统一为 `SlideFade`。
- 将随记默认视图归一化逻辑挪回随记设置归一化路径，避免后续维护混淆。
- 扩展自动化测试覆盖：设置默认值、格子标题图标默认值、随记默认视图归一化，以及多屏感知的格子定位。

## 1.2.0 - 2026-07-02

### English

- Changed the project license from MIT to GPL-3.0-only for future source code and releases. Previously published MIT-licensed DeskBox versions remain under the MIT License.
- Completed the first large widget architecture refactor after 1.1.10: widgets now share a `WidgetShell`, content host, content factory, registry, session manager, window factory, and diagnostic path instead of keeping each widget type as a separate window implementation.
- Introduced the feature-widget foundation used by Todo, Quick Capture, Music, and future content widgets, including content providers, persisted widget kinds, lifecycle handling, positioning, z-order/session behavior, and settings integration.
- Added the Todo widget as a first-class desktop widget with local storage, task completion, filtering, inline editing, full-screen editing, custom due times, and coverage for store/view-model/content-adapter behavior.
- Added the Music widget with Windows media session integration, playback controls, playback mode switching, system volume control, responsive waveform styles, compact-card layout, long-title marquee behavior, and optional album-color ambience.
- Reworked Quick Capture on top of the newer content/widget infrastructure, with more consistent input and editing surfaces, safer recent-content refresh behavior, cached thumbnails for recent image previews, and reduced duplicate preview loading.
- Unified widget chrome and editing details across file and feature widgets: title bar metrics, title styles, inline editors, full-screen editor surfaces, hover/pressed states, empty states, tooltips, action buttons, segmented controls, and light/dark icon behavior.
- Reorganized Settings around the new architecture: feature-widget controls, appearance groups, file-widget display options, interaction/global hotkey controls, music rhythm options, Quick Capture preferences, and clearer localized labels.
- Improved managed-storage and widget lifecycle maintenance, including safer cleanup/restore paths, default managed storage handling, session persistence, and diagnostics around widget windows.
- Expanded automated coverage for the refactor with tests for content factories, widget registry/session/positioning, content window factory, Todo storage/view models, chrome mode resolution, feature-widget settings, storage cleanup, and Quick Capture thumbnail behavior.
- Updated release metadata, installer versioning, documentation, and dependency notes for the 1.2.0 build. The installer continues to check for .NET 8 Runtime x64 and Windows App Runtime 2.1.3 x64.

### 中文

- 项目授权协议从 MIT 调整为 GPL-3.0-only，适用于后续源码和版本；此前已经按 MIT 发布的 DeskBox 旧版本仍保持 MIT 授权。
- 完成 1.1.10 之后第一轮大规模格子架构重构：文件格子和功能格子开始共享 `WidgetShell`、内容宿主、内容工厂、注册表、会话管理、窗口工厂和诊断路径，不再让每类格子都维护一套孤立窗口实现。
- 建立功能格子基础设施，用于承载待办、随记、音乐以及后续内容格子：包括内容 Provider、格子类型持久化、生命周期处理、位置管理、层级/会话行为和设置页集成。
- 新增待办格子作为一等桌面格子：支持本地存储、完成状态、筛选、行内编辑、全屏编辑、自定义结束时间，并补充存储、ViewModel 和内容适配层测试。
- 新增音乐格子：接入 Windows 媒体会话，支持播放控制、播放模式切换、系统音量控制、自适应频谱、紧凑卡片布局、长歌名循环滚动和可选封面氛围取色。
- 将随记迁移到新的内容/格子基础上，统一输入和编辑体验，优化最近内容刷新，给最近图片生成缩略图缓存，并减少重复预览加载。
- 统一文件格子和功能格子的外壳与编辑细节：标题栏尺寸、标题样式、行内编辑、全屏编辑层、悬停/按下状态、空状态、tooltip、操作按钮、分段控件以及浅色/深色图标行为。
- 按新架构重新整理设置页：功能格子开关、外观分组、文件格子显示、交互/全局快捷键、音乐频谱、随记偏好和本地化标签都做了重新归类和清理。
- 强化收纳目录与格子生命周期维护：包括更安全的清理/恢复路径、默认收纳路径处理、格子会话持久化，以及窗口诊断能力。
- 扩展自动化测试覆盖：新增内容工厂、格子注册/会话/定位、内容窗口工厂、待办存储和 ViewModel、标题栏模式解析、功能格子设置、收纳清理和随记缩略图相关测试。
- 更新 1.2.0 发布元数据、安装器版本、文档和依赖说明。安装器继续检测 .NET 8 Runtime x64 和 Windows App Runtime 2.1.3 x64，缺少时可引导安装。

## 1.1.10 - 2026-06-29

### English

- Fixed Quick Capture recent clipboard monitoring after restart: clipboard event listening now initializes on the UI thread and `Refresh()` safely marshals back to the UI dispatcher when needed.
- Fixed Quick Capture list scrolling when recent content grows beyond the widget height by constraining the list area to the remaining widget space.
- Added the phase-1 widget architecture refactoring plan to document the next stable refactor path before starting the architecture work.

### 中文

- 修复随记最近复制内容在重启后偶发不自动记录的问题：剪贴板事件监听现在在 UI 线程初始化，`Refresh()` 在需要时会安全切回 UI 调度线程。
- 修复随记最近内容过多时列表无法上下滚动的问题：列表区域现在会被限制在格子剩余空间内，内部滚动可以正常工作。
- 新增第一阶段格子架构重构路线文档，作为后续正式重构前的稳定基线。

## 1.1.9 - 2026-06-29

### English

- Fixed clipboard monitoring not persisting after restart: `QuickCaptureEnabled` now defaults to `true`.
- Fixed widget z-order: widgets now follow natural Windows z-order instead of being pushed to bottom. Added 2s safety auto-restore timer.
- Fixed QuickCapture z-order consistency with WidgetWindow: both now use `ClearTopMostOnly`, `BringAllVisibleWidgetsToFront`, and 300ms deactivation guard.
- Improved QuickCapture UI: Sticky Notes style input, search moved to tab bar, expand button for full-screen editing, input only visible on Records tab.
- Fixed toggle switch text localization: deferred to `SettingsRoot.Loaded` for proper control resolution.
- Fixed tray menu font: explicit `FontFamily` fallback when `DefaultMenuFlyoutItemStyle` not found.
- Fixed widget animation: removed scale effect from SlideFade and ScaleSlide effects for pure slide-in.
- Fixed global hotkey (F7) not working after packaged install.
- Fixed delete widget crash: added `_isClosing` guard to `ApplyBackdropPreference`.
- Fixed hotkey toggle: `ShouldHideWidgetsForTrayToggle` now hides when widgets are visible.

### 中文

- 修复剪贴板监控重启后不生效：`QuickCaptureEnabled` 默认值改为 `true`。
- 修复格子 z-order：格子现在跟随 Windows 自然层级，不再被推到底层。新增 2 秒安全自动恢复定时器。
- 修复随记 z-order 与文件格子的一致性：两者都使用 `ClearTopMostOnly`、`BringAllVisibleWidgetsToFront` 和 300ms 失焦守卫。
- 优化随记 UI：便签风格输入框，搜索移到 Tab 栏，展开按钮全屏编辑，输入框仅在记录 Tab 显示。
- 修复开关文字本地化：延迟到 `SettingsRoot.Loaded` 后设置，确保控件已渲染。
- 修复托盘菜单字体：当 `DefaultMenuFlyoutItemStyle` 找不到时，显式设置 `FontFamily` 兜底。
- 修复格子动画：移除 SlideFade 和 ScaleSlide 效果的缩放，纯滑入。
- 修复全局快捷键（F7）打包后不工作。
- 修复删除格子崩溃：`ApplyBackdropPreference` 加 `_isClosing` 守卫。
- 修复快捷键切换：`ShouldHideWidgetsForTrayToggle` 在格子可见时返回隐藏。

## 1.1.8 - 2026-06-29

### English

- Fixed app not launching and tray menu losing WinUI styling on other computers: caused by `EnableMsixTooling` being disabled. Restored to `true` for proper WinUI resource resolution.
- Fixed global hotkey (F7) not working: `OnLaunched` was called multiple times, creating a new `GlobalHotkeyService` that overwrote the already-attached instance. Now reuses existing instance and adds late-attach fallback.
- Fixed toggle switch style consistency: all toggles now use `SettingToggleSwitchStyle`.
- Fixed settings window staying on top when opened from tray right-click.

### 中文

- 修复其他电脑上应用无法启动、托盘菜单丢失样式的问题：`EnableMsixTooling` 被关闭导致 WinUI 资源解析失败，恢复为 `true`。
- 修复全局快捷键（F7）不工作：`OnLaunched` 被多次调用，新创建的 `GlobalHotkeyService` 覆盖了已 attach 的实例。现在复用已有实例并添加延迟 attach 兜底。
- 修复开关样式一致性：所有开关统一使用 `SettingToggleSwitchStyle`。
- 修复从托盘右键打开设置页面后一直置顶的问题。

## 1.1.6 - 2026-06-29

### English

- Fixed settings window staying on top when opened from tray right-click menu. Removed always-on-top logic and let Windows handle z-order naturally.
- Improved widget z-order reliability: reduced safety auto-restore timer from 5s to 2s.

### 中文

- 修复从托盘右键打开设置页面后，设置页面一直置顶挡住其他窗口的问题。移除强制置顶逻辑，让 Windows 自然处理窗口层级。
- 优化格子 z-order 可靠性：安全自动恢复定时器从 5 秒缩短到 2 秒。

## 1.1.5 - 2026-06-29

### English

- Fixed clipboard monitoring not persisting after restart: changed QuickCaptureEnabled default to true so clipboard monitoring starts automatically on first install.
- Fixed widget z-order issue where widgets could get stuck on top after interaction: added 5-second safety timer that auto-restores widgets to desktop layer if they remain topmost without user interaction.
- Improved toggle switch style consistency across all settings: removed visual padding and aligned all toggles to the right edge.
- Simplified corner radius options: removed "System default" option, keeping only Small radius, Round, and Square corners. Default remains Small radius.

### 中文

- 修复剪贴板监控重启后不生效的问题：将 QuickCaptureEnabled 默认值改为 true，首次安装后自动启用剪贴板监控。
- 修复格子交互后可能卡在顶部的 z-order 问题：新增 5 秒安全定时器，如果格子在无用户交互的情况下保持顶部状态，自动恢复到桌面层。
- 统一设置界面所有开关样式：移除视觉内边距，所有开关右对齐。
- 精简圆角选项：移除"系统默认"选项，保留小圆角、圆角、直角三个选项。默认值仍为小圆角。

## 1.1.4 - 2026-06-28

### English

- Fixed widget z-order issue where widgets would stay above fullscreen browser after batch raise. Widgets now properly hide behind other windows when clicking outside.
- Optimized startup initialization: theme refresh and clipboard service now initialize in parallel, reducing launch time by 2-3 seconds.
- Added error handling to critical async event handlers (file drop, drag completion) to prevent unhandled exceptions from crashing the app.
- Added `SafeFireAndForget` helper method for safe async execution in event handlers.

### 中文

- 修复批量唤起格子后点击外部窗口时，部分格子仍留在浏览器上方的层级问题。
- 优化启动初始化：主题刷新和剪贴板服务并行初始化，启动速度提升 2-3 秒。
- 为关键异步事件处理器（文件拖放、拖拽完成）添加错误处理，防止未处理异常导致崩溃。
- 新增 `SafeFireAndForget` 辅助方法，用于事件处理器中的安全异步执行。

## 1.1.3 - 2026-06-27

### English

- Optimized widget animation performance: replaced per-frame Win32 P/Invoke opacity calls with GPU-accelerated Visual.Opacity, cached Composition Visual, and enabled Windows-native cubic bezier easing curves.
- Simplified animation settings: removed redundant direction-specific effects, added a single "Slide direction" dropdown and "Easing intensity" control with None/Light/Standard/Strong options. Direction dropdown is disabled for effects that have no slide component.
- Fixed animation effect inconsistency between file widgets and Quick Capture widgets: both now support the same set of effects with identical parameters.
- Added image thumbnail previews for image files in widgets instead of generic file type icons.
- Fixed single-click file open not working when "Double-click to open" is disabled.
- Fixed right-click triggering single-click open instead of showing the context menu.
- Fixed widget click events being consumed by box selection logic, preventing ItemClick from firing.
- Removed "Focus clicked widget only" setting due to unreliable z-order behavior across different widget types. All widgets now always show and hide together.
- Improved default settings: animation effect defaults to Fade, speed defaults to Standard.

### 中文

- 优化格子动画性能：将每帧的 Win32 P/Invoke 透明度调用替换为 GPU 加速的 Visual.Opacity，缓存 Composition Visual，启用 Windows 原生贝塞尔缓动曲线。
- 精简动画设置：移除重复的方向特定效果，新增统一的"滑动方向"下拉框和"缓动强度"控制（无/轻微/标准/强烈）。方向下拉框在无滑动成分的效果下自动禁用。
- 修复文件格子和随记格子动画效果不一致的问题，两种格子现在支持完全相同的效果和参数。
- 新增图片文件缩略图预览，替代原来的通用文件类型图标。
- 修复关闭"双击打开"后单击无法打开文件的问题。
- 修复右键点击文件时误触发单击打开而非弹出菜单的问题。
- 修复格子框选逻辑吞掉 ItemClick 事件导致点击失效的问题。
- 移除"唤起后仅保留点击的格子"设置，因不同格子类型间 z-order 行为不一致。所有格子现在统一显示和隐藏。
- 优化默认设置：动画效果默认为淡入淡出，速度默认为标准。

## 1.1.2 - 2026-06-26

### English

- Optimized Quick Capture tab switching performance: added equality guards to item view model updates, replaced O(n²) collection diffing with dictionary-based O(n) lookup, and cached tab/item action button brushes to eliminate per-switch allocations.
- Added a new setting "Focus clicked widget only" for batch widget raise behavior. When enabled, clicking one widget hides all others; when disabled (default), all widgets stay visible together.
- Fixed Z-order inconsistency during batch raise from tray: widgets no longer fall behind fullscreen applications when clicking one widget, and the previously-clicked widget no longer stays on top unexpectedly.
- Unified Z-order behavior between file widgets and Quick Capture widgets to prevent asymmetric deactivation handling.

### 中文

- 优化随记格子 Tab 切换性能：为 item ViewModel 更新添加等值守卫，将 O(n²) 的集合同步替换为基于字典的 O(n) 查找，并缓存 Tab 和操作按钮的 Brush 以消除每次切换的对象分配。
- 新增"唤起后仅保留点击的格子"设置。开启后点击一个格子，其他格子自动隐藏；关闭时（默认）所有格子保持可见。
- 修复批量唤起格子时的层级不一致问题：点击格子时其他格子不再跑到全屏应用后面，之前点过的格子也不会意外留在前台。
- 统一文件格子和随记格子的层级处理逻辑，避免两者行为不一致。

## 1.1.1 - 2026-06-26

### English

- Fixed internal dragging for shortcut files (`.lnk`) in managed widgets. DeskBox now keeps its own path-based drag metadata even when Windows cannot convert a shortcut into a `StorageItem`.

### 中文

- 修复收纳格子内快捷方式（`.lnk`）无法长按拖动的问题。即使 Windows 无法把快捷方式转换为 `StorageItem`，DeskBox 也会使用自身的路径数据继续完成格子内拖拽。

## 1.1.0 - 2026-06-26

### English

- Added drag-and-drop diagnostics in Settings with one-click repair for DeskBox compatibility flags, startup entries, and shortcuts. If Windows 10/11 cannot drag files into widgets, run this repair first.
- Improved Explorer drag/drop compatibility for managed and mapped widgets, including native shell message allowance, legacy shell format fallback, and more useful drop diagnostics.
- Fixed widget sorting stability with natural name ordering, deterministic tie-breakers, and correct insertion when new files are added while a sort mode is active.
- Improved Quick Capture text editing: saved text now opens the inline editor on double-click, while the context menu can edit text in Notepad and sync changes back.
- Changed the default tray icon style to colorful for new installs and restored defaults.
- Improved first-run onboarding so it is marked complete after the first install launch and no longer reappears just because widgets are empty.
- Improved installer and uninstall behavior: current-user install remains the default, the install folder can be changed, startup can be selected during setup, and uninstall can optionally keep or remove local DeskBox app data.

### 中文

- 新增设置内的拖拽异常诊断和一键修复，可清理 DeskBox 的兼容性标记、启动项和快捷方式。如果 Win10/Win11 遇到文件拖不进格子的问题，请先运行此修复。
- 优化资源管理器拖拽兼容，收纳格子和映射格子支持更多原生 shell 拖拽消息和旧格式兜底，并输出更完整的拖拽诊断日志。
- 修复格子内排序稳定性，使用更接近 Windows 的自然名称排序，补充稳定兜底，并确保新加入文件按当前排序方式插入。
- 优化随记文本编辑：已保存文本双击进入随记内编辑；右键可选择“在记事本中编辑”，保存关闭后会同步回随记。
- 新安装和恢复默认设置时，托盘图标默认改为彩色。
- 优化新用户引导，首次安装启动后即标记为已完成，不会因为格子为空而每次启动重复弹出；仍可在设置中手动打开。
- 优化安装和卸载体验：继续默认按当前用户安装，支持选择安装目录，安装时可选择开机自启，卸载时可选择保留或删除本地 DeskBox 应用数据。

## 1.0.9 - 2026-06-25

### English

- Reworked Settings into a cleaner Windows-style structure with fewer top-level categories, native ComboBox/NumberBox controls, toggle on/off labels, drill-in rows, and a clearer Quick Capture settings entry.
- Added widget item sorting by name, size, item type, and date modified, with per-widget persistence and repeat-click ascending/descending behavior.
- Improved widget menus by separating title-bar widget management from content-area file actions, including view switching, sorting, paste, refresh, and mapped-folder actions.
- Improved Quick Capture tabs, title buttons, hover actions, copy feedback, and shared show/restore behavior with regular widgets.
- Improved drag/drop compatibility, empty-widget drop handling, managed-vs-mapped drag captions, z-order restoration, icon hydration retries, and Chinese IME support during file/folder rename.
- Changed the installer to current-user installation by default and added automatic migration from older Program Files administrator installs to reduce Explorer drag/drop permission conflicts.
- Added clearer guidance for Explorer drag/drop failures: DeskBox should not be run as administrator, because Windows can block file drops from non-elevated Explorer windows into elevated DeskBox windows.
- Refined first-run onboarding with shorter Windows-style copy and simpler setup choices.

### 中文

- 重构设置页面结构，减少顶层分类，并统一使用原生 ComboBox、NumberBox、带“开 / 关”文字的开关、钻入式设置项和更清晰的随记设置入口。
- 新增格子内排序方式：名称、大小、项目类型、修改日期，并支持按格子保存排序状态和重复点击切换升序 / 降序。
- 优化格子菜单，将标题栏的格子管理操作和内容区的文件操作拆分得更清晰，包括视图切换、排序、粘贴、刷新和映射文件夹操作。
- 优化随记 Tab、标题栏按钮、悬浮按钮、复制反馈，以及与普通格子一致的显示 / 恢复层级行为。
- 增强拖拽兼容、空格子拖放、收纳 / 映射拖拽提示、层级恢复、图标加载重试和文件 / 文件夹重命名时的中文输入法支持。
- 补充拖拽异常排查说明：DeskBox 日常使用不应以管理员权限运行，否则 Windows 可能会阻止普通权限资源管理器向 DeskBox 拖入文件。
- 精简新用户引导文案和设置选项，更贴近 Windows 风格。

## 1.0.8 - 2026-06-24

### English

- Improved Windows 11 23H2 drag/drop compatibility by launching DeskBox after install as the original user instead of inheriting the installer elevation level.
- Improved Explorer drag/drop handling for file widgets by accepting link-style requested operations when the widget can safely resolve them into the configured managed action.
- Improved drag hover captions so managed storage widgets show "managed widget" and mapped-folder widgets show "mapped folder" as distinct targets.
- Improved Quick Capture copy feedback by replacing per-row copy bubbles with a stable bottom-centered toast.
- Improved Quick Capture clipboard writes with short automatic retries when Windows temporarily locks the clipboard, reducing first-click copy failures.
- Tightened Quick Capture title button sizing and hover action styling so More, Delete, and item actions match the regular widget controls more closely.
- Fixed Quick Capture click-to-copy feedback, copy failure messaging, and several post-1.0.7 polish issues around mapped widgets and drag prompts.

### 中文

- 优化 Windows 11 23H2 拖拽兼容性，安装完成后启动 DeskBox 时不再继承安装器管理员层级，而是回到原始用户权限。
- 优化资源管理器拖拽处理，文件格子可兼容部分 link-style 拖拽操作，并按设置中的收纳动作安全处理。
- 优化拖拽悬浮提示，收纳格子显示“收纳组件”，映射文件夹显示“映射文件夹”，目标更清楚。
- 优化随记复制反馈，移除每行内部气泡，统一改为底部居中的稳定 toast。
- 优化随记剪贴板写入，在 Windows 剪贴板被短暂占用时自动短间隔重试，减少第一次单击复制失败。
- 调整随记右上角按钮和记录悬浮按钮尺寸/样式，让更多、删除和记录操作更接近普通格子控件。
- 修复 1.0.7 后发现的随记单击复制反馈、复制失败提示、映射格子拖拽提示等细节问题。

## 1.0.7 - 2026-06-23

### English

- Improved tray and global-hotkey behavior so file widgets and Quick Capture are raised, hidden, and restored as one group.
- Added a light WidgetManager restore path that keeps DeskBox widgets together after menu interactions and restores the group only after the user moves back to another app.
- Improved full-screen app behavior: F7 can raise widgets again when they are visible but covered, and a keyboard-hook fallback prevents apps such as Axure from consuming the configured hotkey first.
- Improved widget show/hide animation with linear timing, shorter default duration, and group-aware off-screen slide distances so adjacent widgets move out consistently.
- Improved Quick Capture layout, hover actions, tab switching, copy/open behavior, image previews, and inline editing for long text.
- Added system-open behavior for Quick Capture items: single click copies with feedback, double click opens text, links, or images in the user's default app.
- Added orphan managed-storage folder management so removed widget folders can be restored, opened, moved back to Desktop, or deleted from Settings.
- Improved managed and mapped widget safety with duplicate-name guards, folder recovery handling, mapped-folder rename sync, icon refresh stability, and file-name display fixes.
- Improved performance and responsiveness around directory refresh, clipboard capture, tab switching, list rendering, and temporary topmost confirmation.

### 中文

- 优化托盘和全局快捷键行为，让文件格子和随记按同一组逻辑统一置顶、隐藏和恢复。
- 新增轻量级 WidgetManager 层级恢复入口，菜单交互后不再由单个窗口自行置底，而是由管理器统一判断整组层级。
- 优化全屏应用场景：格子可见但被外部应用遮挡时，F7 会重新置顶；同时增加快捷键钩子兜底，避免 Axure 等应用先消费快捷键。
- 优化格子显示/隐藏动画，改为线性节奏、更短默认时长，并按整组相对屏幕位置计算滑出距离，减少遮挡和割裂感。
- 优化随记布局、悬浮按钮、Tab 切换、复制/打开行为、图片预览和长文本内联编辑体验。
- 随记支持单击复制并提示成功，双击按系统默认应用打开文本、链接或图片，不再用内部编辑弹框作为双击入口。
- 新增孤立收纳文件夹管理页，已移除格子留下的收纳目录可在设置中恢复、打开、移回桌面或删除。
- 增强收纳格子和映射格子的稳定性，包括重名保护、异常文件夹恢复、映射文件夹改名同步、图标刷新稳定性和文件名显示修复。
- 优化目录刷新、剪贴板记录、Tab 切换、列表渲染和临时置顶确认等性能与响应细节。

## 1.0.6 - 2026-06-21

### English

- Added Quick Capture as an optional feature widget for local text, link, screenshot, and recent clipboard capture workflows.
- Added Quick Capture Records, Pinned, and Recent views with hover actions, compact search, drag-out support, image thumbnails, and save-to-file-widget actions.
- Added upload-friendly storage access: managed storage can be pinned to Quick Access, opened from the tray, and mirrored with folder shortcuts for file pickers.
- Improved drag/drop and clipboard behavior so file drags stay file-first, path copying is explicit, and DeskBox's own clipboard writes are ignored by Recent capture.
- Improved file widgets with custom Explorer icon refresh, filename extension display controls, shortcut-arrow settings placement, and clearer migration progress/result feedback.
- Improved tray/global-hotkey layering so widgets stay temporarily raised until the user clicks another app, and Settings can join the temporary topmost layer when opened during that state.
- Improved Quick Capture polish with scoped-search messaging, target-widget refresh/highlight after saving, compact edit dialogs, tighter tab/action layout, and theme-aligned styling.
- Improved first-run onboarding scaling for high-DPI setups and fixed several small layout, acrylic, and refresh edge cases.

### 中文

- 新增随记功能格子，用于本地保存文本、链接、截图和最近复制内容，功能可在设置中关闭。
- 随记支持记录、固定、最近三个视图，并加入悬停操作、紧凑搜索、拖出内容、图片缩略图和保存到文件格子。
- 增强上传友好入口：收纳路径可固定到快速访问，可从托盘打开，并为文件选择器保留格子文件夹快捷方式。
- 优化拖拽和剪贴板行为：文件拖拽优先保持文件格式，复制路径改为显式操作，并忽略 DeskBox 自己写入剪贴板造成的最近记录污染。
- 优化文件格子：支持资源管理器自定义图标刷新、文件后缀显示控制、快捷方式箭头设置归位，并补充迁移进度和结果反馈。
- 优化托盘和全局快捷键层级：格子临时置顶后，只有点击其他应用才恢复；此状态下打开设置页也会临时置顶。
- 优化随记细节：增加当前视图搜索提示，保存到文件格子后刷新并高亮目标文件，编辑弹窗适配小窗口，tab 和操作按钮布局更紧凑，并跟随 DeskBox 主题色。
- 优化新手引导在高 DPI 缩放下的布局，并修复若干毛玻璃、刷新和界面边界问题。

## 1.0.5 - 2026-06-18

### English

- Rebuilt first-run onboarding with a DeskBox logo intro, a five-step guide, looping right-side feature scenes, and Chinese, English, light-mode, and dark-mode support.
- Added an optional global hotkey that triggers the same show, hide, and temporary-raise flow as the tray left-click action.
- Improved Settings and tray access with managed-storage opening, Quick Access pinning, download-link actions, and maintenance controls.
- Improved storage and mapping workflows, including default storage migration, mapped shortcut sync, orphan managed-folder cleanup, and steadier drag/drop behavior.
- Removed remaining stale blur-toggle plumbing and release animation/window references more promptly after Settings or onboarding closes.

### 中文

- 重构新用户引导：加入前置 DeskBox logo 动效、五步引导、右侧循环演示场景，并适配中文、英文、浅色和深色模式。
- 新增全局快捷键，可在设置中启用，用键盘触发与托盘左键一致的显示、隐藏和临时置顶流程。
- 优化设置和托盘入口，补充打开默认收纳目录、固定到快速访问、下载链接和维护操作。
- 优化文件收纳与映射流程，包括默认收纳路径迁移、映射快捷方式同步、孤立收纳目录清理和拖拽稳定性。
- 清理旧的模糊开关残留，并在设置窗口、新用户引导关闭后更及时释放动画和窗口引用。

## 1.0.4 - 2026-06-16

### English

- Improved tray left-click behavior so raised widgets stay on top while the pointer moves, then return to desktop level only after the user clicks another non-DeskBox window.
- Added follow-up topmost confirmation when raising multiple widgets from the tray so every visible widget is brought forward consistently.
- Improved tray right-click menu positioning by anchoring the WinUI menu from the actual tray icon rectangle and keeping it out of the tray icon hit area.
- Added automatic backdrop refresh retries after widget show, tray reveal, theme, and appearance changes to recover acrylic surfaces that occasionally render as flat gray.
- Reworked Settings into a left-side navigation layout with dedicated General, Appearance, Widget layout, Animation, Storage, Interaction, Maintenance, and About sections.

### 中文

- 优化托盘左键逻辑：格子临时置顶后，移动鼠标不会触发层级恢复，只有点击其他非 DeskBox 窗口才会回到桌面层级。
- 增加多格子托盘置顶后的二次确认，确保可见格子能更稳定地被一起唤起。
- 优化托盘右键菜单定位，菜单会基于真实托盘图标位置弹出，并避开托盘图标点击区域。
- 增加毛玻璃背景自动刷新重试，在显示格子、托盘唤起、主题和外观变化后恢复偶发的灰底问题。
- 重构设置窗口为左侧导航布局，将常规、外观、格子布局、动画、文件与收纳、操作、重置与维护和关于分区展示。

## 1.0.3 - 2026-06-16

### English

- Added configurable widget show/hide animation effects and speed presets in Settings, with Chinese and English labels.
- Reworked tray animation execution to use smoother frame pacing, real window movement for slide effects, and composition-driven opacity/scale transitions.
- Reduced widget animation flicker by avoiding duplicate item transitions during mapped-folder reveal and by restoring the final visual state consistently.
- Improved tray left-click behavior so visible desktop-layer widgets hidden behind other apps are raised temporarily instead of being hidden immediately.
- Improved tray-launched Settings behavior so the Settings window opens temporarily on top and clears topmost state after focus leaves.
- Improved temporary foreground behavior for newly created widgets, widget dragging, and folder picker ownership.
- Added performance logging support and coverage for the performance logger.

### 中文

- 在设置中新增可配置的格子显示、隐藏动画效果和速度预设，并提供中文、英文标签。
- 重构托盘动画执行方式，使用更平滑的帧节奏、真实窗口移动和基于组合层的透明度、缩放过渡。
- 减少映射文件夹唤起时的格子动画闪烁，并更稳定地恢复最终视觉状态。
- 优化托盘左键逻辑：被其他应用遮挡的桌面层级格子会先被临时置顶，而不是立即隐藏。
- 优化托盘打开设置窗口时的临时置顶行为，设置窗口失焦后会清除置顶状态。
- 改进新建格子、拖动格子和文件夹选择器的前台窗口体验。
- 增加性能日志支持，并补充性能日志测试覆盖。

## 1.0.2 - 2026-06-16

### English

- Added Chinese and English localization across widgets, settings, tray menus, onboarding, dialogs, notes, empty states, and status messages.
- Added a language selector in Settings and refreshed localized text dynamically when the user changes languages.
- Reworked onboarding to expose important setup choices directly in the flow, including managed-drop behavior, the default storage path, folder mapping, and startup launch.
- Improved onboarding visuals, right-side step animations, and repeated scene playback so each step better matches the feature being introduced.
- Fixed startup-launch behavior so DeskBox starts silently to the tray after reboot instead of opening Settings.
- Improved tray behavior so right-click "Show all widgets" temporarily raises widgets just like left-clicking the tray icon.
- Improved widget show/hide animation with a unified right-to-left motion, removed per-widget cascade timing, and reduced mapped-widget flicker.
- Improved mapped-folder reveal behavior by suppressing duplicate item transitions during window animation.
- Improved light-mode styling in onboarding and settings, including text contrast, surface colors, and the active-step indicator shape.
- Improved widget selection behavior so selecting an item in one widget clears selections in other widgets.
- Improved drag-selection responsiveness and reduced repeated visual work during rectangle selection.
- Improved shortcut handling so broken `.lnk` files use the native Windows resolve/delete prompt when opened.
- Improved file operations around cut/copy, mapped folders, desktop drag-out refresh, and shell clipboard data.
- Updated README to Chinese by default, added an English README switch, and refreshed release documentation.

### 中文

- 增加中文和英文本地化，覆盖格子、设置、托盘菜单、新用户引导、对话框、提示、空状态和状态消息。
- 在设置中增加语言选择器，切换语言后动态刷新本地化文本。
- 重构新用户引导，在流程中直接暴露拖入处理方式、默认收纳路径、文件夹映射和开机自启等关键设置。
- 优化新用户引导视觉、右侧步骤动效和重复播放，让每一步更贴合对应功能。
- 修复开机自启行为，重启后 DeskBox 会静默启动到托盘，而不是打开设置窗口。
- 优化托盘行为，右键“显示全部格子”会像左键点击托盘图标一样临时置顶格子。
- 优化格子显示、隐藏动画，统一为从右向左的动作，移除每个格子的级联延迟，并减少映射格子闪烁。
- 优化映射文件夹唤起行为，在窗口动画期间抑制重复的项目过渡。
- 优化浅色模式下的新用户引导和设置样式，包括文字对比度、界面颜色和当前步骤指示器形状。
- 优化格子选中行为，在一个格子中选择项目时会清除其他格子的选择。
- 提升框选响应速度，并减少矩形选择过程中的重复视觉工作。
- 优化快捷方式处理，打开损坏的 `.lnk` 文件时使用 Windows 原生解析或删除提示。
- 优化剪切、复制、映射文件夹、拖出到桌面刷新和 Shell 剪贴板相关文件操作。
- 将 README 改为中文默认入口，增加英文 README 切换，并刷新发布文档。

## 1.0.1 - 2026-06-12

### English

- Added a Windows-native onboarding guide, with an entry in Settings for replaying it.
- Improved tray reveal behavior, widget show/hide animations, and temporary foreground behavior.
- Improved default settings, reset-to-defaults, live appearance preview, and display density controls.
- Improved widget file interactions including drag and drop, cut, rename, delete confirmation, and keyboard shortcuts.
- Fixed installer dependency detection for .NET 8 Runtime x64 and Windows App Runtime 2.1.3 x64.
- Improved installer shortcut icons and overwrite-install behavior while preserving user settings and managed files.

### 中文

- 增加 Windows 原生风格的新用户引导，并在设置中提供重新打开入口。
- 优化托盘唤起行为、格子显示隐藏动画和临时前台行为。
- 优化默认设置、恢复默认值、外观实时预览和显示密度控制。
- 优化格子文件交互，包括拖拽、剪切、重命名、删除确认和键盘快捷键。
- 修复安装器对 .NET 8 Runtime x64 和 Windows App Runtime 2.1.3 x64 的依赖检测。
- 优化安装器快捷方式图标和覆盖安装行为，并保留用户设置与收纳文件。

## 1.0.0 - 2026-06-11

### English

- Initial public test release.

### 中文

- 首个公开测试版本。