前言¶
在 DeepSeek Harness（DSH）裏寫提示詞，常見做法是直接交給模型「潤色一遍」。輸出往往更流暢，但未必按 role / task / context / constraints / output format 這類 Agent 流水線組織，後續在 composer 裏複用、迭代也不直觀。
下面介紹社區插件 提示詞工坊（dsh-prompt-lab，維護者 xueccci）。它在 DSH Web 輸入欄提供 優化 入口：先用規則或可選 LLM 把當前草稿改寫成可執行的 Agent 結構，再在確認彈窗裏對照原稿、看五層診斷與輸出分，由你決定是否寫回 composer。本地規則可離線工作；需要精修時可走 hybrid、僅 DSH 或 OpenAI 兼容的雲端 API。
這是什麼¶
dsh-prompt-lab 是面向 DeepSeek Harness 的 Agent 結構化提示詞優化插件，分類上屬於模型推理相關能力。它解決的是：把 composer 裏的零散草稿，整理成帶角色、任務、上下文、約束與輸出格式的結構化提示，並在寫回前給你明確的確認步驟。
插件爲 MIT 許可的獨立社區項目，與 DeepSeek AI 無隸屬關係。安裝與能力說明以 GitHub 倉庫 與 SkillHub 目錄頁 爲準；SkillHub 爲獨立插件目錄站點，並非 DeepSeek 官方應用商店。
環境要求： DSH >= 0.2.0-rc.2（Typert 嚴格 codec 需 create() 工廠；模型元數據經 llm.resolveModelInfo() 讀取）。
核心功能¶
與普通「潤色」的差異¶
| 通用潤色類插件 | dsh-prompt-lab | |
|---|---|---|
| 方法 | 讓模型重寫一次 | 先做 Agent 階梯 結構化 |
| 模式 | 多種策略標籤 | 普通優化 / 精簡 / 擴寫 |
| 離線 | 通常依賴模型 | 本地規則 可產出結構化結果 |
| 確認 | 靜默寫回 | 彈窗 + 分數 + 顯式操作 |
| 失敗 | 硬失敗 | 降級本地，黃條提示 |
三種模式¶
- 普通優化：改寫成 Agent 結構（role / task / context / constraints / output format）。
- 精簡：提取主幹——核心任務、硬約束、交付物。
- 擴寫：只細化用戶在原稿中點名的需求。
四種引擎¶
| 引擎 | 行爲 |
|---|---|
| 僅本地 | 離線規則，不調用模型，草稿不出本機 |
| hybrid（默認） | 本地骨架 → 當 provider 與 model 可解析時再經 DSH 精修 |
| 僅 DSH | 優先 DSH；無模型或失敗時降級本地 + 黃條 |
| 雲端 API | OpenAI 兼容 HTTP（DeepSeek 或自定義）；失敗同樣降級本地 + 黃條 |
hybrid / 僅 DSH / 雲端 API 會把草稿與本地骨架發給所配置的模型服務商；僅本地模式數據留在本機。
請求超時：idle 15s / 總計 60s。
確認彈窗¶
點 優化（或 Ctrl/Cmd+Enter）後，彈窗展示原稿、結果、五層 chips 與輸出分。左側原稿可編輯。
| 操作 | 行爲 |
|---|---|
| 繼續優化 | 對當前左側原稿再跑一輪（與入口「優化」相同邏輯） |
| 回填輸入 | 右側結果填入左側原稿，便於二次編輯 |
| 採用 | 左側原稿寫回 composer，toast「已寫入」；僅當 composer 原草稿未被改動時寫回 |
| 複製 | 複製右側結果到剪貼板 |
| 取消 / Esc / × | 不修改 composer 草稿 |
安裝與啓用¶
在已安裝 DSH 且使用 web profile 的前提下，按 README 安裝固定版本：
dsh plugin --profile web add github:xueccci/dsh-prompt-lab#v0.2.0
重啓該 profile 的 Web 進程，瀏覽器內 Ctrl+Shift+R 強刷。Linux 下可用下面命令確認插件已載入（Windows 文檔示例爲 findstr，可按環境改用 grep）：
dsh --profile web --dump-config | grep dsh-prompt-lab
成功後，composer 輸入欄左側應出現 優化 按鈕。
典型用法¶
- 在 composer 輸入欄寫好草稿。
- 點擊 優化，或按
Ctrl/Cmd+Enter。 - 在彈窗中查看原稿與結果；可在左側編輯，或 繼續優化、回填輸入。
- 確認無誤後點 採用，將左側內容寫回輸入框（composer 草稿未變時生效）。
在 設置 → 提示詞工坊 中可調整：
- 引擎：僅本地 | hybrid（默認）| 僅 DSH | 雲端 API
- 模式：普通優化 | 精簡 | 擴寫
- 雲端 API：Base URL / Key / 模型，含測試連接
- 推理行爲：自循環、快捷鍵（默認開啓）
- 關於：維護者與插件信息
雲端 API 的 Key 保存在瀏覽器 localStorage，不會寫入工作區文件。
適用場景與注意¶
適合： 經常在 DSH Web composer 裏寫 Agent 類提示、希望統一五段結構、又需要在寫回前人工把關的開發者。
注意：
- 插件隨當前 DSH 進程權限運行；安裝前建議閱讀 源碼 與 MIT 許可證（見倉庫
LICENSE、NOTICE）。 - 非本地引擎會向配置的服務商發送草稿與骨架；敏感內容請優先 僅本地，或自建可控的雲端端點。
- 精修失敗時仍會給出本地結構化結果，留意界面黃條說明。
DSH 生態強調「一切皆插件」；本插件當前 package 版本爲 0.2.0，GitHub 星標數爲 3（以目錄頁與倉庫頁面爲準）。
