为什么值得关注

它无需分支或构建步骤，即可在 Hermes Desktop 环境中提供精致的便签体验，利用插件 SDK 和 CSS 变量实现主题适配，并提供拖拽合并等独特交互。

适合谁使用

需要快速记笔记的 Hermes Desktop 用户
将 Hermes 作为智能助手界面的知识工作者或研究人员
探索 Hermes 插件生态的开发者
喜欢极简、支持键盘操作的便签系统的任何人

典型使用场景

在 Hermes Desktop 中快速记下提醒、想法或任务
通过堆叠便签组织内容，再弹出重要便签以获得更多关注
将相关便签拖拽重叠形成笔记堆，用于头脑风暴
使用实验性的代理指令（如 /sticky）从纯文本创建便签

项目优势

零配置：单文件插件，无需构建步骤或应用分支
灵活交互：支持堆叠、弹出、合并、一键收起，并配有快捷键
主题感知：使用应用的 CSS 变量而非硬编码颜色
支持个人配置：基于插件范围的 ctx.storage 存储，尊重 Hermes 配置文件

使用前须知

v0.1 版本：默认全局便签；会话固定功能较弱，项目固定功能尚未实现
代理创建功能（纯文本标记）为实验性，尽力支持
需要 Hermes Desktop（Electron 应用）；仅命令行/网关无法加载该插件
磁盘插件限制仅允许导入 react、react/jsx-runtime 和插件 SDK

README 快速开始

Hermes Sticky Notes

In-Desktop sticky / post-it notes for Hermes Desktop, built as a single disk plugin (no app fork, no build step).

One stack on the glass. Break out notes when they need ambient space. Drag floats together to pile them. Stack all when the desk gets loud.

v0.1 — global stickies by default. Session pin exists as a light toggle; project pin may come later.

Install

Requires Hermes Desktop (the Electron app). CLI/gateway alone will not load this.

mkdir -p ~/.hermes/desktop-plugins/sticky-notes
curl -fsSL -o ~/.hermes/desktop-plugins/sticky-notes/plugin.js \
  https://raw.githubusercontent.com/VGFreakXBL/hermes-sticky-notes/main/plugin.js

Or copy manually:

mkdir -p ~/.hermes/desktop-plugins/sticky-notes
cp plugin.js ~/.hermes/desktop-plugins/sticky-notes/plugin.js

Then in Desktop:

⌘K → Reload desktop plugins (or wait a few seconds for the file watcher)
Settings → Plugins → enable Sticky Notes if it’s off
Look for the status chip sticky and the floating stickies stack card

Named profiles: install under ~/.hermes/profiles//desktop-plugins/sticky-notes/ instead when that profile is active.

How to use

Action	How
New sticky	Status chip, stack New, palette Sticky: New (stack), or `⌘⇧N`
Edit	Select a row in the stack; body autosaves
Break out	↗ on a stack row or Break out in the editor
Pile	Drag free breakout windows until they overlap ~40%, then release
Flip inside a pile	Click a row in the pile list
Split from pile	↗ on a pile row
Return one to stack	↙ stack on a breakout, or ↙ in a pile
Stack everything	Stack all / `⌘⇧S` / palette
Clear all	Palette Sticky: Clear all (destructive)

Notes persist in plugin-scoped storage (ctx.storage), profile-aware. No real filesystem access.

Design notes

One stack card by default (not one float per note)
Overlap-merge only after a real drag (not on plain clicks)
Short grace after split so notes aren’t immediately re-piled
Themes: no hardcoded colors — uses app CSS variables
Disk plugin rules: jsx() / jsxs() only; imports limited to @hermes/plugin-sdk, react, react/jsx-runtime

Agent (best-effort)

If the gateway event payload in

项目描述

Sticky / post-it notes for Hermes Desktop (disk plugin)

hermes-sticky-notes