前言¶
在 DSH 裏和模型對話時,很多人習慣先在輸入框裏寫一段口語化的想法,再指望模型「猜對」意圖。草稿往往缺背景、缺約束、缺輸出格式,來回改幾輪纔夠用。另一種做法是在外部文檔裏寫好完整提示詞再粘貼,但和當前會話、當前草稿脫節。
下面介紹社區插件 dsh-prompt-polish(維護者 LMQ00):在 Web 客戶端側把粗糙文本交給模型轉寫成更規範的提示詞,在輸入框上方的浮層裏預覽,用戶點「採用」後才寫入輸入框,且從不自動發送。轉寫走 Host 私有路由,用戶原文與規範結果都不寫入會話日誌。
這是什麼¶
dsh-prompt-polish 是 DeepSeek Harness(DSH)的客戶端類插件:分類爲客戶端,當前 GitHub 星標爲 0。一句話定位:把粗糙提示詞轉寫成規範提示詞,浮層預覽確認後寫入輸入框(不自動發送)。
倉庫:https://github.com/LMQ00/dsh-prompt-polish
社區目錄頁:https://www.skillhub.cn/plugins/LMQ00/dsh-prompt-polish
實現上分爲 Host 半邊(index.js,export function apply(ctx))與 Client 半邊(client.js,dsh.client.platform = web)。協議爲 MIT;package.json 中版本爲 0.2.0。
核心功能¶
轉寫與預覽¶
- 支持斜槓命令
/polish,也支持點擊輸入框工具條按鈕(位於模型選擇器左側)。 - 轉寫結果在輸入框上方浮層展示;只有點擊「採用」纔會替換或寫入輸入框內容。
- 模型認爲信息不足時,最多追問 3 輪;追問選項的形態對齊 DSH 內置提問組件。
- 輸出語言跟隨輸入語言,插件不提供語言相關配置項。
調用方式與草稿行爲¶
| 調用 | 使用的粗糙文本 | 輸入框草稿 |
|---|---|---|
/polish 幫我寫個登錄頁 |
命令參數文本 | 不改動 |
/polish(草稿非空) |
當前草稿 | 不改動,僅在「採用」時被替換 |
/polish(草稿爲空) |
無 | 浮層提示「先寫點東西」,不調用模型 |
設計約束(v1)¶
- 從不自動發送:
inputActions.submit未被使用;發送始終由用戶自行觸發。 - 用戶文本不進會話日誌:轉寫在 Host 私有路由
POST /polish/translate完成,粗糙文本與規範提示詞都不 append 到 session。 - v1 不聲明 Config:
MAX_ROUNDS = 3、TIMEOUT_MS = 60000、模型取ctx.agentDefaultModel,均爲index.js內代碼常量。
依賴¶
README 說明爲零依賴:index.js 無 bare import;client.js 僅通過模塊加載器查詢 require('react')(瀏覽器模塊表,非 ESM 包解析)。
安裝與啓用¶
資料中的安裝形態爲:以 link: 方式掛進 profile web,Loader 行爲 include:polish。具體 profile 編輯步驟以倉庫內 docs/development.md 爲準;搭環境、安裝 bundle、確認是否生效,也建議按該文檔與 docs/runbook.md 操作。
package.json 中 dsh.client 配置了 platform: web、immediately: true,並向 @deepseek-ai/dsh-client-ui-conversation 注入客戶端腳本;bundle 通過 ./cordis.patch.yml 打補丁。
注意:插件在當前 DSH 進程權限下運行。安裝或 link 前應自行審閱源碼與 MIT 許可證,社區目錄站點與 DeepSeek / 幻方無官方從屬關係,並非官方應用商店。
典型用法¶
先用參數轉寫,輸入框裏原有草稿保持不變:
/polish 幫我寫個登錄頁
無參數時,用輸入框當前草稿作爲粗糙文本(草稿爲空則只提示,不調模型):
/polish
也可不寫命令,直接點輸入框工具條上的 polish 按鈕。預覽滿意後點「採用」寫回輸入框,再自行決定是否發送。
倉庫自測命令(零依賴,node --test):
npm test
適用場景與注意¶
適合:經常在 DSH Web 裏寫提示詞、希望把口語化需求整理成結構更清晰、約束更明確的版本,且希望在寫入前人工確認的人。
不適合或需知:
- 需要把轉寫過程或結果留存在會話歷史裏——本插件刻意不寫 session。
- 需要改追問輪次、超時、默認模型——v1 無 Config,只能改源碼常量或等後續版本。
- 非 Web 客戶端環境——插件聲明爲
web平臺客戶端能力。
出問題時(例如按鈕不見、浮層錯位、修改不生效),可對照倉庫 docs/runbook.md。
結尾¶
dsh-prompt-polish 把「寫規範提示詞」收成客戶端內一步:命令或按鈕觸發、浮層預覽、採用後寫框、不自動發送、不進會話日誌。DSH 生態強調「一切皆插件」;若要在 Web 側打磨提示詞草稿,可從目錄頁或 GitHub 查看說明與源碼。