前言¶

在 DeepSeek Harness（DSH）裏寫提示詞，常見做法是先在編輯器裏堆一段口語化草稿，再手動補輸出格式、約束和範圍，或複製到外部工具裏改寫。草稿短還好，一旦涉及多輪對話裏的「按上面的方案改」這類指代，改寫成本會明顯上升。社區插件 dsh-prompt-wisp（提示詞精靈）把這一步收進宿主界面：在聊天輸入框發送鍵左側註冊一枚 ✦ 按鈕，點一下即可用你已配置的模型把草稿改寫成更清晰、結構化、可直接執行的提示詞；另提供會話執行監控告警條，便於發現卡死、空轉等問題。下面介紹其定位、能力與安裝用法。

這是什麼¶

dsh-prompt-wisp 由維護者 jr-create 發佈，分類爲客戶端插件，面向 DSH web profile。一句話：在 composer 工具行、發送鍵旁增加 ✦ 優化按鈕，讀取輸入框草稿，經宿主端調用默認或指定模型改寫後寫回輸入框；模型調用走宿主已配置的服務，插件本身零運行時依賴、零外部網絡請求、零構建步驟。

項目託管於 GitHub（jr-create/dsh-prompt-wisp），當前 package 版本 0.2.0，許可證 MIT。社區目錄頁：skillhub.cn 插件頁。DSH 生態強調「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。

核心功能¶

提示詞優化（✦ 按鈕）¶

• 槽位：官方 conversation.input.right（發送鍵左側），深淺色主題自動適配。
• 流程：讀取草稿 → 宿主調用模型 → 按內置提示詞工程規則改寫 → 寫回輸入框。規則側重點是保留意圖與約束、補明顯缺口、消除模糊表述、語言跟隨草稿；模型只返回改寫正文。
• 會話上下文感知（詳細優化模式）：瀏覽器僅傳 sessionId；會話日誌在宿主端經 sessionPersistence 只讀讀取，不碰原始 .jsonl.zstd。摘要排除 source.kind === 'plugin' 的注入消息；尾部最多 80 事件 → 最多 12 條對話 → 每條最多 600 字符 → 全文預算 4000 字符。無歷史或讀失敗時降級爲「僅按草稿優化」，成功時氣泡可標註「（已結合會話上下文）」。
• 安全與反饋：HTTP 路由 loopback-only + same-origin；草稿單次上限 20,000 字符；空草稿、超長、模型錯誤在按鈕旁內聯提示，不靜默失敗。

雙模式與兜底¶

兩種模式最多向 3 條模型路由併發，先返回乾淨答案者勝出；競速失敗或超時時，本地規則引擎（去廢話詞典、形狀規範化、重複句摺疊）兜底。

模型路由（優先級）¶

1. 請求顯式 { provider, model }（經註冊表校驗）；
2. 宿主「默認模型」（agent-default-model）；
3. 第一個已註冊 provider 的第一個模型。

GET /api/dsh-prompt-wisp/route 可查詢當前會使用的模型。

會話執行監控¶

在輸入區上方 conversation.input.dock 槽位顯示全寬告警條：瀏覽器每 5 秒輪詢（後臺標籤頁暫停），宿主經 sessionPersistence 分析最近 120 個事件，檢測卡死/死鎖（45 秒無新事件）、無效輸出（8+ 步無可見文本）、工具循環（同工具近似參數連續 5 次）、回合失敗（120 秒內）等。只讀分析，不寫入會話、不干預執行；關閉後若有新發現會再彈出。

設置頁¶

DSH 設置 → 提示詞精靈：兩個分組、六個開關，保存後立即生效；配置落在 <DSH_HOME>/dsh-prompt-wisp/config.json。

提示詞優化：「去廢話」（默認關）、「詳細優化」（默認關）。

會話執行監控：「顯示會話監控告警條」（默認開）、「卡死/死鎖檢測」（默認開）、「無效輸出檢測」（默認開）、「工具循環檢測」（默認開）。

HTTP API（loopback + same-origin）¶

可修復錯誤返回 200 + { ok: false, error } 供界面展示；未預期崩潰才 500。

安裝與啓用¶

安裝命令以倉庫 README 爲準：

# 從 GitHub 安裝（推薦鎖定 release tag）
dsh plugin --profile web add github:jr-create/dsh-prompt-wisp#v0.2.0

# 或跟蹤倉庫最新狀態
dsh plugin --profile web add github:jr-create/dsh-prompt-wisp

# 本地開發（鏈接源目錄）
dsh plugin --profile web add link:<本倉庫絕對路徑>

安裝後重啓 dsh web，輸入區工具行出現 ✦ 按鈕即表示加載成功。

兼容性（README 聲明）：DSH 宿主 0.1.5-rc.2（開發與 81 項測試所驗證版本）；profile web；Node ^22.19.0 || >=24.0.0。無 LLM 服務時插件仍可加載，按鈕會提示宿主無可用 LLM；無 sessionPersistence 時上下文感知與執行監控自動關閉。

典型用法¶

1. 在輸入框正常寫草稿（中英文均可）；
2. 點擊 ✦（草稿爲空時按鈕置灰）；
3. 等待片刻，優化結果替換草稿，按鈕旁出現確認氣泡；失敗則顯示紅色原因。

需要完整結構化改寫並結合近期對話指代時，在設置中打開「詳細優化」。想確認當前模型路由時，可在本機訪問 GET /api/dsh-prompt-wisp/route（須滿足 loopback + same-origin）。

適用場景與注意¶

適合：經常在 DSH web 界面寫長提示、希望少切換工具即可完成結構化改寫；希望在 composer 上方被動觀察回合是否卡死、空轉或工具循環的開發者。

權限與風險（插件自述）：讀取點擊 ✦ 時的草稿與默認模型配置（只讀）；寫入優化後的草稿文本；不直連外部 API；會話摘要在詳細模式下由宿主只讀提供。插件以當前 dsh 進程權限運行，安裝前建議閱讀 源碼與 LICENSE，自行評估是否滿足環境要求。

結尾¶

dsh-prompt-wisp 把「草稿 → 可執行提示詞」和輕量會話監控收進 DSH 輸入區，依賴宿主已有模型與 sessionPersistence，無額外構建與外部請求。進一步瞭解與安裝：

• 社區目錄：https://www.skillhub.cn/plugins/jr-create/dsh-prompt-wisp
• 源碼與文檔：https://github.com/jr-create/dsh-prompt-wisp