前言¶
DeepSeek Harness (DSH) 插件生態旨在通過模塊化擴展工具集。narrative-prompt-polish 插件位於“模型推理”分類下，由 shengyvself 維護。它解決了一個常見痛點：原始草稿往往缺乏清晰度，難以直接交付給 AI Agent。它通過啓動一個可對話的子代理來打磨提示詞，而不是立即覆蓋文本。本插件要求 DSH 版本 ≥ 0.1.5。
核心功能¶
-
主框 ✨ → 可對話子代理打磨
點擊主框右下角的✨，服務端會通過POST /api/polish.start在主會話下起一個continuable子代理。該子代理繼承當前會話的 provider、model 和預設。客戶端隨後打開該子代理會話，進入多輪追問環節。滿意後，用戶手動將結果複製回主輸入框。 -
C 方案與 Prompt Cache
默認使用full模式，通過deriveMessages復刻[system] + [...history]前綴。這確保了前綴與主會話一致，從而命中 prompt cache，僅增量計算草稿與潤色指令。若主會話非 live 會話，會降級至partial（近期對話）或none（裸草稿）。 -
意圖分類與安全寫回
插件內置本地正則分類意圖（debug/implement/explain/chat）。在 CAS（Check-And-Set）機制下，若草稿在打磨期間被用戶修改，插件會拒絕覆蓋並提示“草稿已變，未應用潤色”。 -
Trace 與事件總線
每次調用會追加 JSONL Trace 到lore/traces/prompt-polish/YYYY-MM-DD.jsonl，記錄意圖、上下文模式、緩存命中等信息。插件支持事件總線聯動，外部模塊可通過廣播narrative:prompt-polish:trigger觸發單次 polish 流程。
安裝與啓用¶
安裝過程依賴 DSH 內核提供的子代理編排服務。
dsh plugin --profile web add github:shengyvself/narrative-prompt-polish
安裝後重啓 DSH Web 即可生效。插件在 0.2.0 版本起移除了所有第三方依賴。
典型用法¶
- 在主框輸入草稿。
- 點擊輸入框右下角的
✨。 - 子代理會話被打開，任務書進入首輪對話。
- 在子代理會話中多輪追問，優化提示詞細節。
- 滿意後，手動複製回填至主輸入框。
適用場景與注意¶
本插件旨在輔助提示詞優化，適合需要將模糊需求轉化爲具體執行指令的開發者。
- 倉庫遷移：原倉
narrative-prompt-polish已遷移至dsh-prompt-only-forge，舊倉保持只讀，不再接受新提交。 - UI 與安全：無野生 DOM 注入，UI 走官方 slot。服務端無
@deepseek-ai/*靜態 import。 - 配置調整：
strictFull: true可改爲硬失敗（no-session），側邊欄浮按鈕在 0.2.0 中已移除。
短結尾¶
該插件通過子代理機制和 C 方案，爲 DSH 用戶提供了意圖感知的提示詞打磨能力。更多細節與源碼，可查看插件目錄或GitHub。
