前言¶
在 DeepSeek Harness（DSH）裏和模型長對話時，常見做法是另開編輯器或文檔，把要反覆粘貼的提示詞、片段說明、待辦要點放在旁邊。窗口一多，切換成本變高；純靠聊天記錄檢索也不適合當「個人素材庫」用。社區插件 dsh-side-memo（維護者 r48n34）把備忘面板嵌進 DSH 界面：右側欄或可切換的浮層，與 Session 同屏，支持標籤、圖片、收藏、拖入輸入框，以及把對話或單條提問存成備忘。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-side-memo 是面向 DeepSeek Harness 的輕量客戶端插件：可開關的右側備忘面板（Side Memo）。在 npm 上包名爲 dsh-side-memo，當前版本 1.3.0，許可證 MIT。README 將其歸類爲 UI & Experience；在 SkillHub 目錄中屬於客戶端類插件。
Host 側 apply() 爲空，不暴露面向智能體的工具，也不讀取 Host 數據；備忘與圖片保存在本機瀏覽器（localStorage / IndexedDB），無網絡訪問、無外部服務。插件以當前 DSH 進程及你安裝的插件包爲準運行，安裝前建議在 GitHub 查看源碼與 LICENSE。
核心功能¶
以下能力均來自項目 README 與 package.json 描述，可按需選用。
備忘與組織
- 在聊天旁打開備忘列表，或在尚未創建 Session 前通過浮層抽屜使用同一套 UI。
- 標題下可加標籤；支持搜索、按標籤篩選或「按標籤分組」。
- 星標收藏會置頂；一鍵複製備忘正文。
內容與圖片
- 支持純文本；可粘貼、拖入或通過按鈕插入內聯圖片。
- 選中圖片後出現變換框：拖手柄縮放，方向鍵微調（默認步進 8 px），
Shift+方向鍵只改單軸；Shift+拖動手柄可自由變形，Alt+拖動從中心縮放；雙擊或重置按鈕恢復原始顯示尺寸（不改變存儲的原圖，只改展示大小）。
與對話聯動
- 編寫消息時，將列表中的備忘拖到聊天輸入框，文本插入光標處（可撤銷的單次編輯）；備忘裏的圖片仍留在面板，不會隨拖入一起進輸入框。
- 會話標題欄旁的 chat-to-memo：可選 Save whole conversation（可見的用戶提問與助手回覆）或 Save only my prompts（僅你的發送內容）。只採集可見文本，推理塊、工具輸出和圖片不寫入； transcript 上限 8000 字符，超出時從最早輪次截斷。新備忘會在面板中打開供編輯。
- 懸停在你自己的某條消息上，操作行裏除 copy 外還有備忘按鈕，可只保存該條提問爲新備忘。
導入導出與交互
- 工具欄支持以 Excel（.xlsx） 導入、導出備忘；導入會追加新條目不覆蓋已有備忘；導出不含圖片二進制（圖片仍只存本地）。
- 列表行右鍵，或聚焦後
Shift+F10，可 Open、Copy、Duplicate、收藏、Delete；刪除需二次確認（與編輯器內刪除行爲一致）。
兼容與實現要點
- 面向 DSH 0.2.x（README 寫明在 0.2.1-rc.3、Desktop profile 下開發與測試）。
- 支持 Web GUI 與 Desktop（Electron/Chromium）；依賴常見瀏覽器 API（含讀取壓縮 xlsx 時的
DecompressionStream('deflate-raw')）。 - 有 Session 時面板走右側欄插件 API；無 Session 時由插件在
shell.overlay層渲染，切換按鈕掛在會話頭conversation.header.leading等區域。倉庫已提交編譯後的client.js/index.js，安裝無需本地 build。
安裝與啓用¶
插件已發佈到 npm。按你使用的 DSH profile 安裝（Web 示例如下）。
dsh plugin --profile web add dsh-side-memo
若需要 npm 尚未收錄的 commit，或 npm 不可達，可從 GitHub 安裝：
dsh plugin --profile web add github:r48n34/dsh-side-memo
Desktop 用戶請在 Settings → Plugins 中確認 profile 名稱（Desktop 應用通常爲 desktop），再執行：
dsh plugin --profile desktop add dsh-side-memo
安裝後，Side Memo 圖標會出現在 Session 標題欄右側（包括尚無 Session 的首屏與新 Session 歡迎頁）；也可從標題欄右側工具區或右側欄的添加/引導入口打開。若圖標未出現，重啓 DSH 一次以加載新插件包。卸載可在 Settings → Plugins 或使用對應 profile 的 dsh plugin 命令。
典型用法¶
- 點擊會話頭右側 Side Memo 圖標，打開或關閉面板。
- 點 New 寫備忘；內容自動保存，也可在編輯器內新建。
- 在標題下加標籤，粘貼或插入圖片並按需縮放；用星標置頂、複製圖標複製全文；需要時用搜索與標籤過濾。
- 用工具欄導入/導出
.xlsx在環境間遷移文本備忘（圖片需仍在本機 IndexedDB 中，導出文件不含圖片）。 - 寫消息時把備忘拖到輸入框插入文本。
- 值得留檔的對話：點 chat-to-memo，選整段對話或僅自己的 prompts；或只對單條消息用懸停行的備忘按鈕。
適用場景與注意¶
適合誰： 需要在 DSH 里長期維護提示詞庫、檢查清單、項目備註，並希望在寫消息時快速拖入或把對話摘成備忘的開發者與用戶；重視本地、離線、無額外雲服務的數據路徑時，該插件與 README 中的隱私說明一致（不加密、不同步多設備）。
使用前請知悉：
- 插件隨 DSH 客戶端加載，權限邊界以你安裝的包與 DSH 版本爲準；安裝前請自行審閱 GitHub 倉庫 與 MIT 許可證。
- 剪貼板寫入僅在用戶觸發複製等操作時發生（README「Permissions & privacy」一節有說明，資料截斷處亦強調無 Host 數據訪問）。
- 社區目錄 SkillHub 插件頁 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；DSH 本身遵循「一切皆插件」的擴展方式，Side Memo 是其中一條客戶端 UI 擴展。
結尾¶
dsh-side-memo 把可搜索、可標籤、可導入導出的備忘面板放進 DSH 右側，並與輸入框、會話頭打通，減少在外部工具與 Harness 之間來回拷貝。若要查看簡介與鏈接，可打開 SkillHub 目錄頁 r48n34/dsh-side-memo；完整安裝說明、快捷鍵與兼容細節以 GitHub README 爲準。
