前言¶
在 DSH 的 composer 裏輸入內容時,經常需要先起草,再發送。dsh-composer-polish 解決的是發送前的一個小動作:把輸入框裏的草稿改得更順,同時不把這條消息發出去。
它把 ✨ 按鈕放在 composer 工具行。點擊後,插件使用 flash 模型改寫當前草稿,再把結果回填到輸入框。你可以先預覽、編輯,再決定是否發送。
這是什麼¶
dsh-composer-polish 是 tianji-qingtian 維護的一個 DeepSeek Harness 插件,許可證爲 MIT,安裝命令固定到 v0.1.4。
它的定位很窄:只做 composer 草稿潤色。它不會代替主模型完成任務,也不會把潤色結果直接作爲聊天消息發送。
核心功能¶
按鈕與狀態¶
按鈕位於 conversation.input.right,也就是 composer 輸入工具行中。
- 草稿爲空或純空白時,按鈕禁用。
- 潤色中顯示 spinner。
- 重複點擊不會觸發第二次請求。
改寫路徑¶
點擊按鈕後,插件通過 harness 內置 commands remote 發起 /polish,不使用自定義 wire protocol。
/polish 命令註冊時 recordInput 爲 false,原始草稿不寫入會話日誌;潤色結果記錄在 command/done。
flash 改寫¶
插件使用零前綴 flash 改寫:
- 模型固定爲
deepseek-v4-flash。 - 使用流式調用。
reasoningEffort爲off。- 約 2000 token 上限。
- 改寫時主模型不運行,且不觸碰主模型 prefix cache。
- 固定模型 id 缺失時,通過
llm.listModels做一次 flash 類模型目錄回退。
回填而不是發送¶
潤色結果通過 inputActions.setDraft 直接回填輸入框,而不是發送爲聊天消息。
- 圖片附件不被處理,僅替換文本。
- 改寫失敗或返回空時,草稿保持不變,僅輸出 console log,不顯示 toast。
- 改寫期間草稿發生變化時,跳過回填,較新編輯優先。
語言與術語¶
改寫跟隨草稿語言和語氣。代碼塊、文件路徑、命令行、標識符和技術術語保持原樣。
按鈕標籤和提示跟隨 harness locale 服務,支持 zh/en。
安裝與啓用¶
準備 dsh CLI¶
需要先有 dsh CLI 在 PATH 上。如果平時只用 npx 運行 harness,可以先全局安裝:
npm install -g @deepseek-ai/dsh
如果偏好 pnpm:
pnpm add -g @deepseek-ai/dsh
也可以不安裝全局命令,後續命令使用 npx @deepseek-ai/dsh 前綴運行。
安裝插件¶
dsh plugin --profile web add "github:tianji-qingtian/dsh-composer-polish#v0.1.4"
安裝後重啓對應 profile 的 harness:
dsh --profile web
重啓後,composer 工具行會出現 ✨ 按鈕;/polish 命令會在 host half 加載後註冊。可以在 Settings → Plugins 中查看 dsh-composer-polish。
典型用法¶
1、在 composer 輸入框裏輸入草稿。
2、點擊工具行中的 ✨ 潤色 / Polish。
3、幾秒後,潤色文本會替換輸入框中的草稿。
4、預覽、編輯,確認沒問題後再按發送。
適用場景與注意¶
適合需要頻繁整理 DSH composer 草稿、希望發送前快速改順文本的場景。
使用注意:
- DeepSeek Harness 處於 developer preview,且迭代較快,可能出現兼容性破壞變更。
- 插件會以當前 dsh 進程權限運行。安裝前應檢查源碼與 MIT 許可證。
- 草稿超過 50 KB 會在改寫前截斷。
- 改寫期間草稿發生變化時,會跳過回填,較新編輯優先。
- 原始草稿通過
recordInput: false不寫入會話日誌;潤色結果會記錄在command/done。 - 改寫模型固定爲
deepseek-v4-flash;如果 harness 重命名模型 id,目錄回退會選擇一個 flash 類替代模型並記錄一行日誌。 package.json聲明 Node 版本爲^22.19.0 || >=24.0.0,packageManager爲pnpm@11.14.0。
小結¶
dsh-composer-polish 把“潤色”放在發送前:它只改輸入框裏的草稿,不發聊天消息,不動圖片附件,也儘量保留代碼塊、路徑、命令行和技術術語。對於 DSH composer 的日常輸入,這是一個比較剋制的前置整理工具。
倉庫地址:https://github.com/tianji-qingtian/dsh-composer-polish