DesktopNote - 桌面便签

一个简洁、优雅的Windows桌面便签应用，支持富文本编辑、多窗口管理、窗口置顶等功能。

功能特性 • 快速开始 • 使用说明 • 开发 • 贡献

---

✨ 功能特性

核心功能

• 📝 富文本编辑 - 支持字体、字号、颜色等格式设置
• ⚡ 实时格式应用 - 更改格式后立即生效，变更属性优先于继承
• 🪟 多窗口管理 - 每个便签独立窗口，可同时显示多个
• 📌 窗口置顶 - 支持普通、置顶、嵌入桌面三种模式
• 🎨 自定义样式 - 可调整背景颜色、透明度、边距、行距
• 🔒 位置锁定 - 防止误操作移动窗口
• 👻 鼠标穿透 - 便签可设置为鼠标穿透模式
• 💾 自动保存 - 编辑内容自动保存，不会丢失

界面特性

• 🎯 智能工具栏 - 鼠标悬停/激活时显示，失焦自动隐藏
• 🌈 彩色边框 - 多种颜色可选，便于区分不同便签
• 🖱️ 便捷操作 - 支持拖动、调整大小、快捷键
• 🔧 系统托盘 - 托盘图标管理所有便签

数据安全

• 💾 可靠存储 - 采用原子性文件操作，防止数据损坏
• 🔐 并发安全 - 文件锁机制防止数据冲突
• 📦 自动备份 - 保存时自动创建备份文件
• 🛡️ 错误恢复 - 数据损坏时自动恢复备份

---

🚀 快速开始

系统要求

• 操作系统: Windows 10 或更高版本
• 运行时: .NET 8.0 Runtime（如果使用自包含版本则不需要）

下载安装

方式一：下载预编译版本（推荐）

1. 访问 Releases 页面
2. 下载最新版本的 DesktopNote-v1.1.0-win-x64.zip
3. 解压到任意目录
4. 运行 DesktopNote.exe

方式二：从源代码构建

# 克隆仓库
git clone https://github.com/watersfree/DesktopNote.git
cd DesktopNote

# 构建
dotnet build -c Release

# 运行
dotnet run

---

📖 使用说明

基本操作

创建便签

• 右键点击系统托盘图标
• 选择 便签管理 → ➕ 新建便签
• 新便签窗口会自动打开

编辑便签

• 直接在窗口中输入或粘贴文本
• 使用工具栏调整字体、字号、颜色
• 所有更改自动保存

删除便签

• 右键托盘图标 → 便签管理 → 选择便签 → 🗑️ 删除此便签
• 确认后便签及窗口将被删除

高级功能

窗口模式

• 普通模式: 常规窗口，可最小化到任务栏
• 始终置顶: 窗口保持在所有窗口最前方
• 嵌入桌面: 窗口嵌入桌面背景（在图标下方）

鼠标穿透

启用后鼠标可以"穿过"便签窗口，便签变为只读显示。
恢复方法：托盘菜单 → 关闭所有鼠标穿透

位置锁定

锁定后窗口无法移动，防止误操作。
解锁方法：托盘菜单 → 解锁所有位置

工具栏固定

点击工具栏的 📍 按钮可固定工具栏，使其在失焦时也保持显示。

快捷操作

操作	方法
移动窗口	拖动顶部彩色边框
调整大小	拖动右下角调整手柄
显示/隐藏工具栏	鼠标悬停在窗口上
快速访问菜单	双击托盘图标

---

🛠️ 开发

技术栈

• 框架: WPF (.NET 8.0)
• 语言: C# 12
• 架构: MVVM-lite（轻量级模式）
• 数据存储: JSON + Base64

项目结构

DesktopNote/
├── Core/              # 核心功能（窗口管理、Win32 API）
├── Services/          # 服务层（数据服务、快捷键）
├── Models/            # 数据模型
├── Controls/          # 自定义控件
├── Resources/         # 资源文件
├── App.xaml           # 应用程序入口
├── MainWindow.xaml    # 主窗口
└── DesktopNote.csproj # 项目文件

构建命令

# Debug构建
dotnet build

# Release构建
dotnet build -c Release

# 创建自包含发布包（不需要.NET Runtime）
dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true

# 创建框架依赖发布包（需要.NET Runtime，体积更小）
dotnet publish -c Release -r win-x64 --self-contained false

运行测试

# 运行应用
dotnet run

# 清理构建
dotnet clean

---

🤝 贡献

欢迎贡献代码、报告问题或提出建议！

如何贡献

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

报告问题

请使用 Issue Tracker 报告问题，提供以下信息：

• Windows版本
• .NET版本
• 问题描述和重现步骤
• 错误截图（如果有）

---

📝 更新日志

查看 CHANGELOG.md 了解版本更新历史。

---

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

---

🙏 致谢

• WPF框架团队
• 所有贡献者和用户

---

📧 联系方式

• 项目仓库: GitHub
• 问题反馈: Issues

---

如果这个项目对你有帮助，请给一个 ⭐ Star！

Made with ❤️ by watersfree