# WitchDrawer

**Repository Path**: COLORREF/fork_WitchDrawer

## Basic Information

- **Project Name**: WitchDrawer
- **Description**: fork : https://github.com/witchscottishfoldcat/WitchDrawer
桌面管理
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://github.com/witchscottishfoldcat/WitchDrawer
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-02
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: fork

## README

<p align="center">
  <img src="https://raw.githubusercontent.com/witchscottishfoldcat/WitchDrawer/main/src/WitchDrawer.App/Assets/app.png" alt="WitchDrawer Logo" width="128" height="128" />
</p>

<h1 align="center">WitchDrawer</h1>

<p align="center">
  <img src="https://img.shields.io/badge/version-1.3.11-blue" alt="Version" />
  <img src="https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-green" alt="License" />
  <img src="https://img.shields.io/badge/.NET-10.0-purple" alt=".NET" />
  <img src="https://img.shields.io/badge/platform-Windows-blue" alt="Platform" />
</p>

WitchDrawer 是一款基于原生 WPF 构建的轻量级 Windows 桌面文件收纳工具。专为桌面美化和日常文件收纳设计：将常用文件拖入桌面小收纳盒，快速打开，让临时工作资料井然有序。

English: WitchDrawer is a lightweight Windows desktop file drawer built with native WPF. It is designed for desktop beautification and daily file staging.

## 效果展示

