前言¶

在 DeepSeek Harness（DSH）的 Web 端寫提示詞時，草稿可能已經包含任務、文件和目標，但仍需要整理成更適合模型理解的表達。已有做法通常是在另一個窗口手動改寫，或臨時拼接 system prompt。dsh-prompt-polish 把這一步放進 composer：在 Web 輸入框工具行添加 ✨ 按鈕，選擇一種重寫風格後，調用當前已連接的 LLM 重寫草稿，並用結果替換原草稿，方便發送前審閱。

插件定位¶

這是一個 DSH 客戶端插件，由 JoukoPuro 維護，許可證爲 MIT。它適用於 DSH Web profile 場景，要求 @deepseek-ai/dsh web profile 運行，並且已配置模型適配器（例如 DeepSeek provider 帶 API key）。插件在 DSH 進程內工作，不要求額外部署獨立服務；由於它會以當前 dsh 進程權限運行，安裝前應先檢查源碼與許可證。

核心功能¶

• 在 Web composer 工具行添加 ✨ sparkle 按鈕；按鈕僅顯示圖標，完整說明通過 tooltip 提供。
• 提供 balanced、concise、detailed、code-oriented 四種重寫風格。
• 菜單文案跟隨瀏覽器語言，支持 zh, en, ja, ko, fr, de, es, pt, ru, it, tr, vi，回退英語。
• 使用當前連接的模型：未配置顯式路由時，解析 agentDefaultModel.currentSelection()；也可通過顯式 provider/model 配置指定。
• 註冊 POST /prompt-polish 接口，並通過 ctx.llm 流式完成一次 LLM 重寫。
• 用重寫結果替換草稿，便於發送前審閱。

安裝與啓用¶

1、確認當前 DSH 的 web profile 已能連接模型，例如已配置 DeepSeek provider 和 API key。

2、在插件檢出目錄或包含 ./dsh-prompt-polish 的目錄執行：

dsh plugin --profile web add ./dsh-prompt-polish

3、重啓 Web 服務，讓 profile 加載新增 bundle：

dsh web

4、打開 Web UI，在輸入框輸入草稿，點擊 composer 工具行的 ✨ 按鈕，選擇需要的重寫風格。

可選配置¶

插件在 profile 的 cordis.patch.yml 中接受 prompt-polish 的可選項。已覈實的配置項包括：

• provider：顯式路由，可選。
• model：顯式模型，必須與 provider 配對。
• style：默認重寫風格，可選 balanced、concise、detailed、code-oriented。
• maxTokens：重寫調用的輸出上限。
• system：自定義重寫指令，替換內置的按風格提示。

如果未配置 provider/model，插件會使用 agentDefaultModel.currentSelection()，也就是當前會話使用的默認模型。配置示例中的具體 provider、model 名稱需要按當前 DSH 環境填寫；這裏不給出未在已覈實事實中出現的固定值。

工作機制¶

插件分爲宿主端和瀏覽器端。

• 宿主端 lib/index.js：在 Web 服務端註冊 POST /prompt-polish，並通過 ctx.llm 流式完成一次 LLM 重寫。
• 瀏覽器端 lib/client.js：在 composer 工具行註冊 ✨ 按鈕，打開風格菜單，提交草稿，並用潤色後的文本替換原草稿。

瀏覽器端是手工構建的 closure-factory 產物，外部依賴限於 react 和 @deepseek-ai/dsh-client-ui-primitives。插件的 peerDependencies 包含 @deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-llm ^0.1.0-rc.6、@deepseek-ai/dsh-agent ^0.1.0-rc.6。

本地驗證¶

在改動正式 profile 前，可以先用臨時端口驗證插件是否加載：

dsh web --port 3099
curl -s http://127.0.0.1:3099/plugins/dsh-prompt-polish/client.js | head

也可以直接調用重寫接口，驗證請求路徑和參數：

curl -s -X POST http://127.0.0.1:3099/prompt-polish \
  -H 'content-type: application/json' \
  -d '{"text":"read a.csv and sort by b","style":"balanced"}'

上面命令用於檢查 /plugins/dsh-prompt-polish/client.js 與 POST /prompt-polish 是否可用；實際 text 和 style 應按自己的草稿填寫。

適用場景與注意¶

適合在 DSH Web 端編寫或審閱提示詞的使用者：已有模型適配器，希望在發送前快速整理草稿，並保留審閱步驟。不適合未配置模型適配器，或需要完全脫離當前 dsh 進程權限運行的場景。

安裝前請注意：

• 插件以當前 dsh 進程權限運行，安裝前檢查源碼與許可證。
• 顯式 model 必須與 provider 配對。
• 許可證爲 MIT。
• DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應描述爲官方應用商店。

結尾¶

dsh-prompt-polish 的價值在於把“發送前重寫提示詞”收斂到 composer 工具行內的一個可審閱動作：使用當前已連接模型，支持多種風格，並用重寫結果替換草稿，而不是直接發送。

GitHub 地址：https://github.com/JoukoPuro/dsh-prompt-polish

已覈實資料未提供可用的社區目錄頁 URL；如需從目錄查找，請以目錄站點的實際頁面爲準。