前言¶
在 DeepSeek Harness（DSH）裏，Composer 輸入框裏的內容會掛在當前這一輪上：Agent 還在跑的時候，你在框裏敲的字往往會進當前 turn 的隊列。實際對話裏卻常出現另一種需求——你已經想到下一步要說什麼，但還不確定這一輪會不會繼續改 bug、要不要立刻發出去；寫進 Composer 容易誤排到本輪，記在腦子裏或臨時記事本又容易丟，也和當前 Session 對不上。
@voltarenyah/dsh-prompt-note 是維護者 voltarenyah 發佈的客戶端類 DSH 插件：在右側邊欄開一個與 Session 綁定的「待發送提示」列表，Agent 仍在工作時可以先記下文案，等合適再逐條發送。社區目錄頁見 skillhub.cn 上的插件條目，源碼與說明在 GitHub：voltarenyah/dsh-prompt-note。
這是什麼¶
插件 npm 包名爲 @voltarenyah/dsh-prompt-note（資料中版本 0.1.2），一句話定位是：Session 維度的 pending prompts 列表，渲染爲 DSH 右側邊欄裏的一個 Tab；你在當前 turn 進行期間寫下「下一輪」要說的內容，準備好後再發送，且一次發送一條。
Host 側通過 engines.dsh 聲明依賴 DSH ≥ 0.2.1-rc.2——該版本起提供右側 Tab 註冊能力（ctx.sidebarRightTabs）。版本過低時 Host 會拒絕安裝，而不是運行時才報錯。
核心功能¶
下面介紹 README 中已寫明的行爲，不擴展未在資料出現的能力。
與 Session 綁定的列表與持久化¶
每個 Session 一份列表，按 Session id 存儲；Host 半部分數據落在 profile 數據目錄下的 <profile>/dsh-prompt-note/notes.json，因此刷新頁面、重啓或其它客戶端重連後，同 profile 下的筆記仍在。
編寫、編輯、刪除¶
面板頂部有編寫區：Ctrl+Enter 添加一條；單條支持行內編輯，Escape 取消編輯。可刪除單條或清空當前 Session 列表（資料中的 API 含 remove、clear）。
就緒後再 Send¶
Send 會把選中的筆記作爲該 Session 的下一條 prompt，經 Host 的 Session 控制器以 mode: 'queue' 提交——與你在 Composer 裏輸入後被排隊的行爲一致；發送成功後會消費該條筆記。從面板發送不會改動 Composer 裏你正在打的草稿。
界面與語言¶
插件註冊右側邊欄 Tab 類型並渲染面板；文案支持英文與中文，跟隨應用當前 locale（locale/en.json、locale/zh.json）。
限制¶
單條筆記最多 20 000 字符；每個 Session 最多 200 條。列表不會實時推送到其它已打開的客戶端；若多端編輯，需在面板標題欄使用 reload 控件刷新。
安裝與啓用¶
安裝粒度是 profile：裝在該 profile 上的 Session 都會看到此 Tab。若包管理器指向的鏡像尚未同步發佈，可在應用內插件管理器裏選 npm 官方 registry，或 CLI 加 --registry https://registry.npmjs.org/。
應用內： 側欄 → Plugins → Add plugin，輸入包名 @voltarenyah/dsh-prompt-note（或固定版本 @voltarenyah/dsh-prompt-note@0.1.2）後安裝。
CLI：
dsh plugin --profile <profile> add @voltarenyah/dsh-prompt-note
通過 Agent： 可讓 Agent 安裝 bundle @voltarenyah/dsh-prompt-note（與 README「With an agent」表述一致）。
資料中許可證爲 MIT；Node 引擎要求 ≥ 20。插件在 DSH 進程權限下運行，安裝前建議自行查看倉庫源碼與許可證。
典型用法¶
- 確認 DSH 版本滿足 ≥ 0.2.1-rc.2，並按上一節爲目標 profile 安裝插件。
- 打開右上角面板開關，展開右側邊欄；在空狀態列表裏選 Pending prompts，或用側欄 + 新建 Tab。Tab 隨 Session 切換，換對話即換列表。
- Agent 仍在處理當前 turn 時，在面板頂部輸入框寫好「下一輪」要說的話，
Ctrl+Enter入列；可繼續追加、編輯或刪除，不必佔用 Composer 隊列。 - 當前 turn 結束或你確認可以進入下一步時，對某條筆記點 Send，該條會按 queue 模式進入 Session；成功後該條從列表移除。
- 若在另一瀏覽器或窗口也開着同 Session，改列表後另一端不會自動同步，在面板頭使用 reload 再拉取。
適用場景與注意¶
適合： 長對話、調試輪次不確定是否還要繼續時，先把後續指令草稿掛在對話旁邊；需要多條備選 prompt、逐條放行而不是一次性堆進 Composer 的場景。
注意：
- 與 Composer「當前 turn 隊列」分工不同：本插件存的是後續 turn 的待發清單，避免和正在執行的 turn 搶隊列。
- 單 Session 200 條、單條 2 萬字符的上限寫死在插件邏輯裏，超長內容應拆條或改用其它存儲方式。
- DSH 生態強調「一切皆插件」；skillhub.cn 爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係，本文僅作插件能力說明。
實現結構（供查閱）¶
維護者在 README 中給出的模塊分工如下，便於排查問題或二次開發時對照：
| 文件 | 作用 |
|---|---|
index.js |
Host：筆記存儲與圍欄路由 /prompt-note/api/*（list、add、update、remove、consume、clear、send） |
client.js |
Client：註冊右側 Tab 並渲染面板 |
cordis.patch.yml |
Bundle patch，插入 prompt-note 行 |
locale/en.json、locale/zh.json |
插件展示文案 |
icon.svg |
圖標 |
路由均爲 POST + JSON body，響應 { ok: true, value } 或 { ok: false, error: { code, message } }，並受 Host 瀏覽器信任檢查（connection.requestRejection）約束。
結尾¶
dsh-prompt-note 把「下一輪要說的話」從 Composer 隊列裏拆出來，放在與 Session 同屏的右側欄裏寫、改、再按需 Send，減少誤排隊和草稿丟失。目錄頁：https://www.skillhub.cn/plugins/voltarenyah/dsh-prompt-note；倉庫：https://github.com/voltarenyah/dsh-prompt-note。
