前言¶
DeepSeek Harness 的核心設計理念是「一切皆插件」。在 Web 界面中,用戶在發送消息前往往需要對草稿進行潤色或重寫。dsh-prompt-optimize 插件通過一個輔助 LLM 調用,允許你在發送消息前重寫當前的 Composer 草稿,且不改變會話狀態。
這是什麼¶
dsh-prompt-optimize 是一個由 peterliucius 維護的 DeepSeek Harness Web 插件。它的核心作用是在 Web Composer 中通過輔助模型重寫當前輸入框的草稿。點擊按鈕僅替換草稿內容,絕不會發送一條新消息或開啓新的對話輪次。
核心功能¶
- 輔助重寫:通過調用輔助 LLM 重寫草稿。
- 無副作用:點擊操作僅替換草稿,不發送消息,不開啓新對話,不追加會話事件。
- 可見性:Sparkle 按鈕始終可見。
- 狀態判斷:按鈕在草稿爲空、包含特殊引用字符(U+FFFC)、會話被移除或輸入機器未處於 Plain 階段時禁用。
- 路由解析:當同時設置了插件
provider/model時優先使用;否則回退到會話的request/header配置或默認代理模型。 - 請求限制:將草稿框架化爲 JSON,使用固定重寫指令,強制配置字節數和 Token 限制,設置超時和
reasoningEffort: 'off'。
安裝與啓用¶
首先啓動 Web Profile:
dsh --profile web
插件默認並未掛載,需通過命令安裝。如果使用 Git 託管的插件且 pnpm 版本大於等於 10,第一次安裝會失敗並打印 allowBuilds 密鑰:
dsh plugin --profile web add github:peterliucius/dsh-prompt-optimize
將打印的密鑰添加到 Web Profile 的 pnpm-workspace.yaml:
allowBuilds:
dsh-prompt-optimize: true
重新運行上述安裝命令即可完成。如果你本地已有代碼且包含 lib/ 目錄,則無需 allowBuilds,直接使用本地路徑安裝:
dsh plugin --profile web add /path/to/dsh-prompt-optimize
插件安裝後會向 Profile 注入一個配置行,包含以下默認值:maxInputBytes: 32768,maxOutputTokens: 4096,timeoutMs: 60000。
典型用法¶
在 Web 界面中,點擊始終可見的 Sparkle 按鈕,插件會捕獲當前草稿並調用輔助模型重寫。重寫後的內容會通過 inputActions.setDraft 僅更新草稿。如果草稿在捕獲後被移動,會彈出 Toast 提示且不再被替換。
適用場景與注意¶
- 權限與安全:插件以當前 DSH 進程權限運行。安裝前請確認源碼來源可信。如果不確定,請固定安裝特定的 Git 提交哈希(
github:peterliucius/dsh-prompt-optimize#<sha>)。 - 配置要求:配置行中的所有字段均爲必填,除非提供了配對的 Route Override;插件庫本身不提供默認值。
- 開發調試:如果需要在本地開發,需要通過 sibling checkout 引用
../dsharness中的依賴。
結尾¶
該插件爲 DeepSeek Harness 的 Web Profile 提供了一個便捷的草稿重寫能力,適合需要在發送前對 Prompt 進行潤色的場景。