前言¶

用 DeepSeek Harness（DSH）跑長對話時，需求、約束和待辦往往散落在多輪消息裏；要對照某段說明繼續改 prompt 或看模型輸出，只能來回滾聊天記錄，或把內容粘到外部記事本。DSH 客戶端支持插件擴展界面行爲。下面介紹維護者 kkomia 提供的客戶端插件 dsh-session-note：在 Web UI 會話窗口上以浮層形式放一塊可拖動、可縮放的便籤，對話怎麼滾它都停在原處，且按會話分別保存文本。

這是什麼¶

dsh-session-note（DSH 會話便籤）是面向 DSH Web 客戶端的插件（package.json 中 dsh.client.platform 爲 web）。它在會話界面旁增加一塊便籤卡片，用來在同一會話上下文中記錄臨時備忘，不替代 DSH 本身的配置或服務端存儲。

分類上屬於 客戶端 類插件；當前包版本爲 1.0.0，許可證 MIT。社區目錄頁見 skillhub 上的 dsh-session-note，源碼與說明見 GitHub：kkomia/dsh-session-note。該目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。

核心功能¶

依據項目 README，能力可概括爲以下幾點。

• 釘住不滾：便籤通過 shell.overlay 掛在窗口上，不隨對話 transcript 滾動。
• 可拖動、可調整大小：拖標題欄移動；拖右下角改寬高。位置與尺寸會記住；窗口縮放時會收進可視區域，避免跑出屏幕。
• 跟隨會話：每個會話一份便籤，切換會話自動換內容；正文按會話持久化，刷新頁面後仍在。
• 鍵盤微調：聚焦標題欄後可用方向鍵移動；按住 Shift 步長更大。調整大小時聚焦右下角後同樣可用方向鍵微調。
• 主題適配：沿用 DSW 設計變量，亮/暗主題自動匹配。
• 與其它面板共存：打開設置、文件等面板時便籤自動隱藏，回到會話再顯示。
• 乾淨卸載：停用或移除插件時，卡片與注入樣式一併移除；localStorage 裏已存文本默認仍保留，重新啓用後可恢復。

數據只寫在瀏覽器 localStorage，不上傳服務端。

安裝與啓用¶

安裝前請確認本機已能正常使用 DSH CLI，且打算給 web profile 裝客戶端插件。官方 README 給出的步驟是：先取得包含 package.json 的插件目錄，再執行 add（路徑必須指向該目錄，不能憑空用 github:owner/repo 拼命令）。

git clone https://github.com/kkomia/dsh-session-note.git
dsh plugin --profile web add ./dsh-session-note

若使用其它 profile（例如 desktop），將命令中的 web 換成對應 profile 名稱即可。

裝好後刷新 DSH Web 頁面，打開任意會話，窗口一側會出現便籤卡片。插件在 package.json 中聲明對 @deepseek-ai/dsh-client-ui-layout 與 @deepseek-ai/dsh-client-ui-session 的注入，並設置 immediately: true，隨客戶端加載生效。

典型用法¶

1. 拖動便籤頂部標題欄，把卡片放到不擋對話的位置。
2. 拖動右下角調整大小；需要精細對齊時聚焦調整角，用方向鍵微調（Shift 加大步長）。
3. 在正文區輸入或粘貼文本；修改會即時自動保存到當前會話。
4. 清空正文即刪除該會話下的便籤內容（邏輯上不再保留該會話文本）。
5. 在不同會話間切換時，便籤內容自動切換爲各會話各自保存的正文。

數據存放與卸載¶

瀏覽器 localStorage 使用如下鍵（README 原文）：

在 Plugins 頁面停用或移除本插件即可完成卸載；已保存文本仍留在本機瀏覽器，重新啓用插件後可再次讀取。

適用場景與注意¶

適合需要在同一會話裏對照模型輸出、維護臨時 checklist、粘貼 API 片段或約束說明的 DSH Web 用戶。便籤不跨設備同步，也不做版本管理；敏感信息請勿依賴僅存在 localStorage 的明文備忘。

DSH 插件以當前 DSH 進程權限運行，客戶端插件會參與 Web UI 的加載與 DOM 行爲。安裝前建議通讀 倉庫源碼 與 MIT 許可證，確認與本地安全策略一致。

結尾¶

dsh-session-note 用一小塊始終貼在會話旁的浮層便籤，把「對照聊天寫備忘」留在 DSH 窗口內，並按會話自動保存。需要安裝步驟與行爲說明時，可查閱 社區目錄頁 與 GitHub README。