DSH Prompt Polisher：DeepSeek Harness 的原生提示詞潤色插件

前言¶

DeepSeek Harness (DSH) 採用插件化架構。在調試提示詞時，頻繁在 DSH 和外部編輯器之間切換會打斷工作流。DSH Prompt Polisher 是一個插件，它在 DSH 輸入框的發送按鈕旁增加了一個原生「潤色」按鈕，利用當前會話的模型配置直接優化提示詞，減少環境切換成本。

它是什麼¶

項目名稱：siyue-zo/dsh-prompt-polisher

維護者：SiYue-ZO

簡介：DeepSeek Harness 的一個安全、原生提示詞潤色插件。它複用當前會話的配置進行潤色，支持衝突檢測、會話隔離和隱私保護。

核心功能¶

• 原生按鈕：在官方 conversation.input.right slot 中增加「潤色」按鈕。
• 配置複用：自動讀取當前 session 的 provider、model 和 reasoning effort，無需重複配置 API key。
• 交互控制：支持加載、取消、結果預覽、失敗重試、應用、複製和恢復原文。
• 衝突檢測：使用 draft + draftRev 機制，請求期間繼續輸入不會覆蓋結果。
• 會話隔離：每會話獨立的 controller、AbortSignal 和 generation guard，避免陳舊響應跨會話寫回。
• 上下文控制：默認只發送當前草稿；可選、受限的最近對話上下文。
• 可訪問性：支持中英文界面、鍵盤可訪問、主題 token 和 reduced-motion。

安裝與啓用¶

環境要求：
- Node.js >= 22.19.0
- DSH 0.1.0-rc.7

安裝命令：

dsh plugin --profile web add github:SiYue-ZO/dsh-prompt-polisher#v0.1.0

安裝後，Web 界面輸入框的發送按鈕旁將出現「潤色」按鈕。

配置¶

插件的默認配置位於 bundle 的 cordis.patch.yml。如需覆蓋，請在 profile 的 cordis.patch.yml 中按相同 row id prompt-polisher 提供完整 config（注意：DSH 的後層 config 是整體替換，不是深合併）。

默認配置參數：

配置示例：

- patch:
    id: prompt-polisher
    config:
      includeContext: false
      contextMessages: 6
      contextMaxChars: 8000
      customInstructions: '優先把驗收標準整理爲清晰列表。'

使用流程¶

1. 輸入與觸發：在 DSH 輸入框撰寫提示詞。空草稿或輸入狀態不是 plain 時，按鈕禁用。點擊「潤色」後，按鈕進入加載狀態，此時可繼續編輯或點擊「取消」。
2. 預覽與處理：請求完成後，結果在上方預覽，原文保留。點擊「應用」可寫回輸入框；點擊「複製」可單獨複製結果。
3. 衝突與恢復：
   - 若草稿未變化，點擊「應用」直接寫回結果。
   - 若草稿變化，按鈕明確改爲「仍然替換」，防止誤覆蓋。
   - 若草稿仍等於剛應用結果且 revision 未變化，「恢復原文」按鈕可用，點擊後恢復至應用前的狀態。

隱私與安全¶

• 不存儲憑證：插件不接收或存儲 API key，模型憑據由 DSH adapter 配置決定。
• 默認隱私保護：includeContext: false 是隱私默認值。開啓後只提取最近的人類/模型純文本，排除工具結果、圖片和插件上下文。
• 數據流隔離：草稿只進入 DSH Host 的一次性輔助 LLM 調用，不寫入正常聊天 transcript。
• 數據去向：最終數據會發送給當前 DSH 模型 adapter 所連接的服務商。

注意事項¶

• 插件不保證在未來的 DSH 版本中可用，建議固定版本號安裝。
• 在生產環境建議將安裝命令中的 #v0.1.0 替換爲審覈過的 commit SHA。

結語¶

該插件通過在 DSH 原生界面中集成潤色功能，降低了提示詞調試的切換成本，適合需要在本地快速迭代 Prompt 的開發者使用。

項目地址：https://github.com/SiYue-ZO/dsh-prompt-polisher