前言¶
在 DeepSeek Harness (DSH) 中開發智能體時，提示詞工程往往成爲效率瓶頸。手動反覆修改不僅耗時，且難以追蹤歷史版本。現有的社區方案中，有的配置繁瑣，有的過度依賴數據庫。dsh-prompt-forge 旨在提供一種輕量級的解決方案，直接在當前會話上下文中完成提示詞的流式優化與技能沉澱。
插件介紹¶
這是一個原生 DSH 插件，由 nina27486486 維護。它通過複用當前會話的模型 (agentDefaultModel) 和流式接口 (llm.stream)，實現了零 API Key 配置的提示詞優化。同時，它提供基於文件的詞庫管理和一鍵生成技能文件的能力，適合需要快速迭代提示詞的開發者。
核心功能¶
- 一鍵優化與流式輸出：在輸入框輸入草稿後，點擊 ⚒ 按鈕或切換卡片模式，系統會通過 SSE 流式輸出優化結果。支持三檔模式：輕量（單句潤色）、標準（結構化改寫）、專家（任務推斷 + 輸出契約 + 變量佔位）。
- 零配置運行：無需配置 API Key 或額外端點，直接複用當前會話的模型參數。
- 基礎動作：支持將優化結果替換草稿、撤回修改、複製內容或重新觸發優化。
- 文件詞庫：使用純 JSON 文件存儲詞庫條目（位置在
$DSH_HOME/prompt-forge/prompts.json），支持直接編輯、Git 同步，並在卡片內瀏覽、點擊插入。 - 存爲技能：對滿意的結果，可一鍵生成
dsh技能文件（位置在$DSH_HOME/skills/forge-<slug>/SKILL.md），之後可通過/forge-<slug>命令調用。
安裝與啓用¶
插件支持自包含部署。安裝時需注意路徑空格問題，建議使用 mklink 建立無空格目錄的聯接。
# 建立目錄聯接（處理路徑空格）
cmd /c mklink /J D:\prompt-forge-dev "D:\deepseek harness\plugins\dsh-prompt-forge"
# 通過 dsh 命令添加插件
./dsh.sh plugin --profile web add D:/prompt-forge-dev
典型用法¶
- 在輸入框輸入草稿，點擊 ⚒ 按鈕（或切換到卡片模式）即可查看流式優化結果。
- 在卡片內的「詞庫」tab 瀏覽條目，點擊條目可直接插入到輸入框。
- 對優化滿意的結果，點擊「存爲技能」，系統會生成對應的 SKILL.md 文件，之後可通過
/forge-<slug>觸發。
注意事項與限制¶
- 質量依賴：優化質量完全取決於當前會話選用的模型。
- 錯誤顯示：若 API Key 無效，錯誤信息會流式顯示在卡片中。
- 實現耦合：插件通過操作 composer DOM 實現草稿讀寫，與官方渲染器的實現存在耦合。若宿主渲染器大改，可能需要調整
findComposer函數。 - 版本兼容性：0.1.1-rc.2 版本的槽位契約（
{session, input}）與 ≥0.1.2-rc.1 的宿主不兼容，升級宿主時需注意適配。 - 依賴：插件無運行時依賴。
結尾¶
dsh-prompt-forge 提供了從草稿到技能文件的完整鏈路，適合追求輕量化和數據可控性的開發者。更多細節可參考插件目錄或 GitHub 倉庫。
