KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

WitchDrawer

★ 153 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

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 桌面收纳效果展示](https://raw.githubusercontent.com/witchscottishfoldcat/WitchDrawer/main/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` 配置构建完整解决方案。

## 本地开发

```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\                   运行日志
```

## 开源协议

本项目采用 **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)

WitchDrawer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README