v0.2.5

🎉 Dasktop v0.2.5

Dasktop v0.2.5 是一次围绕桌面图标排布、Box 缩放和窗口尺寸保存的体验优化版本：重点统一了 Box 内文件图标的实际占位与缩放吸附步进，修正了图标背景和悬停区域的贴合方式，也避免了自动收起、启动恢复或 DPI 校准等程序性 resize 误覆盖用户手动保存的 Box 尺寸。

✨ 核心更新

• 网格行高统一：Box 内文件图标的网格行高改为与实际排版共用同一套计算逻辑，减少缩放后出现的视觉错位
• 图标占位优化：调整了 Box 文件图标的纵向间距、内边距和悬停背景高度，让单行文件名的选中区域更贴近内容
• 尺寸保存更稳：缩放事件增加来源判断，自动收起、启动恢复和 DPI 校准触发的 resize 不再覆盖用户真实手动调整结果

🧩 体验优化

• 缩放手感更一致：窗口吸附步进与实际网格排版保持一致，调整 Box 尺寸时更不容易出现“能缩进去但排不齐”的情况
• 图标布局更紧凑：默认图标间距进一步收敛，桌面 Box 在内容密度较高时更利于扫描和浏览
• 选中反馈更准确：图标按钮本身按内容收缩，减少多余背景留白带来的误触感

🛡️ 稳定性优化

• 程序性 resize 过滤：对非用户主动发起的窗口尺寸变化做了区分，降低自动逻辑干扰真实布局的风险
• 保存节流更明确：缩放结束时只在有效手动 resize 场景下落库，减少异常尺寸写入的可能性

🐛 问题修复

• 修复自动收起、启动恢复或 DPI 校准触发窗口 resize 时，可能误覆盖用户手动保存的 Box 尺寸的问题
• 修复 Box 图标视觉高度和网格步进不一致时，缩放后出现的轻微排版偏移问题
• 修复单行文件名场景下图标背景铺满过多、悬停反馈不够贴合内容的问题

⚠️ 版本说明

v0.2.5 不引入新的数据迁移，也不改变现有 Box 的使用方式。本版本主要聚焦桌面图标排布一致性、窗口缩放稳定性和细节体验收口，整体行为保持原有习惯。

📦 安装说明

提供两种安装包格式：

• Dasktop_0.2.5_x64-setup.exe：NSIS 安装程序，推荐大多数用户使用
• Dasktop_0.2.5_x64_zh-CN.msi：MSI 安装程序，适合企业环境或需要静默安装的场景

下载对应的安装包并运行即可

v0.2.4

🎉 Dasktop v0.2.4

Dasktop v0.2.4 是一次偏架构、稳定性和维护性的优化版本：重点重整 Tauri 后端分层、Windows Shell 底层适配、文件传输流程和桌面扫描缓存，让 Box 的文件操作、系统图标收纳、托盘生命周期和原生拖放链路更清晰、更稳定，也为后续功能迭代减少重复代码和隐藏风险。

✨ 核心更新

• 后端分层重构：按 commands、domain、services、infrastructure 重新整理 Rust 后端结构，命令层更薄，业务编排和底层适配边界更清楚
• Windows 适配拆分：拆分原生拖放、Shell 文件操作、右键菜单、系统桌面图标、Shell 虚拟项和图标解析逻辑，减少巨型文件和跨职责代码
• 领域契约收口：集中整理应用事件、桌面策略、剪贴板操作、数据库字段和文件系统常量，减少魔法值散落
• 文件传输流程优化：将 copy、move、map、skip、rename、replace、回滚和备份等流程拆分到更清晰的传输计划与执行模块

🧩 结构优化

• 命令层更轻量：Tauri 命令入口只负责参数转换和调用服务，复杂业务逻辑下沉到服务层
• 桌面服务更聚焦：拆分 Box 文件夹扫描、revision、展示模型构建、文件操作目标解析和 Shell 图标服务
• 应用生命周期拆分：托盘自启状态同步、设置窗口显示和退出前系统桌面图标恢复逻辑独立维护
• Box 文件夹能力收口：真实收纳目录校验、路径命名、拖入处理和删除策略按职责拆分，降低后续改动成本

⚡ 性能优化

