dsh-prompt-refiner：DeepSeek Harness 提示詞精煉插件

前言¶

DeepSeek Harness (DSH) 採用“一切皆插件”的理念。在開發智能體或調試模型時，開發者經常需要將模糊的草稿改寫成結構化、可執行的提示詞。dsh-prompt-refiner 是一款輸入欄「提示詞精煉」插件，旨在解決提示詞結構混亂、精煉成本高（特別是思考 token 計費問題）以及缺乏監控數據等問題。

核心功能¶

插件提供以下能力：
* 結構化改寫：將輸入文本改寫爲「目標 / 背景 / 步驟 / 要求 / [假設]」結構。
* 成本路由：精煉過程可路由到便宜的模型（如 deepseek-v4-flash），而非跟隨會話默認模型。
* 結果緩存：基於 LRU 策略緩存精煉結果，相同輸入零成本複用。
* Token 統計：面板展示用量，並將數據落盤爲 JSONL，支持 GET /prompt-refine/stats 查詢。
* 思考檔位控制：默認 off，避免不必要的思考 token 消耗。
* 對比面板：展示原文與改寫結果，假設部分獨立高亮。
* 清洗與校驗：結果長度護欄，max-tokens 截斷判爲失敗並丟棄。

安裝與配置¶

插件提供動態模式（免安裝）和靜態模式（推薦）兩種安裝方式。

動態模式（嚐鮮）¶

在 DSH 的「Cordis 動態插件」面板中：
1. 新建插件；
2. 在 code.host 粘貼 src/host.js 全文，code.client 粘貼 src/client.js 全文；
3. 激活並授權，輸入欄出現 ✨ 按鈕。
注意：動態版限制模型跟隨會話默認選擇、緩存僅內存、統計不落盤。

靜態模式（推薦）¶

使用 npm 包安裝：

npm publish          # 或先在本地 npm pack
dsh plugin --profile web add dsh-prompt-refiner

安裝後，在 ~/.dsh/profiles/web/cordis.patch.yml 註冊插件行：

- insert:
    - id: dsh-prompt-refiner
      name: 'dsh-prompt-refiner'

重啓 dsh web 服務後生效。

配置文件¶

編輯 $DSH_HOME/prompt-refiner/config.json（默認 ~/.dsh/prompt-refiner/config.json）。配置項優先級爲：cordis 條目 > config.json > 內置默認。

{
  "model": "deepseek-v4-flash", // 優化器模型；null = 跟隨會話當前模型
  "provider": null,             // null = 跟隨會話當前 provider
  "reasoningEffort": "off",     // 思考檔位：'off'|'low'|'high'|'max'
  "maxTokens": 2048,
  "temperature": 0.3,
  "minChars": 0,
  "maxChars": 8000,
  "resultMaxChars": 4000,       // 結果長度護欄
  "cacheMax": 200,
  "cacheTtlMs": 86400000,
  "metrics": true               // 統計落盤開關
}

關鍵配置說明：思考檔位¶

DeepSeek 適配器把模型的 thinking token 計在 outputTokens 裏。不顯式指定檔位時，適配器默認 high，會導致精煉任務產生大量無用的思考內容。
插件默認下發 reasoningEffort: 'off'，並在面板顯示實際生效的檔位（如 思考 off）。若請求的檔位不被支持，插件會自動回退到該模型支持的最省檔位。

統計與監控¶

插件提供兩類數據反饋：
1. 落盤文件：$DSH_HOME/prompt-refiner/metrics.jsonl。每次精煉追加一行記錄，包含時間、模型、是否緩存命中、是否跳過、實際思考檔位、字符數、入/出/思考 token、耗時。
2. 接口查詢：GET /prompt-refine/stats。用於彙總自宿主啓動起的內存累計及落盤目錄位置。
3. 面板展示：實時顯示模型、字數變化、耗時、緩存狀態、思考檔位及 token 統計。

已知限制與差異¶

與 dsh-prompt-optimize-plugin 的差異：本插件補齊了成本控制層。相比於 dsh-prompt-optimize-plugin，本插件支持成本路由（使用便宜模型）、LRU 緩存、統計落盤，以及思考檔位默認關閉（防止非必要計費）。
結果截斷：若結果因 max-tokens 被截斷，會被判爲失敗並丟棄，不會應用半截提示詞。
未驗證項：
- 本地路徑掛載（不發佈直接指向本目錄）的 CLI 用法尚未驗證。
- 面板在真實瀏覽器裏的觀感需要人眼確認。
- Phase A 路線（自動攔截）的實現狀態。

總結¶

dsh-prompt-refiner 是一款專注於提示詞結構化與成本控制的 DSH 插件。通過默認關閉思考檔位、支持緩存路由以及完善的統計落盤，它可以幫助開發者在精煉提示詞時有效控制 Token 消耗。

目錄頁：https://www.skillhub.cn/plugins/glh5835/dsh-prompt-refiner
GitHub：https://github.com/glh5835/dsh-prompt-refiner