前言¶
在 DeepSeek Harness（DSH）的對話過程中，需求往往在中間發生變化。此時需要在幾秒鐘內捕獲上下文，稍後能快速檢索，並保持上下文連續性。dsh-memo 專爲這種“當下記錄，日後查找”的需求設計。
是什麼¶
dsh-memo 是一個爲 DeepSeek Harness 提供的備忘錄/草稿插件。它提供側邊欄入口，支持快速捕獲，使用本地 SQLite 存儲，能夠同步到私有 GitHub 倉庫，並支持圖片與截圖。
安裝與啓用¶
在安裝前，請確保環境滿足以下條件：
- DeepSeek Harness 版本爲 0.2.0-rc.2 或更高
- 捆綁的 Node.js 版本爲 22.5 或更高（
node:sqlite的最低要求）
使用官方命令安裝：
dsh plugin --profile <your-profile> add @adamcjm/dsh-memo
安裝完成後重啓 DeepSeek Harness，側邊欄底部會出現 Memo 圖標。
核心功能¶
側邊欄與快速捕獲¶
插件在側邊欄底部設置入口，帶有未讀徽章。點擊後打開面板，頂部常駐輸入框支持拖動調整大小。
- 保存：輸入內容後按
Enter保存。 - 圖片支持：支持
⌘V粘貼截圖、拖拽圖片或通過文件選擇器（支持⌘/⇧多選）添加。圖片以 SHA-256 哈希命名存儲，重複粘貼同一圖片僅佔用一份空間。 - 編輯：卡片支持內聯編輯，可直接修改正文、圖片和標籤。
標籤與排序¶
- 自動標籤：在正文中輸入
#tag格式的內容，保存後自動創建標籤。標籤名在空格或標點處結束，無固定白名單。 - 置頂：點擊卡片上的置頂按鈕，置頂筆記會排在列表最前，顯示標記和左側強調條。
- 拖拽排序：在同一天組內，可拖動卡片調整順序。排序結果會寫入源文件並隨 GitHub 同步。
- 日期排序：通過右側的排序按鈕切換“降序（今日在前）”或“升序（最早在前）”。
搜索與同步¶
- 搜索：支持 CJK 字符串搜索，以及
#tag、source:、after:、before:、has:image、is:open等限定符。例如has:image可篩選包含圖片的筆記。 - 本地存儲：使用
node:sqlite，無外部依賴，無需編譯原生模塊。 - GitHub 同步：文本層支持自動推送到私有倉庫（30 秒防抖），同時每日生成 SQLite 快照。
使用示例¶
捕獲需求變更¶
打開側邊欄 Memo 面板，輸入以下內容並按 Enter：
Mr. Zhang wants a WeChat QR login entry on the login page; prototype due next Wednesday #requirement-change #login
系統會自動提取 #requirement-change 和 #login 作爲標籤。
添加截圖¶
截取屏幕後，在輸入框中按下 ⌘V，圖片會自動嵌入筆記。
重新排序¶
在某一天的內容中，按住卡片拖動到新位置，鬆手即可保存新的順序。
注意事項¶
- 桌面版 Profile：桌面版 profile 僅限手動配置，CLI 拒絕寫入該 profile。如需在桌面版安裝，需手動編輯
~/.dsh/profiles/desktop/package.json並安裝依賴。 - 依賴：無第三方運行時依賴。
- 許可證：MIT 許可證。
結語¶
dsh-memo 提供了輕量級的側邊欄記錄能力，通過本地 SQLite 和 GitHub 同步保證了數據的持久性與可訪問性。適合需要在對話中快速記錄靈感、需求變更或碎片信息的開發者使用。
