MultiDesktop

为工作、学习和生活，切换不同的 Windows 桌面文件夹。

快速开始 · 命令行使用 · 加密安全说明 · 源码构建 · 发行页面

项目定位： MultiDesktop 切换的是当前用户的 Windows 桌面目录及可选壁纸，不是 Win + Tab 中的应用窗口工作区，也不是虚拟机或隔离沙箱。运行中的应用不会被隔离。

一款基于 C# / .NET 10 / Windows Forms 的本地桌面管理工具。将工作文件、学习资料和娱乐快捷方式分别保存在不同文件夹，通过主窗口、系统托盘或命令行切换桌面内容，并为不同桌面配置独立壁纸。

切换优先使用 Win32 Shell API；失败时回退到修改注册表并重启资源管理器。添加配置不会自动迁移原桌面文件，公共桌面中的快捷方式仍可能显示。

支持 桌面加密：可以为任意桌面设置密码，切换时需输入密码解锁，离开时自动重新加密，保护你的私密文件。

✨ 功能特性

一键切换桌面：通过 SHSetKnownFolderPath 无感切换桌面文件夹，explorer 自动刷新，无需重启
自定义壁纸：每个桌面可设置独立的壁纸与显示方式（填充/适应/拉伸/平铺/居中/跨屏）
🔒 桌面加密：为桌面设置密码后，文件夹被压缩加密（基于后量子密码学文件加密库），切换时输入密码解锁，离开时自动重新加密
系统托盘：最小化到托盘，右键菜单快速切换桌面
满血 CLI：列出 / 添加 / 删除 / 切换桌面，壁纸、加密、设置、Skills 安装全部可通过命令行完成；支持 --json 结构化输出与稳定退出码，适合 AI 与脚本调用
深色 / 浅色主题：跟随系统或手动切换
UI 与逻辑分层：全部业务逻辑集中在不依赖 WinForms 的核心层，GUI 与 CLI 共用同一套实现

快速开始

运行环境

Windows 系统；项目目标框架为 net10.0-windows，不支持直接在 Linux 或 macOS 上运行。
依赖框架的发行版本需要 .NET 10 Desktop Runtime，从源码构建需要 .NET 10 SDK。
自包含或 NativeAOT 发行包的运行要求、支持架构和最低系统版本，以具体发行说明和测试结果为准。

安装

从 Releases 选择适合系统的发行包，按包内说明运行 MultiDesktop.exe。
备份重要文件并记录原桌面目录。建议先创建一个非重要的测试文件夹体验功能。
点击 添加桌面，填写唯一名称并选择已有文件夹，可选配置壁纸。
保存后选中桌面，点击 切换到选中桌面，或从系统托盘菜单切换。
将原桌面目录也保存为配置，方便切回。退出程序不会自动恢复原桌面。

首次使用时会按需创建配置。普通桌面切换后，原文件仍在原目录；删除桌面配置不等于删除文件，也不等于解除加密。

从源码构建

dotnet build src/MultiDesktop/MultiDesktop.csproj -c Release

🖥️ 界面预览

主窗口

桌面列表展示所有已配置的桌面，支持单选 / 多选
按钮：添加桌面、删除、切换到选中桌面、编辑选中桌面、设置、关于软件
加密桌面在列表中标记为"已加密"，切换时会要求输入密码

添加 / 编辑桌面

输入项	说明
桌面名称	唯一标识，不可重复
桌面路径	必须是已存在的文件夹
启用自定义壁纸	勾选后配置壁纸路径与显示方式
壁纸路径	支持 jpg / png / bmp / gif
显示方式	填充 / 适应 / 拉伸 / 平铺 / 居中 / 跨屏
桌面加密设置	设置 / 修改 / 移除桌面密码

桌面名称必须唯一。 加密包 id 由桌面名称哈希生成，同名桌面会共用同一个加密包而互相覆盖，因此重名会被拒绝。

🔒 桌面加密

加密原理

设置密码时，桌面文件夹先被压缩为 zip，再用 后量子密码学文件加密（PostQuantum.FileEncryption）加密为 Zips\<id>.zip.encrypted，然后删除原明文文件夹
加密包 id 由桌面名称经 FNV-1a 哈希生成，删除或重排桌面不会导致 id 错位
密码不写入桌面配置，但已验证的密码会缓存在本次会话的内存中，以便重新加密。正常密码校验通过实际解密完成，项目没有密码找回机制。

加密安全说明

加密会实际删除原明文文件夹，不只是锁定界面。请先备份，再用非重要数据测试。