• 扫描缓存流程优化：Box 文件扫描复用未变化项目的展示模型和 Shell 图标，减少重复解析
• 排序缓存键优化：桌面文件排序使用缓存 key，避免刷新比较时反复分配小写字符串
• 路径转换复用：统一路径展示和 Windows UTF-16 转换工具，减少重复 to_string_lossy 中转
• HDROP 读写复用：剪贴板和原生拖放共用 HDROP 文件列表解析与写入逻辑，减少重复 Windows 协议处理

🛡️ 稳定性优化

• Shell 资源释放收口：统一释放 COM 分配内存、PIDL、STGMEDIUM 和未被剪贴板接管的 HGLOBAL，降低底层资源泄漏风险
• Shell 文件操作框架统一：回收站删除和 Explorer 感知的文件移动复用同一套 SHFileOperationW 执行框架
• 原生拖放状态管理优化：收敛 DropTarget 回调中的状态写入和 unsafe 范围，减少拖放边界问题
• 桌面路径边界校验：删除 Box 并迁回桌面内容时显式校验桌面路径，避免系统路径异常导致文件处理不清晰

🐛 问题修复

• 修复 Shell 虚拟项和系统桌面图标重复维护 ID 与 CLSID 映射的问题，改为复用统一目录清单
• 修复删除 Box 并迁回桌面内容时未显式校验桌面路径类型的边界问题
• 修复剪贴板写入失败时部分全局内存可能未释放的风险
• 修复多个 Windows 底层模块各自维护 Shell 返回内存释放逻辑，容易遗漏释放边界的问题

⚠️ 版本说明

v0.2.4 继续沿用真实文件夹 Box 模型，不引入新的数据迁移或旧模型兼容分支。本版本主要是后端结构、Windows 底层适配、文件操作稳定性和维护性优化，用户侧使用方式保持不变。

🔒 安全提示

• 删除 Box 仍会按当前删除策略处理对应的真实收纳文件夹，请在删除前确认策略和需要保留的内容
• Box 文件项右键菜单、打开方式、删除到回收站和剪贴板操作仍由 Windows Shell 接管，不改变原生文件操作习惯
• 系统桌面图标收纳保存的是引用关系，退出 Dasktop 时会按接管前状态恢复原生桌面图标显示

📦 安装说明

提供两种安装包格式：

• Dasktop_0.2.4_x64-setup.exe：NSIS 安装程序，推荐大多数用户使用
• Dasktop_0.2.4_x64_zh-CN.msi：MSI 安装程序，适合企业环境或需要静默安装的场景

下载对应的安装包并运行即可

v0.2.3

🎉 Dasktop v0.2.3

Dasktop v0.2.3 是一次偏体验和稳定性的优化版本：重点改进 Box 自动收缩时序、闲置可见度动画、桌面拖拽刷新和文件扫描性能，让 Box 在日常使用中更顺、更稳，也减少不必要的卡顿和误触。

✨ 核心更新

• 自动收缩延迟可调：新增鼠标离开 Box 后的延迟收缩时间设置，可根据使用习惯调整收起节奏
• 闲置可见度动画增强：Box 闲置透明度支持分别配置淡入和淡出时长，显示与隐藏节奏更细腻
• 文件夹扫描缓存优化：Box 文件夹新增版本号判断，无变化时避免重复拉取完整文件列表
• Shell 图标缓存优化：系统虚拟项和文件图标会复用缓存，减少反复解析图标造成的性能消耗

🧩 交互体验

• 右键菜单期间保持展开：打开文件原生右键菜单时，Box 不会因为失焦或鼠标离开而提前收缩
• 标题编辑收缩优化：修改 Box 名称后点击桌面提交时，自动收缩行为会按预期恢复
• 设置分组优化：外观设置中单独整理 Box 收缩时序配置，动画速度、延迟时间和视觉密度关系更清楚
• 菜单误选优化：Box 更多菜单禁用文本误选中，操作体验与设置页保持一致
• 发行版右键菜单隐藏：正式版隐藏 WebView 默认右键菜单，避免出现浏览器式菜单；Box 文件项仍保留 Windows 原生右键菜单

⚡ 性能优化

