前言¶
在 DSH（DeepSeek Harness）裏和 agent 協作時，寫給模型的指令、要發出的消息，經常寫着寫着就不太通順。常見的做法是另開一個會話，把草稿粘過去讓模型改寫，再複製回來——切來切去，步驟不少。
@max-null/dsh-draft-polish 把這一步收進了輸入框：發送按鈕左側有一個 ✨ 按鈕，點一下就調用 LLM 潤色當前草稿，結果直接回填輸入框。潤色不創建會話、不寫入歷史，會話正在輸出時也照常可用。下面按功能、安裝、用法、設置的順序介紹這個插件。
這是什麼¶
一句話定位：面向 DeepSeek Harness 的草稿潤色插件。維護者是 Max-Null，屬於 @max-null/* 插件系列、SSID（思靈 · Seek Soul in Darkness）桌面體驗的組成部分，從分形（OC 桌面殼）的同類功能遷移進化而來。當前版本 0.2.3，許可證 MIT。
DSH 的理念是「一切皆插件」，潤色這種掛在輸入框旁邊的小工具，正適合以插件形式接入，而不是塞進內核。
核心功能¶
已覈實的能力有六項，逐條說：
- 一鍵潤色：發送按鈕左側的 ✨ 按鈕，點擊後 LLM 潤色草稿，結果回填輸入框。輸入爲空時按鈕不觸發。
- 會話進行中可用：潤色走 DSH
llm渠道，與 agent 會話調度解耦，會話正在輸出時照常潤色。這一點是相對 OC 桌面殼舊版本的改進。 - 攜帶會話上下文：默認把最近 4 條對話作爲背景上下文帶給模型，幫助理解你這段草稿的意圖；不需要時可以關閉。
- 複用現有模型渠道：默認繼承當前會話的渠道，不需要單獨配 API Key；也可以單獨指定 provider 和 model。
- 零污染：潤色不創建會話、不寫入歷史，只改輸入框裏的草稿。
- 按會話隔離：每個會話的輸入框獨立。潤色進行中切換到別的會話，結果仍寫回發起潤色的那個會話。
安裝與啓用¶
先做安裝。官方方式是把插件加進指定 profile：
dsh plugin --profile <name> add @max-null/dsh-draft-polish
也可以手動加入 profile 的 package.json dependencies 和 dsh.profile.bundles：
- id: draft-polish
name: '@max-null/dsh-draft-polish'
版本與兼容性：0.2.2 及以上適配 DSH 0.1.2-alpha.2+（當前 0.2.3 屬於這一檔）；0.2.1 及更早版本適配 0.1.1-rc.2。安裝前先確認自己的 DSH 版本。
典型用法¶
經過上面的步驟，插件啓用後即可使用。日常潤色的完整流程是四步：
- 在輸入框裏寫草稿；
- 點發送按鈕左側的 ✨ 按鈕（輸入爲空時按鈕不觸發）；
- 等待數秒，潤色結果自動替換輸入框內容，按鈕轉圈表示潤色中；
- 檢查結果，滿意後照常發送。
設置¶
設置頁 → 左欄「潤色設置」條目（DSH 0.1.2-alpha.2 起，配置命名空間 draft-polish）。主要配置項與默認值如下：
| 配置 | 默認值 | 說明 |
|---|---|---|
provider |
'' |
潤色模型渠道，留空繼承當前會話渠道 |
model |
deepseek-v4-flash |
潤色用的模型 |
reasoningEffort |
off |
思考強度，潤色場景用 off 最快 |
budgetTokens |
1024 |
輸出 token 預算 |
temperature |
0.3 |
低隨機性，保住原意 |
timeoutMs |
30000 |
超時兜底 |
contextEnabled |
true |
是否攜帶會話上下文 |
recentWindowMessages |
4 |
作爲上下文的近期對話條數 |
只改想改的項即可，默認值覆蓋多數場景。
權限與安全¶
裝進自己的環境前，值得先弄清它碰了什麼：
- 網絡：client 半端只通過同源相對路徑
/draft-polish/api/*訪問當前 DSH 進程內的 host JSON API（本機），不請求任何外部 URL、不上傳數據、無遙測。 - 憑證：插件不持有 API Key，潤色調用經 DSH
llm渠道，複用你已配置的模型渠道與憑證。 - 依賴：運行時零外部 npm 依賴（schemastery 已內聯進
lib/index.js）；peer 依賴只有 DSH 官方服務與 react，由 DSH 運行時提供。 - 文件系統：不讀寫任何文件，唯一的持久狀態是
draft-polish設置命名空間，由 DSH settings 服務管理。
失敗時也不吞草稿：host API 不可用 → 提示錯誤、草稿不變；LLM 調用失敗 → 原草稿保留並提示，默認 30 秒超時；上下文讀取失敗 → 降級爲不帶上下文潤色，不中斷。
需要提醒：插件以當前 dsh 進程的權限運行，安裝前建議檢查源碼與許可證（本項目爲 MIT），確認沒有超出預期的行爲。
適用場景¶
適合這幾類情況：經常在 DSH 裏給 agent 寫指令、發消息，希望發出去之前把措辭理順；會話經常長時間運行，不想爲了潤色一段話專門另開會話；在意會話歷史保持乾淨，不希望潤色過程留下痕跡。多會話並行使用也沒問題，按會話隔離的機制保證結果寫回正確的輸入框。
小結¶
@max-null/dsh-draft-polish 把「潤色一段草稿」從切會話、粘貼、複製，簡化成點一下按鈕：調用複用 DSH 現有模型渠道，不建會話、不寫歷史，失敗也不丟草稿。如果你的日常工作重度依賴 DSH 輸入框，可以按上面的步驟裝上試一試。
插件目錄頁：https://www.skillhub.cn/plugins/Max-Null/dsh-draft-polish
GitHub 倉庫：https://github.com/Max-Null/dsh-draft-polish
說明一句：skillhub 是社區維護的獨立插件目錄，與 DeepSeek、幻方沒有官方從屬關係。
