Desktop Stickies

Desktop Stickies 是一款专为 Obsidian 打造的拟物化独立桌面便笺插件。融合桌面悬浮纸质便笺与 Obsidian 原生 Live Preview 实时预览引擎，既保留了经典便笺的极简即时手感，又让所有灵感数据无缝沉淀在你的本地 Markdown 知识库中。

🌟 核心特性

• 🪟 原生桌面独立悬浮小窗：脱离主库网格限制，通过独立小窗悬浮在桌面上，随手记录与参考；
• 📌 真·桌面置顶 (Always on Top)：基于底层 Electron 窗口能力，一键让便笺常驻在所有软件窗口最上层；
• 🧹 任务栏防拥挤 (Skip Taskbar)：便笺小窗自动从 Windows 任务栏隐藏，任务栏永远只保留 1 个主程序图标，保持桌面清爽；
• 🗂️ 桌面便笺管理器 (Notes Hub)：主库一键唤出便笺管理器，瀑布流卡片检索所有历史便笺，支持关键字即时过滤与重新唤醒；
• 🎨 7 款经典与暗夜便笺纸皮肤：经典黄、薄荷绿、樱花粉、晴空蓝、香芋紫、简约白，新增暗夜碳黑 (Charcoal) 专为深色模式与夜间护眼打造；
• 🫧 工具栏智能居中与自动隐藏：富文本工具栏绝对水平居中；鼠标移出便笺时工具栏自动平滑隐藏，移入时优雅浮现，提供极致沉浸感；
• ⚡ 原生 Markdown 实时预览 (Live Preview)：直接输入 Markdown 语法，标题、列表、复选框即打即显、所见即所得；
• 🛠️ 全套富文本快捷工具栏：
  • 待办清单 (Checklist)：插入/切换待办，支持多选内容批量打勾与取消，光标自动定位；
  • 无序列表与有序列表：支持多选批量转换，有序列表自动按序号递增编号；
  • 删除线：选中文本一键划线包裹；
  • 插入本地图片：点击直接拉起资源管理器选图，自动存入 Vault 并生成标准引用；
  • 标题与 YAML 一键显隐：默认隐藏顶栏多余标题和属性面板，提供独立按钮随需展开；
• 🗑️ 删除与关闭生命周期分离：工具栏提供「移入废纸篓」按钮，明确区分收起小窗与安全删除笔记；
• 🖥️ 屏幕边界越界保护：拔插外接显示器或切换多屏时，自动将漂移的便笺拉回当前屏幕可视区域；
• 🌐 原生中英文国际化 (i18n)：自动识别 Obsidian 系统语言，命令、设置、工具栏与提示无缝切换中文/英文；
• 💾 100% 本地 Markdown 存储：自动持久化为本地 .md 文件，位置、尺寸、皮肤与置顶状态记录于 YAML Frontmatter 中，多端同步无障碍。

🚀 快速上手

1. 手动安装

1. 下载项目构建产物 main.js、styles.css、manifest.json；
2. 在你的 Obsidian 库目录中，找到 .obsidian/plugins/，新建文件夹 desktop-sticky-notes；
3. 将上述三个文件拷贝到该文件夹中；
4. 在 Obsidian 的「设置」➔「第三方插件」中刷新并启用 Desktop Sticky Notes。

2. 使用方法

• 新建便笺：点击左侧功能栏（Ribbon）的便签纸图标，或按 Ctrl+P 输入 新建桌面便笺；
• 打开便笺管理器：点击左侧功能栏的网格图标，或按 Ctrl+P 输入 打开桌面便笺管理器；
• 将现有笔记作为便笺打开：在主库文件列表右键任意 .md 笔记，选择「以桌面便笺打开 (Open as desktop sticky note)」；
• 关闭便笺：点击便笺右上角的 ×，内容已实时自动保存，窗口安全关闭；
• 删除便笺：点击便笺右上角的 🗑️ 垃圾桶图标，将笔记移入废纸篓。

3. 工具栏快捷功能

• 便笺置顶 (Pin)：点击图钉图标，便笺常驻在桌面最上层（置顶时图钉高亮变红）；
• 换肤调色盘：内置 7 种经典拟物底色（含暗夜碳黑），即点即切；
• 待办清单 (Checklist)：快速插入 - [ ] ，支持多选多行批量打勾或取消；
• 编号与列表：支持多选自动递增编号（1. 2. 3...）；
• 插入图片：点击直接拉起资源管理器选图，自动存入附件并生成标准引用；
• 标题与 YAML 显隐：一键切换笔记大标题与属性面板，按需展开。

🛠️ 本地开发与构建

# 安装依赖
npm install

# 生产环境打包构建
npm run build

# 代码风格与规范检查
npm run lint

📄 开源许可

本项目遵循 MIT License 许可开源。