Meredith2328/dsh-sticky-note

左下角便签：随手记点子 / 感想 / TODO，实时保存到归档目录，清单 + 悬浮归档。

当前版本 v0.6.1 兼容 DSH 0.2.x（最低 0.2.0-rc.2，最新实测 0.2.2-rc.1）。包内已声明机器可读的 engines.dsh 范围，DSH 会在安装/加载前自动做兼容性检查；便签设置仍由插件 Config 自动写入当前 profile patch。

✨ 功能

• 📝 随手记：编辑框工具栏上的便签按钮，点击弹出便签面板
• 📍 可选固定：从标题栏操作中固定后吸附到屏幕边缘，外部点击不再关闭；固定状态与位置会被记住
• 🔁 可选续写：可在插件设置中选择重新打开时继续当前草稿；默认关闭，保持原有行为
• 🔎 整体缩放：标题栏操作提供 − / 倍率 / +，支持 Cmd/Ctrl + + / - / 0，倍率会被记住
• 💾 自动保存：按设定间隔（10 秒 / 1 分钟 / 5 分钟）自动落盘，Ctrl+S 立即保存
• 🏷️ 三分类：点子 / 感想 / TODO，快捷键 Ctrl+Shift+1/2/3 切换
• 📤 一键发送：便签内容直接发给当前对话（或追加到输入框）
• 📋 历史便签：分组清单 + 展开收起，双击查看、单击预备发送，归档分组可一键恢复
• ✏️ 可编辑：历史便签可二次编辑保存；外部编辑器改动后查看视图自动刷新
• 📌 选择保留：标记保留的便签不会被自动清除（针形图标）
• 🧹 自动清除：按最后修改时间计龄，超期未保留的先移入「已清除」回收站（保留 30 天），Host 定时触发
• 🖥️ Markdown：编辑 ↔ 实时预览（Ctrl+Shift+V），支持表格 / 任务列表 / 删除线 / 图片
• 🌓 深色模式：全部配色跟随 DSW 主题变量，深浅自动切换
• ⌨️ 快捷键：Esc 层层退出、Tab/Shift+Tab 缩进、Ctrl+Shift+X 删除线、Ctrl+Shift+T 任务项、Ctrl+T 表格骨架等
• ⚙️ 可配置：存储路径、保存间隔、清除周期、默认类别、发送方式、是否继续当前草稿

📦 安装

dsh plugin --profile web add github:Meredith2328/dsh-sticky-note

或本地目录：

dsh plugin --profile web add file:/path/to/dsh-sticky-note

安装后重启 DSH（Web 或 Desktop）。

请不要使用裸包名 dsh plugin ... add dsh-sticky-note；npm 上的同名包不是本项目。

🧩 版本对应与自动兼容

安装前可先运行 dsh --version，再按实际 DSH 版本选择插件：

便签版本	支持的 DSH 版本	建议	说明
v0.6.1（当前）	0.2.x，最低 0.2.0-rc.2	✅ 推荐	已验证至 0.2.2-rc.1；声明 engines.dsh，由 DSH 自动拦截不兼容版本
v0.6.0	0.2.x，最低 0.2.0-rc.2	可用	已验证 0.2.0-rc.2 和 0.2.1-rc.5；未声明 engines.dsh
v0.5.0 / v0.2.4	0.1.0-rc.7 ~ 0.1.6-alpha.2	旧版 DSH	使用旧版 settings 接缝，不兼容 DSH 0.2.x
v0.2.2 ~ v0.2.3	0.1.0-rc.7 ~ 0.1.1-rc.2	旧版 DSH	仅用于更早的 DSH 环境

当前 v0.6.1 的机器可读范围为：

"engines": {
  "dsh": ">=0.2.0-rc.2 <0.3.0-0"
}

上面的上界包含用于排除 0.3.0 预发布版的技术哨兵，实际含义是“只接受 0.2.x”。DSH 0.2.1 及以后会优先读取这个字段；不匹配时，插件管理器会在导入插件代码前拒绝安装或加载。DSH 0.2.0 仍可回退使用 peerDependencies 中的版本范围。因此正常使用匹配版本时，不需要手工修改 package.json 或 profile 配置。

首次加载时，设置值来自插件的 Config 默认值；用户保存设置后，插件会自动把条目以 dsh-sticky-note 为 id 写入当前 profile 的 cordis.patch.yml。Read/Write、RPC 和插件详情页配置插槽继续沿用 DSH 0.2 的接口。

本次兼容性检查在全新的 DSH 0.2.2-rc.1 Web profile 中完成：插件安装后正常加载，客户端包 dsh-sticky-note/client.js 被正确注入，编辑框工具栏的便签按钮与面板可用，/api/dsh-sticky-note/call RPC 有响应；浏览器页面脚本、控制台和 HTTP 请求均无报错。接口层面逐项核对过：settings.update / settings.configure、connection.fetch.register 与 connection.rpc.handle、conversation.input.left 和 plugins.bundle.config 插槽在 0.2.2-rc.1 中均保持可用；Cordis 从 4.0.5 升到 4.1.0，本插件使用的 ctx.effect、ctx.inject、ctx.fiber 接口没有变化。该版本要求迁移的 tools.resolve / executable、提示词组装和 Session Projection 异步注册都不是本插件使用的接口，因此无需修改插件代码。仓库的自动化测试全部通过。

🗂️ 存储结构

<root>/
├── 点子/    ← 以时间戳命名的 .md 文件
├── 感想/
├── TODO/
├── 归档/    ← 归档的便签（前缀类别名，可一键恢复）
└── 已清除/  ← 自动清除的回收站（保留 30 天）

默认根路径 ~/.dsh/sticky-notes（DSH_HOME 下），可在设置页修改。

🤝 贡献

外部贡献采用先 Issue、后 PR 的流程。请先阅读 CONTRIBUTING.md；未经确认的 PR 暂不进入人工代码审查。

📄 License

MIT