退出不等于锁定： 当前退出逻辑不会自动重新加密正在使用的桌面。应先切换到普通桌面，确认重新加密成功后再退出。
解锁时文件为明文： 有权限的其他进程仍可读取文件，不提供应用隔离。
重新加密可能失败： 文件占用、权限不足或空间不足等异常可能让文件保持明文，应认真检查提示。
临时明文会落盘： 压缩、解密与密码验证过程中会产生明文 ZIP 或临时解压目录，正常清理不等于安全擦除。
加密包不是版本备份： 重新加密会替换旧包，应保留独立备份，不应宣称异常情况下绝不丢失数据。
谨慎改名： 加密包 ID 依赖桌面名称。建议先移除加密，再修改名称，最后重新设置密码。
优先使用 GUI 或交互式输入密码： 命令行密码可能出现在终端历史、脚本和进程参数中。

引用加密库不代表整个应用已通过安全审计。

加密流程（GUI）

添加 / 编辑桌面窗口中点击 "桌面加密设置"
首次设置：输入新密码与确认密码，点击确定
修改密码：输入原密码 + 新密码（原密码错误会提示）
移除加密：新密码留空，输入原密码即可
切换到加密桌面时弹窗输入密码；离开已解锁的加密桌面时自动重新加密（会话内密码缓存在内存，退出程序后失效）

加密流程（CLI）

# 添加时直接加密
MultiDesktop add --name "私密" --path "D:\Private" --password 123456

# 为已有桌面设置 / 修改 / 移除密码
MultiDesktop password --name "私密" --new 654321 --old 123456
MultiDesktop password --name "私密" --remove --old 654321

💻 CLI 命令行

不带任何参数时启动图形界面；带参数即进入命令行模式。GUI 与 CLI 共用同一套核心逻辑（Core/），因此行为与提示一致。

命令一览

命令	说明
`list`	列出所有已配置的桌面
`add`	添加桌面（可选壁纸与加密）
`remove`	删除桌面配置（不删除文件夹，也不解除加密）
`switch`	切换当前桌面文件夹
`wallpaper`	设置或取消已有桌面的自定义壁纸
`password`	设置 / 修改 / 移除桌面加密密码
`settings`	查看或修改应用设置
`install-skills`	安装 SKILL.md 并把程序目录加入 PATH
`help` / `version`	帮助 / 版本号

全局选项

选项	说明
`--json`	以 JSON 输出结果，适合 AI 与脚本
`--quiet`	成功时不输出提示
`--no-input`	禁止交互式输入，缺少密码时直接失败（退出码 `5`）
`--password-stdin`	从标准输入读取一个密码
`--help` / `-h`	显示帮助

示例

# 列出（表格 / JSON / 原始 XML）
.\MultiDesktop.exe list
.\MultiDesktop.exe list --json
.\MultiDesktop.exe list --xml

# 添加
.\MultiDesktop.exe add --name "工作" --path "D:\WorkDesktop"
.\MultiDesktop.exe add --name "娱乐" --path "E:\Game" --wallpaper "D:\wall.jpg" --style 拉伸
.\MultiDesktop.exe add --name "私密" --path "D:\Private" --password 123456

# 切换
.\MultiDesktop.exe switch --name "工作"
.\MultiDesktop.exe switch --name "私密" --password 123456

# 壁纸与密码
.\MultiDesktop.exe wallpaper --name "工作" --wallpaper "D:\wall.jpg" --style 适应
.\MultiDesktop.exe wallpaper --name "工作" --clear
.\MultiDesktop.exe password --name "私密" --new 654321 --old 123456
.\MultiDesktop.exe password --name "私密" --remove --old 654321

# 设置与 Skills
.\MultiDesktop.exe settings --color 深色 --exit-mode 询问
.\MultiDesktop.exe install-skills

switch 的补充选项：

选项	说明
`--reencrypt-password <密码>`	离开的加密桌面重新加密所需密码
`--no-reencrypt`	不重新加密离开的加密桌面

CLI 每次调用都是新进程，会话密码缓存为空。若离开的加密桌面需要重新加密而没提供 --reencrypt-password，切换不会被阻塞，但会输出警告说明该桌面文件暂为明文。

退出码

脚本与 AI 可据此稳定判断失败原因，无需解析提示文案：

退出码	含义
`0`	成功
`1`	一般错误（IO 失败、加密失败等）
`2`	参数用法错误
`3`	桌面不存在
`4`	密码错误
`5`	需要密码但禁止交互
`6`	用户取消

密码输入

命令行中的密码会进入终端历史、脚本与进程参数，存在泄露风险。优先级建议：

省略密码 → 交互式隐藏输入（回显为 *）
--password-stdin → 从标准输入读取
--password <密码> → 明文参数，仅用于可信任的本地脚本

提示信息输出到标准输出，错误输出到标准错误，便于管道过滤。

⚙️ 配置文件

配置文件位于程序同目录（不可写时回退到 %AppData%\MultiDesktop）。

