前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常對話時，經常需要「說一句話就出一張圖」：插圖、海報草圖、界面 mock 等。若每次切到瀏覽器 Playground、再手動下載保存，會話上下文和本地歸檔都會斷檔。社區插件 dsh-moss-image（維護者 Akashyc）把 MOSS-Image 文生圖接口接到 DSH：模型調用 image_generate 工具，圖以附件出現在會話裏，並寫入你指定的本地目錄；2.x 起還帶側欄圖庫、相冊與畫風等能力。本文按倉庫 README 說明定位、安裝與用法；插件爲 MIT 社區作品，非 DeepSeek 或 Moss 官方出品。
這是什麼¶
dsh-moss-image 是 DSH bundle 插件：在對話中描述畫面，由模型調 Moss 文生圖接口生成 PNG，展示在會話中並落盤。當前 package 版本爲 2.1.0（2026-11-03）。依賴自備 Moss API Key，調用費用由使用者承擔。
核心功能¶
下面列出的行爲均來自項目 README，裝好後可在 設置 → 側欄 Moss 生圖 與 Moss 圖庫 中驗證。
對話生圖¶
- 模型調用工具
image_generate，圖片以附件顯示，可點開查看。 - 一次只出一張 PNG；單張可能需幾十秒到數分鐘，屬接口常態。
- 輸入框左側有「生圖」按鈕，會把「畫一張圖：」 prepend 到草稿，保留已有文字。
提示詞與佈局¶
- 服務端智能改寫（默認開）：與 Moss 官方 Playground 一致，描述可原文照傳；畫面裏要出現的文字會原樣保留。
- 可選 讓 DeepSeek 優化提示詞、轉成英文提示詞；與智能改寫同時開會互相限制，佈局生圖開啓時智能改寫會自動關閉。
- 佈局生圖（默認開）：海報、精確文字位置時，模型按左上角原點給出元素框，插件換算成接口所需的中心座標 layout JSON。
種子與改圖¶
- 同一會話內迭代改圖默認 沿用上一張種子，只改提示詞相關表述；說「換一張」才換新種子。
- 會話種子只在內存中，重啓 DSH 後每個會話的第一張重新隨機。
- 同種子可保持構圖與大樣，但改尺寸或模型會得到不同結果。
本地保存與校驗¶
- 全部圖片寫入同一 絕對路徑 目錄（默認
~/Pictures/Moss）；設置頁「試生成」也進同一目錄。寫失敗會先放緩存並說明，同名加序號不覆蓋。 - 尺寸本地攔截：每邊 256–2048、16 的倍數、總像素 ≤ 2097152，不合格不發請求、不計費。
- 不自動重試：超時後服務端可能仍在生成，自動重發會導致重複計費。
Moss 圖庫（2.x）¶
側欄 Moss 圖庫 以文件夾方式管理：相冊排在列表前、雙擊進入、麪包屑或 Backspace 返回；支持單擊選中、Ctrl/Shift 多選、框選、右鍵菜單、Delete 刪除；雙擊圖片打開大圖。元數據在保存目錄下的 library.json（v2 格式，舊格式自動兼容）。
畫風與配置¶
- 設置裏可選畫風，選中後固定提示詞拼在描述最前面；默認不追加。擴展畫風需改倉庫
lib/styles.js。 - API Key 存入 DSH 憑據服務（鍵名
MOSS_API_KEY），不寫配置文件、不回顯。默認接口地址https://api.mosi.cn，默認模型moss-image-sft-1.0。
安裝與啓用¶
安裝從 GitHub 直接解析，不打包 npm、不用 tgz。github: 前綴由 pnpm 解析，公開倉庫無需登錄；安裝的是默認分支當前提交。裝完需 重啓 DSH，並在 設置 → 插件 → Moss 生圖（README 中亦寫設置側欄 Moss 生圖）填寫 API Key（在 platform.moss.cn 申請）。
讓 Agent 安裝（推薦）¶
對 agent 說明：
安裝插件 github:Akashyc/dsh-moss-image
插件管理頁¶
路徑：插件 → 添加插件，地址填：
github:Akashyc/dsh-moss-image
然後安裝。
安裝腳本¶
在倉庫目錄執行（ --apply 纔會真正改 profile）：
node install.mjs --apply
不加 --apply 僅打印將要修改的內容。更新時可重跑上述命令（腳本會額外執行 pnpm update）；或先卸載再按同一地址安裝。
手動寫 profile¶
編輯 ~/.dsh/profiles/<profile>/package.json（默認 profile 爲 desktop），在 dependencies 與 dsh.profile.bundles 中加入插件（bundles 已有項則追加，勿整段替換）：
{
"dependencies": {
"dsh-moss-image": "github:Akashyc/dsh-moss-image"
},
"dsh": {
"profile": {
"bundles": ["dsh-moss-image"]
}
}
}
隨後在 profile 目錄執行：
pnpm install
重啓 DSH 後，設置側欄應出現 Moss 生圖。
裝後自檢¶
README 建議：在 Moss 生圖設置頁點 測試連接（只查模型列表，不計費），再點 試生成；側欄打開 Moss 圖庫 查看落盤文件。
典型用法¶
對話裏直接描述¶
例如：
畫一隻橘貓坐在窗邊，雨後的花園，柔和的自然光
需要尺寸或種子時可在同一句說明，例如「9:16，種子 42」。尺寸也可在設置裏選預設（如默認 1024x1024）或手填寬×高。
卸載（節選）¶
對 agent：卸載插件 dsh-moss-image。或插件管理頁卸載，或：
node install.mjs --uninstall --apply
卸載不會刪除憑據裏的 API Key、~/.dsh/dsh-moss-image/ 下的設置與緩存、已保存圖片；需手動清理。
適用場景與注意¶
適合：已在 DSH 裏對話、希望模型按需出圖並本地歸檔的開發者或重度用戶；需要相冊式管理 Moss 出圖結果時，可用 2.x 圖庫。
注意：
- 插件以當前 DSH 進程權限運行；安裝前請閱讀 GitHub 源碼 與 MIT 許可證，自行評估信任邊界。
- 生成內容需遵守 Moss 平臺政策與所在地法律；提示詞與參數僅發往所配置的 Moss 接口。
- 升級自舊版：
pathMode已移除，相對目錄配置會丟棄並回落默認~/Pictures/Moss；升級後建議重啓一次 DSH。
結尾¶
dsh-moss-image 把 Moss 文生圖、會話工具調用、本地落盤和圖庫收到一個 DSH 插件裏，減少在 Playground 與 IDE 之間來回切換。社區目錄頁：skillhub.cn/plugins/Akashyc/dsh-moss-image；源碼與完整配置表見 github.com/Akashyc/dsh-moss-image。
