前言¶
在 DeepSeek Harness（DSH）裏跑智能體，輸入框裏往往先是一段口語化的草稿：意圖有了，但結構、約束和上下文經常不齊。自己手工擴寫成「給模型看的」提示詞既費時，也容易漏掉關鍵字段。社區裏已有類似「增強提示詞」的交互參考；@amyaxy/dsh-prompt-boost-model 面向 DSH Web GUI 做了一套獨立實現，並支持在設置裏選擇用哪條模型路由完成改寫，而不是隻靠兩個自由文本框拼 provider / model。
下面介紹這個插件的定位、能力與安裝用法。事實以 GitHub 倉庫 README 與 package.json 爲準；生態目錄見 SkillHub 插件頁。DSH 的社區插件目錄與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
- 名稱：
@amyaxy/dsh-prompt-boost-model（npm 包名，倉庫 amyaxy/dsh-prompt-boost-model） - 維護者：amyaxy
- 分類：模型推理（SkillHub 歸類）
- 版本（資料中明確）：
0.1.1，許可證 MIT；要求 DSH>=0.2.0-rc.2 - 一句話：在 Web 輸入框把當前草稿改寫爲更結構化的提示詞，預覽確認後再回填；增強所用模型可在設置中選擇。
核心功能¶
輸入框與快捷鍵¶
| 位置 | 行爲 |
|---|---|
| 輸入框右側「增強」按鈕 | 把當前草稿改寫爲結構化提示詞，先預覽，確認後纔回填 |
快捷鍵 Ctrl + Alt + B |
同上 |
改寫結果僅在用戶確認後替換草稿，並保留「撤銷」入口，原始草稿不會丟失。README 寫明實現參照 WorkBuddy 的增強提示詞體驗，爲本插件獨立實現的一套輕量方案。
設置頁：增強提示詞¶
路徑：設置 → 增強提示詞。可配置項包括：
- 勾選啓用
- 選擇增強所用模型（分組下拉框）
- 溫度、輸出上限、超時
- 自定義指令（
systemPrompt）
模型下拉框與路由¶
與「兩個自由文本輸入框拼模型 id」的做法相比，本插件在設置頁渲染真實的 <optgroup> / <option>，數據來自宿主當前模型註冊表（示例結構見 README：按提供商分組，選項同時顯示友好名與模型 id）。
- 列表由宿主聚合
llm.listProviders()與llm.listConfigurableProviders()，尚未配置但可激活的提供商也會出現在列表中 - 選擇「跟隨默認模型」時不鎖定路由，由宿主默認模型兜底
路由優先級：
- 本插件設置裏選定的
provider/model - 宿主默認模型（
agentDefaultModel）
診斷與安全¶
- 模型未返回文本時，
finish分塊會透出更具體原因（例如適配器失敗、推理模型佔滿輸出預算、撞上輸出上限等），便於調整maxOutputTokens或換模型 - 增強接口會消耗模型額度，僅在同機同源頁面可用：loopback、嚴格
Host/Origin校驗、拒絕代理轉發頭、請求體與timeoutMs約束（詳見 README「安全邊界」）
安裝與啓用¶
官方安裝命令如下（勿自行拼接其他 dsh plugin add 形式）：
dsh plugin install @amyaxy/dsh-prompt-boost-model
從本地目錄安裝時，將 <此目錄的絕對路徑> 換爲插件源碼所在路徑：
dsh plugin install <此目錄的絕對路徑>
安裝後刷新頁面即可；cordis.patch.yml 會插入一條 prompt-boost 條目。
典型用法¶
- 在 DSH Web 輸入框寫好草稿意圖。
- 點擊「增強」或按
Ctrl + Alt + B，等待模型生成結構化提示詞並在預覽中查看。 - 確認後回填；不滿意可撤銷，草稿仍在。
- 在 設置 → 增強提示詞 中啓用功能，從下拉框選擇增強模型，按需調整
temperature、maxOutputTokens、timeoutMs與systemPrompt。
設置在 DSH 數據目錄下的獨立文件中（非宿主 settings.describe() 表單），路徑爲 <DSH_HOME>/prompt-boost/settings.json。資料中的字段示例：
{
"enabled": true,
"provider": "trae-enterprise",
"model": "DeepSeek-V4.1-Flash-1017",
"temperature": 0.3,
"maxOutputTokens": 4096,
"timeoutMs": 60000,
"systemPrompt": ""
}
寫入採用「臨時文件 + rename」的原子替換；讀取逐字段校驗，損壞時退回默認值。
適用場景與注意¶
適合：經常在 DSH Web 裏寫長提示、希望一鍵結構化且能顯式選擇增強模型的開發者；已配置多提供商、需要從註冊表裏點選路由而不是手填 id 的環境。
注意：
- 插件在當前 DSH 進程權限下運行，增強調用會走你所選模型的額度與 API 配置；安裝前應閱讀源碼與 MIT 許可證，並知悉上述本地訪問邊界。
- 本地路徑安裝的包無法解析
@deepseek-ai/*與react，因此宿主端僅使用node:內置模塊、export const inject = []，配置頁由瀏覽器端自繪——這是設計約束，不是功能缺失。 - 引擎要求
dsh >=0.2.0-rc.2，版本不匹配時請先升級宿主。
結構速覽¶
package.json # dsh.bundle.patch + dsh.client
cordis.patch.yml # 同時掛載宿主端與瀏覽器端
lib/index.js # 路由、模型目錄、增強調用、設置存儲
lib/client.js # 設置頁、輸入框按鈕、預覽浮層、i18n
中英文案已內置；label 使用 thunk，切換語言即時生效。
結尾¶
@amyaxy/dsh-prompt-boost-model 把「草稿 → 結構化提示詞」收進 DSH Web 輸入框，並用宿主模型註冊表驅動的下拉框降低選錯路由的概率。需要安裝命令與配置字段時，以 README 爲準。