DesktopList.xml

存储所有桌面配置，主键为桌面名称：

字段	类型	说明
`桌面名称`	string	唯一标识，主键
`桌面路径`	string	桌面根目录文件夹路径
`是否开启自定义壁纸`	bool	切换到此桌面时是否设置壁纸
`自定义壁纸地址`	string	壁纸图片完整路径
`壁纸显示方式`	string	填充 / 适应 / 拉伸 / 平铺 / 居中 / 跨屏
`是否加密`	bool	该桌面是否已加密

AppSettings.xml

键	类型	有效值	说明
`Color`	int	`0`=跟随系统 / `1`=浅色 / `2`=深色	颜色模式
`ExitMode`	int	`0`=询问 / `1`=最小化到后台 / `2`=退出程序	关闭窗口行为

🛠️ 技术实现

架构分层

业务逻辑与界面完全分离，GUI 与 CLI 是核心层的两个消费者：

src/MultiDesktop/
├── Core/                          核心层：不依赖 WinForms
│   ├── OperationResult.cs         统一结果模型 + CLI 退出码
│   ├── JsonBuffer.cs              零反射 JSON 输出（AOT 安全）
│   ├── AppPaths.cs                配置目录解析
│   ├── DesktopRepository.cs       DesktopList.xml 唯一读写出口
│   ├── DesktopService.cs          桌面增删改查、壁纸配置、当前桌面检测
│   ├── DesktopSwitchService.cs    切换工作流（解锁 → 切换 → 重新加密）
│   ├── EncryptionService.cs       加解密与会话密码缓存
│   ├── PasswordService.cs         密码设置 / 修改 / 移除用例
│   ├── SettingsService.cs         AppSettings 读写
│   ├── WallpaperService.cs        显示方式取值与校验（平台无关）
│   ├── SkillInstaller.cs          SKILL.md 安装与 PATH 写入
│   ├── CliArgs.cs                 命令行解析
│   ├── CliRunner.cs               满血 CLI 命令调度
│   └── Platform/                  平台相关实现（唯一允许调用系统 API 的地方）
│       ├── PlatformInfo.cs            平台判定与提示文案
│       ├── IDesktopPlatform.cs        平台实现接口
│       ├── DesktopPlatform.cs         按运行平台选择实现
│       ├── WindowsDesktopPlatform.cs  Windows：Shell API + 注册表 + 壁纸
│       ├── MacDesktopPlatform.cs      macOS：预留（类注释含落地思路）
│       └── LinuxDesktopPlatform.cs    Linux：预留（类注释含落地思路）
├── Program.cs                     入口 + 窗体间传值的 static 中介
├── ColorModeMap.cs                颜色映射（依赖 WinForms，属 UI 层）
└── frm*.cs                        窗体：只负责收集输入与显示结果

平台支持： 桌面文件夹切换与壁纸设置目前仅实现 Windows。相关系统调用（Shell API、注册表、SystemParametersInfo）已全部收拢在 Core/Platform/ 下，Core 的其余部分与平台无关。

macOS 与 Linux 预留了实现位（MacDesktopPlatform / LinuxDesktopPlatform，类注释中写明了落地思路：macOS 走 ~/Desktop 符号链接 + osascript 壁纸；Linux 走 xdg-user-dirs-update + 按桌面环境分支的 gsettings / plasma-apply-wallpaperimage）。在这两个平台上调用 switch 会得到明确提示而非底层异常，并且会在要求输入密码之前就失败。新增平台只需实现 IDesktopPlatform 并在 DesktopPlatform.Create() 中登记。

约定： 核心层不弹任何对话框，通过 OperationResult（含提示文案、退出码、结构化数据）报告成功与失败；由调用方决定呈现方式 —— GUI 弹 MessageBox，CLI 打印文本或输出 JSON。密码由调用方收集后作为参数传入，核心层不主动询问。

桌面切换

优先方案：SHSetKnownFolderPath(FOLDERID_Desktop, ...) —— 无感切换，无需重启 explorer
回退方案：修改注册表 HKCU\...\Explorer\User Shell Folders\Desktop 与 Shell Folders\Desktop，重启 explorer 生效

壁纸设置

通过 SystemParametersInfo(SPI_SETDESKWALLPAPER, ...) 设置壁纸，同步写入注册表 HKCU\Control Panel\Desktop\WallpaperStyle / TileWallpaper。

构建与发布

源码构建

当前项目配置：

组件	版本 / 用途
C# / .NET	`net10.0-windows`
Windows Forms	窗口与事件处理
AntdUI	`2.4.4`，界面控件
I18N.DotNet	`1.3.1`，国际化相关支持
PostQuantum.FileEncryption	`1.6.0`，文件加解密
程序集版本	`1.3.6.0`

