前言¶
DeepSeek Harness（DSH）自帶 read_image，只能讀已有圖片，不能在對話裏直接「畫一張圖」或按參考圖改場景。濟南大學的大模型公共服務平臺 濟大詞元（llm.ujn.edu.cn）提供 OpenAI 兼容接口，其中包含 Qwen-Image 等生圖能力；接口可以單獨調，但和 DSH 的工具註冊、base64 落盤、持久附件、憑據存儲並不自動打通。
下面介紹社區插件 dsh-ujn-image（維護者 Jia-HuaWu）：在 DSH 設置頁填一次 API Key，對話裏用自然語言觸發文生圖或圖生圖，生成結果存成 PNG 並作爲持久圖片附件回傳，便於後續在會話裏繼續用。
這是什麼¶
dsh-ujn-image 屬於 DSH 社區插件目錄中的「模型推理」類項目（目錄頁：skillhub.cn/plugins/Jia-HuaWu/dsh-ujn-image）。它補了三塊缺口：
| 缺口 | 插件做法 |
|---|---|
| DSH 沒有內置「生成圖」工具 | 註冊 ujn_generate_image、ujn_edit_image |
| 平臺返回 base64，對話需要持久附件 | 解碼 → 落盤 → ctx.attachments.saveImage() → 回傳 ImageBlock |
| API Key 不宜寫在明文配置裏 | 走 DSH 官方憑據域，設置頁填寫，響應不回傳明文 |
一句話：讓 DSH 會調用校內平臺畫畫，並把圖畫進對話附件鏈路。
核心功能¶
文生圖¶
在對話裏描述畫面即可，例如：
畫一隻戴着宇航員頭盔的橘貓，漂浮在太空中，細膩寫實風格
工具主要參數（摘自 README）：
| 參數 | 必填 | 說明 |
|---|---|---|
prompt |
是 | 畫面描述，中文可直接寫 |
size |
否 | square / landscape / portrait / wide / tall |
enhance |
否 | 是否先用 Qwen-Image-PE-T2I 擴寫提示詞（約多 15 秒；失敗會回退原提示詞） |
steps |
否 | 採樣步數，默認 40 |
fileName |
否 | 自定義文件名（同名不覆蓋，自動加序號） |
圖片編輯 / 圖生圖¶
需要保留角色或物體外觀時，應附 1–4 張參考圖，並寫清「保持…不變」。純文生圖無法知道參考圖裏的角色長什麼樣。
示例：
讓她在玩電腦 [附上一張角色圖]
對應平臺 /v1/images/edits（multipart）。images 可填 DSH 附件目錄裏無擴展名的只讀副本路徑，插件按文件 magic bytes 識別格式。
編輯場景下 README 建議 enhance 默認關閉：PE-I2I 改寫實測約 70 秒，且有時不改寫中文；指令寫清楚時通常不必開。
設置頁¶
安裝並重啓 DSH 後，在 設置 → 濟大詞元文生圖 中可：
- 填寫 API Key（保存後僅顯示「已配置」）
- 測試連接：列平臺模型，確認密鑰與生圖模型可用
- 試跑：不打開對話即可預覽生成；填參考圖路徑則自動進入編輯模式
- 調整接口地址、生圖模型、默認畫幅、採樣步數、保存目錄等
若已在「設置 → 模型」爲同一平臺配置過密鑰，插件默認複用 UJN_API_KEY 憑據名。
安裝與啓用¶
README 給出的安裝方式如下（本地路徑示例需改成你機器上的插件目錄）：
# 桌面端（DeepSeek Harness 桌面應用）
dsh plugin --profile desktop add link:E:/DeepseekHarness/dsh-ujn-image
# 網頁版（dsh web）
dsh plugin --profile web add link:E:/DeepseekHarness/dsh-ujn-image
# 或從 git 安裝
dsh plugin --profile desktop add git+https://github.com/Jia-HuaWu/dsh-ujn-image
安裝後重啓 DSH：宿主側工具註冊與瀏覽器側設置頁裝配在啓動時完成。README 徽章標明面向 DSH 0.2.0-rc.2 生態；package.json 中插件版本爲 1.0.0，許可證 MIT。
卸載示例：
dsh plugin --profile desktop remove dsh-ujn-image
卸載不會刪除已生成圖片，也不會清除憑據文件。
拿到 API Key¶
- 打開 https://llm.ujn.edu.cn ，用統一身份認證登錄（學生用學號）
- 進入「密鑰 / Tokens」，創建密鑰
- 複製
ujn-開頭的字符串（只顯示一次，需當場保存） - 粘貼到插件設置頁
README 說明：生圖模型與聊天模型配額獨立，出圖不擠佔日常對話額度。
典型用法¶
只做文生圖：在對話裏用中文描述畫面，必要時在工具參數裏指定 size、steps 或開啓 enhance。
角色進新場景：先附上角色參考圖，再發類似「讓這個角色坐在電腦桌前玩電腦遊戲…保持髮型、髮飾、服裝完全一致」的指令，由 ujn_edit_image 調用編輯接口。
不在對話裏試：用設置頁的「試跑」，可單獨驗證文生圖或帶參考圖的編輯。
讓模型「看見」生成的圖（可選）¶
插件會把圖寫成持久附件，但 DSH 的 llm-pi-ai 適配器在模型未聲明 input 時，默認可能只接受文本，圖片會被替換成佔位說明，模型讀不到像素。README 建議在 profile 的 cordis.patch.yml 裏爲 ujn 路由增加 defaultInput: [text, image]，並註明需實測平臺模型確實支持讀圖後再改。不做這一步時，圖仍會生成並在界面顯示，只是模型可能無法基於畫面內容繼續追問或修改。
適用場景與注意¶
適合誰：已在或可訪問濟南大學大模型平臺（濟大詞元）、希望在 DSH 對話/agent 流程裏直接文生圖、圖生圖的用戶。
運行方式：與其它 DSH 插件一樣，代碼在 當前 dsh 進程權限 下執行；安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證，確認密鑰與生成圖片的落盤位置（默認相關目錄見 README 工作原理：ujn-images/、設置存於 $DSH_HOME/dsh-ujn-image/settings.json）。
安全相關（README 摘要）：密鑰進 $DSH_HOME/.credentials.yaml；設置頁寫密鑰的接口僅接受本機迴環請求，反代或局域網訪問可通過 DSH_UJN_IMAGE_TRUSTED_HOSTS 聲明可信 Host。
已知限制：依賴校內平臺可用性與配額；圖生圖依賴參考圖與提示詞質量；第三方插件未使用 @deepseek-ai/dsh-tools 的 defineTool，而是手寫與註冊表等價的工具定義（README 有說明原因）。
結尾¶
dsh-ujn-image 把濟大詞元的 Qwen-Image 文生圖、圖生圖能力接進 DSH 工具與附件鏈路，並配套設置頁、連接測試與試跑。社區目錄：https://www.skillhub.cn/plugins/Jia-HuaWu/dsh-ujn-image ；源碼與完整說明：https://github.com/Jia-HuaWu/dsh-ujn-image。
