📌 uTools 拾光便签 (AmberNotes)

高颜值便签，双击一键极速粘贴。

拾光便签是一款基于 Vue 3 + TypeScript + Pinia + Sass 构建的高颜值、生产力工具型 uTools 便签插件。融入了现代 Glassmorphism 风格与 Fluent Design 微动效交互，支持极速双击粘贴、超级面板文本捕获、多级分类与数据云同步，助你清爽、高效地记录日常灵感与备忘。

---

🌈 核心特色

• 🚀 双击粘贴：非编辑状态下双击卡片可一键自动隐藏插件，并直接粘贴文本到光标处，效率翻倍。
• 📂 多级分类：支持无限层级的子分类折叠与自由拖拽排序，快速实现多级归档管理。
• 💡 超级面板：完美集成 uTools 超级面板，支持划词一键捕获文本极速生成卡片。
• 🗑️ 历史回收站：支持便签历史回收站功能，误删卡片可一键还原或彻底清除。
• 🔍 多维检索：内嵌式搜索范围下拉框，支持“标题/内容/标签”多类别多选模糊搜索。
• 🎨 高颜值配色：支持 6 种精心调配的 HSL 卡片颜色，支持平滑置顶与亮暗主题完美自适应。
• 🔄 数据安全：支持单卡片 TXT 导出、全局 JSON 备份（带 Schema 校验），在 uTools 环境下自动开启加密云同步。
• ⌨️ 快捷键操作：支持全局快捷新建 (Ctrl+Alt+N)、一键聚焦搜索框 (Ctrl+F) 以及卡片编辑的快捷键操作。

---

🔌 uTools API 适配

在 src/utils/storage.ts 中封装了统一的适配层：

• 数据持久化：在 uTools 环境下自动启用 dbStorage（支持加密与多端同步），浏览器环境下自动退化到 localStorage。
• 系统主题贴合：调用 uTools API 动态获取并监听系统主题色，实现 100% 自动适配。
• 本地写盘：复用 Preload 底层服务进行静默安全的 TXT/JSON 导入导出。

---

🛠️ 本地开发与调试

1. 安装依赖

npm install

2. 启动开发服务器

npm run dev

启动后，本地预览地址为：http://localhost:5173/。

3. 在 uTools 中调试

1. 呼出 uTools，搜索并进入 开发者工具。
2. 点击 新建项目，选择项目根目录下的 public/plugin.json。
3. 确保本地 npm run dev 正常运行，在开发者工具中点击 运行 即可进行沙箱调试。

---

📦 打包与发布

1. 打包项目：

   npm run build

   打包完成后，会在根目录下生成 dist/ 目录。
2. 打包 UPX： 在 uTools 开发者工具 项目面板中点击 打包项目，选择生成的 dist/ 目录和 public/ 下的图标，生成 .upx 格式的插件包，上传至 uTools 开放平台审核即可。