CrabDesk 1.0.1

CrabDesk 1.0.1

把杂乱的桌面装进盒子 —— 面向 Windows 10/11 的开源桌面整理工具。

CrabDesk 让你在桌面上创建可自由排列的「盒子」，把文件、文件夹和快捷方式按自己的习惯收纳进去。文件始终留在原地 —— 拖入盒子只改变逻辑分组，不复制、不移动，也不改变任何路径。盒子直接嵌入 Explorer 桌面层，而不是悬浮置顶窗口，因此 Win+D / Win+M 后依然可见，普通应用和全屏窗口也能正常覆盖它。

本版本是 1.0 稳定版的最新维护更新，包含下方列出的修复与体验改进，同时也适用于第一次接触 CrabDesk 的用户：下载 CrabDesk-Setup-x64.exe 安装即可。

✨ 主要特性

📦 桌面盒子

• 盒子嵌入 Explorer 桌面层，Win+D / Win+M 后依然可见
• 自由移动、缩放、折叠；标题栏内直接重命名
• 折叠的盒子在鼠标悬停时自动展开，移开后恢复
• 圆角抗锯齿渲染，透明边缘透出壁纸；可配置背景与强调色、35%–100% 不透明度、边框和缩放手柄
• 网格 / 列表两种视图，可调整图标尺寸与间距

🔗 虚拟分组，文件不动

• 拖入盒子只更新逻辑分组，不复制文件、不改变路径
• 分组项的原生图标停放到桌面可视区域外，移出盒子时恢复原位置
• 未分组的项目继续由 Explorer 原生显示和交互，CrabDesk 不重绘代理图标，也不替换桌面右键菜单

🧠 自动整理与 AI 分类

• 按类型、扩展名、名称通配符配置整理规则，一键应用到桌面图标
• 规则用紧凑表格编辑，启用状态、匹配模式和目标盒子一目了然
• 可选接入 OpenAI 兼容接口做 AI 分类：自定义标签（自动创建同名盒子）和提示词；只发送图标名称，不上传图标图片或文件内容，API Key 保存在本机

📁 映射盒子

• 绑定任意文件夹并实时显示其内容，支持只读模式与离线重连状态提示

🖥️ 多显示器与桌面兼容

• 多显示器布局、盒子跨屏拖放、DPI 自适应
• 与 Wallpaper Engine 等动态壁纸层级兼容
• Explorer 重启后自动恢复布局和图标位置

🎨 主题与外观

• 设置窗口、托盘菜单、盒子均支持浅色 / 深色 / 跟随系统
• 设置窗口可选 Mica / Acrylic 等 Fluent 背景材质

💾 备份与恢复

• 手动与每日自动备份，可配置保留策略；导入、导出、一键恢复
• 恢复前自动回滚备份，重置布局前自动备份

⚡ 效率与更新

• 全局快捷键：「显示桌面」「立即整理」，注册冲突实时提示
• 托盘图标、单实例、开机自启
• 通过 GitHub Releases 检查更新（稳定版 / 测试版通道），应用内下载，SHA-256 与发布者校验
• 「关于」页提供桌面宿主、显示器 / DPI 诊断信息，可一键复制

🆕 1.0.1 更新内容

• 新建盒子默认尺寸：新创建的普通盒子、右键菜单创建的盒子和映射文件夹盒子默认使用 244 × 288 DIP，并保留现有盒子的自定义尺寸。
• 管理盒子几何编辑：设置页“管理盒子”现在显示所选盒子的工作区 DIP 位置与尺寸，可直接编辑 X、Y、宽度和高度；修改会立即应用并沿用工作区边界、动态最小尺寸和持久化逻辑。
• 右键菜单创建位置：从桌面 Explorer 右键菜单创建盒子时，新盒子会尽量跟随菜单触发位置，并兼容多显示器、负坐标、工作区偏移和 DPI 缩放。
• 悬停展开动画：图标仍在异步加载时也会使用临时动画缓存，减少动画期间的整盒重绘和掉帧。
• 更新检查缓存：应用升级后会丢弃由旧版本生成的更新缓存，避免旧的 ETag 或“已是最新”状态遮挡新版本。

📥 安装

系统要求：Windows 10 / 11（64 位）

安装包	说明
CrabDesk-Setup-x64.exe	推荐入口：内嵌 CrabDesk 应用负载，检测并仅下载缺失的 Microsoft 运行组件
CrabDesk-Payload-x64.exe	已具备运行依赖时使用的应用安装负载
SHA256SUMS.txt	发布文件的 SHA-256 校验值

Setup 自身采用 Native AOT，不依赖目标电脑预先安装 .NET，CrabDesk 应用本体作为内部负载嵌入其中。安装包会自动检测并补装缺失的 .NET Desktop Runtime、Windows App Runtime 和 Visual C++ 运行库。

🚀 快速开始

1. 启动 CrabDesk，从托盘菜单或设置页创建一个盒子
2. 把桌面上的文件、文件夹、快捷方式拖进盒子 —— 只是归类，不会移动文件
3. 在「整理规则」页配置规则或启用 AI 分类，一键把桌面整理干净
4. 把常用文件夹添加为映射盒子，随时查看内容

🔒 隐私与安全

• CrabDesk 不收集任何使用数据，所有配置仅保存在本机（%LocalAppData%\CrabDesk）
• AI 分类只向接口发送图标名称；API Key 本地保存，不上传
• 更新下载强制校验 SHA-256，并校验发布者一致性
• 详细说明见 PRIVACY.md

⬆️ 升级说明

• 本版本保持现有布局数据格式，不会重置已保存盒子的尺寸、位置或内容
• 建议升级前在“布局备份”页面创建一次手动备份
• 发布包未配置 Authenticode 代码签名，完整性依赖 HTTPS 与 SHA256SUMS.txt 校验

📄 许可证

GPL-3.0 © CrabDesk contributors