灵感便签lastplayer82/dsh-sticky-notes

dsh-sticky-notes（灵感便签）

适用于 DeepSeek Harness Web GUI 的便签——在智能体思考时随手记下想法，然后在不打断它的情况下把想法送入对话。完全双语（中/英）：界面跟随 DSH 界面语言。

功能

- 随时记录：在智能体思考/运行时捕捉想法——每次按键都会自动保存
（浏览器 localStorage + 宿主文件双重写入，重启或端口变更都不会丢失）。
- 浮动面板（v0.2）：点击停靠栏小标签 / 侧边栏条目，会在输入框附近弹出
一个浮动覆盖层（没有打开对话时位于右下角）；点击外部或按 ESC 会自动保存并关闭
（草稿会保留）。可通过标题栏拖动，可从 8 条边/角调整大小
——大小和位置会被记住。
- 绝不打断智能体：发送和转发都走官方队列通道（conversation.send，mode=queue）——当目标会话
繁忙时，消息会排队，并在当前回合结束后处理。
- 一键发送：发送单条便签，或将多条合并为一条
消息（原文照录，空行分隔，无额外修饰）。
- 拖动排序（v0.2.5）：拖动任意未发送便签上的 ⋮⋮ 手柄来
重新排列列表——合并发送会严格遵循你看到的顺序，因此
智能体会按你期望的顺序收到你的想法。
- 行内编辑（v0.2.5）：点击便签文本即可就地编辑（光标
会落在你点击的位置）；焦点离开 → 自动保存；ESC 取消。
- 复制单条便签（v0.2.5）：每条便签的复制按钮会把原文照录地放到
剪贴板。
- 转发到另一个对话（v0.2）：「转到…」会打开一个会话选择器
（繁忙会话会被标记），并通过目标会话自己的队列
通道转发。
- 导出（v0.2.1）：勾选便签并导出为 TXT / JSON / Markdown——可复制
或下载；TXT 仅含原文（可直接粘贴），Markdown 修饰跟随
界面语言。
- 确认提示（v0.2）：破坏性操作（清除已发送 / 清除全部）使用
面板内确认覆盖层（window.confirm 在 Electron 中不可靠）。
- 双语（v0.2.2）：完整中/英词典，自动跟随 DSH 语言区域
服务。

安装

dsh plugin --profile web add

或者将 "@lastplayer82/dsh-sticky-notes": "link:../../plugins/dsh-sticky-notes"
添加到 profiles/web/package.json 的 dependencies 中，并将包名添加到
dsh.profile.bundles，然后执行 pnpm install 并运行一次 node scripts/junction.mjs。
安装后需要完全重启 DSH（仅刷新页面不够）。

用法

1. 点击输入框上方的便签按钮（或侧边栏条目；徽标
= 未发送数量）以打开浮动面板。
2. 输入一个想法 → 「记下」/ Enter 保存并保持输入框聚焦
（Shift+Enter 插入换行）。
3. 发送到当前聊天：单条便签用「发送到对话」，或用「合并发送」
合并多条（取消勾选可排除）。
4. 发送到另一个聊天：「转到…」→ 选择一个会话 → 通过其自身的
队列通道。
5. 排序：拖动 ⋮⋮ 手柄（仅未发送的便签）——合并/转发的顺序
跟随列表顺序。
6. 编辑：点击任意便签的文本，编辑，点击别处（自动保存），ESC 取消。
7. 已发送的便签保留在列表中并标记为 ✓，可以清除（需确认）；
「清空全部」会移除所有内容（需确认）。

数据与持久化

- dsh.sticky.v1（localStorage）+ 宿主文件 ~/.dsh/dsh-sticky.json 是
稳定的持久化契约——升级绝不能丢失便签；数组
顺序即用户的显示/合并顺序。
- 卸载插件不会删除宿主文件，因此重新安装
即可恢复便签。

架构

- 宿主：src/index.ts + src/routes.ts —— /api/dsh-sticky/status
（健康探测）、/api/dsh-sticky/state（状态文件读/写）、回环
信任防护。
- 客户端：src/client/ —— 侧边栏入口（自愈式 DOM 挂载）、浮动
面板（body 级固定覆盖层）、输入停靠栏芯片注册在官方
conversation.input.dock 插槽上（conversation.send 用于队列投递）。
- 转发：ctx.sessions.scope(targetId) → 目标会话的限定作用域
conversation.send；通过 ctx.sessions.list 快照读取名册。
- 事件：面板 ↔ 停靠栏通过 dsh-sticky:send/-result、
dsh-sticky:list-sessions/-result、dsh-sticky:forward/-result 通信；存储
变更广播 dsh-sticky:change。

构建与测试

pnpm install && pnpm build        # 构建宿主 + 客户端 bundle（需要 node 在 PATH 中）
node scripts/smoke-client.mjs    # 客户端冒烟测试（构建后）：挂载/徽标/队列/发送/名册/转发/导出/复制/编辑/排序

中文速览

DSH 灵感便签插件：AI 思考时随手记想法（自动保存不丢），一键/合并发送或转发到指定会话，全部走官方排队通道、绝不打断 AI；v0.2.5 起支持每条复制、拖拽排序（合并发送顺序跟随清单）、点击文本就地编辑（失焦自动保存）；界面中英双语跟随 DSH 语言设置。安装后需彻底重启 DSH（刷新页面不算）。