在 Windows 上安装 .NET 10 SDK，在仓库根目录执行：

# 构建，默认自动还原依赖
 dotnet build src/MultiDesktop/MultiDesktop.csproj -c Release

# 启动 GUI；实际操作会修改桌面设置
dotnet run --project src/MultiDesktop/MultiDesktop.csproj

# 命令行模式（任何参数都会进入 CLI）
dotnet run --project src/MultiDesktop/MultiDesktop.csproj -- list --json

# Windows x64 自包含发布示例
dotnet publish src/MultiDesktop/MultiDesktop.csproj -c Release -r win-x64 --self-contained true -o publish/local-win-x64

常规 Release 输出目录为 src/MultiDesktop/bin/Release/net10.0-windows/。

MultiDesktop.AOT.csproj 中启用了 PublishAot=true。实测（.NET 10 + MSVC 14.51 + Windows SDK 10.0.26100）发布成功，产出约 27 MB 的单文件原生 exe，CLI 的 XML 与 JSON 输出均正常。

两点需要注意：

CLI 的 JSON 输出刻意不使用反射式序列化（改用 Utf8JsonWriter 手工写入）。JsonSerializer.Serialize 的反射式路径在 NativeAOT 下会抛 InvalidOperationException: Reflection-based serialization has been disabled；更麻烦的是该异常若冒泡到 GUI 的顶层兜底逻辑会被吞掉，表现为退出码 0 但输出为空，脚本会误判为成功。
构建期仍会报告 System.Data.DataTable.ReadXml / WriteXml 的 IL3050 警告。实测该路径在 AOT 下工作正常（配置文件读写无异常），属保守误报；其余 IL3053 警告来自 WinForms / AntdUI 等依赖库。

发布前仍应在本机验证窗口、XML 配置与加解密功能。

源码导航

文件（相对 `src/MultiDesktop/`）	主要职责
`Program.cs`	启动、CLI 与 GUI 分流、窗体间传值的 static 中介
`Core/CliRunner.cs`	全部 CLI 命令与输出格式
`Core/DesktopSwitchService.cs`	切换工作流（含离开桌面自动重新加密）
`Core/PasswordService.cs`	密码设置 / 修改 / 移除
`Core/EncryptionService.cs`	压缩加密、解密还原、密码校验
`frmMain.cs`	桌面列表、切换工作流与托盘交互（只做 UI）
`frmAddDesktop.cs`	添加和编辑桌面
`frmPassword.cs`	设置、修改和移除密码
`frmInputPassword.cs`	解锁密码输入
`frmSet.cs` / `frmClose.cs`	设置与关闭行为
`frmAbout.cs`	关于窗口
`*.Designer.cs`	对应窗体布局

迁移与问题反馈

迁移时应同时保留 DesktopList.xml、AppSettings.xml、配置目录下的 Zips/，以及配置目录之外的桌面文件夹。仅复制 EXE 不会迁移数据，绝对路径也可能需要重新配置。

启动顶层异常时，程序会尝试在配置目录写入 error.log。欢迎通过 Issues 提交系统版本、程序版本、复现步骤和脱敏后的错误信息。不要上传密码、私密文件或未经检查的配置与加密包。

📄 许可证

MIT License — 详见 LICENSE。

项目主页：https://github.com/Qibowen2008/MultiDesktop

Name		Name	Last commit message	Last commit date
.workbuddy/memory		.workbuddy/memory
pics		pics
publish		publish
src		src
.gitignore		.gitignore
LICENSE		LICENSE
README.MD		README.MD
localize_designer.py		localize_designer.py

Navigation Menu

Repository files navigation

MultiDesktop

✨ 功能特性

快速开始

运行环境

安装

从源码构建

🖥️ 界面预览

主窗口

添加 / 编辑桌面

🔒 桌面加密

加密原理

加密安全说明

加密流程（GUI）

加密流程（CLI）

💻 CLI 命令行

命令一览

全局选项

示例

退出码

密码输入

⚙️ 配置文件

DesktopList.xml

AppSettings.xml

🛠️ 技术实现

架构分层

桌面切换

壁纸设置

构建与发布

源码构建

源码导航

迁移与问题反馈

📄 许可证

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

MultiDesktop

✨ 功能特性

快速开始

运行环境

安装

从源码构建

🖥️ 界面预览

主窗口

添加 / 编辑桌面

🔒 桌面加密

加密原理

加密安全说明

加密流程（GUI）

加密流程（CLI）

💻 CLI 命令行

命令一览

全局选项

示例

退出码

密码输入

⚙️ 配置文件

DesktopList.xml

AppSettings.xml

🛠️ 技术实现

架构分层

桌面切换

壁纸设置

构建与发布

源码构建

源码导航

迁移与问题反馈

📄 许可证

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages