前言¶

在 DeepSeek Harness（DSH）里做智能体或长对话时，灵感、待办和零散句子往往落在对话历史或剪贴板里，需要时再找成本高。常见做法是用外部笔记或本地 Markdown，但和「继续跟 AI 聊下去」之间还要自己复制粘贴、自己整理标题和分类。dsh-note（仓库名 dsh-stickynote，维护者 AIcivilization，分类：记忆）是 DSH 的 web 侧插件：侧栏一点或快捷键打开捕获浮层，文字或语音记下后落本地 Markdown；保存后由对话当前模型异步整理标题、归类、补要点、抽待办；再一键投递到当前对话或新开对话。定位是分流入口，不是又一本需要自建文件夹结构的笔记库。

这是什么¶

npm 包名为 dsh-note（与生态里已有的 dsh-sticky-note 区分，避免 npm 相似名冲突）。它是 DeepSeek Harness 插件，要求 DSH >=0.2.1-rc.5，硬依赖 webServer；当前包版本为 0.1.3，许可证 MIT。设计思路写在仓库 DESIGN.md；社区目录页见 SkillHub 条目，源码与说明见 GitHub。

核心能力¶

捕获与整理¶

• 侧栏按键、对话顶部按钮打开主界面；Alt+Space 打开捕获浮层，⌘↵ 保存，Esc 取消。
• 捕获浮层支持语音：插件自带采集（getUserMedia → WAV），识别走宿主 speechController（需 voice-input-bundle 且 provider 就绪）。
• 保存后 AI 异步整理：起标题、三层归类（规则 → 模型 → 用户）、补要点、抽待办、认时间线索；跑过 AI 的条目带 +AI 角标，原文改过会标「旧」。
• 无 llm 服务时便签保持「素贴」，没有 +AI；AI 整理跟随对话当前模型，插件不单独配置模型。

浏览、搜索与数据形态¶

• 三区面板：软分类树、卡片流、详情；支持搜索原文、标题、标签、类别。
• 回收站为软删除、无 TTL，可恢复；归档默认从主视图排除，可在归档视图查看或取消归档。
• 批量多选：归档、取消归档、移入回收站，单条失败不影响其余；超过 120 条用虚拟滚动，官方说明 5000 条仍可流畅浏览。
• 数据目录 ~/.dsh/stickynote/：一条一文件 Markdown + frontmatter，图片在 media/；卸载插件数据不丢，只是没有界面。可 git、可 grep、可外挂 Obsidian。

与对话的衔接¶

• 一键投递到当前对话或新开对话并发送（真建会话并把内容作为第一条消息，不是留草稿）；投递前会处理空草稿、发送中、已有内容等几种情况，默认「追加」。
• 新开对话前可列出相关思路作为投递候选，多选一起带走。
• 分类决定主按钮：想法/工作「聊这张」、待办「设个提醒」、参考「找相关」、生活「看看」。「聊这张」可绑卡片为主题，输入框上方显示主题条。
• 聊完后可通过 agent 工具 stickynote_update 把结论追加回卡片（只追加不覆盖）。
• 待办侧认出「明天下午」等时间线索时可交给 schedule 建提醒；无 schedule 则不显示「设个提醒」。模糊时间词（如「有空」「改天」）故意不解析。

模型工具与其它¶

插件向模型暴露 4 个工具：stickynote_capture、stickynote_search、stickynote_get、stickynote_promote。设置页可查看数据目录、条数、AI 开关、队列，开关四类提示、增删类别；支持导出全部为单个 .md，设置页导入 .md / .txt（永远新建不覆盖）。捕获浮层可粘贴或拖入截图，图片存本地，默认不发给模型（隐私优先；看图需 attachment 服务）。多标签同步用 SSE，轮询兜底。

安装与启用¶

从 npm 安装（推荐）：

dsh plugin --profile web add dsh-note

本地开发改代码时：

dsh plugin --profile web add /path/to/dsh-stickynote

然后在 profile 的 package.json 里把 dsh-note 加入 dsh.profile.bundles，重启 dsh，浏览器硬刷新（Ctrl+Shift+R）。前端 bundle 带 immutable 缓存头，不硬刷可能继续用旧 manifest。

可选依赖缺失时的行为（摘自 README）：

典型用法¶

1. 工作或对话中按下 Alt+Space，输入或语音记下片段，⌘↵ 保存。
2. 稍后在侧栏打开三区面板，在分类树或搜索里找到条目，查看 AI 生成的标题与要点。
3. 需要继续深挖时，点「聊这张」开新对话并绑定主题；或把卡片内容投递到当前对话。
4. 对话得出结论后，让 agent 调用 stickynote_update 把结论写回卡片。
5. 待办类条目若识别出确定时间，用「设个提醒」交给 schedule（到点推送依赖通知类插件，如 dsh-notify-me）。

保存时若发现与已有条目相似，会 T1 提示，只提示不自动合并。

适用场景与注意¶

适合需要在 DSH 内快速收录碎片、又希望少维护文件夹、且希望内容和后续对话打通的开发者与用户。卡片按「展示 / 深入 / 执行 / 参考」等路径分流，强调记下来之后能立刻进对话或执行，而不是长期堆在收件箱里。

安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。DSH 插件在 dsh 进程权限下运行，数据写在用户目录 ~/.dsh/stickynote/，语音与图片涉及本机能力与本地文件，按需评估环境。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；星标数会随时间变化，以 GitHub 页面为准。

已知边界包括：语音转写一次性返回、不做流式边听边出字；图片默认不参与模型阅读；悬浮球与部分提示功能在 README 中标注尚未完成。

结尾¶

dsh-note 把「秒记」和「AI 整理 + 投递对话」收进同一套本地 Markdown 数据里，适合作为 DSH 工作流里的记忆与分流入口。目录与安装说明：SkillHub · dsh-stickynote；仓库与完整能力列表：github.com/AIcivilization/dsh-stickynote。