[![WitchDrawer 桌面收纳效果展示](docs/images/witchdrawer-desktop-showcase.png)](https://www.bilibili.com/video/BV1zx3c6eEX8/)

▶ [在哔哩哔哩观看 WitchDrawer 视频演示](https://www.bilibili.com/video/BV1zx3c6eEX8/)

## 功能特性

- **普通收纳盒** — 将拖入的文件或文件夹移入 WitchDrawer 的应用数据存储目录
- **映射收纳盒** — 仅存储绝对路径引用，源文件保留在原位
- **像素收纳盒** — 像素风格的收纳盒，为桌面增添趣味
- **桌面浮动窗口** — 每个收纳盒显示为精美的浮动桌面窗口，支持自由拖放定位
- **窗口位置记忆** — 自动记住每个收纳盒在桌面上的位置
- **窗口卷起** — 可手动将普通和映射收纳盒收起到标题栏，并记住每个盒子的卷起状态
- **系统图标** — 拖入的文件显示系统原生图标
- **文件名显示** — 网格视图可按收纳盒显示或隐藏文件名
- **拖出支持** — 可以将项目从收纳盒中拖出作为文件放置
- **跨盒拖放** — 支持在收纳盒之间拖放移动图标
- **快捷面板** — 按 `Ctrl+Alt+W` 跨所有收纳盒搜索并打开项目
- **三套主题** — 清透雅致 / 玻璃光泽 / 水晶棱镜
- **图标大小** — 超大 / 大 / 中 / 小 四档可调
- **可调透明度** — 可分别调节桌面盒子、盒子边线和图标背景框透明度
- **开机自启动** — 可在设置中开启/关闭
- **检查更新** — 自动检测 GitHub Releases 新版本
- **原位还原删除** — 删除收纳项或收纳盒时，普通/像素盒文件恢复到原来的位置；原位置不可用则回退到桌面，重名自动加后缀；映射盒只删除引用
- **窗口恢复** — 可从主页收纳盒菜单恢复单个窗口，或从系统托盘显示全部收纳盒
- **桌面图标隐藏** — 可在设置中隐藏 Windows 桌面文件、文件夹和快捷方式；也可启用双击桌面空白区域快速切换，不移动或删除文件
- **系统托盘** — 最小化到系统托盘，不占用任务栏
- **单实例运行** — 防止重复启动

## 使用说明

- 将文件或文件夹直接拖入收纳盒即可开始使用。
- **普通收纳盒**会把文件或文件夹实际移动到 WitchDrawer 的数据目录，适合由应用统一管理的临时文件。
- **映射收纳盒**只保存源文件的绝对路径，不移动、复制或删除源文件，适合项目目录、工作目录以及经常被其他程序使用的文件。
- 建议文件夹尽量使用映射收纳盒，避免移动大量文件或正在使用的文件；需要保留文件原位置时，请优先选择映射收纳盒。
- Windows 10 暂时可能有部分功能不兼容，建议优先使用 Windows 11。

## 技术栈

| 技术 | 说明 |
|------|------|
| .NET 10 | 运行时 |
| WPF | 原生 Windows UI |
| Win32 API | Shell 打开、全局快捷键、窗口层级 |
| SQLite | 本地持久化（WAL 模式） |
| CommunityToolkit.Mvvm | MVVM 框架 |
| xUnit | 单元测试 |

本项目有意避免使用 Electron、WebView 外壳和沉重的第三方 UI 框架。

## 仓库结构

```text
WitchDrawer.sln
src/
  WitchDrawer.App/       WPF UI、窗口、视图模型、拖放、快捷键绑定
  WitchDrawer.Core/      模型、SQLite 持久化、文件导入/删除规则、更新检查
  WitchDrawer.Native/    Shell 打开、全局快捷键、系统托盘
tests/
  WitchDrawer.Core.Tests/
```

## 环境要求

- Windows 10/11
- .NET SDK `10.0.300` 或兼容的 .NET 10 SDK

> Windows 10 暂时可能有部分功能不兼容，建议优先使用 Windows 11。

## 构建

```powershell
dotnet build WitchDrawer.sln
```

也可以在仓库根目录执行快捷脚本：

```powershell
.\build.ps1
```

该脚本使用 `Release` 配置构建完整解决方案。

### 发布 Windows x64 版本

维护者可在安装 Inno Setup 6 后执行：

```powershell
.\tools\Publish-WitchDrawer.ps1
```

脚本会生成自包含便携 ZIP、`Setup.exe` 安装包及各自的 SHA-256 校验文件。发布前应确认 ZIP 解压后可以启动，并且 GitHub Release 同时上传 ZIP 和 `Setup.exe`；不要只把单个 exe 从发布目录手工压进 ZIP。

## 本地开发

```powershell
.\dev.ps1
```

该脚本使用 `Debug` 配置构建并启动 WPF 应用。

Debug 可执行文件位于：

```text
src/WitchDrawer.App/bin/Debug/net10.0-windows/WitchDrawer.App.exe
```

## 测试

```powershell
dotnet test WitchDrawer.sln
```

测试覆盖：默认收纳盒创建、普通/映射/像素盒导入、重复文件名后缀、跨盒移动、原位还原删除、更新 URL 校验等。

## 运行时数据

```text
%LocalAppData%\WitchDrawer\
  witchdrawer.db          SQLite 数据库
  Boxes\{BoxId}\          普通收纳盒的文件存储
  logs\                   运行日志
```

## 赞助支持

如果 WitchDrawer 对你有帮助，欢迎赞助支持项目的持续开发与维护：

- 赞助页面：[www.witchcat.cn/zh/support](https://www.witchcat.cn/zh/support)
- 也可以在应用内打开 **关于 → 赞助作者**，点击「前往赞助页面」
- 赞助时请备注你的 ID，可加入鸣谢名单

## 开源协议

本项目采用 **CC BY-NC-SA 4.0** 协议开源。

- **BY（署名）**：二次修改必须注明原作者 Thewitchcat
- **NC（非商用）**：禁止商业使用
- **SA（相同方式共享）**：衍生作品必须以相同协议开源

## 作者

- **Thewitchcat**
- 邮箱：witchscottishfoldcat@gmail.com
- 网站：[www.witchcat.cn](https://www.witchcat.cn)
- GitHub：[witchscottishfoldcat/WitchDrawer](https://github.com/witchscottishfoldcat/WitchDrawer)