前言¶
在 DeepSeek Harness（DSH）里和模型对话时，常会临时记下灵感、待办、命令或一段待粘贴的文案。系统剪贴板或外部记事本可以凑合，但要么被对话窗口挡住，要么刷新页面后内容丢失。DSH 社区插件 dsh-quick-notes（npm 包名 dsh-quick-notes）在 Web GUI 上提供一块可拖动的浮动便签窗口：左侧笔记目录、右侧编辑区，内容自动落盘到本机，不占用整屏。下面介绍它是什么、能做什么，以及如何安装与日常使用。
这是什么¶
Quick Notes 由维护者 LittleLemonJam 发布，在 SkillHub 插件目录 中归类为「记忆」。官方简介为：面向 DSH Web GUI 的浮动便签板，支持笔记目录、文本编辑、粘贴图片与本地持久化。
当前 npm 版本为 1.0.0（MIT 许可证）。插件要求 DeepSeek Harness 0.2.0 及以上；本地数据服务期望 Node.js 22.13 及以上——DSH 自带 Node 运行时，从市场或命令行安装时一般不必单独装 Node，仅从源码构建时才需要本机 Node。
核心功能¶
以下能力均来自项目 README 与 package.json 说明。
多笔记与目录
- 左侧目录列出多条笔记，右侧编辑当前选中项；可新建、重命名、置顶、删除，并拖拽或
Alt+↑/↓调整顺序。 - 删除的笔记进入回收站，可恢复或永久删除。
文本与图片
- 右键菜单支持复制、剪切、粘贴、清除格式；
Ctrl/Cmd+B/I/U切换粗体、斜体、下划线。 - 可粘贴或拖入 PNG、JPEG、WebP、GIF，大图会自动缩小以适应窗口；不支持保留 SVG 与远程图片链接。
窗口行为
- 标题栏可拖动位置，八向手柄可缩放（最小约 320×240）；可切换「仅笔记」窄窗、最小化为浮动小球，或重置为默认 560×440 尺寸。
- 窗口大小与位置会记住；设置里还可「重置窗口位置」到 DSH 框架右侧默认区域。
设置与备份
- 字号（13–20）、行高（1.4–2.0）、主题（跟随 DSH / 浅色 / 深色）、横线纸开关。
- 通过 Export JSON / Import JSON 做备份；界面可查看同步状态。
- 界面语言跟随 DSH（中英文）。
数据与隐私
- 笔记保存在本机
~/.dsh/quick-notes/notes.json（Windows 为%USERPROFILE%\.dsh\quick-notes\notes.json）；若设置了DSH_HOME，则在该目录下。 - 可用环境变量
DSH_QUICK_NOTES_DIR更换数据目录。 - 插件不上传笔记内容，无账号与遥测；敏感内容请自行做好磁盘加密或定期导出备份。
安装与启用¶
任选一种官方文档中的方式即可。
在 DSH 界面安装
- 打开侧边栏 Plugins 页面。
- 选择 Add plugin → Install a third-party plugin，输入
dsh-quick-notes并确认。 - 若插件未立即出现，重启 DSH 一次；然后在左侧边栏底部点击便签图标打开窗口。
若已配置插件市场（内置 Plugins → Discover，或 Settings → Plugin market 下的社区源），也可搜索 Quick Notes 或 随想随记 安装。
命令行安装
Web UI 使用的 profile 名为 web 时，执行：
dsh plugin --profile web add dsh-quick-notes
若你使用其他 profile，将 web 换成对应名称。安装后若窗口不出现，重启 DSH 以便本地数据服务启动。
典型用法¶
安装并重启（如需要）后，按 README 中的入门步骤操作：
- 点击左侧边栏底部的便签图标，打开便签窗口。
- 在目录区按
+新建笔记，输入名称后按Enter。 - 在正文区输入内容；无单独保存按钮，停顿片刻后会自动写入。
- 需要时在目录中点击切换笔记；双击目录名或编辑器上方标题可重命名。
常见用法包括：对话旁记短待办、暂存命令或地址、粘贴即将用到的截图或片段。格式化与图片操作见上文「核心功能」；横线纸通过回收站旁的三线按钮切换。
适用场景与注意¶
适合谁
- 长时间在 DSH Web 里调试 prompt、对照多轮对话，需要「始终可见又不挡满屏」的 scratchpad 的开发者或重度用户。
- 希望笔记只留在本机 JSON、并可导出备份、不依赖第三方云笔记的场景。
安装与运行注意
- DSH 生态理念是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。
- 第三方插件以当前 DSH 进程权限运行，便签文件为明文 JSON；安装前应确认你接受其本地读写范围与数据路径。
结尾¶
dsh-quick-notes 把浮动便签、多笔记目录、简单富文本与图片、本地持久化收进 DSH Web 侧边栏的一枚图标里，适合作为对话旁的临时记忆层。更多细节见仓库 README（含 简体中文 README）与用户文档目录下的 docs/user-guide.md。
