前言¶
在 DeepSeek Harness(DSH)的 Web 會話裏,agent 回合結束後,用戶經常要重新輸入下一輪提示詞。dsh-suggest-prompt 針對這個環節:它在每個 agent 回合完成後,通過一次有界的輔助 LLM 調用寫入一條建議的下一條提示詞;Web 端將這條建議渲染爲輸入框內部的淺色幽靈佔位文字,默認按 Tab 採納進草稿。
插件定位¶
它是 DSH 的一個 Web profile 插件,維護者爲 studyzy,許可證爲 MIT。核心職責是:
- 在回合完成後生成建議提示詞;
- 將建議寫入會話日誌;
- 在 Web 輸入框內顯示爲佔位文字;
- 提供可配置的採納快捷鍵。
核心功能¶
建議生成¶
每個 agent 回合完成後,插件會執行一次有界的輔助 LLM 調用。默認情況下:
- 繼承主請求最近一次記錄的路由;
- 發送最後一輪用戶輸入與 AI 最終回答;
maxRecentTurns默認爲1;- 關閉思考,使用
reasoningEffort: off,對應thinking: disabled。
Web 端展示¶
建議會在 Web 輸入框內顯示爲淺色幽靈佔位文字。每個完成回合都會生成建議,但幽靈文字只在草稿爲空時顯示。默認按 Tab 採納進草稿;也可以將採納快捷鍵錄製爲 Alt+Slash、Ctrl+Enter 等。
可配置限制¶
插件提供字節、令牌、超時上限、轉錄長度預算和建議可見字符上限等限制。支持顯式指定 provider / model,不指定時跟隨會話路由。
過濾與跳過¶
發送前會做轉錄脫敏,輸出會做淨化與語義過濾。空回覆或不合格回覆會被靜默跳過:不寫 suggest-prompt/suggested 事件、投影保持 null、不記錄警告。
安裝與啓用¶
前置條件¶
需要滿足以下環境:
- Node.js
^22.19或>=24 pnpm- 基於
deepseek-harness的dsh部署,且使用 web profile dsh ≥ 0.1.1-rc.1- 瀏覽器端提供
conversation.input.overlay槽位與inputActions.setDraft
從 GitHub 安裝¶
推薦先使用 GitHub 倉庫安裝:
dsh plugin --profile web add git@github.com:studyzy/dsh-suggest-prompt.git
安裝完成後,重啓正在運行的 dsh web 服務。
如果 pnpm ≥10 在 git 安裝時攔截 prepare 構建腳本,需要把 pnpm 打印的包鍵加入:
~/.dsh/profiles/web/pnpm-workspace.yaml
的 allowBuilds,然後重新執行安裝命令。
本地源碼安裝¶
如果本地已有源碼目錄:
dsh plugin --profile web add /path/to/dsh-suggest-prompt
通過 npm 安裝¶
插件發佈後,可以使用 npm 包名安裝:
dsh plugin --profile web add @studyzy/dsh-suggest-prompt
卸載¶
dsh plugin --profile web remove @studyzy/dsh-suggest-prompt
典型用法¶
1、打開 WebUI「設置 → 插件」的「建議提示詞」卡片。
2、選擇建議生成使用的 provider / model,或選擇跟隨會話路由。
3、保存配置。下一個完成回合生效。
4、如需要,在該卡片中錄製採納快捷鍵,例如 Alt+Slash 或 Ctrl+Enter。
5、等待 agent 完成一個回合。若輸入框草稿爲空,輸入框內會出現淺色幽靈佔位文字。
6、按默認 Tab 將建議採納進草稿,再編輯或發送。
適用場景與注意¶
適合在 DSH Web profile 中連續多輪對話的使用者。它適合需要快速獲得下一句提示詞草稿、同時希望保留人工確認的場景。
使用前需要注意:
- 插件以當前
dsh進程權限運行。安裝前應檢查源碼與許可證;本項目聲明 MIT 許可。 - 該插件通過 DSH 插件機制接入,不是官方應用商店組件。
- 每個完成回合都會生成建議,但 Web 端只在草稿爲空時顯示幽靈文字。
- 被中止(取代)的生成不會爲較早回合留下建議。
- 空回覆或被過濾的回覆視爲無建議:不寫
suggest-prompt/suggested事件、投影保持null、不記錄警告。 - 投影保留最後一條建議;重新打開舊會話會顯示其最終建議,且不發起新的模型調用。
- 對無法關閉思考的模型,思考可能消耗預算;
maxOutputTokens偏小時可能提前以max-tokens結束。
結尾¶
dsh-suggest-prompt 將建議提示詞限制爲一次有界的輔助生成,並在 Web 輸入框中提供可採納的佔位文字。它適合想減少重複輸入、又不希望打斷當前草稿的 DSH Web 使用者。
GitHub 倉庫:
- https://github.com/studyzy/dsh-suggest-prompt