DeepSeek Harness 插件：dsh-prompt-optimizer

DeepSeek Harness（DSH）採用插件化架構。開發者經常在輸入框中編寫 prompt，但很難確保其結構清晰。dsh-prompt-optimizer 插件通過一鍵優化解決了這個問題。

插件簡介¶

這是一個爲 DSH composer 設計的插件。輸入草稿並按 ✨（或 Alt+O）即可重寫爲更清晰、結構化的 prompt。該插件默認零配置，直接複用當前會話的模型服務，也支持接入任意 OpenAI 兼容的接口。

插件由 winditer 維護，採用 MIT 許可證。

安裝¶

推薦通過 GitHub 倉庫身份安裝，以避免 npm 名字衝突導致市場無法識別插件來源：

dsh plugin --profile desktop add github:winditer/dsh-prompt-optimizer

安裝後，請完全重啓 DSH（退出並重新打開），composer 右側纔會出現 ✨ 按鈕。

核心功能¶

• 一鍵優化：在 composer 中輸入草稿後，點擊右側的 ✨ 按鈕，或選中輸入框後按 Alt+O。插件會立即在輸入框上方顯示優化預覽卡片。
• 真流式預覽：利用 harness 的 webServer 服務進行 SSE 傳輸。模型先流式輸出“推理過程”（通常爲次要顏色），隨後流式輸出潤色後的 prompt。你可以實時看到模型思考的過程。
• 零配置默認：默認情況下，插件複用當前會話（session）或 agent 的默認模型配置（agentDefaultModel + llm 服務），無需額外填寫 API Key。
• 自定義端點模式：取消勾選“使用當前會話模型”後，可填入任意 OpenAI 兼容的 /chat/completions 接口地址、API Key 和模型名。
• 完成操作行：預覽完成後，卡片底部提供操作按鈕：替換草稿（將結果寫回 composer）、複製、重新優化 或 放棄。
• 雙語 UI：界面語言跟隨 DSH 的當前語言（中文/English），無需刷新頁面。
• 本地配置：設置持久化保存在 ~/.dsh/prompt-optimizer-config.json，通過本地 RPC 通道與主機通信，獨立於主機的設置註冊表。
• 深色模式支持：所有顏色跟隨 DSH 主題變量，在深色夜間模式下使用品牌藍和白色文本。
• 本地憑證安全：僅在自定義端點模式下，API Key 存儲在本地配置文件中，且僅發送至你配置的接口地址。

使用流程¶

1. 在 DSH 的 composer 中輸入一段原始 prompt。
2. 點擊右側的 ✨（或按 Alt+O）。
3. 預覽卡片出現在輸入框上方。你會先看到模型輸出的推理文本，隨後看到優化後的 prompt 逐 token 流式顯示。
4. 查看結果：
   - 點擊 替換草稿，將潤色後的內容直接寫入 composer。
   - 點擊 複製，將內容複製到剪貼板。
   - 點擊 重新優化，基於原草稿再次運行。
   - 點擊 放棄，關閉預覽卡片。

配置說明¶

進入 DSH 的 設置 → 通用設置 → Prompt 優化，可以看到以下配置項：

配置文件保存在 ~/.dsh/prompt-optimizer-config.json。卸載插件時，該文件也會被清理。

架構與安全¶

插件採用 Host-Client 分離設計：

• Host Half：位於 lib/index.js。通過 loopback RPC 通道（/dsh-prompt-optimizer）持久化配置，並通過 webServer 註冊 HTTP API（/dsh-prompt-optimizer/api）。它負責處理流式請求。
• Client Half：位於 dist/client.js。通過 fetch 調用 Host API，渲染 UI（按鈕、預覽卡片、設置行）。

安全注意事項：
- 默認路由不發送憑證，它直接複用 harness 已配置的 provider。
- 自定義模式的 API Key 僅保存在本地，不會上傳到其他服務器。
- 優化結果僅展示在預覽卡片中。只有點擊 替換草稿 後，文本纔會寫入當前會話。

生態與資源¶

插件目錄：dsh-prompt-optimizer

源碼倉庫：github.com/winditer/dsh-prompt-optimizer