前言¶
在 DSH Composer 裏寫提示詞,常見問題是想法只有一兩句,下游模型卻需要任務邊界、驗收標準和約束才能穩定執行。手工逐條補全費時,單純「潤色文筆」的工具又未必給出機器可解析的骨架。Prompt Spark(提示詞火花)面向這類場景:在保持輸入語言的前提下,把模糊草稿擴成帶固定標籤的結構化提示詞,並支持在替換前全文審閱與編輯。
這是什麼¶
Prompt Spark 是維護者 Erfan817 發佈的 DeepSeek Harness 插件,npm 包名爲 dsh-prompt-enhancer-plus,當前版本 1.6.0,許可證 MIT。倉庫分類上屬於模型推理相關能力;一句話定位是:把粗糙想法變成 AI 能穩定解析、人也能直接閱讀的可執行提示詞。官方簡介強調不會在未確認的情況下自動發送任何內容。
除 DSH 外,同一套規則核心還可通過本機服務對接 VS Code/Cursor、Claude Code、CLI 與全局熱鍵等入口;下文以 DSH 安裝與 Composer 用法爲主,其他 harness 僅作對照說明。
核心功能¶
結構化輸出契約¶
增強結果使用純文本標籤,不是 Markdown 或 JSON。穩定錨點爲英文標籤:Task:、Requirements:、Acceptance criteria:、Constraints:;在「詳細」檔會補充 Context:、Failure cases:。標籤後的正文跟隨用戶草稿語言(中文草稿則正文多爲中文)。
三檔詳細度¶
- 簡潔:主要潤色,結構最少。
- 標準:適度補充結構,爲默認檔。
- 詳細:展開邊界、驗收標準與失敗情形。
項目感知(DSH)¶
在 DSH 會話工作區內,插件會讀取 AGENTS.md、CLAUDE.md、README.md、README.zh.md、package.json 作爲參考,使強化結果更貼合當前項目上下文。
人格與預覽¶
可保存並跨會話複用改寫方向(如產品、工程、寫作、極簡等 persona)。替換草稿前可編輯完整預覽;提供最近五條記錄與十秒撤銷。
與「只變好讀」工具的差別¶
README 中的設計目標是「可執行」:既要結構化到下游模型能解析,又要自然到人可審閱。DSH 可在 Composer 工具欄提供原生 強化提示詞 按鈕;其他 harness 受宿主 API 限制,通常通過面板、斜槓命令或本機服務等價實現。
環境要求¶
- DSH:
>= 0.2.2-rc.1(見package.json的engines.dsh) - Node:
>= 22(README 徽章說明) - 非 DSH 適配器需先運行桌面伴侶本機服務(監聽
127.0.0.1迴環端口)
安裝與啓用(DSH)¶
通過 DSH 插件管理器安裝插件源碼目錄,然後重啓 DSH。資料未給出 dsh plugin add github:... 一類一鍵命令,安裝方式以管理器掛載源碼目錄爲準。
可在 DSH 插件配置中按需調整輸入輸出與超時(示例來自 README):
- id: prompt-enhancer-plus
name: dsh-prompt-enhancer-plus
config:
maxInputChars: 12000
maxOutputTokens: 3000
timeoutMs: 90000
典型用法(DSH Composer)¶
- 在 Composer 輸入框寫下短草稿。
- 點擊工具欄 強化提示詞(可先選詳細度與人格,若界面提供)。
- 在預覽中審閱或修改結果。
- 選擇 替換草稿 寫回輸入框,或 複製 到別處使用。
同一草稿在三檔下的形態差異,官方用「導出 CSV」爲例說明(節選):
簡潔 / concise
Task: 做一個導出 CSV 的功能。
Requirements: 1. 可選擇導出字段;2. 支持 UTF-8。
標準 / standard
Task: 做一個導出 CSV 的功能。
Requirements: 1. 可選擇導出字段;2. 支持 UTF-8。
Acceptance criteria: 導出文件能在 Excel 中正常打開,字段與選擇一致。
Constraints: 不修改現有數據結構。
詳細 / detailed
Task: 做一個導出 CSV 的功能。
Context: 現有系統已支持列表篩選,導出需複用篩選結果。
Requirements: 1. 可選擇導出字段;2. 支持 UTF-8;3. 大數據量分批寫入。
Acceptance criteria: 導出文件能在 Excel 中正常打開;字段與選擇一致;10 萬行內不超時。
Constraints: 不修改現有數據結構;不新增第三方依賴。
Failure cases: 無數據時導出空文件並提示;字段全不選時按鈕禁用。
其他入口(可選)¶
若你在 Cursor / VS Code 使用同名能力,需先啓動桌面伴侶:
npm install --ignore-scripts
npm run desktop
VS Code / Cursor 擴展安裝示例(README 給出打包與安裝命令):
cd vscode-extension
npx @vscode/vsce package --allow-missing-repository
code --install-extension prompt-spark-vscode-1.0.0.vsix
cursor --install-extension prompt-spark-vscode-1.0.0.vsix
Claude Code 可將 .claude/commands/enhance.md 複製到項目或用戶級命令目錄後使用 /enhance ...。CLI 示例:
echo "幫我做一個導出 CSV 的功能" | node cli/enhance.mjs --level detailed
工作原理上,除 DSH 內嵌路徑外,適配器多通過本機服務 POST /api/enhance 調用統一的 prompt-core.js 規則集。
適用場景與注意¶
適合:習慣在 Composer 先寫短意圖、再交給模型做實現或推理的 DSH 用戶;需要在同一會話內利用工作區 AGENTS.md 等文件對齊項目約定的團隊。
務必注意:
- 插件以當前 DSH 進程權限運行,安裝前應自行查看倉庫源碼與 MIT 許可證,確認可接受其讀取工作區內上述參考文件的行爲。
- 強化過程會調用模型推理,受
maxInputChars、maxOutputTokens、timeoutMs等配置約束;超長草稿可能被截斷或超時。 - DSH 社區插件目錄(SkillHub)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;列表信息以你本地安裝的版本爲準。
結尾¶
Prompt Spark 的價值在於用一套固定標籤把「想說一句」變成「能執行一段」,並在 DSH 裏用 Composer 按鈕完成草稿—預覽—替換的閉環。瞭解更多可看社區目錄頁與 GitHub 倉庫:
- 目錄頁:https://www.skillhub.cn/plugins/Erfan817/prompt-spark
- GitHub:https://github.com/Erfan817/prompt-spark