• 文件列表刷新减负：Box 内容未变化时不替换前端数组引用，减少文件网格不必要的整体重渲染
• 并发刷新合并：多个入口同时触发刷新时会合并请求，避免重复扫描
• 桌面拖拽刷新优化：系统桌面图标拖入或拖出 Box 后，Windows 桌面原生图标状态刷新更及时
• 快捷方式图标解析优化：改进 .lnk 图标提取和透明度处理，提升部分快捷方式图标显示效果

🐛 问题修复

• 修复开启 Box 自动收缩后，文件原生右键菜单打开期间会提前收缩的问题
• 修复关闭文件原生右键菜单时可能重复触发收缩动画的问题
• 修复修改 Box 名称并点击桌面提交时不会自动收缩的问题
• 修复系统桌面图标拖入或拖出 Box 后，Windows 桌面原生图标显示状态刷新明显滞后的问题
• 修复设置面板切换时滚动位置异常，影响切换动画的问题
• 修复退出时 WebView2 进程可能触发类注销失败的问题

⚠️ 版本说明

v0.2.3 继续沿用 v0.2.2 的真实文件夹 Box 模型。本版本主要是交互、性能和稳定性优化，不引入新的数据迁移或旧模型兼容分支。

🔒 安全提示

• 卸载器中文提示已更新：如果卸载时选择删除配置和应用数据，可能会删除 Dasktop 创建的 Box 文件夹及其中内容
• 卸载前请先转移需要保留的 Box 文件夹内容，避免误删重要文件
• Box 文件项右键菜单仍由 Windows Shell 接管，不改变原生文件操作习惯

📦 安装说明

提供两种安装包格式：

• Dasktop_0.2.3_x64-setup.exe：NSIS 安装程序，推荐大多数用户使用
• Dasktop_0.2.3_x64_zh-CN.msi：MSI 安装程序，适合企业环境或需要静默安装的场景

下载对应的安装包并运行即可。

v0.2.2

🎉 Dasktop v0.2.2

Dasktop v0.2.2 是一次重要的整理模型升级：Box 从早期的「虚拟映射」调整为「真实文件夹映射」。每个 Box 现在都对应一个真实收纳文件夹，文件拖入、拖出、删除和打开都围绕 Windows 文件系统能力展开，同时继续保留桌面分组、系统图标收纳和原生交互体验

✨ 核心更新

• 真实文件夹 Box：每个 Box 对应一个真实文件夹，Box 内内容来自实际文件夹扫描，不再只是旧版虚拟路径映射
• 收纳根目录：支持设置新建 Box 的收纳根目录，后续 Box 会在该目录下创建对应文件夹
• 拖入处理策略：外部文件拖入 Box 时支持移动、复制或映射，便于在整理效率和原文件位置之间自由取舍
• 拖出处理策略：Box 内文件拖回桌面时同样支持移动、复制或映射，整理关系更加可控
• 打开真实文件夹：可直接从 Box 菜单或设置页打开对应的真实文件夹，方便在 Explorer 中查看和管理
• 删除策略增强：删除 Box 时可选择将内容移回桌面、保留真实文件夹或放入回收站

🖥 桌面与系统图标

• 系统桌面图标收纳：支持将「此电脑」「回收站」「网络」「控制面板」「用户文件夹」拖入 Box 管理
• 自动隐藏原生图标：系统桌面图标被收纳后，可自动隐藏 Windows 原生桌面上的同名入口
• 退出自动恢复：Dasktop 退出时会恢复系统桌面图标到接管前状态，下次启动后再按 Box 引用重新接管
• Shell 虚拟项独立管理：系统图标没有真实文件路径，会单独保存引用，避免误触真实文件复制、剪切、重命名或删除逻辑

🧩 交互体验

• 应用单实例：重复启动 Dasktop 时不再多开主进程，而是唤起已有应用的设置窗口
• 拖拽排序提示：Box 内拖动文件时，通过插入线提示释放后的目标位置
• 多来源排序落点：支持桌面文件、跨 Box 文件和系统虚拟图标拖入 Box 时按目标位置入列
• Box 文件操作：支持类 Windows 的选择、重命名、复制、剪切、粘贴和 Delete 操作
• 文件名显示优化：重命名输入改为多行文本区域，长文件名编辑和展示更自然

🛠 体验优化

