dsh-improve-prompt：一鍵改寫輸入框草稿，讓 Agent 照着執行

在 DSH（DeepSeek Harness）開發流程中，輸入框是交互的核心。開發者輸入的原始草稿往往口語化、含糊不清，或者包含大量指代，直接發給 Agent 執行效果較差。dsh-improve-prompt 插件通過本地 LLM 能力，將輸入框草稿改寫爲結構清晰、指令明確的提示詞，並確保不丟失關鍵信息。

核心功能¶

保真閘與長度閘
插件內置兩層安全機制。保真閘會提取草稿中的硬事實（如文件路徑、URL、代碼塊、版本號），驗證改寫後是否保留。若缺失，會觸發修復調用或回灌原始細節。長度閘限制改寫後的文本長度，標準檔不超過輸入的 2.5 倍，且不低於 200 字符。若超預算，插件會拒絕改寫並保留原文。

一鍵改寫與撤回
點擊輸入框工具欄的 ✦ 按鈕，插件會在 1-3 秒內將草稿直接替換爲增強版本。替換後 8 秒內可點擊「撤回」恢復原文。一旦手動編輯輸入框，撤回條自動消失，不會覆蓋用戶的新輸入。

質量憑證與檔位
改寫完成後，輸入框上方會顯示狀態條，包含「保真 X/5」、「長度倍率」、「耗時」等信息。插件提供輕（去廢話、≤1.2x）和標準（結構化、≤2.5x）兩檔位，支持一鍵切換，檔位記憶在本地。

智能上下文與斜槓命令
對於含指代（如「那個」、「it」）或短草稿，插件會自動攜帶最近 N 輪對話上下文。對於斜槓命令（如 /bugfix），插件會保留命令前綴，僅改寫正文內容。

失敗即原文
在模型不可用、超時或網絡失敗時，插件絕不改動輸入框內容，僅返回提示信息，保證用戶輸入不被破壞。

零配置與接口
插件無需 API Key，直接調用 DSH 自帶模型。同時提供本地 HTTP 接口 POST /dsh-improve-prompt/api/improve，供腳本或工具集成。

安裝與啓用¶

安裝
確保 dsh 版本不低於 0.1.1-rc.2。在終端執行以下命令安裝插件：

dsh plugin --profile web add dsh-improve-prompt

啓用與卸載
安裝後重啓 dsh web，輸入框工具欄（發送鍵左側）會出現 ✦ 按鈕。點擊按鈕懸停可查看當前檔位。

dsh plugin --profile web remove dsh-improve-prompt   # 卸載

典型用法¶

1. 口語化改寫
輸入口語化需求：

就是那個幫我把 src/host/config.ts 裏的 maxRatioFor 改成 2.5 唄
點擊 ✦ 後，草稿被替換爲：
把 src/host/config.ts 裏的 maxRatioFor 改成 2.5

2. 斜槓命令支持
輸入 /bugfix ISS-202607-00090605A 用戶反饋填充後密碼框被清空。
點擊 ✦ 後，前綴 /bugfix ... 被保留，正文被改寫爲排查步驟清晰的版本。

3. 腳本集成
通過本地 HTTP 接口調用：

curl -X POST http://127.0.0.1:3080/dsh-improve-prompt/api/improve \
  -H 'content-type: application/json' \
  -d '{"text":"把那個接口加上限流","sessionId":"sess-1","mode":"standard"}'

4. 失敗處理
若未配置默認模型，點擊 ✦ 時會報錯「未找到可用模型」，原文保持不變。

適用場景與注意¶

適用場景
* 需要精準保留文件路徑、類名、版本號等硬事實的改動請求。
* 口語化、英文長句或中英混合草稿的規範化。
* 續寫式草稿或報錯日誌的直接貼入。
* 希望快速驗證 Prompt 改寫效果，並隨時撤回的場景。

注意事項
* 插件運行在當前 DSH 進程權限下，安裝前建議檢查源碼。
* 失敗時插件不會修改輸入框內容，適合對輸入安全要求高的場景。
* 僅支持 Web Profile，需在 dsh web 環境中使用。

短結尾¶

dsh-improve-prompt 專注於解決輸入框草稿質量參差不齊的問題。通過保真閘、長度閘和一鍵撤回機制，它能在幾秒鐘內提供高質量的 Prompt 改寫，同時保證用戶輸入的絕對安全。如需定製行爲，可覆蓋 prompts/*.md 模板文件。

GitHub 倉庫：https://github.com/hoyyang/dsh-improve-prompt