前言¶
在 DeepSeek Harness（DSH）裏跑文生圖、圖像編輯或多模型推理時，常見做法是手寫英文提示詞，或對照各模型文檔自己拼語法。不同頁籤、不同模型（FLUX、Midjourney、H3 等）規則不一致，改一版提示詞往往要在文檔和輸入框之間來回切。
下面介紹社區插件 dsh-prompt-assistant（維護者 MJDACK，分類：模型推理）。它掛在 DSH 桌面版 Web UI 側邊欄，用一句話中文產出可直接下游使用的提示詞，並支持參考圖與結果區對話微調。插件以 bundle 形式接入 DSH 的 Cordis 補丁與 Web 客戶端，不單獨構建。
這是什麼¶
dsh-prompt-assistant 是 DSH 側邊欄裏的「提示詞助手」：輸入中文描述（必要時附帶參考圖），按當前頁籤套用對應系統提示詞或模型規範，輸出結構化結果（英文描述、畫幅、編輯指令等）。本地已收錄的模型走內置規範庫；未收錄的可聯網查官方指南並緩存在本機。
開發與運行環境以 README 爲準：DSH 桌面版（Web UI），開發時使用 0.2.1-rc.x 量級版本，插件 API 使用 ctx.llm、ctx.attachments、ctx.webServer；圖像相關能力需要所選模型支持圖片輸入（README 記載 deepseek-flash 實測可用）。
三個頁籤分別做什麼¶
文生圖¶
套用包內或自定義目錄下的 system_prompt_t2i.md，輸出英文畫面描述與畫幅比例，字段爲 rewritten_prompt、wh_ratio。
圖像編輯¶
套用 system_prompt_edit.md，需要上傳待編輯圖；輸出編輯指令與畫幅。多圖時帶 ratio_follow。多圖引用在結果裏按 <image1>(簡短描述) 格式書寫，例如 <image1>(穿白裙的女孩)、<image2>(夜晚的城市街道)，便於下游識別每張圖。
模型提示詞¶
輸入格式爲 模型名: 中文描述，例如 moss: …、anima：…、h3: …（半角、全角冒號均可，模型名不區分大小寫）。插件按該模型的原生語法寫英文提示詞，並附中文直譯。內置 24 個模型 / 97 個別名 的規範（FLUX、Qwen-Image、Seedream、Midjourney、SDXL、Nano Banana、Veo、Kling、Wan、Runway 等）。本地未收錄時會聯網檢索，正文寫入 ~/.dsh/prompt-assistant/specs/<model>.md 後下次直接命中；可通過配置關閉聯網（見下文 webLookup）。
若本機安裝了 h3-prompt-writing skill，h3: / h3-ref: 會自動使用該 skill 的官方指南（T2VA/I2VA/FL2VA/L2VA、Ref2VA 等段式）。H3 完整指南不隨本倉庫分發，見倉庫 NOTICE。
三個頁籤均可添加參考圖；生成結果後可在面板底部繼續對話調整（例如「背景換成夜晚」「再短一點」「翻譯改口語」），模型返回完整新結果並更新卡片，也可純問答。切換頁籤時草稿、參考圖、上次結果與對話記錄會保留。
圖片與模型選擇¶
參考圖支持拖拽、粘貼或點 + 上傳；前端統一重編碼爲 PNG/JPEG（最長邊 2048），WebP、超大圖或 MIME 不符會在本地攔截，避免到上游才報錯。模型下拉會標出不支持圖片的模型；帶圖提交時前後端都會校驗。新增本地模型規範後，可點下拉旁的 ↻ 重新讀取（Host 側緩存約 30 秒，面板每次打開也會刷新），無需重啓 DSH。
規範庫可展開，點擊模型名會自動把 別名: 填入輸入框。
安裝與啓用¶
這是 DSH bundle（package.json 中 dsh.bundle.patch + dsh.client），無需構建。安裝前請自行閱讀倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，聯網查規範時會把模型名發給搜索服務（正文僅緩存在本機）。
方式一：插件管理界面
- 將倉庫克隆或下載到本地，例如
D:\plugins\dsh-prompt-assistant。 - 打開 DSH → 插件 → 添加插件 → 選擇目錄（或「本地安裝」），指向該目錄。
- 側邊欄出現「提示詞助手」。
方式二：命令行
dsh plugin --profile <profile-name> add link:/absolute/path/to/dsh-prompt-assistant
將 <profile-name> 與路徑換成你的 profile 與插件目錄的絕對路徑。若桌面版自行管理的 profile 拒絕命令行寫入（提示 profile "…" is managed exclusively by the Electron application），請改用方式一。
修改 Host 側 index.js 後瀏覽器不會自動加載新代碼：在插件頁關閉再打開該 bundle，或重啓 DSH。
配置¶
配置寫在 bundle 的 cordis.patch.yml 裏，在 config 下覆蓋即可，例如：
- insert:
- id: prompt-assistant
name: dsh-prompt-assistant
config:
promptDir: 'D:\my-prompts'
specDir: 'D:\my-specs'
learnedDir: 'D:\my-specs-learned'
| 鍵 | 默認 | 說明 |
|---|---|---|
promptDir |
~/.dsh/prompt-assistant/prompts |
放置 文生圖/system_prompt_t2i.md、圖像編輯/system_prompt_edit.md；缺失則用包內 prompts/ |
specDir |
~/.dsh/skills/model-prompt-en/references |
模型規範庫（含 index.md 與 models/） |
specFallbackDir |
包內 specs/ |
specDir 找不到時使用 |
learnedDir |
~/.dsh/prompt-assistant/specs |
聯網學到的模型規範 |
specFiles |
h3 相關路徑 | 掛載外部文件作爲規範；文件不存在則跳過 |
maxImages / maxImageBytes / maxBodyBytes |
0 / 12MB / 256MB |
圖片張數、單張大小、請求體上限（0 表示圖片張數不限） |
webLookup |
true |
未收錄模型是否聯網查詢 |
典型用法¶
文生圖：在「文生圖」頁籤輸入中文畫面描述，可選參考圖，選模型後提交，使用返回的 rewritten_prompt 與 wh_ratio 對接下游生圖。
圖像編輯：上傳要改的圖片，用中文說明改動意圖；多圖時在結果中確認 <imageN>(描述) 是否與意圖一致。
模型提示詞：在輸入框寫 flux: 賽博朋克街景，霓虹雨夜 這類一行，或從規範庫點選模型名自動補全前綴；需要對照語法時可展開規範庫閱讀。
對話調整：結果卡片生成後，在底部輸入「背景換成夜晚」等短指令，獲取完整新 JSON 結果（對話調整僅攜帶文本結果，不會把參考圖再發一遍）。
本機腳本或同源頁面還可調用插件註冊的 HTTP 接口（僅迴環 Host、同源，無額外 token）：
GET /dsh-prompt-assistant/info
GET /dsh-prompt-assistant/lookup?alias=moss
POST /dsh-prompt-assistant/rewrite {mode, text, images?, model?}
POST /dsh-prompt-assistant/chat {mode, input, result, history, text, model?}
適用場景與注意¶
適合在 DSH 桌面版裏頻繁寫 T2I、圖像編輯指令，或需要在 FLUX、MJ、H3 等多套語法間切換的開發者。默認請求只走本機 DSH（127.0.0.1），無獨立外部後端；草稿與學到的規範僅存本地。
已知限制（README）：不做流式渲染，需等待模型返回完整 JSON；對話調整不帶參考圖；模型不支持圖片時面板會提示換模型。社區目錄 SkillHub 插件頁 與 DeepSeek / 幻方無官方從屬關係，DSH 生態理念是「一切皆插件」，安裝來源以你信任的倉庫與目錄頁爲準。
結尾¶
dsh-prompt-assistant 把文生圖、圖像編輯和模型原生提示詞收斂到側邊欄三個頁籤，用中文輸入和可選參考圖降低提示詞編寫成本，並用對話微調減少反覆重跑。詳情與 issue 見 GitHub 倉庫：https://github.com/MJDACK/dsh-prompt-assistant；目錄介紹見 https://www.skillhub.cn/plugins/MJDACK/dsh-prompt-assistant。
