前言¶
用 DSH 跑智能體流程時，常需要在對話旁邊隨手記東西：待辦、字段樣例、一段要反覆貼進去的 prompt。系統裏沒有對應的工具，多數做法是另開一個窗口或切到別的筆記軟件，記完再粘回來。dsh-sticky-notes 走的是另一種路子——在 Web UI 里加一塊旁掛的浮動便籤窗，不離開對話界面就能記和查。下面介紹這個插件。
這是什麼¶
dsh-sticky-notes 是 DeepSeek Harness（DSH）的便籤插件，由 stallenlu 維護，分類爲客戶端（client-side）。它提供一個可拖動的浮動便籤面板、一個側邊欄完整頁面，支持 Markdown 預覽、粘貼圖片和設置項。插件版本 1.0.7，要求 DSH >= 0.2.0-rc.1（在 0.2.1-rc.5 桌面版開發與實測），許可證 MIT，GitHub 星標 0 星，創建於 2026-11-04。
數據全部存在瀏覽器 localStorage，沒有 Host 側邏輯。
核心功能¶
- 浮動便籤窗：屏幕右側中部懸浮標籤，帶便籤計數徽章；點擊展開面板，標題欄可拖動，位置持久化，換分辨率後自動收回視口內。
- 完整頁面：左側邊欄點便籤圖標進入完整頁面，與浮窗共享同一份數據，改一處另一處即時同步。
- Markdown 預覽：用宿主的
MarkdownText渲染便籤；點擊預覽區切回純文本編輯，失焦後回到預覽。 - 粘貼圖片：在便籤文本框裏 Ctrl+V 粘貼圖片即附加，縮略圖右上角 × 單獨移除。
- 設置項：浮窗 ⚙ 和完整頁面都有設置區，共 7 項（見下節）。
- 跨窗口同步：便籤與設置都監聽
storage事件，多窗口各視圖保持一致。 - 數據健壯性：存儲損壞時不覆蓋原數據，只給出警示，用戶真實編輯後才授權寫回；寫入失敗提示「僅保留到關閉頁面」。
- 雙語：跟隨宿主語言服務，宿主未提供時回退瀏覽器語言，中文環境顯示中文。
設置項¶
設置走設置區，不需要改配置文件。
| 設置 | 類型 | 默認 | 說明 |
|---|---|---|---|
| 浮動面板 | 開關 | 開 | 是否顯示屏幕右側的浮動標籤 |
| 側邊欄入口 | 開關 | 開 | 是否在左側邊欄顯示便籤圖標（設置頁始終可達） |
| Markdown 預覽 | 開關 | 開 | 關閉後所有便籤退回純文本編輯框 |
| 計數徽章 | 開關 | 開 | 浮動標籤上的便籤數量 |
| 面板寬度 | 數字 | 320 | 240–560 像素，越界自動收攏 |
| 便籤排序 | 下拉 | 最新的在前 | 最新的在前 / 最舊的在前，浮窗與頁面共享 |
| 刪除全部便籤 | 按鈕 | — | 需二次確認 |
存儲與限制¶
插件不建自己的存儲方案，直接寫 localStorage 的三個鍵：
dsh-sticky-notes:v1 便籤列表（[{id, text, images, updatedAt}]）
dsh-sticky-notes:settings 設置項
dsh-sticky-notes:pos 浮窗位置
圖片限制：每條便籤最多 8 張，單張 ≤700KB（以 data URL 存儲，單條最壞約 5.6MB）；讀取時會清洗非 data:image/ 的值並截斷到 8 張。數據只在本地瀏覽器，不跨設備同步。
安裝與啓用¶
按 README 的做法，把包放到任意位置，然後在 $DSH_PROFILE_DIR/package.json 里加依賴和 bundle：
{
"dependencies": {
"dsh-sticky-note-panel": "link:C:/path/to/dsh-sticky-note-panel"
},
"dsh": {
"profile": {
"bundles": ["dsh-sticky-note-panel"]
}
}
}
bundle 自帶的 cordis.patch.yml 會插入插件行 ui-sticky-notes，不需要再改 profile 的 patch 文件。所以這裏的步驟是：先放好包，再改 profile 的 package.json，然後重啓 DSH。
生效規則不一樣，別混在一起：
link:依賴是符號鏈接，改client.js這類代碼後刷新頁面即生效。- 改 manifest（
package.json/cordis.patch.yml）後必須重啓 DSH。
典型用法¶
裝好之後不需要額外指令，插件自己註冊三個界面位置。實際用法就三步：
- 對話時屏幕右側的浮動標籤上有便籤數量，點開是便籤面板；標題欄按住即可拖動，拖到的位置會記住。
- 想記長內容時點左側邊欄的便籤圖標進完整頁面，清裏寫 Markdown，失焦後自動渲染預覽；點擊渲染結果又切回可編輯的純文本。
- 需要截圖做素材時直接在文本框 Ctrl+V，圖片存成縮略圖，右邊 × 可單獨刪，不想要的圖不必整條便籤刪掉。
多開窗口時，任意一個窗口的增刪改和設置改動，都會同步到其他窗口。
適用場景與注意¶
適合在 DSH 對話旁做輕量記錄的人：臨時待辦、待確認的請求參數、想在對話裏反覆引用的片段。它不是知識庫，不做跨設備同步，也不做全文檢索，需要長期歸檔的內容還是該用別的工具。
幾句提醒：
- 這個插件在瀏覽器裏運行，用的是當前 DSH 進程和頁面上下文，行爲以插件源碼爲準，裝前應看一眼源碼和 MIT 許可證。
- 數據只存在當前瀏覽器，清瀏覽器數據等於清空便籤；圖片按 data URL 存，規格不小，別當成附件庫用。
- 它是社區目錄裏收錄的客戶端插件，屬於第三方項目，與 DeepSeek / 幻方沒有官方從屬關係，升級 DSH 大版本前建議先覈對兼容性（README 標註的實測版本是 0.2.1-rc.5）。
結尾¶
dsh-sticky-notes 的定位很清楚：給 DSH Web UI 補一小塊對話旁的記事區，浮動窗和完整頁面共用一份數據，Markdown 渲染和圖片粘貼都配齊，實現上不碰 Host、不建後端，全靠 localStorage 和宿主的運行時能力。功能不復雜，勝在裝完即用、卸載乾淨。
插件目錄頁：https://www.skillhub.cn/plugins/stallenlu/dsh-sticky-notes
GitHub：https://github.com/stallenlu/dsh-sticky-notes