• 菜单尺寸优化：Box 更多菜单高度跟随内容自然撑开，减少内容裁切和多余滚动条
• 菜单动画优化：打开与关闭动画改为可打断的淡入淡出，快速操作时更稳定
• 设置窗口优化：右侧内容切换动画与左侧菜单选中态节奏保持一致
• 桌面拖入体验优化：取消额外拖拽虚影，仅保留排序落点反馈
• 版本信息统一：关于面板与侧栏统一读取包版本和作者，减少发布信息不同步

🐛 问题修复

• 修复 Tauri 拖放事件丢弃扩展字段，导致系统桌面图标拖入 Box 后无法入库的问题
• 修复 Box 内 Shell 虚拟项复制、剪切、重命名和真实文件删除链路误触真实文件操作的风险
• 修复 Box 菜单在部分分辨率下被裁切的问题
• 修复 Box 重命名输入框内 Ctrl+A、Ctrl+C、Ctrl+V、Ctrl+X 误触发文件区快捷键的问题
• 修复设置面板切换时偶发显示滚动条的问题
• 修复 Box 框选拖到边缘时框选层撑出滚动条的问题
• 修复 Box 更多菜单快速打开关闭时偶发出现缩放感或动画卡顿的问题

⚠️ 版本说明

v0.2.2 调整了 Box 的底层整理模型：普通文件、文件夹和快捷方式现在会进入真实 Box 文件夹，具体行为取决于你选择的移动、复制或映射策略。旧版虚拟映射逻辑已被替换，本版本不保留旧数据结构兼容分支

🔒 安全承诺

• 删除 Box 前会按当前删除策略处理真实文件夹，不会静默清空文件
• 选择「保留文件夹」时，只删除 Dasktop 内的 Box 记录，真实文件夹仍会保留
• 选择「移回桌面」或「进回收站」时，会沿用 Windows 文件系统能力处理真实文件
• 收纳系统桌面图标只管理显示和引用关系，不会删除系统入口
• Dasktop 退出时会尽量恢复被接管前的系统桌面图标显示状态

📦 安装说明

提供两种安装包格式：

• Dasktop_0.2.2_x64-setup.exe：NSIS 安装程序，推荐大多数用户使用
• Dasktop_0.2.2_x64_zh-CN.msi：MSI 安装程序，适合企业环境或需要静默安装的场景

下载对应的安装包并运行即可

v0.1.0

🎉 Dasktop v0.1.0

Dasktop 是一款面向 Windows 桌面的轻量整理工具。通过可移动、可调整大小的 Box，将桌面上的文件、文件夹和快捷方式按用途分组，让桌面保持清爽，同时保留原有文件位置和系统打开方式。

✨ 核心功能

• 桌面分组管理：创建多个 Box，按工作、项目、资料、工具等场景分类整理桌面
• 自由布局：Box 支持拖动、缩放，并提供智能吸附功能
• 快速收纳：将桌面文件拖入 Box 即可形成清晰的分组关系
• 保持系统体验：文件使用 Windows 默认程序打开，保留系统原生右键菜单
• 外观自定义：支持浅色/深色/跟随系统主题，可调整透明度、圆角、图标和文字样式
• 桌面图标控制：可选择隐藏系统原生桌面图标，只保留整理视图
• 开机自启：登录后自动恢复上次整理好的桌面布局
• 系统托盘集成：便捷的托盘菜单入口

🔧 技术栈

• 基于 Tauri 2.x 构建，提供原生性能体验
• Vue 3 + TypeScript 前端架构
• 支持 Windows Shell 虚拟桌面项集成

⚠️ 版本说明

这是首个公开版本 (v0.1.0)，主要用于产品演示、试用反馈和功能验证。欢迎提供使用反馈和功能建议。

🔒 安全承诺

• 删除 Box 只会删除分组，不会删除真实文件
• 隐藏系统桌面图标只影响显示，不会移动或清空文件
• 所有文件操作沿用 Windows 系统能力

📦 安装说明

提供两种安装包格式：

• Dasktop_0.1.0_x64-setup.exe：NSIS 安装程序，推荐大多数用户使用
• Dasktop_0.1.0_x64_zh-CN.msi：MSI 安装程序，适合企业环境或需要静默安装的场景

下载对应的安装包并运行即可