前言¶
在 DSH 裏跑陪伴類智能體,常見需求是讓模型不只說話,還能按「此刻穿什麼、人在哪」出一張圖,並在 QQ 等橋裏用 markdown 路徑直接發圖。自己拼 prompt、對接生圖 API、還要和劇本插件對齊上下文,步驟多且容易和舊版工具鏈脫節。dsh-feiyu-image(維護者 Vansnc,社區分類:模型推理)把這件事收成模型可調的一個工具 shoot:自動拼固定角色特徵、可變穿着與場景,落盤 PNG,回覆裏寫  即可。
這是什麼¶
dsh-feiyu-image 是 DeepSeek Harness 的 npm 插件(當前版本 0.5.0,MIT,要求 Node.js ≥ 22)。定位爲「給陪伴角色一個相機」:模型調用 shoot 即可生成並保存圖片。生圖默認走火山方舟 Seedream 5.0(doubao-seedream-5-0-pro-260628,2048×2048),並保留百鍊 Token Plan 的 wan2.7-image 作爲備用後端。與已停在 0.1.7、依賴舊版 dsh-tools 的 dsh-image-studio 不同,作者針對當前 dsh 0.2.x 單獨實現了單一工具方案。
配套生態上,安裝 dsh-feiyu-life 後,提示詞會讀取「今日劇本」裏的穿着與場景;未裝仍可用,只是提示詞少這兩項。
核心功能¶
下面介紹插件向模型暴露的能力和運行約束,均來自倉庫 README。
工具 shoot¶
| 參數 | 說明 |
|---|---|
提示 |
可選,畫面裏還想要什麼 |
類型 |
selfie 自拍,或 scene 只拍場景 |
生成流程要點:
- 提示詞自動拼接:固定特徵(長相、髮色、耳、尾、瞳色等,每次一字不差帶上)、可變服裝(默認女僕裝;睡衣、浴巾、外出服等以畫面描述爲準)、此刻穿着(來自
dsh-feiyu-life劇本,若已安裝)、場景、光線與畫風。 - 硬比例約束:日系成人向、七頭身、非 Q 版;畫風爲二次元(日系成人向動畫、賽璐璐上色)。文檔中的角色設定爲鯨魚娘(藍髮、鯨魚鰭耳、鯨魚尾、女僕裝等),同一角色靠固定特徵與固定
seed跨場景保持同一張臉,服裝爲可變量。 - 出圖保存路徑:
~/.dsh/feiyu-image/feiyu-<時間戳>.png。 - 節流:默認每天最多 8 張、兩次調用至少間隔 30 秒(可在配置中調整)。
- 生圖失敗會返回原因,不會卡住整輪對話。
與 QQ 橋的銜接¶
回覆中使用 markdown 圖片語法,例如 ,QQ 橋會把路徑抽成圖片段發送。
成本與耗時(文檔記載)¶
單張約 18–22 秒,2048×2048 PNG(約 7MB);按 Token Plan 的圖片額度計費,一張一次。
安裝與啓用¶
先做插件安裝,再確認百鍊 Token Plan 配置文件存在(與 bailian-tp 插件共用)。
dsh plugin --profile web add dsh-feiyu-image
需要 ~/.dsh/bailian-tp/config.json(Token Plan 的 key 和 base)。
DSH 插件在當前 dsh 進程權限下運行;安裝前建議在 GitHub 查看源碼與 MIT 許可證,確認符合你的環境與合規要求。社區目錄頁:https://www.skillhub.cn/plugins/Vansnc/dsh-feiyu-image;倉庫:https://github.com/Vansnc/dsh-feiyu-image。
配置¶
配置文件路徑:~/.dsh/feiyu-image-config.json(不存在則使用默認)。示例字段如下:
{
"總開關": true,
"模型": "wan2.7-image",
"外觀": "中國大陸 21 歲女大學生,素顏淡妝,黑色齊肩發,皮膚偏白,身形偏瘦",
"風格": "手機隨手拍,自然光,輕微膠片顆粒,真實質感,不過度磨皮",
"每日上限": 8,
"最短間隔秒": 30,
"存圖目錄": ""
}
文檔另提到:可將參考圖放在 ~/.dsh/feiyu-image/角色設定/正面.jpg,用於鎖定臉、髮色漸變、鯨魚鰭耳、呆毛、鯨魚尾、女僕裝款式等;改設定時也可對照 ~/.dsh/feiyu-image/角色-設定.png。
典型用法¶
模型側調用示例:
shoot 類型=selfie 提示="把剛取到的畫冊攤在桌上,低頭看畫面"
shoot 類型=scene 提示="宿舍窗臺上的綠蘿,傍晚的光"
用戶側在模型回覆裏用  引用落盤文件即可發圖。
適用場景與已知邊界¶
適合誰: 已在 DSH web profile 下跑陪伴角色、需要「劇本上下文 + 生圖 + QQ 發圖」一條鏈路的開發者;願意使用火山方舟 Seedream 5.0 或百鍊 wan2.7-image 並完成 bailian-tp 配置的用戶。
需要注意:
- 文檔記載當前部分接口不接受同時傳文本與參考圖(傳參考圖可能 400:
Either 'text' or 'image' must be provided, but not both),因此無法完全用「角色參考圖 + 指令」鎖臉;現方案靠固定設定與固定seed保持「同一人」觀感,細節仍可能漂移;要更強鎖定需 LoRA 或支持 image-edit 的接口。 - 畫面中的中文文字(黑板、書頁等)容易糊成亂碼,儘量避免需要辨認的字。
- 穿着與場景自動銜接依賴
dsh-feiyu-life。
反饋¶
問題可到 GitHub 開 issue(https://github.com/Vansnc/dsh-feiyu-image/issues),附上插件版本與相關圖片。
經過上面的步驟,dsh-feiyu-image 把生圖收斂爲模型的一個 shoot 調用:上下文從劇本插件讀取,圖片落盤到 ~/.dsh/feiyu-image/,再通過 markdown 路徑對接 QQ。目錄與源碼分別以 SkillHub 與 GitHub 爲準維護與迭代。