前言¶
用 DeepSeek Harness（dsh）寫代碼、改方案時，對話窗口裏經常會冒出不該立刻發給模型的東西：一個還沒想清楚的點子、一句對剛纔回答的感想、一條稍後要做的 TODO。這些內容如果塞進當前輸入框，容易被下一次發送帶走；如果切到外部筆記軟件，又要離開正在進行的會話。
官方倉庫 deepseek-ai/deepseek-harness 把 Harness 概括成 Everything is a plugin（一切皆插件）：界面插槽也可以被第三方包接管。社區目錄 DeepSeek Harness 插件庫 收錄了一批這類插件，它是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。
dsh-sticky-note 補的就是輸入欄這一側。它在編輯框工具欄放一枚便籤按鈕，點開後可以按「點子 / 感想 / TODO」分類隨手記，內容以 Markdown 文件落盤，歷史清單和歸檔都在同一塊面板裏。本文按目錄詳情頁、GitHub 倉庫 README / package.json / lib/index.js / lib/client.js，以及上游官方倉庫交叉覈對後整理。
這是什麼¶
dsh-sticky-note 是一款面向 DeepSeek Harness Web 客戶端的工具與能力插件，由 Meredith2328 維護。倉庫 Meredith2328/dsh-sticky-note 採用 MIT 許可證，主要語言是 JavaScript。package.json 中的版本號是 0.2.1。GitHub 倉庫當前星標爲 9（目錄頁仍顯示 6，以倉庫頁面爲準）。GitHub topic 標了 dsh-plugin 和 dsh-external。
它解決的問題很具體：把臨時筆記留在 DSH 界面裏，而不是混進對話，也不必另開一套筆記應用。目錄頁和倉庫簡介都把它寫成「左下角便籤」；客戶端實際把按鈕注入到輸入欄左側插槽 conversation.input.left，點擊後彈出便籤面板。
插件分成兩半：Host 端負責讀寫磁盤、定時清理；Web 端負責面板、快捷鍵和設置頁。cordis.patch.yml 會把同名包的 Host 與 Web 兩半一起裝進當前 profile。
核心功能¶
下面這些能力來自倉庫 README，並與 Host / 客戶端源碼交叉覈對過。
隨手記與自動保存¶
編輯框工具欄上有一枚便籤按鈕（aria-label 爲「打開便籤」）。點開後面板可直接寫 Markdown。自動保存間隔可選 10 秒 / 1 分鐘 / 5 分鐘，也可以關掉（間隔爲 0）。Ctrl+S 會立即落盤。空內容不會寫成文件。
默認根目錄是 $DSH_HOME/sticky-notes（未設置 DSH_HOME 時即 ~/.dsh/sticky-notes）。文件按時間戳命名，例如 20260818-153045.md；類別爲 TODO 時會多一個 -todo 後綴。同一條草稿在類別不變時會覆蓋同一文件，切類別或點「新建」纔會開新文件。
三分類、發送與歷史清單¶
便籤分成三類：點子 / 感想 / TODO，快捷鍵 Ctrl+Shift+1/2/3 切換。默認類別是「點子」。
寫好之後可以把內容交給當前對話，發送方式有兩種：
send：直接發出（默認）append：追加到輸入框末尾
歷史側是分組清單，可展開收起。客戶端幫助文案寫明：單擊條目會露出發送按鈕，雙擊查看內容。歸檔分組可以把條目移回原類別目錄。歷史便籤支持二次編輯保存；用外部編輯器改過對應 .md 後，查看視圖會刷新。
保留、自動清除與回收站¶
每條便籤可以打「保留」標記（針形圖標）。自動清除按文件最後修改時間計齡，未保留且超期的條目會先被移入「已清除」目錄，而不是立刻刪掉。清除週期可選 1 / 3 / 7 天，設爲 0 則不自動清除；默認是 7 天。回收站再保留 30 天 後才真正刪除。
Host 在啓動時跑一次清理，之後每小時再跑一次，不依賴用戶是否打開歷史列表。2026-08-16 的提交還修了一處迴歸：保留標記按「類別 + 原始文件名」識別身份，歸檔再恢復後仍然豁免清理。
Markdown、主題與設置¶
編輯和預覽用 Ctrl+Shift+V 切換。README 寫明支持表格、任務列表、刪除線和圖片。配色跟隨 DSW 主題變量，深淺色會一起切。
設置入口在 設置 → 插件 → 便籤。可改的項包括：存儲路徑、保存間隔、清除週期、默認類別、發送方式，以及查看模式（inline 在面板內看全文，file 用系統默認程序打開文件）。配置寫在 $DSH_HOME/sticky-note-config.json，保留名單寫在 $DSH_HOME/sticky-note-retained.json。
磁盤目錄結構如下：
<root>/
├── 點子/ ← 以時間戳命名的 .md 文件
├── 感想/
├── TODO/
├── 歸檔/ ← 歸檔條目，文件名前綴帶原類別名，可一鍵恢復
└── 已清除/ ← 自動清除的回收站（再留 30 天）
安裝與啓用¶
社區目錄頁給出的安裝命令是：
dsh plugin add github:Meredith2328/dsh-sticky-note
package.json 把客戶端平臺聲明爲 web，README 也要求裝到 web profile。更穩妥的寫法是顯式指定 profile：
dsh plugin --profile web add github:Meredith2328/dsh-sticky-note
如需可復現安裝，按目錄頁提示固定 commit 哈希。本文覈對時，倉庫 main 最新提交是 ebabb6c746b1495c5f077e440d98b6665d7a61b9（2026-08-16）：
dsh plugin --profile web add github:Meredith2328/dsh-sticky-note#ebabb6c746b1495c5f077e440d98b6665d7a61b9
本地開發可以用 README 中的目錄安裝：
dsh plugin --profile web add file:/path/to/dsh-sticky-note
README 還寫了 dsh plugin --profile web add dsh-sticky-note（不帶 github: 前綴）。當前在 npm registry 查不到同名包，這條命令不能當成已發佈的 npm 安裝方式；從 GitHub 安裝請用上面的 github:Meredith2328/dsh-sticky-note。
安裝完成後，按 README 重啓 DSH（Web 或 Desktop）。上游 CLI 文檔說明：從 Git 拉源碼時，pnpm ≥10 可能攔截 prepare 一類構建腳本，第一次 add 失敗後要把提示裏的包鍵寫進該 profile 的 pnpm-workspace.yaml 再重試。本倉庫發佈的是已構建的 lib/，是否彈出該提示以本機 pnpm 行爲爲準。
目錄頁的安全提示同樣適用：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。
典型用法¶
- 啓動
dsh web（或 Desktop），確認輸入欄左側出現便籤按鈕。 - 點擊按鈕打開面板，按
Ctrl+Shift+1/2/3選「點子 / 感想 / TODO」，寫下內容。默認約 10 秒自動保存；着急落盤就按Ctrl+S。 - 需要把這段話交給模型時，用面板上的發送：直接發出，或先追加到輸入框再自己改一版。
- 打開「歷史便籤」查看分組清單。雙擊查看並繼續改；要長期留着的條目打上保留標記；告一段落的條目可以歸檔，之後再一鍵恢復。
- 到 設置 → 插件 → 便籤 改存儲路徑、保存間隔和清除週期。如果希望用 VS Code / 記事本打開文件，把查看模式改成
file。面板上也有「打開便籤文件夾」，Host 會調用系統默認文件管理器（Windows 用explorer，macOS 用open，Linux 用xdg-open）。
常用快捷鍵（README 列出，客戶端源碼中有對應處理）：
Esc：層層退出Tab/Shift+Tab：縮進Ctrl+S：立即保存Ctrl+Shift+V：編輯 / 預覽Ctrl+Shift+X：刪除線Ctrl+Shift+T：任務列表項Ctrl+T：插入表格骨架
適用場景與注意事項¶
適合已經在用 DSH Web 界面、需要把「還不想發給模型的話」就近記下的人。三類目錄把點子、感想和待辦分開，歷史清單加歸檔，適合同一臺機器上連續多天的會話。它不是知識庫，也沒有全文檢索或跨設備同步；筆記就是本地 Markdown 文件。
使用前需要看清這幾條邊界：
- 只聲明瞭 Web 客戶端。
package.json的dsh.client.platform是web，並注入@deepseek-ai/dsh-client-ui-slots。Headless / TUI profile 裝上也不會出現這塊面板。 - 以當前 dsh 進程權限運行。 Host 會在配置的根目錄讀寫文件，也能拉起系統默認程序打開文件或文件夾。安裝前應閱讀
lib/index.js、lib/client.js和 MIT 許可證；不信任的來源不要裝。 - 自動清除會搬文件。 默認 7 天未改且未保留的便籤會進「已清除」，30 天后刪除。重要條目要打保留，或把
clearAfter設爲 0。 - 社區目錄不是官方商店。 deepseek-harness-plugin.com 與 DeepSeek / 幻方無官方從屬關係。Harness 仍是開發者預覽，插件可能隨核心升級出現不兼容變更。需要可復現環境時，固定上面的 commit 哈希。
小結¶
dsh-sticky-note 把一塊本地 Markdown 便籤嵌進 DSH 的輸入欄：分類記錄、定時落盤、一鍵送進對話，歷史和歸檔都在面板裏完成。它不替代專業筆記軟件，只補「人還在會話裏、話還不能發給模型」這一段。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-sticky-note/
GitHub：https://github.com/Meredith2328/dsh-sticky-note
