前言¶
在使用 DSH(DeepSeek Harness)編寫內容時,經常遇到這樣的場景:剛想好一句話,按回車就送進了模型;或者把想法記在別的筆記應用裏,切回來時上下文已經涼了。這個插件在 composer 工具欄加一個入口,把草稿格固定在輸入框旁邊,回車只換行,內容只存本機 localStorage。
這是什麼¶
dsh-composer-scratchpad 是一個客戶端插件,作者爲 br0caz。它的核心是輸入框邊上的一塊草稿格:點工具欄那支鉛筆,彈出一個純淨文本框,先把靈感寫進去,回車只換行,永遠不會發出去。想好了再自己挪進輸入框。
解決什麼問題¶
- 避免誤觸:直接敲進輸入框,一行回車就把半成品發出去了;
- 保留上下文:寫進別的筆記應用再切回來,上下文已經涼了;
- 狀態一致:內容僅存本機
localStorage,所有會話共用同一份,切會話、切項目、刷新、重啓都不丟。
核心功能¶
- 在 composer 工具欄增加一個入口:掛載點爲客戶端插槽
conversation.input.right,由@deepseek-ai/dsh-client-ui-conversation提供,位於模型選擇器左邊。 - 純淨文本框:沒有文件夾、沒有標籤、沒有多頁、沒有發送按鈕。
- 只換行:鍵盤事件在面板內就地截斷,不進主編輯器的提交鏈路。
- 可調整大小:拖動右下角把手可改變面板尺寸,雙擊把手回到默認 380×220。
- 內容提示:圖標右上角小點表示裏面還有內容。
- 數據存儲:只寫本機
localStorage,鍵名爲dsh-composer-scratchpad(歷史鍵名dsh-memo-pad:*),不聯網、不進會話、不上傳。
安裝與啓用¶
桌面端 / 網頁端(圖形界面)¶
在側欄插件面板裏添加 GitHub 源:
github:br0caz/dsh-composer-scratchpad
命令行¶
dsh plugin --profile web add github:br0caz/dsh-composer-scratchpad
走 npm(發佈之後)¶
包還沒發到 npm,上面兩條走的是 GitHub 源。等 dsh-composer-scratchpad 上架 npm 之後,纔可以只寫包名:
dsh plugin --profile web add dsh-composer-scratchpad
裝完重啓內核(客戶端模塊清單在啓動期生成)。從源碼或本地路徑裝時,改完 client.js 還要 Ctrl+Shift+R 硬刷新一次——客戶端 bundle 帶 cache-control: immutable,普通刷新不會重新拉。
運行環境¶
- 宿主:DSH Web 端(
dsh web)或桌面端;桌面端跑的仍是profiles/web這一套 - DSH 版本:
>= 0.2.0(見engines.dsh)。0.2.1-rc.2實測正常,更早版本未驗證 - 掛載點:客戶端插槽
conversation.input.right,由@deepseek-ai/dsh-client-ui-conversation提供 - 瀏覽器:任何支持
localStorage的瀏覽器;桌面端內嵌 WebView 同樣可用 - Node:
>= 18,只用於npm test;插件本身運行不需要 Node - 網絡:不需要。零依賴、無構建步驟、不發起任何請求
排查工具欄沒有鉛筆圖標¶
裝上後工具欄沒有鉛筆圖標,就按這個順序排查:
- 重啓內核——客戶端模塊清單在啓動期生成,熱裝不會自動進清單;
Ctrl+Shift+R硬刷新——客戶端 bundle 帶cache-control: immutable,普通刷新拉不到新的;dsh plugin list --profile web確認插件真的進了bundles;- 都沒有就覈對宿主版本,
conversation.input.right在這個版本里是否還存在。
典型用法¶
| 操作 | 結果 |
|---|---|
| 點鉛筆圖標 | 打開 / 收起面板 |
Esc 或點面板外 |
收起 |
Enter |
只換行(鍵盤事件在面板內就地截斷,不進主編輯器的提交鏈路) |
| 拖動右下角把手 | 左拖變寬、上拖變高(面板貼着工具欄往上彈) |
| 雙擊把手 | 回到默認 380×220 |
| 圖標右上角小點 | 表示裏面還有內容 |
第一次打開時會浮出一句「可拖動調整大小」,2.4 秒淡出。判據是教到會爲止:拖過一次就永不再提;沒拖過最多提 3 次。
適用場景與注意¶
適合需要在 composer 旁邊快速草擬內容,但還沒有決定是否發送給模型的人。
面板配色只按深色主題寫過(#2a2b2f),淺色主題下會難看——那是外觀問題,不是裝錯了。
內容不進工作區文件,AI 讀不到(同樣是有意的:這是你的草稿,不是給模型的上下文)。
插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證(MIT)。
短結尾¶
dsh-composer-scratchpad 只做一件事:你還沒決定發不發的那一句話。適合需要臨時草稿格的開發者,安裝後即可在 composer 工具欄使用。
- 目錄頁:https://www.skillhub.cn/plugins/br0caz/dsh-composer-scratchpad
- GitHub:https://github.com/br0caz/dsh-composer-scratchpad