前言¶
在 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。
